Import Set-Modus des Webservice

Wenn eine SOAP-Nachricht einen Datensatz in eine Import Set-Tabelle einfügt und für diese Tabelle kein Import Set im Status Loading vorhanden ist, wird ein neuer Import Set erstellt, wobei der Modus auf Synchronfestgelegt ist.

Ein Import Set mit dem ModusSynchron transformiert die Daten, sobald sie eingefügt werden (sofern die Transformationszuordnung bereits vorhanden ist). Dieser Importsatz hat auch den Standardstatus „ Laden“. Standardmäßig werden alle synchronenImportsätze um Mitternacht automatisch in „Verarbeitet“ geändert. Daher wird bei einer neuen Einfügung in dieselbe Tabelle ein neuer synchroner Importsatz erstellt.

Abbildung : 1. Synchroner Importsatz

Wenn Sie diesen Importsatz in den Modus „ Asynchron “ und den Status „ Laden “ ändern, werden die eingehenden Daten nicht beim Einfügen transformiert, sondern der Importsatz „geladen“ und die Datentransformation später entweder manuell oder mit einem geplanten zurückgestellt Skriptauftrag.

Tabelle : 1. Importsatzmodus

Modus	Status	Funktion
Asynchron	Wird geladen	Die Datentransformation erfolgt nicht automatisch und sofort. Daten, die der Importsatzzeile hinzugefügt wurden, haben den Status „Ausstehend“. Die Transformation kann geplant oder manuell ausgeführt werden, wenn der Status in „ Geladen“ geändert wird
Asynchron	Geladen	Markiert den Abschluss des Datenladevorgangs. Die Datentransformation kann jetzt geplant oder manuell erfolgen.
Synchron	Wird geladen	Die Datentransformation erfolgt automatisch und sofort, wenn Daten in die zugehörige Import Set-Zeile eingefügt werden.
Synchron	Geladen	Wenn neue Daten in diesen zugeordneten Importsatz eingefügt werden, wird ein neuer Importsatz mit dem Modus „ Synchron “ und dem Status „ Laden “ erstellt. Das Ändern des Status in „ Geladen “ ist eine Möglichkeit, anzugeben, dass für die nächste Import Set-Zeileneinfügung ein neuer synchroner Importsatz erstellt (und sofort transformiert) werden soll.

Einfügeverhalten steuern

In Importsätzen, die ein oder mehrere Zusammenfügungsfelder angeben, werden Datensätze mit einem übereinstimmenden Zusammenfügungswert seriell (einzeln) von der Quell- in die Zieltabelle umgewandelt, um Duplikate zu vermeiden.

In Import Sets, die kein Zusammenfügungsfeld angeben, werden Datensätze gleichzeitig transformiert. Sie können dieses Verhalten mit der Eigenschaft glide.import_set_insert_serialized_when_no_coalesce steuern.

Die Systemeigenschaft glide.import_set_insert_serialized.<table name> steuert, wie die Instanz Datensätze aus Webservice-Aufrufen in eine bestimmte Import Set-Tabelle einfügt. Bei „true“ verhindert diese Eigenschaft, dass identische gleichzeitige Einfügungen doppelte Datensätze erstellen, indem die Einfügevorgänge der Datenbank serialisiert werden. Wenn für eine Zieltabelle keine Zusammenfügungsfelder in einer Transformationszuordnung definiert sind, legen Sie diese Eigenschaft auf „falsch “ fest, um die Leistung des Webservice-Importsatzes zu verbessern.

Hinweis:

Das Festlegen dieser Eigenschaft auf „falsch“ kann zur Erstellung doppelter Datensätze führen.

Hinweis:

Die Systemeigenschaft glide.soap.import_set_insert_serialized.<table name> bietet die gleiche Funktionalität wie glide.import_set_insert_serialized.<table name>, aber wenn beide Eigenschaften definiert sind, ersetzt glide.import_set_insert_serialized.<table name>glide.soap.import_set_insert_serialized.<table name>.

Standard-SOAP-Antwort

Die SOAP-Antwort von einem Webservice-Import Set- Einfügeaufruf gibt die folgenden Standardwerte zurück.

<SOAP-ENV:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/" SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/"><SOAP-ENV:Body><insertResponse><sys_id>fa648f5f0a0a0b2b0048e7012448b8f1</sys_id><table>incident</table><display_name>number</display_name><display_value>INC10014</display_value><status>inserted</status></insertResponse></SOAP-ENV:Body></SOAP-ENV:Envelope>

Tabelle : 2. Standard-SOAP-Antwort

Feld	Beschreibung
sys_id	Die Sys_id des resultierenden Datensatzes, der erstellt oder geändert wurde
table	Der Tabellenname der betroffenen Tabelle. Im Falle eines asynchronen Aufrufs wäre der Tabellenname die Import Set-Tabelle, z. B. imp_notification für die Import Set-Tabelle des Benachrichtigungs -Webservices
display_name	Der Name des Felds, das als Anzeigefeld für den erstellten oder geänderten Datensatz festgelegt wurde
display_value	Der Wert des Felds, das als Anzeigefeld festgelegt ist. Das Anzeigefeld für die Incident -Tabelle ist beispielsweise das Feld Nummer, und ein Beispielwert wäre INC10001
Status	Ein Zeichenfolgenwert, der die Aktion angibt, die als Ergebnis des Aufrufs des Webservice ausgeführt wurde, und sich auf den Datensatz bezieht, der durch die sys_id und die Tabellenfeldwerte definiert ist eingefügt : Der Datensatz wurde eingefügt Aktualisiert : Der Datensatz wurde aktualisiert ignored – Die Eingabe wurde ignoriert, der Datensatz wurde nicht aktualisiert, und es wurde kein neuer Datensatz erstellt übersprungen – Die Eingabedaten wurden aufgrund fehlender Zusammenfügungswerte übersprungen (ähnlich wie ignoriert). Fehler : Beim Verarbeiten der Eingabe ist ein Fehler aufgetreten
status_message	Dieser Wert wird in den Wert im Feld Kommentar der Importsatzzeile übersetzt und enthält normalerweise Informationen zum Statuswert, z. B. „Keine Feldwerte geändert“, wenn der Status „ignoriert“ ist. Wenn Sie diesen Wert auf einen benutzerdefinierten Zeichenfolgenwert festlegen, enthält die SOAP-Antwort ein optionales Feld status_message, das zurückgegeben werden soll.
error_message	Die Nachricht, die sich auf den Fehlerstatusbezieht. Wenn ein Fehler auftritt, führt das Festlegen dieses Werts auf einen benutzerdefinierten Zeichenfolgenwert dazu, dass die SOAP-Antwort ein optionales Feld error_message enthält, das zurückgegeben werden soll

SOAP-Antwort wird angepasst

Es ist möglich, andere Informationen als die in der WSDL angegebenen Informationen einzubeziehen, indem der Inhalt von status_message mit dem Transformationsskript überschrieben wird.