Benutzerdefinierte Prozessaktionen aus einem Workflow konfigurieren

Sie können eine benutzerdefinierte Prozessaktion von einem Echtzeitworkflow aktivieren, ohne Code zu schreiben. Weitere Informationen: Benutzerdefinierte Aktionen aus einem Workflow aufrufen

Möglicherweise können Sie auch eine benutzerdefinierte Prozessaktion erstellen, die bewirkt, dass ein Entwickler sie in Code verwenden kann, oder Sie müssen eine vorher definierte Aktion bearbeiten. Denken Sie wie bei Echtzeit-Workflowprozessen dabei an Folgendes:

• Was soll die Aktion bewerkstelligen?

• Unter welchen Bedingungen soll die Aktion ausgeführt werden?

Im Gegensatz zu Echtzeit-Workflowprozessen müssen Sie die folgenden Optionen nicht festlegen:

• Starten bei: Benutzerdefinierte Prozessaktionen starten, wenn der Code die für sie generierte Meldung aufruft.

• Umfang: Benutzerdefinierte Prozessaktionen werden immer im Kontext des aufrufenden Benutzers ausgeführt.

• Im Hintergrund ausführen: Benutzerdefinierte Prozessaktionen sind immer Echtzeitworkflows.

Im Gegensatz zu Echtzeitworkflowprozessen verfügen benutzerdefinierte Prozessaktionen über Eingabe- und Ausgabeargumente. Weitere Informationen: Prozessargumente definieren

Eine benutzerdefinierte Prozessaktion erstellen

Wichtig

Wenn Sie eine Aktion erstellen, die als Teil einer Lösung eingeschlossen sein soll, die verteilt wird, erstellen Sie sie im Kontext der Lösung. Navigieren Sie zu Einstellungen > Lösungen, und suchen Sie die nicht verwaltete Lösung, deren Teil diese Aktion sein wird. Wählen Sie dann auf der Menüleiste Neu > Prozess aus. Dadurch wird sichergestellt, dass das dem Namen der Aktion zugeordnete Anpassungspräfix konsistent mit den anderen Komponenten in der Lösung ist. Nachdem Sie die Aktion erstellt haben, können Sie das Präfix nicht mehr ändern.

Hinweis

Wenn Sie beabsichtigen, ein Plug-in zu schreiben, um Ihre Logik für eine Custom Process Action zu implementieren, anstatt den Workflow Designer zu verwenden, sollten Sie stattdessen eine Custom-API verwenden. Weitere Informationen: Vergleich Custom Process Action und Custom-API

Wie Echtzeit-Workflowprozesse verfügen Aktionen über die folgenden Eigenschaften im Dialogfeld Prozess erstellen:

• Prozessname

  Nachdem Sie einen Namen für den Prozess eingegeben haben, wird ein eindeutiger Name für ihn erstellt, indem alle Sonderzeichen oder Leerzeichen vom Prozessnamen entfernt werden.

• Kategorie

  Diese Eigenschaft legt fest, dass es sich um einen Aktionsprozess handelt. Eine spätere Änderung ist nach dem Speichern des Prozesses nicht möglich.

• Entität

  Bei Aktionsprozessen können Sie eine Tabelle auswählen, um den Kontext für den Echtzeit-Workflow bereitzustellen, wie bei anderen Arten von Prozessen, Sie haben aber auch die Möglichkeit zur Auswahl von Keine (global). Verwenden Sie diese Option, wenn Ihre Aktion nicht den Kontext einer bestimmten Tabelle erfordert. Eine spätere Änderung ist nach dem Speichern des Prozesses nicht möglich.

• Art

  Verwenden Sie diese Eigenschaft, um zu wählen, ob Sie eine neue benutzerdefinierte Prozessaktion von Grund auf erstellen oder von einer vorhandenen Vorlage ausgehen.

Aktionen bearbeiten

Sie müssen Prozesse deaktivieren, bevor Sie sie bearbeiten können.

Sie können eine benutzerdefinierte Prozessaktion bearbeiten, die als Teil einer nicht verwalteten Lösung erstellt oder einer Lösung hinzugefügt wurde, die in Ihrer Organisation eingerichtet wurde. Ist die Lösung eine verwaltete Lösung, können Sie sie möglicherweise nicht bearbeiten. Der Lösungsherausgeber hat die Möglichkeit, die verwalteten Eigenschaften zu bearbeiten, sodass die Aktion, die mit einer verwalteten Lösung installiert wurde, nicht bearbeitet werden kann.

Wenn eine Aktion gespeichert wird, wird ein eindeutiger Name auf der Grundlage des Prozessnamens generiert. Diesem eindeutigen Namen wird das Anpassungspräfix des Lösungsherausgeber hinzugefügt. Dies ist der Name der Meldung, die ein Entwickler in seinem Code verwendet.

Wenn Sie eine Aktion bearbeiten, stehen Ihnen die folgenden Optionen zur Verfügung:

