Webservice-Importsatzmodus

  • Freigeben Version: Zurich
  • Aktualisiert 31. Juli 2025
  • 3 Minuten Lesedauer
  • Wenn eine SOAP-Nachricht einen Datensatz in eine Importsatztabelle einfügt und kein Importsatz für diese Tabelle in vorhanden ist Wird Geladen status, wird ein neuer Importsatz mit erstellt Modus Auf festlegen Synchron .

    Ein Importsatz mit Modus Von Synchron Transformiert die Daten, sobald sie eingefügt werden (vorausgesetzt, die Transformationszuordnung ist bereits vorhanden). Dieser Importsatz hat auch einen Standard Status Von Wird Geladen . Standardmäßig alle Synchron Importsätze werden automatisch in geändert Verarbeitet Um Mitternacht. Daher wird, wenn eine neue Einfügung in dieselbe Tabelle erfolgt, eine neue Synchron Importsatz wird erstellt.

    Abbildung : 1. Synchroner Importsatz
    Dieser Importsatz wird in geändert Modus Von Asynchron Und ein status Von Wird Geladen Hat den Effekt, dass die eingehenden Daten nicht beim Einfügen umgewandelt werden, sondern dass der Importsatz „geladen“ wird und die Datentransformation später zurückgestellt wird, entweder manuell oder mit einer geplanten Skriptaufgabe.
    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 geändert wird Geladen
    Asynchron Geladen Markiert den Abschluss des Ladevorgangs der Daten. Die Datentransformation kann jetzt geplant oder manuell erfolgen.
    Synchron Wird geladen Die Datentransformation erfolgt automatisch und sofort, wenn Daten in die zugehörige Importsatzzeile eingefügt werden.
    Synchron Geladen Wenn neue Daten in diesen zugehörigen Importsatz eingefügt werden, wird ein neuer Importsatz des Modus angezeigt Synchron Und Status Wird Geladen Wird erstellt. Status wird in geändert Geladen Ist eine Möglichkeit, anzugeben, dass eine neue Synchron Importsatz muss für die nächste Einfügung der Importsatzzeile erstellt (und sofort umgewandelt) werden.

    Steuern Des Einfügeverhaltens

    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 transformiert, um Duplikate zu verhindern.

    In Importsätzen, die kein Zusammenfügungsfeld angeben, werden Datensätze gleichzeitig umgewandelt. Sie können dieses Verhalten mit steuern glide.import_set_insert_serialized_when_no_coalesceEigenschaft.

    Die glide.import_set_insert_serialized.<table name>Die Systemeigenschaft steuert, wie die Instanz Datensätze aus Webservice-Aufrufen in eine bestimmte Importsatztabelle einfügt. Bei „wahr“ 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 fest Falsch Zur Verbesserung der Leistung des Webservice-Importsatzes.

    Hinweis:
    Diese Eigenschaft wird auf festgelegt Falsch Kann zur Erstellung doppelter Datensätze führen.
    Hinweis:
    Die glide.soap.import_set_insert_serialized.<table name>Die Systemeigenschaft bietet eine entsprechende Funktionalität für glide.import_set_insert_serialized.<table name>, Aber wenn beide Eigenschaften definiert sind, glide.import_set_insert_serialized.<table name>Ersetzt glide.soap.import_set_insert_serialized.<table name>.

    Standard-SOAP-Antwort

    Die SOAP-Antwort aus einem Webservice-Importsatz Einfügen Aufruf 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 Fall von Asynchron Rufen Sie an, der Tabellenname wäre die Importsatztabelle, z. B. imp_Notification für Benachrichtigungen Webservice-Importsatztabelle
    display_name Der Name des Felds, das als Anzeigefeld für den Datensatz festgelegt ist, der erstellt oder geändert wurde
    display_value Der Wert des Felds, das als Anzeigefeld festgelegt ist. Zum Beispiel das Anzeigefeld für Incident Tabelle ist Nummer Feld und ein Beispielwert wären INC10001
    status Ein Zeichenfolgenwert, der die Aktion angibt, die als Ergebnis des Webserviceaufrufs aufgetreten ist und sich auf den von definierten Datensatz bezieht sys_ID Und Tabelle Feldwerte
    • Eingefügt – Der Datensatz wurde eingefügt
    • Aktualisiert – Der Datensatz wurde aktualisiert
    • Ignoriert – 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 übersetzt, der in gefunden wurde Kommentar Feld der Importsatzzeile und enthält normalerweise Informationen im Zusammenhang mit Status Wert, z. B. „Keine Feldwerte geändert“, wenn der Status „ignoriert“ lautet. Wenn Sie diesen Wert auf einen anwenderdefinierten Zeichenfolgenwert festlegen, wird die SOAP-Antwort ein optionales Feld „Status_message“ zurückgegeben.
    error_message Die Nachricht, die sich auf einen Status von bezieht Fehler . Wenn ein Fehler auftritt, wird die SOAP-Antwort durch Festlegen dieses Werts auf einen anwenderdefinierten Zeichenfolgenwert ein optionales Feld „error_message“ zurückgegeben

    Anpassung der SOAP-Antwort

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