変数の変換を利用する

備考

想定作業時間：15分

概要

高度な変数を扱う際、変数を使用する前にそれらを変換するロジックが必要になる場合があります。例えば、配列をデフォルトのJSON形式の代わりに、セパレーターを使用して文字列に変換するなどです。このような場合に変数の変換が役立ちます。

学べること

• 変数の変換の使用方法
• 関数の概要
• 例
• 関連ドキュメント

変数の変換の使用方法

変数の変換は常に変換後の新しい変数を作成します。したがって、変換後の変数名を指定する必要があります。こちらには.を使用してネストされた変数を割り当てることも可能です。

次に、値については、2つのモードがあります。これは値フィールドに何が期待されているか、システムがそれをどのように理解すべきかを決定します。

モード	説明	入力変数のタイプ	例
文字列形式	このモードでは、値は文字列として評価されます。たとえば、ユーザーはJSON文字列を静的に定義できます。そして最も重要なのは、{$existing_variable}表記を使用できることです。	文字列	My {$custom_data} {"my_object_key": "{$captured_value}"}
ポインタ形式	このモードでは、既存の変数を直接指します。指定できるのはターゲット変数の位置(必要に応じてネストされた位置)のみであり、複数の変数を組み合わせることはできません。指定された変数は変更されず、読み込みだけが行われます。また、括弧や$記号は省略して指定します。	指定された変数のタイプと同じ	existing_var existing.nested.var

入力を指定したら、次は1つ以上の関数を適用します。

関数の概要

関数は定義された順序（上から下）で、順番に適用されます。

注意

KurocoEdgeは変数に対して厳密な型システムを適用しています。与えられたタイプに適用可能な関数を選択することが重要です。慣例として、関数名は適用可能な入力タイプを示すタイプで始まります。

エラーが発生した場合（指定された変数が存在しない、または関数のタイプが一致しない場合）、このアクションは無効になり、エラーがログに記録されます。詳細については、KurocoEdgeのレスポンスログヘッダーを確認してください。

備考

プレビューモードでは、ルール開発の都合上、実行時エラーはプレビューモーダル内に表示されます。

現在、次の関数が定義されています：

関数名	説明	結果のタイプ
StringParseToJson	入力文字列をJSONとして解析します	解析した結果による
ArrayJoin	配列を指定された区切り文字で連結して文字列に変換します	文字列
ObjectKeys	オブジェクトのキーを使用して配列に変換します	配列
ObjectValues	オブジェクトの値を使用して配列に変換します	配列

備考

利用可能な関数のリストは意図的に最小限に保たれており、ユーザーのニーズに基づいて拡張されます。したがって、ビジネスロジックに役立つと思われる関数がある場合は、KurocoEdgeサポートへの問い合わせを検討してください。

例

API変数のレスポンスが次のオブジェクトを返すとします：

{
  "cities": {
    "Tokyo": {
      "region": "Kanto",
      "pop": "14 millions"
    },
    "Osaka": {
      "region": "Kinki",
      "pop": "2.7 millions"
    }
  }
}

そして、「期待する変数」セクションでcitiesを指定したとします。すると、citiesはリクエストのKurocoEdgeメモリ内でJSONオブジェクトとして保存されます。
次に、以下の設定を使用すると都市名のリストを抽出できます。

これにより、city_namesという名前の変数が作成され、値はTokyo,Osakaの文字列になります。

関連ドキュメント

• API変数を利用する