Udostępnij za pomocą


Przewodnik referencyjny dotyczący funkcji w wyrażeniach dla przepływów pracy w usługach Azure Logic Apps i Power Automate

Dotyczy: Azure Logic Apps (Consumption + Standard)

W przypadku definicji przepływów pracy w usługach Azure Logic Apps i Power Automate niektóre wyrażenia pobierają wartości z akcji środowiska uruchomieniowego, które mogą jeszcze nie istnieć po uruchomieniu przepływu pracy. Aby odwołać się do wartości w tych wyrażeniach lub przetworzyć je, możesz użyć funkcji wyrażeń udostępnianych przez język definicji przepływu pracy.

Note

Ten przewodnik referencyjny dotyczy zarówno usług Azure Logic Apps, jak i Power Automate, ale istnieje w dokumentacji usługi Azure Logic Apps. Chociaż przewodnik odnosi się specjalnie do przepływów pracy aplikacji logiki, te funkcje działają zarówno dla przepływów w usłudze Power Automate, jak i przepływów pracy w usłudze Azure Logic Apps. Aby uzyskać więcej informacji na temat funkcji i wyrażeń w usłudze Power Automate, zobacz Używanie wyrażeń w warunkach.

Można na przykład obliczyć wartości przy użyciu funkcji matematycznych, takich jak funkcja add(), gdy chcesz uzyskać sumę z liczb całkowitych lub zmiennoprzecinkowych. Poniżej przedstawiono inne przykładowe zadania, które można wykonywać za pomocą funkcji:

Task Składnia funkcji Result
Zwraca ciąg małymi literami. toLower('<tekst>')

Na przykład: toLower('Hello')
"hello"
Zwracanie globalnie unikatowego identyfikatora (GUID). guid() "c2ecc88d-88c8-4096-912c-d6f2e2b138ce"

Aby znaleźć funkcje na podstawie ich ogólnego przeznaczenia, zapoznaj się z poniższymi tabelami. Aby uzyskać szczegółowe informacje o każdej funkcji, zobacz listę alfabetyczną.

Funkcje w wyrażeniach

Aby pokazać, jak używać funkcji w wyrażeniu, w tym przykładzie pokazano, jak można uzyskać wartość z parametru customerName i przypisać tę wartość do accountName właściwości przy użyciu funkcji parameters() w wyrażeniu:

"accountName": "@parameters('customerName')"

Poniżej przedstawiono kilka innych ogólnych sposobów używania funkcji w wyrażeniach:

Task Składnia funkcji w wyrażeniu
Wykonaj pracę z elementem, przekazując ten element do funkcji. "@<functionName>(<item>)"
1. Pobierz wartość parametruName przy użyciu funkcji zagnieżdżonej parameters() .
2. Wykonaj pracę z wynikiem, przekazując tę wartość do functionName.
"@<functionName>(parameters('<parameterName>'))"
1. Pobierz wynik z zagnieżdżonej funkcji wewnętrznej functionName.
2. Przekaż wynik do funkcji zewnętrznej functionName2.
"@<functionName2>(<(><item>))"
1. Pobierz wynik z functionName.
2. Biorąc pod uwagę, że wynik jest obiektem właściwości propertyName, pobierz wartość tej właściwości.
"@<functionName>(<element>).<propertyName>"

Na przykład concat() funkcja może przyjmować co najmniej dwie wartości ciągu jako parametry. Ta funkcja łączy te ciągi w jeden ciąg. Możesz przekazać literały ciągu, na przykład "Sophia" i "Owen", aby uzyskać połączony ciąg "SophiaOwen":

"customerName": "@concat('Sophia', 'Owen')"

Możesz też pobrać wartości ciągów z parametrów. W tym przykładzie użyto parameters() funkcji w każdym concat() parametrze i parametrach firstName i lastName . Następnie przekazujesz wynikowe ciągi do concat() funkcji, aby uzyskać połączony ciąg, na przykład "SophiaOwen":

"customerName": "@concat(parameters('firstName'), parameters('lastName'))"

Tak czy inaczej oba przykłady przypisują wynik do customerName właściwości .

Zagadnienia dotyczące korzystania z funkcji

  • Projektant nie ocenia wyrażeń środowiska uruchomieniowego, które są używane jako parametry funkcji w czasie projektowania. Projektant wymaga, aby wszystkie wyrażenia mogły być w pełni oceniane w czasie projektowania.

  • Parametry funkcji są oceniane od lewej do prawej.

  • W składni definicji parametrów znak zapytania (?), który pojawia się po parametrze oznacza, że parametr jest opcjonalny. Zobacz na przykład getFutureTime().

  • Wyrażenia funkcji, które pojawiają się w tekście z tekstem zwykłym, wymagają ujęć nawiasów klamrowych ({}), aby zamiast tego używać formatu interpolowanego wyrażenia. Ten format pomaga uniknąć problemów z analizowaniem. Jeśli wyrażenie funkcji nie jest wyświetlane w tekście ze zwykłym tekstem, nie są wymagane nawiasy klamrowe.

    W poniższym przykładzie przedstawiono poprawną i niepoprawną składnię:

    Odpowiedź prawidłowa: "<text>/@{<function-name>('<parameter-name>')}/<text>"

    Odpowiedź nieprawidłowa: "<text>/@<function-name>('<parameter-name>')/<text>"

    OK:"@<function-name>('<parameter-name>')"

Poniższe sekcje organizują funkcje na podstawie ich ogólnego przeznaczenia lub można przeglądać te funkcje w kolejności alfabetycznej.

Funkcje łańcuchów znakowych

Aby pracować z ciągami, możesz użyć tych funkcji ciągów, a także niektórych funkcji kolekcji. Funkcje łańcuchowe działają tylko na łańcuchach znaków.

Funkcja String Task
chunk Podziel ciąg lub kolekcję na fragmenty o równej długości.
concat Połącz dwa lub więcej ciągów i zwróć połączony ciąg.
endsWith Sprawdź, czy ciąg kończy się określonym podciągem.
formatNumber Zwracanie liczby jako ciągu na podstawie określonego formatu
guid Wygeneruj globalnie unikalny identyfikator (GUID) jako ciąg znaków.
indexOf Zwróć pozycję początkową dla podciągu.
isFloat Zwraca wartość logiczną wskazującą, czy ciąg jest liczbą zmiennoprzecinkową.
isInt Zwraca wartość logiczną wskazującą, czy ciąg jest liczbą całkowitą.
lastIndexOf Zwróć pozycję początkową ostatniego wystąpienia podciągu.
length Zwraca liczbę elementów w ciągu lub tablicy.
nthIndexOf Zwróć pozycję początkową lub wartość indeksu, w której nwystąpienie podciągu pojawia się w ciągu.
replace Zastąp podciąg określonym ciągiem i zwróć zaktualizowany ciąg.
slice Zwróć podciąg, określając pozycję początkową i końcową lub wartość. Zobacz również podciąg.
split Zwraca tablicę zawierającą podciągi oddzielone przecinkami od większego ciągu na podstawie określonego znaku ogranicznika w oryginalnym ciągu.
startsWith Sprawdź, czy ciąg rozpoczyna się od określonego podciągu.
substring Zwraca znaki z ciągu, zaczynając od określonej pozycji. Zobacz również wycinek.
toLower Zwraca ciąg małymi literami.
toUpper Zwraca ciąg w formacie wielkiej litery.
trim Usuń spacje wiodące i końcowe z ciągu i zwróć zmieniony ciąg.

Funkcje odbioru

Aby pracować z kolekcjami, zazwyczaj tablicami, ciągami, a czasami słownikami, można użyć tych funkcji kolekcji.

Funkcja Collection Task
chunk Podziel ciąg lub kolekcję na fragmenty o równej długości.
contains Sprawdź, czy kolekcja zawiera określony element.
empty Sprawdź, czy kolekcja jest pusta.
first Zwróć pierwszy element z kolekcji.
intersection Zwróć kolekcję zawierającą tylko wspólne elementy w określonych kolekcjach.
item Jeśli ta funkcja pojawia się wewnątrz akcji powtarzającej się w tablicy, zwróć bieżący element w tablicy podczas bieżącej iteracji akcji.
join Zwróć ciąg zawierający wszystkie elementy z tablicy oddzielone określonym znakiem.
last Zwróć ostatni element z kolekcji.
length Zwraca liczbę elementów w ciągu lub tablicy.
reverse Odwraca kolejność elementów w tablicy.
skip Usuń elementy rozpoczynające kolekcję i zwróć wszystkie pozostałe elementy.
sort Sortuj elementy w kolekcji.
take Zwróć elementy z przodu kolekcji.
union Zwróć kolekcję zawierającą wszystkie elementy z określonych kolekcji.

Logiczne funkcje porównywania

Aby pracować z warunkami, porównać wartości i wyniki wyrażeń lub ocenić różne rodzaje logiki, możesz użyć tych funkcji porównania logicznego. Aby uzyskać pełną dokumentację dotyczącą każdej funkcji, zobacz listę alfabetyczną.

Note

Jeśli używasz funkcji logicznych lub warunków do porównywania wartości, wartości null są konwertowane na puste wartości ciągu (""). Zachowanie warunków różni się w porównaniu z pustym ciągiem zamiast wartości null. Aby uzyskać więcej informacji, zobacz funkcję string().

Funkcja porównania logicznego Task
and Sprawdź, czy wszystkie wyrażenia są prawdziwe.
equals Sprawdź, czy obie wartości są równoważne.
greater Sprawdź, czy pierwsza wartość jest większa niż druga wartość.
greaterOrEquals Sprawdź, czy pierwsza wartość jest większa lub równa drugiej wartości.
if Sprawdź, czy wyrażenie jest prawdziwe czy fałszywe. Na podstawie wyniku należy zwrócić określoną wartość.
isFloat Zwraca wartość logiczną wskazującą, czy ciąg jest liczbą zmiennoprzecinkową.
isInt Zwraca wartość logiczną wskazującą, czy ciąg jest liczbą całkowitą.
less Sprawdź, czy pierwsza wartość jest mniejsza od drugiej wartości.
lessOrEquals Sprawdź, czy pierwsza wartość jest mniejsza, czy równa drugiej wartości.
not Sprawdź, czy wyrażenie jest fałszywe.
or Sprawdź, czy co najmniej jedno wyrażenie jest prawdziwe.

Funkcje konwersji

Aby zmienić typ lub format wartości, możesz użyć tych funkcji konwersji. Na przykład można zmienić wartość z wartości logicznej na liczbę całkowitą. Aby uzyskać więcej informacji na temat sposobu obsługi typów zawartości przez usługę Azure Logic Apps podczas konwersji, zobacz Handle content types (Obsługa typów zawartości). Aby uzyskać pełną dokumentację dotyczącą każdej funkcji, zobacz listę alfabetyczną.

Note

Usługa Azure Logic Apps automatycznie lub niejawnie wykonuje kodowanie i dekodowanie base64, więc nie trzeba ręcznie wykonywać tych konwersji przy użyciu funkcji kodowania i dekodowania. Jeśli jednak używasz tych funkcji w projektancie, w projektancie mogą wystąpić nieoczekiwane zachowania renderowania. Te zachowania mają wpływ tylko na widoczność funkcji, a nie ich efekt, chyba że edytujesz wartości parametrów funkcji, co spowoduje usunięcie funkcji i ich efektów z kodu. Aby uzyskać więcej informacji, zobacz Niejawne konwersje typów danych.

Funkcja konwersji Task
array Zwraca tablicę z pojedynczego określonego wejścia. Aby uzyskać wiele danych wejściowych, zobacz createArray.
base64 Zwróć wersję zakodowaną w formacie base64 dla ciągu.
base64ToBinary Zwróć wersję binarną dla ciągu kodowanego w base64.
base64ToString Zwraca wersję ciągu dla ciągu zakodowanego w formacie base64.
binary Zwraca wersję binarną dla wartości wejściowej.
bool Zwróć wersję logiczną dla wartości wejściowej.
createArray Zwraca tablicę z wielu danych wejściowych.
dataUri Zwraca identyfikator URI danych dla wartości wejściowej.
dataUriToBinary Zwróć wersję binarną dla URI danych.
dataUriToString Zwróć wersję łańcuchową dla identyfikatora URI danych.
decimal Zwraca liczbę dziesiętną dla ciągu dziesiętnego.
decodeBase64 Zwraca wersję ciągu dla ciągu zakodowanego w formacie base64.
decodeDataUri Zwróć wersję binarną dla URI danych.
decodeUriComponent Zwróć ciąg znaków, w którym znaki ucieczki są zastępowane ich zdekodowanymi wersjami.
encodeUriComponent Zwróć ciąg, który zastępuje znaki niebezpieczne adresu URL znakami ucieczki.
float Zwraca liczbę zmiennoprzecinkową dla wartości wejściowej.
int Zwróć wersję całkowitą dla łańcucha znaków.
json Zwróć wartość typu JavaScript Object Notation (JSON) lub obiekt dla ciągu znaków lub XML.
string Zwraca wersję ciągu dla wartości wejściowej.
uriComponent Zwróć wersję kodowaną w URI dla wartości wejściowej, zastępując niebezpieczne dla URL znaki znakami ucieczki.
uriComponentToBinary Zwróć wersję binarną dla ciągu zakodowanego jako URI.
uriComponentToString Zwróć wersję w formie ciągu dla ciągu zakodowanego jako URI.
xml Zwróć wersję XML dla ciągu znaków.

Niejawne konwersje typów danych

Usługa Azure Logic Apps automatycznie lub niejawnie konwertuje między niektórymi typami danych, więc nie trzeba ręcznie wykonywać tych konwersji. Jeśli na przykład używasz wartości innych niż ciągi, w których ciągi są oczekiwane jako dane wejściowe, usługa Azure Logic Apps automatycznie konwertuje wartości inne niż ciągi na ciągi.

Załóżmy na przykład, że wyzwalacz zwraca wartość liczbową jako dane wyjściowe:

triggerBody()?['123']

Jeśli używasz tych liczbowych danych wyjściowych, w których oczekiwane są dane wejściowe ciągu, takie jak adres URL, usługa Azure Logic Apps automatycznie konwertuje wartość na ciąg przy użyciu notacji nawiasów klamrowych ({}):

@{triggerBody()?['123']}

Kodowanie i dekodowanie base64

Usługa Azure Logic Apps automatycznie lub niejawnie wykonuje kodowanie lub dekodowanie base64, więc nie trzeba ręcznie wykonywać tych konwersji przy użyciu odpowiednich funkcji:

  • base64(<value>)
  • base64ToBinary(<value>)
  • base64ToString(<value>)
  • base64(decodeDataUri(<value>))
  • concat('data:;base64,',<value>)
  • concat('data:,',encodeUriComponent(<value>))
  • decodeDataUri(<value>)

Note

Jeśli ręcznie dodasz dowolną z tych funkcji podczas korzystania z projektanta, bezpośrednio do wyzwalacza lub akcji lub za pomocą edytora wyrażeń, odejdź od projektanta, a następnie wróć do projektanta, funkcja zniknie z projektanta, pozostawiając tylko wartości parametrów. To zachowanie występuje również w przypadku wybrania wyzwalacza lub akcji, która używa tej funkcji bez edytowania wartości parametrów funkcji. Ten wynik wpływa tylko na widoczność funkcji, a nie na efekt. W widoku kodu funkcja nie ma wpływu. Jednak jeśli edytujesz wartości parametrów funkcji, funkcja i jej efekt zostaną usunięte z widoku kodu, pozostawiając tylko wartości parametrów funkcji.

Funkcje matematyczne

Aby pracować z liczbami całkowitymi i zmiennoprzecinkami, możesz użyć tych funkcji matematycznych. Aby uzyskać pełną dokumentację dotyczącą każdej funkcji, zobacz listę alfabetyczną.

Math, funkcja Task
add Zwróć wynik z dodania dwóch liczb.
div Zwróć wynik dzielenia dwóch liczb.
max Zwraca najwyższą wartość z zestawu liczb lub tablicy.
min Zwraca najniższą wartość z zestawu liczb lub tablicy.
mod Zwróć resztę z dzielenia dwóch liczb.
mul Zwróć wynik mnożenia dwóch liczb.
rand Zwraca losową liczbę całkowitą z określonego zakresu.
range Zwraca tablicę całkowitą rozpoczynającą się od określonej liczby całkowitej.
sub Zwróć wynik odejmowania liczby drugiej od liczby pierwszej.

Funkcje daty i godziny

Aby pracować z datami i godzinami, możesz użyć tych funkcji daty i godziny. Aby uzyskać pełną dokumentację dotyczącą każdej funkcji, zobacz listę alfabetyczną.

Funkcja daty lub godziny Task
addDays Dodaj dni do znacznika czasu.
addHours Dodaj godziny do znacznika czasu.
addMinutes Dodaj minuty do znacznika czasu.
addSeconds Dodaj sekundy do znacznika czasu.
addToTime Dodaj określone jednostki czasu do znacznika czasu. Zobacz również getFutureTime.
convertFromUtc Przekonwertuj znacznik czasu z uniwersalnego czasu koordynowanego (UTC) na docelową strefę czasową.
convertTimeZone Przekonwertuj znacznik czasu ze źródłowej strefy czasowej na docelową strefę czasową.
convertToUtc Przekonwertuj znacznik czasu ze źródłowej strefy czasowej na uniwersalny czas koordynowany (UTC).
dateDifference Zwróć różnicę między dwiema datami jako przedziałem czasu.
dayOfMonth Zwróć składnik dnia miesiąca z sygnatury czasowej.
dayOfWeek Zwróć komponent dnia tygodnia ze znacznika czasu.
dayOfYear Zwraca dzień składnika roku ze znacznika czasu.
formatDateTime Zwraca datę ze znacznika czasu.
getFutureTime Zwróć bieżący znacznik czasu powiększony o określoną liczbę jednostek czasu. Zobacz również addToTime.
getPastTime Zwróć aktualny znacznik czasu pomniejszony o określone jednostki czasu. Zobacz również odejmowanieFromTime.
parseDateTime Zwróć znacznik czasu z ciągu zawierającego znacznik czasu.
startOfDay Zwróć początek dnia dla znacznika czasu.
startOfHour Zwróć początek bieżącej godziny dla danego znacznika czasu.
startOfMonth Zwróć początek miesiąca na podstawie znacznika czasu.
subtractFromTime Odejmij liczbę jednostek czasu od znacznika czasowego. Zobacz również getPastTime.
ticks Zwróć wartość właściwości ticks dla określonego znacznika czasu.
utcNow Zwróć aktualny znacznik czasu jako ciąg znaków.

Funkcje przepływu pracy

Te funkcje przepływu pracy mogą pomóc:

  • Uzyskaj szczegółowe informacje o wystąpieniu przepływu pracy w czasie wykonywania.
  • Praca z danymi wejściowymi używanymi do tworzenia wystąpień aplikacji logiki lub przepływów.
  • Odwołuj się do danych wyjściowych z wyzwalaczy i akcji.

Na przykład możesz odwoływać się do danych wyjściowych z jednej akcji i używać tych danych w późniejszej akcji. Aby uzyskać pełną dokumentację dotyczącą każdej funkcji, zobacz listę alfabetyczną.

Funkcja przepływu pracy Task
action Zwróć dane wyjściowe bieżącej akcji w czasie wykonywania lub wartości z innych par nazw i wartości JSON. Zobacz również akcje.
actions Zwraca dane wyjściowe akcji w czasie wykonywania lub wartości z innych par nazw i wartości JSON. Zobacz też akcję.
body Zwraca dane wyjściowe akcji body w czasie wykonywania.
formDataMultiValues Utwórz tablicę z wartościami, które pasują do nazwy klucza w danych formularza lub w danych wyjściowych akcji zakodowanych w formie .
formDataValue Zwraca pojedynczą wartość zgodną z nazwą klucza w danych formularza lub danych wyjściowych zakodowanych w formie akcji.
item Jeśli ta funkcja pojawia się wewnątrz akcji powtarzającej się w tablicy, zwróć bieżący element w tablicy podczas bieżącej iteracji akcji.
items Jeśli ta funkcja pojawi się wewnątrz pętli Foreach lub Until, zwróć bieżący element z określonej pętli.
iterationIndexes Jeśli ta funkcja pojawi się wewnątrz pętli Until, zwróć wartość indeksu dla bieżącej iteracji. Tej funkcji można używać wewnątrz zagnieżdżonych pętli Until.
listCallbackUrl Zwróć "adres URL wywołania zwrotnego", który wywołuje wyzwalacz lub akcję.
multipartBody Zwróć treść określonej części w danych wyjściowych akcji, które mają wiele części.
outputs Zwraca dane wyjściowe akcji w czasie wykonywania.
parameters Zwróć wartość parametru opisanego w definicji przepływu pracy.
result Zwraca dane wejściowe i wyjściowe z akcji najwyższego poziomu wewnątrz określonej akcji o określonym zakresie, takiej jak For_each, Untili Scope.
trigger Zwraca dane wyjściowe wyzwalacza w czasie wykonywania lub z innych par nazw i wartości JSON. Zobacz również wyzwalaczOutputs i triggerBody.
triggerBody Zwracanie danych wyjściowych body wyzwalacza w czasie wykonywania. Zobacz wyzwalacz.
triggerFormDataValue Zwraca pojedynczą wartość odpowiadającą nazwie klucza w danych formularza lub danych wyjściowych wyzwalacza zakodowanego w formie .
triggerMultipartBody Zwróć treść określonej części w danych wyjściowych wieloczęściowych wyzwalacza.
triggerFormDataMultiValues Utwórz tablicę, której wartości pasują do nazwy klucza w danych formularza lub w danych wyjściowych wyzwalacza zakodowanego w formie .
triggerOutputs Zwraca dane wyjściowe wyzwalacza w czasie wykonywania lub wartości z innych par nazw i wartości JSON. Zobacz wyzwalacz.
variables Zwraca wartość określonej zmiennej.
workflow Zwróć wszystkie szczegóły dotyczące samego przepływu pracy w czasie wykonywania.

