Connectoroperationen

Eine Serviceoperation ist ein benannter Satz von Funktionen, der von einem Service angeboten wird. Eine Serviceoperation, die eine neue Bestellung erstellt, könnte zum Beispiel den Namen 'SalesSalesOrderService.create' haben. Ein Service kann mehrere Serviceoperationen verfügbar machen. Die Serviceoperationen, die durch einen Service verfügbar gemacht werden, können angepasste Serviceoperationen beinhalten. In der folgenden Tabelle werden einige häufig verwendete Serviceoperationen für Dokumentservices beschrieben.

Die folgenden Operationen werden durch den MS Dynamics AX 2012 R3-Connector ausgeführt:

Operation Beschreibung
Create Diese Operation erstellt einen Datensatz für ein neues Element in der Datenbank. Beispiel: Für einen Bestellungsservice (Sales Order Service) erstellt diese Operation eine neue Bestellung. In der Regel antwortet diese Operation mit einem Entitätsschlüssel, der die ID des neuen Elements enthält. Der neue Datensatz, der erstellt wird, verwendet die Feldwerte aus dem Datensatz in der Nachricht.

Es kann ein Integrationsport konfiguriert werden, um vorhandene Dokumente zu ersetzen, wenn diese Serviceoperation aufgerufen wird.

Delete Diese Operation löscht einen Datensatz in der Datenbank. Es können nur Datensätze in untergeordneten Tabellen gelöscht werden.
Find Diese Operation sucht nach dem angegebenen Datenbanksatz.
FindKeys Diese Operation ruft eine Liste von Entitätsschlüsseln ab, die den angegebenen Suchkriterien entsprechen. Beispiel: Eine Anforderung kann eine Abfrage nach Kunden enthalten, deren Nachname mit dem Buchstaben T beginnt. Die Antwort auf diese Abfrage enthält eine Liste von Schlüsselfeldern und Werten, mit denen Sie wiederum weitere Daten abfragen können. Mithilfe der Schlüsselfelder könnten Sie zum Beispiel jeden Kundenstammdatensatz in der zuvor abgerufenen Liste aktualisieren.
Read Diese Operation ruft die angegebenen Datensätze aus der Datenbank ab. Die Datensätze, die gelesen werden müssen, werden durch Entitätsschlüssel angegeben. Die Antwort enthält die Daten für die Datensätze, die zurückgegeben werden.
Update Diese Operation aktualisiert einen Datensatz in der Datenbank. Nur die Felder, für die die Werte in der Nachricht angegeben werden, werden aktualisiert. Die Werte für alle anderen Datenbankfelder bleiben unverändert.
getKeys Diese Operation ruft die Schlüssel für Dokumente mithilfe eines Dokumentfilters ab.
getChangedKeys Diese Operation ruft die Schlüssel für Dokumente mithilfe eines Dokumentfilters und eines übergebenen Datumswerts ab.