Aktivität 'OData schreiben'
Diese Aktivität empfängt die Ausgabe der Aktivität 'OData lesen' als Eingabe zusammen mit anderen Details wie Nutzdaten, HTTP-Statuscode usw. und generiert die Ausgabe, die als Antwort zurückgegeben werden muss.
Konfigurationseigenschaften für die Aktivität 'OData schreiben'
Feldname | Beschreibung |
---|---|
OData-Version | Die OData-Version, die von dieser Aktivität verwendet werden soll. In einer Orchestrierung müssen alle Aktivitäten dieselbe Version verwenden. Gegenwärtig wird nur die Version 4.0 unterstützt. |
Eingabedaten auswählen | Wählen Sie eine der Optionen zur Übergabe der Geschäftsdatenstruktur
an die Aktivität 'OData lesen' aus. Die OData-API wird auf Basis der angegebenen Geschäftsstrukturen erstellt.
|
Das folgende XML-Schema mit Objekten 'account' und 'product' ist ein Beispiel.
<?xml version="1.0" encoding="UTF-8"?>
<schema xmlns="http://www.w3.org/2001/XMLSchema" elementFormDefault="qualified"
xmlns:ras="http://www.sample.com/xmlns/prod/sample"
targetNamespace="http://www.sample.com/xmlns/prod/sample">
<element name="account" type="ras:AccountObject"/>
<element name="product" type="ras:ProductObject"/>
<complexType name="AccountObject">
<sequence maxOccurs="1" minOccurs="1">
<element maxOccurs="1" minOccurs="0" name="accountId" type="int"/>
<element maxOccurs="1" minOccurs="0" name="accountName" type="string"/>
<element maxOccurs="1" minOccurs="0" name="valid" type="boolean"/>
</sequence>
</complexType>
<complexType name="ProductObject">
<sequence maxOccurs="1" minOccurs="1">
<element maxOccurs="1" minOccurs="1" name="pid" type="int"/>
<element maxOccurs="1" minOccurs="0" name="productName" type="string"/>
<element maxOccurs="1" minOccurs="0" name="description" type="string"/>
<element maxOccurs="1" minOccurs="0" name="stock" type="int"/>
</sequence>
</complexType>
</schema>
Feldname | Beschreibung |
---|---|
serviceName | Dies ist der Name der OData-ReST-API und ist Teil der URL. Der Wert dieser Eigenschaft muss mit dem Wert der Eigenschaft "URL (Pfad nach Hostname)" in der Anzeige 'Konfigurieren' der HTTP-Aktivität "Anforderung empfangen" übereinstimmen. Wenn die URL mit diesem Namen (Beispiel: http://host/serviceName) angetroffen wird, gibt sie das Servicedokument in der Antwort zurück. |
protocol | Das Protokoll, das von Ihrer OData-ReST-API unterstützt wird. Dieser Wert muss mit einem der beiden unterstützten Werte (HTTP oder HTTPS) als Standardwert festgelegt werden. |
host | Der Host, auf dem die API ausgeführt wird. Der Wert für diese Eigenschaft muss aus der Ausgabe der HTTP-Aktivität "Anforderung empfangen" zugeordnet werden. |
method | Die HTTP-Methode der Anforderung. Der Wert für diese Eigenschaft muss aus der Ausgabe der HTTP-Aktivität "Anforderung empfangen" zugeordnet werden. |
Accept | Der Accept-Headerwert. Der Wert dieser Eigenschaft kann auf den Standardwert gesetzt oder aus der Ausgabe der HTTP-Aktivität "Anforderung empfangen" zugeordnet werden. Unterstützte Werte: application/json und application/xml. |
Content-Type | Der Wert des Content-Type-Headers. Der Wert dieser Eigenschaft kann auf den Standardwert gesetzt oder aus der Ausgabe der HTTP-Aktivität "Anforderung empfangen" zugeordnet werden. Unterstützte Werte: application/json und application/xml. |
resourcePath | Diese Eigenschaft enthält den URL-Pfad des Aufrufs und wird aus der Ausgabe der Aktivität "OData lesen" zugeordnet. |
entities | Diese Eigenschaft hat den Typ eines Zeichenfolgenarrays und enthält die Entitätsgruppennamen, die in der URL angefordert wurden und aus der Ausgabe der Aktivität 'OData lesen' zugeordnet wurden. Beispiel: Wenn 'serviceName' den Wert '/test' hat und die ausgewählte Geschäftsdatenstruktur ein Konto ('account') aus dem obigen Schema ist, dann sieht die URL zum Abruf aller Kontendetails wie folgt aus: http://hostname/test/accounts. In diesem Beispiel ist der Entitätsgruppenname 'accounts'. |
fieldName | Wenn die Anforderung für einen in der Geschäftsdatenstruktur enthaltenen Feldnamen gilt, ist der Name des Felds in dieser Eigenschaft enthalten. Der Wert dieser Eigenschaft wird aus der Ausgabe der Aktivität "OData lesen" zugeordnet. Beispiel: Wenn die URL http://hostname/test/accounts(5)/accountName angefordert wird, hat 'fieldName' den Wert 'accountName'. |
additionalpath | Wenn ein weiteres Token wie $value oder $count in der Anforderungs-URL enthalten ist, ist dieser Wert in dieser Eigenschaft vorhanden und wurde aus der Ausgabe der Aktivität 'OData lesen' zugeordnet. |
primaryKeys | Wenn die Anforderungs-URL Primärschlüssel enthält, sind diese Informationen in diesem Feld vorhanden und der Wert wird aus der Ausgabe der Aktivität 'OData lesen' zugeordnet. URL-Beispiele: http://hostname/test/accounts(5) http://hostname/test/salesorder(orderid='so1',name='ask') Die Struktur "primaryKeys" enthält den Feldnamen, den Wert und den Datentyp des Primärschlüssels. |
status | Enthält den HTTP-Statuscode, der in der Antwort für die Operation 'DELETE' zurückgegeben wird. |
writeODataInput | Die Geschäftsobjektstruktur, die serialisiert und in der Antwort zurückgegeben werden muss. |
writeODataQueryParametersInput | Die Abfrageparameter, die auf die Antwortdaten angewendet werden müssen. Die Werte werden aus der Ausgabe der Aktivität 'OData lesen' zugeordnet. |
writeODataHttpHeadersInput | Die HTTP-Header, die auf die Antwortdaten angewendet werden müssen. Die Werte werden aus der Ausgabe der Aktivität 'OData lesen' zugeordnet. |
Feldname | Beschreibung |
---|---|
writeODataOutput | Die Daten, die als Antwort gesendet werden müssen. Diese Daten umfassen den HTTP-Statuscode, die HTTP-Nachricht und die Antwortnutzdaten. |
writeODataHttpHeadersOutput | Diese Eigenschaft enthält die HTTP-Header, die als Antwort gesendet werden müssen. |