---
title: "アクションの種類"
slug: "action-types"
abstract: "スクリプト、API呼び出し、Azureサービス、プリント生成、レポート、状態機械の開始など、アクションタイプの概要。"
---
# アクションの種類

Content Hubは以下のアクションタイプをサポートしています。

## アクションスクリプト

アクションスクリプトはあらかじめ定義された [スクリプト](https://doc.sitecore.com/ch/ja/developers/cloud-dev/scripts.html "Scripts")を実行します。

## API呼び出し

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

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

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

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

{<SETTING\_CATEGORY>.<SETTING\_NAME>.<SETTING\_PROPERTY>}

-   **タイムアウト**:API呼び出しへのタイムアウトで、応答がなければ呼び出しは失敗します。注:リスト内のタイムアウト値は秒単位で表されます。
-   **ヘッダー**:リクエストヘッダーはトリガーコンテキストから動的な値を取得できます。 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イベントハブ**を選択し、以下のフィールドに入力してください。

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

{<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イベントハブ用の接続文字列です。接続文字列と宛先は固定値で設定できますし、設定から解決することもできます。
-   **宛先タイプ**: **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>|<child value2>

## 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ファイルを生成します。「**タイプ**」ドロップダウンメニューから**「印刷」エンティティ生成**を選択し、以下のフィールドを埋めます。

フィールド名

概要

必須

**定義**

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

はい

**テンプレート**

使いたいあらかじめ定義された [プリントテンプレート](https://doc.sitecore.com/ch/en/users/content-hub/create-a-print-template.html) 。

はい

## 報道チャンネル

**Reporting channel**アクションを使って、システムのレポートパイプラインへのエントリをログに記録し、「**Manage** > **Reporting logs**」から確認できます。例として、「[作成された製品トラック](https://doc.sitecore.com/ch/ja/developers/cloud-dev/track-products-created.html "Track products created")」を参照してください。

> !重要報告チャンネルに記録されたイベントを含むチャートを作成するには、これらのイベントをPredefinedEventTypes[設定](https://doc.sitecore.com/ch/en/users/content-hub/settings.html)に追加してください。

## 状態機械の起動

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

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