Azure Logic Apps と Power Automate のワークフローで使用する式の関数に関する参考ガイド

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

Azure Logic Apps および Power Automate でのワークフロー定義の場合、一部の式では、ワークフローの実行開始時にはまだ存在しない可能性がある値が実行時のアクションから取得されます。 これらの式で値を参照または処理するには、ワークフロー定義言語によって提供される式関数を使用できます。

たとえば、整数や浮動小数点数の合計が必要なときは、add() 関数などの数学関数を使って値を計算できます。 関数を使用して実行できるタスクの他の例を示します。

一般的な目的に基づいて関数を探すには、以降の表をご覧ください。 または、各関数の詳細については、アルファベット順の一覧を参照してください。

式の関数

式で関数を使用する方法を示すために、次の例では、customerName パラメーターから値を取得し、式の中で accountName 関数を使ってその値を プロパティに割り当てる方法を示します。

"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 プロパティに結果を割り当てています。

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

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

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

• パラメーターの定義の構文において、パラメーターの後に疑問符 (?) が付いている場合は、そのパラメーターが省略可能であることを意味します。 たとえば、getFutureTime() をご覧ください。

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

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

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

  正しくない: "<text>/@<function-name>('<parameter-name>')/<text>"

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

次のセクションでは、一般的な目的に基づいて関数を整理します。または、これらの関数をアルファベット順で参照することもできます。

文字列関数

文字列を処理するには、以下の文字列関数および一部のコレクション関数も使用できます。 文字列関数は文字列でのみ機能します。

コレクション関数

コレクション (通常は配列や文字列、場合によってはディクショナリ) を操作するには、以下のコレクション関数を使用できます。

論理比較関数

条件の処理、値と式の結果の比較、さまざまな種類のロジックの評価などを行うには、以下の論理比較関数を使用できます。 各関数の完全なリファレンスについては、アルファベット順の一覧を参照してください。

変換関数

値の型または形式を変更するには、以下の変換関数を使用できます。 たとえば、値をブール値から整数に変更できます。 Azure Logic Apps が変換時にコンテンツ タイプを処理する方法の詳細については、「コンテンツ タイプを処理する」を参照してください。 各関数の完全なリファレンスについては、アルファベット順の一覧を参照してください。

暗黙的なデータ型の変換

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

算術関数

整数と浮動小数点数を操作するには、以下の算術関数を使用できます。 各関数の完全なリファレンスについては、アルファベット順の一覧を参照してください。

日付と時刻関数

日付と時刻を操作するには、以下の日付と時刻の関数を使用できます。 各関数の完全なリファレンスについては、アルファベット順の一覧を参照してください。

ワークフロー関数

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

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

たとえば、あるアクションからの出力を参照し、後のアクションでそのデータを使用できます。 各関数の完全なリファレンスについては、アルファベット順の一覧を参照してください。

URI 解析関数

URI (Uniform Resource Identifier) を処理して、URI のさまざまなプロパティ値を取得します。以下の URI 解析関数を使用できます。 各関数の完全なリファレンスについては、アルファベット順の一覧を参照してください。

操作関数: JSON と XML

JSON オブジェクトと XML ノードを処理するには、以下の操作関数を使用できます。 各関数の完全なリファレンスについては、アルファベット順の一覧を参照してください。

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

すべての関数 (アルファベット順)

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

A

アクション

実行時の "現在の" アクションの出力を返すか、または式に割り当てることができる他の JSON の名前と値のペアの値を返します。 既定では、この関数はアクション オブジェクト全体を参照しますが、必要に応じて値を取得するプロパティを指定することができます。 actions() も参照してください。

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

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

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

actions

実行時のアクションの出力を返すか、または式に割り当てることができる他の JSON の名前と値のペアの値を返します。 既定では、この関数はアクション オブジェクト全体を参照しますが、必要に応じて値を取得するプロパティを指定することができます。 短縮形については、body() を参照してください。 現在のアクションの場合は、action() をご覧ください。

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

例

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

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

返される結果: "Succeeded"

add

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

add(<summand_1>, <summand_2>)

例

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

add(1, 1.5)

返される結果: 2.5

日数を追加

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

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

例 1

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

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

返される結果: "2018-03-25T00:00:00.0000000Z"

例 2

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

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

返される結果: "2018-03-10T00:00:00.0000000Z"