Funkcje analizowania URI

Aby pracować z identyfikatorami URI i uzyskać różne wartości właściwości dla tych identyfikatorów URI, możesz użyć tych funkcji analizowania identyfikatorów URI. Aby uzyskać pełną dokumentację dotyczącą każdej funkcji, zobacz listę alfabetyczną.

Funkcja analizowania identyfikatora URI Task
uriHost host Zwraca wartość identyfikatora URI (Uniform Resource Identifier).
uriPath path Zwraca wartość identyfikatora URI (Uniform Resource Identifier).
uriPathAndQuery Zwraca wartości path i query dla identyfikatora URI (URI).
uriPort port Zwraca wartość identyfikatora URI (Uniform Resource Identifier).
uriQuery query Zwraca wartość identyfikatora URI (Uniform Resource Identifier).
uriScheme scheme Zwraca wartość identyfikatora URI (Uniform Resource Identifier).

Funkcje manipulowania: JSON i XML

Aby pracować z obiektami JSON i węzłami XML, można użyć tych funkcji manipulowania. Aby uzyskać pełną dokumentację dotyczącą każdej funkcji, zobacz listę alfabetyczną.

Funkcja manipulowania Task
addProperty Dodaj właściwość i jej wartość lub parę name-value do obiektu JSON i zwróć zaktualizowany obiekt.
coalesce Zwraca pierwszą wartość inną niż null z co najmniej jednego parametru.
removeProperty Usuń właściwość z obiektu JSON i zwróć zaktualizowany obiekt.
setProperty Ustaw wartość właściwości obiektu JSON i zwróć zaktualizowany obiekt.
xpath Sprawdź kod XML dla węzłów lub wartości, które są zgodne z wyrażeniem XPath (XML Path Language) i zwraca pasujące węzły lub wartości.

---------------------------------

Wszystkie funkcje — lista alfabetyczna

W tej sekcji wymieniono wszystkie dostępne funkcje w kolejności alfabetycznej.

A

akcja

Zwróć dane wyjściowe bieżącej akcji w czasie wykonywania lub wartości z innych par nazw i wartości JSON, które można przypisać do wyrażenia. Domyślnie ta funkcja odwołuje się do całego obiektu akcji, ale opcjonalnie można określić właściwość, której wartość chcesz. Zobacz również akcje().

Funkcji można używać action() tylko w następujących miejscach:

  • Właściwość unsubscribe akcji elementu webhook, aby uzyskać dostęp do wyniku z oryginalnego subscribe żądania
  • Właściwość trackedProperties akcji
  • do-until Warunek pętli dla akcji
action()
action().outputs.body.<property>
Parameter Required Typ Description
< własność> No String Nazwa właściwości obiektu akcji, której wartość ma być następująca: name, startTime, endTime, inputs, outputs, status, code, trackingId i clientTrackingId. W witrynie Azure Portal te właściwości można znaleźć, przeglądając szczegóły konkretnej historii uruchamiania. Aby uzyskać więcej informacji, zobacz INTERFEJS API REST — akcje uruchamiania przepływu pracy.
Wartość zwracana Typ Description
< Akcja-wyjście> Object Dane wyjściowe obiektu JSON z bieżącej akcji lub właściwości

actions

Zwraca dane wyjściowe akcji w czasie wykonywania lub wartości z innych par nazw i wartości JSON, które można przypisać do wyrażenia. Domyślnie funkcja odwołuje się do całego obiektu akcji, ale opcjonalnie można określić właściwość, której wartość jest odpowiednia. Aby uzyskać skrócone wersje, zobacz body(). Aby uzyskać bieżącą akcję, zobacz action().

Note

Wcześniej można było użyć actions() funkcji lub conditions elementu podczas określania, że akcja została uruchomiona na podstawie danych wyjściowych innej akcji. Jednak aby zadeklarować jawne zależności między akcjami, należy teraz użyć właściwości zależnej akcji runAfter . Aby dowiedzieć się więcej na temat runAfter właściwości, zobacz Catch and handle failures with the runAfter property (Przechwytywanie i obsługa błędów za pomocą właściwości runAfter).

actions('<actionName>')
actions('<actionName>').outputs.body.<property>
Parameter Required Typ Description
< actionName> Yes String Nazwa obiektu akcji, którego dane wyjściowe chcesz wykonać
< własność> No String Nazwa właściwości obiektu akcji, której wartość ma być następująca: name, startTime, endTime, inputs, outputs, status, code, trackingId i clientTrackingId. W witrynie Azure Portal te właściwości można znaleźć, przeglądając szczegóły konkretnej historii uruchamiania. Aby uzyskać więcej informacji, zobacz INTERFEJS API REST — akcje uruchamiania przepływu pracy.
Wartość zwracana Typ Description
< Akcja-wyjście> Object Dane wyjściowe obiektu JSON z określonej akcji lub właściwości

Example

Ten przykład pobiera status wartość właściwości z akcji Get user X w czasie wykonywania:

actions('Get_user').outputs.body.status

I zwraca ten wynik: "Succeeded"

add

Zwróć wynik z dodania dwóch liczb.

add(<summand_1>, <summand_2>)
Parameter Required Typ Description
< >summand_1, <summand_2> Yes Liczba całkowita, zmiennoprzecinkowa lub mieszana Liczby do dodania
Wartość zwracana Typ Description
< wynik-suma> Liczba całkowita lub zmiennoprzecinkowa Wynik dodawania określonych liczb

Example

W tym przykładzie dodano określone liczby:

add(1, 1.5)

I zwraca ten wynik: 2.5

addDays

Dodaj dni do znacznika czasu.

addDays('<timestamp>', <days>, '<format>'?)
Parameter Required Typ Description
< Sygnatury czasowej> Yes String Ciąg zawierający znacznik czasu
< Dni> Yes Integer Dodatnia lub ujemna liczba dni do dodania
< format> No String Ciąg formatu liczbowego, który jest specyfikatorem pojedynczego formatu lub wzorcem formatu niestandardowego. Domyślny format znacznika czasu to "o" (rrrr-MM-ddTHH:mm:ss.fffffffK), który jest zgodny z normą ISO 8601 i zachowuje informacje o strefie czasowej.

Jeśli format nie jest prawidłową wartością, zostanie wygenerowany błąd.
Wartość zwracana Typ Description
< sygnatura czasowa aktualizacji> String Znacznik czasu plus określona liczba dni

Przykład 1

W tym przykładzie dodano 10 dni do określonego znacznika czasu:

addDays('2018-03-15T00:00:00Z', 10)

I zwraca ten wynik: "2018-03-25T00:00:00.0000000Z"

Przykład 2

W tym przykładzie odejmuje pięć dni od określonego znacznika czasu:

addDays('2018-03-15T00:00:00Z', -5)

I zwraca ten wynik: "2018-03-10T00:00:00.0000000Z"

addHours

Dodaj godziny do znacznika czasu.

addHours('<timestamp>', <hours>, '<format>'?)
Parameter Required Typ Description
< Sygnatury czasowej> Yes String Ciąg zawierający znacznik czasu
< Godzin> Yes Integer Dodatnia lub ujemna liczba godzin do dodania
< format> No String Ciąg formatu liczbowego, który jest specyfikatorem pojedynczego formatu lub wzorcem formatu niestandardowego. Domyślny format znacznika czasu to "o" (rrrr-MM-ddTHH:mm:ss.fffffffK), który jest zgodny z normą ISO 8601 i zachowuje informacje o strefie czasowej.

Jeśli format nie jest prawidłową wartością, zostanie wygenerowany błąd.
Wartość zwracana Typ Description
< sygnatura czasowa aktualizacji> String Znacznik czasu plus określona liczba godzin

Przykład 1

W tym przykładzie dodano 10 godzin do określonego znacznika czasu:

addHours('2018-03-15T00:00:00Z', 10)

I zwraca ten wynik: "2018-03-15T10:00:00.0000000Z"

Przykład 2

W tym przykładzie odejmuje pięć godzin od określonego znacznika czasu:

addHours('2018-03-15T15:00:00Z', -5)

I zwraca ten wynik: "2018-03-15T10:00:00.0000000Z"

addMinutes

Dodaj minuty do znacznika czasu.

addMinutes('<timestamp>', <minutes>, '<format>'?)
Parameter Required Typ Description
< Sygnatury czasowej> Yes String Ciąg zawierający znacznik czasu
< protokół> Yes Integer Dodatnia lub ujemna liczba minut do dodania
< format> No String Ciąg formatu liczbowego, który jest specyfikatorem pojedynczego formatu lub wzorcem formatu niestandardowego. Domyślny format znacznika czasu to "o" (rrrr-MM-ddTHH:mm:ss.fffffffK), który jest zgodny z normą ISO 8601 i zachowuje informacje o strefie czasowej.

Jeśli format nie jest prawidłową wartością, zostanie wygenerowany błąd.
Wartość zwracana Typ Description
< sygnatura czasowa aktualizacji> String Znacznik czasu plus określona liczba minut

Przykład 1

W tym przykładzie dodano 10 minut do określonego znacznika czasu:

addMinutes('2018-03-15T00:10:00Z', 10)

I zwraca ten wynik: "2018-03-15T00:20:00.0000000Z"

Przykład 2

W tym przykładzie odejmuje pięć minut od określonego znacznika czasu:

addMinutes('2018-03-15T00:20:00Z', -5)

I zwraca ten wynik: "2018-03-15T00:15:00.0000000Z"

addProperty

Dodaj właściwość i jej wartość lub parę name-value do obiektu JSON i zwróć zaktualizowany obiekt. Jeśli właściwość już istnieje w czasie wykonywania, funkcja kończy się niepowodzeniem i zgłasza błąd.

addProperty(<object>, '<property>', <value>)
Parameter Required Typ Description
< sprzeciwiać się> Yes Object Obiekt JSON, w którym chcesz dodać właściwość
< własność> Yes String Nazwa właściwości do dodania
< wartość> Yes Any Wartość właściwości
Wartość zwracana Typ Description
< zaktualizowany obiekt> Object Zaktualizowany obiekt JSON z określoną właściwością

Aby dodać właściwość nadrzędną do istniejącej właściwości, użyj setProperty() funkcji, a nie addProperty() funkcji. W przeciwnym razie funkcja zwraca tylko obiekt podrzędny jako dane wyjściowe.

