Azure Logic Apps と Power Automate のワークフローの式の関数のリファレンス ガイド

適用対象: Azure Logic Apps (従量課金 + 標準)

Azure Logic Apps および Power Automate のワークフロー定義では、ワークフローの実行開始時にまだ存在しない可能性のある実行時アクションから値を取得する式があります。 To reference or process the values in these expressions, you can use expression functions provided by the Workflow Definition Language.

For example, you can calculate values by using math functions, such as the add() function, when you want the sum from integers or floats. 関数を使用して実行できるタスクの他の例を示します。

一般的な目的に基づいて関数を見つけるには、次の表を確認します。 Or, for detailed information about each function, see the alphabetical list.

式の関数

To show how to use a function in an expression, this example shows how you can get the value from the customerName parameter and assign that value to the accountName property by using the parameters() function in an expression:

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

式で関数を使用できる他の一般的な方法を次に示します。

たとえば、concat() 関数はパラメーターとして 2 つ以上の文字列値を受け取ることができます。 この関数は、これらの文字列を 1 つの文字列に結合します。 たとえば "Sophia" と "Owen" のような文字列リテラルを渡して、結合された文字列 "SophiaOwen" を取得できます。

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

または、パラメーターから文字列値を取得することができます。 次の例では、各 parameters() パラメーターおよび concat() パラメーターと firstName パラメーターで、lastName 関数を使っています。 その後、結果の文字列を concat() 関数に渡して、結合された文字列 ("SophiaOwen" など) を取得します。

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

どちらの例でも、customerName プロパティに結果を割り当てています。

関数の使用に関する考慮事項

• デザイナーは、デザイン時に関数パラメーターとして使用されるランタイム式を評価しません。 デザイナーでは、すべての式をデザイン時に完全に評価できる必要があります。

• 関数パラメーターは、左から右に評価されます。

• パラメーターの定義の構文において、パラメーターの後に疑問符 (?) が付いている場合は、そのパラメーターが省略可能であることを意味します。 For example, see getFutureTime().

• プレーンテキストでインラインで表示される関数式では、代わりに式の補間形式を使用するために中かっこ ({}) を囲む必要があります。 この形式は、解析の問題を回避するのに役立ちます。 関数式がプレーン テキストでインラインで表示されない場合は、中かっこは必要ありません。

  次の例は、正しい構文と正しくない構文を示しています。

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

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

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

The following sections organize functions based on their general purpose, or you can browse these functions in alphabetical order.

String functions

To work with strings, you can use these string functions and also some collection functions. 文字列関数は、文字列でのみ機能します。

Collection functions

コレクション(一般に配列、文字列、場合によっては辞書)を操作するには、これらのコレクション関数を使用できます。

論理比較関数

条件を操作したり、値と式の結果を比較したり、さまざまな種類のロジックを評価したりするには、これらの論理比較関数を使用できます。 For the full reference about each function, see the alphabetical list.

Conversion functions

値の型または形式を変更するには、これらの変換関数を使用できます。 たとえば、値をブール値から整数に変更できます。 Azure Logic Apps が変換時にコンテンツ タイプを処理する方法の詳細については、「コンテンツ タイプを処理する」を参照してください。 For the full reference about each function, see the alphabetical list.

暗黙的なデータ型の変換

Azure Logic Apps を使用すると、一部のデータ型間の変換が自動的または暗黙的に行われるため、これらの変換を手動で行う必要はありません。 たとえば、入力として文字列が想定されている場所で文字列以外の値を使用すると、Azure Logic Apps によって文字列以外の値が文字列に自動的に変換されます。

たとえば、トリガーから出力として数値が返されるとします。

triggerBody()?['123']

URL などの文字列入力が想定されている場所でこの数値出力を使用する場合、Azure Logic Apps によって中かっこ ({}) 表記を使用して値が文字列に自動的に変換されます。

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

Base64 のエンコードとデコード

Azure Logic Apps を使用すると、base64 エンコードまたはデコードが自動的または暗黙的に実行されるため、対応する関数を使用してこれらの変換を手動で実行する必要はありません。

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

Math functions

整数と浮動小数点数を操作するには、以下の算術関数を使用できます。 For the full reference about each function, see the alphabetical list.

日付と時刻関数

日付と時刻を操作するには、以下の日付と時刻の関数を使用できます。 For the full reference about each function, see the alphabetical list.

Workflow functions

以下のワークフロー関数を使うと次のことができます。

• 実行時にワークフロー インスタンスの詳細を取得します。
• ロジック アプリまたはフローのインスタンス化に使われた入力を処理します。
• トリガーやアクションからの出力を参照します。

たとえば、あるアクションからの出力を参照し、後のアクションでそのデータを使用できます。 For the full reference about each function, see the alphabetical list.

URI 解析関数

URI (Uniform Resource Identifier) を処理して、URI のさまざまなプロパティ値を取得します。以下の URI 解析関数を使用できます。 For the full reference about each function, see the alphabetical list.

操作関数: JSON と XML

JSON オブジェクトと XML ノードを処理するには、以下の操作関数を使用できます。 For the full reference about each function, see the alphabetical list.

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

すべての関数 - アルファベット順の一覧

このセクションでは、使用可能なすべての関数をアルファベット順に示します。

A

アクション

Return the current action's output at runtime, or values from other JSON name-and-value pairs, which you can assign to an expression. 既定では、この関数はアクション オブジェクト全体を参照しますが、必要に応じて値を取得するプロパティを指定することができます。 See also actions().

action() 関数は、次の場所でのみ使うことができます。

• 元の unsubscribe 要求の結果にアクセスできるように、webhook アクションの subscribe プロパティ
• アクションの trackedProperties プロパティ
• アクションの do-until ループ条件

action()
action().outputs.body.<property>

actions

実行時のアクションの出力を返すか、または式に割り当てることができる他の JSON の名前と値のペアの値を返します。 既定では、この関数はアクション オブジェクト全体を参照しますが、必要に応じて値を取得するプロパティを指定することができます。 For shorthand versions, see body(). For the current action, see action().

actions('<actionName>')
actions('<actionName>').outputs.body.<property>

Example

この例は、実行時に X アクション status から Get user プロパティの値を取得します。

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

次の結果が返されます。 "Succeeded"

add

2 つの数値を加算した結果を返します。

add(<summand_1>, <summand_2>)

Example

この例は、指定した数値を加算します。

add(1, 1.5)

次の結果が返されます。 2.5

addDays

タイムスタンプに日数を加算します。

addDays('<timestamp>', <days>, '<format>'?)

Example 1

この例は、指定したタイムスタンプに 10 日を加算します。

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

次の結果が返されます。 "2018-03-25T00:00:00.0000000Z"

Example 2

この例は、指定したタイムスタンプから 5 日を減算します。

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

次の結果が返されます。 "2018-03-10T00:00:00.0000000Z"

addHours

タイムスタンプに時間を加算します。

addHours('<timestamp>', <hours>, '<format>'?)

Example 1

この例は、指定したタイムスタンプに 10 時間を加算します。

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

次の結果が返されます。 "2018-03-15T10:00:00.0000000Z"

Example 2

この例は、指定したタイムスタンプから 5 時間を減算します。

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

次の結果が返されます。 "2018-03-15T10:00:00.0000000Z"

addMinutes

