Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
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:
- Wählen Sie den Wert aus, den Sie bearbeiten möchten.
- Wählen Sie die Schaltfläche Dynamischen Inhalt hinzufügen aus, die unterhalb des Textfelds angezeigt wird.
- Wählen Sie im Fenster für dynamische Inhalte die Registerkarte Ausdrücke aus, und scrollen Sie, um Ihren Wert auszuwählen.
- Aktualisieren Sie Ihren Ausdruck, und wählen Sie OK aus, um ihn hinzuzufügen.
Ü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: