Erste Schritte mit der erweiterten Formatierung in ArcGIS Dashboards

Da heiße Winde und Trockenheit in Kalifornien ein ständiges Problem darstellen, überwachen die Behörden dieses US-Bundesstaates das Netz ununterbrochen auf Stromausfälle. Die Katastrophenschutzbehörde des Gouverneurs von Kalifornien (California Governor's Office of Emergency Services, Cal OES) verfolgt die Ausfälle und veröffentlicht sie in einem Web-Service, der die wahrscheinliche Ursache der Störung und die Anzahl der davon betroffenen Kunden angibt. Um die Entscheidungsfindung zu unterstützen und eine bessere Priorisierung der Ressourcen zu ermöglichen, ist es entscheidend, dass die Dashboards, die von den für die Versorgungsnetze zuständigen Behörden verwendet werden, nicht einfach nur die gemeldeten Ausfälle anzeigen, sondern auch Warnungen generieren und die betroffenen Gemeinden und Kunden identifizieren.

In ArcGIS Dashboards werden Sie ein visuell informatives Dashboard für die Anzeige der Ausfälle erstellen. Unter Verwendung der erweiterten Formatierung in Arcade können Sie dann berechnen, wie lange ein Ausfall vorliegt, und diese Informationen zur Liste der gemeldeten Ausfälle hinzufügen. Zusätzlich werden Sie eine Warnung konfigurieren, die anzeigt, wann ein neuer Ausfall gemeldet wurde.

Dieses Lernprogramm wurde zuletzt am 28. Februar 2024 getestet.

Endergebnis anzeigen​

Anforderungen

• ArcGIS-Organisationskonto mit einer Publisher-, Vermittler- oder Administratorrolle in einer ArcGIS-Organisation (siehe die Optionen für den Zugriff auf die Software)
• ArcGIS Dashboards

Eine Stromausfallkarte erstellen

Der erste Schritt ist das Erstellen der Karte, die als geographischer Schwerpunkt des Dashboards dienen soll. Dazu erstellen Sie in ArcGIS Online mit Map Viewer eine Webkarte und fügen den Stromausfall-Layer hinzu. Danach legen Sie den Style des Layers und seiner Pop-ups fest. Diese Webkarte und ihre Layer dienen dann als Datenquelle für Ihre anderen Dashboard-Elemente.

Layer zu einer neuen Karte hinzufügen

Zuerst erstellen Sie die Karte für Ihr Dashboard in ArcGIS Online.

1. Melden Sie sich bei Ihrem ArcGIS-Organisationskonto an.
2. Klicken Sie oben auf der Seite auf Karte, um eine neue Karte zu öffnen.

   

   Hinweis:

   Je nach Organisations- und Benutzereinstellungen ist es möglich, dass Sie Map Viewer Classic geöffnet haben. ArcGIS Online bietet zwei Map Viewer zum Anzeigen, Verwenden und Erstellen von Karten. Weitere Informationen zu den verfügbaren und empfohlenen Map Viewern finden Sie in diesen FAQ.

   In diesem Lernprogramm wird Map Viewer verwendet.

   
3. Klicken Sie auf der (dunklen) Werkzeugleiste Inhalt auf Hinzufügen , und wählen Sie Layer über URL hinzufügen aus.

   

4. Kopieren Sie im Fenster Layer-Details den folgenden Web-Service, und fügen Sie ihn in das Feld URL ein:

   https://services.arcgis.com/BLN4oKB0N1YSgvY8/arcgis/rest/services/Power_Outages_(View)/FeatureServer/0

   Hinweis:

   Dieser Layer enthält die von der Katastrophenschutzbehörde des Gouverneurs von Kalifornien (California Governor's Office of Emergency Services, Cal OES) stammenden Informationen zu Stromausfällen für den US-Bundesstaat Kalifornien. Fragen zu diesem Dataset richten Sie bitte an: [e-mail].

   Die Stromausfälle in diesem Layer werden mit Pull-Operationen direkt aus den öffentlich zugänglichen Stromausfallkarten der Versorgungsunternehmen extrahiert. Der Layer selbst wird alle 15 Minuten automatisch aktualisiert. Berücksichtigt werden die folgenden Versorgungsunternehmen: Pacific Gas and Electric, Southern California Edison, San Diego Gas & Electric, Sacramento Municipal Utility District (SMUD) und Los Angeles Department of Water and Power (LADWP).

   In diesem Dataset enthaltene Layer:

   • Power Outage Incidents: Punkt-Layer, der die Daten aller Versorgungsunternehmen anzeigt und am besten für die Anzeige einer allgemeinen Ortsangabe des Ausfalls und die Steuerung von Zahlenangaben in Dashboards geeignet ist.
   • Power Outage Areas: Polygon-Layer, der die ungefähre geographische Ausdehnung des Stromausfalls anzeigt.
   • Power Outages by County: Dieser Layer fasst die insgesamt betroffenen Kunden nach Landkreis zusammen. Dieser Layer eignet sich für die Anzeige der Auswirkung der Ausfälle auf der Ebene des US-Bundesstaates.

5. Klicken Sie auf Zur Karte hinzufügen.

   Die Karte zeigt nun die Stromausfälle in Kalifornien. Da die Daten häufig aktualisiert werden, sollten Sie ein Aktualisierungsintervall für den Layer festlegen.

6. Aktivieren Sie im Abschnitt Aktualisierungsintervall des Bereichs Eigenschaften die Umschaltfläche Layer automatisch aktualisieren.
7. Geben Sie 15 für die Anzahl der Minuten ein.

   

   Dies entspricht dem Intervall, in dem der Layer aktualisiert wird.

8. Klicken Sie in der Werkzeugleiste Inhalt auf Grundkarte.
9. Wählen Sie im Bereich Grundkarte den Eintrag Straßen (Nacht) aus.

   

Dem Layer einen Style zuweisen

Ein Versorgungsausfall ist ein Ereignis, das entweder eine geplante Betriebsunterbrechung oder das Ergebnis einer Störung ist und eine Unterbrechung der Leistungserbringung gegenüber Kunden verursacht. Die Ausfallorte werden in der Regel von Remote-Geräten, die der Erkennung von Systemfehlern dienen, gemeldet. Standardmäßig werden die Ereignisse auf der Karte als geplante und nicht geplante Ereignisse klassifiziert. Dies ist eine gute Methode zum Klassifizieren der Daten. Der Style des Layers kann aber so festgelegt werden, dass sich diese zwei Klassen besser unterscheiden lassen.

1. Klicken Sie in der Werkzeugleiste Inhalt auf Layer.

   

2. Klicken Sie im Bereich Layer auf den Layer Power Outages (View) - Power Outage Incidents.
3. Klicken Sie auf der (hellen) Werkzeugleiste Einstellungen auf Styles.

   

4. Klicken Sie im Bereich Styles auf Style-Optionen für den Style Typen (eindeutige Symbole).

   

5. Klicken Sie unter Outage Type auf das Symbol für Nicht geplant.

   

6. Klicken Sie im Symbol-Style unter Aktuelles Symbol auf Basispunkt.
   
7. Wählen Sie unter Symbol ändern im Dropdown-Menü Kategorie die Option Firefly aus. Wählen Sie ein Rot aus, und klicken Sie auf Fertig.

   

8. Klicken Sie auf das Symbol für Geplant, wählen Sie ein grünes Firefly-Symbol aus, und klicken Sie auf OK.

   

9. Klicken Sie in den Style-Optionen auf Fertig, wenn Sie mit dem Stylen des Layers fertig sind, und dann noch einmal auf Fertig, um den Bereich Styles zu schließen.

   Nachdem sich nun die zwei Ausfalltypen durch ihre Symbole besser unterscheiden lassen, sollten Sie die Cluster-Bildung anwenden, um Konzentrationen von Ausfällen zu visualisieren.

10. Klicken Sie auf der (hellen) Werkzeugleiste Einstellungen auf Aggregation.

    

11. Aktivieren Sie im Bereich Aggregation die Option Aggregation aktivieren.

    

    Cluster-Bildung ist standardmäßig aktiviert.

12. Klicken Sie bei Cluster-Bildung auf Optionen.

    

    Der Bereich Cluster-Bildung wird angezeigt.

13. Ziehen Sie im Bereich Cluster-Bildung den Schieberegler für Cluster-Radius stärker in Richtung von Wenig. Ziehen Sie für Größenbereich den rechten Schieberegler nach links.

    

    Der Kraftwerk-Layer wird jetzt mit Clustern symbolisiert. Wenn Sie vergrößern und verkleinern, werden die Cluster neu konfiguriert, um sich an den aktuellen Maßstab anzupassen. Jeder Cluster wird mit der Anzahl der darin enthaltenen Kraftwerke beschriftet.

    Sie wählen jetzt eine andere Grundkarte aus, sodass sich die Kraftwerk-Features auf der Karte besser abheben. Da die Punkte in diesem Layer durch eher helle Symbole dargestellt werden, können Sie Kontrast schaffen, indem Sie sie auf einer dunklen und neutralen Grundkarte anzeigen.

14. Klicken Sie auf "Zurück", und schließen Sie den Bereich Aggregation.

    

15. Der Style des Layers Power Outages (View) – Power Outage Incidents wird aktualisiert.

    

Pop-ups konfigurieren

Pop-ups eignen sich für das Zusammenfassen eines bestimmten Datenpunktes auf der Karte. Standardmäßig enthalten die meisten Pop-ups alle Felder und Werte. Sie als Zuständiger für die Versorgung sind aber nur an der Ursache des Ausfalls, an der geschätzten Korrekturzeit und am zugehörigen Versorgungsunternehmen interessiert. Durch Konfigurieren der Pop-ups des Layers können Sie die Anzeige der Informationen anpassen.

1. Stellen Sie sicher, dass im Bereich Layer der Layer Power Outages (View) - Power Outage Incidents ausgewählt ist, und wählen Sie auf der Werkzeugleiste Einstellungen die Option Pop-ups aus.
   

   Der Bereich Pop-ups wird angezeigt.

2. Klicken Sie im Bereich Pop-ups auf Titel, und geben Sie den Text Power Outage: {IncidentId} ein.

   

3. Klicken Sie neben Liste "Felder" auf die Schaltfläche Optionen und dann auf Löschen.

   

4. Klicken Sie auf Inhalt hinzufügen, und wählen Sie Text aus.

   Der Texteditor wird angezeigt. Im Editor können Sie eine Kombination aus statischen Texten und Attributfeldern verwenden, um ein benutzerdefiniertes Pop-up zu erstellen.

5. Geben Sie im Editor { ein, und wählen Sie Impacted Customers aus.

   

   Das Feld {ImpactedCustomers} wird zum Textfeld hinzugefügt.

6. Geben Sie hinter {ImpactedCustomers} ein Leerzeichen gefolgt von dem folgenden Text ein:

   customers impacted. Power is expected to resume {EstimatedRestoreDate}.

   Cause: {Cause}

   Contact {UtilityCompany} for more details.

   

7. Klicken Sie auf OK, um die Konfiguration zu speichern und den Editor zu schließen.
8. Vergrößern Sie die Kartenansicht, um die einzelnen Ausfälle zu sehen.
9. Klicken Sie auf einen Ausfall auf Ihrer Karte, um das Pop-up anzuzeigen.

   Wenn Sie auf einen Cluster klicken, wird das Standard-Pop-up für diesen Cluster angezeigt.

   

10. Klicken Sie auf der Werkzeugleiste Inhalt auf Speichern und öffnen und anschließend auf Speichern unter.

    

    Das Fenster Karte speichern wird angezeigt.

11. Geben Sie im Fenster Karte speichern für Titel den Text California power outages map ein, und fügen Sie Ihre Initialen hinzu, damit der Kartenname in Ihrer Organisation eindeutig ist.
12. Geben Sie als Tags die Begriffe California, power, outages ein.
13. Geben Sie als Zusammenfassung den folgenden Text ein: A map of California power outages to be used in a dashboard.

14. Klicken Sie auf Speichern.

Ein Stromausfall-Dashboard erstellen

In ArcGIS Dashboards können Sie ein Dashboard erstellen, mit dem die Benutzer einen schnellen Überblick über die Stromausfälle und die relevanten Informationen dazu erhalten. Dashboards bietet viele Konfigurationsoptionen zum Visualisieren von Daten. Mit der erweiterten Formatierung können Sie Daten, die im Feature-Layer nicht verfügbar sind, ableiten und visualisieren. Die erste Information, die Sie ableiten werden, ist die Ausfalldauer. Dies ist die in Stunden und Minuten angegebene Gesamtzeit eines Ausfallereignisses von der gemeldeten Zeit bis zur aktuellen Zeit. Die zweite Information, die Sie ableiten werden, ist der Zuverlässigkeitswirkungsindex (Reliability Impact Index, häufig auch als Index der durchschnittlichen Systemunterbrechungsdauer bzw. SAIDI für System Average Interruption Duration Index bezeichnet). Dies ist die Gesamtzahl der betroffenen Kunden, dividiert durch die Ausfalldauer in Minuten.

Das Dashboard erstellen

1. Öffnen Sie ggf. die Webkarte der Stromausfälle in Kalifornien mit dem Titel California power outages map.
2. Klicken Sie auf der Werkzeugleiste Inhalt auf die Schaltfläche App erstellen, und wählen Sie Dashboards aus.

   

   ArcGIS Dashboards wird in einer neuen Registerkarte geöffnet.

   Die Felder Titel und Tag sind bereits entsprechend den Elementdetails Ihrer Webkarte ausgefüllt.

3. Geben Sie als Zusammenfassung den folgenden Text ein: This dashboard displays the current planned and unplanned power outages in the State of California.
4. Klicken Sie auf Dashboard erstellen.

   ArcGIS Dashboards öffnet ein neu erstelltes Dashboard mit dem Kartenelement California power outages. Passen Sie das Design des Dashboards an das dunkle Design der Grundkarte an.

5. Klicken Sie auf der Werkzeugleiste auf die Schaltfläche Design.

   

   Der Bereich Layout wird angezeigt.

6. Klicken Sie unter Layout für Design auf Dunkel.

Als Nächstes konfigurieren Sie ein Listenelement unter Verwendung der ausgewählten Farben für die Anzeige auf einem dunklen Hintergrund.

Das Listenelement konfigurieren

Das erste Element, das Sie Ihrem Dashboard hinzufügen, ist eine Liste. Eine Liste eignet sich für die Anzeige von Features, in diesem Fall der Ausfälle. Mit einer erweiterten Formatierung können Sie die Liste so konfigurieren, dass abgeleitete Informationen zu einem Ausfall angezeigt werden.

1. Klicken Sie auf der Werkzeugleiste des Dashboards auf Element hinzufügen.

   

2. Klicken Sie links im Kartenelement auf die Schaltfläche "Hinzufügen", und wählen Sie Liste aus.

   

3. Klicken Sie im Fenster Layer auswählen auf Power Outages (View) - Power Outage Incidents.
4. Klicken Sie auf der Registerkarte Daten im Abschnitt Sortieren nach auf Feld hinzufügen, und wählen Sie Startdatum/-zeit aus.

   

5. Klicken Sie auf Absteigend sortieren.

   

   Die Liste wird so sortiert, dass die neuesten Ausfälle am Anfang angezeigt werden.

6. Klicken Sie auf die Registerkarte Liste.

   In der Liste wird das Feld OBJECTID für jeden Datenpunkt angezeigt. Die OBJECTID sagt jedoch nichts über den Ausfall aus. Einige Informationen sind bereits in den Daten verfügbar, die Ausfalldauer und der Zuverlässigkeitsindex jedoch nicht. Diese Informationen können Sie mit einem Arcade-Ausdruck berechnen. Arcade ist eine flexible Ausdruckssprache, mit der Sie mit Daten in ArcGIS in Echtzeit arbeiten können. Arcade können Sie verwenden, um Feldberechnungen an Ihren Daten durchzuführen und die Darstellung Ihrer Datenpunkte anzupassen. Sie können Arcade-Ausdrücke mit dem Editor für Arcade-Ausdrücke erstellen und anwenden.

7. Klicken Sie in den Listenoptionen neben Erweiterte Formatierung auf Aktivieren.

   

   Der Arcade-Editor wird angezeigt.

   Hinweis:

   Wenn die erweiterte Formatierung aktiviert wurde, sind systemdefinierte Eigenschaften nicht mehr verfügbar. Die gesamte Formatierung der Visualisierung einer Liste erfolgt über den Ausdruck.

   Im Abschnitt Ausdruck können Sie den Ausdruck erstellen. Auf den Registerkarten Profilvariablen und Funktionen finden Sie die Elemente, die Sie im Ausdruck verwenden. Die Registerkarte Profilvariablen enthält eine Liste vordefinierter Variablen für das Erstellen von Ausdrücken. Zum Beispiel erhalten Sie mit $datapoint Zugriff auf die Felder in Ihren Daten. Auf der Registerkarte Funktionen erhalten Sie Zugriff auf die Bibliothek der Arcade-Funktionen. Sie können auf die Informationsschaltfläche neben den einzelnen Funktionen klicken, um die Hilfe zu Parametern, Syntax und Verwendung der jeweiligen Funktion anzuzeigen. Mit einem Arcade-Ausdruck können Sie berechnen, wie viel Zeit zwischen dem Zeitpunkt, an dem der Bericht hinzugefügt wurde, und der aktuellen Zeit verstrichen ist. Dazu sollten Sie eine Variable für den Zeitpunkt der Meldung des Ausfalls und eine Variable für die aktuelle Zeit erstellen und eine integrierte Arcade-Funktion verwenden, um die Differenz zu berechnen.

8. Klicken Sie auf die Schaltfläche Pop-out-Editor.

   

   Daraufhin wird das Fenster Erweiterte Formatierung angezeigt.

9. Löschen Sie den aktuellen Ausdruck im Textfeld, und geben Sie var dateOpened = ein.
10. Platzieren Sie den Cursor hinter dem Gleichheitszeichen, fügen Sie ein Leerzeichen ein, und klicken Sie auf die Registerkarte Profilvariablen.

    

11. Klicken Sie auf den Pfeil für $datapoint.
12. Klicken Sie in der daraufhin angezeigten Variablenliste auf die Variable $datapoint.StartDate.

    Die Variable wird der Codezeile hinzugefügt. Diese Zeile definiert den StartDate-Wert als den Zeitpunkt, an dem der Ausfall gemeldet wurde.

    

13. Klicken Sie hinter StartDate, und drücken Sie die Eingabetaste, um eine neue Zeile einzufügen.

    Definieren Sie auf der nächsten Zeile die zweite Variable für die aktuelle Zeit.

14. Geben Sie var currentTime = ein.
15. Klicken Sie auf die Registerkarte Funktionen, und geben Sie in der Suchleiste den Text now ein. Wählen Sie in der Liste der Ergebnisse die Funktion Now() aus.

    

    Damit wird diese Funktion Ihrem Ausdruck hinzugefügt. Die Funktion Now() gibt das aktuelle Datum und die aktuelle Uhrzeit zurück.

    

    Als Nächstes verwenden Sie die zwei definierten Variablen zum Berechnen der verstrichenen Zeit mit der Funktion DateDiff. Die Funktion DateDiff subtrahiert zwei Datumsangaben und gibt die Differenz in den angegebenen Einheiten zurück. Bei dieser Berechnung soll die Zeit in Minuten zurückgegeben werden.

16. Beginnen Sie eine neue Zeile, und geben Sie die folgende Syntax ein: var minutesOpened = DateDiff(currentTime, dateOpened, 'minutes');

    Der vollständige Arcade-Code lautet wie folgt:

    var dateOpened = $datapoint.StartDate
    var currentTime = Now()
    var minutesOpened = DateDiff(currentTime, dateOpened, 'minutes');

    

    Das Ergebnis dieser Berechnung besagt, wie viele Minuten lang ein Ausfall aktiv war. Es kann jedoch vorkommen, dass Ausfälle mehrere Stunden oder sogar Tage andauern. In diesen Fällen ist die Anzahl der Minuten nicht sehr aussagekräftig. Mit einer in Arcade geschriebenen Funktion können Sie die Anzeige der verstrichenen Zeit in Minuten, Stunden und Tagen formatieren.

    Als Nächstes fügen Sie eine Funktion zum Formatieren der verstrichenen Zeit hinzu.

17. Drücken Sie zweimal die Eingabetaste, kopieren Sie die folgende Funktionsanweisung, und fügen Sie sie ein:

    //Define the function name.
    function formatElapsedTime(numMinutes) 
    { 
    //The elapsed time of an outage is not always a whole number.  
        numMinutes = Floor(Abs(numMinutes)); 
    //Using the Floor function, you can round down the time to number of hours and days. 
        var numHours = Floor((numMinutes/60),0); 
        var numDays = Floor((numMinutes/(60*24)),0); 
    //Using a When logic function, you can append the unit prefix to the value. 
        var elapsedTime = When( 
            numHours < 1, numMinutes + 'm', 
            numDays < 1, numHours + 'h ', 
            numDays + 'd ' 
             ); 
          return elapsedTime;  
    }

    Hinweis:

    Anhand der Kommentare im Ausdruck (die mit // beginnen) erfahren Sie, was der betreffende Teil der Funktion bewirkt.

    

    Diese Funktion rundet die Anzahl der Minuten auf die nächste ganze Zahl ab und verwendet dann die restlose Division, um aus diesen gerundeten Minuten die Stunden und Tage zu berechnen. Danach wird mit einer logischen When-Funktion das geeignete Einheitenpräfix angehängt.

    Jetzt können Sie Ihre Variable für die Ausfalldauer in ihrer endgültigen Form definieren. Diese Zeile erstellt die Variable timeFormatted, die die Ergebnisse der gerade erstellten Funktion formatElapsedTime nach Anwendung auf die Variable minutesOpened enthält, damit die verstrichene Zeit korrekt angezeigt wird.

18. Fügen Sie hinter Ihrer Funktion eine weitere Zeile ein, und geben Sie die folgende Syntax ein: var timeFormatted = formatElapsedTime(minutesOpened);

    Nach dem Berechnen der Ausfalldauer können Sie jetzt den Zuverlässigkeitswirkungsindex berechnen. Der Zuverlässigkeitswirkungsindex wird bestimmt, indem die Anzahl der betroffenen Kunden durch die Ausfalldauer dividiert wird.

19. Fügen Sie eine weitere Zeile ein, und geben Sie die folgende Syntax ein: var reliabilityIndex = Floor(($datapoint["ImpactedCustomers"]/minutesOpened),2);

    Diese neue Variable dividiert den Datenpunkt Impacted Customers durch die Variable minutesOpened, die Sie zuvor erstellt haben. Da dieser Wert wahrscheinlich ein Bruch sein wird, wird die Funktion Floor auf die gesamte Berechnung angewendet, um die Zahl auf zwei Dezimalstellen zu runden.

    Nachdem Sie den Zuverlässigkeitswirkungsindex berechnet haben, können Sie bestimmen, welche Ausfälle schwerwiegender sind oder wahrscheinlich ein sofortiges Eingreifen erfordern. Damit diese Ausfälle in der Liste sofort auffallen, sollten Sie eine Farbvariable erstellen, die die Ereignisse mit einem Zuverlässigkeitswirkungsindex größer als 1 hervorhebt.

20. Fügen Sie eine weitere Zeile ein, und geben Sie die folgende Syntax ein: var severityColor = IIF(reliabilityIndex > 1, '#C22E00', '#363636')

    Diese Variable verwendet die Funktion IFF, die, wenn eine Bedingung wahr (true) ist, einen bestimmten Wert, in diesem Fall eine bestimmte Farbe, und andernfalls einen anderen Wert zurückgibt. In diesem Fall wird, wenn der Wert für den Zuverlässigkeitswirkungsindex über dem Schwellenwert 1 liegt, die Farbe Rot verwendet. Andernfalls wird die Farbe Grau verwendet.

    Ihre endgültigen Variablen timeFormatted, reliabilityIndex und severityColor können Sie jetzt im Ausdruck zurückgeben. Danach können Sie sie in der Zeilenelementvorlage als neue Attribute referenzieren, um das Listenelement zu füllen.

21. Fügen Sie eine Zeile ein, und geben Sie am Ende Ihres Ausdrucks die folgende Syntax ein:
    return { 
      attributes: { 
        timeFormatted: timeFormatted, 
        reliabilityIndex: reliabilityIndex, 
        severityColor: severityColor 
    } 
    }

    Ihr Arcade-Editor sollte dann wie folgt aussehen:

    

    Der vollständige Code lautet:

    var dateOpened = $datapoint.StartDate
    var currentTime =Now()
    var minutesOpened = DateDiff(currentTime, dateOpened, 'minutes');
    
    //Define the function name. 
    function formatElapsedTime(numMinutes)
    {
    //The elapsed time of an outage is not always a whole number. 
        numMinutes = Floor(Abs(numMinutes));
    //Using the Floor function, you can round down the time to number of hours and days.
        var numHours = Floor((numMinutes/60),0);
        var numDays = Floor((numMinutes/(60*24)),0);
    //Using a When logic function, you can append the unit prefix to the value.
        var elapsedTime = When(
            numHours < 1, numMinutes + 'm',
            numDays < 1, numHours + 'h ',
            numDays + 'd '
             );
          return elapsedTime; 
    }
    
    var timeFormatted = formatElapsedTime(minutesOpened);
    var reliabilityIndex = Floor(($datapoint["ImpactedCustomers"]/minutesOpened),2);
    var severityColor = IIF(reliabilityIndex > 1, '#C22E00', '#363636')
    
    return {
      attributes: {
        timeFormatted: timeFormatted,
        reliabilityIndex: reliabilityIndex,
        severityColor: severityColor
    }
    }

22. Klicken Sie im unteren Bereich des Fensters auf die Schaltfläche Fertig.
23. Führen Sie im Bereich Listenoptionen einen Bildlauf nach unten bis unter das Textfeld Ausdruck durch, und klicken Sie unter Vorlage für Zeilenelement auf Quelle.

    

    In Dashboards können Sie benutzerdefinierten HTML-Code verwenden, um Ihre Listenelemente zu formatieren. Damit können Sie zusammen mit der erweiterten Formatierung benutzerdefinierte Visualisierungen erstellen, die nicht Teil der systemdefinierten Eigenschaften sind. Im Feld Vorlage für Zeilenelement können Sie Ihren soeben erstellten Ausdruck mit HTML verwenden, um die Formatierung der einzelnen Listenelemente bei der Anzeige zu definieren.

24. Löschen Sie die Zeile <p>{OBJECTID}</p>.
25. Kopieren Sie den folgenden Text, und fügen Sie ihn im Editor ein:
    <div style="background-color:#363636; border-left:3px solid white; padding:0.4rem 0.3rem 0.3rem 0.6rem"> 
    
    <p><span style="font-size:16px; opacity:1">Time elapsed: {expression/timeFormatted}</span></p> 
    
    <p><span style="font-size:14px; opacity:1; padding:1px">{UtilityCompany} - {County}</span></p> 
    
    <p><span style="background-color:{expression/severityColor}; border-radius:5px; font-size:14px; opacity:1; padding:1px 6px">SAIDI: {expression/reliabilityIndex}</span></p> 
    
    </div>

    

    Das erste Tag <div style> bestimmt das Strukturzeilenelement. Innerhalb von "div style" bestimmen Sie die Hintergrundfarbe, den Rahmen und Textabstand des Zeilenelements.

    Die nächsten Zeilen mit dem Absatz-Tag <p> bestimmen die Formatierung jeder einzelnen Information im Zeilenelement. Bei Ihrer Liste sollen die neu berechnete verstrichene Zeit, das Versorgungsunternehmen und der Zuverlässigkeitswirkungsindex angezeigt werden.

    Bestimmen Sie für jedes <p>-Tag die Formatierung unter Verwendung des <span style>-Tags und der gewünschten Formatierungseigenschaften. Innerhalb des <p>-Tags bestimmen Sie den Text, der im Zeilenelement angezeigt wird. In diesem Beispiel geben Sie im ersten <p>-Tag den anzuzeigenden Text "Time elapsed:" und direkt dahinter den Ausdruck für die verstrichene Zeit an.

26. Klicken Sie auf Quellcode, um eine Vorschau Ihrer Listenformatierung anzuzeigen.
27. Klicken Sie auf Fertig.

    Bei jedem Listenelement werden jetzt die verstrichene Zeit, das zugehörige Versorgungsunternehmen und der Wert für den Zuverlässigkeitswirkungsindex (SAIDI) angezeigt. Wenn der Wert höher als der Schwellenwert ist, wird er in Rot hervorgehoben.

    

Den Ausfallindikator konfigurieren

Nachdem Sie eine Liste der einzelnen gemeldeten Ausfälle erstellt haben, fügen Sie im nächsten Schritt einen Indikator hinzu. Dieser Indikator zeigt auf einen Blick, wie viele Ausfälle im US-Bundesstaat aktiv sind. Zusätzlich zur Anzeige der Anzahl der aktiven Ausfälle können Sie unter Verwendung eines Referenzwertes, einer erweiterten Formatierung und eines benutzerdefinierten HTML-Codes eine Warnung erstellen, die ausgegeben wird, wenn ein Ausfall gemeldet wurde.

1. Klicken Sie auf der Werkzeugleiste des Dashboards auf Element hinzufügen. Zeigen Sie auf das Kartenelement, klicken Sie auf die Schaltfläche "Hinzufügen" auf der rechten Seite und anschließend auf Indikator.
2. Klicken Sie im Fenster Indikator – Layer auswählen auf Power Outages (View) - Power Outage Incidents.

   Das Fenster Indikator wird geöffnet.

3. Blenden Sie auf der Registerkarte Daten den Abschnitt Referenz ein.
4. Wählen Sie für Referenztyp die Option Statistik aus.

   Anhand des Referenzwertes wird ermittelt, wann ein neuer Ausfall gemeldet wurde. Diesen Wert sollten Sie so filtern, dass nur die Ausfälle innerhalb der letzten 5 Minuten angezeigt werden. Damit wird festgelegt, dass nur ein Ausfall innerhalb der letzten 5 Minuten ein neuer Ausfall ist.

5. Klicken Sie neben Filtern auf die Schaltfläche Filter.
6. Erstellen Sie unter Filter den folgenden Ausdruck:
   • Klicken Sie für Feld für die Bedingung auf Startdatum/-zeit.
   • Wählen Sie den Operator liegt innerhalb des/der letzten aus.
   • Geben Sie den Wert 5 ein, und wählen Sie die Einheit Minuten aus.

   

   Nachdem Sie den Referenzwert festgelegt haben, können Sie mit erweiterter Formatierung die Datenwarnung einrichten, die dem Indikatortitel hinzugefügt werden soll.

7. Klicken Sie auf die Registerkarte Indikator.
8. Klicken Sie unter Erweiterte Formatierung auf Aktivieren.

   Unter Verwendung von Arcade können Sie mit einer logischen IFF-Funktion die Variable erstellen, anhand der bestimmt werden soll, wann die Warnung bei einem neuen Ausfall angezeigt werden soll. Ihre Bedingung sollte auf dem von Ihnen konfigurierten Referenzwert basieren. Diese Bedingung besagt, dass die Meldung angezeigt werden soll, wenn die Anzahl der Ausfälle, die innerhalb der letzten 5 Minuten gemeldet wurden, größer als Null ist. Andernfalls wird sie ausgeblendet.

9. Fügen Sie im Editor hinter den ersten Zeilen zur Definition der Variablen eine Zeile ein, und geben Sie die folgende Syntax ein: var visibility = IIF($reference.count_ObjectID > 0, 'visible', 'hidden').

   

   Als Nächstes müssen Sie die Sichtbarkeitsbedingung und all das, was der Indikator anzeigen soll, zurückgeben. Sie müssen auch die Meldung erstellen, die angezeigt werden soll, wenn ein neuer Ausfall gemeldet wurde. In diesem Fall konfigurieren Sie die Meldung so, dass sie besagt, dass in den letzten 5 Minuten ein neuer Ausfall gemeldet wurde.

10. Löschen Sie im Editor den Code-Block von return { bis zur letzten Zeile.
11. Kopieren Sie den folgenden Text, und fügen Sie ihn an dieser Stelle ein:
    return { 
        middleText: $datapoint["count_ObjectID"], 
        middleTextMaxSize: 'large', 
        bottomText:'Active outages', 
        bottomTextMaxSize: 'medium', 
        attributes: { 
           visibility: visibility,  
           message: 'New outage reported in the last 5 mins' 
       } 
    
    }

    In der Return-Anweisung werden die verschiedenen Eigenschaften des Indikators definiert. Für diesen Indikator verwenden Sie nur die Textbereiche in der Mitte und unten. Sie sollten auch die Sichtbarkeitsvariable ("visibility") definieren, die mit der Meldung angezeigt wird, wenn die Sichtbarkeitsbedingung erfüllt ist.

    Tipp:

    Alle Teile eines Indikators können Sie mit erweiterter Formatierung definieren. Diese Eigenschaften werden andernfalls unter Verwendung der Standard-Konfigurationseinstellungen des Indikators definiert. Eine vollständige Liste der Indikatoreigenschaften, die definiert werden können, finden Sie unter Erweiterte Formatierung in einem Indikator.

12. Klicken Sie auf die Registerkarte Allgemein.
13. Klicken Sie im Bereich Allgemeine Optionen für den Abschnitt Titel auf Bearbeiten.

    

14. Klicken Sie im Rich-Text-Editor auf Quellcode.
15. Kopieren Sie den folgenden Text, und fügen Sie ihn im Editor ein:
    <div style="background-color:#de290033; border-left:2px solid #de2900; box-shadow:0 4px 6px 0 hsla(0,0%,0%,0.2); color:##de2900; margin-bottom:0.4rem; margin-left:0.4rem; margin-right:0.4rem; margin-top:0.1rem; padding:0.7rem; visibility: {expression/visibility}; width:98%"> 
    <span style="font-size:16px">{expression/message} </span> 
    
    </div>

    In diesem Fall wird HTML zum Definieren der Style-Eigenschaften der Meldung verwendet. Das erste Tag <div style> bestimmt die Struktur. Innerhalb des <div style>-Tags werden verschiedene Eigenschaften festgelegt, wie zum Beispiel Hintergrundfarbe und Rahmen. Die Sichtbarkeit der Meldung wird durch den Sichtbarkeitsausdruck, den Sie bereits erstellt haben, gesteuert.

16. Klicken Sie auf Quellcode, um eine Vorschau Ihrer Meldung anzuzeigen.
17. Klicken Sie auf Fertig.

    Ihr Ausfallindikator zeigt jetzt die Gesamtzahl der aktiven Ausfälle im US-Bundesstaat an.

    

    Wenn innerhalb der letzten 5 Minuten ein Ausfall gemeldet wurde, wird die Warnmeldung im oberen Bereich angezeigt.

    

Den Kundenbetroffenheitsindikator konfigurieren

Das letzte Element, das Sie hinzufügen müssen, ist ein Indikator, der die Anzahl der Kunden, die durch die Ausfälle betroffen sind, aufgeschlüsselt nach geplanter und ungeplanter Unterbrechung zusammenfasst. Die Kenntnis der Anzahl der betroffenen Kunden ist wichtig, um die Situation besser beurteilen zu können.

1. Klicken Sie auf der Werkzeugleiste des Dashboards auf Element hinzufügen. Zeigen Sie auf das Indikatorelement, und klicken Sie oben auf die Schaltfläche "Hinzufügen". Wählen Sie Indikator aus.
2. Klicken Sie im Fenster Indikator – Layer auswählen auf Power Outages (View) - Power Outage Incidents.
3. Wählen Sie im Bereich Datenoptionen für Statistik die Option Summe aus. Wählen Sie für Feld die Option Impacted Customers aus.

   

4. Blenden Sie den Abschnitt Referenz ein, und wählen Sie für Referenztyp die Option Statistik aus.

   Im Abschnitt Referenz werden weitere Optionen angezeigt

5. Klicken Sie für Filtern auf die Schaltfläche Filter.
6. Wählen Sie in der Dropdown-Liste Feld für die Bedingung das Feld Outage Type aus.
7. Vergewissern Sie sich, dass für den Operator gleich ausgewählt ist. Wählen Sie auf der Registerkarte Wert die Option Geplant aus.

   

8. Wählen Sie für Statistik die Option Summe aus. Wählen Sie für Feld die Option Impacted Customers aus.

   

   Jetzt haben Sie den Wert und den Referenzwert für die Verwendung in der Anzeige Ihres Indikators festgelegt. In diesem Fall ist der Wert die Gesamtzahl der betroffenen Kunden, und der Referenzwert ist die Gesamtzahl der von geplanten Unterbrechungen betroffenen Kunden.

9. Klicken Sie auf die Registerkarte Indikator.

   Werte, Referenzwerte und vordefinierte Berechnungen können direkt in die Visualisierung des Indikators aufgenommen werden. Dazu werden entweder geschweifte Klammern {} oder die Schaltfläche Felder: {} verwendet.

10. Geben Sie im Bereich Indikatoroptionen Folgendes ein:
    • Geben Sie für Text oben den Text Impacted customers ein.
    • Geben Sie für Text Mitte den Text Total:{calcualted/value} ein.
    • Geben Sie für Text unten den Text Planned:{calculated/reference} Unplanned: {calculated/difference} ein.

    

11. Blenden Sie den Abschnitt Wertformatierung ein
12. Deaktivieren Sie die Einstellung Einheitenpräfix.

    

    Dadurch werden die exakten Werte für die betroffenen Kunden angezeigt.

13. Klicken Sie auf Fertig.

    Die Indikatoranzeige enthält jetzt die Gesamtzahl der betroffenen Kunden sowie die Anzahl der von geplanten und von ungeplanten Unterbrechungen betroffenen Kunden.

    

    Als Nächstes ordnen Sie die Dashboard-Indikatoren an.

14. Zeigen Sie mit der Maus auf die linke Kante der Indikatorspalte, damit der Größenänderungscursor angezeigt wird. Ziehen Sie die Spalte so, dass die Karte größer und die Indikatoren kleiner werden.

    

15. Zoomen und schwenken Sie die Karte im Kartenelement, um die Daten um den US-Bundesstaat Kalifornien zu zentrieren.
16. Schließen Sie ggf. das Fenster Layout für eine bessere Vorschau der Dashboards.

    

17. Klicken Sie auf der Werkzeugleiste "Dashboard" auf Speichern, und wählen Sie Speichern aus, um Ihr Dashboard zu speichern.

    

In diesem Lernprogramm haben Sie eine Stromausfallkarte und ein Dashboard erstellt, auf dem neu gemeldete Ausfälle im US-Bundesstaat Kalifornien nahezu in Echtzeit angezeigt werden. Mit einer erweiterten Formatierung von Listen- und Indikatorelementen waren Sie in der Lage, Daten, die nicht ohne Weiteres verfügbar waren, abzuleiten und zu visualisieren. Zusätzlich zum Visualisieren neuer Informationen konnten Sie eine Warnung konfigurieren, die ausgegeben wird, wenn ein Ausfall gemeldet wurde. Wenn die neu gemeldeten Ausfälle sofort angezeigt werden, können Städte, Landkreise und US-Bundesstaaten fundierte Entscheidungen treffen und Ressourcen mobilisieren, um Probleme effizienter zu lösen.

Weitere Lernprogramme finden Sie in der Lernprogrammgalerie.

Beiträge anderer Softwarehersteller

• Von der Katastrophenschutzbehörde des Gouverneurs von Kalifornien (California Governor's Office of Emergency Services, Cal OES) stammende Informationen zu Stromausfällen in Kalifornien.
• Straßen (Nacht): Esri, TomTom, Garmin, FAO, NOAA, USGS, © OpenStreetMap-Mitwirkende und die GIS-Anwender-Community