タイムスタンプに分を加算します。

addMinutes('<timestamp>', <minutes>, '<format>'?)

Example 1

この例は、指定したタイムスタンプに 10 分を加算します。

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

次の結果が返されます。 "2018-03-15T00:20:00.0000000Z"

Example 2

この例は、指定したタイムスタンプから 5 分を減算します。

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

次の結果が返されます。 "2018-03-15T00:15:00.0000000Z"

addProperty

JSON オブジェクトにプロパティとその値 (名前と値のペア) を追加し、更新されたオブジェクトを返します。 実行時にプロパティが既に存在する場合、関数は失敗し、エラーをスローします。

addProperty(<object>, '<property>', <value>)

親プロパティを既存のプロパティに追加するには、setProperty() 関数ではなく、addProperty() 関数を使用します。 それ以外の場合、関数は子オブジェクトだけを出力として返します。

setProperty(<object>, '<parent-property>', addProperty(<object>['<parent-property>'], '<child-property>', <value>)

Example 1

This example adds the middleName property to a JSON object, which is converted from a string to JSON by using the JSON() function. このオブジェクトには、プロパティ firstName と surName が既に含まれています。 この関数は、指定された値を新しいプロパティに割り当て、更新されたオブジェクトを返します。

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

現在の JSON オブジェクトを次に示します。

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

更新された JSON オブジェクトを次に示します。

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

Example 2

This example adds the middleName child property to the existing customerName property in a JSON object, which is converted from a string to JSON by using the JSON() function. この関数は、指定された値を新しいプロパティに割り当て、更新されたオブジェクトを返します。

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

現在の JSON オブジェクトを次に示します。

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

更新された JSON オブジェクトを次に示します。

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

addSeconds

タイムスタンプに秒を加算します。

addSeconds('<timestamp>', <seconds>, '<format>'?)

Example 1

この例は、指定したタイムスタンプに 10 秒を加算します。

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

次の結果が返されます。 "2018-03-15T00:00:10.0000000Z"

Example 2

この例は、指定したタイムスタンプから 5 秒を減算します。

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

次の結果が返されます。 "2018-03-15T00:00:25.0000000Z"

addToTime

タイムスタンプに指定した時間単位を加算します。 See also getFutureTime().

addToTime('<timestamp>', <interval>, '<timeUnit>', '<format>'?)

Example 1

この例は、指定したタイムスタンプに 1 日を加算します。

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

次の結果が返されます。 "2018-01-02T00:00:00.0000000Z"

Example 2

この例は、指定したタイムスタンプに 1 日を加算します。

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

省略可能な "D" 形式を使用して返される結果: "Tuesday, January 2, 2018"

and

すべての式が true かどうかを確認します。 すべての式が true の場合は true を返し、少なくとも 1 つの式が false の場合は false を返します。

and(<expression1>, <expression2>, ...)

Example 1

これらの例は、指定したブール値がすべて true かどうかを調べます。

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

次の結果を返します。

• 最初の例: どちらの式も true であるため、 trueを返します。
• 2 番目の例: 1 つの式が false であるため、 falseを返します。
• 3 番目の例:両方の式が false なので、false を返します。

Example 2

これらの例は、指定した式がすべて true かどうかを調べます。

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

次の結果を返します。

• 最初の例: どちらの式も true であるため、 trueを返します。
• 2 番目の例: 1 つの式が false であるため、 falseを返します。
• 3 番目の例:両方の式が false なので、false を返します。

アレイ

指定した 1 つの入力から配列を返します。 For multiple inputs, see createArray().

array('<value>')

Example

この例は、"hello" という文字列から配列を作成します。

array('hello')

次の結果が返されます。 ["hello"]

B

base64

文字列の base64 エンコード バージョンを返します。

base64('<value>')

Example

この例は、"hello" という文字列を base64 エンコード文字列に変換します。

base64('hello')

次の結果が返されます。 "aGVsbG8="

base64ToBinary

base64 エンコード文字列のバイナリ バージョンを返します。

base64ToBinary('<value>')

Example

この例は、"aGVsbG8=" という base64 エンコード文字列をバイナリ文字列に変換します。

base64ToBinary('aGVsbG8=')

たとえば、HTTP アクションを使用して要求を送信しているとします。 base64 でエンコードされた文字列を base64ToBinary() でバイナリ データに変換し、要求でそのデータをコンテンツ タイプ application/octet-stream を使用して送信できます。

base64ToString

base64 エンコード文字列の文字列バージョンを返し、実質的に base64 の文字列をデコードします。 Use this function rather than decodeBase64(), which is deprecated.

base64ToString('<value>')

Example

この例は、"aGVsbG8=" という base64 エンコード文字列を単なる文字列に変換します。

base64ToString('aGVsbG8=')

次の結果が返されます。 "hello"

binary

文字列の base64 エンコード バイナリ バージョンを返します。

binary('<value>')

Example

たとえば、画像またはビデオ ファイルを返す HTTP アクションを使用している場合です。 binary() を使用して、値を base-64 でエンコードされたコンテンツ エンベロープ モデルに変換できます。 その後、Compose などの他のアクションでコンテンツ エンベロープを再利用できます。 この関数式を使用し、要求でコンテンツ タイプ application/octet-stream の文字列バイトを送信できます。

body

実行時のアクションの body 出力を返します。 actions('<actionName>').outputs.body の短縮形です。 See actions().

body('<actionName>')

Example

この例は、X アクション body からの Get user 出力を取得します。

body('Get_user')

返される結果:

"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

値のブールバージョンを返します。

bool(<value>)

オブジェクトで bool() を使用している場合、オブジェクトの値はブール値に変換できる文字列か整数にする必要があります。

Outputs

これらの例では、bool() で入力がサポートされているさまざまな種類を示しています。

C

chunk

文字列または配列を等しい長さのチャンクに分割します。

chunk('<collection>', '<length>')
chunk([<collection>], '<length>')

Example 1

次の例は、文字列を長さ 10 のチャンクに分割します。

chunk('abcdefghijklmnopqrstuvwxyz', 10)

次の結果が返されます。 ['abcdefghij', 'klmnopqrst', 'uvwxyz']

Example 2

次の例は、配列を長さ 5 のチャンクに分割します。

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

次の結果が返されます。 [ [1,2,3,4,5], [6,7,8,9,10], [11,12] ]

結合する

1 つ以上のパラメーターから最初の null 以外の値を返します。 空の文字列、空の配列、空のオブジェクトは null ではありません。

coalesce(<object_1>, <object_2>, ...)

Example

これらの例は、指定した値から最初の null 以外の値を返し、すべての値が null のときは null を返します。

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

次の結果を返します。

• 最初の例: true
• 2 番目の例: "hello"
• 3 番目の例: null

concat

2 つ以上の文字列を結合し、結合された文字列を返します。

concat('<text1>', '<text2>', ...)

Example

この例は、文字列 "Hello" と "World" を結合します。

concat('Hello', 'World')

次の結果が返されます。 "HelloWorld"

contains

コレクションに特定の項目があるかどうかを確認します。 アイテムが見つかった場合は true を返し、見つからない場合は false を返します。 この関数では大文字と小文字が区別されます。

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

具体的には、この関数は次のコレクション型で動作します。

• A string to find a substring
• An array to find a value
• A dictionary to find a key

Example 1

この例は、文字列 "hello world" で部分文字列 "world" を調べて、true を返します。

contains('hello world', 'world')

Example 2

この例は、文字列 "hello world" で部分文字列 "universe" を調べて、false を返します。

contains('hello world', 'universe')

convertFromUtc

タイムスタンプを協定世界時 (UTC) からターゲット タイム ゾーンに変換します。

convertFromUtc('<timestamp>', '<destinationTimeZone>', '<format>'?)

Example 1

この例は、タイムスタンプを指定したタイム ゾーンに変換します。

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

次の結果が返されます。 "2018-01-01T00:00:00.0000000"

Example 2

この例は、タイムスタンプを指定したタイム ゾーンに変換して形式を設定します。

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

次の結果が返されます。 "Monday, January 1, 2018"

convertTimeZone

タイムスタンプをソース タイム ゾーンからターゲット タイム ゾーンに変換します。

convertTimeZone('<timestamp>', '<sourceTimeZone>', '<destinationTimeZone>', '<format>'?)

Example 1

この例は、ソース タイム ゾーンをターゲット タイム ゾーンに変換します。

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

次の結果が返されます。 "2018-01-01T00:00:00.0000000"

Example 2

この例は、タイム ゾーンを指定したタイム ゾーンに変換して形式を設定します。

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

次の結果が返されます。 "Monday, January 1, 2018"

convertToUtc

タイムスタンプをソース タイム ゾーンから協定世界時 (UTC) に変換します。

convertToUtc('<timestamp>', '<sourceTimeZone>', '<format>'?)

Example 1

この例は、タイムスタンプを UTC に変換します。

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

次の結果が返されます。 "2018-01-01T08:00:00.0000000Z"

Example 2

この例は、タイムスタンプを UTC に変換します。

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

次の結果が返されます。 "Monday, January 1, 2018"

createArray

複数の入力から配列を返します。 For single input arrays, see array().

createArray('<object1>', '<object2>', ...)

Example

この例は、以下の入力から配列を作成します。

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

次の結果が返されます。 ["h", "e", "l", "l", "o"]

D

dataUri

文字列のデータ URI (Uniform Resource Identifier) を返します。

dataUri('<value>')

Example

この例は、"hello" という文字列に対する URI を作成します。

dataUri('hello')

次の結果が返されます。 "data:text/plain;charset=utf-8;base64,aGVsbG8="

dataUriToBinary

データ URI (Uniform Resource Identifier) のバイナリ バージョンを返します。 Use this function rather than decodeDataUri(). どちらの関数も機能は同じですが、dataUriBinary() をお勧めします。

dataUriToBinary('<value>')

Example

この例は、次のデータ URI のバイナリ バージョンを作成します。

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

返される結果:

"01100100011000010111010001100001001110100111010001100101011110000111010000101111011100000 1101100011000010110100101101110001110110110001101101000011000010111001001110011011001010111 0100001111010111010101110100011001100010110100111000001110110110001001100001011100110110010 10011011000110100001011000110000101000111010101100111001101100010010001110011100000111101"

dataUriToString

データ URI (Uniform Resource Identifier) の文字列バージョンを返します。

dataUriToString('<value>')

Example

この例は、次のデータ URI の文字列を作成します。

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

次の結果が返されます。 "hello"

dateDifference

2 つのタイムスタンプの差をタイムスパンとして返します。 この関数は、startDate から endDate を引き、文字列形式のタイムスタンプとして結果を返します。

dateDifference('<startDate>', '<endDate>')

Example

この例は、2 番目の値から最初の値を引きます。

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

次の結果が返されます。 "1268.00:00:00"

dayOfMonth

タイムスタンプから月の日を返します。

dayOfMonth('<timestamp>')

Example

この例は、次のタイムスタンプから月の日付を返します。

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

次の結果が返されます。 15

dayOfWeek

タイムスタンプから曜日を返します。

dayOfWeek('<timestamp>')

Example

この例は、次のタイムスタンプから曜日を返します。

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

次の結果が返されます。 4

dayOfYear

タイムスタンプから年の日を返します。

dayOfYear('<timestamp>')

Example

この例は、次のタイムスタンプから年の何日目かを返します。

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

次の結果が返されます。 74

10 進

文字列内の 10 進数を 10 進数として返します。 この関数は 10 進数の有効桁数を必要とするデータで作業しているとき使用できますが、論理比較関数や算術関数の入力として使用することもできます。 To capture and preserve precision when you use the result from the decimal() function, wrap any decimal output with the string function. この使用法を次の例で示します。10 進数の結果を数値として使用すると、有効桁数が失われる可能性があります。

decimal('<value>')

Example 1

この例では、数値として使用される 10 進数を作成します。

decimal('1.2345678912312131') // Returns 1.234567891231213.

Example 2

この例では 10 進数を作成して、結果を文字列に変換することで精度を維持します。

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

Example 3

この例では、算術関数を 2 つの 10 進数で使用して、結果を数値として使用します。

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

Example 4

この例では、算術関数を 2 つの 10 進数で使用して、結果を文字列に変換することで精度を維持します。

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

decodeBase64 (deprecated)

This function is deprecated, so use base64ToString() instead.

decodeDataUri

データ URI (Uniform Resource Identifier) のバイナリ バージョンを返します。 Consider using dataUriToBinary(), rather than decodeDataUri(). どちらの関数も機能は同じですが、dataUriToBinary() をお勧めします。

decodeDataUri('<value>')

Example

この例は、次のデータ URI のバイナリ バージョンを返します。

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

次の結果が返されます。 "hello"

decodeUriComponent

エスケープ文字をデコード バージョンに置き換えた文字列を返します。

decodeUriComponent('<value>')

Example

この例は、次の文字列内のエスケープ文字をデコード バージョンに置き換えます。

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

次の結果が返されます。 "https://contoso.com"

div

2 つの数値を除算した結果を返します。 To get the remainder result, see mod().

div(<dividend>, <divisor>)

Example 1

どちらの例も、整数型の値 2 を返します

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

Example 2

どちらの例も、float 型の値 2.2 を返します

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

E

encodeUriComponent

URL の安全でない文字がエスケープ文字に置き換えられた、文字列の URI (Uniform Resource Identifier) エンコード バージョンを返します。 Consider using uriComponent(), rather than encodeUriComponent(). どちらの関数も機能は同じですが、uriComponent() をお勧めします。

encodeUriComponent('<value>')

Example

この例は、次の文字列の URI エンコード バージョンを作成します。

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

次の結果が返されます。 "https%3A%2F%2Fcontoso.com"

empty

コレクションが空かどうかを調べます。 コレクションが空の場合は true を返し、空でない場合は false を返します。

empty('<collection>')
empty([<collection>])

Example

これらの例は、指定したコレクションが空かどうかを調べます。

empty('')
empty('abc')

次の結果を返します。

• 1 番目の例:空の文字列を渡しているので、関数は true を返します。
• 2 番目の例:文字列 "abc" を渡しているので、関数は false を返します。

endsWith

文字列が特定の部分文字列で終わるかどうかを確認します。 部分文字列が見つかった場合は true を返し、見つからない場合は false を返します。 この関数は、大文字と小文字を区別しません。

endsWith('<text>', '<searchText>')

Example 1

次の使用例は、"hello world" 文字列が "world" 文字列で終わるかどうかを確認します。

endsWith('hello world', 'world')

次の結果が返されます。 true

Example 2

この例では、"hello world" 文字列が "universe" 文字列で終わるかどうかを確認します。

endsWith('hello world', 'universe')

次の結果が返されます。 false

equals

値、式、またはオブジェクトの両方が等しいかどうかを確認します。 両方が同等の場合は true を返し、同等でない場合は false を返します。

equals('<object1>', '<object2>')

Example

これらの例では、指定した入力が等価であるかどうかをチェックします。

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

次の結果を返します。

• 最初の例: 両方の値が等価であるため、関数は trueを返します。
• 2 番目の例: 両方の値は同等ではありません。そのため、関数は falseを返します。

F

first

文字列または配列から最初の項目を返します。

first('<collection>')
first([<collection>])

Example

これらの例は、以下のコレクション内の最初の項目を検索します。

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

次の結果を返します。

• 最初の例: "h"
• 2 番目の例: 0

float

浮動小数点数の文字列バージョンを実際の浮動小数点数に変換します。 この関数は、ロジック アプリ ワークフローや Power Automate フローなど、アプリにカスタム パラメーターを渡す場合にのみ使用できます。 ロケール固有の形式で表される浮動小数点文字列を変換するには、必要に応じて RFC 4646 ロケール コードを指定できます。

float('<value>', '<locale>'?)

Example 1

この例は、次の浮動小数点数の文字列バージョンを作成します。

float('10,000.333')

次の結果が返されます。 10000.333

Example 2

次の例は、次のドイツ語形式の浮動小数点数の文字列バージョンを作成します。

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

次の結果が返されます。 10000.333

formatDateTime

指定した形式のタイムスタンプを返します。

formatDateTime('<timestamp>', '<format>'?, '<locale>'?)

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

Return an array with values that match a key name in an action's form-data or form-encoded output.

formDataMultiValues('<actionName>', '<key>')

Example

この例は、指定したアクションの form-data 出力または form-encoded 出力内の "Subject" キーの値から配列を作成します。

formDataMultiValues('Send_an_email', 'Subject')

配列で件名のテキストを返します (例: ["Hello world"])

formDataValue

Return a single value that matches a key name in an action's form-data or form-encoded output. 複数の一致が見つかった場合、関数はエラーをスローします。

formDataValue('<actionName>', '<key>')

Example

この例は、指定したアクションの form-data 出力または form-encoded 出力内の "Subject" キーの値から文字列を作成します。

formDataValue('Send_an_email', 'Subject')

文字列として件名のテキストを返します (例: "Hello world")

formatNumber

指定された形式に基づいた文字列として数値を返します。

formatNumber(<number>, <format>, <locale>?)

Example 1

数値 1234567890 の形式を設定するとします。 この例では、この数値の形式を文字列 "1,234,567,890.00" として設定します。

formatNumber(1234567890, '0,0.00', 'en-us')

*Example 2"

数値 1234567890 の形式を設定するとします。 この例では、数値の形式を文字列 "1.234.567.890,00" に設定します。

formatNumber(1234567890, '0,0.00', 'is-is')

Example 3

数値 17.35 の形式を設定するとします。 この例では、数値の形式を文字列 "$17.35" に設定します。

formatNumber(17.35, 'C2')

Example 4

数値 17.35 の形式を設定するとします。 この例では、数値の形式を文字列 "17,35 kr" に設定します。

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

G

getFutureTime

現在のタイムスタンプと指定した時間単位を返します。

getFutureTime(<interval>, <timeUnit>, <format>?)

Example 1

現在のタイムスタンプが "2018-03-01T00:00:00.0000000Z" であるものとします。 この例は、そのタイムスタンプに 5 日を加算します。

getFutureTime(5, 'Day')

次の結果が返されます。 "2018-03-06T00:00:00.0000000Z"

Example 2

現在のタイムスタンプが "2018-03-01T00:00:00.0000000Z" であるものとします。 この例は、5 日を加算して、結果を "D" 形式に変換します。

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

次の結果が返されます。 "Tuesday, March 6, 2018"

getPastTime

現在のタイムスタンプから指定した時間単位を引いた値を返します。

getPastTime(<interval>, <timeUnit>, <format>?)

Example 1

現在のタイムスタンプが "2018-02-01T00:00:00.0000000Z" であるものとします。 この例は、そのタイムスタンプから 5 日を減算します。

getPastTime(5, 'Day')

次の結果が返されます。 "2018-01-27T00:00:00.0000000Z"

Example 2

現在のタイムスタンプが "2018-02-01T00:00:00.0000000Z" であるものとします。 この例は、5 日を減算して、結果を "D" 形式に変換します。

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

次の結果が返されます。 "Saturday, January 27, 2018"

greater

最初の値が 2 番目の値より大きいかどうかを確認します。 最初の値が多い場合は true を返し、小さい場合は false を返します。

greater(<value>, <compareTo>)
greater('<value>', '<compareTo>')

Example

次の例では、最初の値が 2 番目の値より大きいかどうかをチェックします。

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

次の結果を返します。

• 最初の例: true
• 2 番目の例: false

greaterOrEquals

最初の値が 2 番目の値以上かどうかを確認します。 最初の値が大きいか等しい場合は true を返し、最初の値が小さい場合は false を返します。

greaterOrEquals(<value>, <compareTo>)
greaterOrEquals('<value>', '<compareTo>')

Example

これらの例では、最初の値が 2 番目の値より大きいか等しいかをチェックします。

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

次の結果を返します。

• 最初の例: true
• 2 番目の例: false

guid

グローバル一意識別子 (GUID) を文字列として生成します (例: "c2ecc88d-88c8-4096-912c-d6f2e2b138ce")。

guid()

既定の "D" 形式 (ハイフンで区切られた 32 桁) 以外の GUID 形式を指定することもできます。

guid('<format>')

Example

この例は同じ GUID を生成しますが、32 桁で、ハイフンによって区切られており、かっこで囲まれています。

guid('P')

次の結果が返されます。 "(c2ecc88d-88c8-4096-912c-d6f2e2b138ce)"

I

if

式が true か false かを確認します。 結果に基づいて、指定した値を返します。 パラメーターは左から右へ評価されます。

if(<expression>, <valueIfTrue>, <valueIfFalse>)

Example

この例は、指定した式が true を返すため "yes" を返します。 それ以外の場合、この例は "no" を返します。

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

indexOf

部分文字列の開始位置またはインデックス値を返します。 この関数は大文字と小文字を区別せず、インデックスは値 0 から始まります。

indexOf('<text>', '<searchText>')

Example

この例は、文字列 "hello world" 内で部分文字列 "world" の開始インデックス値を検索します。

indexOf('hello world', 'world')

次の結果が返されます。 6

int

整数の文字列バージョンを実際の整数値に変換します。

int('<value>')

Example

この例は、文字列 "10" の整数バージョンを作成します。

int('10')

次の結果が返されます。 10

isFloat

文字列が浮動小数点数かどうかを示すブール値を返します。 既定では、この関数は浮動小数点形式にインバリアント カルチャを使用します。 他のロケール固有の形式で表される浮動小数点数を識別するため、必要に応じて RFC 4646 ロケール コードを指定できます。

isFloat('<string>', '<locale>'?)

Example 1

次の例は、文字列がインバリアント カルチャの浮動小数点数かどうかを確認します。

isFloat('10,000.00')

次の結果が返されます。 true

Example 2

次の例は、文字列がドイツ語ロケールの浮動小数点数かどうかを確認します。

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

次の結果が返されます。 true

isInt

文字列が整数かどうかを示すブール値を返します。

isInt('<string>')

Example

次の例は、文字列が整数かどうかを確認します。

isInt('10')

次の結果が返されます。 true

項目

配列に対する繰り返しアクションの内部で使うと、アクションの現在の繰り返しの間に配列の現在の項目を返します。 その項目のプロパティから値を取得することもできます。

item()

Example

この例は、for-each ループの現在の繰り返しの内部で "Send_an_email" アクションに対する現在のメッセージから body 要素を取得します。

item().body

items

for-each ループの各サイクルから現在の項目を返します。 この関数は、for-each ループの内部で使います。

items('<loopName>')

Example

この例は、指定した for-each ループから現在の項目を取得します。

items('myForEachLoopName')

iterationIndexes

Until ループ内の現在の繰り返しのインデックス値を返します。 この関数は、入れ子になった Until ループ内で使用できます。

iterationIndexes('<loopName>')

Example

この例では、カウンター変数を作成し、カウンター値が 5 に達するまで、Until ループ内の各繰り返しの間に 1 つずつその変数を増分します。 また、この例では各繰り返しの現在のインデックスを追跡する変数も作成します。 Until ループで、各繰り返しの間にカウンター値を増分し、カウンター値を現在のインデックス値に割り当ててから、カウンター値を増分します。 ループ内で、この例は、iterationIndexes 関数を使用して現在の反復インデックスを参照します。

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

文字列または XML に対する JSON (JavaScript Object Notation) 型の値、オブジェクト、またはオブジェクトの配列を返します。

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

Example 1

この例では、次の文字列を JSON 値に変換します。

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

次の結果が返されます。 [1, 2, 3]

Example 2

この例では、次の文字列を JSON に変換します。

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

返される結果:

{
  "fullName": "Sophia Owen"
}

Example 3

この例では、json() および xml() の各関数を使用して、ルート要素に 1 つの子要素を含む XML を、その子要素に対する person という名前の JSON オブジェクトに変換します。

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

返される結果:

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

Example 4

この例では、json() および xml() の各関数を使用して、ルート要素に複数の子要素を含む XML を、それらの子要素に対する JSON オブジェクトを含む person という名前の配列に変換します。

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>'))

返される結果:

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

intersection

Return a collection that has only the common items across the specified collections. 結果に表示するには、この関数に渡されるすべてのコレクションに項目が含まれている必要があります。 1 つ以上の項目の名前が同じである場合、その名前の最後の項目が結果に表示されます。

intersection([<collection1>], [<collection2>], ...)
intersection('<collection1>', '<collection2>', ...)

Example

この例は、次のすべての配列に共通する項目を検索します。

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

And returns an array with only these items: [1, 2]

参加

Return a string that has all the items from an array and has each character separated by a delimiter.

join([<collection>], '<delimiter>')

Example

この例は、指定した文字で区切られた、次の配列のすべての項目を含む文字列を作成します。

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

次の結果が返されます。 "a.b.c"

L

last

コレクションから最後の項目を返します。

last('<collection>')
last([<collection>])

Example

これらの例は、以下のコレクション内の最後の項目を検索します。

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

次の結果を返します。

• 最初の例: "d"
• 2 番目の例: 3

lastIndexOf

部分文字列の最後の出現箇所の開始位置またはインデックス値を返します。 この関数は大文字と小文字を区別せず、インデックスは値 0 から始まります。

lastIndexOf('<text>', '<searchText>')

文字列または部分文字列の値が空の場合は、以下の動作が発生します。

• 文字列の値のみが空の場合、関数により -1 が返されます。

• 文字列と部分文字列の値がどちらも空の場合、関数により 0 が返されます。

• 部分文字列の値のみが空の場合、関数により文字列の長さから 1 を引いた値が返されます。

Examples

この例では、文字列 world 内の部分文字列 hello world hello world の最後の出現箇所の開始インデックス値を見つけます。 返される結果は 18 です。

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

この例には部分文字列のパラメーターがなく、入力文字列の値 (22) から 1 を引いた値は 0 より大きいため、23 の値が返されます。

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

length

コレクション内の項目の数を返します。

length('<collection>')
length([<collection>])

Example

次の例では、これらのコレクション内の項目の数をカウントします。

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

返される結果: 4

less

最初の値が 2 番目の値より小さいかどうかを確認します。 最初の値が小さい場合は true を返し、最初の値が多い場合は false を返します。

less(<value>, <compareTo>)
less('<value>', '<compareTo>')

Example

これらの例では、最初の値が 2 番目の値より小さいかどうかをチェックします。

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

次の結果を返します。

• 最初の例: true
• 2 番目の例: false

lessOrEquals

最初の値が 2 番目の値以下かどうかを確認します。 最初の値が以下の場合は true を返し、最初の値が多い場合は false を返します。

lessOrEquals(<value>, <compareTo>)
lessOrEquals('<value>', '<compareTo>')

Example

これらの例では、最初の値が 2 番目の値より小さいか等しいかをチェックします。

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

次の結果を返します。

• 最初の例: true
• 2 番目の例: false

listCallbackUrl

トリガーまたはアクションを呼び出す "コールバック URL" を返します。 This function works only with triggers and actions for the HttpWebhook and ApiConnectionWebhook connector types, but not the Manual, Recurrence, HTTP, and APIConnection types.

listCallbackUrl()

Example

この例は、この関数が返すことのあるコールバック URL の例を示します。

"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

両端を含む数値のリストまたは配列から最大の値を返します。

max(<number1>, <number2>, ...)
max([<number1>, <number2>, ...])

Example

これらの例は、数値のセットと配列から最大値を取得します。

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

返される結果: 3

min

数値のセットまたは配列から最小の値を返します。

min(<number1>, <number2>, ...)
min([<number1>, <number2>, ...])

Example

これらの例は、数値のセットと配列で最小の値を取得します。

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

返される結果: 1

mod

2 つの数値を除算した剰余を返します。 To get the integer result, see div().

mod(<dividend>, <divisor>)

Example 1

この例は、1 番目の数値を 2 番目の数値で除算します。

mod(3, 2)

次の結果が返されます。 1

Example 2

この例では、一方または両方の値が負の場合、結果は被除数の符号と一致することを示しています。

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

この例では、次の結果が返されます。

• 最初の例: -1
• 2 番目の例: 1

mul

2 つの数値を乗算した積を返します。

mul(<multiplicand1>, <multiplicand2>)

Example

これらの例は、1 番目の数値と 2 番目の数値を乗算します。

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

次の結果を返します。

• 最初の例: 2
• 2 番目の例: 3

multipartBody

複数の部分を持つアクションの出力の特定の部分に対する本文を返します。

multipartBody('<actionName>', <index>)

N

not

式が false かどうかを確認します。 式が false の場合は true を返し、true の場合は false を返します。

not(<expression>)

Example 1

これらの例では、指定した式が false であるかどうかをチェックします。

not(false)
not(true)

次の結果を返します。

• 最初の例: 式は false であるため、関数は trueを返します。
• 2 番目の例: 式は true であるため、関数は falseを返します。

Example 2

これらの例では、指定した式が false であるかどうかをチェックします。

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

次の結果を返します。

• 最初の例: 式は false であるため、関数は trueを返します。
• 2 番目の例: 式は true であるため、関数は falseを返します。

nthIndexOf

Return the starting position or index value where the nth occurrence of a substring appears in a string.

nthIndexOf('<text>', '<searchText>', <occurrence>)

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

少なくとも 1 つの式が true かどうかを確認します。 少なくとも 1 つの式が true の場合は true を返し、すべて false の場合は false を返します。

or(<expression1>, <expression2>, ...)

Example 1

これらの例では、少なくとも 1 つの式が true かどうかをチェックします。

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

次の結果を返します。

• 最初の例: 少なくとも 1 つの式が true であるため、関数は trueを返します。
• 2 番目の例: どちらの式も false であるため、関数は falseを返します。

Example 2

これらの例では、少なくとも 1 つの式が true かどうかをチェックします。

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

次の結果を返します。

• 最初の例: 少なくとも 1 つの式が true であるため、関数は trueを返します。
• 2 番目の例: どちらの式も false であるため、関数は falseを返します。

outputs

実行時のアクションの出力を返します。

outputs('<actionName>')

Example

この例は、X アクション Get user からの出力を取得します。

outputs('Get_user')

返される結果:

{
  "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

ワークフローの定義で記述されているパラメーターの値を返します。

parameters('<parameterName>')

Example

次のような JSON 値があるものとします。

{
  "fullName": "Sophia Owen"
}

この例は、指定したパラメーターの値を取得します。

parameters('fullName')

次の結果が返されます。 "Sophia Owen"

parseDateTime

タイムスタンプを含む文字列からタイムスタンプを返します。

parseDateTime('<timestamp>', '<locale>'?, '<format>'?)

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

指定した範囲からランダムな整数を返します。これは、開始端でのみ含まれます。

rand(<minValue>, <maxValue>)

Example

この例は、指定した範囲 (最大値は除きます) からランダムな整数を取得します。

rand(1, 5)

結果として次のいずれかの整数が返ります: 1、2、3、4

範囲

指定した整数から始まる整数の配列を返します。

range(<startIndex>, <count>)

Example

この例は、指定したインデックスから始まり、指定された数の整数を含む、整数の配列を作成します。

range(1, 4)

次の結果が返されます。 [1, 2, 3, 4]

removeProperty

オブジェクトからプロパティを削除し、更新されたオブジェクトを返します。 削除しようとしたプロパティが存在しない場合、この関数は元のオブジェクトを返します。

removeProperty(<object>, '<property>')

既存のプロパティから子プロパティを削除するには、次の構文を使用します。

removeProperty(<object>['<parent-property>'], '<child-property>')

Example 1

This example removes the middleName property from a JSON object, which is converted from a string to JSON by using the JSON() function, and returns the updated object:

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

現在の JSON オブジェクトを次に示します。

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

更新された JSON オブジェクトを次に示します。

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

Example 2

This example removes the middleName child property from a customerName parent property in a JSON object, which is converted from a string to JSON by using the JSON() function, and returns the updated object:

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

現在の JSON オブジェクトを次に示します。

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

更新された JSON オブジェクトを次に示します。

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

置換

部分文字列を指定した文字列に置き換え、結果文字列を返します。 この関数では大文字と小文字が区別されます。

replace('<text>', '<oldText>', '<newText>')

Example

この例は、文字列 "the old string" で部分文字列 "old" を検索し、"old" を "new" に置き換えます。

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

次の結果が返されます。 "the new string"

result

指定されたスコープ付きアクション内の最上位レベルのアクション (For_each、Until、Scope アクションなど) からの結果を返します。 result() 関数は、単一のパラメーター (スコープの名前) を受け取り、そのスコープ内の第 1 レベルのアクションの情報を含んだ配列を返します。 これらのアクションのオブジェクトには、actions() 関数によって返される属性と同じ属性 (アクションの開始時刻、終了時刻、状態、入力、相関 ID、出力など) が含まれます。

たとえば、この関数を使用すると、失敗したアクションの結果を取得して、例外の診断や処理に役立てることができます。 詳細については「エラーのコンテキストと結果を取得する」をご覧ください。

result('<scopedActionName>')

Example

この例では、For_each アクションで result() 関数を使用して、Compose ループ内にある HTTP アクションの各繰り返しからの入力と出力を返します。

{
   "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"
      }
   }
}

