Schritt „Datensatz erstellen oder aktualisieren“

  • Freigeben Version: Xanadu
  • Aktualisiert 1. August 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 ausgewählt haben. 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 mit dem Wert der eindeutigen Bezeichner übereinstimmt, 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. Benutzer 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 die Aktualisierung mehrerer Journalfelder, z. B. der zusätzlichen Kommentare 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 den nächsten Schritt auszuführen 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: Die Ausführung der Aktion wird im nächsten Schritt fortgesetzt.
    • Zu 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 erzeugt wird, wenn der Datensatzvorgang fehlschlägt.

    Status
    Datentyp: Choice

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

    • Erstellt [created]: Die Aktion hat einen Datensatz erstellt.
    • Aktualisiert [updated]: Die Aktion hat einen Datensatz aktualisiert.
    • Fehler [error]: Bei der Aktion ist ein Fehler aufgetreten.
    Schrittstatus
    Datentyp: Object

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

    Schrittstatuscode
    Datentyp: Integer
    Ganzzahlige Datenpille, die angibt, ob bei dem Schritt ein Fehler aufgetreten ist. 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 wurde. Sie können diese Codes nicht anpassen.
    • Erfolg [0]: Der Schritt war erfolgreich.
    • Fehler [1]: Der Schritt hat zu einem Fehler geführt.
    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 Benutzerdatensatz. Der Schritt „Datensatz erstellen oder aktualisieren“ verwendet diese Eingaben, um einen Problemdatensatz zu erstellen oder zu aktualisieren. Die Felder Problembeschreibung und Geöffnet von bestimmen die Eindeutigkeit. Wenn die Eingabewerte übereinstimmen, führt der Schritt einen Aktualisierungsvorgang anstelle eines Erstellungsvorgangs aus.