アクションの種類

アクションスクリプト

アクションスクリプトはあらかじめ定義された スクリプトを実行します。

API呼び出し

API呼び出しアクションを使って外部APIに呼び出しを行います。これらのアクションは一括実行を可能にします。

!注API呼び出しアクションは多言語プロパティをサポートしていません。

タイプドロップダウンメニューからAPI呼び出しを選択した場合、以下のフィールドに入力してください。

• フィールド名
• メソッド:API呼び出しアクションは3種類のHTTPメソッドをサポートしています:POSTPUTGET
• API URL
  。この値は設定からも解決可能です。環境固有の設定からAPI URLを解決するには、以下のフォーマットを使用します。

{<SETTING_CATEGORY>.<SETTING_NAME>.<SETTING_PROPERTY>}

• タイムアウト
  、応答がなければ呼び出しは失敗します。注
  。
• ヘッダー
  。 CREATE または UPDATE アクションがトリガーされると、コンテキストにはエンティティのプロパティ値とリレーション識別子が含まれます。 DELETE アクションがトリガーされるとコンテキストは空ですが、利用可能な情報はすべて標準ヘッダーを通じて送信されます。TipRequestヘッダーはAPIを使った認証に使用できます。
• 値
  、例えば {Title} を値フィールドに配置すると、エンティティの Title プロパティの値が抽出されます。リレーション名を使用する場合、その値はターゲットエンティティ識別子を含みます。両方の場合、複数の値が存在する場合、 | 文字が区切りとして使われます。自己関係型を使用する場合、解決された値は以下の形式で表されます。<PARENT_VALUE1>|<PARENT_VALUE2>; <CHILD_VALUE1>|<CHILD_VALUE2>これらをメッセージ本文に配置する際、値は コンテキストというトップレベルのプロパティに付加されます。注意以下の制限はヘッダーおよび値コレクションに適用されます
  - 64 KBValues - 256 KB いずれかのコレクションが閾値を超えた場合、リクエストは実行されず、失敗した試みはアクション監査ログに記録されます。

API URLの例

{Actions.ApiCalls.BeeUrl} {Actions.ApiCalls.RedUrl}

Actionsカテゴリ内で名前ApiCalls設定を作成する際は、次のように設定してください:

{ "BeeUrl": "https://bee.com", "RedUrl": "https://red.com" }

!重要プロパティは大文字・文字に依存し、ピリオドを表示できません。リクエストヘッダーや変数は設定から解決できません。

Azure event hub

リクエストにヘッダーを追加するには**、Azureのイベントハブアクションを使ってください。タイプドロップダウンメニューからAzureイベントハブ**を選択し、以下のフィールドに入力してください。

• フィールド名
• 接続文字列
  。接続文字列は固定値で設定することも、設定から解決することもできます。
• EventHub
  。環境固有の設定から接続文字列やEventHubを解決するには、以下の形式を使用します:例
  ・文字を区別し、ピリオドをサポートしません。リクエストヘッダーや変数は設定からの値を解決しません。

{<SETTING_CATEGORY>.<SETTING_NAME>.<SETTING_PROPERTY>}

{Actions.Event.connectionString} {Actions.Event.eventHub}

• ヘッダー
  。 CREATE または UPDATE アクションがトリガーされると、コンテキストにはエンティティのプロパティ値とリレーション識別子が含まれます。 DELETE アクションがトリガーされると、コンテキストは空です。
• 値
  、例えば {Title} を値フィールドに配置すると、エンティティの Title プロパティの値が抽出されます。リレーション名を使用する場合、その値はターゲットエンティティ識別子を含みます。両方の場合、複数の値が存在する場合、 | 文字が区切りとして使われます。自己関係型を使用する場合、解決された値は以下の形式になります。<PARENT_VALUE1>|<PARENT_VALUE2>; <CHILD_VALUE1>|<CHILD_VALUE2>メッセージ本文の値も追加できます。この構文はヘッダーと同じで、定義された値をメッセージ本文内の「 context 」というプロパティに配置します。

Azure service bus

Azureのサービスバスアクションを使ってリクエストにヘッダーを追加します。これらのアクションは一括実行を可能にします。

「Type」ドロップダウンメニューから**「Azure event hub**」を選択し、以下のフィールドに入力してください。

• フィールド名
• 接続文字列
  。接続文字列と宛先は固定値で設定できますし、設定から解決することもできます。
• 宛先タイプ: Azureのサービスバス アクションは2種類の宛先をサポートしています
  - メッセージの消費に使われるキュー名。トピック - メッセージを消費するためのトピック名とサブスクリプション名。
