Freigeben über


Dynamischer Workflowinhalt

Hinweis

Microsoft Purview Data Catalog (klassisch) und Data Health Insights (klassisch) übernehmen keine neuen Kunden mehr, und diese Dienste, bisher Azure Purview, befinden sich jetzt im Kundensupportmodus.

Wichtig

Dieses Feature ist derzeit in der Vorschau. Die zusätzlichen Nutzungsbedingungen für Microsoft Azure Previews enthalten zusätzliche rechtliche Bestimmungen, die für Azure-Features gelten, die sich in der Betaversion, in der Vorschau oder anderweitig noch nicht in der allgemeinen Verfügbarkeit befinden.

Sie können dynamische Inhalte in Microsoft Purview-Workflows verwenden, um bestimmte Variablen im Workflow zuzuordnen oder andere Ausdrücke hinzuzufügen, um diese Werte zu verarbeiten.

Wenn Sie Ihren Workflows dynamische Inhalte hinzufügen, erstellen Sie Ausdrücke aus bereitgestellten Bausteinen, die auf Informationen in Ihrem Workflow verweisen und diese verarbeiten, damit Sie die benötigten Werte in Echtzeit abrufen können.

Im Menü "Dynamischer Inhalt" stehen derzeit folgende Optionen zur Verfügung:

  • Integrierte Variablen : Variablen, die Werte darstellen, die aus den Elementen, die ihn ausgelöst haben, in den Workflow kommen
  • Ausdrücke : Formeln, die aus Funktionen und Variablen erstellt wurden, die Werte im Workflow verarbeiten können.

Integrierte Variablen

Derzeit sind die folgenden Variablen für einen Workflowconnector in Microsoft Purview verfügbar:

Voraussetzungsconnector Integrierte Variable Funktionalität Typ Mögliche Werte
Wenn die Datenzugriffsanforderung übermittelt wird
Wenn die Anforderung zum Aktualisieren des Ressourcenobjekts übermittelt wird
Workflow.Requestor Die ID des Anforderers des Workflows Zeichenfolge
Asset.Name Der Name des Medienobjekts Zeichenfolge
Asset.Description Die Beschreibung des Medienobjekts string oder NULL
Asset.Type Der Typ des Medienobjekts Zeichenfolge
Asset.Fully Qualified Name Der vollqualifizierte Name des Medienobjekts Zeichenfolge
Asset.Owner Die IDs der Datenbesitzer der Ressource Array von Zeichenfolgens
Asset.Classification Die Anzeigenamen von Klassifizierungen der Ressource Array von Zeichenfolgens
Asset.Schema.Classification Die Anzeigenamen von Klassifizierungen, die auf eine Spalte im Ressourcenschema angewendet werden Array von Zeichenfolgens
Asset.Is Zertifiziert Der Indikator, ob die Ressource die Qualitätsstandards Ihrer organization erfüllt und als zuverlässig angesehen werden kann boolean true oder false
Wenn die Datenzugriffsanforderung übermittelt wird Workflow.Request Recipient Die ID des Anforderungsempfängers des Workflows Zeichenfolge
Starten und Warten auf eine Genehmigung Approval.Outcome Das Ergebnis der Genehmigung Zeichenfolge 'Approved' oder 'Rejected'
Approval.Assigned To Die IDs der genehmigenden Personen Array von Zeichenfolgens
Approval.Comments Die Namen der genehmigenden Personen und ihre Kommentare Zeichenfolge
Überprüfen der Datenquellenregistrierung auf Datennutzungsgovernance Datennutzungsgovernance Das Ergebnis der Überprüfung der Datennutzungsgovernance boolean true oder false
Wenn die Anforderung zur Erstellung von Begriffen übermittelt wird Workflow.Requestor Die ID des Anforderers des Workflows Zeichenfolge
Term.Name Der Name des Begriffs Zeichenfolge
Term.Formal Name Der formale Name des Begriffs Zeichenfolge
Term.Definition Die Definition des Begriffs Zeichenfolge
Term.Experts Die IDs der Experten des Begriffs Array von Zeichenfolgens
Term.Stewards Die IDs der Stewards des Begriffs Array von Zeichenfolgens
Term.Parent.Name Der Name des übergeordneten Ausdrucks, sofern vorhanden Zeichenfolge
Term.Parent.Formal Name Der formale Name des übergeordneten Ausdrucks, sofern vorhanden Zeichenfolge
Wenn die Anforderung zum Aktualisieren von Laufzeiten übermittelt wird
Wenn die Anforderung zum Löschen von Begriffen übermittelt wird
Workflow.Requestor Der Anforderer des Workflows Zeichenfolge
Term.Name Der Name des Begriffs Zeichenfolge
Term.Formal Name Der formale Name des Begriffs Zeichenfolge
Term.Definition Die Definition des Begriffs string oder NULL
Term.Experts Die IDs der Experten des Begriffs Array von Zeichenfolgens
Term.Stewards Die IDs der Stewards des Begriffs Array von Zeichenfolgens
Term.Parent.Name Der Name des übergeordneten Ausdrucks, sofern vorhanden Zeichenfolge
Term.Parent.Formal Name Der formale Name des übergeordneten Ausdrucks, sofern vorhanden Zeichenfolge
Term.Created By Die ID des Erstellers des Begriffs Zeichenfolge
Term.Last aktualisiert von Die ID der letzten Aktualisierung des Begriffs Zeichenfolge
Wenn die Anforderung zum Importieren von Begriffen übermittelt wird Workflow.Requestor Die ID des Anforderers des Workflows Zeichenfolge
File.Name importieren Der Name der zu importierenden Datei. Zeichenfolge
HTTP Http.Body HTTP-Antworttext Objekt oder Zeichenfolge
Http.Headers HTTP-Antwortheader Objekt
Http.Statuscode HTTP-Statuscode Zeichenfolge
Auf jeden anwenden Element Das aktuelle Element der Aktion "Auf jedes anwenden" Any
Bis Index Der aktuelle Iterationsindex der Until-Aktion ganze Zahl
Datensatz erstellen
Datensatz löschen
Datensatz abrufen
Datensatz aktualisieren
Ergebnis Das Ergebnis der ServiceNow-Aktion Objekt
Abrufen von Datensatztypen
Datensätze auflisten
Ergebnis Das Ergebnis der ServiceNow-Aktion Array von Objekts

