> For the complete documentation index, see [llms.txt](https://docs.allganize.ai/alliyzgaido/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.allganize.ai/alliyzgaido/settings/variables/list-variables-file-variables.md).

# リスト変数・ファイル変数

リスト変数を使用すると、外部データを使用して顧客向けの動的な回答リストを作成でき、ファイル変数を使用すると、ユーザーは所定のファイルをアップロードすることができます。

一般的な変数の管理方法については、[こちらを参照](https://docs.allganize.ai/alli-userguide/settings/variables/variables)してください。

## リスト変数 <a href="#list-variable" id="list-variable"></a>

リスト変数には３つの異なるタイプがあります。 ・文字列リスト ・JSON ・JSONリスト すべてのタイプのリスト変数を利用するには、JSONに関する基本的な知識が必要となります。

### **STEP 1. リスト変数を作成**

Alliダッシュボードにログインして、文字列型変数の作成を開始します。\
Alliダッシュボードにログインして、文字列型変数の作成を開始します。 変数の作成方法は以下の３パターンがあります。\
**方法 1** -\[設定]メニューから>変数>を作成する 。\
\[設定]> \[変数]> \[カスタム]に移動し、\[+追加]をクリックします。

\
**方法 2** – チャットフロー編集で変数を作成する。\
チャット編集画面でノードに新しい変数を追加します。\[応答内容を以下で保存する]直下のドロップダウンメニューから\[新しい変数を作成]をクリックします。<br>

**方法 3** – チャット編集内＠変数リストメニューから作成する 。\
変数追加画面の\[タイプ]選択にて“文字列リスト”、“JSON”、“JSONリスト”から選択します。 変数の名前と説明も入力して保存します。

#### **方法1-\[設定]メニューから変数を作成する**

<figure><img src="https://i0.wp.com/guide.allganize.ai/wp-content/uploads/2022/05/%E3%83%AA%E3%82%B9%E3%83%88%E5%A4%89%E6%95%B01.png?resize=800%2C268&#x26;ssl=1" alt="" height="268" width="800"><figcaption></figcaption></figure>

#### **方法2-チャットフロー編集で変数を作成する**

<figure><img src="https://i0.wp.com/guide.allganize.ai/wp-content/uploads/2022/05/%E3%83%AA%E3%82%B9%E3%83%88%E5%A4%89%E6%95%B02-1.png?resize=800%2C551&#x26;ssl=1" alt="" height="551" width="800"><figcaption><p>方法2</p></figcaption></figure>

#### **方法3-チャット編集内＠変数リストメニューから作成する**&#x20;

<figure><img src="https://i0.wp.com/guide.allganize.ai/wp-content/uploads/2022/05/%E3%83%AA%E3%82%B9%E3%83%88%E5%A4%89%E6%95%B03.png?resize=800%2C179&#x26;ssl=1" alt="" height="179" width="800"><figcaption><p>方法3</p></figcaption></figure>

### **STEP 2. JSON形式でデータポイントを準備する**

使用する変数に応じて、適切な形式でリストを準備します。 以下に例を示します。

{% code lineNumbers="true" %}

```json
{
  "STR_LIST_VAR": [
    "TypeA",
    "TypeB",
    "TypeNew"
  ],
  "JSON_VAR": {
    "empno": 1,
    "name": "Chris",
    "email": "Chris@allganize.ai"
  },
  "JSON_LIST_VAR": [
    {
      "empno": 1,
      "name": "James",
      "email": "James@allganize.ai"
    },
    {
      "empno": 2,
      "name": "Peter",
      "email": "Peter@allganize.ai"
    }
  ]
}
```

{% endcode %}

キーが変数の名前と一致することを確認してください。 上記の例では、STR\_LIST\_VAR、JSON\_VAR、JSON\_LIST\_VARが各変数の名前である必要があります。 ちなみに、後で[**連携ノード**](https://docs.allganize.ai/alli-userguide/skills/skill-editor/node/integrate-node-advanced)のAdvancedオプションを使用してJSONパスを指定する場合は、変数名は一致していなくても問題ありません。

### **STEP 3. チャットフローを設計する**

[**【外部データ連携】**](https://docs.allganize.ai/alli-userguide/skills/skill-editor/node/integrate-node-advanced)ノードを使用して、設定したデータポイントからデータを取得します。 リスト変数を使用する前に、外部データ連携ノード（設定の参照はこちら）および会話応答ノードを配置する必要があります。

<figure><img src="https://i0.wp.com/guide.allganize.ai/wp-content/uploads/2022/05/%E3%83%AA%E3%82%B9%E3%83%88%E5%A4%89%E6%95%B04.png?resize=719%2C361&#x26;ssl=1" alt="" height="361" width="719"><figcaption><p>Place Integrate node before you use any List variables.</p></figcaption></figure>

【会話・質問応答】ノードで、\[応答の追加]に☑を入れ、\[+動的応答オプションの追加]をクリック後、 🖊をクリックし、\[動的応答オプションの編集]にて、使用する変数を選択します。 JSONまたはJSONリストを使用している場合は、DisplayパスとバリューパスをJSON形式で入力する必要があります。 Displayパスは、チャットフローで顧客に表示されるオプション用であり、バリューパスは、顧客がオプションを選択したときに返される値用です。

<figure><img src="https://i0.wp.com/guide.allganize.ai/wp-content/uploads/2022/05/%E3%83%AA%E3%82%B9%E3%83%88%E5%A4%89%E6%95%B05.png?resize=462%2C298&#x26;ssl=1" alt="" height="298" width="462"><figcaption></figcaption></figure>

<figure><img src="https://i0.wp.com/guide.allganize.ai/wp-content/uploads/2022/05/%E3%83%AA%E3%82%B9%E3%83%88%E5%A4%89%E6%95%B06.png?resize=343%2C388&#x26;ssl=1" alt="" height="388" width="343"><figcaption></figcaption></figure>

### **STEP 4. リストの表示を確認**

PREVIEWを使用して、リストが意図したとおりに表示されるかどうかを確認できます。

<figure><img src="https://i0.wp.com/guide.allganize.ai/wp-content/uploads/2022/05/%E3%83%AA%E3%82%B9%E3%83%88%E5%A4%89%E6%95%B07.png?resize=372%2C328&#x26;ssl=1" alt="" height="328" width="372"><figcaption></figcaption></figure>

## ファイル変数 <a href="#file-variable" id="file-variable"></a>

File変数の使用は非常に簡単です。

### **STEP 1. ファイル変数の作成**

変数タイプとして\[ファイル]を選択する以外は、上記のリスト変数のSTEP１と同じ内容です。

### **STEP 2. チャットフローの設計**

【会話・質問応答】ノードまたは[【入力フォーム】](https://docs.allganize.ai/alli-userguide/skills/skill-editor/node/build-a-form-node)ノードでFile変数を使用できます。 【会話・質問応答】ノードで、\[応答追加]をオンにして、応答種別として\[ファイル]を選択し、\[応答の保存先]としてファイル変数を選択します。 【入力フォーム】ノードで、フィールドの変数の１つとして\[ファイル]変数を選択します。

<figure><img src="https://i0.wp.com/guide.allganize.ai/wp-content/uploads/2022/05/%E3%83%AA%E3%82%B9%E3%83%88%E5%A4%89%E6%95%B09.png?resize=800%2C1166&#x26;ssl=1" alt="" width="375"><figcaption></figcaption></figure>

<figure><img src="https://i0.wp.com/guide.allganize.ai/wp-content/uploads/2022/05/%E3%83%AA%E3%82%B9%E3%83%88%E5%A4%89%E6%95%B010.png?resize=800%2C1096&#x26;ssl=1" alt="" width="375"><figcaption></figcaption></figure>

### **STEP 3. 動作確認**

【会話・質問応答】ノードの場合、ユーザーは\[クリップ]アイコンをクリックしてファイルをアップロードできます。【入力フォーム】ノードの場合、\[ファイルを添付]をクリックし、該当ファイルをアップロードすることができます。

<figure><img src="https://i0.wp.com/guide.allganize.ai/wp-content/uploads/2022/05/%E3%83%AA%E3%82%B9%E3%83%88%E5%A4%89%E6%95%B08.png?resize=800%2C529&#x26;ssl=1" alt="" height="529" width="800"><figcaption></figcaption></figure>

<figure><img src="https://i0.wp.com/guide.allganize.ai/wp-content/uploads/2022/01/List_Variable11.png?resize=380%2C352&#x26;ssl=1" alt="" height="352" width="380"><figcaption></figcaption></figure>

Dashboardのユーザーリスト内でもアップロードされたファイルが表示・確認できます。

<figure><img src="https://i0.wp.com/guide.allganize.ai/wp-content/uploads/2022/01/List_Variable12.png?resize=578%2C61&#x26;ssl=1" alt="" height="61" width="578"><figcaption></figcaption></figure>