addHours（時間を追加）

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

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

例 1

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

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

返される結果: "2018-03-15T10:00:00.0000000Z"

例 2

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

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

返される結果: "2018-03-15T10:00:00.0000000Z"

addMinutes

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

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

例 1

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

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

返される結果: "2018-03-15T00:20:00.0000000Z"

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

例 1

この例では、middleName 関数を使用して文字列から JSON に変換される JSON オブジェクトに プロパティを追加します。 このオブジェクトには、プロパティ firstName と surName が既に含まれています。 この関数は、指定された値を新しいプロパティに割り当て、更新されたオブジェクトを返します。

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

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

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

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

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

例 2

この例では、middleName 関数を使用して文字列から JSON に変換される JSON オブジェクトの既存の customerName プロパティに 子プロパティを追加します。 この関数は、指定された値を新しいプロパティに割り当て、更新されたオブジェクトを返します。

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

例 1

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

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

返される結果: "2018-03-15T00:00:10.0000000Z"

例 2

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

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

返される結果: "2018-03-15T00:00:25.0000000Z"

addToTime（アドトゥタイム）

タイムスタンプに指定した時間単位を加算します。 getFutureTime() もご覧ください。

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

例 1

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

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

返される結果: "2018-01-02T00:00:00.0000000Z"

例 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>, ...)

例 1

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

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

次の結果を返します。

• 1 番目の例: 両方の式が true なので、true を返します。
• 2 番目の例: 1 つの式が false なので、false を返します。
• 3 番目の例: 両方の式が false なので、false を返します。

例 2

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

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

次の結果を返します。

• 1 番目の例: 両方の式が true なので、true を返します。
• 2 番目の例: 1 つの式が false なので、false を返します。
• 3 番目の例: 両方の式が false なので、false を返します。

アレイ

指定した 1 つの入力から配列を返します。 複数の入力の場合は、createArray() をご覧ください。

array('<value>')

例

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

array('hello')

返される結果: ["hello"]

B

base64

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

base64('<value>')

例

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

base64('hello')

返される結果: "aGVsbG8="

base64ToBinary

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

base64ToBinary('<value>')

例

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

base64ToBinary('aGVsbG8=')

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

base64ToString

base64 エンコード文字列の文字列バージョンを返し、実質的に base64 の文字列をデコードします。 非推奨の decodeBase64() ではなく、この関数を使用してください。

base64ToString('<value>')

例

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

base64ToString('aGVsbG8=')

返される結果: "hello"

binary

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

binary('<value>')

例

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

body

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

body('<actionName>')

例

この例は、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() を使用している場合、オブジェクトの値はブール値に変換できる文字列か整数にする必要があります。

出力

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

C

チャンク (chunk)

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

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

例 1

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

chunk('abcdefghijklmnopqrstuvwxyz', 10)

返される結果: ['abcdefghij', 'klmnopqrst', 'uvwxyz']

例 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>, ...)

例

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

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

次の結果を返します。

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

concat

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

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

例

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

concat('Hello', 'World')

返される結果: "HelloWorld"

contains

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

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

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

• "文字列" からの "部分文字列" の検索
• "配列" からの "値" の検索
• "ディクショナリ" からの "キー" の検索

例 1

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

contains('hello world', 'world')

例 2

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

contains('hello world', 'universe')

convertFromUtc

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

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

例 1

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

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

返される結果: "2018-01-01T00:00:00.0000000"

例 2

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

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

返される結果: "Monday, January 1, 2018"

convertTimeZone

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

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

例 1

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

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

返される結果: "2018-01-01T00:00:00.0000000"

例 2

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

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

返される結果: "Monday, January 1, 2018"

convertToUtc（UTCに変換）

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

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

例 1

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

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

返される結果: "2018-01-01T08:00:00.0000000Z"

例 2

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

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

返される結果: "Monday, January 1, 2018"

createArray

複数の入力から配列を作成して返します。 単一入力の配列については、array() をご覧ください。

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

例

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

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

返される結果: ["h", "e", "l", "l", "o"]

D

dataUri

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

dataUri('<value>')

例

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

dataUri('hello')

返される結果: "data:text/plain;charset=utf-8;base64,aGVsbG8="

データURIをバイナリに変換