Ausdrücke

Mit Workflowdefinitionen in Microsoft Purview können Sie Funktionen in Ihren Ausdrücken verwenden, um Werte in Ihren Workflows zu verarbeiten.

Informationen zum Ermitteln von Funktionen basierend auf ihrem allgemeinen Zweck finden Sie in den folgenden Tabellen. Ausführliche Informationen zu den einzelnen Funktionen finden Sie in der alphabetischen Liste.

Wenn Sie einen Workflow erstellen und Ihren Ausdrücken eine Funktion hinzufügen möchten, führen Sie die folgenden Schritte aus:

  1. Wählen Sie den Wert aus, den Sie bearbeiten möchten.
  2. Wählen Sie die Schaltfläche Dynamischen Inhalt hinzufügen aus, die unterhalb des Textfelds angezeigt wird.
  3. Wählen Sie im Fenster für dynamische Inhalte die Registerkarte Ausdrücke aus, und scrollen Sie, um Ihren Wert auszuwählen.
  4. Aktualisieren Sie Ihren Ausdruck, und wählen Sie OK aus, um ihn hinzuzufügen.

Screenshot eines Workflowtextfelds mit hervorgehobener Option

Überlegungen

  • Funktionsparameter werden von links nach rechts ausgewertet.

  • Funktionen, die inline mit Nur-Text angezeigt werden, erfordern einschließende geschweifte Klammern ({}), um stattdessen das interpolierte Format des Ausdrucks zu verwenden. Dieses Format trägt dazu bei, Analyseprobleme zu vermeiden. Wenn Ihr Funktionsausdruck nicht inline mit Nur-Text angezeigt wird, sind keine geschweiften Klammern erforderlich.

    Das folgende Beispiel zeigt die richtige und falsche Syntax:

    Richtig: "<text>/@{<function-name>('<parameter-name>')}/<text>"

    Falsch: "<text>/@<function-name>('<parameter-name>')/<text>"

  • Funktionen können Überladungen aufweisen, bei denen es sich um mehrere Versionen einer Funktion mit demselben Namen, aber unterschiedlichen Methoden zum Ausführen einer Aufgabe handelt, je nachdem, welche Eingabe Sie ihnen geben.

In den folgenden Abschnitten werden Funktionen basierend auf ihrem allgemeinen Zweck organisiert, oder Sie können diese Funktionen in alphabetischer Reihenfolge durchsuchen.

Zeichenfolgenfunktionen

Um mit Zeichenfolgen zu arbeiten, können Sie diese Zeichenfolgenfunktionen und auch einige Sammlungsfunktionen verwenden. Zeichenfolgenfunktionen funktionieren nur für Zeichenfolgen.

String-Funktion Aufgabe
endsWith Überprüfen Sie, ob eine Zeichenfolge mit der angegebenen Teilzeichenfolge endet.
startsWith Überprüfen Sie, ob eine Zeichenfolge mit einer bestimmten Teilzeichenfolge beginnt.

Sammlungsfunktionen

Für die Arbeit mit Sammlungen, in der Regel Arrays, Zeichenfolgen und manchmal Wörterbücher, können Sie diese Auflistungsfunktionen verwenden.

