---
title: "イベント変換"
url: https://docs.catalyst.zoho.com/ja/signals/help/targets/event-body-setup/event-transformation/
description: "運用効率のために、ターゲットに配信する前にイベントボディをカスタマイズします。"
last_updated: 2026-08-17T12:16:04Z
service: Signals
type: general
---

# イベント変換

各ターゲットシステムに合わせてイベントスキーマをカスタマイズできます。これにより、同じイベントに対して異なるターゲットごとに異なるスキーマを持つ複雑なオーケストレーションフローを構築できます。Signalsは、スキーマ変換のためのJSONパスとマッピングロジックを使用して、コーディングなしでプロセスを簡素化します。

### 抽出

このアプローチにより、スキーマから単一のキーを抽出し、その特定のキーのみを指定されたターゲットに転送できます。

#### データの抽出方法

1. [こちら](https://docs.catalyst.zoho.com/ja/signals/help/rules/create-rule/)のドキュメントの手順に従ってルールを作成します。

2. *ターゲット入力*を設定する際に、*ターゲット入力*の下の**Extraction**を選択します。

3. **Path**のボックスをクリックして、イベントスキーマ内のすべてのキーを表示します。必要なキーを選択してルールを保存します。

![Extracting a key from the event body](https://catalyst-docs-development.zohostratus.in/images/help/signals/help/targets/event-transformation/extraction.webp)

### 変換

データ変換は、JSONパスを利用したマッピングの概念に基づいています。

#### データの変換方法

1. [こちら](https://docs.catalyst.zoho.com/ja/signals/help/rules/create-rule/)のドキュメントの手順に従ってルールを作成します。

2. *ターゲット入力*を設定する際に、*ターゲット入力*の下の**Transformation**を選択します。

3. 新しいテンプレートで、キー名を入力し、その値の代わりにサンプルイベントスキーマの目的のキーのJSONパスを指定します。

![Simple transformation of an event body](https://catalyst-docs-development.zohostratus.in/images/help/signals/help/targets/event-transformation/simple.gif)

4. テンプレートで配列を作成するには、**for-eachメソッド**を使用します。これにより、サンプルスキーマの任意の配列から特定のオブジェクト/キーにアクセスできます。

配列にしたいキーの横に、この構文**forEach((var{n})->{JSON_path_of_desired_key} )**をデプロイします。

構文内の**var{n}**は、配列の変数名と配列内の特定のインデックスを指定します。構文内の**JSON_path**の場所には、新しいキーやJSONオブジェクトを使用することもでき、その中にfor-eachメソッドを含めることも含めないこともできます。

![Complex transformation of an event body](https://catalyst-docs-development.zohostratus.in/images/help/signals/help/targets/event-transformation/complex.gif)

構文内のキー値をマッピングするには、引数で設定した**var{n}**（変数）を指定し、目的のキーに移動します。

> **Note:** Catalyst Signalsは、提供されたサンプルイベントスキーマに基づいて、テンプレートコンパイラペインで**JSONパスの候補**を提供します。これにより、サンプルスキーマからのキーとその順序の検索が容易になります。