データ URI (Uniform Resource Identifier) のバイナリ バージョンを返します。 decodeDataUri() ではなく、この関数を使用してください。 どちらの関数も機能は同じですが、dataUriBinary() をお勧めします。

dataUriToBinary('<value>')

例

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

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

返される結果:

"01100100011000010111010001100001001110100111010001100101011110000111010000101111011100000 1101100011000010110100101101110001110110110001101101000011000010111001001110011011001010111 0100001111010111010101110100011001100010110100111000001110110110001001100001011100110110010 10011011000110100001011000110000101000111010101100111001101100010010001110011100000111101"

dataUriToString

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

dataUriToString('<value>')

例

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

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

返される結果: "hello"

** 日付差

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

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

例

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

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

返される結果: "1268.00:00:00"

dayOfMonth

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

dayOfMonth('<timestamp>')

例

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

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

返される結果: 15

dayOfWeek

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

dayOfWeek('<timestamp>')

例

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

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

返される結果: 4

dayOfYear

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

dayOfYear('<timestamp>')

例

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

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

返される結果: 74

10 進

文字列内の 10 進数を 10 進数として返します。 この関数は 10 進数の有効桁数を必要とするデータで作業しているとき使用できますが、論理比較関数や算術関数の入力として使用することもできます。 decimal() 関数の結果を使用するときに有効桁数をキャプチャして保持するには、任意の 10 進出力を文字列関数でラップします。 この使用法を次の例で示します。10 進数の結果を数値として使用すると、有効桁数が失われる可能性があります。

decimal('<value>')

例 1

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

decimal('1.2345678912312131') // Returns 1.234567891231213.

例 2

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

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

例 3

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

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

例 4

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

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

decodeBase64 (非推奨)

この関数は非推奨です。代わりに base64ToString() を使用してください。

デコードデータURI

データ URI (Uniform Resource Identifier) のバイナリ バージョンを返します。 ではなく、decodeDataUri() を使うようにしてください。 どちらの関数も機能は同じですが、dataUriToBinary() をお勧めします。

decodeDataUri('<value>')

例

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

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

返される結果: "hello"

decodeUriComponent

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

decodeUriComponent('<value>')

例

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

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

返される結果: "https://contoso.com"

div

2 つの数値を除算した結果を返します。 結果の残りの部分を取得するには、mod() をご覧ください。

div(<dividend>, <divisor>)

例 1

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

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

例 2

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

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

E

encodeUriComponent

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

encodeUriComponent('<value>')

例

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

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

返される結果: "https%3A%2F%2Fcontoso.com"

empty

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

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

例

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

empty('')
empty('abc')

次の結果を返します。

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

endsWith

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

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

例 1

この例は、文字列 "hello world" が文字列 "world" で終わっているかどうかを調べます。

endsWith('hello world', 'world')

返される結果: true

例 2

この例は、文字列 "hello world" が文字列 "universe" で終わっているかどうかを調べます。

endsWith('hello world', 'universe')

返される結果: false

equals

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

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

例

これらの例は、指定した入力が等しいかどうかを調べます。

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

次の結果を返します。

• 1 番目の例: 両方の値は等しいので、関数は true を返します。
• 2 番目の例: 両方の値は等しくないので、関数からは false が返されます。

F

first

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

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

例

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

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

次の結果を返します。

• 1 番目の例: "h"
• 2 番目の例: 0

float

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

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

例 1

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

float('10,000.333')

返される結果: 10000.333

例 2

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

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

返される結果: 10000.333

例 3

予期しない有効な入力の例:

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

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

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

例

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（フォームデータの複数の値）

アクションの form-data 出力または form-encoded 出力内のキー名と一致する値の配列を返します。

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

例

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

formDataMultiValues('Send_an_email', 'Subject')

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

フォームデータ値

アクションの form-data 出力または form-encoded 出力内のキー名と一致する単一の値を返します。 複数の一致が見つかった場合、関数はエラーをスローします。

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

例

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

formDataValue('Send_an_email', 'Subject')

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

formatNumber

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

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

例 1

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

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

*例 2"

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

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

例 3

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

formatNumber(17.35, 'C2')

例 4

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

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

G

未来の時間を取得する

現在のタイムスタンプに指定した時刻単位を加えて返します。

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

例 1

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

getFutureTime(5, 'Day')

返される結果: "2018-03-06T00:00:00.0000000Z"

