Aktion „Datensätze suchen“.
Suchen Sie mehrere Datensätze in einer beliebigen Tabelle unter definierten Bedingungen.
Rollen und Verfügbarkeit
Verfügbar als Workflow-Studio ServiceNow -Kernaktion. Benutzer 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 Pillen auch aus dem Datenbereich ziehen oder in der Pillenauswahl auswählen.
- Tabelle
- Datentyp: Table Name
Tabellenname, der die zu suchenden Datensätze enthält.
- Bedingungen
- Datentyp: Conditions
Feldnamen und Feldwerte, die Sie für die Suche nach Datensätzen verwenden möchten. Um ein Inline-Skript zum Angeben von Bedingungen zu verwenden, sollten Sie zum Erstellen Ihrer Abfrage die Klassen GlideRecord und GlideQueryCondition verwenden. Siehe GlideRecord - Global und GlideQueryCondition - Global.
- Anordnen nach
- Datentyp: Field Name
Feld, das Sie zum Sortieren von Ergebnissen verwenden möchten.
- Sortiertyp
- Datentyp: Choice
Option zum alphabetischen Sortieren in aufsteigender oder absteigender Reihenfolge.
- Max. Ergebnisse
- Datentyp: Integer
Die maximale Anzahl von Datensatzergebnissen, die die Aktion zurückgeben kann.
Ausgaben
Diese Ausgaben werden im Datenbereich angezeigt. Sie können sie an anderer Stelle in Ihrem Flow als Eingaben verwenden.
- Datensätze
- Datentyp: Records
Liste der gefundenen Datensatz-Sys-IDs basierend auf den von Ihnen angegebenen Suchkriterien. Weitere Informationen finden Sie unter Datensätze.Datentyp [Tabelle].
- Tabelle
- Datentyp: Table Name
Tabelle, die die Liste der Datensätze enthält.
- Anzahl
- Datentyp: Integer
Anzahl der Datensätze, die von der Aktion zurückgegeben wurden.
Allgemeine Leitlinien
Beachten Sie bei der Arbeit mit der Aktion „Datensätze suchen“ die folgenden allgemeinen Richtlinien.
- Verarbeiten Sie Datensätze mit der Flow-Logik „Für jeden“.
- Verwenden Sie die Flow-Logik „Für jeden“, um eine Liste der Datensätze zu durchlaufen. Weitere Informationen zur Verwendung der For-Each-Flow-Logik finden Sie unter Für jede Flow-Logik.
- Legen Sie Max. Ergebnisse fest, um die Leistung zu verbessern
- Legen Sie die Eingabe Max. Ergebnisse auf 1000 Datensätze oder weniger fest, um die Leistung Ihres Flows zu verbessern. Je mehr Datensätze das System suchen muss, desto mehr Systemressourcen benötigt es, um sie zu identifizieren und zu verarbeiten.
- Verwenden Sie Bedingungen, um Datensätze zu filtern
- Verwenden Sie Bedingungen, um die Anzahl der von der Aktion zurückgegebenen Datensätze zu begrenzen. Je spezifischere Bedingungen Sie angeben können, desto besser ist die Leistung Ihres Flows.
Sucht nach Konfigurationselementen, die einem Change-Anforderungsbenutzer zugewiesen sind
In diesem Beispiel wird der Flow gestartet, wenn eine Notfall-Change-Anforderung in der Kategorie „Netzwerk“ geöffnet wird. Die Aktion „Datensätze nachschlagen“ verwendet die Tabelle Configuration Item [cmdb_ci] als Tabelleneingabe. Die Eingabe Bedingungen sucht nach Configuration Items, die der anfordernden Person der Change-Anforderung zugewiesen sind. Die Eingabe Sortieren nach verwendet das Feld Name, um eine aufsteigende alphabetische Sortierung durchzuführen.
In den Ausführungsdetails zeigt die Ausgabe Anzahl drei Configuration Items an, die der anfordernden Person der Change-Anforderung zugewiesen sind. In der Ausgabe „Datensätze“ werden die Konfigurationselemente auf der Seite „Ausführungsdetails“ nach Name angezeigt, die Datenpille enthält jedoch eine Reihe von Sys-ID-Werten. Die Tabellenausgabe ist die Tabelle „Configuration Item“ [cmdb_ci].