Sammlungsfunktion Aufgabe
enthält Überprüfen Sie, ob eine Sammlung über ein bestimmtes Element verfügt.
length Gibt die Anzahl der Elemente in einer Auflistung oder die Länge einer Zeichenfolge zurück.

Logische Vergleichsfunktionen

Um mit Bedingungen zu arbeiten, Werte und Ausdrucksergebnisse zu vergleichen oder verschiedene Arten von Logik auszuwerten, können Sie diese logischen Vergleichsfunktionen verwenden. Die vollständige Referenz zu den einzelnen Funktionen finden Sie in der alphabetischen Liste.

Logische Vergleichsfunktion Aufgabe
nicht Überprüfen Sie, ob ein Ausdruck false ist. Gibt true zurück, wenn der Ausdruck false ist, oder gibt false zurück, wenn true.
und Überprüfen Sie, ob alle Ausdrücke wahr sind. Gibt true zurück, wenn alle Ausdrücke true sind, oder false zurück, wenn mindestens ein Ausdruck false ist.
oder Überprüfen Sie, ob mindestens ein Ausdruck true ist. Gibt true zurück, wenn mindestens ein Ausdruck true ist, oder false, wenn alle false sind.
gleich Überprüfen Sie, ob beide Werte gleichwertig sind.
größer Überprüfen Sie, ob der erste Wert größer als der zweite Wert ist.
greaterOrEquals Überprüfen Sie, ob der erste Wert größer oder gleich dem zweiten Wert ist.
weniger Überprüfen Sie, ob der erste Wert kleiner als der zweite Wert ist.
lessOrEquals Überprüfen Sie, ob der erste Wert kleiner oder gleich dem zweiten Wert ist.

Benutzerfunktionen

Um mit Benutzern zu arbeiten, ihre Beziehungen zu anderen Benutzern und Gruppen und die Ressourcen, auf die sie zugreifen, z. B. ihre E-Mails, Kalender, Dateien, Administratorrollen, Gruppenmitgliedschaften. Die vollständige Referenz zu den einzelnen Funktionen finden Sie in der alphabetischen Liste.

Benutzerfunktion Aufgabe
getUserName Rufen Sie den Namen des Benutzers ab.
getManager Rufen Sie die ID des Vorgesetzten des Benutzers ab.
memberOfGroup Überprüfen Sie, ob der Benutzer Mitglied der Gruppe ist.

Konvertierungsfunktionen

Um den Typ oder das Format eines Werts zu ändern, können Sie diese Konvertierungsfunktionen verwenden. Die vollständige Referenz zu den einzelnen Funktionen finden Sie in der alphabetischen Liste.

Konvertierungsfunktion Aufgabe
createArray Gibt ein Array aus einer beliebigen Anzahl von Eingaben zurück.
createObject Gibt ein leeres Objekt zurück.
Zeichenfolge Gibt die Zeichenfolgenversion für einen Wert zurück.
int Versuchen Sie, den Eingabewert in eine ganze Zahl zu konvertieren.
float Versuchen Sie, den Eingabewert in eine Gleitkommazahl zu konvertieren.
bool Versuchen Sie, den Eingabewert in einen booleschen Wert zu konvertieren.
Objekt Versuchen Sie, den Eingabewert in ein -Objekt zu konvertieren.
Array Versuchen Sie, den Eingabewert in ein Array zu konvertieren.
nullOrElse Geben Sie einem Nullable-Wert einen Standardwert zu.

Alle Funktionen – alphabetische Liste

und

Überprüfen Sie, ob alle Ausdrücke wahr sind. Gibt true zurück, wenn alle Ausdrücke true sind, oder false zurück, wenn mindestens ein Ausdruck false ist.

Parameter Typ Beschreibung
Wert boolean Der erste zu überprüfende Ausdruck
Werte... boolean Die restlichen Zu überprüfenden Ausdrücke
Rückgabewerttyp Beschreibung
boolean Gibt true zurück, wenn alle Ausdrücke true sind. Gibt false zurück, wenn mindestens ein Ausdruck false ist.

Beispiele

In diesen Beispielen wird überprüft, ob die angegebenen Ausdrücke false sind:

and(equals(1, 1), equals(2, 2))
and(equals(1, 1), equals(1, 2))
and(equals(1, 2))

Und gibt die folgenden Ergebnisse zurück:

  • Erstes Beispiel: Beide Ausdrücke sind true, daher wird zurückgegeben true.
  • Zweites Beispiel: Ein Ausdruck ist false, gibt also zurück false.
  • Drittes Beispiel: Der Ausdruck ist false und gibt daher zurück false.

Array

