Hinzufügen und Konfigurieren des Schrittes "E-Mail senden"

Mit dem Schritt "E-Mail senden" wird eine E-Mail-Benachrichtigung an einen oder mehrere Empfänger gesendet, wenn der Schritt ausgeführt wird. Dieser Schritttyp kann verwendet werden, um Benachrichtigungen zu senden, wenn ein Schritt oder Auftrag abgeschlossen wurde oder wenn ein Schritt nicht erfolgreich abgeschlossen wurde.

Vor dem Senden von E-Mail-Benachrichtigungen mithilfe des Schrittes "E-Mail senden" können Sie optional für ArcGIS Workflow Manager Einstellungen für E-Mail-Benachrichtigung konfigurieren. Mit benutzerdefinierten SMTP-Servereinstellungen können Sie Anlagen einbinden, die E-Mail-Adressen anstelle von Benutzernamen oder einer Gruppen-ID verwenden und die Textfelder CC und BCC aktivieren.

Hinweis:

Möglicherweise müssen Sie benutzerdefinierte Rollen ändern, um die E-Mail-Adressen von Mitgliedern der Organisation mit ArcGIS Arcade-Ausdrücken abzurufen.

Konfigurieren des Schrittes

Um den Schritt zu konfigurieren, gehen Sie wie folgt vor:

  1. Erstellen oder bearbeiten Sie ein Workflow-Diagramm, um das Fenster Schrittbibliothek aufzurufen.
  2. Ziehen Sie E-Mail senden aus dem Fenster Schrittbibliothek auf den Verbindungspfeil eines Schrittes auf der Workflow-Zeichenfläche.

    Das Fenster Schrittdetails wird angezeigt.

  3. Geben Sie in das Textfeld Schrittname einen Namen für den Schritt ein.
  4. Klicken Sie optional auf die Umschaltfläche Benutzerdefinierten SMTP-Server aktivieren, um Ihren SMTP-Server zum Senden von E-Mails zu verwenden.
  5. Wenn Sie keinen benutzerdefinierten SMTP-Server konfiguriert haben, wählen Sie eine der folgenden Optionen für Empfängertyp aus, und geben Sie im Textfeld An die Empfänger an:
    • Benutzernamen: Geben Sie eine Liste mit durch Semikolons getrennten Benutzernamen an, oder verwenden Sie einen Arcade-Ausdruck, um eine dynamische Liste mit Empfängern zu erstellen. Arcade-Ausdrücke müssen in doppelten Anführungszeichen angegeben werden.
    • Gruppen-ID: Geben Sie eine einzelne Gruppen-ID an, oder verwenden Sie einen Arcade-Ausdruck, um eine Gruppen-ID abzurufen. Arcade-Ausdrücke müssen in doppelten Anführungszeichen angegeben werden.

    Im Textfeld An muss mindestens ein gültiger Benutzername, eine gültige Gruppen-ID oder ein gültiger Arcade-Ausdruck angegeben werden.

    Vorsicht:

    Wenn Sie über keinen benutzerdefinierten SMTP-Server verfügen, beträgt die maximale Anzahl der Empfänger 50. Arcade-Ausdrücke können dazu führen, dass die Empfängerliste die maximal zulässige Größe überschreitet.

    Ein Benutzername

    JDoe

    Eine Gruppen-ID

    7dr6de56442840ccbf49b3f869f49b27

    Mehrere Benutzernamen

    JDoe;KSmith;MFields

    Ein Arcade-Ausdruck

    "GetUser($CurrentPortal, jobOwner($job))['username']"

    Mehrere Arcade-Ausdrücke

    "GetUser($CurrentPortal, jobOwner($job))['username']";"jobCreator($job)";"lastRunner($job, '8b107614-c6dc-20b3-c232-e03bf7c007bc')"

    Benutzernamen und Arcade-Ausdrücke

    JDoe;"GetUser($CurrentPortal, jobOwner($job))['username']";KSmith;"lastRunner($job, '8b107614-c6dc-20b3-c232-e03bf7c007bc')"

    Tipp:

    Klicken Sie auf Diese Eingabe unterstützt Arcade-Ausdrücke This input supports Arcade expressions, und wählen Sie einen ArcGIS Arcade-Ausdruck für das zugehörige Textfeld aus.

  6. Wenn Sie über einen benutzerdefinierten SMTP-Server verfügen, geben Sie E-Mail-Adressen in den Textfeldern An, CC bzw. BCC durch Semikolons getrennt ein, oder verwenden Sie einen ArcGIS Arcade-Ausdruck, um eine dynamische Liste mit Empfängern zu erstellen. Arcade-Ausdrücke müssen in doppelten Anführungszeichen angegeben werden.

    In einem der Textfelder An, CC bzw. BCC muss mindestens eine gültige E-Mail-Adresse oder ein gültiger Arcade-Ausdruck angegeben werden.

    Eine E-Mail-Adresse

    user1@test.com

    Mehrere E-Mail-Adressen

    user1@test.com;user2@test.com;user3@test.com;user4@test.com

    Ein Arcade-Ausdruck

    "GetUser($CurrentPortal, JobOwner($Job))['Email']"

    Mehrere Arcade-Ausdrücke

    "GetUser($CurrentPortal, JobOwner($Job))['Email']";"GetUser($CurrentPortal)['Email']";"GetUser($CurrentPortal, LastRunner($Job, 'f50d740d-cc04-9296-4ce3-181e82604465'))['Email']"

    E-Mail-Adressen und Arcade-Ausdrücke

    user1@test.com;"GetUser($CurrentPortal, JobOwner($Job))['Email']";user3@test.com;"GetUser($CurrentPortal)['Email']"

    Tipp:

    Klicken Sie auf Diese Eingabe unterstützt Arcade-Ausdrücke This input supports Arcade expressions, und wählen Sie einen ArcGIS Arcade-Ausdruck für das zugehörige Textfeld aus.

  7. Geben Sie im Textfeld Betreff einen Betreff für die E-Mail-Benachrichtigung ein.

    Sie müssen einen Betreff eingeben. Das Feld Betreff darf nicht leer bleiben.

    Sie können auch Arcade-Ausdrücke verwenden, um für den Betreff einen dynamischen Wert bereitzustellen. Wenn der Betreff Text und Arcade-Ausdrücke enthält, formatieren Sie den Text wie folgt:

    JobName($Job) + 'is ready'

  8. Geben Sie im Textfeld Text einen Meldungstext für die E-Mail-Benachrichtigung ein.

    Sie müssen im Textkörper eine Meldung eingeben. Das Feld Text darf nicht leer bleiben.

    Sie können auch Arcade-Ausdrücke verwenden, um für den Textkörper einen dynamischen Wert bereitzustellen.

    Wenn der Textkörper Text und Arcade-Ausdrücke enthält, formatieren Sie den Text wie folgt:

    '<b>' + JobName($Job) + '</b>, created by <b>' + JobCreator($Job) + '</b>, was started on <b>' + Text(Date(JobStartDate($Job)), 'dddd, MMMM D, Y') + '</b>.'
    Vorsicht:

    Wenn Sie nicht über einen benutzerdefinierten SMTP-Server verfügen, ist die Größe der E-Mail auf 100 KB begrenzt. Arcade-Ausdrücke können dazu führen, dass für den Textkörper die maximal zulässige Größe überschritten wird.

  9. Wenn Sie über einen benutzerdefinierten SMTP-Server verfügen, können Sie mithilfe der folgenden Optionen unter Anlagen einbeziehen Anlagen in die E-Mail-Benachrichtigung einbinden:
    • Keine: Keine Auftragsanlagen in die E-Mail-Benachrichtigung einbinden.
    • Alle: Alle Ordner mit Auftragsanlagen in die E-Mail-Benachrichtigung einbinden.
    • Nach Ordner: Geben Sie in das Textfeld Nach Ordner eine Liste mit Namen von Ordnern mit Auftragsanlagen ein, um die Ordner mit Auftragsanlagen anzugeben, die in die E-Mail-Benachrichtigung eingebunden werden sollen.
      Hinweis:

      Ordner mit Auftragsanlagen sind im Workflow-Element enthalten. Es handelt sich hierbei nicht um Dateisystempfade.

    Hinweis:

    Wenn ein Auftrag mehrere Anlagen enthält, werden diese als einzelne .zip-Datei gesendet, wobei die Anlagenordnerstruktur des Auftrags erhalten bleibt.

  10. Klicken Sie ggf. auf E-Mail-Vorschau anzeigen, um die E-Mail in einer Vorschau anzuzeigen.
    Hinweis:

    Wenn die E-Mail auftragsspezifische Arcade-Ausdrücke enthält, müssen Sie in das Textfeld E-Mail-Vorschau anzeigen eine gültige Auftrags-ID eingeben, damit Sie den Arcade-Ausdruck in einer Vorschau anzeigen können. Wenn die E-Mail für den Ausgabewert eines Schrittes einen Arcade-Ausdruck enthält, muss der Schritt ausgeführt werden, damit der Ausgabewert in einer Vorschau angezeigt werden kann.

    Im Fenster Vorschau der E-Mail wird eine Empfängerliste und eine Vorschau von Betreff und Textkörper angezeigt.

  11. Klicken Sie auf die Registerkarte Options.
  12. Konfigurieren Sie Schrittoptionen nach Bedarf:
    • Manuell: Der Schritt wird manuell ausgeführt.
      • Optional: Der Schritt kann fertiggestellt werden, ohne dass er ausgeführt wird.
    • Automatisch: Der Schritt wird ausgeführt, sobald er aktiviert wird.
      Hinweis:

      Wenn das Workflow-Diagramm so konfiguriert ist, dass automatisch eine Folge von Schritten ausgeführt wird, in der der Schritt "GP-Service ausführen" enthalten ist, werden Schritte nach Ablauf des Benutzer-Token nicht automatisch ausgeführt. Wenn zusätzliche automatisierte Schritte ohne manuellen Eingriff ausgeführt werden sollen, müssen Sie über die Organisationserweiterung "ArcGIS Workflow Manager Advanced" verfügen.

    • Nach einem Zeitplan ausführen: Der Schritt wird nach einem festgelegten Zeitplan ausgeführt.

      Weitere Informationen zu Planungsoptionen

  13. Wählen Sie optional eine der folgenden Optionen, um die Hilfe in diesem Schritt zu konfigurieren:
    • Keine: Hierüber konfigurieren Sie den Schritt ohne Schritthilfe.
    • Text: Hierüber konfigurieren Sie den Hilfetext für den Schritt im Textfeld Text.

      Sie können ArcGIS Arcade-Ausdrücke verwenden, um für die Hilfe zum Schritt einen dynamischen Wert bereitzustellen. Wenn die Schritthilfe Text und Arcade-Ausdrücke enthält, muss der Text wie folgt formatiert werden:

      
      'For further assistance, please contact' + JobCreator($Job) + '.'

    • URL: Hierüber konfigurieren Sie den Schritt mit einem Link zu einer Hilfe im Textfeld URL.
      Hinweis:

      Bei in der Web-App ausgeführten Schritten werden nur die URL-Formate HTTP und HTTPS unterstützt. Bei in ArcGIS Pro ausgeführten Schritten werden HTTP, HTTPS und Dateiformate unterstützt.

      Sie können auch Arcade-Ausdrücke verwenden, um einen dynamischen Wert bereitzustellen. Wenn die URL Text und Arcade-Ausdrücke enthält, muss der Text wie folgt formatiert werden:

      
      'https://pro.arcgis.com/en/pro-app/latest/tool-reference/' + JobExtendedProperty($Job, 'tools', 'toolbox') + '/' + jobExtendedProperty($job, 'tools', 'alias') + '.htm'

      Konfigurieren Sie das Kontrollkästchen Arcade-Ergebnis automatisch codieren wie folgt:

      • Wenn ein Arcade-Ausdruck ein Ergebnis zurückgibt, in dem Sonderzeichen enthalten sind, die beim Konvertieren in eine URL mit Escape-Zeichen versehen werden müssen, wie zum Beispiel ein Leerzeichen oder ein Schrägstrich, dann stellen Sie sicher, dass das Kontrollkästchen Arcade-Ergebnis automatisch codieren aktiviert ist.
      • Wenn ein Arcade-Ausdruck zum Erstellen der Basis-URL verwendet wird, dann deaktivieren Sie das Kontrollkästchen Arcade-Ergebnis automatisch codieren.

  14. Klicken Sie ggf. auf die Registerkarte Style, um Form und Farbe für den Schritt zu ändern.
  15. Klicken Sie ggf. auf die Registerkarte Info, und geben Sie im Textfeld Schrittbeschreibung eine Beschreibung für den Schritt ein.
    Tipp:

    Die Registerkarte Info enthält auch die ID des Schrittes, die zusammen mit dynamischen Auftragseigenschaften verwendet werden kann, um das Ergebnis eines Schrittes abzurufen. Klicken Sie auf Schritt-ID kopieren Copy Step ID, um die Schritt-ID in die Zwischenablage zu kopieren.

Rückgabewert

Nach Abschluss des Schrittes wird der Rückgabewert gespeichert, um das Ergebnis des Schrittes anzuzeigen. Der Rückgabewert kann mithilfe von Pfaden sofort ausgewertet werden, um die nächsten Schritte im Workflow zu bestimmen. Mithilfe von ArcGIS Arcade-Ausdrücken können Sie während des gesamten Workflows auch den Rückgabewert eines abgeschlossenen Schrittes abrufen. In der folgenden Tabelle sind die Rückgabewerte des Schrittes aufgeführt:

RückgabewertBeschreibung

S000001

Der Schritt wurde erfolgreich abgeschlossen.

F000001

Der Schritt wurde nicht erfolgreich abgeschlossen.

Verwandte Themen