Aktion „Anhang suchen“

  • Freigeben Version: Zurich
  • Aktualisiert 31. Juli 2025
  • 1 Minute Lesedauer
  • Sucht nach einem Anhang, der einem Datensatz zugeordnet ist, und gibt die SYS-ID des Anhangs als Datenpille zurück.

    Rollen und Verfügbarkeit

    Verfügbar als Workflow-Studio ServiceNowCore-Aktion. Anwender mit der Rolle „Flow_Designer“ oder „admin“ können einem Flow eine Aktion hinzufügen und Konfigurationsdetails definieren.

    Eingaben

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

    Dateiname
    Datentyp: String

    Der Name des Anhangs, den Sie suchen möchten. Sie können diese Eingabe leer lassen, um nach allen Anhängen für einen Datensatz zu suchen.

    Quelldatensatz
    Datentyp: Record

    Datensatz mit einem oder mehreren Anhängen, die gesucht werden sollen. Sie können verwenden Aktion „Datensatz suchen“ Um einen entsprechenden Quelldatensatz zu finden.

    Ausgaben

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

    Sys-ID des Anhangs
    Datentyp: String

    SYS-ID des ersten übereinstimmenden Anhangs. Sie können verwenden Aktion „Datensatz suchen“ Um diesen Zeichenfolgenwert in eine Datensatzausgabe zu konvertieren.

    Anhangliste
    Datentyp: String

    JSON-formatierte Zeichenfolge, die alle Anhänge enthält, die der Suchabfrage entsprechen. Jedes übereinstimmende Element wird als Objekt formatiert, das die SYS-ID, den Dateinamen und die Dateigröße in Byte des Anhangs enthält. Sie können eine anwenderdefinierte Aktion verwenden, um dieses Objekt nach Bedarf zu analysieren.

    Suchen Sie nach Anhängen aus Incident-Datensätzen

    Konfiguration der Aktion „Anhang suchen“, bei der die Eingabe „Dateiname“ leer ist und der Quelldatensatz dem Auslöser-Incident zugeordnet ist.

    In diesem Beispiel wird nach Anhängen aus Incident-Datensätzen gesucht, damit sie in zugehörige Problemdatensätze kopiert werden können. Die Eingabe „Dateiname“ ist leer, um alle Anhänge im Quelldatensatz zu finden. Die Eingabe „Quelldatensatz“ verwendet die Datenpille „Incident-Auslöser-Datensatz“.

    Ausführungsdetails für Flow-Schritt 1 mit einer bestimmten SYS-ID-Zeichenfolge, die als Ausgabe zurückgegeben wird.

    In diesem Beispiel zeigen die Flow-Ausführungsdetails, dass der Auslöser-Incident nur einen Anhang hatte. Die Ausgabe „SYS-ID des Anhangs“ listet die SYS-ID des Anhangdatensatzes als Zeichenfolgenwert auf. Die Ausgabe „Anhangsliste“ ist leer, da dem Quelldatensatz nur ein Anhang zugeordnet war.

    Wenn der auslösende Incident-Datensatz zwei oder mehr Anhänge enthält, die der Suchabfrage entsprechen, füllt die Aktion die Ausgabe der Anhangliste mit einer JSON-Zeichenfolge aus.
    [
      {
        "sys_id": "a8008849db7e4210497c1a481396193c",
        "file_name": "Root Cause Analysis",
        "file_size_in_bytes": "48955"
      },
      {
        "sys_id": "c0a298356f102100758ecb512e3ee409",
        "file_name": "Pasted Image",
        "file_size_in_bytes": "97236"
      }
    ]