Diese Funktion versucht, den Eingabewert in ein Array zu konvertieren. Es wird verwendet, um den Wert aus einem breiteren Typ in ein Array umzuwandern. Informationen zum Erstellen eines Arrays aus Elementen finden Sie unter createArray.

Parameter Typ Beschreibung
Wert Any Der zu konvertierende Wert
Rückgabewerttyp Beschreibung
Array Der konvertierte Arraywert

Beispiel

In diesem Beispiel wird das Element einer "Apply to each"-Aktion vom Arraytyp bestätigt:

array(items('Appy to each'))

bool

Diese Funktion versucht, den Eingabewert in einen booleschen Wert zu konvertieren. Es wird verwendet, um den Wert von einem breiteren Typ in einen booleschen Wert zu umwandeln.

Parameter Typ Beschreibung
Wert Any Der zu konvertierende Wert
Rückgabewerttyp Beschreibung
boolean Der konvertierte boolesche Wert

Beispiel

In diesem Beispiel wird das Element einer "Apply to each"-Aktion vom booleschen Typ bestätigt:

bool(items('Appy to each'))

contains

Überprüfen Sie, ob eine Sammlung über ein bestimmtes Element verfügt. Gibt true zurück, wenn das Element gefunden wird, oder false, wenn es nicht gefunden wird.

Überladung 1: Eine Zeichenfolge zum Suchen einer Teilzeichenfolge

Bei dieser Überladung wird die Groß-/Kleinschreibung beachtet.

Parameter Typ Beschreibung
Sammlung Zeichenfolge Die zu überprüfende Zeichenfolge
Wert Zeichenfolge Die zu suchde Teilzeichenfolge
Rückgabewerttyp Beschreibung
boolean Gibt true zurück, wenn die Teilzeichenfolge gefunden wird. Gibt false zurück, wenn er nicht gefunden wird.

Überladung 2: Ein Array zum Suchen eines Werts

Parameter Typ Beschreibung
Sammlung Array Die zu überprüfende Sammlung
Wert Any Das zu suchende Element
Rückgabewerttyp Beschreibung
boolean Gibt true zurück, wenn das Element gefunden wird. Gibt false zurück, wenn er nicht gefunden wird.

Beispiel 1

In diesem Beispiel wird die Zeichenfolge "hello world" für die Teilzeichenfolge "world" überprüft und zurückgegeben true:

contains('hello world', 'world')

Beispiel 2

In diesem Beispiel wird die Variable Asset.Owner auf das Element überprüft, das der Variablen Workflow.Requestor entspricht:

contains(runInput()['asset']['dataOwner'], runInput()['requestor'])

createArray

Gibt ein Array aus einer beliebigen Anzahl von Eingaben zurück. Für diese Funktion müssen die Eingabewerte nicht vom gleichen Typ sein.

Parameter Typ Beschreibung
Werte... Any Werte zum Erstellen des Arrays.
Rückgabewerttyp Beschreibung
Array Das Array, das aus allen Eingabeelementen erstellt wurde

Beispiele

In diesen Beispielen wird ein Array aus Eingaben erstellt:

createArray('h', 'e', 'l', 'l', 'o')
createArray(true, null)
createArray()

createObject

Gibt ein leeres Objekt zurück.

Rückgabewerttyp Beschreibung
Objekt Ein leeres Objekt

Beispiel

In diesem Beispiel wird ein Array aus Eingaben erstellt und zurückgegeben {}.

createObject()

endsWith

Überprüfen Sie, ob eine Zeichenfolge mit einer bestimmten Teilzeichenfolge endet. Gibt true zurück, wenn die Teilzeichenfolge gefunden wird, oder false, wenn sie nicht gefunden wird. Bei dieser Funktion wird die Groß-/Kleinschreibung beachtet.

Parameter Typ Beschreibung
text Zeichenfolge Die zu überprüfende Zeichenfolge
searchText Zeichenfolge Die endende Teilzeichenfolge, die gesucht werden soll
Rückgabewerttyp Beschreibung
boolean Gibt true zurück, wenn die endende Teilzeichenfolge gefunden wird. Gibt false zurück, wenn er nicht gefunden wird.

Beispiel 1

In diesem Beispiel wird überprüft, ob die Zeichenfolge "hello world" mit der Zeichenfolge "world" endet:

endsWith('hello world', 'world')

Und gibt dieses Ergebnis zurück: true

Beispiel 2

In diesem Beispiel wird überprüft, ob die Zeichenfolge "hello world" mit der Zeichenfolge "universe" endet:

endsWith('hello world', 'universe')

Und gibt dieses Ergebnis zurück: false

gleich

Überprüfen Sie, ob beide Werte, Ausdrücke oder Objekte gleichwertig sind. Gibt true zurück, wenn beide gleichwertig sind, oder false, wenn sie nicht äquivalent sind.

