Aktionen ausführen
In OData werden Aktionen zum Hinzufügen serverseitiger Operationen für Entitäten verwendet. Eine Aktion kann für eine einzelne Entität oder eine Sammlung von Entitäten ausgeführt werden. Aktionen geben Daten zurück und können verwendet werden, um die folgenden Operationen auszuführen:
• Gleichzeitiges Bearbeiten mehrerer Entitäten
• Zulassen von Aktualisierungen nur für bestimmte Eigenschaften einer Entität
• Senden von Daten an den Server, der nicht in einer Entität definiert ist
• Implementieren komplexer Transaktionen
Verwenden Sie die Aktion Aktionen ausführen, um Aktionen auszuführen, die in den OData-Metadaten definiert sind.
Führen Sie die folgenden Schritte aus, um die Aktion Aktionen ausführen in Ihrem Workflow zu verwenden:
1. Ziehen Sie die Aktion Aktionen ausführen unter OData in den Zeichenbereich, zeigen Sie mit der Maus auf die Aktion, und klicken Sie dann auf 
. Oder: Doppelklicken Sie auf die Aktion. Das Fenster "Aktionen ausführen" wird geöffnet.
. Oder: Doppelklicken Sie auf die Aktion. Das Fenster "Aktionen ausführen" wird geöffnet.2. Bearbeiten Sie bei Bedarf die Beschriftung. Standardmäßig ist der Beschriftungsname mit dem Aktionsnamen identisch.
3. Informationen zum Hinzufügen eines OData-Konnektortyps finden Sie unter Unterstützte OData-Konnektortypen.
Wenn Sie zuvor einen Konnektortyp hinzugefügt haben, wählen Sie den entsprechenden Konnektortyp aus, und wählen Sie unter Konnektor-Name den Konnektor aus.
4. Klicken Sie auf TESTEN, um den Konnektor zu validieren.
5. Klicken Sie auf KONNEKTOR ZUORDNEN, um die Aktion mit einem anderen Konnektor auszuführen als dem, den Sie zum Füllen der Eingabefelder verwenden. Geben Sie im Feld Laufzeit-Konnektor einen gültigen OData-Konnektornamen an. Weitere Informationen zu KONNEKTOR ZUORDNEN finden Sie unter Using Map Connector.
6. Aktivieren Sie das Kontrollkästchen Referenzdomänen einschließen, um alle Aktionen anzuzeigen, die von ActionImport in den referenzierten Domänen beschrieben werden.
7. Wählen Sie in der Liste Aktion die OData-Aktion aus, die Sie ausführen möchten.
Die Felder im Eingabeformular ändern sich dynamisch basierend auf der ausgewählten Aktion.
8. Wählen Sie Formular aus, um Eingaben für einzelne Eigenschaften im Formular vorzunehmen, oder wählen Sie JSON zuweisen aus, um ein einzelnes JSON-Objekt mit allen erforderlichen Eigenschaften anzugeben.
9. Verwenden Sie die Optionen in der Liste Abfragetyp, um die Ausgabe basierend auf den Objekteigenschaften zu filtern, die in der Ausgabe enthalten sein sollen. Wenn die Aktion ein Objekt nicht zurückgibt, ist die Option Abfragetyp nicht verfügbar.
Anhängig vom Rückgabetyp der Aktion, hat eine Abfrage folgende Parameter:
◦ Einzelnes Objekt – Eigenschaften auswählen, Zugehörige Elemente hinzufügen
◦ Sammlung von Objekten – Filter, Eigenschaften auswählen, Zugehörige Elemente hinzufügen, Grenzwert, Überspringen
Wählen Sie in der Liste Abfragetyp den Typ Formularbasierte Abfrage, Diskrete Abfrage oder Leere Abfrage aus, um Abfrageparameter anzugeben.
Formularbasierte Abfrage a. (Nur für Sammlung von Objekten verfügbar) Gehen Sie unter der Gruppe Filter wie folgt vor: a. Wählen Sie in der Liste Vereinen durch einen logischen Operator aus, um die Filterklauseln zu verknüpfen. Der Standardwert ist and. b. Klicken Sie unter Filterklauseln auf Hinzufügen, um einen Filter hinzuzufügen: ▪ Eigenschaft – Wählen Sie eine Eigenschaft aus. ▪ Übereinstimmende Bedingung – Wählen Sie eine Bedingung aus. Die Bedingung hängt davon ab, welchen Eigenschaftstyp Sie ausgewählt haben (Zeichenfolge, boolescher Wert usw.). ▪ Wert – Geben Sie einen Eigenschaftswert ein. Um mehrere Filter hinzuzufügen, klicken Sie auf Hinzufügen. Klicken Sie auf  , um hinzugefügte Filter zu löschen.Wenn Sie dieselben Eigenschaften hinzufügen und UND in der Liste Vereinen durch auswählen, werden die Attribute durch den ODER-Operator verknüpft. b. Klicken Sie unter Eigenschaften auswählen auf Hinzufügen, und wählen Sie in der Liste Eigenschaft die Eigenschaft aus, für die Sie Werte abrufen möchten. Klicken Sie auf Hinzufügen, um mehrere Eigenschaften hinzuzufügen. Klicken Sie auf , um hinzugefügte Eigenschaften zu löschen.Wenn Sie eine Eigenschaft auswählen, werden standardmäßig Werte für die ausgewählten Eigenschaften und "Schlüssel"-Eigenschaften in der Ausgabe abgerufen. Wenn Sie keine Eigenschaft auswählen, sind standardmäßig alle Entitätseigenschaften in der Ausgabe enthalten. c. Klicken Sie unter Zugehörige Elemente hinzufügen auf Hinzufügen, und wählen Sie in der Liste Zugehöriges Element das zugehörige Element aus, für das Sie Werte abrufen möchten. Klicken Sie auf Hinzufügen, um mehrere zugehörige Elemente hinzuzufügen. Klicken Sie auf , um hinzugefügte zugehörige Elemente zu löschen.Alle als NavigationProperty markierten Eigenschaften sind als Zugehöriges Element kategorisiert. d. (Nur für Sammlung von Objekten verfügbar) Geben Sie im Feld Grenzwert einen Wert ein, um die Ausgabe auf eine angegebene Anzahl von Entitäten zu begrenzen. e. (Nur für Sammlung von Objekten verfügbar) Geben Sie im Feld Überspringen die Anzahl der Ressourcen ein, die Sie überspringen möchten. |
Diskrete Abfrage a. (Nur für Sammlung von Objekten verfügbar) Geben Sie im Feld Filter die OData-Filterkriterien im Format propertyName operator 'value' [and | or | not]... an. Beispiel: number eq '0000222341' oder name eq 'PTC' oder startswith(name, 'PTC') b. Geben Sie im Feld Eigenschaften auswählen einen OData-select-Ausdruck an, um eine durch Trennzeichen getrennte Liste der Eigenschaftsnamen bereitzustellen. Wenn Sie eine Eigenschaft in der Abfrage angeben, werden standardmäßig Werte für die ausgewählten Eigenschaften in der Ausgabe abgerufen. Wenn Sie keine Eigenschaft angeben, sind standardmäßig alle Entitätseigenschaften in der Ausgabe enthalten. c. Geben Sie im Feld Zugehörige Elemente hinzufügen einen OData-select-Ausdruck an, um eine durch Trennzeichen getrennte Liste zugehöriger Elemente bereitzustellen. Alle als NavigationProperty markierten Eigenschaften sind als Zugehöriges Element kategorisiert. d. (Nur für Sammlung von Objekten verfügbar) Geben Sie im Feld Grenzwert die Anzahl der Suchergebnisse ein, die Sie abrufen möchten. e. (Nur für Sammlung von Objekten verfügbar) Geben Sie im Feld Überspringen die Anzahl der Top-Suchergebnisse ein, die Sie im Ergebnis überspringen möchten. |
Leere Abfrage Geben Sie im Feld Abfrage einen OData-Abfrageausdruck an. Beispiel: $select=name,number&$expand=context&$top=2&$skip=1&$orderby=name asc&$filter=name eq 'PTC' Wenn Sie eine Eigenschaft in der Abfrage angeben, werden standardmäßig Werte für die ausgewählten Eigenschaften in der Ausgabe abgerufen. Wenn Sie keine Eigenschaft angeben, sind standardmäßig alle Entitätseigenschaften in der Ausgabe enthalten. Alle als NavigationProperty markierten Eigenschaften sind als Zugehöriges Element kategorisiert. Je nach Rückgabetyp der Aktion können Sie die Parameter "Filter", "Grenzwert" und "Überspringen" im Abfrageausdruck angeben. |
10. Klicken Sie auf Weitere Felder anzeigen.
11. Klicken Sie unter der Gruppe Kopfzeilen auf Hinzufügen, um der Anforderung eine benutzerdefinierte Kopfzeile hinzuzufügen. Geben Sie ein Schlüssel-Wert-Paar an.
Klicken Sie auf Hinzufügen, um mehrere Schlüssel-Wert-Paare hinzuzufügen. Klicken Sie auf , um hinzugefügte benutzerdefinierte Kopfzeilen zu löschen.
, um hinzugefügte benutzerdefinierte Kopfzeilen zu löschen.12. Klicken Sie auf Fertig.
 | Wenn Sie dieses Aktionsformular bearbeiten, die ausgewählte Aktion ändern und Werte für alle erforderlichen Felder angeben, wird evtl. eine Fehlerbenachrichtigung im Workflow-Editor angezeigt. Öffnen Sie in diesem Fall das Aktionsformular erneut, und klicken Sie auf Fertig. Der Fehler wird nicht mehr angezeigt. |
Ausgabeschema
Abhängig von der OData-Aktion, die Sie auswählen, gibt die Aktion Aktionen ausführen ein dynamisches Ausgabeschema zurück. Wenn die Aktion nicht über einen Rückgabetyp verfügt, wird eine Meldungszeichenfolge zurückgegeben.
Wenn Sie Formularbasierte Abfrage ausgewählt haben, um Abfrageparameter anzugeben, bietet das Ausgabeschema nur Details der ausgewählten Eigenschaften.
Für Diskrete Abfrage oder Leere Abfrage enthält das Ausgabeschema alle Eigenschaften des zurückgegebenen Objekts, aber es stellt nur Werte der angegebenen Eigenschaften bereit.