setProperty(<object>, '<parent-property>', addProperty(<object>['<parent-property>'], '<child-property>', <value>)
Parameter Required Typ Description
< sprzeciwiać się> Yes Object Obiekt JSON, w którym chcesz dodać właściwość
< właściwość nadrzędna> Yes String Nazwa właściwości nadrzędnej, w której chcesz dodać właściwość podrzędną
< właściwość podrzędna> Yes String Nazwa właściwości podrzędnej do dodania
< wartość> Yes Any Wartość ustawiona dla określonej właściwości
Wartość zwracana Typ Description
< zaktualizowany obiekt> Object Zaktualizowany obiekt JSON, którego właściwość została ustawiona

Przykład 1

W tym przykładzie middleName właściwość dodaje do obiektu JSON, który jest konwertowany z ciągu na format JSON przy użyciu funkcji JSON(). Obiekt zawiera firstName już właściwości i surName . Funkcja przypisuje określoną wartość do nowej właściwości i zwraca zaktualizowany obiekt:

addProperty(json('{ "firstName": "Sophia", "lastName": "Owen" }'), 'middleName', 'Anne')

Oto bieżący obiekt JSON:

{
   "firstName": "Sophia",
   "surName": "Owen"
}

Oto zaktualizowany obiekt JSON:

{
   "firstName": "Sophia",
   "middleName": "Anne",
   "surName": "Owen"
}

Przykład 2

W tym przykładzie właściwość podrzędna middleName dodaje właściwość podrzędną do istniejącej customerName właściwości w obiekcie JSON, który jest konwertowany z ciągu na format JSON przy użyciu funkcji JSON(). Funkcja przypisuje określoną wartość do nowej właściwości i zwraca zaktualizowany obiekt:

setProperty(json('{ "customerName": { "firstName": "Sophia", "surName": "Owen" } }'), 'customerName', addProperty(json('{ "customerName": { "firstName": "Sophia", "surName": "Owen" } }')['customerName'], 'middleName', 'Anne'))

Oto bieżący obiekt JSON:

{
   "customerName": {
      "firstName": "Sophia",
      "surName": "Owen"
   }
}

Oto zaktualizowany obiekt JSON:

{
   "customerName": {
      "firstName": "Sophia",
      "middleName": "Anne",
      "surName": "Owen"
   }
}

addSeconds

Dodaj sekundy do znacznika czasu.

addSeconds('<timestamp>', <seconds>, '<format>'?)
Parameter Required Typ Description
< Sygnatury czasowej> Yes String Ciąg zawierający znacznik czasu
< Sekund> Yes Integer Dodatnia lub ujemna liczba sekund do dodania
< format> No String Ciąg formatu liczbowego, który jest specyfikatorem pojedynczego formatu lub wzorcem formatu niestandardowego. Domyślny format znacznika czasu to "o" (rrrr-MM-ddTHH:mm:ss.fffffffK), który jest zgodny z normą ISO 8601 i zachowuje informacje o strefie czasowej.

Jeśli format nie jest prawidłową wartością, zostanie wygenerowany błąd.
Wartość zwracana Typ Description
< sygnatura czasowa aktualizacji> String Sygnatura czasowa plus określona liczba sekund

Przykład 1

W tym przykładzie dodano 10 sekund do określonego znacznika czasu:

addSeconds('2018-03-15T00:00:00Z', 10)

I zwraca ten wynik: "2018-03-15T00:00:10.0000000Z"

Przykład 2

W tym przykładzie odejmuje pięć sekund do określonego znacznika czasu:

addSeconds('2018-03-15T00:00:30Z', -5)

I zwraca ten wynik: "2018-03-15T00:00:25.0000000Z"

addToTime

Dodaj określone jednostki czasu do znacznika czasu. Zobacz również getFutureTime().

addToTime('<timestamp>', <interval>, '<timeUnit>', '<format>'?)
Parameter Required Typ Description
< Sygnatury czasowej> Yes String Ciąg zawierający znacznik czasu
< interwał> Yes Integer Liczba określonych jednostek czasu do dodania
< timeUnit> Yes String Jednostka czasu do użycia z interwałem: "Second", "Minute", "Hour", "Day", "Week", "Month", "Year"
< format> No String Ciąg formatu liczbowego, który jest specyfikatorem pojedynczego formatu lub wzorcem formatu niestandardowego. Domyślny format znacznika czasu to "o" (rrrr-MM-ddTHH:mm:ss.fffffffK), który jest zgodny z normą ISO 8601 i zachowuje informacje o strefie czasowej.

Jeśli format nie jest prawidłową wartością, zostanie wygenerowany błąd.
Wartość zwracana Typ Description
< sygnatura czasowa aktualizacji> String Sygnatura czasowa plus określona liczba jednostek czasu

Przykład 1

Ten przykład dodaje jeden dzień do określonego znacznika czasu:

addToTime('2018-01-01T00:00:00Z', 1, 'Day')

I zwraca ten wynik: "2018-01-02T00:00:00.0000000Z"

Przykład 2

Ten przykład dodaje jeden dzień do określonego znacznika czasu:

addToTime('2018-01-01T00:00:00Z', 1, 'Day', 'D')

Zwraca wynik przy użyciu opcjonalnego formatu "D": "Tuesday, January 2, 2018"

and

Sprawdź, czy wszystkie wyrażenia są prawdziwe. Zwraca wartość true, gdy wszystkie wyrażenia mają wartość true lub zwracają wartość false, gdy co najmniej jedno wyrażenie ma wartość false.

and(<expression1>, <expression2>, ...)
Parameter Required Typ Description
< wyraz1,><wyrażenie2>, ... Yes logiczny Wyrażenia do sprawdzenia
Wartość zwracana Typ Description
prawda lub fałsz logiczny Zwraca wartość true, gdy wszystkie wyrażenia są prawdziwe. Zwraca wartość false, gdy co najmniej jedno wyrażenie ma wartość false.

Przykład 1

Te przykłady sprawdzają, czy określone wartości logiczne są prawdziwe:

and(true, true)
and(false, true)
and(false, false)

I zwraca następujące wyniki:

  • Pierwszy przykład: Oba wyrażenia są prawdziwe, więc zwraca wartość true.
  • Drugi przykład: jedno wyrażenie jest fałszywe, więc zwraca wartość false.
  • Trzeci przykład: Oba wyrażenia są fałszywe, więc zwraca wartość false.

Przykład 2

Te przykłady sprawdzają, czy określone wyrażenia są prawdziwe:

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

I zwraca następujące wyniki:

  • Pierwszy przykład: Oba wyrażenia są prawdziwe, więc zwraca wartość true.
  • Drugi przykład: jedno wyrażenie jest fałszywe, więc zwraca wartość false.
  • Trzeci przykład: Oba wyrażenia są fałszywe, więc zwraca wartość false.

macierz

Zwraca tablicę z pojedynczego określonego wejścia. W przypadku wielu danych wejściowych zobacz createArray().

array('<value>')
Parameter Required Typ Description
< wartość> Yes String Ciąg do tworzenia tablicy
Wartość zwracana Typ Description
[<wartość>] Array Tablica zawierająca pojedyncze określone dane wejściowe

Example

W tym przykładzie zostanie utworzona tablica z ciągu "hello":

array('hello')

I zwraca ten wynik: ["hello"]

B

base64

Zwróć wersję zakodowaną w formacie base64 dla ciągu.

Note

Usługa Azure Logic Apps automatycznie lub niejawnie wykonuje kodowanie i dekodowanie base64, więc nie trzeba ręcznie wykonywać tych konwersji przy użyciu funkcji kodowania i dekodowania. Jeśli jednak używasz tych funkcji, w projektancie mogą wystąpić nieoczekiwane zachowania renderowania. Te zachowania mają wpływ tylko na widoczność funkcji, a nie ich efekt, chyba że edytujesz wartości parametrów funkcji, co spowoduje usunięcie funkcji i ich efektów z kodu. Aby uzyskać więcej informacji, zobacz Kodowanie i dekodowanie Base64.

base64('<value>')
Parameter Required Typ Description
< wartość> Yes String Ciąg wejściowy
Wartość zwracana Typ Description
< ciąg base64> String Wersja zakodowana w formacie base64 dla ciągu wejściowego

Example

W tym przykładzie ciąg "hello" jest konwertowany na ciąg zakodowany w formacie base64:

base64('hello')

I zwraca ten wynik: "aGVsbG8="

base64ToBinary

Zwróć wersję binarną dla ciągu kodowanego w base64.

Note

Usługa Azure Logic Apps automatycznie lub niejawnie wykonuje kodowanie i dekodowanie base64, więc nie trzeba ręcznie wykonywać tych konwersji przy użyciu funkcji kodowania i dekodowania. Jeśli jednak używasz tych funkcji w projektancie, w projektancie mogą wystąpić nieoczekiwane zachowania renderowania. Te zachowania mają wpływ tylko na widoczność funkcji, a nie ich efekt, chyba że edytujesz wartości parametrów funkcji, co spowoduje usunięcie funkcji i ich efektów z kodu. Aby uzyskać więcej informacji, zobacz Kodowanie i dekodowanie Base64.

base64ToBinary('<value>')
Parameter Required Typ Description
< wartość> Yes String Ciąg zakodowany w formacie base64 do konwersji
Wartość zwracana Typ Description
< binarny-za-base64-string> String Wersja binarna dla ciągu zakodowanego w formacie base64

Example

W tym przykładzie ciąg "aGVsbG8=" zakodowany w formacie base64 jest konwertowany na ciąg binarny:

base64ToBinary('aGVsbG8=')

Załóżmy na przykład, że używasz akcji HTTP do wysłania żądania. Możesz użyć base64ToBinary() polecenia , aby przekonwertować ciąg zakodowany w formacie base64 na dane binarne i wysłać te dane przy użyciu application/octet-stream typu zawartości w żądaniu.

base64ToString

Zwróć wersję ciągu dla ciągu zakodowanego w formacie base64, co skutecznie dekoduje ciąg base64. Użyj tej funkcji zamiast dekodowaćBase64(), która jest przestarzała.

Note

Usługa Azure Logic Apps automatycznie lub niejawnie wykonuje kodowanie i dekodowanie base64, więc nie trzeba ręcznie wykonywać tych konwersji przy użyciu funkcji kodowania i dekodowania. Jeśli jednak używasz tych funkcji w projektancie, w projektancie mogą wystąpić nieoczekiwane zachowania renderowania. Te zachowania mają wpływ tylko na widoczność funkcji, a nie ich efekt, chyba że edytujesz wartości parametrów funkcji, co spowoduje usunięcie funkcji i ich efektów z kodu. Aby uzyskać więcej informacji, zobacz Kodowanie i dekodowanie Base64.

base64ToString('<value>')
Parameter Required Typ Description
< wartość> Yes String Ciąg zakodowany w formacie base64 do dekodowania
Wartość zwracana Typ Description
< dekodowany-base64-string> String Wersja ciągu dla ciągu zakodowanego w formacie base64

Example

Ten przykład konwertuje ciąg zakodowany w formacie base64 "aGVsbG8=" na tylko ciąg:

base64ToString('aGVsbG8=')

I zwraca ten wynik: "hello"

binarny

Zwróć zakodowaną w formacie base64 wersję binarną ciągu.

binary('<value>')
Parameter Required Typ Description
< wartość> Yes String Ciąg do konwersji
Wartość zwracana Typ Description
< binarny-za-wartość wejściową> String Zakodowana w formacie base64 wersja binarna dla określonego ciągu

Example

Na przykład używasz akcji HTTP zwracającej obraz lub plik wideo. Możesz użyć binary() polecenia , aby przekonwertować wartość na model koperty zawartości zakodowanej w formacie base-64. Następnie możesz ponownie użyć koperty zawartości w innych akcjach, takich jak Compose. To wyrażenie funkcji służy do wysyłania bajtów ciągu z typem application/octet-stream zawartości w żądaniu.

body

Zwraca dane wyjściowe akcji body w czasie wykonywania. Skrót dla .actions('<actionName>').outputs.body Zobacz akcje().

body('<actionName>')
Parameter Required Typ Description
< actionName> Yes String Nazwa danych wyjściowych body akcji, które chcesz wykonać
Wartość zwracana Typ Description
< Akcja-ciało-wyjście> String Dane body wyjściowe z określonej akcji

Example

Ten przykład pobiera body dane wyjściowe z Get user akcji X:

body('Get_user')

I zwraca ten wynik:

"body": {
    "FullName": "Contoso Corporation",
    "Location": "Generic Town, USA",
    "Id": 283541717,
    "UserName": "ContosoInc",
    "FollowersCount": 172,
    "Description": "Leading the way in transforming the digital workplace.",
    "StatusesCount": 93,
    "FriendsCount": 126,
    "FavouritesCount": 46,
    "ProfileImageUrl": "https://pbs.twimg.com/profile_images/908820389907722240/gG9zaHcd_400x400.jpg"
}

bool

Zwróć wersję logiczną wartości.

bool(<value>)
Parameter Required Typ Description
< wartość> Yes Any Wartość, która ma być konwertowana na wartość logiczną.

Jeśli używasz z bool() obiektem, wartość obiektu musi być ciągiem lub liczbą całkowitą, którą można przekonwertować na wartość logiczną.

Wartość zwracana Typ Description
true lub false logiczny Wersja logiczna określonej wartości.

Outputs

W poniższych przykładach przedstawiono różne obsługiwane typy danych wejściowych dla elementu bool():

Wartość wejściowa Typ Wartość zwracana
bool(1) Integer true
bool(0) Integer false
bool(-1) Integer true
bool('true') String true
bool('false') String false

C

chunk

Podziel ciąg lub tablicę na fragmenty o równej długości.

chunk('<collection>', '<length>')
chunk([<collection>], '<length>')
Parameter Required Typ Description
< kolekcja> Yes Ciąg lub tablica Kolekcja do podziału
< długość> Yes Długość każdego fragmentu
Wartość zwracana Typ Description
< kolekcja> Array Tablica fragmentów o określonej długości

Przykład 1

W tym przykładzie ciąg jest podzielony na fragmenty o długości 10:

chunk('abcdefghijklmnopqrstuvwxyz', 10)

I zwraca ten wynik: ['abcdefghij', 'klmnopqrst', 'uvwxyz']

Przykład 2

W tym przykładzie tablica jest podzielona na fragmenty o długości 5.

chunk(createArray(1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12), 5)

I zwraca ten wynik: [ [1,2,3,4,5], [6,7,8,9,10], [11,12] ]

połączyć

Zwraca pierwszą wartość inną niż null z co najmniej jednego parametru. Puste ciągi, puste tablice i puste obiekty nie mają wartości null.

coalesce(<object_1>, <object_2>, ...)
Parameter Required Typ Description
< >object_1, <object_2>, ... Yes Dowolny, może mieszać typy Co najmniej jeden element do sprawdzenia pod kątem wartości null
Wartość zwracana Typ Description
< pierwszy element o wartości innej niż null> Any Pierwszy element lub wartość, która nie ma wartości null. Jeśli wszystkie parametry mają wartość null, ta funkcja zwraca wartość null.

Example

Te przykłady zwracają pierwszą wartość inną niż null z określonych wartości lub null, gdy wszystkie wartości mają wartość null:

coalesce(null, true, false)
coalesce(null, 'hello', 'world')
coalesce(null, null, null)

I zwraca następujące wyniki:

  • Pierwszy przykład: true
  • Drugi przykład: "hello"
  • Trzeci przykład: null

concat

Połącz dwa lub więcej ciągów i zwróć połączony ciąg.

concat('<text1>', '<text2>', ...)
Parameter Required Typ Description
< tekst1>, <tekst2>, ... Yes String Co najmniej dwa ciągi do połączenia
Wartość zwracana Typ Description
< text1text2...> String Ciąg utworzony na podstawie połączonych ciągów wejściowych.



Uwaga: Długość wyniku nie może przekraczać 104 857 600 znaków.

Note

Usługa Azure Logic Apps automatycznie lub niejawnie wykonuje kodowanie i dekodowanie base64, więc nie trzeba ręcznie wykonywać tych konwersji podczas korzystania z concat() funkcji z danymi, które wymagają kodowania lub dekodowania:

  • concat('data:;base64,',<value>)
  • concat('data:,',encodeUriComponent(<value>))

Jeśli jednak używasz tej funkcji w projektancie, w projektancie mogą wystąpić nieoczekiwane zachowania renderowania. Te zachowania mają wpływ tylko na widoczność funkcji, a nie efekt, chyba że edytujesz wartości parametrów funkcji, co spowoduje usunięcie funkcji i efektu z kodu. Aby uzyskać więcej informacji, zobacz Kodowanie i dekodowanie Base64.

Example

Ten przykład łączy ciągi "Hello" i "World":

concat('Hello', 'World')

I zwraca ten wynik: "HelloWorld"

contains

Sprawdź, czy kolekcja zawiera określony element. Zwraca wartość true, gdy element zostanie znaleziony lub zwraca wartość false, gdy nie zostanie znaleziony. Ta funkcja uwzględnia wielkość liter.

contains('<collection>', '<value>')
contains([<collection>], '<value>')

W szczególności ta funkcja działa na następujących typach kolekcji:

  • Ciąg do znalezienia podciągów
  • Tablica do znalezienia wartości
  • Słownik do znalezienia klucza
Parameter Required Typ Description
< kolekcja> Yes Ciąg, tablica lub słownik Kolekcja do sprawdzenia
< wartość> Yes Ciąg, tablica lub słownik, odpowiednio Element do znalezienia
Wartość zwracana Typ Description
prawda lub fałsz logiczny Zwraca wartość true po znalezieniu elementu. Zwraca wartość false, gdy nie zostanie znaleziona.

Przykład 1

W tym przykładzie jest sprawdzany ciąg "hello world" dla podciągów "world" i zwraca wartość true:

contains('hello world', 'world')

Przykład 2

W tym przykładzie ciąg "hello world" dla podciągu "universe" i zwraca wartość false:

contains('hello world', 'universe')

convertFromUtc

Przekonwertuj znacznik czasu z uniwersalnego czasu koordynowanego (UTC) na docelową strefę czasową.

convertFromUtc('<timestamp>', '<destinationTimeZone>', '<format>'?)
Parameter Required Typ Description
< Sygnatury czasowej> Yes String Ciąg zawierający znacznik czasu
< destinationTimeZone> Yes String Nazwa docelowej strefy czasowej. W przypadku nazw stref czasowych zapoznaj się z artykułem Domyślne strefy czasowe systemu Microsoft Windows.
< format> No String Ciąg formatu liczbowego, który jest specyfikatorem pojedynczego formatu lub wzorcem formatu niestandardowego. Domyślny format znacznika czasu to "o" (rrrr-MM-ddTHH:mm:ss.fffffffK), który jest zgodny z normą ISO 8601 i zachowuje informacje o strefie czasowej.

Jeśli format nie jest prawidłową wartością, zostanie wygenerowany błąd.
Wartość zwracana Typ Description
< przekonwertowana sygnatura czasowa> String Sygnatura czasowa przekonwertowana na docelową strefę czasową bez przesunięcia strefy czasowej UTC.

Przykład 1

W tym przykładzie znacznik czasu jest konwertowany na określoną strefę czasową:

convertFromUtc('2018-01-01T08:00:00.0000000Z', 'Pacific Standard Time')

I zwraca ten wynik: "2018-01-01T00:00:00.0000000"

Przykład 2

W tym przykładzie znacznik czasu jest konwertowany na określoną strefę czasową i format:

convertFromUtc('2018-01-01T08:00:00.0000000Z', 'Pacific Standard Time', 'D')

I zwraca ten wynik: "Monday, January 1, 2018"

convertTimeZone

Przekonwertuj znacznik czasu ze źródłowej strefy czasowej na docelową strefę czasową.

convertTimeZone('<timestamp>', '<sourceTimeZone>', '<destinationTimeZone>', '<format>'?)
Parameter Required Typ Description
< Sygnatury czasowej> Yes String Ciąg zawierający znacznik czasu
< sourceTimeZone> Yes String Nazwa źródłowej strefy czasowej. Aby uzyskać informacje o nazwach stref czasowych, zobacz Domyślne strefy czasowe systemu Microsoft Windows, ale może być konieczne usunięcie wszelkich znaków interpunkcyjnych z nazwy strefy czasowej.
< destinationTimeZone> Yes String Nazwa docelowej strefy czasowej. Aby uzyskać informacje o nazwach stref czasowych, zobacz Domyślne strefy czasowe systemu Microsoft Windows, ale może być konieczne usunięcie wszelkich znaków interpunkcyjnych z nazwy strefy czasowej.
< format> No String Ciąg formatu liczbowego, który jest specyfikatorem pojedynczego formatu lub wzorcem formatu niestandardowego. Domyślny format znacznika czasu to "o" (rrrr-MM-ddTHH:mm:ss.fffffffK), który jest zgodny z normą ISO 8601 i zachowuje informacje o strefie czasowej.

Jeśli format nie jest prawidłową wartością, zostanie wygenerowany błąd.
Wartość zwracana Typ Description
< przekonwertowana sygnatura czasowa> String Sygnatura czasowa przekonwertowana na docelową strefę czasową

Przykład 1

W tym przykładzie źródłowa strefa czasowa jest konwertowana na docelową strefę czasową:

convertTimeZone('2018-01-01T08:00:00.0000000Z', 'UTC', 'Pacific Standard Time')

I zwraca ten wynik: "2018-01-01T00:00:00.0000000"

Przykład 2

W tym przykładzie strefa czasowa jest konwertowana na określoną strefę czasową i format:

convertTimeZone('2018-01-01T80:00:00.0000000Z', 'UTC', 'Pacific Standard Time', 'D')

I zwraca ten wynik: "Monday, January 1, 2018"

convertToUtc

Przekonwertuj znacznik czasu ze źródłowej strefy czasowej na uniwersalny czas koordynowany (UTC).

convertToUtc('<timestamp>', '<sourceTimeZone>', '<format>'?)
Parameter Required Typ Description
< Sygnatury czasowej> Yes String Ciąg zawierający znacznik czasu
< sourceTimeZone> Yes String Nazwa źródłowej strefy czasowej. Aby uzyskać informacje o nazwach stref czasowych, zobacz Domyślne strefy czasowe systemu Microsoft Windows, ale może być konieczne usunięcie wszelkich znaków interpunkcyjnych z nazwy strefy czasowej.
< format> No String Ciąg formatu liczbowego, który jest specyfikatorem pojedynczego formatu lub wzorcem formatu niestandardowego. Domyślny format znacznika czasu to "o" (rrrr-MM-ddTHH:mm:ss.fffffffK), który jest zgodny z normą ISO 8601 i zachowuje informacje o strefie czasowej.

Jeśli format nie jest prawidłową wartością, zostanie wygenerowany błąd.
Wartość zwracana Typ Description
< przekonwertowana sygnatura czasowa> String Sygnatura czasowa przekonwertowana na utc

Przykład 1

W tym przykładzie sygnatura czasowa jest konwertowana na czas UTC:

convertToUtc('01/01/2018 00:00:00', 'Pacific Standard Time')

I zwraca ten wynik: "2018-01-01T08:00:00.0000000Z"

Przykład 2

W tym przykładzie sygnatura czasowa jest konwertowana na czas UTC:

convertToUtc('01/01/2018 00:00:00', 'Pacific Standard Time', 'D')

I zwraca ten wynik: "Monday, January 1, 2018"

createArray

Zwraca tablicę z wielu danych wejściowych. Aby uzyskać informacje o pojedynczych tablicach wejściowych, zobacz array().

createArray('<object1>', '<object2>', ...)
Parameter Required Typ Description
< obiekt1>, <obiekt2>, ... Yes Dowolny, ale nie mieszany Co najmniej dwa elementy do utworzenia tablicy
Wartość zwracana Typ Description
[<obiekt1>, <obiekt2>, ...] Array Tablica utworzona na podstawie wszystkich elementów wejściowych

Example

W tym przykładzie zostanie utworzona tablica na podstawie tych danych wejściowych:

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

I zwraca ten wynik: ["h", "e", "l", "l", "o"]

D

dataUri

Zwracanie identyfikatora URI (URI) danych dla ciągu.

dataUri('<value>')
Parameter Required Typ Description
< wartość> Yes String Ciąg do konwersji
Wartość zwracana Typ Description
< Data-uri> String Identyfikator URI danych dla ciągu wejściowego

Example

W tym przykładzie zostanie utworzony identyfikator URI danych dla ciągu "hello":

dataUri('hello')

I zwraca ten wynik: "data:text/plain;charset=utf-8;base64,aGVsbG8="

dataUriToBinary

Zwraca wersję binarną dla identyfikatora URI (URI). Użyj tej funkcji zamiast dekodowaćDataUri(). Chociaż obie funkcje działają w taki sam sposób, dataUriBinary() jest preferowana.

dataUriToBinary('<value>')
Parameter Required Typ Description
< wartość> Yes String Identyfikator URI danych do konwersji
Wartość zwracana Typ Description
< Binary-for-data-uri> String Wersja binarna identyfikatora URI danych

Example

W tym przykładzie zostanie utworzona wersja binarna dla tego identyfikatora URI danych:

dataUriToBinary('data:text/plain;charset=utf-8;base64,aGVsbG8=')

I zwraca ten wynik:

"01100100011000010111010001100001001110100111010001100101011110000111010000101111011100000 1101100011000010110100101101110001110110110001101101000011000010111001001110011011001010111 0100001111010111010101110100011001100010110100111000001110110110001001100001011100110110010 10011011000110100001011000110000101000111010101100111001101100010010001110011100000111101"

dataUriToString

Zwraca wersję ciągu dla identyfikatora URI (URI).

dataUriToString('<value>')
Parameter Required Typ Description
< wartość> Yes String Identyfikator URI danych do konwersji
Wartość zwracana Typ Description
< String-for-data-uri> String Wersja ciągu identyfikatora URI danych

Example

W tym przykładzie zostanie utworzony ciąg dla tego identyfikatora URI danych:

dataUriToString('data:text/plain;charset=utf-8;base64,aGVsbG8=')

I zwraca ten wynik: "hello"

dateDifference

Zwróć różnicę między dwoma znacznikami czasu jako przedziałem czasu. Ta funkcja odejmuje startDate element z endDateelementu i zwraca wynik jako znacznik czasu w formacie ciągu.

dateDifference('<startDate>', '<endDate>')
Parameter Required Typ Description
< DataStartDate> Yes String Ciąg zawierający znacznik czasu
< koniec Data> Yes String Ciąg zawierający znacznik czasu
Wartość zwracana Typ Description
< przedział czasu> String Różnica między dwoma znacznikami czasu, która jest znacznikiem czasu w formacie ciągu. Jeśli startDate wartość jest większa niż endDate, wynik jest wartością ujemną.

Example

W tym przykładzie odejmuje pierwszą wartość z drugiej wartości:

dateDifference('2015-02-08', '2018-07-30')

I zwraca ten wynik: "1268.00:00:00"

dayOfMonth

Zwróć dzień miesiąca z znacznika czasu.

dayOfMonth('<timestamp>')
Parameter Required Typ Description
< Sygnatury czasowej> Yes String Ciąg zawierający znacznik czasu
Wartość zwracana Typ Description
< dzień miesiąca> Integer Dzień miesiąca z określonego znacznika czasu

Example

W tym przykładzie jest zwracana liczba dni miesiąca z tego znacznika czasu:

dayOfMonth('2018-03-15T13:27:36Z')

I zwraca ten wynik: 15

dayOfWeek

Zwróć dzień tygodnia z znacznika czasu.

dayOfWeek('<timestamp>')
Parameter Required Typ Description
< Sygnatury czasowej> Yes String Ciąg zawierający znacznik czasu
Wartość zwracana Typ Description
< dzień tygodnia> Integer Dzień tygodnia od określonego znacznika czasu, w którym niedziela wynosi 0, poniedziałek to 1 itd.

Example

W tym przykładzie zwracana jest liczba dni tygodnia z tego znacznika czasu:

dayOfWeek('2018-03-15T13:27:36Z')

I zwraca ten wynik: 4

dayOfYear

Zwraca dzień roku ze znacznika czasu.

dayOfYear('<timestamp>')
Parameter Required Typ Description
< Sygnatury czasowej> Yes String Ciąg zawierający znacznik czasu
Wartość zwracana Typ Description
< dzień roku> Integer Dzień roku z określonego znacznika czasu

Example

Ten przykład zwraca liczbę dni roku z tego znacznika czasu:

dayOfYear('2018-03-15T13:27:36Z')

I zwraca ten wynik: 74

liczba dziesiętna

Zwraca liczbę dziesiętną w ciągu jako liczbę dziesiętną. Tej funkcji można używać podczas pracy z danymi, które wymagają dokładności dziesiętnej, a także jako danych wejściowych dla funkcji porównania logicznego i funkcji matematycznych. Aby przechwycić i zachować precyzję podczas używania wyniku z funkcji decimal(), zawijaj wszystkie dane wyjściowe dziesiętne za pomocą funkcji string. To użycie jest pokazane w poniższych przykładach, w których można utracić precyzję, jeśli użyjesz wyniku dziesiętnego jako liczby.

Note

Precyzja dziesiętna omówiona w kontekście tej funkcji i środowisko uruchomieniowe usługi Azure Logic Apps jest taka sama jak precyzja dziesiętna platformy .NET.

decimal('<value>')
Parameter Required Typ Description
< wartość> Yes String Liczba dziesiętna w ciągu
Wartość zwracana Typ Description
< dziesiętny> Liczbowy dziesiętny Liczba dziesiętna ciągu wejściowego

Przykład 1

W tym przykładzie zostanie utworzona liczba dziesiętna, która jest używana jako liczba:

decimal('1.2345678912312131') // Returns 1.234567891231213.

Przykład 2

W tym przykładzie zostanie utworzona liczba dziesiętna, a następnie przekonwertowana wynik na ciąg na potrzeby zachowania precyzji:

string(decimal('1.2345678912312131')) // Returns "1.2345678912312131".

Przykład 3

W tym przykładzie użyto funkcji matematycznej w dwóch liczbach dziesiętnych i użyto wyniku jako liczby:

add(decimal('1.2345678912312131'), decimal('1.2345678912312131')) // Returns 2.469135782462426.

Przykład 4

W tym przykładzie użyto funkcji matematycznej w dwóch liczbach dziesiętnych i przekonwertowaliśmy wynik na ciąg na potrzeby zachowania dokładności:

string(add(decimal('1.2345678912312131'), decimal('1.2345678912312131'))) // Returns "2.4691357824624262".

decodeBase64 (przestarzałe)

Ta funkcja jest przestarzała, dlatego zamiast tego użyj metody base64ToString().

decodeDataUri

Zwraca wersję binarną dla identyfikatora URI (URI). Rozważ użycie metody dataUriToBinary(), a nie decodeDataUri(). Chociaż obie funkcje działają w taki sam sposób, dataUriToBinary() jest preferowana.

Note

Usługa Azure Logic Apps automatycznie lub niejawnie wykonuje kodowanie i dekodowanie base64, więc nie trzeba ręcznie wykonywać tych konwersji przy użyciu funkcji kodowania i dekodowania. Jeśli jednak używasz tych funkcji w projektancie, w projektancie mogą wystąpić nieoczekiwane zachowania renderowania. Te zachowania mają wpływ tylko na widoczność funkcji, a nie ich efekt, chyba że edytujesz wartości parametrów funkcji, co spowoduje usunięcie funkcji i ich efektów z kodu. Aby uzyskać więcej informacji, zobacz Kodowanie i dekodowanie Base64.

decodeDataUri('<value>')
Parameter Required Typ Description
< wartość> Yes String Ciąg identyfikatora URI danych do dekodowania
Wartość zwracana Typ Description
< Binary-for-data-uri> String Wersja binarna ciągu identyfikatora URI danych

Example

Ten przykład zwraca wersję binarną dla tego identyfikatora URI danych:

decodeDataUri('data:text/plain;charset=utf-8;base64,aGVsbG8=')

I zwraca ten wynik: "hello"

decodeUriComponent

Zwróć ciąg znaków, w którym znaki ucieczki są zastępowane ich zdekodowanymi wersjami.

decodeUriComponent('<value>')
Parameter Required Typ Description
< wartość> Yes String Ciąg ze znakami ucieczki do dekodowania
Wartość zwracana Typ Description
< dekodowany identyfikator URI> String Zaktualizowany ciąg z dekodowanym znakiem ucieczki

Example

W tym przykładzie znaki ucieczki w tym ciągu zastępują dekodowane wersje:

decodeUriComponent('https%3A%2F%2Fcontoso.com')

I zwraca ten wynik: "https://contoso.com"

div

Zwróć wynik dzielenia dwóch liczb. Aby uzyskać wynik pozostały, zobacz mod().

div(<dividend>, <divisor>)
Parameter Required Typ Description
< dywidenda> Yes Liczba całkowita lub zmiennoprzecinkowa Liczba do podzielenia przez dzielnik
< dzielnik> Yes Liczba całkowita lub zmiennoprzecinkowa Liczba dzieląca dywidendę, ale nie może być równa zero
Wartość zwracana Typ Description
< Rezultat ilorazowy> Liczba całkowita lub zmiennoprzecinkowa Wynik dzielenia pierwszej liczby przez drugą liczbę. Jeśli dywidenda lub dzielnika ma typ Float, wynik ma typ Float.



Uwaga: Aby przekonwertować wynik zmiennoprzecinkowy na liczbę całkowitą, spróbuj utworzyć i wywołać funkcję na platformie Azure z poziomu aplikacji logiki.

Przykład 1

Oba przykłady zwracają tę wartość z typem liczba całkowita: 2

div(10,5)
div(11,5)

Przykład 2

Oba przykłady zwracają tę wartość z typem zmiennoprzecinkowym: 2.2

div(11,5.0)
div(11.0,5)

E

encodeUriComponent

Zwróć wersję zakodowaną w postaci identyfikatora zasobu (URI) dla ciągu, zastępując znaki ucieczki niebezpiecznymi adresami URL. Rozważ użycie identyfikatora uriComponent(), a nie encodeUriComponent(). Chociaż obie funkcje działają w taki sam sposób, uriComponent() jest preferowana.

Note

Usługa Azure Logic Apps automatycznie lub niejawnie wykonuje kodowanie i dekodowanie base64, więc nie trzeba ręcznie wykonywać tych konwersji przy użyciu funkcji kodowania i dekodowania. Jeśli jednak używasz tych funkcji w projektancie, w projektancie mogą wystąpić nieoczekiwane zachowania renderowania. Te zachowania mają wpływ tylko na widoczność funkcji, a nie ich efekt, chyba że edytujesz wartości parametrów funkcji, co spowoduje usunięcie funkcji i ich efektów z kodu. Aby uzyskać więcej informacji, zobacz Kodowanie i dekodowanie Base64.

encodeUriComponent('<value>')
Parameter Required Typ Description
< wartość> Yes String Ciąg do konwersji na format zakodowany w formacie URI
Wartość zwracana Typ Description
< identyfikator URI zakodowany> String Ciąg zakodowany w formacie URI z znakami ucieczki

Example

W tym przykładzie zostanie utworzona wersja zakodowana w identyfikatorze URI dla tego ciągu:

encodeUriComponent('https://contoso.com')

I zwraca ten wynik: "https%3A%2F%2Fcontoso.com"

empty

Sprawdź, czy kolekcja jest pusta. Zwraca wartość true, gdy kolekcja jest pusta lub zwraca wartość false, gdy nie jest pusta.

empty('<collection>')
empty([<collection>])
Parameter Required Typ Description
< kolekcja> Yes Ciąg, tablica lub obiekt Kolekcja do sprawdzenia
Wartość zwracana Typ Description
prawda lub fałsz logiczny Zwraca wartość true, gdy kolekcja jest pusta. Zwraca wartość false, jeśli nie jest pusta.

Example

Te przykłady sprawdzają, czy określone kolekcje są puste:

empty('')
empty('abc')

I zwraca następujące wyniki:

  • Pierwszy przykład: Przekazuje pusty ciąg, więc funkcja zwraca truewartość .
  • Drugi przykład: Przekazuje ciąg "abc", więc funkcja zwraca falsewartość .

endsWith

Sprawdź, czy ciąg kończy się określonym podciągem. Zwraca wartość true, gdy podciąg zostanie znaleziony lub zwróci wartość false, gdy nie zostanie znaleziona. Ta funkcja nie uwzględnia wielkości liter.

endsWith('<text>', '<searchText>')
Parameter Required Typ Description
< Tekst> Yes String Ciąg do sprawdzenia
< tekst wyszukiwania> Yes String Kończenie podciągów do znalezienia
Wartość zwracana Typ Description
prawda lub fałsz logiczny Zwraca wartość true po znalezieniu końcowego podciągu. Zwraca wartość false, gdy nie zostanie znaleziona.

Przykład 1

W tym przykładzie sprawdza się, czy ciąg "hello world" kończy się ciągiem "world":

endsWith('hello world', 'world')

I zwraca ten wynik: true

Przykład 2

W tym przykładzie sprawdza się, czy ciąg "hello world" kończy się ciągiem "universe":

endsWith('hello world', 'universe')

I zwraca ten wynik: false

equals

Sprawdź, czy obie wartości, wyrażenia lub obiekty są równoważne. Zwraca wartość true, gdy obie są równoważne lub zwracają wartość false, gdy nie są równoważne.

equals('<object1>', '<object2>')
Parameter Required Typ Description
< obiekt1>, <obiekt2> Yes Various Wartości, wyrażenia lub obiekty do porównania
Wartość zwracana Typ Description
prawda lub fałsz logiczny Zwraca wartość true, gdy obie są równoważne. Zwraca wartość false, jeśli nie jest równoważna.

Example

Te przykłady sprawdzają, czy określone dane wejściowe są równoważne.

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

I zwraca następujące wyniki:

  • Pierwszy przykład: Obie wartości są równoważne, więc funkcja zwraca truewartość .
  • Drugi przykład: Obie wartości nie są równoważne, więc funkcja zwraca falsewartość .

F

first

Zwraca pierwszy element z ciągu lub tablicy.

first('<collection>')
first([<collection>])
Parameter Required Typ Description
< kolekcja> Yes Ciąg lub tablica Kolekcja, w której należy znaleźć pierwszy element
Wartość zwracana Typ Description
< Pierwszy przedmiot kolekcji> Any Pierwszy element w kolekcji

Example

Te przykłady znajdują pierwszy element w tych kolekcjach:

first('hello')
first(createArray(0, 1, 2))

I zwróć następujące wyniki:

  • Pierwszy przykład: "h"
  • Drugi przykład: 0

float

Przekonwertuj wersję ciągu dla liczby zmiennoprzecinkowych na rzeczywistą liczbę zmiennoprzecinkową. Tej funkcji można używać tylko podczas przekazywania parametrów niestandardowych do aplikacji, na przykład przepływu pracy aplikacji logiki lub przepływu usługi Power Automate. Aby przekonwertować ciągi zmiennoprzecinkowe reprezentowane w formatach specyficznych dla ustawień regionalnych, opcjonalnie można określić kod ustawień regionalnych RFC 4646.

float('<value>', '<locale>'?)
Parameter Required Typ Description
< wartość> Yes String Ciąg, który ma prawidłową liczbę zmiennoprzecinkową do przekonwertowania. Wartości minimalne i maksymalne są takie same jak limity dla typu danych zmiennoprzecinkowych.
< Ustawień regionalnych> No String Kod ustawień regionalnych RFC 4646 do użycia.

Jeśli nie zostanie określony, zostaną użyte domyślne ustawienia regionalne.

Jeśli ustawienia regionalne nie są prawidłową wartością, zostanie wygenerowany błąd, że podane ustawienia regionalne są nieprawidłowe lub nie mają skojarzonych ustawień regionalnych.
Wartość zwracana Typ Description
< wartość zmiennoprzecinkowa> Float Liczba zmiennoprzecinkowa dla określonego ciągu. Wartości minimalne i maksymalne są takie same jak limity dla typu danych zmiennoprzecinkowych.

Przykład 1

W tym przykładzie zostanie utworzona wersja ciągu dla tego numeru zmiennoprzecinkowego:

float('10,000.333')

I zwraca ten wynik: 10000.333

Przykład 2

W tym przykładzie jest tworzona wersja ciągu dla tego numeru zmiennoprzecinkowego w stylu niemieckim:

float('10.000,333', 'de-DE')

I zwraca ten wynik: 10000.333

Przykład 3

Przykłady nieoczekiwanie prawidłowych danych wejściowych:

float('12,3,4,5678')  //Returns   12345678
float('1234567,8+')   //Returns   12345678
float('12345,6,78,-') //Returns  -12345678
float('-12,345,678,') //Returns  -12345678
float('12345678.-')   //Returns  -12345678
float('.12345678')    //Returns 0.12345678

formatDateTime

Zwraca znacznik czasu w określonym formacie.

formatDateTime('<timestamp>', '<format>'?, '<locale>'?)
Parameter Required Typ Description
< Sygnatury czasowej> Yes String Ciąg zawierający znacznik czasu
< format> No String Ciąg formatu liczbowego, który jest specyfikatorem pojedynczego formatu lub wzorcem formatu niestandardowego. Domyślny format znacznika czasu to "o" (rrrr-MM-ddTHH:mm:ss.fffffffK), który jest zgodny z normą ISO 8601 i zachowuje informacje o strefie czasowej.
< Ustawień regionalnych> No String Ustawienia regionalne do użycia. Jeśli wartość jest nieokreślona, jest to en-us. Jeśli ustawienia regionalne nie są prawidłową wartością, zostanie wygenerowany błąd.
Wartość zwracana Typ Description
< ponownie sformatowany znacznik czasu> String Zaktualizowany znacznik czasu w określonym formacie i ustawieniach regionalnych, jeśli określono.

Examples

formatDateTime('03/15/2018') // Returns '2018-03-15T00:00:00.0000000'.
formatDateTime('03/15/2018 12:00:00', 'yyyy-MM-ddTHH:mm:ss') // Returns '2018-03-15T12:00:00'.
formatDateTime('01/31/2016', 'dddd MMMM d') // Returns 'Sunday January 31'.
formatDateTime('01/31/2016', 'dddd MMMM d', 'fr-fr') // Returns 'dimanche janvier 31'.
formatDateTime('01/31/2016', 'dddd MMMM d', 'fr-FR') // Returns 'dimanche janvier 31'.
formatDateTime('01/31/2016', 'dddd MMMM d', 'es-es') // Returns 'domingo enero 31'.

formDataMultiValues

Zwraca tablicę z wartościami, które pasują do nazwy klucza w danych formularza lub danych wyjściowych zakodowanych w formie akcji.

formDataMultiValues('<actionName>', '<key>')
Parameter Required Typ Description
< actionName> Yes String Akcja, której dane wyjściowe mają wartość klucza, której chcesz użyć
< klucz> Yes String Nazwa klucza, którego wartość ma zostać utworzona
Wartość zwracana Typ Description
[<tablica z wartościami> klucza] Array Tablica ze wszystkimi wartościami zgodnymi z określonym kluczem

Example

W tym przykładzie utworzono tablicę na podstawie wartości klucza "Podmiot" w danych formularza lub danych wyjściowych zakodowanych w formularzu określonej akcji:

formDataMultiValues('Send_an_email', 'Subject')

Zwraca tekst tematu w tablicy, na przykład: ["Hello world"]

formDataValue

Zwraca pojedynczą wartość zgodną z nazwą klucza w danych formularza lub danych wyjściowych zakodowanych w formie akcji. Jeśli funkcja znajdzie więcej niż jedno dopasowanie, funkcja zgłasza błąd.

formDataValue('<actionName>', '<key>')
Parameter Required Typ Description
< actionName> Yes String Akcja, której dane wyjściowe mają wartość klucza, której chcesz użyć
< klucz> Yes String Nazwa klucza, którego wartość ma zostać utworzona
Wartość zwracana Typ Description
< klucz-wartość> String Wartość w określonym kluczu

Example

W tym przykładzie tworzony jest ciąg z wartości klucza "Podmiot" w danych formularza lub danych wyjściowych zakodowanych w formularzu określonej akcji:

formDataValue('Send_an_email', 'Subject')

Zwraca tekst tematu jako ciąg, na przykład: "Hello world"

formatNumber

Zwraca liczbę jako ciąg, który jest oparty na określonym formacie.

formatNumber(<number>, <format>, <locale>?)
Parameter Required Typ Description
< numer> Yes Liczba całkowita lub podwójna Wartość, którą chcesz sformatować.
< format> Yes String Ciąg formatu złożonego, który określa format, którego chcesz użyć. Aby zapoznać się z obsługiwanymi ciągami formatu liczbowego, zobacz Standardowe ciągi formatu liczbowego obsługiwane przez number.ToString(<format>, <locale>)program .
< Ustawień regionalnych> No String Ustawienia regionalne do użycia jako obsługiwane przez number.ToString(<format>, <locale>)program . Jeśli wartość jest nieokreślona, jest to en-us. Jeśli ustawienia regionalne nie są prawidłową wartością, zostanie wygenerowany błąd.
Wartość zwracana Typ Description
< sformatowany-numer> String Określona liczba jako ciąg w określonym formacie. Możesz rzutować tę zwracaną wartość na wartość int lub float.

Przykład 1

Załóżmy, że chcesz sformatować liczbę 1234567890. Ten przykład formatuje tę liczbę jako ciąg "1,234,567,890.00".

formatNumber(1234567890, '#,##0.00', 'en-US')

*Przykład 2"

Załóżmy, że chcesz sformatować liczbę 1234567890. Ten przykład formatuje liczbę do ciągu "1.234.567.890,00".

formatNumber(1234567890, '#,##0.00', 'is-IS')

Przykład 3

Załóżmy, że chcesz sformatować liczbę 17.35. Ten przykład formatuje liczbę do ciągu "$17.35".

formatNumber(17.35, 'C2')

Przykład 4

Załóżmy, że chcesz sformatować liczbę 17.35. Ten przykład formatuje liczbę do ciągu "17,35 kr".

formatNumber(17.35, 'C2', 'is-IS')

G

getFutureTime

Zwróć bieżący znacznik czasu powiększony o określoną liczbę jednostek czasu.

getFutureTime(<interval>, <timeUnit>, <format>?)
Parameter Required Typ Description
< interwał> Yes Integer Liczba jednostek czasu do dodania
< timeUnit> Yes String Jednostka czasu do użycia z interwałem: "Second", "Minute", "Hour", "Day", "Week", "Month", "Year"
< format> No String Specyfikator pojedynczego formatu lub wzorzec formatu niestandardowego. Domyślny format znacznika czasu to "o" (rrrr-MM-ddTHH:mm:ss.fffffffK), który jest zgodny z normą ISO 8601 i zachowuje informacje o strefie czasowej.

Jeśli format nie jest prawidłową wartością, zostanie wygenerowany błąd, że podany format jest nieprawidłowy i musi być ciągiem formatu liczbowego.
Wartość zwracana Typ Description
< sygnatura czasowa aktualizacji> String Bieżący znacznik czasu plus określona liczba jednostek czasu

Przykład 1

Załóżmy, że bieżący znacznik czasu to "2018-03-01T00:00:00.0000000Z". W tym przykładzie dodano pięć dni do tego znacznika czasu:

getFutureTime(5, 'Day')

I zwraca ten wynik: "2018-03-06T00:00:00.0000000Z"

Przykład 2

Załóżmy, że bieżący znacznik czasu to "2018-03-01T00:00:00.0000000Z". W tym przykładzie dodano pięć dni i przekonwertowaliśmy wynik na format "D":

getFutureTime(5, 'Day', 'D')

I zwraca ten wynik: "Tuesday, March 6, 2018"

getPastTime

Zwróć aktualny znacznik czasu pomniejszony o określone jednostki czasu.

getPastTime(<interval>, <timeUnit>, <format>?)
Parameter Required Typ Description
< interwał> Yes Integer Liczba określonych jednostek czasu do odejmowania
< timeUnit> Yes String Jednostka czasu do użycia z interwałem: "Second", "Minute", "Hour", "Day", "Week", "Month", "Year"
< format> No String Specyfikator pojedynczego formatu lub wzorzec formatu niestandardowego. Domyślny format znacznika czasu to "o" (rrrr-MM-ddTHH:mm:ss.fffffffK), który jest zgodny z normą ISO 8601 i zachowuje informacje o strefie czasowej.

Jeśli format nie jest prawidłową wartością, zostanie wygenerowany błąd, że podany format jest nieprawidłowy i musi być ciągiem formatu liczbowego.
Wartość zwracana Typ Description
< sygnatura czasowa aktualizacji> String Bieżący znacznik czasu minus określona liczba jednostek czasu

Przykład 1

Załóżmy, że bieżący znacznik czasu to "2018-02-01T00:00:00.0000000Z". W tym przykładzie odejmuje pięć dni od tego znacznika czasu:

getPastTime(5, 'Day')

I zwraca ten wynik: "2018-01-27T00:00:00.0000000Z"

Przykład 2

Załóżmy, że bieżący znacznik czasu to "2018-02-01T00:00:00.0000000Z". W tym przykładzie odejmuje pięć dni i konwertuje wynik na format "D":

getPastTime(5, 'Day', 'D')

I zwraca ten wynik: "Saturday, January 27, 2018"

greater

Sprawdź, czy pierwsza wartość jest większa niż druga wartość. Zwraca wartość true, gdy pierwsza wartość jest większa lub zwraca wartość false, gdy jest mniejsza.

greater(<value>, <compareTo>)
greater('<value>', '<compareTo>')
Parameter Required Typ Description
< wartość> Yes Liczba całkowita, zmiennoprzecinkowa lub ciąg Pierwsza wartość do sprawdzenia, czy większa niż druga wartość
< compareTo> Yes Liczba całkowita, zmiennoprzecinkowa lub ciąg, odpowiednio Wartość porównania
Wartość zwracana Typ Description
prawda lub fałsz logiczny Zwraca wartość true, gdy pierwsza wartość jest większa niż druga wartość. Zwraca wartość false, gdy pierwsza wartość jest równa lub mniejsza niż druga wartość.

Example

Te przykłady sprawdzają, czy pierwsza wartość jest większa niż druga wartość:

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

I zwróć następujące wyniki:

  • Pierwszy przykład: true
  • Drugi przykład: false

greaterOrEquals

Sprawdź, czy pierwsza wartość jest większa lub równa drugiej wartości. Zwraca wartość true, gdy pierwsza wartość jest większa lub równa, lub zwraca wartość false, gdy pierwsza wartość jest mniejsza.

greaterOrEquals(<value>, <compareTo>)
greaterOrEquals('<value>', '<compareTo>')
Parameter Required Typ Description
< wartość> Yes Liczba całkowita, zmiennoprzecinkowa lub ciąg Pierwsza wartość do sprawdzenia, czy wartość większa niż lub równa drugiej wartości
< compareTo> Yes Liczba całkowita, zmiennoprzecinkowa lub ciąg, odpowiednio Wartość porównania
Wartość zwracana Typ Description
prawda lub fałsz logiczny Zwraca wartość true, gdy pierwsza wartość jest większa lub równa drugiej wartości. Zwraca wartość false, gdy pierwsza wartość jest mniejsza niż druga wartość.

Example

Te przykłady sprawdzają, czy pierwsza wartość jest większa, czy równa drugiej wartości:

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

I zwróć następujące wyniki:

  • Pierwszy przykład: true
  • Drugi przykład: false

guid

Wygeneruj unikatowy identyfikator globalny (GUID) jako ciąg, na przykład "c2ecc88d-88c8-4096-912c-d6f2e2b138ce":

guid()

Ponadto można określić inny format identyfikatora GUID innego niż domyślny format "D", który jest 32 cyframi oddzielonymi łącznikami.

guid('<format>')
Parameter Required Typ Description
< format> No String Specyfikator pojedynczego formatu dla zwróconego identyfikatora GUID. Domyślnie format to "D", ale można użyć "N", "D", "B", "P" lub "X".
Wartość zwracana Typ Description
< Wartość identyfikatora GUID> String Losowo wygenerowany identyfikator GUID

Example

Ten przykład generuje ten sam identyfikator GUID, ale jako 32 cyfry oddzielone łącznikami i ujęte w nawiasy:

guid('P')

I zwraca ten wynik: "(c2ecc88d-88c8-4096-912c-d6f2e2b138ce)"

I

if

Sprawdź, czy wyrażenie jest prawdziwe czy fałszywe. Na podstawie wyniku należy zwrócić określoną wartość. Parametry są oceniane od lewej do prawej.

if(<expression>, <valueIfTrue>, <valueIfFalse>)
Parameter Required Typ Description
< wyrażenie> Yes logiczny Wyrażenie do sprawdzenia
< valueIfTrue> Yes Any Wartość, która ma być zwracana, gdy wyrażenie ma wartość true
< valueIfFalse> Yes Any Wartość, która ma być zwracana, gdy wyrażenie ma wartość false
Wartość zwracana Typ Description
< określona wartość zwracana> Any Określona wartość zwracana na podstawie tego, czy wyrażenie ma wartość true, czy false

Example

Ten przykład zwraca wartość "yes" , ponieważ określone wyrażenie zwraca wartość true. W przeciwnym razie przykład zwraca wartość "no":

if(equals(1, 1), 'yes', 'no')

indexOf

Zwraca wartość pozycji początkowej lub indeksu dla podciągów. Ta funkcja nie uwzględnia wielkości liter, a indeksy zaczynają się od liczby 0.

indexOf('<text>', '<searchText>')
Parameter Required Typ Description
< Tekst> Yes String Ciąg zawierający podciąg do znalezienia
< tekst wyszukiwania> Yes String Podciąg do znalezienia
Wartość zwracana Typ Description
< Wartość indeksowa> Integer Pozycja początkowa lub wartość indeksu dla określonego podciągu.

Jeśli ciąg nie zostanie znaleziony, zwróć liczbę -1.

Example

W tym przykładzie znajduje wartość indeksu początkowego dla podciągów "world" w ciągu "hello world":

indexOf('hello world', 'world')

I zwraca ten wynik: 6

int

Przekonwertuj wersję ciągu dla liczby całkowitej na rzeczywistą liczbę całkowitą.

int('<value>')
Parameter Required Typ Description
< wartość> Yes String Wersja ciągu dla liczby całkowitej do przekonwertowania. Wartości minimalne i maksymalne są takie same jak limity dla typu danych liczb całkowitych.
Wartość zwracana Typ Description
< wynik liczby całkowitej> Integer Wersja całkowita dla określonego ciągu. Wartości minimalne i maksymalne są takie same jak limity dla typu danych liczb całkowitych.

Example

W tym przykładzie zostanie utworzona wersja całkowita dla ciągu "10":

int('10')

I zwraca ten wynik: 10

isFloat

Zwraca wartość logiczną wskazującą, czy ciąg jest liczbą zmiennoprzecinkową. Domyślnie ta funkcja używa niezmiennej kultury dla formatu zmiennoprzecinkowego. Aby zidentyfikować liczby zmiennoprzecinkowe reprezentowane w innych formatach specyficznych dla ustawień regionalnych, opcjonalnie można określić kod ustawień regionalnych RFC 4646.

isFloat('<string>', '<locale>'?)
Parameter Required Typ Description
< wartość> Yes String Ciąg do zbadania
< Ustawień regionalnych> No String Kod ustawień regionalnych RFC 4646 do użycia
Wartość zwracana Typ Description
< Wynik logiczny> logiczny Wartość logiczna wskazująca, czy ciąg jest liczbą zmiennoprzecinkową

Przykład 1

W tym przykładzie sprawdza się, czy ciąg jest liczbą zmiennoprzecinkową w niezmiennej kulturze:

isFloat('10,000.00')

I zwraca ten wynik: true

Przykład 2

W tym przykładzie sprawdza się, czy ciąg jest liczbą zmiennoprzecinkową w niemieckich ustawieniach regionalnych:

isFloat('10.000,00', 'de-DE')

I zwraca ten wynik: true

isInt

Zwraca wartość logiczną wskazującą, czy ciąg jest liczbą całkowitą.

isInt('<string>')
Parameter Required Typ Description
< struna> Yes String Ciąg do zbadania
Wartość zwracana Typ Description
< Wynik logiczny> logiczny Wartość logiczna wskazująca, czy ciąg jest liczbą całkowitą

Example

W tym przykładzie sprawdza się, czy ciąg jest liczbą całkowitą:

isInt('10')

I zwraca ten wynik: true

element

W przypadku użycia wewnątrz akcji powtarzającej się w tablicy, zwróć bieżący element w tablicy podczas bieżącej iteracji akcji. Możesz również pobrać wartości z właściwości tego elementu.

item()
Wartość zwracana Typ Description
< current-array-item> Any Bieżący element w tablicy dla bieżącej iteracji akcji

Example

W tym przykładzie element jest pobierany body z bieżącego komunikatu dla akcji "Send_an_email" wewnątrz bieżącej iteracji dla każdej pętli:

item().body

items

Zwróć bieżący element z każdego cyklu w pętli for-each. Użyj tej funkcji wewnątrz pętli for-each.

items('<loopName>')
Parameter Required Typ Description
< loopName> Yes String Nazwa pętli for-each
Wartość zwracana Typ Description
< przedmiot> Any Element z bieżącego cyklu w określonej pętli for-each

Example

W tym przykładzie jest pobierany bieżący element z określonej pętli for-each:

items('myForEachLoopName')

iterationIndexes

Zwróć wartość indeksu dla bieżącej iteracji wewnątrz pętli Until. Tej funkcji można używać wewnątrz zagnieżdżonych pętli Until.

iterationIndexes('<loopName>')
Parameter Required Typ Description
< loopName> Yes String Nazwa pętli Until
Wartość zwracana Typ Description
< indeks> Integer Wartość indeksu dla bieżącej iteracji wewnątrz określonej pętli Until

Example

W tym przykładzie jest tworzona zmienna licznika i zwiększa ją o jedną podczas każdej iteracji w pętli Until, aż wartość licznika osiągnie pięć. W tym przykładzie jest również tworzona zmienna, która śledzi bieżący indeks dla każdej iteracji. Podczas każdej iteracji w pętli Until przykład zwiększa wartość licznika, a następnie przypisuje wartość licznika do bieżącej wartości indeksu, a następnie zwiększa wartość licznika. W pętli ten przykład odwołuje się do bieżącego indeksu iterationIndexes iteracji przy użyciu funkcji :

iterationIndexes('Until_Max_Increment')

{
   "actions": {
      "Create_counter_variable": {
         "type": "InitializeVariable",
         "inputs": {
            "variables": [ 
               {
                  "name": "myCounter",
                  "type": "Integer",
                  "value": 0
               }
            ]
         },
         "runAfter": {}
      },
      "Create_current_index_variable": {
         "type": "InitializeVariable",
         "inputs": {
            "variables": [
               {
                  "name": "myCurrentLoopIndex",
                  "type": "Integer",
                  "value": 0
               }
            ]
         },
         "runAfter": {
            "Create_counter_variable": [ "Succeeded" ]
         }
      },
      "Until_Max_Increment": {
         "type": "Until",
         "actions": {
            "Assign_current_index_to_counter": {
               "type": "SetVariable",
               "inputs": {
                  "name": "myCurrentLoopIndex",
                  "value": "@variables('myCounter')"
               },
               "runAfter": {
                  "Increment_variable": [ "Succeeded" ]
               }
            },
            "Compose": {
               "inputs": "'Current index: ' @{iterationIndexes('Until_Max_Increment')}",
               "runAfter": {
                  "Assign_current_index_to_counter": [
                     "Succeeded"
                    ]
                },
                "type": "Compose"
            },           
            "Increment_variable": {
               "type": "IncrementVariable",
               "inputs": {
                  "name": "myCounter",
                  "value": 1
               },
               "runAfter": {}
            }
         },
         "expression": "@equals(variables('myCounter'), 5)",
         "limit": {
            "count": 60,
            "timeout": "PT1H"
         },
         "runAfter": {
            "Create_current_index_variable": [ "Succeeded" ]
         }
      }
   }
}

J

json

Zwróć wartość typu JavaScript Object Notation (JSON), obiekt lub tablicę obiektów dla ciągu lub XML.

json('<value>')
json(xml('value'))

Important

Bez schematu XML, który definiuje strukturę danych wyjściowych, funkcja może zwracać wyniki, w których struktura znacznie różni się od oczekiwanego formatu, w zależności od danych wejściowych.

To zachowanie sprawia, że ta funkcja jest nieodpowiednia dla scenariuszy, w których dane wyjściowe muszą być zgodne z dobrze zdefiniowanym kontraktem, na przykład w krytycznych systemach biznesowych lub rozwiązaniach.

Parameter Required Typ Description
< wartość> Yes Ciąg lub xml Ciąg lub kod XML do konwersji
Wartość zwracana Typ Description
< Wynik JSON> Natywny typ, obiekt lub tablica JSON Natywna wartość typu JSON, obiekt lub tablica obiektów z ciągu wejściowego lub XML.



— W przypadku przekazania kodu XML, który ma jeden element podrzędny w elemecie głównym, funkcja zwraca pojedynczy obiekt JSON dla tego elementu podrzędnego.

— W przypadku przekazania kodu XML zawierającego wiele elementów podrzędnych w elemecie głównym funkcja zwraca tablicę zawierającą obiekty JSON dla tych elementów podrzędnych.

— Jeśli ciąg ma wartość null, funkcja zwraca pusty obiekt.

Przykład 1

W tym przykładzie ten ciąg jest konwertowany na wartość JSON:

json('[1, 2, 3]')

I zwraca ten wynik: [1, 2, 3]

Przykład 2

W tym przykładzie ten ciąg jest konwertowany na kod JSON:

json('{"fullName": "Sophia Owen"}')

I zwraca ten wynik:

{
  "fullName": "Sophia Owen"
}

Przykład 3

W tym przykładzie użyto json() funkcji i xml() do przekonwertowania kodu XML, który ma jeden element podrzędny w elemecie głównym na obiekt JSON o nazwie person dla tego elementu podrzędnego:

json(xml('<?xml version="1.0"?> <root> <person id="1"> <name>Sophia Owen</name> <occupation>Engineer</occupation> </person> </root>'))

I zwraca ten wynik:

{
   "?xml": { 
      "@version": "1.0" 
   },
   "root": {
      "person": {
         "@id": "1",
         "name": "Sophia Owen",
         "occupation": "Engineer"
      }
   }
}

Przykład 4

W tym przykładzie użyto json() funkcji i xml() do przekonwertowania kodu XML zawierającego wiele elementów podrzędnych w elemecie głównym na tablicę o nazwie person zawierającej obiekty JSON dla tych elementów podrzędnych:

json(xml('<?xml version="1.0"?> <root> <person id="1"> <name>Sophia Owen</name> <occupation>Engineer</occupation> </person> <person id="2"> <name>John Doe</name> <occupation>Engineer</occupation> </person> </root>'))

I zwraca ten wynik:

{
   "?xml": {
      "@version": "1.0"
   },
   "root": {
      "person": [
         {
            "@id": "1",
            "name": "Sophia Owen",
            "occupation": "Engineer"
         },
         {
            "@id": "2",
            "name": "John Doe",
            "occupation": "Engineer"
         }
      ]
   }
}

intersection

Zwróć kolekcję zawierającą tylko wspólne elementy w określonych kolekcjach. Aby wyświetlić wynik, element musi pojawić się we wszystkich kolekcjach przekazanych do tej funkcji. Jeśli co najmniej jeden element ma taką samą nazwę, w wyniku pojawi się ostatni element o tej nazwie.

intersection([<collection1>], [<collection2>], ...)
intersection('<collection1>', '<collection2>', ...)
Parameter Required Typ Description
< kolekcja1>, <kolekcja2>, ... Yes Tablica lub obiekt, ale nie obie Kolekcje, z których mają być używane tylko typowe elementy
Wartość zwracana Typ Description
< wspólne elementy> Tablica lub obiekt, odpowiednio Kolekcja zawierająca tylko wspólne elementy w określonych kolekcjach

Example

W tym przykładzie znaleziono typowe elementy w tych tablicach:

intersection(createArray(1, 2, 3), createArray(101, 2, 1, 10), createArray(6, 8, 1, 2))

Zwraca tablicę z tylko tymi elementami: [1, 2]

dołączyć

Zwróć ciąg, który zawiera wszystkie elementy z tablicy i ma każdy znak oddzielony ogranicznikiem.

join([<collection>], '<delimiter>')
Parameter Required Typ Description
< kolekcja> Yes Array Tablica zawierająca elementy do sprzężenia
< Ogranicznik> Yes String Separator, który pojawia się między poszczególnymi znakami w wynikowym ciągu
Wartość zwracana Typ Description
< znak1><Ogranicznik><znak2><Ogranicznik>... String Wynikowy ciąg utworzony na podstawie wszystkich elementów w określonej tablicy.



Uwaga: Długość wyniku nie może przekraczać 104 857 600 znaków.

Example

W tym przykładzie zostanie utworzony ciąg ze wszystkich elementów tej tablicy z określonym znakiem jako ogranicznikiem:

join(createArray('a', 'b', 'c'), '.')

I zwraca ten wynik: "a.b.c"

L

last

Zwróć ostatni element z kolekcji.

last('<collection>')
last([<collection>])
Parameter Required Typ Description
< kolekcja> Yes Ciąg lub tablica Kolekcja, w której należy znaleźć ostatni element
Wartość zwracana Typ Description
< ostatni element kolekcji> Ciąg lub tablica, odpowiednio Ostatni element w kolekcji

Example

Te przykłady znajdują ostatni element w tych kolekcjach:

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

I zwraca następujące wyniki:

  • Pierwszy przykład: "d"
  • Drugi przykład: 3

lastIndexOf

Zwraca wartość pozycji początkowej lub indeksu dla ostatniego wystąpienia podciągów. Ta funkcja nie uwzględnia wielkości liter, a indeksy zaczynają się od liczby 0.

lastIndexOf('<text>', '<searchText>')
Parameter Required Typ Description
< Tekst> Yes String Ciąg zawierający podciąg do znalezienia
< tekst wyszukiwania> Yes String Podciąg do znalezienia
Wartość zwracana Typ Description
< end-index-value> Integer Wartość pozycji początkowej lub indeksu dla ostatniego wystąpienia określonego podciągu.

Jeśli wartość ciągu lub podciąg jest pusta, występuje następujące zachowanie:

  • Jeśli tylko wartość ciągu jest pusta, funkcja zwraca -1wartość .

  • Jeśli ciąg i wartości podciągów są puste, funkcja zwraca 0wartość .

  • Jeśli tylko wartość podciągów jest pusta, funkcja zwraca długość ciągu minus 1.

Examples

W tym przykładzie znajduje wartość indeksu początkowego ostatniego wystąpienia podciągów podciągów world w ciągu hello world hello world. Zwrócony wynik to 18:

lastIndexOf('hello world hello world', 'world')

W tym przykładzie brakuje parametru podciągnięcia i zwraca wartość , 22 ponieważ wartość ciągu wejściowego (23) minus 1 jest większa niż 0.

lastIndexOf('hello world hello world', '')

length

Zwróć liczbę elementów w kolekcji.

length('<collection>')
length([<collection>])
Parameter Required Typ Description
< kolekcja> Yes Ciąg lub tablica Kolekcja z elementami do zliczenia
Wartość zwracana Typ Description
< długość lub liczba> Integer Liczba elementów w kolekcji

Example

Te przykłady zliczają liczbę elementów w tych kolekcjach:

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

I zwróć ten wynik: 4

less

Sprawdź, czy pierwsza wartość jest mniejsza od drugiej wartości. Zwraca wartość true, gdy pierwsza wartość jest mniejsza lub zwraca wartość false, gdy pierwsza wartość jest większa.

less(<value>, <compareTo>)
less('<value>', '<compareTo>')
Parameter Required Typ Description
< wartość> Yes Liczba całkowita, zmiennoprzecinkowa lub ciąg Pierwsza wartość do sprawdzenia, czy wartość mniejsza niż druga
< compareTo> Yes Liczba całkowita, zmiennoprzecinkowa lub ciąg, odpowiednio Element porównania
Wartość zwracana Typ Description
prawda lub fałsz logiczny Zwraca wartość true, gdy pierwsza wartość jest mniejsza niż druga wartość. Zwraca wartość false, gdy pierwsza wartość jest równa lub większa niż druga wartość.

Example

Te przykłady sprawdzają, czy pierwsza wartość jest mniejsza niż druga wartość.

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

I zwróć następujące wyniki:

  • Pierwszy przykład: true
  • Drugi przykład: false

lessOrEquals

Sprawdź, czy pierwsza wartość jest mniejsza, czy równa drugiej wartości. Zwraca wartość true, gdy pierwsza wartość jest mniejsza lub równa, lub zwraca wartość false, gdy pierwsza wartość jest większa.

lessOrEquals(<value>, <compareTo>)
lessOrEquals('<value>', '<compareTo>')
Parameter Required Typ Description
< wartość> Yes Liczba całkowita, zmiennoprzecinkowa lub ciąg Pierwsza wartość do sprawdzenia, czy wartość mniejsza niż lub równa drugiej wartości
< compareTo> Yes Liczba całkowita, zmiennoprzecinkowa lub ciąg, odpowiednio Element porównania
Wartość zwracana Typ Description
prawda lub fałsz logiczny Zwraca wartość true, gdy pierwsza wartość jest mniejsza lub równa drugiej wartości. Zwraca wartość false, gdy pierwsza wartość jest większa niż druga wartość.

Example

Te przykłady sprawdzają, czy pierwsza wartość jest mniejsza lub równa drugiej wartości.

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

I zwróć następujące wyniki:

  • Pierwszy przykład: true
  • Drugi przykład: false

listCallbackUrl

Zwróć "adres URL wywołania zwrotnego", który wywołuje wyzwalacz lub akcję. Ta funkcja działa tylko z wyzwalaczami i akcjami dla typów łączników HttpWebhook i ApiConnectionWebhook , ale nie z typami Manual, Recurrence, HTTP i APIConnection .

listCallbackUrl()
Wartość zwracana Typ Description
< callback-URL> String Adres URL wywołania zwrotnego dla wyzwalacza lub akcji

Example

W tym przykładzie przedstawiono przykładowy adres URL wywołania zwrotnego, który może zwrócić ta funkcja:

"https://prod-01.westus.logic.azure.com:443/workflows/<*workflow-ID*>/triggers/manual/run?api-version=2016-10-01&sp=%2Ftriggers%2Fmanual%2Frun&sv=1.0&sig=<*signature-ID*>"

M

max

Zwróć najwyższą wartość z listy lub tablicy z liczbami, które są uwzględniane na obu końcach.

max(<number1>, <number2>, ...)
max([<number1>, <number2>, ...])
Parameter Required Typ Description
< liczba1>, <liczba2>, ... Yes Liczba całkowita, zmiennoprzecinkowa lub obie Zestaw liczb, z których chcesz uzyskać najwyższą wartość
[<numer1>, numer2><, ...] Yes Tablica — liczba całkowita, zmiennoprzecinkowa lub obie Tablica liczb, z której ma być najwyższa wartość
Wartość zwracana Typ Description
< wartość maksymalna> Liczba całkowita lub zmiennoprzecinkowa Najwyższa wartość w określonej tablicy lub zestawie liczb

Example

Te przykłady pobierają najwyższą wartość z zestawu liczb i tablicy:

max(1, 2, 3)
max(createArray(1, 2, 3))

I zwróć ten wynik: 3

min

Zwraca najniższą wartość z zestawu liczb lub tablicy.

min(<number1>, <number2>, ...)
min([<number1>, <number2>, ...])
Parameter Required Typ Description
< liczba1>, <liczba2>, ... Yes Liczba całkowita, zmiennoprzecinkowa lub obie Zestaw liczb, z których ma być najniższa wartość
[<numer1>, numer2><, ...] Yes Tablica — liczba całkowita, zmiennoprzecinkowa lub obie Tablica liczb, z której ma być najniższa wartość
Wartość zwracana Typ Description
< minimalna wartość> Liczba całkowita lub zmiennoprzecinkowa Najniższa wartość w określonym zestawie liczb lub określonej tablicy

Example

Te przykłady pobierają najniższą wartość w zestawie liczb i tablicy:

min(1, 2, 3)
min(createArray(1, 2, 3))

I zwróć ten wynik: 1

mod

Zwróć resztę z dzielenia dwóch liczb. Aby uzyskać wynik liczby całkowitej, zobacz div().

mod(<dividend>, <divisor>)
Parameter Required Typ Description
< dywidenda> Yes Liczba całkowita lub zmiennoprzecinkowa Liczba do podzielenia przez dzielnik
< dzielnik> Yes Liczba całkowita lub zmiennoprzecinkowa Liczba dzieląca dywidendę, ale nie może być równa zero
Wartość zwracana Typ Description
< modulo-wynik> Liczba całkowita lub zmiennoprzecinkowa Pozostała część z dzielenia pierwszej liczby przez drugą liczbę

Przykład 1

W tym przykładzie pierwsza liczba jest podzielona przez drugą liczbę:

mod(3, 2)

I zwraca ten wynik: 1

Przykład 2

W tym przykładzie pokazano, że jeśli jedna lub obie wartości są ujemne, wynik odpowiada znakowi dywidendy:

mod(-5, 2)
mod(4, -3)

Przykład zwraca następujące wyniki:

  • Pierwszy przykład: -1
  • Drugi przykład: 1

mul

Zwróć wynik mnożenia dwóch liczb.

mul(<multiplicand1>, <multiplicand2>)
Parameter Required Typ Description
< multiplicand1> Yes Liczba całkowita lub zmiennoprzecinkowa Liczba, która ma być mnożna przez mnożenie i 2
< multiplicand2> Yes Liczba całkowita lub zmiennoprzecinkowa Liczba wielokrotna mnożenia i1
Wartość zwracana Typ Description
< wynik produktu> Liczba całkowita lub zmiennoprzecinkowa Produkt z mnożenia pierwszej liczby przez drugą liczbę

Example

W tych przykładach wiele pierwszej liczby według drugiej liczby:

mul(1, 2)
mul(1.5, 2)

I zwróć następujące wyniki:

  • Pierwszy przykład: 2
  • Drugi przykład 3

multipartBody

Zwróć treść określonej części w danych wyjściowych akcji, które mają wiele części.

multipartBody('<actionName>', <index>)
Parameter Required Typ Description
< actionName> Yes String Nazwa akcji, która zawiera dane wyjściowe z wieloma częściami
< indeks> Yes Integer Wartość indeksu dla żądanej części
Wartość zwracana Typ Description
< ciało> String Treść określonej części

N

not

Sprawdź, czy wyrażenie jest fałszywe. Zwraca wartość true, gdy wyrażenie ma wartość false lub zwraca wartość false, gdy wartość true.

not(<expression>)
Parameter Required Typ Description
< wyrażenie> Yes logiczny Wyrażenie do sprawdzenia
Wartość zwracana Typ Description
prawda lub fałsz logiczny Zwraca wartość true, gdy wyrażenie ma wartość false. Zwraca wartość false, gdy wyrażenie ma wartość true.

Przykład 1

Te przykłady sprawdzają, czy określone wyrażenia są fałszywe:

not(false)
not(true)

I zwróć następujące wyniki:

  • Pierwszy przykład: wyrażenie ma wartość false, więc funkcja zwraca truewartość .
  • Drugi przykład: Wyrażenie ma wartość true, więc funkcja zwraca falsewartość .

Przykład 2

Te przykłady sprawdzają, czy określone wyrażenia są fałszywe:

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

I zwróć następujące wyniki:

  • Pierwszy przykład: wyrażenie ma wartość false, więc funkcja zwraca truewartość .
  • Drugi przykład: Wyrażenie ma wartość true, więc funkcja zwraca falsewartość .

nthIndexOf

Zwróć pozycję początkową lub wartość indeksu, w której nwystąpienie podciągu pojawia się w ciągu.

nthIndexOf('<text>', '<searchText>', <occurrence>)
Parameter Required Typ Description
< Tekst> Yes String Ciąg zawierający podciąg do znalezienia
< tekst wyszukiwania> Yes String Podciąg do znalezienia
< zdarzenie> Yes Integer Liczba określająca nwystąpienie podciągów do znalezienia. Jeśli wystąpienie jest ujemne, rozpocznij wyszukiwanie od końca.
Wartość zwracana Typ Description
< Wartość indeksowa> Integer Wartość pozycji początkowej lub indeksu dla nwystąpienia określonego podciągu. Jeśli podciąg nie zostanie znaleziony lub nie zostanie odnaleziony mniej niż n wystąpień podciągów, zwróć wartość -1.

Examples

nthIndexOf('123456789123465789', '1', 1) // Returns `0`.
nthIndexOf('123456789123465789', '1', 2) // Returns `9`.
nthIndexOf('123456789123465789', '12', 2) // Returns `9`.
nthIndexOf('123456789123465789', '6', 4) // Returns `-1`.

O

or

Sprawdź, czy co najmniej jedno wyrażenie jest prawdziwe. Zwraca wartość true, gdy co najmniej jedno wyrażenie ma wartość true lub zwraca wartość false, gdy wszystkie są fałszywe.

or(<expression1>, <expression2>, ...)
Parameter Required Typ Description
< wyraz1,><wyrażenie2>, ... Yes logiczny Wyrażenia do sprawdzenia
Wartość zwracana Typ Description
prawda lub fałsz logiczny Zwraca wartość true, gdy co najmniej jedno wyrażenie ma wartość true. Zwraca wartość false, gdy wszystkie wyrażenia są fałszywe.

Przykład 1

Te przykłady sprawdzają, czy co najmniej jedno wyrażenie ma wartość true:

or(true, false)
or(false, false)

I zwróć następujące wyniki:

  • Pierwszy przykład: Co najmniej jedno wyrażenie ma wartość true, więc funkcja zwraca truewartość .
  • Drugi przykład: Oba wyrażenia są fałszywe, więc funkcja zwraca falsewartość .

Przykład 2

Te przykłady sprawdzają, czy co najmniej jedno wyrażenie ma wartość true:

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

I zwróć następujące wyniki:

  • Pierwszy przykład: Co najmniej jedno wyrażenie ma wartość true, więc funkcja zwraca truewartość .
  • Drugi przykład: Oba wyrażenia są fałszywe, więc funkcja zwraca falsewartość .

outputs

Zwraca dane wyjściowe akcji w czasie wykonywania.

outputs('<actionName>')
Parameter Required Typ Description
< actionName> Yes String Nazwa danych wyjściowych akcji, które chcesz wykonać
Wartość zwracana Typ Description
< wyjście> String Dane wyjściowe z określonej akcji

Example

Ten przykład pobiera dane wyjściowe z akcji Get userX:

outputs('Get_user')

I zwraca ten wynik:

{
  "statusCode": 200,
  "headers": {
    "Pragma": "no-cache",
    "Vary": "Accept-Encoding",
    "x-ms-request-id": "a916ec8f52211265d98159adde2efe0b",
    "X-Content-Type-Options": "nosniff",
    "Timing-Allow-Origin": "*",
    "Cache-Control": "no-cache",
    "Date": "Mon, 09 Apr 2018 18:47:12 GMT",
    "Set-Cookie": "ARRAffinity=b9400932367ab5e3b6802e3d6158afffb12fcde8666715f5a5fbd4142d0f0b7d;Path=/;HttpOnly;Domain=twitter-wus.azconn-wus.p.azurewebsites.net",
    "X-AspNet-Version": "4.0.30319",
    "X-Powered-By": "ASP.NET",
    "Content-Type": "application/json; charset=utf-8",
    "Expires": "-1",
    "Content-Length": "339"
  },
  "body": {
    "FullName": "Contoso Corporation",
    "Location": "Generic Town, USA",
    "Id": 283541717,
    "UserName": "ContosoInc",
    "FollowersCount": 172,
    "Description": "Leading the way in transforming the digital workplace.",
    "StatusesCount": 93,
    "FriendsCount": 126,
    "FavouritesCount": 46,
    "ProfileImageUrl": "https://pbs.twimg.com/profile_images/908820389907722240/gG9zaHcd_400x400.jpg"
  }
}

P

parameters

Zwróć wartość parametru opisanego w definicji przepływu pracy.

parameters('<parameterName>')
Parameter Required Typ Description
< nazwa parametru> Yes String Nazwa parametru, którego wartość ma zostać utworzona
Wartość zwracana Typ Description
< parametr-wartość> Any Wartość określonego parametru

Example

Załóżmy, że masz tę wartość JSON:

{
  "fullName": "Sophia Owen"
}

W tym przykładzie jest pobierana wartość określonego parametru:

parameters('fullName')

I zwraca ten wynik: "Sophia Owen"

parseDateTime

Zwróć znacznik czasu z ciągu zawierającego znacznik czasu.

parseDateTime('<timestamp>', '<locale>'?, '<format>'?)
Parameter Required Typ Description
< Sygnatury czasowej> Yes String Ciąg zawierający znacznik czasu
< Ustawień regionalnych> No String Ustawienia regionalne do użycia.

Jeśli nie zostanie określony, domyślne ustawienia regionalne to en-us.

Jeśli ustawienia regionalne nie są prawidłową wartością, zostanie wygenerowany błąd.
< format> No String Ciąg formatu liczbowego, który jest specyfikatorem pojedynczego formatu lub wzorcem formatu niestandardowego. Domyślny format znacznika czasu to "o" (rrrr-MM-ddTHH:mm:ss.fffffffK), który jest zgodny z normą ISO 8601 i zachowuje informacje o strefie czasowej. Jeśli format nie jest określony, spróbuj przeanalizować wiele formatów, które są zgodne z podanymi ustawieniami regionalnymi. Jeśli format nie jest prawidłową wartością, zostanie wygenerowany błąd.
Wartość zwracana Typ Description
< parsowany znacznik czasu> String Przeanalizowany znacznik czasu w formacie "o" (rrrr-MM-ddTHH:mm:ss.fffK), który jest zgodny z normą ISO 8601 i zachowuje informacje o strefie czasowej.

Examples

parseDateTime('20/10/2014', 'fr-fr') // Returns '2014-10-20T00:00:00.0000000'.
parseDateTime('20 octobre 2010', 'fr-FR') // Returns '2010-10-20T00:00:00.0000000'.
parseDateTime('martes 20 octubre 2020', 'es-es') // Returns '2020-10-20T00:00:00.0000000'.
parseDateTime('21052019', 'fr-fr', 'ddMMyyyy') // Returns '2019-05-21T00:00:00.0000000'.
parseDateTime('20190521', 'fr-fr', 'yyyyMMdd') // Returns '2019-05-21T00:00:00.0000000'.
parseDateTime('10/20/2014 15h', 'en-US', 'MM/dd/yyyy HH\h') // Returns '2014-10-20T15:00:00.0000000'.

R

rand

Zwraca losową liczbę całkowitą z określonego zakresu, który jest uwzględniany tylko na końcu początkowym.

rand(<minValue>, <maxValue>)
Parameter Required Typ Description
< minValue> Yes Integer Najniższa liczba całkowita w zakresie
< maxValue> Yes Integer Liczba całkowita, która jest zgodna z najwyższą liczbą całkowitą w zakresie, który może zwrócić funkcja
Wartość zwracana Typ Description
< wynik losowy> Integer Losowa liczba całkowita zwrócona z określonego zakresu

Example

W tym przykładzie jest pobierana losowa liczba całkowita z określonego zakresu, z wyłączeniem maksymalnej wartości:

rand(1, 5)

Funkcja zwraca jedną z tych liczb w wyniku: 1, , 2lub 34

zakres

Zwraca tablicę całkowitą rozpoczynającą się od określonej liczby całkowitej.

range(<startIndex>, <count>)
Parameter Required Typ Description
< startIndex> Yes Integer Wartość całkowita, która uruchamia tablicę jako pierwszy element
< hrabia> Yes Integer Liczba liczb całkowitych w tablicy. Wartość parametru count musi być dodatnią liczbą całkowitą, która nie przekracza 100 000.



Uwaga: Suma startIndex wartości i count nie może przekraczać 2 147 483 647.
Wartość zwracana Typ Description
[<wynik> zasięgowy] Array Tablica z liczbami całkowitymi rozpoczynającymi się od określonego indeksu

Example

W tym przykładzie jest tworzona tablica całkowita, która rozpoczyna się od określonego indeksu i ma określoną liczbę liczb całkowitych:

range(1, 4)

I zwraca ten wynik: [1, 2, 3, 4]

removeProperty

Usuń właściwość z obiektu i zwróć zaktualizowany obiekt. Jeśli właściwość, którą próbujesz usunąć, nie istnieje, funkcja zwraca oryginalny obiekt.

removeProperty(<object>, '<property>')
Parameter Required Typ Description
< sprzeciwiać się> Yes Object Obiekt JSON, z którego chcesz usunąć właściwość
< własność> Yes String Nazwa właściwości do usunięcia
Wartość zwracana Typ Description
< zaktualizowany obiekt> Object Zaktualizowany obiekt JSON bez określonej właściwości

Aby usunąć właściwość podrzędną z istniejącej właściwości, użyj następującej składni:

removeProperty(<object>['<parent-property>'], '<child-property>')
Parameter Required Typ Description
< sprzeciwiać się> Yes Object Obiekt JSON, którego właściwość ma zostać usunięta
< właściwość nadrzędna> Yes String Nazwa właściwości nadrzędnej z właściwością podrzędną, którą chcesz usunąć
< właściwość podrzędna> Yes String Nazwa właściwości podrzędnej do usunięcia
Wartość zwracana Typ Description
< zaktualizowany obiekt> Object Zaktualizowany obiekt JSON, którego właściwość podrzędna została usunięta

Przykład 1

W tym przykładzie właściwość jest usuwana middleName z obiektu JSON, który jest konwertowany z ciągu na kod JSON przy użyciu funkcji JSON() i zwraca zaktualizowany obiekt:

removeProperty(json('{ "firstName": "Sophia", "middleName": "Anne", "surName": "Owen" }'), 'middleName')

Oto bieżący obiekt JSON:

{
   "firstName": "Sophia",
   "middleName": "Anne",
   "surName": "Owen"
}

Oto zaktualizowany obiekt JSON:

{
   "firstName": "Sophia",
   "surName": "Owen"
}

Przykład 2

W tym przykładzie właściwość podrzędna jest usuwana middleName z właściwości nadrzędnej customerName w obiekcie JSON, który jest konwertowany z ciągu na kod JSON przy użyciu funkcji JSON() i zwraca zaktualizowany obiekt:

removeProperty(json('{ "customerName": { "firstName": "Sophia", "middleName": "Anne", "surName": "Owen" } }')['customerName'], 'middleName')

Oto bieżący obiekt JSON:

{
   "customerName": {
      "firstName": "Sophia",
      "middleName": "Anne",
      "surName": "Owen"
   }
}

Oto zaktualizowany obiekt JSON:

{
   "customerName": {
      "firstName": "Sophia",
      "surName": "Owen"
   }
}

zamienić

Zastąp podciąg określonym ciągiem i zwróć ciąg wynikowy. Ta funkcja uwzględnia wielkość liter.

replace('<text>', '<oldText>', '<newText>')
Parameter Required Typ Description
< Tekst> Yes String Ciąg, który ma podciąg, który ma zastąpić
< oldText> Yes String Podciąg do zastąpienia
< newText> Yes String Ciąg zastępczy
Wartość zwracana Typ Description
< zaktualizowany tekst> String Zaktualizowany ciąg po zastąpieniu podciągu

Jeśli podciąg nie zostanie znaleziony, zwróć oryginalny ciąg.

Example

W tym przykładzie znajduje się podciąg "stary" w ciągu "stary" i zastępuje ciąg "old" ciągiem "new":

replace('the old string', 'old', 'new')

I zwraca ten wynik: "the new string"

result

Zwróć wyniki z akcji najwyższego poziomu w określonej akcji o określonym zakresie, takiej jak For_each, Untillub Scope akcja. Funkcja result() akceptuje pojedynczy parametr, który jest nazwą zakresu i zwraca tablicę zawierającą informacje z akcji pierwszego poziomu w tym zakresie. Te obiekty akcji zawierają te same atrybuty co atrybuty zwracane przez actions() funkcję, takie jak czas rozpoczęcia akcji, czas zakończenia, stan, dane wejściowe, identyfikatory korelacji i dane wyjściowe.

Note

Ta funkcja zwraca informacje tylko z akcji pierwszego poziomu w akcji o określonym zakresie, a nie z bardziej zagnieżdżonych akcji, takich jak akcje przełączania lub warunku.

Możesz na przykład użyć tej funkcji, aby uzyskać wyniki z akcji, które zakończyły się niepowodzeniem, aby można było diagnozować i obsługiwać wyjątki. Aby uzyskać więcej informacji, zobacz Pobieranie kontekstu i wyników dla błędów.

result('<scopedActionName>')
Parameter Required Typ Description
< scopedActionName> Yes String Nazwa akcji o określonym zakresie, w której mają zostać wprowadzone dane wejściowe i wyjściowe z akcji najwyższego poziomu w tym zakresie
Wartość zwracana Typ Description
< array-object> Obiekt tablicy Tablica zawierająca tablice danych wejściowych i wyjściowych z każdej akcji najwyższego poziomu w określonym zakresie

Example

W tym przykładzie zwracane są dane wejściowe i wyjściowe z każdej iteracji akcji HTTP wewnątrz For_each pętli, używając result() funkcji w Compose akcji:

{
   "actions": {
      "Compose": {
         "inputs": "@result('For_each')",
         "runAfter": {
            "For_each": [
               "Succeeded"
            ]
         },
         "type": "compose"
      },
      "For_each": {
         "actions": {
            "HTTP": {
               "inputs": {
                  "method": "GET",
                  "uri": "https://httpstat.us/200"
               },
               "runAfter": {},
               "type": "Http"
            }
         },
         "foreach": "@triggerBody()",
         "runAfter": {},
         "type": "Foreach"
      }
   }
}

Oto jak przykładowa zwracana tablica może wyglądać, gdzie obiekt zewnętrzny outputs zawiera dane wejściowe i wyjściowe z każdej iteracji akcji wewnątrz For_each akcji.

[
   {
      "name": "HTTP",
      "outputs": [
         {
            "name": "HTTP",
            "inputs": {
               "uri": "https://httpstat.us/200",
               "method": "GET"
            },
            "outputs": {
               "statusCode": 200,
               "headers": {
                   "X-AspNetMvc-Version": "5.1",
                   "Access-Control-Allow-Origin": "*",
                   "Cache-Control": "private",
                   "Date": "Tue, 20 Aug 2019 22:15:37 GMT",
                   "Set-Cookie": "ARRAffinity=0285cfbea9f2ee7",
                   "Server": "Microsoft-IIS/10.0",
                   "X-AspNet-Version": "4.0.30319",
                   "X-Powered-By": "ASP.NET",
                   "Content-Length": "0"
               },
               "startTime": "2019-08-20T22:15:37.6919631Z",
               "endTime": "2019-08-20T22:15:37.95762Z",
               "trackingId": "6bad3015-0444-4ccd-a971-cbb0c99a7.....",
               "clientTrackingId": "085863526764.....",
               "code": "OK",
               "status": "Succeeded"
            }
         },
         {
            "name": "HTTP",
            "inputs": {
               "uri": "https://httpstat.us/200",
               "method": "GET"
            },
            "outputs": {
            "statusCode": 200,
               "headers": {
                   "X-AspNetMvc-Version": "5.1",
                   "Access-Control-Allow-Origin": "*",
                   "Cache-Control": "private",
                   "Date": "Tue, 20 Aug 2019 22:15:37 GMT",
                   "Set-Cookie": "ARRAffinity=0285cfbea9f2ee7",
                   "Server": "Microsoft-IIS/10.0",
                   "X-AspNet-Version": "4.0.30319",
                   "X-Powered-By": "ASP.NET",
                   "Content-Length": "0"
               },
               "startTime": "2019-08-20T22:15:37.6919631Z",
               "endTime": "2019-08-20T22:15:37.95762Z",
               "trackingId": "9987e889-981b-41c5-aa27-f3e0e59bf69.....",
               "clientTrackingId": "085863526764.....",
               "code": "OK",
               "status": "Succeeded"
            }
         }
      ]
   }
]

reverse

Odwraca kolejność elementów w kolekcji. Gdy używasz tej funkcji z funkcją sort(), możesz sortować kolekcję w kolejności malejącej.

reverse([<collection>])
Parameter Required Typ Description
< kolekcja> Yes Array Kolekcja do odwrócenia
Wartość zwracana Typ Description
[<zaktualizowana kolekcja>] Array Odwrócona kolekcja

Example

W tym przykładzie odwrócona jest tablica liczb całkowitych:

reverse(createArray(0, 1, 2, 3))

Zwraca tę tablicę: [3,2,1,0]

S

setProperty

Ustaw wartość właściwości obiektu JSON i zwróć zaktualizowany obiekt. Jeśli właściwość, którą próbujesz ustawić, nie istnieje, właściwość zostanie dodana do obiektu. Aby dodać nową właściwość, użyj funkcji addProperty().

setProperty(<object>, '<property>', <value>)
Parameter Required Typ Description
< sprzeciwiać się> Yes Object Obiekt JSON, którego właściwość chcesz ustawić
< własność> Yes String Nazwa istniejącej lub nowej właściwości do ustawienia
< wartość> Yes Any Wartość ustawiona dla określonej właściwości

Aby ustawić właściwość podrzędną w obiekcie podrzędnym, użyj wywołania zagnieżdżonego setProperty() . W przeciwnym razie funkcja zwraca tylko obiekt podrzędny jako dane wyjściowe.

setProperty(<object>, '<parent-property>', setProperty(<object>['parentProperty'], '<child-property>', <value>))
Parameter Required Typ Description
< sprzeciwiać się> Yes Object Obiekt JSON, którego właściwość chcesz ustawić
< właściwość nadrzędna> Yes String Nazwa właściwości nadrzędnej z właściwością podrzędną, którą chcesz ustawić
< właściwość podrzędna> Yes String Nazwa właściwości podrzędnej do ustawienia
< wartość> Yes Any Wartość ustawiona dla określonej właściwości
Wartość zwracana Typ Description
< zaktualizowany obiekt> Object Zaktualizowany obiekt JSON, którego właściwość została ustawiona

Przykład 1

W tym przykładzie surName właściwość ustawia właściwość w obiekcie JSON, który jest konwertowany z ciągu na kod JSON przy użyciu funkcji JSON(). Funkcja przypisuje określoną wartość do właściwości i zwraca zaktualizowany obiekt:

setProperty(json('{ "firstName": "Sophia", "surName": "Owen" }'), 'surName', 'Hartnett')

Oto bieżący obiekt JSON:

{
   "firstName": "Sophia",
   "surName": "Owen"
}

Oto zaktualizowany obiekt JSON:

{
   "firstName": "Sophia",
   "surName": "Hartnett"
}

Przykład 2

W tym przykładzie właściwość podrzędna surName dla właściwości nadrzędnej customerName w obiekcie JSON jest konwertowana z ciągu na format JSON przy użyciu funkcji JSON(). Funkcja przypisuje określoną wartość do właściwości i zwraca zaktualizowany obiekt:

setProperty(json('{ "customerName": { "firstName": "Sophia", "surName": "Owen" } }'), 'customerName', setProperty(json('{ "customerName": { "firstName": "Sophia", "surName": "Owen" } }')['customerName'], 'surName', 'Hartnett'))

Oto bieżący obiekt JSON:

{
   "customerName": {
      "firstName": "Sophie",
      "surName": "Owen"
   }
}

Oto zaktualizowany obiekt JSON:

{
   "customerName": {
      "firstName": "Sophie",
      "surName": "Hartnett"
   }
}

pominąć

Usuń elementy rozpoczynające kolekcję i zwróć wszystkie pozostałe elementy.

skip([<collection>], <count>)
Parameter Required Typ Description
< kolekcja> Yes Array Kolekcja, której elementy chcesz usunąć
< hrabia> Yes Integer Dodatnia liczba całkowita dla liczby elementów do usunięcia z przodu
Wartość zwracana Typ Description
[<zaktualizowana kolekcja>] Array Zaktualizowana kolekcja po usunięciu określonych elementów

Example

W tym przykładzie usunięto jeden element ( liczbę 0) z przodu określonej tablicy:

skip(createArray(0, 1, 2, 3), 1)

Zwraca tę tablicę z pozostałymi elementami: [1,2,3]

część

Zwróć podciąg, określając pozycję początkową i końcową lub wartość. Zobacz również podciąg ().

slice('<text>', <startIndex>, <endIndex>?)
Parameter Required Typ Description
< Tekst> Yes String Ciąg zawierający podciąg do znalezienia
< startIndex> Yes Integer Położenie początkowe lub wartość początkowa oparta na zera, gdzie rozpocząć wyszukiwanie podciągów

— Jeśli właściwość startIndex jest większa niż długość ciągu, zwróć pusty ciąg.

— Jeśli właściwość startIndex jest ujemna, rozpocznij wyszukiwanie na wartości indeksu, która jest sumą długości ciągu i właściwości startIndex.
< endIndex> No Integer Położenie lub wartość końcowa oparta na zera, gdzie należy zakończyć wyszukiwanie podciągów. Znak znajdujący się w końcowej wartości indeksu nie jest uwzględniony w wyszukiwaniu.

— Jeśli właściwość endIndex nie jest określona lub większa niż długość ciągu, wyszukaj na końcu ciągu.

— Jeśli właściwość endIndex jest ujemna, zakończ wyszukiwanie na wartości indeksu, która jest sumą długości ciągu i endIndex.
Wartość zwracana Typ Description
< wynik fragmentatora> String Nowy ciąg zawierający znaleziony podciąg

Examples

slice('Hello World', 2) // Returns 'llo World'.
slice('Hello World', 30) // Returns ''.
slice('Hello World', 10, 2) // Returns ''.
slice('Hello World', 0) // Returns 'Hello World'.
slice('Hello World', 2, 5) // Returns 'llo'.
slice('Hello World', 6, 20) // Returns 'World'.
slice('Hello World', -2) // Returns 'ld'.
slice('Hello World', 3, -1) // Returns 'lo Worl'.
slice('Hello World', 3, 3) // Returns ''.

sortować

Sortuj elementy w kolekcji. Możesz sortować obiekty kolekcji za pomocą dowolnego klucza, który zawiera prymitywny typ danych obsługiwany przez Workflow Definition Language, taki jak int, float, string lub bool.

sort([<collection>], <sortBy>?)
Parameter Required Typ Description
< kolekcja> Yes Array Kolekcja z elementami do sortowania
< sortBy> No String Klucz używany do sortowania obiektów kolekcji
Wartość zwracana Typ Description
[<zaktualizowana kolekcja>] Array Posortowana kolekcja

Przykład 1

W tym przykładzie sortuje się tablicę liczb całkowitych:

sort(createArray(2, 1, 0, 3))

Zwraca tę tablicę: [0,1,2,3]

Przykład 2

Ten przykład sortuje tablicę obiektów według klucza:

sort(createArray(json('{ "first": "Amalie", "last": "Rose" }'), json('{ "first": "Elise", "last": "Renee" }')), 'last')

Zwraca tę tablicę: [{ "first": "Elise", "last": "Renee" }, {"first": "Amalie", "last": "Rose" }')]

podzielić

Zwraca tablicę zawierającą podciągi oddzielone przecinkami na podstawie określonego znaku ogranicznika w oryginalnym ciągu.

split('<text>', '<delimiter>')
Parameter Required Typ Description
< Tekst> Yes String Ciąg do oddzielenia od podciągów na podstawie określonego ogranicznika w oryginalnym ciągu
< Ogranicznik> Yes String Znak w oryginalnym ciągu do użycia jako ogranicznik
Wartość zwracana Typ Description
[<podciąg1,podciąg2><>,...] Array Tablica zawierająca podciągy z oryginalnego ciągu oddzielona przecinkami

Przykład 1

W tym przykładzie jest tworzona tablica z podciągami z określonego ciągu na podstawie określonego znaku jako ogranicznika:

split('a_b_c', '_')

I zwraca tę tablicę w wyniku: ["a","b","c"]

Przykład 2

W tym przykładzie jest tworzona tablica z jednym elementem, gdy w ciągu nie istnieje ogranicznik:

split('a_b_c', ' ')

I zwraca tę tablicę w wyniku: ["a_b_c"]

startOfDay

Zwróć początek dnia dla znacznika czasu.

startOfDay('<timestamp>', '<format>'?)
Parameter Required Typ Description
< Sygnatury czasowej> Yes String Ciąg zawierający znacznik czasu
< format> No String Ciąg formatu liczbowego, który jest specyfikatorem pojedynczego formatu lub wzorcem formatu niestandardowego. Domyślny format znacznika czasu to "o" (rrrr-MM-ddTHH:mm:ss.fffffffK), który jest zgodny z normą ISO 8601 i zachowuje informacje o strefie czasowej.

Jeśli format nie jest prawidłową wartością, zostanie wygenerowany błąd.
Wartość zwracana Typ Description
< sygnatura czasowa aktualizacji> String Określony znacznik czasu, ale rozpoczynający się od znaku zero-godzinnego dla dnia

Example

W tym przykładzie znajduje się początek dnia dla tego znacznika czasu:

startOfDay('2018-03-15T13:30:30Z')

I zwraca ten wynik: "2018-03-15T00:00:00.0000000Z"

startOfHour

Zwróć początek bieżącej godziny dla danego znacznika czasu.

startOfHour('<timestamp>', '<format>'?)
Parameter Required Typ Description
< Sygnatury czasowej> Yes String Ciąg zawierający znacznik czasu
< format> No String Ciąg formatu liczbowego, który jest specyfikatorem pojedynczego formatu lub wzorcem formatu niestandardowego. Domyślny format znacznika czasu to "o" (rrrr-MM-ddTHH:mm:ss.fffffffK), który jest zgodny z normą ISO 8601 i zachowuje informacje o strefie czasowej.

Jeśli format nie jest prawidłową wartością, zostanie wygenerowany błąd.
Wartość zwracana Typ Description
< sygnatura czasowa aktualizacji> String Określony znacznik czasu, ale rozpoczynający się od znaku zero-minutowego dla godziny

Example

W tym przykładzie znajduje się początek godziny dla tego znacznika czasu:

startOfHour('2018-03-15T13:30:30Z')

I zwraca ten wynik: "2018-03-15T13:00:00.0000000Z"

startOfMonth

Zwróć początek miesiąca na podstawie znacznika czasu.

startOfMonth('<timestamp>', '<format>'?)
Parameter Required Typ Description
< Sygnatury czasowej> Yes String Ciąg zawierający znacznik czasu
< format> No String Ciąg formatu liczbowego, który jest specyfikatorem pojedynczego formatu lub wzorcem formatu niestandardowego. Domyślny format znacznika czasu to "o" (rrrr-MM-ddTHH:mm:ss.fffffffK), który jest zgodny z normą ISO 8601 i zachowuje informacje o strefie czasowej.

Jeśli format nie jest prawidłową wartością, zostanie wygenerowany błąd.
Wartość zwracana Typ Description
< sygnatura czasowa aktualizacji> String Określony znacznik czasu, ale rozpoczynający się pierwszego dnia miesiąca na znaczniku zero-godzinnym

Przykład 1

Ten przykład zwraca początek miesiąca dla tego znacznika czasu:

startOfMonth('2018-03-15T13:30:30Z')

I zwraca ten wynik: "2018-03-01T00:00:00.0000000Z"

Przykład 2

Ten przykład zwraca początek miesiąca w określonym formacie dla tego znacznika czasu:

startOfMonth('2018-03-15T13:30:30Z', 'yyyy-MM-dd')

I zwraca ten wynik: "2018-03-01"

startsWith

Sprawdź, czy ciąg rozpoczyna się od określonego podciągu. Zwraca wartość true, gdy podciąg zostanie znaleziony lub zwróci wartość false, gdy nie zostanie znaleziona. Ta funkcja nie uwzględnia wielkości liter.

startsWith('<text>', '<searchText>')
Parameter Required Typ Description
< Tekst> Yes String Ciąg do sprawdzenia
< tekst wyszukiwania> Yes String Ciąg początkowy do znalezienia
Wartość zwracana Typ Description
prawda lub fałsz logiczny Zwraca wartość true po znalezieniu początkowego podciągu. Zwraca wartość false, gdy nie zostanie znaleziona.

Przykład 1

W tym przykładzie sprawdza się, czy ciąg "hello world" rozpoczyna się od podciągu "hello":

startsWith('hello world', 'hello')

I zwraca ten wynik: true

Przykład 2

W tym przykładzie sprawdza się, czy ciąg "hello world" rozpoczyna się od podciągu "greetings":

startsWith('hello world', 'greetings')

I zwraca ten wynik: false

ciąg

Zwróć wersję ciągu dla wartości.

string(<value>)
Parameter Required Typ Description
< wartość> Yes Any Wartość do konwersji. Jeśli ta wartość ma wartość null lub ma wartość null, wartość jest konwertowana na pusty ciąg ("").



Jeśli na przykład przypiszesz zmienną ciągu do właściwości nieistniejącej, do której można uzyskać dostęp za pomocą ? operatora, wartość null zostanie przekonwertowana na pusty ciąg. Jednak porównywanie wartości null nie jest takie samo jak porównywanie pustego ciągu.
Wartość zwracana Typ Description
< ciąg-wartość> String Wersja ciągu dla określonej wartości. Jeśli parametr wartości ma wartość null lub ma wartość null, ta wartość jest zwracana jako pusta wartość ciągu ("").

Przykład 1

W tym przykładzie zostanie utworzona wersja ciągu dla tego numeru:

string(10)

I zwraca ten wynik: "10"

Przykład 2

W tym przykładzie tworzony jest ciąg dla określonego obiektu JSON i używa znaku ukośnika odwrotnego (\) jako znaku ucieczki dla podwójnego cudzysłowu (").

string( { "name": "Sophie Owen" } )

I zwraca ten wynik: "{ \\"name\\": \\"Sophie Owen\\" }"

sub

Zwróć wynik odejmowania liczby drugiej od liczby pierwszej.

sub(<minuend>, <subtrahend>)
Parameter Required Typ Description
< minuend> Yes Liczba całkowita lub zmiennoprzecinkowa Liczba, z której należy odjąć odejmowanie odejmowania
< odjemnik> Yes Liczba całkowita lub zmiennoprzecinkowa Liczba do odejmowania od minuend
Wartość zwracana Typ Description
< wynik> Liczba całkowita lub zmiennoprzecinkowa Wynik odejmowania drugiej liczby z pierwszej liczby

Example

W tym przykładzie odejmuje drugą liczbę z pierwszej liczby:

sub(10.3, .3)

I zwraca ten wynik: 10

substring

Zwraca znaki z ciągu, zaczynając od określonej pozycji lub indeksu. Wartości indeksu zaczynają się od liczby 0. Zobacz również fragmentator().

substring('<text>', <startIndex>, <length>)
Parameter Required Typ Description
< Tekst> Yes String Ciąg, którego znaki chcesz
< startIndex> Yes Integer Liczba dodatnia równa lub większa niż 0, której chcesz użyć jako pozycji początkowej lub wartości indeksu
< długość> No Integer Dodatnia liczba znaków, które mają być w podciągu

Note

Upewnij się, że suma z dodawania wartości parametrów startIndex i length jest mniejsza niż długość ciągu podanego dla parametru tekstowego . W przeciwnym razie występuje błąd, w przeciwieństwie do podobnych funkcji w innych językach, w których wynikiem jest podciąg od indeksu start do końca ciągu. Parametr length jest opcjonalny i jeśli nie podano, funkcja substring() przyjmuje wszystkie znaki rozpoczynające się od startIndex na końcu ciągu.

Wartość zwracana Typ Description
< wynik podciągów> String Podciąg o określonej liczbie znaków rozpoczynający się od określonej pozycji indeksu w ciągu źródłowym

Example

W tym przykładzie utworzono podciąg z pięciu znaków z określonego ciągu, zaczynając od wartości indeksu 6:

substring('hello world', 6, 5)

I zwraca ten wynik: "world"

subtractFromTime

Odejmij liczbę jednostek czasu od znacznika czasowego. Zobacz również getPastTime.

subtractFromTime('<timestamp>', <interval>, '<timeUnit>', '<format>'?)
Parameter Required Typ Description
< Sygnatury czasowej> Yes String Ciąg zawierający znacznik czasu
< interwał> Yes Integer Liczba określonych jednostek czasu do odejmowania
< timeUnit> Yes String Jednostka czasu do użycia z interwałem: "Second", "Minute", "Hour", "Day", "Week", "Month", "Year"
< format> No String Ciąg formatu liczbowego, który jest specyfikatorem pojedynczego formatu lub wzorcem formatu niestandardowego. Domyślny format znacznika czasu to "o" (rrrr-MM-ddTHH:mm:ss.fffffffK), który jest zgodny z normą ISO 8601 i zachowuje informacje o strefie czasowej.

Jeśli format nie jest prawidłową wartością, zostanie wygenerowany błąd.
Wartość zwracana Typ Description
< sygnatura czasowa aktualizacji> String Sygnatura czasowa minus określona liczba jednostek czasu

Przykład 1

W tym przykładzie odejmuje jeden dzień od tego znacznika czasu:

subtractFromTime('2018-01-02T00:00:00Z', 1, 'Day')

I zwraca ten wynik: "2018-01-01T00:00:00.0000000Z"

Przykład 2

W tym przykładzie odejmuje jeden dzień od tego znacznika czasu:

subtractFromTime('2018-01-02T00:00:00Z', 1, 'Day', 'D')

Zwraca ten wynik przy użyciu opcjonalnego formatu "D": "Monday, January, 1, 2018"

T

take

Zwróć elementy z przodu kolekcji.

take('<collection>', <count>)
take([<collection>], <count>)
Parameter Required Typ Description
< kolekcja> Yes Ciąg lub tablica Kolekcja, której elementy chcesz
< hrabia> Yes Integer Dodatnia liczba całkowita dla liczby elementów, które mają być od przodu
Wartość zwracana Typ Description
< podzbiór> lub [<podzbiór>] Ciąg lub tablica, odpowiednio Ciąg lub tablica zawierająca określoną liczbę elementów pobranych z przodu oryginalnej kolekcji

Example

Te przykłady pobierają określoną liczbę elementów z przodu tych kolekcji:

take('abcde', 3)
take(createArray(0, 1, 2, 3, 4), 3)

I zwróć następujące wyniki:

  • Pierwszy przykład: "abc"
  • Drugi przykład: [0, 1, 2]

ticks

Zwraca liczbę znaczników, które są 100-nanosekundowe interwały, od 1 stycznia 0001 12:00:00 północy (lub DateTime.Ticks w C#) do określonego znacznika czasu. Aby uzyskać więcej informacji, zobacz ten temat: Właściwość DateTime.Ticks (System).

ticks('<timestamp>')
Parameter Required Typ Description
< Sygnatury czasowej> Yes String Ciąg znacznika czasu
Wartość zwracana Typ Description
< ticks-number> Integer Liczba znaczników od określonego znacznika czasu

toLower

Zwraca ciąg małymi literami. Jeśli znak w ciągu nie ma małej litery, ten znak pozostaje niezmieniony w zwracanym ciągu.

toLower('<text>')
Parameter Required Typ Description
< Tekst> Yes String Ciąg, który ma być zwracany w formacie małych liter
Wartość zwracana Typ Description
< małe litery i tekst> String Oryginalny ciąg w formacie małych liter

Example

W tym przykładzie ten ciąg jest konwertowany na małe litery:

toLower('Hello World')

I zwraca ten wynik: "hello world"

toUpper

Zwraca ciąg w formacie wielkiej litery. Jeśli znak w ciągu nie ma wielkiej litery, ten znak pozostaje niezmieniony w zwracanym ciągu.

toUpper('<text>')
Parameter Required Typ Description
< Tekst> Yes String Ciąg, który ma być zwracany w formacie wielkiej litery
Wartość zwracana Typ Description
< wielkie litery — tekst> String Oryginalny ciąg w formacie wielkiej litery

Example

W tym przykładzie ten ciąg jest konwertowany na wielkie litery:

toUpper('Hello World')

I zwraca ten wynik: "HELLO WORLD"

wyzwalacz

Zwraca dane wyjściowe wyzwalacza w czasie wykonywania lub wartości z innych par nazw i wartości JSON, które można przypisać do wyrażenia.

  • Wewnątrz danych wejściowych wyzwalacza ta funkcja zwraca dane wyjściowe z poprzedniego wykonania.

  • Wewnątrz warunku wyzwalacza ta funkcja zwraca dane wyjściowe z bieżącego wykonania.

Domyślnie funkcja odwołuje się do całego obiektu wyzwalacza, ale opcjonalnie można określić właściwość, której wartość jest odpowiednia. Ponadto ta funkcja ma dostępne wersje skrócone, zobacz triggerOutputs() i triggerBody().

trigger()
Wartość zwracana Typ Description
< Wyjście wyzwalacze> String Dane wyjściowe z wyzwalacza w czasie wykonywania

triggerBody

Zwracanie danych wyjściowych body wyzwalacza w czasie wykonywania. Skrót dla .trigger().outputs.body Zobacz trigger().

triggerBody()
Wartość zwracana Typ Description
< Wyjście z korpusem wyzwalacza> String Dane body wyjściowe z wyzwalacza

triggerFormDataMultiValues

Zwraca tablicę z wartościami, które pasują do nazwy klucza w danych formularza wyzwalacza lub danych wyjściowych zakodowanych w formie .

triggerFormDataMultiValues('<key>')
Parameter Required Typ Description
< klucz> Yes String Nazwa klucza, którego wartość ma zostać utworzona
Wartość zwracana Typ Description
[<tablica z wartościami> klucza] Array Tablica ze wszystkimi wartościami zgodnymi z określonym kluczem

Example

W tym przykładzie utworzono tablicę na podstawie wartości klucza "feedUrl" w danych formularza lub danych wyjściowych zakodowanych w formularzu wyzwalacza RSS:

triggerFormDataMultiValues('feedUrl')

I zwraca tę tablicę jako przykładowy wynik: ["https://feeds.a.dj.com/rss/RSSMarketsMain.xml"]

triggerFormDataValue

Zwraca ciąg z pojedynczą wartością zgodną z nazwą klucza w danych formularza lub danych wyjściowych zakodowanych w formularzu wyzwalacza. Jeśli funkcja znajdzie więcej niż jedno dopasowanie, funkcja zgłasza błąd.

triggerFormDataValue('<key>')
Parameter Required Typ Description
< klucz> Yes String Nazwa klucza, którego wartość ma zostać utworzona
Wartość zwracana Typ Description
< klucz-wartość> String Wartość w określonym kluczu

Example

W tym przykładzie zostanie utworzony ciąg z wartości klucza "feedUrl" w danych formularza lub danych wyjściowych zakodowanych w formularzu wyzwalacza RSS:

triggerFormDataValue('feedUrl')

I zwraca ten ciąg jako przykładowy wynik: "https://feeds.a.dj.com/rss/RSSMarketsMain.xml"

triggerMultipartBody

Zwróć treść określonej części w danych wyjściowych wyzwalacza, które mają wiele części.

triggerMultipartBody(<index>)
Parameter Required Typ Description
< indeks> Yes Integer Wartość indeksu dla żądanej części
Wartość zwracana Typ Description
< ciało> String Treść określonej części w danych wyjściowych wieloczęściowych wyzwalacza

triggerOutputs

Zwraca dane wyjściowe wyzwalacza w czasie wykonywania lub wartości z innych par nazw i wartości JSON. Skrót dla .trigger().outputs Zobacz trigger().

triggerOutputs()
Wartość zwracana Typ Description
< Wyjście wyzwalacze> String Dane wyjściowe z wyzwalacza w czasie wykonywania

przycinać

Usuń spacje wiodące i końcowe z ciągu i zwróć zmieniony ciąg.

trim('<text>')
Parameter Required Typ Description
< Tekst> Yes String Ciąg zawierający biały znak wiodący i końcowy do usunięcia
Wartość zwracana Typ Description
< aktualizowanyTekst> String Zaktualizowana wersja oryginalnego ciągu bez wiodącego lub końcowego odstępu

Example

W tym przykładzie usunięto wiodące i końcowe białe znaki z ciągu "Hello World":

trim(' Hello World  ')

I zwraca ten wynik: "Hello World"

U

związek

Zwróć kolekcję zawierającą wszystkie elementy z określonych kolekcji. Aby wyświetlić wynik, element może pojawić się w dowolnej kolekcji przekazanej do tej funkcji. Jeśli co najmniej jeden element ma taką samą nazwę, w wyniku pojawi się ostatni element o tej nazwie.

union('<collection1>', '<collection2>', ...)
union([<collection1>], [<collection2>], ...)
Parameter Required Typ Description
< kolekcja1>, <kolekcja2>, ... Yes Tablica lub obiekt, ale nie obie Kolekcje, z których mają być potrzebne wszystkie elementy
Wartość zwracana Typ Description
< aktualizowanaKolekcja> Tablica lub obiekt, odpowiednio Kolekcja ze wszystkimi elementami z określonych kolekcji — bez duplikatów

Example

Ten przykład pobiera wszystkie elementy z tych kolekcji:

union(createArray(1, 2, 3), createArray(1, 2, 10, 101))

I zwraca ten wynik: [1, 2, 3, 10, 101]

uriComponent

Zwróć wersję zakodowaną w postaci identyfikatora zasobu (URI) dla ciągu, zastępując znaki ucieczki niebezpiecznymi adresami URL. Użyj tej funkcji, a nie encodeUriComponent(). Chociaż obie funkcje działają w taki sam sposób, uriComponent() jest preferowana.

uriComponent('<value>')
Parameter Required Typ Description
< wartość> Yes String Ciąg do konwersji na format zakodowany w formacie URI
Wartość zwracana Typ Description
< identyfikator URI zakodowany> String Ciąg zakodowany w formacie URI z znakami ucieczki

Example

W tym przykładzie zostanie utworzona wersja zakodowana w identyfikatorze URI dla tego ciągu:

uriComponent('https://contoso.com')

I zwraca ten wynik: "https%3A%2F%2Fcontoso.com"

uriComponentToBinary

Zwróć wersję binarną dla składnika URI (Uniform Resource Identifier).

uriComponentToBinary('<value>')
Parameter Required Typ Description
< wartość> Yes String Ciąg zakodowany w formacie URI do konwersji
Wartość zwracana Typ Description
< Binary-for-encoded-uri> String Wersja binarna dla ciągu kodowanego identyfikatorem URI. Zawartość binarna jest zakodowana w formacie base64 i reprezentowana przez $contentelement .

Example

W tym przykładzie zostanie utworzona wersja binarna dla tego ciągu zakodowanego za pomocą identyfikatora URI:

uriComponentToBinary('https%3A%2F%2Fcontoso.com')

I zwraca ten wynik: "aHR0cHM6Ly9jb250b3NvLmNvbQ=="

uriComponentToString

Zwróć wersję ciągu dla zakodowanego ciągu identyfikatora URI (URI), co skutecznie dekoduje ciąg zakodowany w identyfikatorze URI.

uriComponentToString('<value>')
Parameter Required Typ Description
< wartość> Yes String Ciąg zakodowany za pomocą identyfikatora URI do dekodowania
Wartość zwracana Typ Description
< dekodowany identyfikator URI> String Zdekodowana wersja ciągu zakodowanego za pomocą identyfikatora URI

Example

W tym przykładzie tworzona jest zdekodowana wersja ciągu dla tego ciągu zakodowanego za pomocą identyfikatora URI:

uriComponentToString('https%3A%2F%2Fcontoso.com')

I zwraca ten wynik: "https://contoso.com"

uriHost

host Zwraca wartość identyfikatora URI (Uniform Resource Identifier).

uriHost('<uri>')
Parameter Required Typ Description
< Uri> Yes String Identyfikator URI, którego host wartość chcesz
Wartość zwracana Typ Description
< wartość hosta> String host Wartość określonego identyfikatora URI

Example

W tym przykładzie znajduje wartość dla tego identyfikatora host URI:

uriHost('https://www.localhost.com:8080')

I zwraca ten wynik: "www.localhost.com"

uriPath

path Zwraca wartość identyfikatora URI (Uniform Resource Identifier).

uriPath('<uri>')
Parameter Required Typ Description
< Uri> Yes String Identyfikator URI, którego path wartość chcesz
Wartość zwracana Typ Description
< wartość ścieżki> String Wartość path określonego identyfikatora URI. Jeśli path nie ma wartości, zwróć znak "/".

Example

W tym przykładzie znajduje wartość dla tego identyfikatora path URI:

uriPath('https://www.contoso.com/catalog/shownew.htm?date=today')

I zwraca ten wynik: "/catalog/shownew.htm"

uriPathAndQuery

Zwraca wartości path i query dla identyfikatora URI (URI).

uriPathAndQuery('<uri>')
Parameter Required Typ Description
< Uri> Yes String Identyfikator URI, którego path wartości i query chcesz
Wartość zwracana Typ Description
< path-query-value> String Wartości path i query dla określonego identyfikatora URI. Jeśli path nie określi wartości, zwróć znak "/".

Example

W tym przykładzie znajdują się wartości i path dla tego identyfikatora query URI:

uriPathAndQuery('https://www.contoso.com/catalog/shownew.htm?date=today')

I zwraca ten wynik: "/catalog/shownew.htm?date=today"

uriPort

port Zwraca wartość identyfikatora URI (Uniform Resource Identifier).

uriPort('<uri>')
Parameter Required Typ Description
< Uri> Yes String Identyfikator URI, którego port wartość chcesz
Wartość zwracana Typ Description
< port-wartość> Integer Wartość port określonego identyfikatora URI. Jeśli port nie określi wartości, zwróć domyślny port dla protokołu.

Example

Ten przykład zwraca wartość dla tego identyfikatora port URI:

uriPort('https://www.localhost:8080')

I zwraca ten wynik: 8080

uriQuery

query Zwraca wartość identyfikatora URI (Uniform Resource Identifier).

uriQuery('<uri>')
Parameter Required Typ Description
< Uri> Yes String Identyfikator URI, którego query wartość chcesz
Wartość zwracana Typ Description
< wartość zapytania> String query Wartość określonego identyfikatora URI

Example

Ten przykład zwraca wartość dla tego identyfikatora query URI:

uriQuery('https://www.contoso.com/catalog/shownew.htm?date=today')

I zwraca ten wynik: "?date=today"

uriScheme

scheme Zwraca wartość identyfikatora URI (Uniform Resource Identifier).

uriScheme('<uri>')
Parameter Required Typ Description
< Uri> Yes String Identyfikator URI, którego scheme wartość chcesz
Wartość zwracana Typ Description
< wartość schematu> String scheme Wartość określonego identyfikatora URI

Example

Ten przykład zwraca wartość dla tego identyfikatora scheme URI:

uriScheme('https://www.contoso.com/catalog/shownew.htm?date=today')

I zwraca ten wynik: "http"

utcNow

Zwróć bieżący znacznik czasu.

utcNow('<format>')

Opcjonalnie możesz określić inny format za pomocą parametru <formatu> .

Parameter Required Typ Description
< format> No String Ciąg formatu liczbowego, który jest specyfikatorem pojedynczego formatu lub wzorcem formatu niestandardowego. Domyślny format znacznika czasu to "o" (rrrr-MM-ddTHH:mm:ss.fffffffK), który jest zgodny z normą ISO 8601 i zachowuje informacje o strefie czasowej.

Jeśli format nie jest prawidłową wartością, zostanie wygenerowany błąd.
Wartość zwracana Typ Description
< znacznik czasu bieżącego> String Bieżąca data i godzina

Examples

utcNow()                  // Returns 2025-09-25T05:18:31.3384797Z
utcNow('u')               // Returns 2025-09-25 05:18:31Z
utcNow('U')               // Returns Thursday, September 25, 2025 5:18:31 AM
utcNow('d')               // Returns 9/25/2025
utcNow('D')               // Returns Thursday, September 25, 2025
utcNow('t')               // Returns 5:18 AM
utcNow('T')               // Returns 5:18:31 AM
utcNow('y')               // Returns September 2025
utcNow('yyyy')            // Returns 2025
utcNow('ddd, d MMM yyyy') // Returns Thu, 25 Sep 2025

V

variables

Zwraca wartość określonej zmiennej.

variables('<variableName>')
Parameter Required Typ Description
< nazwa_zmiennej> Yes String Nazwa zmiennej, której wartość ma zostać utworzona
Wartość zwracana Typ Description
< zmienna-wartość> Any Wartość określonej zmiennej

Example

Załóżmy, że bieżąca wartość zmiennej "numItems" to 20. W tym przykładzie jest pobierana wartość całkowita dla tej zmiennej:

variables('numItems')

I zwraca ten wynik: 20

W

przepływ pracy

Zwróć wszystkie szczegóły dotyczące samego przepływu pracy w czasie wykonywania.

workflow().<property>
Parameter Required Typ Description
< własność> No String Nazwa właściwości przepływu pracy, której wartość jest odpowiednia



Domyślnie obiekt przepływu pracy ma następujące właściwości: name, , type, idlocation, runi tags.



- Wartość run właściwości jest obiektem JSON, który zawiera następujące właściwości: name, typei id.



— Właściwość tags jest obiektem JSON zawierającym tagi skojarzone z aplikacją logiki w usłudze Azure Logic Apps lub przepływem w usłudze Power Automate oraz wartościami dla tych tagów. Aby uzyskać więcej informacji na temat tagów w zasobach platformy Azure, zobacz Tag zasobów, grupy zasobów i subskrypcje dla organizacji logicznej na platformie Azure.



Uwaga: domyślnie aplikacja logiki nie ma tagów, ale przepływ usługi Power Automate ma flowDisplayName tagi i environmentName .

Przykład 1

W tym przykładzie zwracana jest nazwa bieżącego przebiegu przepływu pracy:

workflow().run.name

Przykład 2

Jeśli używasz usługi Power Automate, możesz utworzyć @workflow() wyrażenie, które używa właściwości wyjściowej tags do pobierania wartości z właściwości lub flowDisplayName przepływuenvironmentName.

Możesz na przykład wysyłać niestandardowe powiadomienia e-mail z samego przepływu, które łączą się z przepływem. Te powiadomienia mogą zawierać link HTML zawierający nazwę wyświetlaną przepływu w tytule wiadomości e-mail i następującą składnię:

<a href=https://flow.microsoft.com/manage/environments/@{workflow()['tags']['environmentName']}/flows/@{workflow()['name']}/details>Open flow @{workflow()['tags']['flowDisplayName']}</a>

X

xml

Zwróć wersję XML dla ciągu zawierającego obiekt JSON.

xml('<value>')
Parameter Required Typ Description
< wartość> Yes String Ciąg z obiektem JSON do konwersji

Obiekt JSON musi mieć tylko jedną właściwość główną, która nie może być tablicą.
Użyj znaku ukośnika odwrotnego (\) jako znaku ucieczki dla podwójnego cudzysłowu (").
Wartość zwracana Typ Description
< wersja xml> Object Zakodowany kod XML dla określonego ciągu lub obiektu JSON

Przykład 1

W tym przykładzie ciąg jest konwertowany na kod XML:

xml('<name>Sophia Owen</name>')

I zwraca ten wynik XML:

<name>Sophia Owen</name>

Przykład 2

W tym przykładzie tworzona jest wersja XML dla tego ciągu, która zawiera obiekt JSON:

xml(json('{ "name": "Sophia Owen" }'))

I zwraca ten wynik XML:

<name>Sophia Owen</name>

Przykład 3

Załóżmy, że masz ten obiekt JSON:

{
  "person": {
    "name": "Sophia Owen",
    "city": "Seattle"
  }
}

W tym przykładzie tworzony jest kod XML dla ciągu zawierającego ten obiekt JSON:

xml(json('{"person": {"name": "Sophia Owen", "city": "Seattle"}}'))

I zwraca ten wynik XML:

<person>
  <name>Sophia Owen</name>
  <city>Seattle</city>
<person>

Przykład 4

Funkcja xml() oczekuje obiektu lub ciągu zawierającego prawidłowy kod XML. Funkcja nie akceptuje nieprzetworzonej tablicy jako danych wejściowych.

Jeśli dane są ciągiem JSON, możesz użyć json() funkcji , aby przekonwertować ciąg na obiekt JSON przed przekazaniem wyniku do xml() funkcji, na przykład:

xml(
  json('{"root":{"array":[
    { "ID": 1, "Name": "James" },
    { "ID": 2, "Name": "John" },
    { "ID": 3, "Name": "Sam" }
  ]}}')
)

Jeśli masz tablicę JSON, podobnie jak w poniższym przykładzie, masz trzy opcje.

[
  { "ID": 1, "Name": "James" },
  { "ID": 2, "Name": "John" },
  { "ID": 3, "Name": "Sam" }
]

Opcja 1. Zapisz tablicę JSON w akcji Redaguj o nazwie Compose1. Następnie użyj funkcji , outputs() aby zwrócić obiekt JSON z compose1.

{
  "root": { "array": @{outputs('Compose1')} }
}

Zapisz zwrócony obiekt JSON w innej akcji o nazwie Compose2. Następnie możesz użyć xml() funkcji i outputs() , aby utworzyć kod XML na podstawie danych wyjściowych obiektu JSON z pliku Compose2, na przykład:

xml(outputs('Compose2'))

Opcja 2. Zapisz tablicę JSON w akcji Redaguj o nazwie Compose1. Następnie użyj outputs()funkcji , concat(), json()i xml() , aby utworzyć kod XML na podstawie danych wyjściowych obiektu JSON, na przykład:

xml(
  json(
    concat(
      '{"root":{"array":',
      outputs('Compose1'),
      '}}'
    )
  )
)

Opcja 3. Zapisz tablicę JSON w akcji Redaguj o nazwie Compose1. Następnie możesz użyć outputs()funkcji , json(), addProperty()i xml() do utworzenia kodu XML na podstawie danych wyjściowych obiektu JSON, na przykład:

xml(
  addProperty(
    json('{}'),
    'root',
    addProperty(
      json('{}'),
      'array',
      outputs('Compose1')
    )
  )
)

Wszystkie przykłady, które obejmują przykład danych ciągu JSON i opcje od 1 do 3, zwracają następujący wynik XML:

<root>
  <array>
    <ID>1</ID>
    <Name>James</Name>
  </array>
  <array>
    <ID>2</ID>
    <Name>John</Name>
  </array>
  <array>
    <ID>3</ID>
    <Name>Sam</Name>
  </array>
</root>

xpath

Sprawdź kod XML dla węzłów lub wartości, które są zgodne z wyrażeniem XPath (XML Path Language) i zwraca pasujące węzły lub wartości. Wyrażenie XPath lub po prostu "XPath" ułatwia nawigowanie po strukturze dokumentu XML, dzięki czemu można wybrać węzły lub wartości obliczeniowe w zawartości XML.

Note

W przypadku aplikacji logiki Consumption i Standard wszystkie wyrażenia funkcji używają biblioteki .NET XPath. Wyrażenia XPath są zgodne z podstawową biblioteką .NET i obsługują tylko wyrażenie obsługiwane przez podstawową bibliotekę .NET.

xpath('<xml>', '<xpath>')
Parameter Required Typ Description
< XML> Yes Any Ciąg XML do wyszukiwania węzłów lub wartości pasujących do wartości wyrażenia XPath
< xpath> Yes Any Wyrażenie XPath używane do znajdowania pasujących węzłów XML lub wartości
Wartość zwracana Typ Description
< xml-node> XML Węzeł XML, gdy tylko jeden węzeł jest zgodny z określonym wyrażeniem XPath
< wartość> Any Wartość z węzła XML, gdy tylko jedna wartość jest zgodna z określonym wyrażeniem XPath
[<xml-node1>, <xml-node2>, ...] -lub- [<value1>, <value2>, ...] Array Tablica z węzłami XML lub wartościami zgodnymi z określonym wyrażeniem XPath

Przykład 1

Załóżmy, że masz ten 'items' ciąg XML:

<?xml version="1.0"?>
<produce>
  <item>
    <name>Gala</name>
    <type>apple</type>
    <count>20</count>
  </item>
  <item>
    <name>Honeycrisp</name>
    <type>apple</type>
    <count>10</count>
  </item>
</produce>

Ten przykład przekazuje wyrażenie XPath, '/produce/item/name/text()', aby znaleźć węzły pasujące <name></name> do węzła w 'items' ciągu XML i zwraca tablicę z tymi wartościami węzłów:

xpath(xml(parameters('items')), '/produce/item/name/text()')

W przykładzie użyto również funkcji parameters(), aby pobrać ciąg XML z 'items' i przekonwertować ciąg na format XML przy użyciu funkcji xml().

Oto tablica wyników wypełniona wartościami węzłów, które pasują do <name></name>elementu :

[ Gala, Honeycrisp ]

Przykład 2

W przykładzie 1 ten przykład przekazuje wyrażenie XPath , '/produce/item/name[1]'aby znaleźć pierwszy name element, który jest elementem podrzędnym item elementu.

xpath(xml(parameters('items')), '/produce/item/name[1]')

Oto wynik: Gala

Przykład 3

W przykładzie 1 ten przykład przekazuje wyrażenie XPath, '/produce/item/name[last()]', aby znaleźć ostatni name element, który jest elementem podrzędnym item elementu.

xpath(xml(parameters('items')), '/produce/item/name[last()]')

Oto wynik: Honeycrisp

Przykład 4

W tym przykładzie załóżmy, że ciąg items XML zawiera również atrybuty i expired='true'expired='false':

<?xml version="1.0"?>
<produce>
  <item>
    <name expired='true'>Gala</name>
    <type>apple</type>
    <count>20</count>
  </item>
  <item>
    <name expired='false'>Honeycrisp</name>
    <type>apple</type>
    <count>10</count>
  </item>
</produce>

Ten przykład przekazuje wyrażenie XPath , '//name[@expired]'aby znaleźć wszystkie name elementy, które mają expired atrybut:

xpath(xml(parameters('items')), '//name[@expired]')

Oto wynik: [ Gala, Honeycrisp ]

Przykład 5

W tym przykładzie załóżmy, że ciąg items XML zawiera tylko ten atrybut: expired = 'true'

<?xml version="1.0"?>
<produce>
  <item>
    <name expired='true'>Gala</name>
    <type>apple</type>
    <count>20</count>
  </item>
  <item>
    <name>Honeycrisp</name>
    <type>apple</type>
    <count>10</count>
  </item>
</produce>

Ten przykład przekazuje wyrażenie XPath, '//name[@expired = 'true']', aby znaleźć wszystkie name elementy, które mają atrybut , expired = 'true':

xpath(xml(parameters('items')), '//name[@expired = 'true']')

Oto wynik: [ Gala ]

Przykład 6

W tym przykładzie załóżmy, że ciąg items XML zawiera również następujące atrybuty:

  • expired='true' price='12'
  • expired='false' price='40'
<?xml version="1.0"?>
<produce>
  <item>
    <name expired='true' price='12'>Gala</name>
    <type>apple</type>
    <count>20</count>
  </item>
  <item>
    <name expired='false' price='40'>Honeycrisp</name>
    <type>apple</type>
    <count>10</count>
  </item>
</produce>

Ten przykład przekazuje wyrażenie XPath, '//name[@price>35]', aby znaleźć wszystkie name elementy, które mają price > 35:

xpath(xml(parameters('items')), '//name[@price>35]')

Oto wynik: Honeycrisp

Przykład 7

W tym przykładzie załóżmy, że ciąg items XML jest taki sam jak w przykładzie 1:

<?xml version="1.0"?>
<produce>
  <item>
    <name>Gala</name>
    <type>apple</type>
    <count>20</count>
  </item>
  <item>
    <name>Honeycrisp</name>
    <type>apple</type>
    <count>10</count>
  </item>
</produce>

W tym przykładzie znajdują węzły pasujące do węzła <count></count> i dodaje te wartości węzła sum() do funkcji :

xpath(xml(parameters('items')), 'sum(/produce/item/count)')

Oto wynik: 30

Przykład 8

W tym przykładzie załóżmy, że masz ten ciąg XML, który zawiera przestrzeń nazw dokumentów XML, xmlns="https://contoso.com":

<?xml version="1.0"?><file xmlns="https://contoso.com"><location>Paris</location></file>

Te wyrażenia używają wyrażenia /*[name()="file"]/*[name()="location"] XPath lub /*[local-name()="file" and namespace-uri()="https://contoso.com"]/*[local-name()="location"], aby znaleźć węzły zgodne z węzłem <location></location> . W poniższych przykładach pokazano składnię używaną w projektancie lub w edytorze wyrażeń:

  • xpath(xml(body('Http')), '/*[name()="file"]/*[name()="location"]')
  • xpath(xml(body('Http')), '/*[local-name()="file" and namespace-uri()="https://contoso.com"]/*[local-name()="location"]')

Oto węzeł wyników zgodny z węzłem <location></location> :

<location xmlns="https://contoso.com">Paris</location>

Important

Jeśli pracujesz w widoku kodu, należy użyć podwójnego cudzysłowu (") przy użyciu znaku ukośnika odwrotnego (\). Na przykład należy użyć znaków ucieczki podczas serializacji wyrażenia jako ciągu JSON. Jeśli jednak pracujesz w projektancie lub edytorze wyrażeń, nie musisz unikać podwójnego cudzysłowu, ponieważ znak ukośnika odwrotnego jest dodawany automatycznie do podstawowej definicji, na przykład:

  • Widok kodu: xpath(xml(body('Http')), '/*[name()=\"file\"]/*[name()=\"location\"]')

  • Edytor wyrażeń: xpath(xml(body('Http')), '/*[name()="file"]/*[name()="location"]')

Przykład 9

W przykładzie 8 w tym przykładzie użyto wyrażenia XPath , 'string(/*[name()="file"]/*[name()="location"])'aby znaleźć wartość w węźle <location></location> :

xpath(xml(body('Http')), 'string(/*[name()="file"]/*[name()="location"])')

Oto wynik: Paris

Dalsze kroki

Dowiedz się więcej o języku definicji przepływu pracy