Parameter Typ Beschreibung
Wert Any Die zu vergleichenden Werte, Ausdrücke oder Objekte
compareTo Any Die Vergleichswerte, Ausdrücke oder Objekte
Rückgabewerttyp Beschreibung
boolean Gibt true zurück, wenn beide äquivalent sind. Gibt false zurück, wenn nicht gleichwertig.

Beispiele

In diesen Beispielen wird überprüft, ob die angegebenen Eingaben gleichwertig sind.

equals(true, 1)
equals('abc', 'abcd')

Und gibt die folgenden Ergebnisse zurück:

  • Erstes Beispiel: Beide Werte sind gleichwertig, sodass die Funktion zurückgibt true.
  • Zweites Beispiel: Beide Werte sind nicht gleichwertig, sodass die Funktion zurückgibt false.

Gleitkommazahl

Diese Funktion versucht, den Eingabewert in eine Gleitkommazahl zu konvertieren. Es wird verwendet, um den Wert von einem breiteren Typ in float umzuwandern.

Parameter Typ Beschreibung
Wert Any Der zu konvertierende Wert
Rückgabewerttyp Beschreibung
float Der konvertierte Float-Wert

Beispiel

In diesem Beispiel wird das Element einer "Apply to each"-Aktion vom Typ float festgelegt:

float(items('Appy to each'))

getManager

Rufen Sie die ID des Vorgesetzten des Benutzers in Microsoft Entra ID ab.

Überladung 1: Abrufen für einen einzelnen Benutzer

Parameter Typ Beschreibung
userId Zeichenfolge Die ID des Eingabebenutzers
Rückgabewerttyp Beschreibung
string oder NULL Die ID des Vorgesetzten des Eingabebenutzers oder NULL, falls nicht vorhanden

Überladung 2: Abrufen für mehrere Benutzer

Parameter Typ Beschreibung
userId Array Die IDs der Eingabebenutzer
Rückgabewerttyp Beschreibung
Array Die Vereinigung der IDs der Vorgesetzten der Eingabebenutzer

Beispiele

In diesen Beispielen werden die Vorgesetzten der Eingabebenutzer abgerufen:

getManager(runInput()['requestor'])
getManager(runInput()['term']['stewards'])
  • Erstes Beispiel: Der Eingabeparameter ist eine Zeichenfolge. Daher wird die ID des Managers von Workflow.Requestor zurückgegeben.
  • Zweites Beispiel: Der Eingabeparameter ist ein Array, sodass der Union-Satz von IDs von Managern von Term.Stewards zurückgegeben wird.

getUserName

Rufen Sie den Namen des Benutzers in Microsoft Entra ID ab.

Überladung 1: Abrufen für einen einzelnen Benutzer

Parameter Typ Beschreibung
userId Zeichenfolge Die ID des Eingabebenutzers
Rückgabewerttyp Beschreibung
Zeichenfolge Der Name des Eingabebenutzers

Überladung 2: Abrufen für mehrere Benutzer

Parameter Typ Beschreibung
userId Array Die IDs der Eingabebenutzer
Rückgabewerttyp Beschreibung
Array Die Namen der Eingabebenutzer

Beispiele

In diesen Beispielen werden die Namen der Eingabebenutzer abgerufen:

getUserName(runInput()['requestor'])
getUserName(runInput()['term']['stewards'])
  • Erstes Beispiel: Der Eingabeparameter ist eine Zeichenfolge und gibt daher den Namen von Workflow.Requestor zurück.
  • Zweites Beispiel: Der Eingabeparameter ist ein Array und gibt daher ein Array von Namen von Term.Stewards zurück.

größer

Überprüfen Sie, ob der erste Wert größer als der zweite Wert ist. Gibt true zurück, wenn der erste Wert größer ist, oder false, wenn kleiner.

Überladung 1: Zahlen vergleichen

Parameter Typ Beschreibung
Wert integer oder float Der erste Wert, der überprüft, ob größer als der zweite Wert ist
compareTo integer oder float Der Vergleichswert
Rückgabewerttyp Beschreibung
boolean Gibt true zurück, wenn der erste Wert größer als der zweite Wert ist. Gibt false zurück, wenn der erste Wert gleich oder kleiner als der zweite Wert ist.

Überladung 2: Vergleichen von Zeichenfolgen

Parameter Typ Beschreibung
Wert Zeichenfolge Der erste Wert, der überprüft, ob größer als der zweite Wert ist
compareTo Zeichenfolge Der Vergleichswert
Rückgabewerttyp Beschreibung
boolean Gibt true zurück, wenn der erste Wert größer als der zweite Wert ist. Gibt false zurück, wenn der erste Wert gleich oder kleiner als der zweite Wert ist.

Beispiele

In diesen Beispielen wird überprüft, ob der erste Wert größer als der zweite Wert ist:

