--- sourceDocument: Xanadu-Build-Workflows sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/de-DE/xanadu/build-workflows Release : - xanadu ft:locale : - de-DE ft:publication_title : - Xanadu-Build-Workflows ft:clusterId : - crworkflow bundleId : - crworkflow workflow : - Creator --- # Schritt „Datensatz erstellen oder aktualisieren" # Schritt „Datensatz erstellen oder aktualisieren" {#ariaid-title1} * Freigeben Version: Xanadu * * Aktualisiert 1. August 2024 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 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 {#create-update-record-step__section_hh2_sfs_thb} 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. {#create-update-record-step__ul_ejg_wws_3hb} ## Rollen und Verfügbarkeit {#create-update-record-step__section_i1f_p1g_jhb} Verfügbar als Workflow-Studio-Aktionsschritt. Benutzer mit der Rolle „action_designer" können eine anwenderdefinierte Aktion mit einem oder mehreren Aktionsschritten erstellen. ## Eingaben {#create-update-record-step__section_all_ztd_lwb} 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.{#create-update-record-step__inputs-description} 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](https://servicenow-prod.fluidtopics.net/kfLZlScsOcqoXjiQ5crahQ "Ermöglichen Sie Flow-Autoren, Feldwerte für einen Datensatz festzulegen, der erstellt oder aktualisiert wird. Verwenden Sie eine Vorlagenwerteingabe, um jedes Mal, wenn Sie einem Flow eine Aktion oder einen Subflow hinzufügen, andere Feldwerte festzulegen."). 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". {#create-update-record-step__ul_s3x_wmb_j1c} ## Ausgaben {#create-update-record-step__section_tdf_15d_lwb} Diese Ausgaben werden im Datenbereich angezeigt. Sie können sie an anderer Stelle in Ihrer Aktion als Eingaben verwenden.{#create-update-record-step__outputs-description} 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. {#create-update-record-step__ul_wy3_3bz_zmb} 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. {#create-update-record-step__ul_obs_2r1_j1c} 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 {#create-update-record-step__example_t5r_r4q_1cc} 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.