• 宛先
  。環境固有の設定から接続文字列または宛先を解決するには、以下の形式を使用します。例:

{<SETTING_CATEGORY>.<SETTING_NAME>.<SETTING_PROPERTY>}

{Actions.Event.connectionString} {Actions.Event.destination}

• ヘッダー
  。 CREATE または UPDATE アクションがトリガーされると、コンテキストにはエンティティのプロパティ値とリレーション識別子が格納されます。 DELETE アクションがトリガーされると、コンテキストは空になります。
• 値
  。例えば、値フィールドに{Title}を入れると、エンティティのTitleプロパティの値が引き出されます。リレーション名を使用する場合、その値は対象エンティティの識別子を含みます。どちらの場合も、複数の値が存在する場合、|文字が区切りとして使われます。自己関係型を使用する場合、解決された値は以下の形式になります
  。構文はヘッダーと同じで、定義された値をメッセージ本文内のコンテキストというプロパティに配置します。注意以下の制限はヘッダーと値のコレクションに適用されます
  - 64 KB バルブ - 256 KB コレクションが閾値を超えるとリクエストは実行されず、失敗した試みはアクション監査ログに記録されます。

<parent_value1>|<parent_value2>; <child_value1>|

M Azure service bus

Content Hubが提供する内部サービスバスにデータを送信するためにM Azure Service Busアクションを使用します。接続文字列は自動的に提供されます。タイプドロップダウンメニューからM Azureサービスバスを選択し、以下のフィールドを入力してください。

フィールド名

概要

必須

目的地の種類

M Azureのサービスバス アクションは、2種類の宛先をサポートしています:

• キュー - メッセージを消費するためのキュー名。
• トピック - メッセージを消費するために使われるトピック名とサブスクリプション名。

ハブ

この接続文字列は 書き込み 操作を可能にします。エンドポイントリンクをコピーするには 「コピーリンク 」をクリックしてください。

いいえ

ハブアウト

この接続文字列は 読み取り専用 操作を可能にします。エンドポイントリンクをコピーするには 「リンクをコピー 」をクリックします。

いいえ

ヘッダー

メッセージヘッダーはトリガーコンテキストから動的な値を引き出すことができます。 CREATE または UPDATE アクションがトリガーされると、コンテキストにはエンティティのプロパティ値とリレーション識別子が含まれます。 DELETE アクションがトリガーされた場合、コンテキストは空です。

いいえ

価値観

コンテキスト変数の構文は表示テンプレートと同じです。例えば、値フィールドに {Title} を入れると、エンティティの Title プロパティの値を取得します。指定されたプロパティが多言語の場合、すべての文化とその値を含むオブジェクトが返されます。

リレーション名を使用する場合、その値には対象エンティティの識別子が含まれなければなりません。

両方の場合、複数の値が存在する場合、 | 文字が区切りとして使われます。自己関係型を使用する場合、解決された値は以下の形式になります。

<parent values separated with '|'> ; <child values separated with '|'>

メッセージ本文の価値も追加できます。構文はヘッダーと同じで、定義した値をメッセージ本文内の「 context 」というプロパティに配置する必要があります。

> [!注]
> ヘッダーと値のコレクションには以下の制限が適用されます:
>

• ヘッダー - 64 KB

• 値 - 256 KB

> いずれかのコレクションが閾値を超えると、そのリクエストは実行されず、失敗した試みはアクション監査ログに記録されます。

いいえ

印刷エンティティ生成

印刷用テンプレートを使った「印刷エンティティ生成」アクションを使って、エンティティのリストからPDFファイルを生成します。「タイプ」ドロップダウンメニューから**「印刷」エンティティ生成**を選択し、以下のフィールドを埋めます。

フィールド名

概要

必須

定義

印刷したいエンティティの定義。

はい

テンプレート

使いたいあらかじめ定義された プリントテンプレート 。

はい

報道チャンネル

Reporting channelアクションを使って、システムのレポートパイプラインへのエントリをログに記録し、「Manage > Reporting logs」から確認できます。例として、「作成された製品トラック」を参照してください。

!重要報告チャンネルに記録されたイベントを含むチャートを作成するには、これらのイベントをPredefinedEventTypes設定に追加してください。

状態機械の起動

状態フローを自動的に開始するには 、Start State Machineアクションを使用します。

Start State Machineアクションを設定するには、State flowの横にある Addをクリックして、このアクションがどの状態フローを開始するかを指定します。選択できる状態フローは1つだけです。