greater(10, 5)
greater('apple', 'banana')

Und gibt diese Ergebnisse zurück:

  • Erstes Beispiel: true
  • Zweites Beispiel: false

greaterOrEquals

Überprüfen Sie, ob der erste Wert größer oder gleich dem zweiten Wert ist. Gibt true zurück, wenn der erste Wert größer oder gleich ist, oder gibt false zurück, wenn der erste Wert kleiner ist.

Überladung 1: Zahlen vergleichen

Parameter Typ Beschreibung
Wert integer oder float Der erste Wert, der überprüft, ob größer oder gleich dem zweiten Wert ist.
compareTo integer oder float Der Vergleichswert
Rückgabewerttyp Beschreibung
boolean Gibt true zurück, wenn der erste Wert größer oder gleich dem zweiten Wert ist. Gibt false zurück, wenn der erste Wert kleiner als der zweite Wert ist.

Überladung 2: Vergleichen von Zeichenfolgen

Parameter Typ Beschreibung
Wert Zeichenfolge Der erste Wert, der überprüft, ob größer oder gleich dem zweiten Wert ist.
compareTo Zeichenfolge Der Vergleichswert
Rückgabewerttyp Beschreibung
boolean Gibt true zurück, wenn der erste Wert größer oder gleich dem zweiten Wert ist. Gibt false zurück, wenn der erste Wert kleiner als der zweite Wert ist.

Beispiele

In diesen Beispielen wird überprüft, ob der erste Wert größer oder gleich dem zweiten Wert ist:

greaterOrEquals(5, 5)
greaterOrEquals('apple', 'banana')

Und gibt diese Ergebnisse zurück:

  • Erstes Beispiel: true
  • Zweites Beispiel: false

int

Diese Funktion versucht, den Eingabewert in eine ganze Zahl zu konvertieren. Es wird verwendet, um den Wert von einem breiteren Typ in eine ganze Zahl umzuwandern.

Parameter Typ Beschreibung
Wert Any Der zu konvertierende Wert
Rückgabewerttyp Beschreibung
ganze Zahl Der konvertierte ganzzahlige Wert

Beispiel

In diesem Beispiel wird bestätigt , dass Item einer "Apply to each"-Aktion vom Typ integer ist:

int(items('Appy to each'))

length

Gibt die Anzahl der Elemente in einer Auflistung oder die Länge einer Zeichenfolge zurück.

Parameter Typ Beschreibung
Wert Zeichenfolge oder Array Die Zeichenfolge oder die Auflistung mit den zu zählenden Elementen
Rückgabewerttyp Beschreibung
boolean Die Anzahl der Elemente in der Auflistung oder die Länge der Zeichenfolge

Beispiele

In diesen Beispielen wird die Anzahl der Elemente in diesen Auflistungen gezählt:

length('abcd')
length(createArray(0, 1, 2, 3))

Und beide geben dieses Ergebnis zurück: 4

weniger

Überprüfen Sie, ob der erste Wert kleiner als der zweite Wert ist. Gibt true zurück, wenn der erste Wert kleiner ist, oder false, wenn der erste Wert größer ist.

Überladung 1: Zahlen vergleichen

Parameter Typ Beschreibung
Wert integer oder float Der erste Wert, der überprüft, ob kleiner als der zweite Wert ist
compareTo integer oder float Der Vergleichswert
Rückgabewerttyp Beschreibung
boolean Gibt TRUE zurück, wenn der erste Wert kleiner als der zweite Wert ist. Gibt false zurück, wenn der erste Wert gleich oder größer als der zweite Wert ist.

Überladung 2: Vergleichen von Zeichenfolgen

Parameter Typ Beschreibung
Wert Zeichenfolge Der erste Wert, der überprüft, ob größer als der zweite Wert ist
compareTo Zeichenfolge Der Vergleichswert
Rückgabewerttyp Beschreibung
boolean Gibt TRUE zurück, wenn der erste Wert kleiner als der zweite Wert ist. Gibt false zurück, wenn der erste Wert gleich oder größer als der zweite Wert ist.

Beispiele

In diesen Beispielen wird überprüft, ob der erste Wert kleiner als der zweite Wert ist.

less(5, 10)
less('banana', 'apple')

Und gibt diese Ergebnisse zurück:

  • Erstes Beispiel: true
  • Zweites Beispiel: false

lessOrEquals

Überprüfen Sie, ob der erste Wert kleiner oder gleich dem zweiten Wert ist. Gibt true zurück, wenn der erste Wert kleiner oder gleich ist, oder gibt false zurück, wenn der erste Wert größer ist.

Überladung 1: Zahlen vergleichen