• Prozessname

  Wenn der Prozess erstellt und der eindeutige Name des Prozesses generiert wird, können Sie den Prozessnamen bearbeiten. Möglicherweise möchten Sie eine Namenskonvention verwenden, die das Finden bestimmter Prozesse erleichtert.

• Eindeutiger Name

  Wenn eine benutzerdefinierte Prozessaktion gespeichert wird, wird ein eindeutiger Name auf der Grundlage des Prozessnamens generiert. Diesem eindeutigen Namen wird das Anpassungspräfix des Lösungsherausgeber hinzugefügt. Dies ist der Name der Meldung, die ein Entwickler in seinem Code verwendet. Ändern Sie diesen eindeutigen Namen nicht, wenn der Prozess aktiviert und Code vorhanden ist, der den Aufruf der Aktion mit diesem Namen erwartet.

  Wichtig

  Nachdem die Aktion aktiviert wurde und Code für die Verwendung eines eindeutigen Namens geschrieben wird, darf dieser eindeutige Name nicht geändert werden, ohne auch den referenzierenden Code zu ändern.

• Rollback aktivieren

  Im Allgemeinen machen Prozesse, die Transaktionen unterstützen, den gesamten Vorgang „rückgängig“ (oder setzen ihn zurück), wenn ein Teil von ihnen fehlschlägt. Es gibt Ausnahmen davon. Aktionen, die von einem Entwickler aus dem Code ausgeschlossen wurden, und die von der benutzerdefinierten Prozessaktion initiiert werden, unterstützen möglicherweise keine Transaktionen. Ein Beispiel wäre, wenn der Code in anderen Systemen Aktionen ausführt, die sich außerhalb des Bereiches der Transaktion befinden. Diese können von der Aktion, die in einer App ausgeführt wird, nicht rückgängig gemacht werden. Einige Meldungen in der Plattform unterstützen keine Transaktionen. Aber alles, was Sie mit der Benutzeroberfläche der Aktion tun können, unterstützt Transaktionen. Alle Aktionen, die Teil eines Echtzeitworkflows sind, gelten als "in Transaktion", bei Aktionen können Sie dies jedoch deaktivieren.

  Fragen Sie den Entwickler, der diese Nachricht verwendet, um festzulegen, ob sie in Transaktion sein muss oder nicht. Im Allgemeinen sollte eine Aktion in Transaktion sein, wenn die Aktionen, die vom Geschäftsprozess ausgeführt werden, sinnlos sind, wenn sie nicht alle erfolgreich ausgeführt werden. Das klassische Beispiel ist die Übertragung von Geldbeträgen zwischen zwei Bankkonten. Wenn Sie Geld von einem Konto abheben, müssen Sie es auf das andere einzahlen. Wenn einer dieser Vorgänge fehlschlägt, schlagen beide fehl.

  Hinweis

  • Sie können Rollback nicht aktivieren, wenn eine benutzerdefinierte Prozessaktion direkt von einem Workflow aus aufgerufen wird. Sie können den Rollback aktivieren, wenn eine benutzerdefinierte Prozessaktion von der Meldung eines Power Apps-Webdiensts ausgelöst wird.
  • Wenn die definierte Aktion keine Daten ändert, sondern nur Daten abruft, gibt es bestimmte Situationen, in denen die Leistung durch Deaktivieren verbessert werden kann, indem Zurücksetzung aktivieren deaktiviert wird.

• Aktivieren als

  Wie bei allen Prozessen können Sie den Prozess als Vorlage aktivieren und als Ausgangspunkt für Prozesse verwenden, die einem ähnlichen Muster folgen.

• Prozessargumente definieren

  In diesem Bereich geben Sie alle Daten an, die die Aktion für ihren Start erwartet, sowie die Daten, die von der Aktion ausgegeben werden. Weitere Informationen: Prozessargumente definieren

• Hinzufügen von Phasen, Bedingungen und Aktionen

  Wie bei anderen Prozessen geben Sie an, welche Aktionen auszuführen sind und wann sie ausgeführt werden sollen. Weitere Informationen: Phasen, Bedingungen und Aktionen hinzufügen

Prozessargumente definieren

Wenn ein Entwickler eine Meldung verwendet, beginnt er möglicherweise mit Daten, die in die Meldung eingegeben werden. Um beispielsweise eine neue Fallzeile zu erstellen, gibt es möglicherweise den Falltitelwert, der als das Eingabeargument eingegeben wird.

Wenn die Meldung abgeschlossen ist, muss der Entwickler möglicherweise einige dadurch geänderte oder generierte Daten an einen anderen Vorgang in seinem Code übergeben. Diese Daten sind das Ausgabeargument.

Ein- und Ausgabeargumente müssen einen Namen, einen Typ sowie Informationen dazu, ob sie immer erforderlich sind, haben. Sie können auch eine Beschreibung angeben.

Der Name der Meldung und Informationen zu allen Prozessargumenten sind gemeinsam die Signatur der Meldung. Nachdem eine Aktion aktiviert wurde und in Code verwendet wird, darf sich die Signatur nicht ändern. Wenn sich diese Signatur ändert, schlägt jeder Code, der diese Meldung verwendet, fehl. Die einzige Ausnahme dazu könnte das Ändern eines der Parameter sein, so dass das Argument nicht immer erforderlich ist.