以下に、返される配列の例を示します。ここで、外側の outputs オブジェクトに、For_each アクション内にあるアクションの各繰り返しからの入力と出力が格納されています。

[
   {
      "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

コレクション内の項目の順序を逆にします。 When you use this function with sort(), you can sort a collection in descending order.

reverse([<collection>])

Example

次の例は、整数の配列の順序を逆にします。

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

次の配列を返します: [3,2,1,0]

S

setProperty

JSON オブジェクトのプロパティの値を設定し、更新されたオブジェクトを返します。 設定しようとしたプロパティが存在しない場合、そのプロパティがオブジェクトに追加されます。 To add a new property, use the addProperty() function.

setProperty(<object>, '<property>', <value>)

子オブジェクト内に子プロパティを設定するには、入れ子になった setProperty() 呼び出しを代わりに使用します。 それ以外の場合、関数は子オブジェクトだけを出力として返します。

setProperty(<object>, '<parent-property>', setProperty(<object>['parentProperty'], '<child-property>', <value>))

Example 1

This example sets the surName property in a JSON object, which is converted from a string to JSON by using the JSON() function. この関数は、指定された値をこのプロパティに割り当て、更新されたオブジェクトを返します。

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

現在の JSON オブジェクトを次に示します。

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

更新された JSON オブジェクトを次に示します。

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

Example 2

This example sets the surName child property for the customerName parent property in a JSON object, which is converted from a string to JSON by using the JSON() function. この関数は、指定された値をこのプロパティに割り当て、更新されたオブジェクトを返します。

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

現在の JSON オブジェクトを次に示します。

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

更新された JSON オブジェクトを次に示します。

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

スキップ

コレクションの先頭から項目を削除し、"他のすべて" の項目を返します。

skip([<collection>], <count>)

Example

この例は、指定した配列の先頭から 1 つの項目 (番号 0) を削除します。

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

そして、残りの項目を含む配列 [1,2,3] を返します。

スライス

開始およびは終了位置または値を指定して部分文字列を返します。 See also substring().

slice('<text>', <startIndex>, <endIndex>?)

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 ''.

並べ替え

コレクション内の項目を並べ替えます。 単純型を含む任意のキーを使用して、コレクション オブジェクトを並べ替えることができます。

sort([<collection>], <sortBy>?)

Example 1

次の例は、整数の配列を並べ替えます。

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

次の配列を返します: [0,1,2,3]

Example 2

次の例は、オブジェクトの配列をキー順に並べ替えます。

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

次の配列を返します: [{ "first": "Elise", "last": "Renee" }, {"first": "Amalie", "last": "Rose" }')]

分割する

元の文字列の指定した区切り文字に基づいて、コンマで区切られた部分文字列を含む配列を返します。

split('<text>', '<delimiter>')

Example 1

この例では、区切り記号として指定した文字に基づいて指定された文字列からの部分文字列を含む配列を作成します。

split('a_b_c', '_')

返される配列の結果: ["a","b","c"]

Example 2

この例では、文字列に区切り記号が存在しない場合、1 つの要素を持つ配列が作成されます。

split('a_b_c', ' ')

返される配列の結果: ["a_b_c"]

startOfDay

タイムスタンプの日の始まりを返します。

startOfDay('<timestamp>', '<format>'?)

Example

この例は、次のタイムスタンプの日の開始を取得します。

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

次の結果が返されます。 "2018-03-15T00:00:00.0000000Z"

startOfHour

タイムスタンプの時間の先頭を返します。

startOfHour('<timestamp>', '<format>'?)

Example

この例は、次のタイムスタンプの時刻の開始を取得します。

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

次の結果が返されます。 "2018-03-15T13:00:00.0000000Z"

startOfMonth

タイムスタンプの月の始まりを返します。

startOfMonth('<timestamp>', '<format>'?)

Example 1

この例は、次のタイムスタンプの月の開始を返します。

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

次の結果が返されます。 "2018-03-01T00:00:00.0000000Z"

Example 2

この例では、次のタイムスタンプの月の開始を指定した形式で返します。

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

次の結果が返されます。 "2018-03-01"

startsWith

文字列が特定の部分文字列で始まるかどうかを確認します。 部分文字列が見つかった場合は true を返し、見つからない場合は false を返します。 この関数は、大文字と小文字を区別しません。

startsWith('<text>', '<searchText>')

Example 1

次の使用例は、"hello world" 文字列が "hello" 部分文字列で始まるかどうかを確認します。

startsWith('hello world', 'hello')

次の結果が返されます。 true

Example 2

次の使用例は、"hello world" 文字列が "greetings" 部分文字列で始まるかどうかを確認します。

startsWith('hello world', 'greetings')

次の結果が返されます。 false

文字列

値の文字列バージョンを返します。

string(<value>)

Example 1

この例は、次の数値の文字列バージョンを作成します。

string(10)

次の結果が返されます。 "10"

Example 2

この例は、指定した JSON オブジェクトの文字列を作成します。二重引用符 (") のエスケープ文字として、バックスラッシュ文字 (\) を使います。

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

次の結果が返されます。 "{ \\"name\\": \\"Sophie Owen\\" }"

sub

1 番目の数値から 2 番目の数値を減算して、結果を返します。

sub(<minuend>, <subtrahend>)

Example

この例は、1 番目の数値から 2 番目の数値を減算します。

sub(10.3, .3)

次の結果が返されます。 10

substring

文字列から、指定された位置またはインデックスから始まる文字を返します。 インデックス値は 0 から始まります。 See also slice().

substring('<text>', <startIndex>, <length>)

Example

この例は、指定した文字列のインデックス値 6 から始まる 5 文字を含む部分文字列を作成します。

substring('hello world', 6, 5)

次の結果が返されます。 "world"

subtractFromTime

タイムスタンプから時間単位の数を減算します。 See also getPastTime.

subtractFromTime('<timestamp>', <interval>, '<timeUnit>', '<format>'?)

Example 1

この例は、次のタイムスタンプから 1 日を減算します。

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

次の結果が返されます。 "2018-01-01T00:00:00.0000000Z"

Example 2

この例は、次のタイムスタンプから 1 日を減算します。

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

省略可能な "D" 形式を使用して返される結果: "Monday, January, 1, 2018"

T

take

コレクションの先頭から項目を返します。

take('<collection>', <count>)
take([<collection>], <count>)

Example

これらの例は、次のコレクションの先頭から指定した数の項目を取得します。

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

次の結果を返します。

• 最初の例: "abc"
• 2 番目の例: [0, 1, 2]

ticks

1 月 1 日 0001 12:00:00 午前 0 時から指定したタイムスタンプまでの 100 ナノ秒間隔のティック数 (または C# の DateTime.Ticks) を返します。 詳細については、DateTime.Ticks プロパティ (システム) のトピックを参照してください。

ticks('<timestamp>')

toLower

小文字の形式で文字列を返します。 文字列内の文字に小文字のバージョンがない場合、その文字は返された文字列内で変更されません。

toLower('<text>')

Example

この例は、次の文字列を小文字に変換します。

toLower('Hello World')

次の結果が返されます。 "hello world"

toUpper

大文字の形式で文字列を返します。 文字列内の文字に大文字のバージョンがない場合、その文字は返される文字列内で変更されません。

toUpper('<text>')

Example

この例は、次の文字列を大文字に変換します。

toUpper('Hello World')

次の結果が返されます。 "HELLO WORLD"

トリガ

実行時のトリガーの出力を返すか、または式に割り当てることができる他の JSON の名前と値のペアの値を返します。

• トリガーの入力の内部では、この関数は前の実行からの出力を返します。

• トリガーの条件の内部では、この関数は現在の実行からの出力を返します。

既定では、この関数はトリガー オブジェクト全体を参照しますが、必要に応じて値を取得するプロパティを指定することができます。 Also, this function has shorthand versions available, see triggerOutputs() and triggerBody().

trigger()

triggerBody

実行時にトリガーの body 出力を返します。 trigger().outputs.body の短縮形です。 See trigger().

triggerBody()

triggerFormDataMultiValues

Return an array with values that match a key name in a trigger's form-data or form-encoded output.

triggerFormDataMultiValues('<key>')

Example

この例は、RSS トリガーの form-data 出力または form-encoded 出力内の "feedUrl" キーの値から配列を作成します。

triggerFormDataMultiValues('feedUrl')

例の結果として返される配列: ["https://feeds.a.dj.com/rss/RSSMarketsMain.xml"]

triggerFormDataValue

Return a string with a single value that matches a key name in a trigger's form-data or form-encoded output. 複数の一致が見つかった場合、関数はエラーをスローします。

triggerFormDataValue('<key>')

Example

この例は、RSS トリガーの form-data 出力または form-encoded 出力内の "feedUrl" キーの値から文字列を作成します。

triggerFormDataValue('feedUrl')

例の結果として返される文字列: "https://feeds.a.dj.com/rss/RSSMarketsMain.xml"

triggerMultipartBody

複数の部分を持つトリガーの出力の特定の部分に対する本文を返します。

triggerMultipartBody(<index>)

triggerOutputs

実行時のトリガーの出力を返すか、または他の JSON の名前と値のペアの値を返します。 trigger().outputs の短縮形です。 See trigger().

triggerOutputs()

トリミングする

文字列から先頭と末尾の空白を削除し、更新された文字列を返します。

trim('<text>')

Example

この例では、文字列 " Hello World " から先頭と末尾の空白が削除されます。

trim(' Hello World  ')

次の結果が返されます。 "Hello World"

U

UNION

Return a collection that has all the items from the specified collections. 結果に表示するには、この関数に渡されるすべてのコレクションに項目を表示できます。 1 つ以上の項目の名前が同じである場合、その名前の最後の項目が結果に表示されます。

union('<collection1>', '<collection2>', ...)
union([<collection1>], [<collection2>], ...)

Example

This example gets all the items from these collections:

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

次の結果が返されます。 [1, 2, 3, 10, 101]

uriComponent

URL の安全でない文字がエスケープ文字に置き換えられた、文字列の URI (Uniform Resource Identifier) エンコード バージョンを返します。 Use this function rather than encodeUriComponent(). どちらの関数も機能は同じですが、uriComponent() をお勧めします。

uriComponent('<value>')

Example

この例は、次の文字列の URI エンコード バージョンを作成します。

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

次の結果が返されます。 "https%3A%2F%2Fcontoso.com"

uriComponentToBinary

URI (Uniform Resource Identifier) コンポーネントのバイナリ バージョンを返します。

uriComponentToBinary('<value>')

Example

この例は、次の URI エンコード文字列のバイナリ バージョンを作成します。

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

次の結果が返されます。 "aHR0cHM6Ly9jb250b3NvLmNvbQ=="

uriComponentToString

URI (Uniform Resource Identifier) エンコード文字列の文字列バージョンを返します。実質的に、URI エンコード文字列をデコードします。

uriComponentToString('<value>')

Example

この例は、次の URI エンコード文字列のデコードされた文字列バージョンを作成します。

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

次の結果が返されます。 "https://contoso.com"

uriHost

URI (Uniform Resource Identifier) の host 値を返します。

uriHost('<uri>')

Example

この例は、次の URI の host 値を検索します。

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

次の結果が返されます。 "www.localhost.com"

uriPath

URI (Uniform Resource Identifier) の path 値を返します。

uriPath('<uri>')

Example

この例は、次の URI の path 値を検索します。

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

次の結果が返されます。 "/catalog/shownew.htm"

uriPathAndQuery

URI (Uniform Resource Identifier) の path と query の値を返します。

uriPathAndQuery('<uri>')

Example

この例は、次の URI の path と query の値を検索します。

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

次の結果が返されます。 "/catalog/shownew.htm?date=today"

uriPort

URI (Uniform Resource Identifier) の port 値を返します。

uriPort('<uri>')

Example

この例は、次の URI の port 値を返します。

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

次の結果が返されます。 8080

uriQuery

URI (Uniform Resource Identifier) の query 値を返します。

uriQuery('<uri>')

Example

この例は、次の URI の query 値を返します。

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

次の結果が返されます。 "?date=today"

uriScheme

URI (Uniform Resource Identifier) の scheme 値を返します。

uriScheme('<uri>')

Example

この例は、次の URI の scheme 値を返します。

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

次の結果が返されます。 "http"

utcNow

現在のタイムスタンプを返します。

utcNow('<format>')

Optionally, you can specify a different format with the <format> parameter.

Example 1

現在の日時が 2018 年 4 月 15 日午後 1 時 0 分 0 秒であるものとします。 この例は、現在のタイムスタンプを取得します。

utcNow()

次の結果が返されます。 "2018-04-15T13:00:00.0000000Z"

Example 2

現在の日時が 2018 年 4 月 15 日午後 1 時 0 分 0 秒であるものとします。 この例は、オプションの "D" 形式を使って現在のタイムスタンプを取得します。

utcNow('D')

次の結果が返されます。 "Sunday, April 15, 2018"

V

variables

指定した変数の値を返します。

variables('<variableName>')

Example

"numItems" 変数の現在の値が 20 であるものとします。 この例は、この変数の整数値を取得します。

variables('numItems')

次の結果が返されます。 20

W

ワークフロー

実行時にワークフロー自体に関するすべての詳細を返します。

workflow().<property>

Example 1

この例は、ワークフローの現在の実行の名前を返します。

workflow().run.name

Example 2

Power Automate を使用する場合は、@workflow() 出力プロパティを使用する tags 式を作成して、フローの flowDisplayName または environmentName プロパティから値を取得できます。

たとえば、リンクをたどってフローに戻るカスタム電子メール通知をフロー自体から送信することができます。 これらの通知に、電子メール タイトルにフローの表示名を含み、次の構文に従う HTML リンクを含めることができます。

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

X

xml

JSON オブジェクトを含む文字列の XML バージョンを返します。

xml('<value>')

Example 1

この例は、文字列を XML に変換します。

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

返される結果の XML:

<name>Sophia Owen</name>

Example 2

この例は、JSON オブジェクトを含む次の文字列の XML バージョンを作成します。

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

返される結果の XML:

<name>Sophia Owen</name>

Example 3

次のような JSON オブジェクトがあるものとします。

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

この例は、この JSON オブジェクトを含む文字列の XML を作成します。

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

返される結果の XML:

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

xpath

XML で XPath (XML Path Language) 式と一致するノードまたは値を調べて、一致するノードまたは値を返します。 XPath 式または単に "XPath" は、XML コンテンツ内のノードまたは計算値を選択できるように、XML ドキュメント構造内の移動を補助します。

xpath('<xml>', '<xpath>')

Example 1

この 'items' 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>

この例では、XPath 式 '/produce/item/name/text()' を渡して、<name></name> XML 文字列内の 'items' ノードに一致するノードを検索し、それらのノード値を含む配列を返します。

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

The example also uses the parameters() function to get the XML string from 'items' and convert the string to XML format by using the xml() function.

<name></name> と一致するノードの値が設定された結果配列は次のとおりです。

[ Gala, Honeycrisp ]

Example 2

例 1 に続いて、この例では、XPath 式 '/produce/item/name[1]' を渡して、name 要素の子である最初の item 要素を検索します。

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

結果は次のとおりです: Gala

Example 3

例 1 に続いて、この例では、XPath 式 '/produce/item/name[last()]' を渡して、name 要素の子である最後の item 要素を検索します。

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

結果は次のとおりです: Honeycrisp

Example 4

この例では、items XML 文字列に、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>

この例では、XPath 式 '//name[@expired]' を渡して、name 属性を持つすべての expired 要素を検索します。

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

結果は次のとおりです: [ Gala, Honeycrisp ]

Example 5

この例では、items XML 文字列に属性 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>

この例では、XPath 式 '//name[@expired = 'true']' を渡して、属性 name を持つすべての expired = 'true' 要素を検索します。

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

結果は次のとおりです: [ Gala ]

Example 6

この例では、items XML 文字列に次の属性も含まれているとします。

• 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>

この例では、XPath 式 '//name[@price>35]' を渡して、name を持つすべての price > 35 要素を検索します。

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

結果は次のとおりです: Honeycrisp

Example 7

この例では、items XML 文字列が例 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>

この例では <count></count> ノードと一致するノードを検索し、sum() 関数でそれらのノードの値を追加します。

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

結果は次のとおりです: 30

Example 8

この例では、次の XML 文字列があるとします。これには、XML ドキュメントの名前空間 xmlns="https://contoso.com" が含まれています。

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

これらの式では、XPath 式 /*[name()="file"]/*[name()="___location"] または /*[local-name()="file" and namespace-uri()="https://contoso.com"]/*[local-name()="___location"] を使用して、<___location></___location> ノードに一致するノードを検索します。 これらの例は、デザイナーまたは式エディターで使用する構文を示しています。

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

<___location></___location> ノードと一致する結果のノード:

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

Example 9

例 8 に続いてこの例では、XPath 式 'string(/*[name()="file"]/*[name()="___location"])' を使用して、<___location></___location> ノードの値を検索します。

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

結果は次のとおりです: Paris

Next steps

ワークフロー定義言語について学習してください