例 2

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

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

返される結果: "Tuesday, March 6, 2018"

getPastTime

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

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

例 1

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

getPastTime(5, 'Day')

返される結果: "2018-01-27T00:00:00.0000000Z"

例 2

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

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

返される結果: "Saturday, January 27, 2018"

greater

1 番目の値が 2 番目の値より大きいかどうかを調べます。 1 番目の値の方が大きい場合は true を返し、大きくない場合は false を返します。

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

例

これらの例は、1 番目の値が 2 番目の値より大きいかどうかを調べます。

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

次の結果を返します。

• 1 番目の例: true
• 2 番目の例: false

greaterOrEquals

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

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

例

これらの例は、1 番目の値が 2 番目の値以上かどうかを調べます。

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

次の結果を返します。

• 1 番目の例: true
• 2 番目の例: false

guid

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

guid()

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

guid('<format>')

例

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

guid('P')

返される結果: "(c2ecc88d-88c8-4096-912c-d6f2e2b138ce)"

I

もし

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

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

例

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

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

indexOf

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

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

例

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

indexOf('hello world', 'world')

返される結果: 6

整数 (int)

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

int('<value>')

例

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

int('10')

返される結果: 10

isFloat

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

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

例 1

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

isFloat('10,000.00')

返される結果: true

例 2

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

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

返される結果: true

isInt

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

isInt('<string>')

例

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

isInt('10')

返される結果: true

項目

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

item()

例

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

item().body

items

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

items('<loopName>')

例

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

items('myForEachLoopName')

iterationIndexes

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

iterationIndexes('<loopName>')

例

この例では、カウンター変数を作成し、カウンター値が 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'))

例 1

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

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

返される結果: [1, 2, 3]

例 2

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

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

返される結果:

{
  "fullName": "Sophia Owen"
}

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

例 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

指定したコレクションすべてに共通する項目 "のみ" を含むコレクションを返します。 結果に含まれるためには、この関数に渡されるすべてのコレクションに項目が含まれる必要があります。 1 つまたは複数の項目が同じ名前である場合は、その名前を持つ最後の項目が結果に含まれます。

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

例

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

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

そして、それらの項目 "[1, 2]" を含む配列を返します。

参加

配列のすべての項目を含み、各文字が "区切り記号" で区切られた文字列を返します。

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

例

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

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

返される結果: "a.b.c"

L

last

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

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

例

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

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

次の結果を返します。

• 1 番目の例: "d"
• 2 番目の例: 3

lastIndexOf

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

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

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

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

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

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

例

この例では、文字列 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>])

例

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

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

返される結果: 4

less

1 番目の値が 2 番目の値より小さいかどうかを調べます。 1 番目の値の方が小さい場合は true を返し、小さくないい場合は false を返します。

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

例

これらの例は、1 番目の値が 2 番目の値より小さいかどうかを調べます。

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

次の結果を返します。

• 1 番目の例: true
• 2 番目の例: false

lessOrEquals

1 番目の値が 2 番目の値以下かどうかを調べます。 1 番目の値が小さいか等しい場合は true を返し、大きい場合は false を返します。

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

例

これらの例は、1 番目の値が 2 番目の値以下かどうかを調べます。

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

次の結果を返します。

• 1 番目の例: true
• 2 番目の例: false

listCallbackUrl

トリガーまたはアクションを呼び出す "コールバック URL" を返します。 この関数は、HttpWebhook および ApiConnectionWebhook コネクタ型に対するトリガーとアクションでのみ機能し、Manual、Recurrence、HTTP、および APIConnection 型では機能しません。

listCallbackUrl()

例

この例は、この関数が返すことのあるコールバック 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*>"

エム

max

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

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

例

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

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

返される結果: 3

min

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

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

例

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

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

返される結果: 1

モッド

2 つの数値を除算した剰余を返します。 整数の結果を取得するには、div() をご覧ください。

mod(<dividend>, <divisor>)

例 1

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

mod(3, 2)

返される結果: 1

例 2

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

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

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

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

mul

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

mul(<multiplicand1>, <multiplicand2>)

例

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

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

次の結果を返します。

• 1 番目の例: 2
• 2 番目の例: 3

multipartBody

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

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

N

ない

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

not(<expression>)

例 1

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

not(false)
not(true)

次の結果を返します。