Sie können die Reihenfolge der Argumente ändern, indem Sie diese sortieren oder nach oben oder unten verschieben, da die Argumente nach Namen und nicht nach Reihenfolge identifiziert werden. Das Ändern der Beschreibung führt auch nicht zur Beschädigung des Codes, der die Meldung verwendet.

Aktionsprozessargumenttypen

Die folgende Tabelle beschreibt die Aktionsprozessargumenttypen.

Typ	Beschreibung
Boolean	Ein true- oder false-Wert.
DateTime	Ein Wert, der Datums- und Uhrzeitinformationen speichert.
Dezimal	Ein Zahlenwert mit dezimaler Präzision. Wird verwendet, wenn die Präzision sehr wichtig ist.
Tabelle	Eine Zeile für die angegebene Tabelle. Wenn Sie Tabelle auswählen, wird die Dropdownliste aktiviert und ermöglicht Ihnen die Auswahl des Tabellentyps.
entityCollection	Eine Sammlung von Tabellenzeilen.
entityReference	Ein Objekt, das den Namen, den Typ und die ID einer Tabellenzeile enthält, die es eindeutig identifiziert. Wenn Sie Tabellenreferenz auswählen, wird die Dropdownliste aktiviert und ermöglicht Ihnen die Auswahl des Tabellentyps.
Float	Ein Zahlenwert mit dezimaler Präzision. Wird verwendet, wenn Daten aus einer nicht absolut präzisen Messung stammen.
Integer	Eine ganze Zahl.
Zahlung	Ein Wert, der Daten zu einem Geldbetrag speichert.
Picklist	Ein Wert, der eine Option für ein OptionSet-Attribut darstellt.
Zeichenfolge	Ein Textwert.

Hinweis

entityCollection-Argumentwerte können nicht auf der Benutzeroberfläche für Bedingungen oder Aktionen festgelegt werden. Diese werden für Entwickler zur Verwendung in benutzerdefiniertem Code bereitgestellt. Weitere Informationen: Erstellen eigener Meldungen

Hinzufügen von Phasen und Schritten

Aktionen sind ein Prozesstyp, der den Echtzeitworkflows sehr ähnlich ist. Alle Schritte, die in den Echtzeitworkflows verwendet werden können, sind auch in Aktionen möglich. Informationen zu den Schritten für Echtzeit-Workflows und Aktionen finden Sie unter Workflowphasen und -schritte.

Aktionen können neben den Schritten, die für Echtzeitworkflows verwendet werden können, auch über den Schritt Wert zuweisen verfügen. In Aktionen können diese nur verwendet werden, um Ausgabeargumente festzulegen. Sie können den Formular-Assistenten verwenden, um Ausgabeargumente auf bestimmte Werte zu setzen, oder, wahrscheinlicher, auf Werte aus der Zeile, auf deren Grundlage die Aktion operiert, von über n:1-Beziehungen mit dieser Zeile verknüpften Zeilen, von in einem früheren Schritt erstellten Zeilen oder auf Werte, die Teil des Prozesses selbst sind.

Verwaltete Eigenschaften

Benutzerdefinierte Prozessaktionen verfügen über zwei relevante verwaltete Eigenschaften

Ist anpassbar

Das verwaltete Is Customizable-Eigenschaft steuert, ob jemand, der eine verwaltete Lösung installiert, die die benutzerdefinierte Prozessaktion enthält, diese bearbeiten oder löschen kann. Wenn Sie möchten, dass die benutzerdefinierte Prozessaktion bearbeitet oder gelöscht wird, wenn sie in einer verwalteten Lösung enthalten ist, sollten Sie diese Eigenschaft auf „true“ setzen.

Is Custom Processing Step Allowed for Other Publishers

Die verwaltete Eigenschaft Is Custom Processing Step Allowed for Other Publishers steuert, ob Plug-In-Entwickler von Drittanbietern Plug-In-Schritte für die durch die benutzerdefinierte Prozessaktion erstellte Nachricht registrieren können. Wenn dies zutrifft, werden Plug-Ins ausgeführt, die von einer anderen Person in dieser Nachricht registriert wurden, und können das Verhalten der benutzerdefinierten Prozessaktion ändern. Bei „false“ werden nur Plug-In-Schritte ausgeführt, die in einer Lösung von demselben Lösungsherausgeber registriert sind.

Nächste Schritte

Aktionen verwenden
Benutzerdefinierten Aktionen aus einem Workflow aufrufen
Überwachung von Echtzeitworkflows und -Aktionen

Hinweis

Können Sie uns Ihre Präferenzen für die Dokumentationssprache mitteilen? Nehmen Sie an einer kurzen Umfrage teil. (Beachten Sie, dass diese Umfrage auf Englisch ist.)

Die Umfrage dauert etwa sieben Minuten. Es werden keine personenbezogenen Daten erhoben. (Datenschutzbestimmungen).