Parameter Typ Beschreibung
Wert integer oder float Der erste Wert, der überprüft, ob kleiner oder gleich dem zweiten Wert ist.
compareTo integer oder float Der Vergleichswert
Rückgabewerttyp Beschreibung
boolean Gibt true zurück, wenn der erste Wert kleiner oder gleich dem zweiten Wert ist. Gibt false zurück, wenn der erste Wert größer als der zweite Wert ist.

Überladung 2: Vergleichen von Zeichenfolgen

Parameter Typ Beschreibung
Wert Zeichenfolge Der erste Wert, der überprüft, ob kleiner oder gleich dem zweiten Wert ist.
compareTo Zeichenfolge Der Vergleichswert
Rückgabewerttyp Beschreibung
boolean Gibt true zurück, wenn der erste Wert kleiner oder gleich dem zweiten Wert ist. Gibt false zurück, wenn der erste Wert größer als der zweite Wert ist.

Beispiele

In diesen Beispielen wird überprüft, ob der erste Wert kleiner oder gleich dem zweiten Wert ist.

lessOrEquals(10, 10)
lessOrEquals('apply', 'apple')

Und gibt diese Ergebnisse zurück:

  • Erstes Beispiel: true
  • Zweites Beispiel: false

memberOfGroup

Überprüfen Sie, ob der Benutzer Mitglied der Gruppe in Microsoft Entra ID ist. Die Gruppen-ID finden Sie auf Microsoft Entra Seite für die Gruppenverwaltung.

Parameter Typ Beschreibung
userId Zeichenfolge Die ID des Eingabebenutzers
groupId Zeichenfolge Die ID der zu überprüfenden Gruppe
Rückgabewerttyp Beschreibung
boolean Gibt true zurück, wenn der Benutzer Mitglied der Gruppe ist. Gibt false zurück, wenn der Benutzer kein Mitglied der Gruppe ist oder die Gruppe nicht vorhanden ist.

Beispiel

In diesem Beispiel wird überprüft, ob Workflow.Requestor Mitglied der angegebenen Gruppe ist:

memberOfGroup(runInput()['requestor'], '00000000-0000-0000-0000-111111111111')

not

Überprüfen Sie, ob ein Ausdruck false ist. Gibt true zurück, wenn der Ausdruck false ist, oder gibt false zurück, wenn true.

Parameter Typ Beschreibung
Wert boolean Der zu überprüfende Ausdruck
Rückgabewerttyp Beschreibung
boolean Gibt true zurück, wenn der Ausdruck false ist. Gibt false zurück, wenn der Ausdruck true ist.

Beispiele

In diesen Beispielen wird überprüft, ob die angegebenen Ausdrücke false sind:

not(equals(1, 2))
not(equals(1, 1))

Und gibt diese Ergebnisse zurück:

  • Erstes Beispiel: Der Ausdruck ist false, sodass die Funktion zurückgibt true.
  • Zweites Beispiel: Der Ausdruck ist true, sodass die Funktion zurückgibt false.

nullOrElse

Geben Sie einem Nullable-Wert einen Standardwert zu. Gibt einen Wert zurück, der nicht nullable ist.

Überladung 1: Zeichenfolgenversion

Parameter Typ Beschreibung
Wert string oder NULL Der Nullable-Wert
defaultValue Zeichenfolge Der Fallbackwert
Rückgabewerttyp Beschreibung
Zeichenfolge Gibt den Eingabewert zurück, wenn er nicht NULL ist. Gibt den Standardwert zurück, wenn der Eingabewert NULL ist.

Überladung 2: Ganzzahlige Version

Parameter Typ Beschreibung
Wert integer oder NULL Der Nullable-Wert
defaultValue ganze Zahl Der Fallbackwert
Rückgabewerttyp Beschreibung
ganze Zahl Gibt den Eingabewert zurück, wenn er nicht NULL ist. Gibt den Standardwert zurück, wenn der Eingabewert NULL ist.

Überladung 3: Float-Version

Parameter Typ Beschreibung
Wert float oder NULL Der Nullable-Wert
defaultValue float Der Fallbackwert
Rückgabewerttyp Beschreibung
float Gibt den Eingabewert zurück, wenn er nicht NULL ist. Gibt den Standardwert zurück, wenn der Eingabewert NULL ist.

Überladung 4: Boolesche Version

Parameter Typ Beschreibung
Wert Boolescher Wert oder NULL Der Nullable-Wert
defaultValue boolean Der Fallbackwert
Rückgabewerttyp Beschreibung
boolean Gibt den Eingabewert zurück, wenn er nicht NULL ist. Gibt den Standardwert zurück, wenn der Eingabewert NULL ist.

Überladung 5: Arrayversion

Parameter Typ Beschreibung
Wert Array oder NULL Der Nullable-Wert
defaultValue Array Der Fallbackwert
Rückgabewerttyp Beschreibung
Array Gibt den Eingabewert zurück, wenn er nicht NULL ist. Gibt den Standardwert zurück, wenn der Eingabewert NULL ist.