• 1 番目の例: 式が false なので、関数は true を返します。
• 2 番目の例: 式が true なので、関数は false を返します。

例 2

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

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

次の結果を返します。

• 1 番目の例: 式が false なので、関数は true を返します。
• 2 番目の例: 式が true なので、関数は false を返します。

nthIndexOf

文字列内での部分文字列の n 番目の出現箇所の開始位置またはインデックス値を返します。

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

例

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>, ...)

例 1

これらの例は、少なくとも 1 つの式が true かどうかを調べます。

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

次の結果を返します。

• 1 番目の例: 少なくとも 1 つの式が true なので、関数は true を返します。
• 2 番目の例: 両方の式が false なので、関数は false を返します。

例 2

これらの例は、少なくとも 1 つの式が true かどうかを調べます。

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

次の結果を返します。

• 1 番目の例: 少なくとも 1 つの式が true なので、関数は true を返します。
• 2 番目の例: 両方の式が false なので、関数は false を返します。

outputs

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

outputs('<actionName>')

例

この例は、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('<parameterName>')

例

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

{
  "fullName": "Sophia Owen"
}

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

parameters('fullName')

返される結果: "Sophia Owen"

parseDateTime

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

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

例

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(<minValue>, <maxValue>)

例

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

rand(1, 5)

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

範囲

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

range(<startIndex>, <count>)

例

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

range(1, 4)

返される結果: [1, 2, 3, 4]

プロパティを削除する

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

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

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

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

例 1

この例では、middleName 関数を使用して文字列から JSON に変換される JSON オブジェクトから プロパティを削除し、更新されたオブジェクトを返します。

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

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

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

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

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

例 2

この例では、middleName 関数を使用して文字列から JSON に変換される JSON オブジェクトの customerName 親プロパティから 子プロパティを削除し、更新されたオブジェクトを返します。

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

例

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

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

返される結果: "the new string"

結果

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

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

result('<scopedActionName>')

例

この例では、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

コレクション内の項目の順序を逆にします。 sort() とともにこの関数を使用すると、コレクションを降順で並べ替えることができます。

reverse([<collection>])

例

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

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

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

S

setProperty

JSON オブジェクトのプロパティの値を設定し、更新されたオブジェクトを返します。 設定しようとしたプロパティが存在しない場合、そのプロパティがオブジェクトに追加されます。 新しいプロパティを追加するには、addProperty() 関数を使用します。

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

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

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

例 1

この例では surName 関数を使用して文字列から JSON に変換される JSON オブジェクトに プロパティを設定します。 この関数は、指定された値をこのプロパティに割り当て、更新されたオブジェクトを返します。

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

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

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

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

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

例 2

この例では、surName 関数を使用して文字列から JSON に変換される JSON オブジェクトの customerName 親プロパティに 子プロパティを設定します。 この関数は、指定された値をこのプロパティに割り当て、更新されたオブジェクトを返します。

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

例

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

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

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

スライス

開始およびは終了位置または値を指定して部分文字列を返します。 「substring()」も参照してください。

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

例

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

例 1

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

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

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

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

例 1

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

split('a_b_c', '_')

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

例 2

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

split('a_b_c', ' ')

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

startOfDay

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

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

例

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

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

返される結果: "2018-03-15T00:00:00.0000000Z"

startOfHour

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

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

例

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

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

返される結果: "2018-03-15T13:00:00.0000000Z"

startOfMonth

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

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

例 1

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

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

返される結果: "2018-03-01T00:00:00.0000000Z"

例 2

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

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

返される結果: "2018-03-01"

startsWith

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

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

例 1

この例は、文字列 "hello world" が部分文字列 "hello" で始まっているかどうかを調べます。

startsWith('hello world', 'hello')

返される結果: true

例 2

この例は、文字列 "hello world" が部分文字列 "greetings" で始まっているかどうかを調べます。

startsWith('hello world', 'greetings')

返される結果: false

文字列

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

string(<value>)

例 1

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

string(10)

返される結果: "10"

例 2

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

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

返される結果: "{ \\"name\\": \\"Sophie Owen\\" }"

sub

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

sub(<minuend>, <subtrahend>)

例

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

sub(10.3, .3)

返される結果: 10

substring

文字列から、指定された位置またはインデックスから始まる文字を返します。 インデックス値は 0 から始まります。 「slice()」も参照してください。

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

例

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

substring('hello world', 6, 5)

返される結果: "world"

subtractFromTime

タイムスタンプから時間単位数を減算します。 getPastTime もご覧ください。

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

例 1

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

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

返される結果: "2018-01-01T00:00:00.0000000Z"

例 2

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

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

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

T

take

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

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

例

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

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

次の結果を返します。

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

ticks

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

ticks('<timestamp>')

toLower

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

toLower('<text>')

例

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

toLower('Hello World')

返される結果: "hello world"

toUpper

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

toUpper('<text>')

例

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

toUpper('Hello World')

返される結果: "HELLO WORLD"

トリガ

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

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

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

既定では、この関数はトリガー オブジェクト全体を参照しますが、必要に応じて値を取得するプロパティを指定することができます。 この関数には短縮バージョンがあります。triggerOutputs() および triggerBody() をご覧ください。

trigger()

triggerBody

実行時にトリガーの body 出力を返します。 trigger().outputs.body の短縮形です。 trigger() をご覧ください。

triggerBody()

triggerFormDataMultiValues

トリガーの form-data 出力または form-encoded 出力内のキー名と一致する値の配列を返します。

triggerFormDataMultiValues('<key>')

例

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

triggerFormDataMultiValues('feedUrl')

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

triggerFormDataValue

トリガーの form-data 出力または form-encoded 出力内のキー名と一致する単一の値の文字列を返します。 複数の一致が見つかった場合、関数はエラーをスローします。

triggerFormDataValue('<key>')

例

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

triggerFormDataValue('feedUrl')

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

triggerMultipartBody

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

triggerMultipartBody(<index>)

triggerOutputs

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

triggerOutputs()

トリミングする

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

trim('<text>')

例

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

trim(' Hello World  ')

返される結果: "Hello World"

U

UNION

指定した複数のコレクションの "すべての" 項目を含む 1 つのコレクションを返します。 この関数に渡されるいずれかのコレクションに含まれる項目は、結果にも含まれます。 1 つまたは複数の項目が同じ名前である場合は、その名前を持つ最後の項目が結果に含まれます。

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

例

この例は、以下のコレクションから "すべての" 項目を取得します。

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

返される結果: [1, 2, 3, 10, 101]

URIコンポーネント

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

uriComponent('<value>')

例

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

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

返される結果: "https%3A%2F%2Fcontoso.com"

uriコンポーネントをバイナリに変換

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

uriComponentToBinary('<value>')

例

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

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

返される結果: "aHR0cHM6Ly9jb250b3NvLmNvbQ=="

uriComponentToString

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

uriComponentToString('<value>')

例

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

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

返される結果: "https://contoso.com"

uriHost (URIホスト)

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

uriHost('<uri>')

例

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

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

返される結果: "www.localhost.com"

uriPath

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

uriPath('<uri>')

例

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

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

返される結果: "/catalog/shownew.htm"

uriPathAndQuery（URIパスおよびクエリ）

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

uriPathAndQuery('<uri>')

例

この例は、次の 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>')

例

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

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

返される結果: 8080

URIクエリ

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

uriQuery('<uri>')

例

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

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

返される結果: "?date=today"

URIスキーム

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

uriScheme('<uri>')

例

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

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

返される結果: "http"

utcNow（現在のUTC時間を取得する機能）

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

utcNow('<format>')

必要に応じて、<format> パラメーターで異なる形式を指定できます。

例 1

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

utcNow()

返される結果: "2018-04-15T13:00:00.0000000Z"

例 2

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

utcNow('D')

返される結果: "Sunday, April 15, 2018"

V

変数

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

variables('<variableName>')

例

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

variables('numItems')

返される結果: 20

W

ワークフロー

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

workflow().<property>

例 1

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

workflow().run.name

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

例 1

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

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

返される結果の XML:

<name>Sophia Owen</name>

例 2

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

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

返される結果の XML:

<name>Sophia Owen</name>

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

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

さらに、この例では、parameters() 関数を使って 'items' から XML 文字列を取得し、xml() 関数を使って文字列を XML 形式に変換します。

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

[ Gala, Honeycrisp ]

例 2

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

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

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

例 3

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

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

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

例 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 ]

例 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 ]

例 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

例 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

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

例 9

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

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

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

次のステップ

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