Schritt „Datensatz erstellen oder aktualisieren“

  • Freigeben Version: Washingtondc
  • Aktualisiert 7. Februar 2024
  • 3 Minuten Lesedauer

    • Erstellen oder aktualisieren Sie einen Datensatz in einer Tabelle ServiceNow mit einem einzigen Vorgang. Aktualisieren Sie einen vorhandenen Datensatz, oder erstellen Sie einen Datensatz mit den angegebenen Werten.

    Identifizierung vorhandener Datensätze

    Der Schritt Datensatz erstellen oder aktualisieren identifiziert vorhandene Datensätze, indem nach übereinstimmenden Werten in den Feldern gesucht wird, die Sie als eindeutige Bezeichner auswählen. Sie können beispielsweise angeben, dass die Felder „Kurzbeschreibung“ und „Priorität“ einen Incident eindeutig identifizieren. Wenn der Schritt einen Incident mit einer übereinstimmenden Kurzbeschreibung und Priorität findet, wird der übereinstimmende Datensatz aktualisiert, anstatt einen neuen Datensatz zu erstellen.

    Hinweis:
    • Wenn kein Feld als eindeutiger Bezeichner ausgewählt ist, erstellt der Schritt einen Datensatz mit den angegebenen Feldwerten.
    • Wenn mehr als ein Datensatz mit dem Wert der eindeutigen Bezeichner übereinstimmt, aktualisiert der Schritt keine Datensätze und zeigt eine Fehlermeldung in den Details der Flow-Ausführung an.

    Rollen und Verfügbarkeit

    Verfügbar als Aktionsdesigner-Aktionsschritt. Benutzer mit der Rolle „action_designer“ können eine benutzerdefinierte Aktion mit einem oder mehreren Aktionsschritten erstellen.

    Eingaben

    Geben Sie einen Wert für jede Eingabe an, die Ihre Aktion benötigt. Um dynamische Werte hinzuzufügen, können Sie auch Pillen aus dem Datenbereich ziehen oder in der Pillenauswahl auswählen.

    Tabelle
    Datentyp: Table Name

    Tabelle, in der ein Datensatz erstellt oder aktualisiert werden soll.

    Felder
    Datentyp: Template Values

    Feldwerte, die für den Datensatz festgelegt oder aktualisiert werden sollen. Um beispielsweise die Kurzbeschreibung auf einen bestimmten Wert festzulegen, wählen Sie Kurzbeschreibung und stellen Sie den gewünschten Wert ein.

    Wichtig:
    Das System unterstützt nicht das Aktualisieren mehrerer Journalfelder, z. B. zusätzliche Anmerkungen oder Arbeitsnotizen eines Aufgabendatensatzes.

    Wenn Sie die Aktion einem Unterablauf hinzufügen, können Sie Erstellen Sie eine Vorlagenwerteingabe. Dynamisch festgelegte Feldwerte können serverseitige Validierungsregeln auslösen, aber keine UI-Richtlinien.

    Bestimmt die Eindeutigkeit
    Datentyp: True/False

    Option zur Auswahl des Felds als eindeutiger Bezeichner, der bestimmt, wann ein Datensatz aktualisiert oder erstellt werden soll. Ein Datensatz wird aktualisiert, wenn der eingehende Feldwert mit einem vorhandenen Datensatzfeldwert übereinstimmt. Ein Datensatz wird erstellt, wenn der eingehende Feldwert nicht mit einem vorhandenen Datensatzfeldwert übereinstimmt. Diese Option wird angezeigt, wenn der erforderliche Tabellenname und die erforderlichen Felder ausgewählt sind.

    Wenn dieser Schritt fehlschlägt
    Datentyp: Choice
    Option, um mit der Ausführung des nächsten Schritts fortzufahren oder zur Fehlerauswertung zu wechseln. Diese Option hat keine Auswirkungen auf die Schrittstatusausgabe. Zur Auswahl stehen:
    • Aktion nicht anhalten und mit dem nächsten Schrittfortfahren: Setzt die Aktion beim nächsten Schritt fort.
    • Zur Fehlerauswertung wechseln: Beendet die Ausführung der Aktion und wechselt zum Abschnitt „Fehlerauswertung“.

    Ausgaben

    Diese Ausgaben werden im Datenbereich angezeigt. Sie können sie an anderer Stelle in Ihrer Aktion als Eingaben verwenden.

    Datensatz
    Datentyp: Record

    Verweis auf erstellten oder aktualisierten Datensatz.

    Tabelle
    Datentyp: Table Name

    Tabelle, in der der Datensatz erstellt oder aktualisiert wurde.

    Fehlermeldung
    Datentyp: String

    Fehlermeldung, die ausgegeben wird, wenn der Datensatzvorgang fehlschlägt.

    Status
    Datentyp: Choice

    Abschlussstatus der Aktion. Auf der Detailseite der Flow-Ausführung wird einer der folgenden Werte angezeigt.

    • Erstellt [created]: Die Aktion hat einen Datensatz erstellt.
    • Aktualisiert [aktualisiert]: Die Aktion hat einen Datensatz aktualisiert.
    • Fehler [error]: Die Aktion hat einen Fehler verursacht.
    Schrittstatus
    Datentyp: Object

    Objektdatenpille, die Laufzeitdetails zum Schritt enthält. Jeder Schritt in einer Aktion gibt einen Schrittstatus zurück.

    Schrittstatuscode
    Datentyp: Integer
    Ganzzahl-Datenpille, die angibt, ob der Schritt einen Fehler verursacht hat. Ein Schritt gibt den Wert 1 zurück, wenn er aus irgendeinem Grund einen Fehler erzeugt. Beispielsweise kann ein Schritt einen Fehler erzeugen, wenn obligatorische Eingabedaten fehlen oder die Ausgabe im falschen Datentyp zurückgegeben wird. Ein Schritt gibt den Wert 0 zurück, wenn er erfolgreich ausgeführt wird. Sie können diese Codes nicht anpassen.
    • Erfolg [0]: Der Schritt war erfolgreich.
    • Fehler [1]: Der Schritt hat einen Fehler erzeugt.
    Schrittstatusnachricht
    Datentyp: String

    Zeichenfolgendatenpille, die die vom Schritt oder Systemvorgang erzeugte Fehlermeldung enthält. Sie können die Schrittstatusnachricht nicht anpassen.