Schritt „Datensatz erstellen oder aktualisieren“

  • Freigeben Version: Zurich
  • Aktualisiert 31. Juli 2025
  • 3 Minuten Lesedauer

    • Erstellen oder aktualisieren Sie einen Datensatz in einem ServiceNowTabelle mit einem einzelnen 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 in den Feldern, die Sie als eindeutige Bezeichner auswählen, nach übereinstimmenden Werten gesucht wird. 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, aktualisiert er den übereinstimmenden Datensatz, 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 dem Wert der eindeutigen Bezeichner entspricht, aktualisiert der Schritt keine Datensätze und zeigt eine Fehlermeldung in den Flow-Ausführungsdetails an.

    Rollen und Verfügbarkeit

    Verfügbar als Workflow-Studio-Aktionsschritt. Anwender mit der Rolle „action_Designer“ können eine anwenderdefinierte 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. der zusätzlichen Kommentare oder Arbeitsnotizen eines Aufgabendatensatzes.

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

    Bestimmt die Eindeutigkeit
    Datentyp: True/False

    Option zum Auswählen des Felds als eindeutiger Bezeichner, der bestimmt, wann ein Datensatz aktualisiert oder erstellt werden soll. Ein Datensatz wird aktualisiert, wenn der Wert des eingehenden Felds mit einem vorhandenen Datensatzfeldwert übereinstimmt. Ein Datensatz wird erstellt, wenn der Wert des eingehenden Felds 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 den nächsten Schritt fortzusetzen oder zur Fehlerauswertung zu wechseln. Diese Option hat keine Auswirkungen auf die Ausgabe „Schrittstatus“. Zur Auswahl stehen:
    • Stoppen Sie die Aktion nicht, und fahren Sie mit dem nächsten Schritt fort : Setzt die Ausführung der Aktion im nächsten Schritt fort.
    • Wechseln Sie zu Fehlerauswertung : Stoppt 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 erzeugt wird, wenn der Datensatzvorgang fehlschlägt.

    Status
    Datentyp: Choice

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

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

    Objektdatenpille mit Laufzeitdetails zum Schritt. Jeder Schritt in einer Aktion gibt einen Schrittstatus zurück.

    Schrittstatuscode
    Datentyp: Integer
    Ganzzahldatenpille, die angibt, ob der Schritt einen Fehler verursacht hat. Ein Schritt gibt einen Wert von 1 zurück, wenn er aus irgendeinem Grund einen Fehler verursacht. Beispielsweise kann ein Schritt zu einem Fehler führen, wenn er obligatorische Eingabedaten fehlt oder Ausgabe im falschen Datentyp zurückgibt. Ein Schritt gibt einen Wert von 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 verursacht.
    Schrittstatusnachricht
    Datentyp: String

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

    Erstellen oder aktualisieren Sie einen Problemdatensatz

    Konfiguration des Schritts „Datensatz erstellen oder aktualisieren“

    Diese Aktion hat zwei Eingaben. Es gibt eine Zeichenfolgeneingabe für eine Beschreibung und eine Referenzeingabe für einen Anwenderdatensatz. Der Schritt „Datensatz erstellen oder aktualisieren“ verwendet diese Eingaben, um einen Problemdatensatz zu erstellen oder zu aktualisieren. Die Problembeschreibung und die Felder „geöffnet von“ bestimmen die Eindeutigkeit. Wenn die Eingabewerte übereinstimmen, führt der Schritt einen Aktualisierungsvorgang anstelle eines Erstellungsvorgangs aus.