Lookup Table Vars

Excelスプレッドシートのワークシートで定義されたテーブルからカスタムデータ行を読み込み、値を個別のスクリプト変数として保存します。 アクションを通してスプレッドシートをアップロードし、読み込むワークシートを選択することができます。ワークシートは、Base 64でエンコードされた文字列としてスクリプトに格納されます。

依存関係

• このアクションで使用するためにアップロードしたスプレッドシートは、Base 64でエンコードされた文字列としてスクリプトに格納されます。これはファイルサーバーに保存されません。
• アップロードした後にファイルのデータを編集することはできません。代わりに、データを更新するには新しいバージョンをアップロードする必要があります。この作業は、最初にファイルをアップロードしたStudioユーザーだけが行うことができます。ユーザーがファイルを更新できない場合は、スクリプトからアクションを削除し、新しいバージョンをアップロードする必要があります。データをリフレッシュする方法の詳細については、このページのアクションを使用するセクションを参照してください。
• スプレッドシートが大きければ大きいほど、このアクションがCXoneサーバーに問題を引き起こす可能性は高くなります。スプレッドシートの行数や列数は、ファイル全体のサイズに影響します。列数とセル内のデータ量にもよりますが、最大行数は10,000～20,000行です。この範囲の行数を持つスプレッドシートでこのアクションを使用する場合には注意が必要です。その場合はデータベースなど別のソリューションの利用も検討してください。
• スプレッドシートから読み込む場合、LookupTablVarsは最後の行を無視します。データの欠落を避けるため、スプレッドシートの最後に行を1つ追加してください。この行は空にするか、「ファイルの終わり」のような値を含めることもできます。
• 列名にスペースを含めることはできません。

サポートされているスクリプトタイプ

一般	Eメール	チャット	電話	ボイスメール	ワークアイテム	SMS	デジタル

入力プロパティ

これらのプロパティは、アクションが実行時に使用するデータを定義します。

これらのプロパティは、ウィザードを使用してスプレッドシートを読み込むと自動的に設定されます。

プロパティ	説明
を追加	スクリプト内でこのアクションを一意に識別できる、短いフレーズを入力します。アクションアイコンにカーソルを合わせるとキャプションが表示されます。The default is the action name.
Value	取得するデータ行の決定に使用されるキー列に一致する値。
File Name	ワークシートが読み込まれたスプレッドシートファイルの名前。スプレッドシートを再度読み込む際に、更新オプションで使用されます。
Worksheet Name	アクションで使用するために選択されたワークシートの名前。ワークブックを再度読み込む際に、更新オプションで使用されます。
Key Column	選択したワークシートのキー列の名前。ワークブックを再ロードするときに[更新]オプションで使用されます。

結果ブランチ条件

結果の分岐条件を使用すると、アクションが実行されたときにさまざまな結果を処理できるように、スクリプトにブランチを作成できます。

条件	説明
Default	スクリプトが他のブランチのいずれかを取る必要がある条件を満たさない限り、パスが取られます。他のブランチが定義されていない場合にも使用されます。
NoMatch	アクションが定義された表からカスタムデータ行を識別できない場合に取られるパス。

アクションの使用

1. LookupTableVarsアクションをスクリプトに追加し、接続します。
2. LookupTableVarsをダブルクリックしてウィザードを開きます。スプレッドシートをアップロード済みで、新しいスプレッドシートを選択したい場合は、アクションを右クリックし、プロパティウィンドウから新しいワークブックを選択をクリックします。
3. 次をクリックして、デフォルトのオプションであるPrivate, Single-Use Look-up Tableを受け入れます。もう片方のオプションは現在サポートされていません。
4. アクションで使用するスプレッドシートを選択し、開くをクリックします。
5. スプレッドシートに複数のワークシートが含まれている場合、アクションの読み込み元となるワークシートを選択し、次をクリックします。
6. ルックアップキーに使用するカラム名を選択し、次をクリックします。
7. 選択内容を確認し、次をクリックします。このアクションは、選択したワークシートをエンコードし、エンコードされた文字列をスクリプトファイルに追加します。
8. 終了をクリックします。

データを更新する

データが変更された場合は、スクリプトに保存されているデータを更新できます。これは、最初にファイルを追加したのと同じユーザーアカウントで、同じコンピューターを使って行う必要があります。

1. LookupTableVarsを右クリックします。

   画像の表示

   
2. ワークブックを更新をクリックします。