Freigeben über


Eine benutzerdefinierte Prozessaktion erstellen

Verwenden Sie benutzerdefinierte Prozessaktionen, wenn Sie eine Reihe von Befehlen im System automatisieren möchten. Verwenden Sie die benutzerdefinierte Prozessaktionen, um das Vokabular zu erweitern, mit dem Entwickler Geschäftsprozesse formulieren können. Eine benutzerdefinierte Prozessaktion nutzt Kernverben, die vom System bereitgestellt werden, z. B. Erstellen, Aktualisieren, Löschen und Zuweisen, um ausdrucksstärkere Verben wie Genehmigen, Eskalieren, Weiterleiten oder Planen zu erstellen. Wenn sich die Definition eines Geschäftsprozesses ändert, können Nicht-Entwickler die benutzerdefinierte Prozessaktion bearbeiten, damit der Code nicht geändert werden muss.

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

Eine benutzerdefinierte Prozessaktion erstellen

Wichtig

Wenn Sie eine benutzerdefinierte Prozessaktion 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.

Wie Workflowprozesse haben benutzerdefinierte Prozessaktionen 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.

  • Tabelle

    Bei Aktionsprozessen können Sie eine Tabelle auswählen, um den Kontext für den 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.

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

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

  • Bereich: Aktionen werden immer im Kontext des aufrufenden Benutzers ausgeführt.

  • Im Hintergrund ausführen: Aktionen sind immer Echtzeitworkflows.

Im Gegensatz zu Workflowprozessen verfügen benutzerdefinierte Prozessaktionen über Eingabe- und Ausgabeargumente.

Hinweis

Sie können eine benutzerdefinierte Prozessaktion von einem Workflow aktivieren, ohne Code zu schreiben. Weitere Informationen: Aufrufen von benutzerdefinierten Prozessaktion aus einem Workflow

Eine benutzerdefinierte Prozessaktion bearbeiten

Sie müssen benutzerdefinierte Prozessaktionen 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 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. Ä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

    Normalerweise machen Prozesse, die Transaktionen unterstützen, den gesamten Vorgang rückgängig, wenn ein Teil davon fehlschlägt. Es gibt einige Ausnahmen davon. Manche Aktionen, die Entwickler in Code einrichten, und die von der benutzerdefinierte Prozessaktion initiiert werden, unterstützen möglicherweise keine Transaktionen. Zum Beispiel: 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 Rollback aktivieren, wenn eine Aktion von einer Power Apps-Webdienstemeldung ausgelöst 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 und Schritten

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

Prozessargumente definieren

Wenn Entwickler Meldungen verwenden, können sie mit einigen Daten beginnen, 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 benutzerdefinierte Prozessaktion 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 kann 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 „entityReference“ 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

Benutzerdefinierte Prozessaktionen gehören zu einem Prozesstyp, der 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 Echtzeitworkflows und Aktionen finden Sie unter Workflowphasen und -schritte.

Zusätzlich zu den Schritten, die für Echtzeitworkflows verwendet werden können, besitzen Aktionen auch den Schritt Wert zuweisen. 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

Benutzerdefinierte Prozessaktionen aus einem Workflow aufrufen

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).