Überladung 6: Objektversion

Parameter Typ Beschreibung
Wert Objekt oder NULL Der Nullable-Wert
defaultValue Objekt Der Fallbackwert
Rückgabewerttyp Beschreibung
Objekt Gibt den Eingabewert zurück, wenn er nicht NULL ist. Gibt den Standardwert zurück, wenn der Eingabewert NULL ist.

Beispiel

In diesem Beispiel wird der Nullablen-Variablen Term.Definition ein Standardwert zugeordnet 'Empty':

nullOrElse(runInput()['term']['definition'], 'Empty')

Objekt

Diese Funktion versucht, den Eingabewert in einen Objektwert zu konvertieren. Es wird verwendet, um den Wert von einem breiteren Typ in ein Objekt umzuwandern.

Parameter Typ Beschreibung
Wert Any Der zu konvertierende Wert
Rückgabewerttyp Beschreibung
boolean Der konvertierte Objektwert

Beispiel

In diesem Beispiel wird das Element einer "Apply to each"-Aktion vom Objekttyp bestätigt:

object(items('Appy to each'))

oder

Überprüfen Sie, ob mindestens ein Ausdruck true ist. Gibt true zurück, wenn mindestens ein Ausdruck true ist, oder false, wenn alle false sind.

Parameter Typ Beschreibung
Wert boolean Der erste zu überprüfende Ausdruck
Werte... boolean Die restlichen Zu überprüfenden Ausdrücke
Rückgabewerttyp Beschreibung
boolean Gibt true zurück, wenn mindestens ein Ausdruck true ist. Gibt false zurück, wenn alle Ausdrücke false sind.

Beispiele

In diesen Beispielen wird überprüft, ob mindestens ein Ausdruck true ist:

or(equals(1, 1), equals(1, 2))
or(equals(1, 2), equals(1, 3))
or(equals(1, 2))

Und gibt diese Ergebnisse zurück:

  • Erstes Beispiel: Mindestens ein Ausdruck ist true, sodass die Funktion zurückgibt true.
  • Zweites Beispiel: Beide Ausdrücke sind false, sodass die Funktion zurückgibt false.
  • Drittes Beispiel: Der Ausdruck ist false, sodass die Funktion zurückgibt false.

startsWith

Überprüfen Sie, ob eine Zeichenfolge mit einer bestimmten Teilzeichenfolge beginnt. Gibt true zurück, wenn die Teilzeichenfolge gefunden wird, oder false, wenn sie nicht gefunden wird. Bei dieser Funktion wird die Groß-/Kleinschreibung beachtet.

Parameter Typ Beschreibung
text Zeichenfolge Die zu überprüfende Zeichenfolge
searchText Zeichenfolge Die anfängliche Teilzeichenfolge, die gesucht werden soll
Rückgabewerttyp Beschreibung
boolean Gibt true zurück, wenn die startende Teilzeichenfolge gefunden wird. Gibt false zurück, wenn er nicht gefunden wird.

Beispiel 1

In diesem Beispiel wird überprüft, ob die Zeichenfolge "hello world" mit der Teilzeichenfolge "hello" beginnt:

startsWith('hello world', 'hello')

Und gibt dieses Ergebnis zurück: true

Beispiel 2

In diesem Beispiel wird überprüft, ob die Zeichenfolge "hello world" mit der Teilzeichenfolge "greetings" beginnt:

startsWith('hello world', 'greetings')

Und gibt dieses Ergebnis zurück: false

string

Diese Funktion gibt die Zeichenfolgenversion des Werts zurück.

Parameter Typ Beschreibung
Wert Any Der zu konvertierende Wert
Rückgabewerttyp Beschreibung
Zeichenfolge Die Zeichenfolgenversion für den angegebenen Wert. Wenn der value-Parameter NULL ist, wird dieser Wert als leerer Zeichenfolgenwert ("") zurückgegeben.

Beispiele

In diesen Beispielen wird der Eingabewert in eine Zeichenfolge konvertiert:

string('abc')
string(true)
string(createArray())

Und gibt diese Ergebnisse zurück:

  • Erstes Beispiel: Der Eingabewert ist eine Zeichenfolge, daher wird ein Identitätswert 'abc'zurückgegeben.
  • Zweites Beispiel: Die Zeichenfolgenversion boolescher Werte wird groß geschrieben, sodass die Funktion zurückgibt 'True'.
  • Drittes Beispiel: Arrays oder Objekte werden in json-Form konvertiert, sodass die Funktion zurückgibt '[]'.

Nächste Schritte

Weitere Informationen zu Workflows finden Sie in den folgenden Artikeln: