Azure Logic Apps のワークフロー定義言語スキーマWorkflow Definition Language schema for Azure Logic Apps

ワークフロー定義には、ロジック アプリの一部として実行される実際のロジックが含まれます。A workflow definition contains the actual logic that executes as a part of your logic app. この定義には、ロジック アプリを開始する 1 つ以上のトリガーと、ロジック アプリが実行する 1 つ以上のアクションが含まれます。This definition includes one or more triggers that start the logic app, and one or more actions for the logic app to take.

ワークフロー定義の基本構造Basic workflow definition structure

ワークフロー定義の基本的な構造を次に示します。Here is the basic structure of a workflow definition:

{
    "$schema": "<schema-of the-definition>",
    "contentVersion": "<version-number-of-definition>",
    "parameters": { <parameter-definitions-of-definition> },
    "triggers": [ { <definition-of-flow-triggers> } ],
    "actions": [ { <definition-of-flow-actions> } ],
    "outputs": { <output-of-definition> }
}

注意

ロジック アプリのワークフローを作成および管理する方法については、ワークフロー管理 REST API のドキュメントをご覧ください。The Workflow Management REST API documentation has information on how to create and manage logic app workflows.

要素名Element name 必須Required 説明Description
$schema$schema いいえNo 定義言語のバージョンが記述されている JSON スキーマ ファイルの場所を指定します。Specifies the location for the JSON schema file that describes the version of the definition language. この場所は、外部の定義を参照する場合に必要です。This location is required when you reference a definition externally. このドキュメントの場所は次のとおりです。For this document, the location is:

https://schema.management.azure.com/providers/Microsoft.Logic/schemas/2015-08-01-preview/workflowdefinition.json#

contentVersioncontentVersion いいえNo 定義のバージョンを指定します。Specifies the definition version. 定義を使ってワークフローをデプロイするとき、この値を使って、正しい定義が確実に使われるようにすることができます。When you deploy a workflow using the definition, you can use this value to make sure that the right definition is used.
parametersparameters なしNo 定義へのデータの入力に使うパラメーターを指定します。Specifies parameters used to input data into the definition. 最大 50 個のパラメーターを定義することができます。A maximum of 50 parameters can be defined.
トリガーtriggers いいえNo ワークフローを開始するトリガーの情報を指定します。Specifies information for the triggers that initiate the workflow. 最大 10 個のトリガーを定義できます。A maximum of 10 triggers can be defined.
actionsactions いいえNo フローの実行時に行うアクションを指定します。Specifies actions that are taken as the flow executes. 最大 250 個のアクションを定義できます。A maximum of 250 actions can be defined.
outputsoutputs いいえNo デプロイされるリソースに関する情報を指定します。Specifies information about the deployed resource. 最大 10 個の出力を定義できます。A maximum of 10 outputs can be defined.

parametersParameters

このセクションでは、デプロイ時にワークフロー定義で使われるすべてのパラメーターを指定します。This section specifies all the parameters that are used in the workflow definition at deployment time. 定義の他のセクションでパラメーターを使う前に、このセクションですべてのパラメーターを宣言する必要があります。All parameters must be declared in this section before they can be used in other sections of the definition.

パラメーター定義の構造の例を次に示します。The following example shows the structure of a parameter definition:

"parameters": {
    "<parameter-name>" : {
        "type" : "<type-of-parameter-value>",
        "defaultValue": <default-value-of-parameter>,
        "allowedValues": [ <array-of-allowed-values> ],
        "metadata" : { "key": { "name": "value"} }
    }
}
要素名Element name 必須Required 説明Description
typetype はいYes : stringType: string

宣言: "parameters": {"parameter1": {"type": "string"}Declaration: "parameters": {"parameter1": {"type": "string"}

指定: "parameters": {"parameter1": {"value": "myparamvalue1"}}Specification: "parameters": {"parameter1": {"value": "myparamvalue1"}}

: securestringType: securestring

宣言: "parameters": {"parameter1": {"type": "securestring"}}Declaration: "parameters": {"parameter1": {"type": "securestring"}}

指定: "parameters": {"parameter1": {"value": "myparamvalue1"}}Specification: "parameters": {"parameter1": {"value": "myparamvalue1"}}

: intType: int

宣言: "parameters": {"parameter1": {"type": "int"}}Declaration: "parameters": {"parameter1": {"type": "int"}}

指定: "parameters": {"parameter1": {"value" : 5}}Specification: "parameters": {"parameter1": {"value" : 5}}

: boolType: bool

宣言: "parameters": {"parameter1": {"type": "bool"}}Declaration: "parameters": {"parameter1": {"type": "bool"}}

指定: "parameters": {"parameter1": { "value": true }}Specification: "parameters": {"parameter1": { "value": true }}

: arrayType: array

宣言: "parameters": {"parameter1": {"type": "array"}}Declaration: "parameters": {"parameter1": {"type": "array"}}

指定: "parameters": {"parameter1": { "value": [ array-of-values ]}}Specification: "parameters": {"parameter1": { "value": [ array-of-values ]}}

: objectType: object

宣言: "parameters": {"parameter1": {"type": "object"}}Declaration: "parameters": {"parameter1": {"type": "object"}}

指定: "parameters": {"parameter1": { "value": { JSON-object } }}Specification: "parameters": {"parameter1": { "value": { JSON-object } }}

: secureobjectType: secureobject

宣言: "parameters": {"parameter1": {"type": "object"}}Declaration: "parameters": {"parameter1": {"type": "object"}}

指定: "parameters": {"parameter1": { "value": { JSON-object } }}Specification: "parameters": {"parameter1": { "value": { JSON-object } }}

注: securestring 型と secureobject 型は、GET 操作では返されません。Note: The securestring and secureobject types are not returned in GET operations. すべてのパスワード、キー、シークレットで、この型を使う必要があります。All passwords, keys, and secrets should use this type.

defaultValuedefaultValue いいえNo リソース作成時に値が指定されないときの、パラメーターの既定値を指定します。Specifies the default value for the parameter when no value is specified at the time the resource is created.
allowedValuesallowedValues いいえNo パラメーターに許可される値の配列を指定します。Specifies an array of allowed values for the parameter.
metadatametadata いいえNo 読み取り可能な説明や、Visual Studio または他のツールによって使われる設計時データなど、パラメーターに関する追加情報を指定します。Specifies additional information about the parameter, such as a readable description or design-time data used by Visual Studio or other tools.

次の例では、アクションの body セクションでパラメーターを使う方法を示します。This example shows how you can use a parameter in the body section of an action:

"body" :
{
  "property1": "@parameters('parameter1')"
}

パラメーターは出力で使うこともできます。Parameters can also be used in outputs.

トリガーとアクションTriggers and actions

トリガーとアクションでは、ワークフローの実行に含めることができる呼び出しを指定します。Triggers and actions specify the calls that can participate in workflow execution. このセクションについて詳しくは、「ワークフローのアクションとトリガー」をご覧ください。For details about this section, see Workflow Actions and Triggers.

出力Outputs

outputs では、ワークフローの実行から返すことができる情報を指定します。Outputs specify information that can be returned from a workflow run. たとえば、各実行で追跡する特定の状態または値がある場合、そのデータを実行の出力に含めることができます。For example, if you have a specific status or value that you want to track for each run, you can include that data in the run outputs. データは、その実行の管理 REST API と、その実行に対する Azure Portal の管理 UI に表示されます。The data appears in the Management REST API for that run, and in the management UI for that run in the Azure portal. また、PowerBI などの他の外部システムにこれらの出力を送って、ダッシュボードを作成することもできます。You can also flow these outputs to other external systems like PowerBI for creating dashboards. サービス REST API で受信した要求に応答するために出力が使われることは "ありません"。Outputs are not used to respond to incoming requests on the Service REST API. response アクション タイプを使って受信要求に応答する例を次に示します。To respond to an incoming request using the response action type, here's an example:

"outputs": {  
  "key1": {  
    "value": "value1",  
    "type" : "<type-of-value>"  
  }  
} 
要素名Element name 必須Required DescriptionDescription
key1key1 はいYes 出力のキー ID を指定します。Specifies the key identifier for the output. key1 は、出力の識別に使う名前に置き換えます。Replace key1 with a name that you want to use to identify the output.
value はいYes 出力の値を指定します。Specifies the value of the output.
typetype はいYes 指定した値の型を指定します。Specifies the type for the value that was specified. 指定できる値の型は次のとおりです。Possible types of values are:
  • string
  • securestring
  • int
  • bool
  • array
  • object

Expressions

定義の JSON 値には、リテラル、または定義使用時に評価される式を、使うことができます。JSON values in the definition can be literal, or they can be expressions that are evaluated when the definition is used. 次に例を示します。For example:

"name": "value"

またはor

"name": "@parameters('password') "

注意

一部の式は、実行開始時には存在しない可能性のある値を実行時のアクションから取得します。Some expressions get their values from runtime actions that might not exist at the beginning of the execution. 関数を使って、これらの値の一部を取得できます。You can use functions to help retrieve some of these values.

式は、JSON 文字列値内の任意の場所で使うことができ、常に別の JSON 値になります。Expressions can appear anywhere in a JSON string value and always result in another JSON value. JSON 値が式であると特定されると、アットマーク (@) を削除することによって式の本体が抽出されます。When a JSON value has been determined to be an expression, the body of the expression is extracted by removing the at-sign (@). @ で始まるリテラル文字列が必要な場合は、@@ を使って文字列をエスケープする必要があります。If a literal string is needed that starts with @, that string must be escaped by using @@. 式の評価方法の例を次に示します。The following examples show how expressions are evaluated.

JSON 値JSON value 結果Result
"parameters""parameters" 文字 "parameters" が返されます。The characters 'parameters' are returned.
"parameters [1]""parameters[1]" 文字 "parameters[1]" が返されます。The characters 'parameters[1]' are returned.
"@@"</span><span class="sxs-lookup">"@@" "@" を含む 1 文字の文字列が返されます。</span><span class="sxs-lookup">A 1 character string that contains '@' is returned.
" @"</span><span class="sxs-lookup">" @" " @" を含む 2 文字の文字列が返されます。</span><span class="sxs-lookup">A 2 character string that contains ' @' is returned.

"文字列の補間" により、式が @{ ... } にラップされている文字列の内部で式を使うこともできます。With string interpolation, expressions can also appear inside strings where expressions are wrapped in @{ ... }. For example:For example:

"name" : "First Name: @{parameters('firstName')} Last Name: @{parameters('lastName')}"

結果は常に文字列であり、この機能は concat 関数に似ています。The result is always a string, which makes this feature similar to the concat function. myNumber42myStringsampleString と定義されているものとします。Suppose you defined myNumber as 42 and myString as sampleString:

JSON 値JSON value 結果Result
"@parameters('myString')""@parameters('myString')" sampleString が文字列として返されます。Returns sampleString as a string.
"@{parameters('myString')}""@{parameters('myString')}" sampleString が文字列として返されます。Returns sampleString as a string.
"@parameters('myNumber')""@parameters('myNumber')" 42 が "数値" として返されます。Returns 42 as a number.
"@{parameters('myNumber')}""@{parameters('myNumber')}" 42 が "文字列" として返されます。Returns 42 as a string.
"Answer is: @{parameters('myNumber')}""Answer is: @{parameters('myNumber')}" 文字列 Answer is: 42 が返されます。Returns the string Answer is: 42.
"@concat('Answer is: ', string(parameters('myNumber')))""@concat('Answer is: ', string(parameters('myNumber')))" 文字列 Answer is: 42 が返されます。Returns the string Answer is: 42
"Answer is: @@{parameters('myNumber')}""Answer is: @@{parameters('myNumber')}" 文字列 Answer is: @{parameters('myNumber')} が返されます。Returns the string Answer is: @{parameters('myNumber')}.

演算子Operators

演算子は、式または関数の中で使うことができる文字です。Operators are the characters that you can use inside expressions or functions.

演算子Operator DescriptionDescription
に関するページを参照してください。. ドット演算子を使うと、オブジェクトのプロパティを参照できます。The dot operator allows you to reference properties of an object
?? 疑問符演算子を使うと、実行時エラーを発生させずに、オブジェクトの null プロパティを参照できます。The question mark operator lets you reference null properties of an object without a runtime error. たとえば、次の式を使って、null トリガー出力を処理できます。For example, you can use this expression to handle null trigger outputs:

@coalesce(trigger().outputs?.body?.property1, 'my default value')

'' 単一引用符は、文字列リテラルをラップする唯一の方法です。The single quotation mark is the only way to wrap string literals. 式の内部で二重引用符を使うことはできません。この区切り記号は、式全体をラップする JSON の引用符と競合するためです。You cannot use double-quotes inside expressions because this punctuation conflicts with the JSON quote that wraps the whole expression.
[][] 角かっこは、配列から特定のインデックスの値を取得するために使うことができます。The square brackets can be used to get a value from an array with a specific index. たとえば、range(0,10)forEach 関数に渡すアクションがある場合、次の関数を使って配列から項目を取得できます。For example, if you have an action that passes range(0,10)in to the forEach function, you can use this function to get items out of arrays:

myArray[item()]

関数Functions

式の中で関数を呼び出すこともできます。You can also call functions within expressions. 次の表では、式の中で使うことができる関数を示します。The following table shows the functions that can be used in an expression.

Expression 評価Evaluation
"@function('Hello')""@function('Hello')" リテラル文字列 "Hello" を最初のパラメーターとして使って、定義の関数メンバーを呼び出します。Calls the function member of the definition with the literal string Hello as the first parameter.
"@function('It"s Cool!')""@function('It''s Cool!')" リテラル文字列 "It's Cool!" をCalls the function member of the definition with the literal string 'It's Cool!' 最初のパラメーターとして使って、定義の関数メンバーを呼び出します。as the first parameter
"@function().prop1""@function().prop1" 定義の myfunction メンバーの prop1 プロパティの値を返します。Returns the value of the prop1 property of the myfunction member of the definition.
"@function('Hello').prop1""@function('Hello').prop1" リテラル文字列 "Hello" を最初のパラメーターとして使って定義の関数メンバーを呼び出し、オブジェクトの prop1 プロパティを返します。Calls the function member of the definition with the literal string 'Hello' as the first parameter and returns the prop1 property of the object.
"@function(parameters('Hello'))""@function(parameters('Hello'))" "Hello" パラメーターを評価し、値を関数に渡します。Evaluates the Hello parameter and passes the value to function

関数の参照Referencing functions

これらの関数を使うと、ロジック アプリ内の他のアクションからの出力や、ロジック アプリの作成時に渡された値を、参照することができます。You can use these functions to reference outputs from other actions in the logic app or values passed in when the logic app was created. たとえば、あるステップからのデータを参照して、別のステップで使うことができます。For example, you can reference the data from one step to use it in another.

関数名Function name DescriptionDescription
parametersparameters 定義で定義されているパラメーター値を返します。Returns a parameter value that is defined in the definition.

parameters('password')

パラメーター番号: 1Parameter number: 1

名前: ParameterName: Parameter

説明: 必須。Description: Required. 値が必要なパラメーターの値の名前です。The name of the parameter whose values you want.

actionaction 式で、他の JSON の名前と値のペアから、または現在の実行時アクションの出力から、値を導出することができます。Enables an expression to derive its value from other JSON name and value pairs or the output of the current runtime action. 次の例で propertyPath によって表されるプロパティは省略可能です。The property represented by propertyPath in the following example is optional. propertyPath を指定しないと、アクション オブジェクト全体を参照します。If propertyPath is not specified, the reference is to the whole action object. この関数は、アクションの do-until 条件の中でのみ使うことができます。This function can only be used inside do-until conditions of an action.

action().outputs.body.propertyPath

actionsactions 式で、他の JSON の名前と値のペアから、または実行時アクションの出力から、値を導出することができます。Enables an expression to derive its value from other JSON name and value pairs or the output of the runtime action. これらの式では、1 つのアクションが別のアクションに依存することを明示的に宣言します。These expressions explicitly declare that one action depends on another action. 次の例で propertyPath によって表されるプロパティは省略可能です。The property represented by propertyPath in the following example is optional. propertyPath を指定しないと、アクション オブジェクト全体を参照します。If propertyPath is not specified, the reference is to the whole action object. この要素または conditions 要素のいずれかを使って依存関係を指定できますが、同じ依存リソースに両方の要素を使う必要はありません。You can use either this element or the conditions element to specify dependencies, but you do not need to use both for the same dependent resource.

actions('myAction').outputs.body.propertyPath

パラメーター番号: 1Parameter number: 1

名前: Action nameName: Action name

説明: 必須。Description: Required. 値が必要なアクションの値の名前です。The name of the action whose values you want.

アクション オブジェクトでは次のプロパティを使用できます。Available properties on the action object are:

  • name
  • startTime
  • endTime
  • inputs
  • outputs
  • status
  • code
  • trackingId
  • clientTrackingId

これらのプロパティについて詳しくは、Rest API に関するページをご覧ください。See the Rest API for details on those properties.

triggertrigger 式で、他の JSON の名前と値のペアから、または実行時トリガーの出力から、値を導出することができます。Enables an expression to derive its value from other JSON name and value pairs or the output of the runtime trigger. 次の例で propertyPath によって表されるプロパティは省略可能です。The property represented by propertyPath in the following example is optional. propertyPath を指定しないと、トリガー オブジェクト全体を参照します。If propertyPath is not specified, the reference is to the whole trigger object.

trigger().outputs.body.propertyPath

トリガーの入力の中で使うと、関数は前の実行の出力を返します。When used inside a trigger's inputs, the function returns the outputs of the previous execution. 一方、トリガーの条件の中で使うと、trigger 関数は現在の実行の出力を返します。However, when used inside a trigger's condition, the trigger function returns the outputs of the current execution.

トリガー オブジェクトでは次のプロパティを使用できます。Available properties on the trigger object are:

  • name
  • scheduledTime
  • startTime
  • endTime
  • inputs
  • outputs
  • status
  • code
  • trackingId
  • clientTrackingId

これらのプロパティについて詳しくは、Rest API に関するページをご覧ください。See the Rest API for details on those properties.

actionOutputsactionOutputs この関数は、actions('actionName').outputs の短縮形です。This function is shorthand for actions('actionName').outputs

パラメーター番号: 1Parameter number: 1

名前: Action nameName: Action name

説明: 必須。Description: Required. 値が必要なアクションの値の名前です。The name of the action whose values you want.

actionBody、bodyactionBody and body これらの関数は、actions('actionName').outputs.body の短縮形です。These functions are shorthand for actions('actionName').outputs.body

パラメーター番号: 1Parameter number: 1

名前: Action nameName: Action name

説明: 必須。Description: Required. 値が必要なアクションの値の名前です。The name of the action whose values you want.

triggerOutputstriggerOutputs この関数は、trigger().outputs の短縮形です。This function is shorthand for trigger().outputs
triggerBodytriggerBody この関数は、trigger().outputs.body の短縮形です。This function is shorthand for trigger().outputs.body
itemitem 繰り返しアクションの中で使うと、この関数は、アクションのその繰り返しに対する配列の項目を返します。When used inside a repeating action, this function returns the item that is in the array for this iteration of the action. たとえば、メッセージの配列の各項目に対して実行するアクションがある場合は、次の構文を使うことができます。For example, if you have an action that runs for each item an array of messages, you can use this syntax:

"input1" : "@item().subject"

コレクション関数Collection functions

これらの関数はコレクションで動作し、一般に、配列や文字列、場合によっては辞書に適用します。These functions operate over collections and generally apply to Arrays, Strings, and sometimes Dictionaries.

関数名Function name 説明Description
containscontains ディクショナリにキーが含まれる場合、リストに値が含まれる場合、または文字列に部分文字列が含まれる場合、true を返します。Returns true if dictionary contains a key, list contains value, or string contains substring. たとえば、次の関数は true を返します。For example, this function returns true:

contains('abacaba','aca')

パラメーター番号: 1Parameter number: 1

名前: Within collectionName: Within collection

説明: 必須。Description: Required. その中で検索を行うコレクションです。The collection to search within.

パラメーター番号: 2Parameter number: 2

名前: Find objectName: Find object

説明: 必須。Description: Required. Within collection 内で検索するオブジェクトです。The object to find inside the Within collection.

lengthlength 配列または文字列内の要素の数を返します。Returns the number of elements in an array or string. たとえば、次の関数は 3 を返します。For example, this function returns 3:

length('abc')

パラメーター番号: 1Parameter number: 1

Name: CollectionName: Collection

説明: 必須。Description: Required. 長さを取得する対象のコレクションです。The collection for which to get the length.

emptyempty オブジェクト、配列、または文字列が空の場合は true を返します。Returns true if object, array, or string is empty. たとえば、次の関数は true を返します。For example, this function returns true:

empty('')

パラメーター番号: 1Parameter number: 1

Name: CollectionName: Collection

説明: 必須。Description: Required. 空かどうかを確認するコレクションです。The collection to check if it is empty.

intersectionintersection 渡された複数の配列またはオブジェクトの間の共通要素を含む 1 つの配列またはオブジェクトを返します。Returns a single array or object that has common elements between arrays or objects passed in. たとえば、次の関数は [1, 2] を返します。For example, this function returns [1, 2]:

intersection([1, 2, 3], [101, 2, 1, 10],[6, 8, 1, 2])

関数のパラメーターは、オブジェクトのセットまたは配列のセットです (両方を混ぜることはできません)。The parameters for the function can either be a set of objects or a set of arrays (not a mixture of both). 同じ名前のオブジェクトが複数ある場合は、その名前を持つ最後のオブジェクトが最終的なオブジェクトに含まれます。If there are two objects with the same name, the last object with that name appears in the final object.

パラメーター番号: 1 ... nParameter number: 1 ... n

名前: Collection nName: Collection n

説明: 必須。Description: Required. 評価対象のコレクションです。The collections to evaluate. 結果にオブジェクトが含まれるには、渡されるすべてのコレクションにオブジェクトが存在する必要があります。An object must be in all collections passed in to appear in the result.

unionunion この関数に渡された配列またはオブジェクトのすべての要素を含む 1 つの配列またはオブジェクトを返します。Returns a single array or object with all the elements that are in either array or object passed to this function. たとえば、次の関数は [1, 2, 3, 10, 101] を返します。For example, this function returns [1, 2, 3, 10, 101]:

union([1, 2, 3], [101, 2, 1, 10])

関数のパラメーターは、オブジェクトのセットまたは配列のセットです (両方を混ぜることはできません)。The parameters for the function can either be a set of objects or a set of arrays (not a mixture thereof). 最終的な出力に同じ名前のオブジェクトが複数ある場合は、その名前を持つ最後のオブジェクトが最終的なオブジェクトに含まれます。If there are two objects with the same name in the final output, the last object with that name appears in the final object.

パラメーター番号: 1 ... nParameter number: 1 ... n

名前: Collection nName: Collection n

説明: 必須。Description: Required. 評価対象のコレクションです。The collections to evaluate. いずれかのコレクションに存在するオブジェクトは、結果にも含まれます。An object that appears in any of the collections also appears in the result.

firstfirst 渡された配列または文字列の最初の要素を返します。Returns the first element in the array or string passed in. たとえば、次の関数は 0 を返します。For example, this function returns 0:

first([0,2,3])

パラメーター番号: 1Parameter number: 1

Name: CollectionName: Collection

説明: 必須。Description: Required. 最初のオブジェクトを取得するコレクションです。The collection to take the first object from.

lastlast 渡された配列または文字列の最後の要素を返します。Returns the last element in the array or string passed in. たとえば、次の関数は 3 を返します。For example, this function returns 3:

last('0123')

パラメーター番号: 1Parameter number: 1

Name: CollectionName: Collection

説明: 必須。Description: Required. 最後のオブジェクトを取得するコレクションです。The collection to take the last object from.

taketake 渡された配列または文字列の最初の Count 個の要素を返します。Returns the first Count elements from the array or string passed in. たとえば、次の関数は [1, 2] を返します。For example, this function returns [1, 2]:

take([1, 2, 3, 4], 2)

パラメーター番号: 1Parameter number: 1

Name: CollectionName: Collection

説明: 必須。Description: Required. 最初の Count 個のオブジェクトを取得するコレクションです。The collection from where to take the first Count objects.

パラメーター番号: 2Parameter number: 2

名前: CountName: Count

説明: 必須。Description: Required. Collection から取得するオブジェクトの数です。The number of objects to take from the Collection. 正の整数にする必要があります。Must be a positive integer.

skipskip 配列のインデックス Count 以降の要素を返します。Returns the elements in the array starting at index Count. たとえば、次の関数は [3, 4] を返します。For example, this function returns [3, 4]:

skip([1, 2 ,3 ,4], 2)

パラメーター番号: 1Parameter number: 1

Name: CollectionName: Collection

説明: 必須。Description: Required. 最初の Count 個のオブジェクトをスキップするコレクションです。The collection to skip the first Count objects from.

パラメーター番号: 2Parameter number: 2

名前: CountName: Count

説明: 必須。Description: Required. Collection の先頭から除去するオブジェクトの数です。The number of objects to remove from the front of Collection. 正の整数にする必要があります。Must be a positive integer.

joinjoin 配列の各要素を区切り記号で結合した文字列を返します。たとえば、次の関数は "1,2,3,4" を返します。Returns a string with each item of an array joined by a delimiter, for example this returns "1,2,3,4":

join([1, 2, 3, 4], ',')

パラメーター番号: 1Parameter number: 1

Name: CollectionName: Collection

説明: 必須。Description: Required. 項目を結合するコレクションです。The collection to join items from.

パラメーター番号: 2Parameter number: 2

名前: DelimiterName: Delimiter

説明: 必須。Description: Required. 項目を区切る文字列です。The string to delimit items with.

文字列関数String functions

次の関数は、文字列にのみ適用されます。The following functions only apply to strings. 文字列には一部のコレクション関数を使うこともできます。You can also use some collection functions on strings.

関数名Function name 説明Description
concatconcat 任意の数の文字列を結合します。Combines any number of strings together. たとえば、パラメーター 1 が p1 の場合、次の関数は somevalue-p1-somevalue を返します。For example, if parameter 1 is p1, this function returns somevalue-p1-somevalue:

concat('somevalue-',parameters('parameter1'),'-somevalue')

パラメーター番号: 1 ... nParameter number: 1 ... n

名前: String nName: String n

説明: 必須。Description: Required. 1 つの文字列に結合する文字列です。The strings to combine into a single string.

substringsubstring 文字列から文字のサブセットを返します。Returns a subset of characters from a string. たとえば、次の関数は abc を返します。For example, this function returns abc:

substring('somevalue-abc-somevalue',10,3)

パラメーター番号: 1Parameter number: 1

名前: StringName: String

説明: 必須。Description: Required. 部分文字列を取得する文字列です。The string from which the substring is taken.

パラメーター番号: 2Parameter number: 2

名前: Start indexName: Start index

説明: 必須。Description: Required. パラメーター 1 で取得する部分文字列の開始位置のインデックスです。The index of where the substring begins in parameter 1.

パラメーター番号: 3Parameter number: 3

名前: LengthName: Length

説明: 必須。Description: Required. 部分文字列の長さです。The length of the substring.

replacereplace 文字列を指定された文字列に置き換えます。Replaces a string with a given string. たとえば、次の関数は the new string を返します。For example, this function returns the new string:

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

パラメーター番号: 1Parameter number: 1

名前: stringName: string

説明: 必須。Description: Required. この文字列内でパラメーター 2 を検索し、見つかった場合は、パラメーター 3 に置き換えます。The string that is searched for parameter 2 and updated with parameter 3, when parameter 2 is found in parameter 1.

パラメーター番号: 2Parameter number: 2

名前: Old stringName: Old string

説明: 必須。Description: Required. この文字列をパラメーター 1 で検索し、一致するものが見つかった場合はパラメーター 3 に置き換えます。The string to replace with parameter 3, when a match is found in parameter 1

パラメーター番号: 3Parameter number: 3

名前: New stringName: New string

説明: 必須。Description: Required. パラメーター 1 でパラメーター 2 と一致する文字列が見つかった場合、この文字列に置き換えます。The string that is used to replace the string in parameter 2 when a match is found in parameter 1.

guidguid この関数は、グローバルに一意の文字列 (GUID) を生成します。This function generates a globally unique string (GUID). たとえば、次の関数は c2ecc88d-88c8-4096-912c-d6f2e2b138ce という GUID を生成できます。For example, this function can generate this GUID: c2ecc88d-88c8-4096-912c-d6f2e2b138ce

guid()

パラメーター番号: 1Parameter number: 1

名前: FormatName: Format

説明: 省略可能。Description: Optional. この GUID の値の書式設定方法を示す単一の書式設定指定子です。A single format specifier that indicates how to format the value of this Guid. 指定できる書式設定パラメーターは、"N"、"D"、"B"、"P"、"X" です。The format parameter can be "N", "D", "B", "P", or "X". 指定しないと、"D" が使われます。If format is not provided, "D" is used.

toLowertoLower 文字列を小文字に変換します。Converts a string to lowercase. たとえば、次の関数は two by two is four を返します。For example, this function returns two by two is four:

toLower('Two by Two is Four')

パラメーター番号: 1Parameter number: 1

名前: StringName: String

説明: 必須。Description: Required. 小文字に変換する文字列です。The string to convert to lower casing. 文字列内の文字に小文字に相当する文字がない場合、変更されないまま返されます。If a character in the string does not have a lowercase equivalent, the character is included unchanged in the returned string.

toUppertoUpper 文字列を大文字に変換します。Converts a string to uppercase. たとえば、次の関数は TWO BY TWO IS FOUR を返します。For example, this function returns TWO BY TWO IS FOUR:

toUpper('Two by Two is Four')

パラメーター番号: 1Parameter number: 1

名前: StringName: String

説明: 必須。Description: Required. 大文字に変換する文字列です。The string to convert to upper casing. 文字列内の文字に大文字に相当する文字がない場合、変更されないまま返されます。If a character in the string does not have an uppercase equivalent, the character is included unchanged in the returned string.

indexofindexof 文字列内で値のインデックスを探します。大文字と小文字は区別されません。Find the index of a value within a string case insensitively. たとえば、次の関数は 7 を返します。For example, this function returns 7:

indexof('hello, world.', 'world')

パラメーター番号: 1Parameter number: 1

名前: StringName: String

説明: 必須。Description: Required. 値を含む可能性のある文字列です。The string that may contain the value.

パラメーター番号: 2Parameter number: 2

名前: StringName: String

説明: 必須。Description: Required. インデックスを探す値です。The value to search the index of.

lastindexoflastindexof 文字列内で値の最後のインデックスを探します。大文字と小文字は区別されません。Find the last index of a value within a string case insensitively. たとえば、次の関数は 3 を返します。For example, this function returns 3:

lastindexof('foofoo', 'foo')

パラメーター番号: 1Parameter number: 1

名前: StringName: String

説明: 必須。Description: Required. 値を含む可能性のある文字列です。The string that may contain the value.

パラメーター番号: 2Parameter number: 2

名前: StringName: String

説明: 必須。Description: Required. インデックスを探す値です。The value to search the index of.

startswithstartswith 文字列が値で始まっているかどうかを調べます。大文字と小文字は区別されません。Checks if the string starts with a value case insensitively. たとえば、次の関数は true を返します。For example, this function returns true:

startswith('hello, world', 'hello')

パラメーター番号: 1Parameter number: 1

名前: StringName: String

説明: 必須。Description: Required. 値を含む可能性のある文字列です。The string that may contain the value.

パラメーター番号: 2Parameter number: 2

名前: StringName: String

説明: 必須。Description: Required. 文字列が始まっている可能性のある値です。The value the string may start with.

endswithendswith 文字列が値で終わっているかどうかを調べます。大文字と小文字は区別されません。Checks if the string ends with a value case insensitively. たとえば、次の関数は true を返します。For example, this function returns true:

endswith('hello, world', 'world')

パラメーター番号: 1Parameter number: 1

名前: StringName: String

説明: 必須。Description: Required. 値を含む可能性のある文字列です。The string that may contain the value.

パラメーター番号: 2Parameter number: 2

名前: StringName: String

説明: 必須。Description: Required. 文字列が終わっている可能性のある値です。The value the string may end with.

splitsplit 区切り記号を使って文字列を分割します。Splits the string using a separator. たとえば、次の関数は ["a", "b", "c"] を返します。For example, this function returns ["a", "b", "c"]:

split('a;b;c',';')

パラメーター番号: 1Parameter number: 1

名前: StringName: String

説明: 必須。Description: Required. 分割する文字列です。The string that is split.

パラメーター番号: 2Parameter number: 2

名前: StringName: String

説明: 必須。Description: Required. 区切り記号です。The separator.

論理関数Logical functions

これらの関数は条件の中で役に立ち、ロジックの種類の評価に使うことができます。These functions are useful inside conditions and can be used to evaluate any type of logic.

関数名Function name DescriptionDescription
equalsequals 2 つの値が等しい場合、true を返します。Returns true if two values are equal. たとえば、パラメーター 1 が someValue の場合、次の関数は true を返します。For example, if parameter1 is someValue, this function returns true:

equals(parameters('parameter1'), 'someValue')

パラメーター番号: 1Parameter number: 1

名前: Object 1Name: Object 1

説明: 必須。Description: Required. Object 2 と比較するオブジェクトです。The object to compare to Object 2.

パラメーター番号: 2Parameter number: 2

名前: Object 2Name: Object 2

説明: 必須。Description: Required. Object 1 と比較するオブジェクトです。The object to compare to Object 1.

lessless 1 番目の引数が 2 番目の引数より小さい場合、true を返します。Returns true if the first argument is less than the second. 値として指定できる型は integer、float、string だけであることに注意してください。Note, values can only be of type integer, float, or string. たとえば、次の関数は true を返します。For example, this function returns true:

less(10,100)

パラメーター番号: 1Parameter number: 1

名前: Object 1Name: Object 1

説明: 必須。Description: Required. Object 2 より小さいかどうかを調べるオブジェクトです。The object to check if it is less than Object 2.

パラメーター番号: 2Parameter number: 2

名前: Object 2Name: Object 2

説明: 必須。Description: Required. Object 1 より大きいかどうかを調べるオブジェクトです。The object to check if it is greater than Object 1.

lessOrEqualslessOrEquals 1 番目の引数が 2 番目の引数より小さいか等しい場合、true を返します。Returns true if the first argument is less than or equal to the second. 値として指定できる型は integer、float、string だけであることに注意してください。Note, values can only be of type integer, float, or string. たとえば、次の関数は true を返します。For example, this function returns true:

lessOrEquals(10,10)

パラメーター番号: 1Parameter number: 1

名前: Object 1Name: Object 1

説明: 必須。Description: Required. Object 2 以下かどうかを調べるオブジェクトです。The object to check if it is less or equal to Object 2.

パラメーター番号: 2Parameter number: 2

名前: Object 2Name: Object 2

説明: 必須。Description: Required. Object 1 以上かどうかを調べるオブジェクトです。The object to check if it is greater than or equal to Object 1.

greatergreater 1 番目の引数が 2 番目の引数より大きい場合、true を返します。Returns true if the first argument is greater than the second. 値として指定できる型は integer、float、string だけであることに注意してください。Note, values can only be of type integer, float, or string. たとえば、次の関数は false を返します。For example, this function returns false:

greater(10,10)

パラメーター番号: 1Parameter number: 1

名前: Object 1Name: Object 1

説明: 必須。Description: Required. Object 2 より大きいかどうかを調べるオブジェクトです。The object to check if it is greater than Object 2.

パラメーター番号: 2Parameter number: 2

名前: Object 2Name: Object 2

説明: 必須。Description: Required. Object 1 より小さいかどうかを調べるオブジェクトです。The object to check if it is less than Object 1.

greaterOrEqualsgreaterOrEquals 1 番目の引数が 2 番目の引数より大きいか等しい場合、true を返します。Returns true if the first argument is greater than or equal to the second. 値として指定できる型は integer、float、string だけであることに注意してください。Note, values can only be of type integer, float, or string. たとえば、次の関数は false を返します。For example, this function returns false:

greaterOrEquals(10,100)

パラメーター番号: 1Parameter number: 1

名前: Object 1Name: Object 1

説明: 必須。Description: Required. Object 2 以上かどうかを調べるオブジェクトです。The object to check if it is greater than or equal to Object 2.

パラメーター番号: 2Parameter number: 2

名前: Object 2Name: Object 2

説明: 必須。Description: Required. Object 1 以下かどうかを調べるオブジェクトです。The object to check if it is less than or equal to Object 1.

andand 両方のパラメーターが true の場合、true を返します。Returns true if both parameters are true. 両方の引数は、ブール値である必要があります。Both arguments need to be Booleans. たとえば、次の関数は false を返します。For example, this function returns false:

and(greater(1,10),equals(0,0))

パラメーター番号: 1Parameter number: 1

名前: Boolean 1Name: Boolean 1

説明: 必須。Description: Required. true でなければならない 1 番目の引数です。The first argument that must be true.

パラメーター番号: 2Parameter number: 2

名前: Boolean 2Name: Boolean 2

説明: 必須。Description: Required. true でなければならない 2 番目の引数です。The second argument must be true.

oror どちらかのパラメーターが true の場合、true を返します。Returns true if either parameter is true. 両方の引数は、ブール値である必要があります。Both arguments need to be Booleans. たとえば、次の関数は true を返します。For example, this function returns true:

or(greater(1,10),equals(0,0))

パラメーター番号: 1Parameter number: 1

名前: Boolean 1Name: Boolean 1

説明: 必須。Description: Required. true になることができる 1 番目の引数です。The first argument that may be true.

パラメーター番号: 2Parameter number: 2

名前: Boolean 2Name: Boolean 2

説明: 必須。Description: Required. true になることができる 2 番目の引数です。The second argument may be true.

notnot 両方のパラメーターが false の場合、true を返します。Returns true if the parameters are false. 両方の引数は、ブール値である必要があります。Both arguments need to be Booleans. たとえば、次の関数は true を返します。For example, this function returns true:

not(contains('200 Success','Fail'))

パラメーター番号: 1Parameter number: 1

名前: BooleanName: Boolean

説明: 両方のパラメーターが false の場合、true を返します。Description: Returns true if the parameters are false. 両方の引数は、ブール値である必要があります。Both arguments need to be Booleans. 次の関数は true を返します。not(contains('200 Success','Fail'))This function returns true: not(contains('200 Success','Fail'))

ifif 式が true または false のどちらになるかに基づいて、指定された値を返します。Returns a specified value based on whether the expression resulted in true or false. たとえば、次の関数は "yes" を返します。For example, this function returns "yes":

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

パラメーター番号: 1Parameter number: 1

名前: ExpressionName: Expression

説明: 必須。Description: Required. 式がどちらの値を返す必要があるかを決定するブール値です。A boolean value that determines which value the expression should return.

パラメーター番号: 2Parameter number: 2

名前: TrueName: True

説明: 必須。Description: Required. 式が true の場合に返す値です。The value to return if the expression is true.

パラメーター番号: 3Parameter number: 3

名前: FalseName: False

説明: 必須。Description: Required. 式が false の場合に返す値です。The value to return if the expression is false.

変換関数Conversion functions

これらの関数は、言語の各ネイティブ型の間の変換に使われます。These functions are used to convert between each of the native types in the language:

  • stringstring

  • integerinteger

  • floatfloat

  • booleanboolean

  • arraysarrays

  • dictionariesdictionaries

  • formsforms

関数名Function name DescriptionDescription
intint パラメーターを整数に変換します。Convert the parameter to an integer. たとえば、この関数は 100 を文字列ではなく数値として返します。For example, this function returns 100 as a number, rather than a string:

int('100')

パラメーター番号: 1Parameter number: 1

名前: ValueName: Value

説明: 必須。Description: Required. 整数に変換する値です。The value that is converted to an integer.

stringstring パラメーターを文字列に変換します。Convert the parameter to a string. たとえば、次の関数は '10' を返します。For example, this function returns '10':

string(10)

オブジェクトを文字列に変換することもできます。You can also convert an object to a string. たとえば、myPar パラメーターが 1 つつのプロパティ abc : xyz を含むオブジェクトの場合、この関数は {"abc" : "xyz"} を返します。For example, if the myPar parameter is an object with one property abc : xyz, then this function returns {"abc" : "xyz"}:

string(parameters('myPar'))

パラメーター番号: 1Parameter number: 1

名前: ValueName: Value

説明: 必須。Description: Required. 文字列に変換する値です。The value that is converted to a string.

jsonjson パラメーターを JSON 型の値に変換します。string() の逆です。Convert the parameter to a JSON type value and is the opposite of string(). たとえば、この関数は [1,2,3] を文字列ではなく配列として返します。For example, this function returns [1,2,3] as an array, rather than a string:

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

同様に、文字列をオブジェクトに変換することもできます。Likewise, you can convert a string to an object. たとえば、次の関数は { "abc" : "xyz" } を返します。For example, this function returns { "abc" : "xyz" }:

json('{"abc" : "xyz"}')

パラメーター番号: 1Parameter number: 1

名前: StringName: String

説明: 必須。Description: Required. ネイティブな型の値に変換する文字列です。The string that is converted to a native type value.

json() 関数は、XML の入力もサポートします。The json() function supports XML input too. たとえば、次のようなパラメーター値があるものとします。For example, the parameter value of:

<?xml version="1.0"?> <root> <person id='1'> <name>Alan</name> <occupation>Engineer</occupation> </person> </root>

これは、次の JSON に変換されます。is converted to this JSON:

{ "?xml": { "@version": "1.0" }, "root": { "person": [ { "@id": "1", "name": "Alan", "occupation": "Engineer" } ] } }

floatfloat パラメーター引数を浮動小数点数に変換します。Convert the parameter argument to a floating-point number. たとえば、次の関数は 10.333 を返します。For example, this function returns 10.333:

float('10.333')

パラメーター番号: 1Parameter number: 1

名前: ValueName: Value

説明: 必須。Description: Required. 浮動小数点数に変換する値です。The value that is converted to a floating-point number.

boolbool パラメーターをブール値に変換します。Convert the parameter to a Boolean. たとえば、次の関数は false を返します。For example, this function returns false:

bool(0)

パラメーター番号: 1Parameter number: 1

名前: ValueName: Value

説明: 必須。Description: Required. ブール値に変換する値です。The value that is converted to a boolean.

base64base64 入力文字列の base64 表現を返します。Returns the base64 representation of the input string. たとえば、次の関数は c29tZSBzdHJpbmc= を返します。For example, this function returns c29tZSBzdHJpbmc=:

base64('some string')

パラメーター番号: 1Parameter number: 1

名前: String 1Name: String 1

説明: 必須。Description: Required. base 64 表現にエンコードする文字列です。The string to encode into base64 representation.

base64ToBinarybase64ToBinary base64 でエンコードされた文字列のバイナリ表現を返します。Returns a binary representation of a base64 encoded string. たとえば、次の関数は some string のバイナリ表現を返します。For example, this function returns the binary representation of some string:

base64ToBinary('c29tZSBzdHJpbmc=')

パラメーター番号: 1Parameter number: 1

名前: StringName: String

説明: 必須。Description: Required. base64 でエンコードされた文字列です。The base64 encoded string.

base64ToStringbase64ToString base64 でエンコードされた文字列の文字列表現を返します。Returns a string representation of a based64 encoded string. たとえば、次の関数は some string を返します。For example, this function returns some string:

base64ToString('c29tZSBzdHJpbmc=')

パラメーター番号: 1Parameter number: 1

名前: StringName: String

説明: 必須。Description: Required. base64 でエンコードされた文字列です。The base64 encoded string.

BinaryBinary 値のバイナリ表現を返します。Returns a binary representation of a value. たとえば、次の関数は some string のバイナリ表現を返します。For example, this function returns a binary representation of some string:

binary('some string')

パラメーター番号: 1Parameter number: 1

名前: ValueName: Value

説明: 必須。Description: Required. バイナリに変換する値です。The value that is converted to binary.

dataUriToBinarydataUriToBinary データの URI のバイナリ表現を返します。Returns a binary representation of a data URI. たとえば、次の関数は some string のバイナリ表現を返します。For example, this function returns the binary representation of some string:

dataUriToBinary('data:;base64,c29tZSBzdHJpbmc=')

パラメーター番号: 1Parameter number: 1

名前: StringName: String

説明: 必須。Description: Required. バイナリ表現に変換するデータ URI です。The data URI to convert to binary representation.

dataUriToStringdataUriToString データの URI の文字列表現を返します。Returns a string representation of a data URI. たとえば、次の関数は some string を返します。For example, this function returns some string:

dataUriToString('data:;base64,c29tZSBzdHJpbmc=')

パラメーター番号: 1Parameter number: 1

名前: StringName: String

説明: 必須。Description: Required. 文字列表現に変換するデータ URI です。The data URI to convert to String representation.

dataUridataUri 値のデータ URI を返します。Returns a data URI of a value. たとえば、次の関数はデータ URI text/plain;charset=utf8;base64,c29tZSBzdHJpbmc= を返します。For example, this function returns this data URI text/plain;charset=utf8;base64,c29tZSBzdHJpbmc=:

dataUri('some string')

パラメーター番号: 1Parameter number: 1

名前: ValueName: Value

説明: 必須。Description: Required. データ URI に変換する値です。The value to convert to data URI.

decodeBase64decodeBase64 入力の base64 文字列の文字列表現を返します。Returns a string representation of an input based64 string. たとえば、次の関数は some string を返します。For example, this function returns some string:

decodeBase64('c29tZSBzdHJpbmc=')

パラメーター番号: 1Parameter number: 1

名前: StringName: String

説明: 入力の base64 文字列の文字列表現を返します。Description: Returns a string representation of an input based64 string.

encodeUriComponentencodeUriComponent 渡される URL でエスケープされた文字列です。URL-escapes the string that's passed in. たとえば、次の関数は You+Are%3ACool%2FAwesome を返します。For example, this function returns You+Are%3ACool%2FAwesome:

encodeUriComponent('You Are:Cool/Awesome')

パラメーター番号: 1Parameter number: 1

名前: StringName: String

説明: 必須。Description: Required. URL の安全でない文字をエスケープする文字列です。The string to escape URL-unsafe characters from.

decodeUriComponentdecodeUriComponent 渡された文字列の URL エスケープを解除します。Un-URL-escapes the string that's passed in. たとえば、次の関数は You Are:Cool/Awesome を返します。For example, this function returns You Are:Cool/Awesome:

encodeUriComponent('You+Are%3ACool%2FAwesome')

パラメーター番号: 1Parameter number: 1

名前: StringName: String

説明: 必須。Description: Required. URL の安全でない文字をデコードする文字列です。The string to decode the URL-unsafe characters from.

decodeDataUridecodeDataUri 入力データの URI 文字列のバイナリ表現を返します。Returns a binary representation of an input data URI string. たとえば、次の関数は some string のバイナリ表現を返します。For example, this function returns the binary representation of some string:

decodeDataUri('data:;base64,c29tZSBzdHJpbmc=')

パラメーター番号: 1Parameter number: 1

名前: StringName: String

説明: 必須。Description: Required. バイナリ表現にデコードする dataURI です。The dataURI to decode into a binary representation.

uriComponenturiComponent 値の URI でエンコードされた表現を返します。Returns a URI encoded representation of a value. たとえば、次の関数は You+Are%3ACool%2FAwesome を返します。For example, this function returns You+Are%3ACool%2FAwesome:

uriComponent('You Are:Cool/Awesome')

パラメーター番号: 1Parameter number: 1

名前: StringName: String

説明: 必須。Description: Required. URI でエンコードする文字列です。The string to be URI encoded.

uriComponentToBinaryuriComponentToBinary URI でエンコードされた文字列のバイナリ表現を返します。Returns a binary representation of a URI encoded string. たとえば、次の関数は You Are:Cool/Awesome のバイナリ表現を返します。For example, this function returns a binary representation of You Are:Cool/Awesome:

uriComponentToBinary('You+Are%3ACool%2FAwesome')

パラメーター番号: 1Parameter number: 1

名前: StringName: String

説明: 必須。Description: Required. URI でエンコードされた文字列です。The URI encoded string.

uriComponentToStringuriComponentToString URI でエンコードされた文字列の文字列表現を返します。Returns a string representation of a URI encoded string. たとえば、次の関数は You Are:Cool/Awesome を返します。For example, this function returns You Are:Cool/Awesome:

uriComponentToBinary('You+Are%3ACool%2FAwesome')

パラメーター番号: 1Parameter number: 1

名前: StringName: String

説明: 必須。Description: Required. URI でエンコードされた文字列です。The URI encoded string.

xmlxml 値の XML 表現を返します。Return an XML representation of the value. たとえば、次の関数は '\<name>Alan\</name>' によって表される XML コンテンツを返します。For example, this function returns XML content represented by '\<name>Alan\</name>':

xml('\<name>Alan\</name>')

xml() 関数は、JSON オブジェクトの入力もサポートします。The xml() function supports JSON object input too. たとえば、パラメーター { "abc": "xyz" } は、XML コンテンツ \<abc>xyz\</abc> に変換されます。For example, the parameter { "abc": "xyz" } is converted to XML content: \<abc>xyz\</abc>

パラメーター番号: 1Parameter number: 1

名前: ValueName: Value

説明: 必須。Description: Required. XML に変換する値です。The value to convert to XML.

arrayarray パラメーターを配列に変換します。Convert the parameter to an array. たとえば、次の関数は ["abc"] を返します。For example, this function returns ["abc"]:

array('abc')

パラメーター番号: 1Parameter number: 1

名前: ValueName: Value

説明: 必須。Description: Required. 配列に変換する値です。The value that is converted to an array.

createArraycreateArray パラメーターから配列を作成します。Creates an array from the parameters. たとえば、次の関数は ["a", "c"] を返します。For example, this function returns ["a", "c"]:

createArray('a', 'c')

パラメーター番号: 1 ... nParameter number: 1 ... n

名前: Any nName: Any n

説明: 必須。Description: Required. 配列に結合する値です。The values to combine into an array.

triggerFormDataValuetriggerFormDataValue form-data または form-encoded トリガー出力のキーと一致する単一の値を返します。Returns a single value matching the key name from form-data or form-encoded trigger output. 一致が複数ある場合は、エラーになります。If there are multiple matches it will error. たとえば、次の式は bar を返します。triggerFormDataValue('foo')For example, the following will return bar: triggerFormDataValue('foo')

パラメーター番号: 1Parameter number: 1

名前: Key NameName: Key Name

説明: 必須。Description: Required. 取得するフォーム データ値のキー名です。The key name of the form data value to return.
triggerFormDataMultiValuestriggerFormDataMultiValues form-data または form-encoded トリガー出力のキーと一致する値の配列を返します。Returns an array of values matching the key name from form-data or form-encoded trigger output. たとえば、次の式は ["bar"] を返します。triggerFormDataValue('foo')For example, the following will return ["bar"]: triggerFormDataValue('foo')

パラメーター番号: 1Parameter number: 1

名前: Key NameName: Key Name

説明: 必須。Description: Required. 取得するフォーム データ値のキー名です。The key name of the form data values to return.
triggerMultipartBodytriggerMultipartBody トリガーのマルチパート出力のパートの本文を返します。Returns the body for a part in a multipart output of the trigger.

パラメーター番号: 1Parameter number: 1

名前: IndexName: Index

説明: 必須。Description: Required. 取得するパートのインデックスです。The index of the part to retrieve.
formDataValueformDataValue form-data または form-encoded アクション出力のキーと一致する単一の値を返します。Returns a single value matching the key name from form-data or form-encoded action output. 一致が複数ある場合は、エラーになります。If there are multiple matches it will error. たとえば、次の式は bar を返します。formDataValue('someAction', 'foo')For example, the following will return bar: formDataValue('someAction', 'foo')

パラメーター番号: 1Parameter number: 1

名前: Action NameName: Action Name

説明: 必須。Description: Required. form-data または form-encoded 応答を含むアクションの名前です。The name of the action with a form-data or form-encoded response.

パラメーター番号: 2Parameter number: 2

名前: Key NameName: Key Name

説明: 必須。Description: Required. 取得するフォーム データ値のキー名です。The key name of the form data value to return.
formDataMultiValuesformDataMultiValues form-data または form-encoded アクション出力のキーと一致する値の配列を返します。Returns an array of values matching the key name from form-data or form-encoded action output. たとえば、次の式は ["bar"] を返します。formDataMultiValues('someAction', 'foo')For example, the following will return ["bar"]: formDataMultiValues('someAction', 'foo')

パラメーター番号: 1Parameter number: 1

名前: Action NameName: Action Name

説明: 必須。Description: Required. form-data または form-encoded 応答を含むアクションの名前です。The name of the action with a form-data or form-encoded response.

パラメーター番号: 2Parameter number: 2

名前: Key NameName: Key Name

説明: 必須。Description: Required. 取得するフォーム データ値のキー名です。The key name of the form data values to return.
multipartBodymultipartBody アクションのマルチパート出力のパートの本文を返します。Returns the body for a part in a multipart output of an action.

パラメーター番号: 1Parameter number: 1

名前: Action NameName: Action Name

説明: 必須。Description: Required. マルチパート応答を含むアクションの名前です。The name of the action with a multipart response.

パラメーター番号: 2Parameter number: 2

名前: IndexName: Index

説明: 必須。Description: Required. 取得するパートのインデックスです。The index of the part to retrieve.

操作関数Manipulation functions

これらの関数は、XML およびオブジェクトに適用されます。These functions apply to XML and objects.

関数名Function name DescriptionDescription
coalescecoalesce 渡された引数で最初の null 以外のオブジェクトを返します。Returns the first non-null object in the arguments passed in. : 空の文字列は null ではありません。Note: An empty string is not null. たとえば、パラメーター 1 と 2 が定義されていない場合、この関数は fallback を返します。For example, if parameters 1 and 2 are not defined, this function returns fallback:

coalesce(parameters('parameter1'), parameters('parameter2') ,'fallback')

パラメーター番号: 1 ... nParameter number: 1 ... n

名前: ObjectnName: Objectn

説明: 必須。Description: Required. null かどうか調べるオブジェクトです。The objects to check for null.

addPropertyaddProperty 追加のプロパティを持つオブジェクトを返します。Returns an object with an additional property. 実行時にプロパティが既に存在する場合は、エラーがスローされます。If the property already exists at runtime an error will be thrown. たとえば、次の関数はオブジェクト { "abc" : "xyz", "def": "uvw" } を返します。For example, this function returns the object { "abc" : "xyz", "def": "uvw" }:

addProperty(json('{"abc" : "xyz"}'), 'def', 'uvw')

パラメーター番号: 1Parameter number: 1

名前: ObjectName: Object

説明: 必須。Description: Required. 新しいプロパティを追加するオブジェクト。The object to add a new property to.

パラメーター番号: 2Parameter number: 2

名前: Property NameName: Property Name

説明: 必須。Description: Required. 新しいプロパティの名前。The name of the new property.

パラメーター番号: 3Parameter number: 3

名前: ValueName: Value

説明: 必須。Description: Required. 新しいプロパティに割り当てる値。The value to assign to the new property.

setPropertysetProperty 追加のプロパティまたは既存のプロパティが指定値に設定されているオブジェクトを返します。Returns an object with an additional property or an existing property set to the given value. たとえば、次の関数はオブジェクト { "abc" : "uvw" } を返します。For example, this function returns the object { "abc" : "uvw" }:

setProperty(json('{"abc" : "xyz"}'), 'abc', 'uvw')

パラメーター番号: 1Parameter number: 1

名前: ObjectName: Object

説明: 必須。Description: Required. プロパティを設定する対象のオブジェクト。The object in which to set the property.

パラメーター番号: 2Parameter number: 2

名前: Property NameName: Property Name

説明: 必須。Description: Required. 新しいプロパティまたは既存のプロパティの名前。The name of the new or existing property.

パラメーター番号: 3Parameter number: 3

名前: ValueName: Value

説明: 必須。Description: Required. プロパティに割り当てる値。The value to assign to the property.

removePropertyremoveProperty プロパティが削除されたオブジェクトを返します。Returns an object with a property removed. 削除するプロパティが存在しない場合は、元のオブジェクトが返されます。If the property to remove does not exist the original object is returned. たとえば、次の関数はオブジェクト { "abc" : "xyz" } を返します。For example, this function returns the object { "abc" : "xyz" }:

removeProperty(json('{"abc" : "xyz", "def": "uvw"}'), 'def')

パラメーター番号: 1Parameter number: 1

名前: ObjectName: Object

説明: 必須。Description: Required. プロパティを削除するオブジェクト。The object to remove the property from.

パラメーター番号: 2Parameter number: 2

名前: Property NameName: Property Name

説明: 必須。Description: Required. 削除するプロパティの名前。The name of the property to remove.

xpathxpath xpath 式が評価された値の xpath 式と一致する XML ノードの配列を返します。Return an array of XML nodes matching the xpath expression of a value that the xpath expression evaluates to.

例 1Example 1

パラメーター p1 の値が、次の XML の文字列表現であるものとします。Assume the value of parameter p1 is a string representation of this XML:

<?xml version="1.0"?> <lab> <robot> <parts>5</parts> <name>R1</name> </robot> <robot> <parts>8</parts> <name>R2</name> </robot> </lab>

コード xpath(xml(parameters('p1')), '/lab/robot/name')This code: xpath(xml(parameters('p1')), '/lab/robot/name')

は、次の値は返します。returns

[ <name>R1</name>, <name>R2</name> ]

一方、コードwhile this code:

xpath(xml(parameters('p1')), ' sum(/lab/robot/parts)')

は、次の値は返します。returns

13

例 2Example 2

次のような XML コンテンツがあるものとします。Given the following XML content:

<?xml version="1.0"?> <File xmlns="http://foo.com"> <Location>bar</Location> </File>

コード @xpath(xml(body('Http')), '/*[name()=\"File\"]/*[name()=\"Location\"]')This code: @xpath(xml(body('Http')), '/*[name()=\"File\"]/*[name()=\"Location\"]')

またはコードor this code:

@xpath(xml(body('Http')), '/*[local-name()=\"File\" and namespace-uri()=\"http://foo.com\"]/*[local-name()=\"Location\" and namespace-uri()=\"\"]')

は、次の値は返します。returns

<Location xmlns="http://abc.com">xyz</Location>

また、コード @xpath(xml(body('Http')), 'string(/*[name()=\"File\"]/*[name()=\"Location\"])')And this code: @xpath(xml(body('Http')), 'string(/*[name()=\"File\"]/*[name()=\"Location\"])')

は、次の値は返します。returns

xyz

パラメーター番号: 1Parameter number: 1

名前: XmlName: Xml

説明: 必須。Description: Required. XPath 式を評価する XML です。The XML on which to evaluate the XPath expression.

パラメーター番号: 2Parameter number: 2

名前: XPathName: XPath

説明: 必須。Description: Required. 評価する XPath 式です。The XPath expression to evaluate.

算術関数Math functions

これらの関数は、integer 型および float 型の値に使うことができます。These functions can be used for either types of numbers: integers and floats.

関数名Function name 説明Description
追加add 2 つの数値を加算した結果を返します。Returns the result from adding the two numbers. たとえば、次の関数は 20.333 を返します。For example, this function returns 20.333:

add(10,10.333)

パラメーター番号: 1Parameter number: 1

名前: Summand 1Name: Summand 1

説明: 必須。Description: Required. Summand 2 に加算する値です。The number to add to Summand 2.

パラメーター番号: 2Parameter number: 2

名前: Summand 2Name: Summand 2

説明: 必須。Description: Required. Summand 1 に加算する値です。The number to add to Summand 1.

subsub 2 つの数値を減算した結果を返します。Returns the result from subtracting two numbers. たとえば、次の関数は -0.333 を返します。For example, this function returns -0.333:

sub(10,10.333)

パラメーター番号: 1Parameter number: 1

名前: MinuendName: Minuend

説明: 必須。Description: Required. Subtrahend を減算する値です。The number that Subtrahend is removed from.

パラメーター番号: 2Parameter number: 2

名前: SubtrahendName: Subtrahend

説明: 必須。Description: Required. Minuend から減算する値です。The number to remove from the Minuend.

mulmul 2 つの数値を乗算した結果を返します。Returns the result from multiplying the two numbers. たとえば、次の関数は 103.33 を返します。For example, this function returns 103.33:

mul(10,10.333)

パラメーター番号: 1Parameter number: 1

名前: Multiplicand 1Name: Multiplicand 1

説明: 必須。Description: Required. Multiplicand 2 と乗算する値です。The number to multiply Multiplicand 2 with.

パラメーター番号: 2Parameter number: 2

名前: Multiplicand 2Name: Multiplicand 2

説明: 必須。Description: Required. Multiplicand 1 と乗算する値です。The number to multiply Multiplicand 1 with.

divdiv 2 つの数値を除算した結果を返します。Returns the result from dividing the two numbers. たとえば、次の関数は 1.0333 を返します。For example, this function returns 1.0333:

div(10.333,10)

パラメーター番号: 1Parameter number: 1

名前: DividendName: Dividend

説明: 必須。Description: Required. Divisor によって除算される値です。The number to divide by the Divisor.

パラメーター番号: 2Parameter number: 2

名前: DivisorName: Divisor

説明: 必須。Description: Required. Dividend を除算する値です。The number to divide the Dividend by.

modmod 2 つの数値を除算した余りを返します (剰余)。Returns the remainder after dividing the two numbers (modulo). たとえば、次の関数は 2 を返します。For example, this function returns 2:

mod(10,4)

パラメーター番号: 1Parameter number: 1

名前: DividendName: Dividend

説明: 必須。Description: Required. Divisor によって除算される値です。The number to divide by the Divisor.

パラメーター番号: 2Parameter number: 2

名前: DivisorName: Divisor

説明: 必須。Description: Required. Dividend を除算する値です。The number to divide the Dividend by. 除算の後、残りの部分が取得されます。After the division, the remainder is taken.

Minmin この関数を呼び出すには 2 つの異なるパターンがあります。There are two different patterns for calling this function.

次の min は配列を受け取り、関数は 0 を返します。Here min takes an array, and the function returns 0:

min([0,1,2])

または、次の関数はコンマ区切りリストを受け取り、やはり 0 を返します。Alternatively, this function can take a comma-separated list of values and also returns 0:

min(0,1,2)

: すべての値は数値でなければならないので、パラメーターが配列の場合、配列は数値だけを含む必要があります。Note: All values must be numbers, so if the parameter is an array, the array has to only have numbers.

パラメーター番号: 1Parameter number: 1

名前: Collection または ValueName: Collection or Value

説明: 必須。Description: Required. 最小値を検索する値の配列、またはセットの最初の値です。Either an array of values to find the minimum value, or the first value of a set.

パラメーター番号: 2 ... nParameter number: 2 ... n

名前: Value nName: Value n

説明: 省略可能。Description: Optional. パラメーター 1 が Value の場合、追加の値を渡すことができ、渡したすべての値の最小値が返されます。If the first parameter is a Value, then you can pass additional values and the minimum of all passed values is returned.

maxmax この関数を呼び出すには 2 つの異なるパターンがあります。There are two different patterns for calling this function.

次の max は配列を受け取り、関数は 2 を返します。Here max takes an array, and the function returns 2:

max([0,1,2])

または、次の関数はコンマ区切りリストを受け取り、やはり 2 を返します。Alternatively, this function can take a comma-separated list of values and also returns 2:

max(0,1,2)

: すべての値は数値でなければならないので、パラメーターが配列の場合、配列は数値だけを含む必要があります。Note: All values must be numbers, so if the parameter is an array, the array has to only have numbers.

パラメーター番号: 1Parameter number: 1

名前: Collection または ValueName: Collection or Value

説明: 必須。Description: Required. 最大値を検索する値の配列、またはセットの最初の値です。Either an array of values to find the maximum value, or the first value of a set.

パラメーター番号: 2 ... nParameter number: 2 ... n

名前: Value nName: Value n

説明: 省略可能。Description: Optional. パラメーター 1 が Value の場合、追加の値を渡すことができ、渡したすべての値の最大値が返されます。If the first parameter is a Value, then you can pass additional values and the maximum of all passed values is returned.

rangerange 特定の値から始まる整数の配列を生成します。Generates an array of integers starting from a certain number. 返される配列の長さを定義します。You define the length of the returned array.

たとえば、次の関数は [3,4,5,6] を返します。For example, this function returns [3,4,5,6]:

range(3,4)

パラメーター番号: 1Parameter number: 1

名前: Start indexName: Start index

説明: 必須。Description: Required. 配列の最初の整数です。The first integer in the array.

パラメーター番号: 2Parameter number: 2

名前: CountName: Count

説明: 必須。Description: Required. この値は、配列内にある整数の個数です。This value is the number of integers that is in the array.

randrand 指定された範囲 (開始値のみを含む) 内で整数の乱数を生成します。Generates a random integer within the specified range (inclusive only on first end). たとえば、この関数は 0 または '1' を返す可能性があります。For example, this function can return either 0 or '1':

rand(0,2)

パラメーター番号: 1Parameter number: 1

名前: MinimumName: Minimum

説明: 必須。Description: Required. 返される可能性のある最小の整数です。The lowest integer that can be returned.

パラメーター番号: 2Parameter number: 2

名前: MaximumName: Maximum

説明: 必須。Description: Required. この値は、返される可能性のある最大の整数の次の整数です。This value is the next integer after the highest integer that could be returned.

データ関数Date functions

関数名Function name DescriptionDescription
utcnowutcnow 現在のタイムスタンプを文字列として返します (例: 2017-03-15T13:27:36Z)。Returns the current timestamp as a string, for example: 2017-03-15T13:27:36Z:

utcnow()

パラメーター番号: 1Parameter number: 1

名前: FormatName: Format

説明: 省略可能。Description: Optional. このタイムスタンプの値を書式設定する方法を示す、単一の書式指定子文字またはカスタム書式指定パターンです。Either a single format specifier character or a custom format pattern that indicates how to format the value of this timestamp. 形式を指定しないと、ISO 8601 形式 ("o") が使われます。If format is not provided, the ISO 8601 format ("o") is used.

addsecondsaddseconds 渡されたタイムスタンプ文字列に秒数を表す整数を追加します。Adds an integer number of seconds to a string timestamp passed in. 秒数は正でも負でもかまいません。The number of seconds can be positive or negative. 書式指定子を指定しない場合の既定値は、ISO 8601 形式 ("o") の文字列です。By default, the result is a string in ISO 8601 format ("o"), unless a format specifier is provided. 例: 2015-03-15T13:27:00ZFor example: 2015-03-15T13:27:00Z:

addseconds('2015-03-15T13:27:36Z', -36)

パラメーター番号: 1Parameter number: 1

名前: TimestampName: Timestamp

説明: 必須。Description: Required. 時刻を表す文字列です。A string that contains the time.

パラメーター番号: 2Parameter number: 2

名前: SecondsName: Seconds

説明: 必須。Description: Required. 追加する秒の値です。The number of seconds to add. 負の値にして秒数を減算できます。Can be negative to subtract seconds.

パラメーター番号: 3Parameter number: 3

名前: FormatName: Format

説明: 省略可能。Description: Optional. このタイムスタンプの値を書式設定する方法を示す、単一の書式指定子文字またはカスタム書式指定パターンです。Either a single format specifier character or a custom format pattern that indicates how to format the value of this timestamp. 形式を指定しないと、ISO 8601 形式 ("o") が使われます。If format is not provided, the ISO 8601 format ("o") is used.

addminutesaddminutes 渡されたタイムスタンプ文字列に分の値を表す整数を追加します。Adds an integer number of minutes to a string timestamp passed in. 分の値は正でも負でもかまいません。The number of minutes can be positive or negative. 書式指定子を指定しない場合の既定値は、ISO 8601 形式 ("o") の文字列です。By default, the result is a string in ISO 8601 format ("o"), unless a format specifier is provided. 例: 2015-03-15T14:00:36ZFor example: 2015-03-15T14:00:36Z:

addminutes('2015-03-15T13:27:36Z', 33)

パラメーター番号: 1Parameter number: 1

名前: TimestampName: Timestamp

説明: 必須。Description: Required. 時刻を表す文字列です。A string that contains the time.

パラメーター番号: 2Parameter number: 2

名前: MinutesName: Minutes

説明: 必須。Description: Required. 追加する分の値です。The number of minutes to add. 負の値にして分の値を減算できます。Can be negative to subtract minutes.

パラメーター番号: 3Parameter number: 3

名前: FormatName: Format

説明: 省略可能。Description: Optional. このタイムスタンプの値を書式設定する方法を示す、単一の書式指定子文字またはカスタム書式指定パターンです。Either a single format specifier character or a custom format pattern that indicates how to format the value of this timestamp. 形式を指定しないと、ISO 8601 形式 ("o") が使われます。If format is not provided, the ISO 8601 format ("o") is used.

addhoursaddhours 渡されたタイムスタンプ文字列に時間数を表す整数を追加します。Adds an integer number of hours to a string timestamp passed in. 時間の値は正でも負でもかまいません。The number of hours can be positive or negative. 書式指定子を指定しない場合の既定値は、ISO 8601 形式 ("o") の文字列です。By default, the result is a string in ISO 8601 format ("o"), unless a format specifier is provided. 例: 2015-03-16T01:27:36ZFor example: 2015-03-16T01:27:36Z:

addhours('2015-03-15T13:27:36Z', 12)

パラメーター番号: 1Parameter number: 1

名前: TimestampName: Timestamp

説明: 必須。Description: Required. 時刻を表す文字列です。A string that contains the time.

パラメーター番号: 2Parameter number: 2

名前: HoursName: Hours

説明: 必須。Description: Required. 追加する時間数です。The number of hours to add. 負の値にして時間数を減算できます。Can be negative to subtract hours.

パラメーター番号: 3Parameter number: 3

名前: FormatName: Format

説明: 省略可能。Description: Optional. このタイムスタンプの値を書式設定する方法を示す、単一の書式指定子文字またはカスタム書式指定パターンです。Either a single format specifier character or a custom format pattern that indicates how to format the value of this timestamp. 形式を指定しないと、ISO 8601 形式 ("o") が使われます。If format is not provided, the ISO 8601 format ("o") is used.

adddaysadddays 渡されたタイムスタンプ文字列に日数を表す整数を追加します。Adds an integer number of days to a string timestamp passed in. 日の値は正でも負でもかまいません。The number of days can be positive or negative. 書式指定子を指定しない場合の既定値は、ISO 8601 形式 ("o") の文字列です。By default, the result is a string in ISO 8601 format ("o"), unless a format specifier is provided. 例: 2015-02-23T13:27:36ZFor example: 2015-02-23T13:27:36Z:

adddays('2015-03-15T13:27:36Z', -2)

パラメーター番号: 1Parameter number: 1

名前: TimestampName: Timestamp

説明: 必須。Description: Required. 時刻を表す文字列です。A string that contains the time.

パラメーター番号: 2Parameter number: 2

名前: DaysName: Days

説明: 必須。Description: Required. 追加する日数です。The number of days to add. 負の値にして日数を減算できます。Can be negative to subtract days.

パラメーター番号: 3Parameter number: 3

名前: FormatName: Format

説明: 省略可能。Description: Optional. このタイムスタンプの値を書式設定する方法を示す、単一の書式指定子文字またはカスタム書式指定パターンです。Either a single format specifier character or a custom format pattern that indicates how to format the value of this timestamp. 形式を指定しないと、ISO 8601 形式 ("o") が使われます。If format is not provided, the ISO 8601 format ("o") is used.

formatDateTimeformatDateTime 日付形式の文字列を返します。Returns a string in date format. 書式指定子を指定しない場合の既定値は、ISO 8601 形式 ("o") の文字列です。By default, the result is a string in ISO 8601 format ("o"), unless a format specifier is provided. 例: 2015-02-23T13:27:36ZFor example: 2015-02-23T13:27:36Z:

formatDateTime('2015-03-15T13:27:36Z', 'o')

パラメーター番号: 1Parameter number: 1

名前: DateName: Date

説明: 必須。Description: Required. 日付を表す文字列です。A string that contains the date.

パラメーター番号: 2Parameter number: 2

名前: FormatName: Format

説明: 省略可能。Description: Optional. このタイムスタンプの値を書式設定する方法を示す、単一の書式指定子文字またはカスタム書式指定パターンです。Either a single format specifier character or a custom format pattern that indicates how to format the value of this timestamp. 形式を指定しないと、ISO 8601 形式 ("o") が使われます。If format is not provided, the ISO 8601 format ("o") is used.

startOfHourstartOfHour 渡された文字列タイムスタンプに時刻の開始を返します。Returns the start of the hour to a string timestamp passed in. 例: 2017-03-15T13:00:00ZFor example 2017-03-15T13:00:00Z:

startOfHour('2017-03-15T13:27:36Z')

パラメーター番号: 1Parameter number: 1

名前: TimestampName: Timestamp

説明: 必須。Description: Required. 時刻を表す文字列です。This is a string that contains the time.

パラメーター番号: 2Parameter number: 2

名前: FormatName: Format

説明: 省略可能。Description: Optional. このタイムスタンプの値を書式設定する方法を示す、単一の書式指定子文字またはカスタム書式指定パターンです。Either a single format specifier character or a custom format pattern that indicates how to format the value of this timestamp. 形式を指定しないと、ISO 8601 形式 ("o") が使われます。If format is not provided, the ISO 8601 format ("o") is used.
startOfDaystartOfDay 渡された文字列タイムスタンプに 1 日の開始を返します。Returns the start of the day to a string timestamp passed in. 例: 2017-03-15T00:00:00ZFor example 2017-03-15T00:00:00Z:

startOfDay('2017-03-15T13:27:36Z')

パラメーター番号: 1Parameter number: 1

名前: TimestampName: Timestamp

説明: 必須。Description: Required. 時刻を表す文字列です。This is a string that contains the time.

パラメーター番号: 2Parameter number: 2

名前: FormatName: Format

説明: 省略可能。Description: Optional. このタイムスタンプの値を書式設定する方法を示す、単一の書式指定子文字またはカスタム書式指定パターンです。Either a single format specifier character or a custom format pattern that indicates how to format the value of this timestamp. 形式を指定しないと、ISO 8601 形式 ("o") が使われます。If format is not provided, the ISO 8601 format ("o") is used.
startOfMonthstartOfMonth 渡された文字列タイムスタンプに月の開始を返します。Returns the start of the month to a string timestamp passed in. 例: 2017-03-01T00:00:00ZFor example 2017-03-01T00:00:00Z:

startOfMonth('2017-03-15T13:27:36Z')

パラメーター番号: 1Parameter number: 1

名前: TimestampName: Timestamp

説明: 必須。Description: Required. 時刻を表す文字列です。This is a string that contains the time.

パラメーター番号: 2Parameter number: 2

名前: FormatName: Format

説明: 省略可能。Description: Optional. このタイムスタンプの値を書式設定する方法を示す、単一の書式指定子文字またはカスタム書式指定パターンです。Either a single format specifier character or a custom format pattern that indicates how to format the value of this timestamp. 形式を指定しないと、ISO 8601 形式 ("o") が使われます。If format is not provided, the ISO 8601 format ("o") is used.
dayOfWeekdayOfWeek 文字列タイムスタンプの曜日部分を返します。Returns the day of week component of a string timestamp. 日曜日は 0、月曜日は 1 などです。Sunday is 0, Monday is 1, and so on. 例: 3For example 3:

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

パラメーター番号: 1Parameter number: 1

名前: TimestampName: Timestamp

説明: 必須。Description: Required. 時刻を表す文字列です。This is a string that contains the time.
dayOfMonthdayOfMonth 文字列タイムスタンプの日付部分を返します。Returns the day of month component of a string timestamp. 例: 15For example 15:

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

パラメーター番号: 1Parameter number: 1

名前: TimestampName: Timestamp

説明: 必須。Description: Required. 時刻を表す文字列です。This is a string that contains the time.
dayOfYeardayOfYear 文字列タイムスタンプの年間通算日数部分を返します。Returns the day of year component of a string timestamp. 例: 74For example 74:

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

パラメーター番号: 1Parameter number: 1

名前: TimestampName: Timestamp

説明: 必須。Description: Required. 時刻を表す文字列です。This is a string that contains the time.
ticksticks 文字列タイムスタンプの刻みプロパティを返します。Returns the ticks property of a string timestamp. 例: 1489603019For example 1489603019:

ticks('2017-03-15T18:36:59Z')

パラメーター番号: 1Parameter number: 1

名前: TimestampName: Timestamp

説明: 必須。Description: Required. 時刻を表す文字列です。This is a string that contains the time.

ワークフロー関数Workflow functions

以下の関数を使うと、実行時にワークフロー自体に関する情報を取得できます。These functions help you get information about the workflow itself at run time.

関数名Function name DescriptionDescription
listCallbackUrllistCallbackUrl トリガーまたはアクションを開始するために呼び出す文字列を返します。Returns a string to call to invoke the trigger or action.

: この関数は httpWebhook および apiConnectionWebhook においてのみ使うことができ、manualrecurrencehttpapiConnection では使えません。Note: This function can only be used in an httpWebhook and apiConnectionWebhook, not in a manual, recurrence, http, or apiConnection.

たとえば、listCallbackUrl() 関数は次の値を返します。For example, the listCallbackUrl() function returns:

https://prod-01.westus.logic.azure.com:443/workflows/1235...ABCD/triggers/manual/run?api-version=2015-08-01-preview&sp=%2Ftriggers%2Fmanual%2Frun&sv=1.0&sig=xxx...xxx

workflowworkflow この関数は、実行時のワークフロー自体の詳細をすべて返します。This function provides you all the details for the workflow itself at the runtime.

ワークフロー オブジェクトでは次のプロパティを使用できます。Available properties on the workflow object are:

  • name
  • type
  • id
  • location
  • run

run プロパティの値は、次のプロパティを持つオブジェクトです。The value of the run property is an object with following properties:

  • name
  • type
  • id

これらのプロパティについて詳しくは、Rest API に関するページをご覧ください。See the Rest API for details on those properties.

たとえば、現在の実行の名前を取得するには、"@workflow().run.name" 式を使用します。For example, to get the name of the current run, use the "@workflow().run.name" expression.

次のステップNext steps

ワークフローのアクションとトリガーWorkflow actions and triggers