［CSV データ更新］で選択肢マスタを構成する

［CSV データ更新］を使えば、CSV から必要なデータを抽出できます。また、［選択型］データ項目の選択肢は、「選択肢ID」と「表示ラベル」の2つの項目で構成されています。そのため、［CSV データ更新］と［選択肢マスタ更新］を併用すれば、CSV から必要なデータを抽出し、そのデータから選択肢マスタファイルを作成できます。

ここでは、社員名簿の CSV データをもとに、「メールアドレスを選択肢ID、氏名を表示ラベルとする」選択肢マスタファイルを自動で作成するアプリの構成方法を紹介します。

［CSV データ更新］関連記事：

1. 選択肢マスタとは

［選択型］データ項目の選択肢は、「選択肢ID」と「表示ラベル」の組み合わせで定義します。選択肢マスタは、この組み合わせを複数まとめて定義した XML 形式のファイルで、アドオンとして登録すると複数のアプリから共通の選択肢として参照できます。

選択肢マスタそのものの書式やさまざまな作成方法については、以下の記事で詳しく解説しています。本記事では、［CSV データ更新］を使って CSV から選択肢マスタを構成する方法に絞って紹介します。

参考記事：

2. 選択肢マスタ自動作成／更新アプリ

このアプリは、社員名簿の CSV データ（インプット）を受け取り、氏名とメールアドレスの選択肢マスタファイル（アウトプット）を自動で作成・登録します。参照元の CSV データを入力すると、氏名（表示ラベル）とメールアドレス（選択肢ID）が抽出され、選択肢マスタファイルとしてアドオンに登録されます。名簿を更新して再実行すれば、選択肢マスタも最新の内容に更新されます。

アプリ定義

ワークフロー図

参照元の CSV データを入力するヒューマンタスクに続けて、［CSV データ更新］工程と［選択肢マスタ更新］工程を配置します。これらの工程は、それぞれ以下の処理を担います。（詳細な設定は後述します。）

［CSV データ更新］で選択肢の表示ラベル・選択肢IDを抽出

参照元の社員名簿 CSV データから、氏名（表示ラベル）とメールアドレス（選択肢ID）を抽出し、それぞれ［文字型（複数行）］データ項目に保存します。工程名は「データ抽出」とします。

［選択肢マスタ更新］で表示ラベル・選択肢IDから選択肢マスタを作成

［CSV データ更新］で出力された2つのデータ項目を選択肢として参照する［選択型］データ項目から、選択肢マスタファイルを作成し、アドオンとして登録します。同名のファイルが既にある場合は更新します。工程名は「選択肢マスタ作成／更新」とします。

データ項目

使用するデータ項目を用意します。

データ項目名	データ型	説明
CSV データ	文字型（複数行）	参照元となる CSV データを保存します。
選択肢ID	文字型（複数行）	CSV データから抽出された選択肢IDを保存します。
表示ラベル	文字型（複数行）	CSV データから抽出された表示ラベルを保存します。
選択肢マスタ作成／更新用選択肢	選択型	このデータ項目の選択肢内容をもとに、選択肢マスタが作成・更新されます。

［選択型］データ項目「選択肢マスタ作成／更新用選択肢」では、［選択肢種別］に［文字型データ項目］を指定し、［選択肢ID］に「選択肢ID」、［表示ラベル］に「表示ラベル」を指定します。

3. ［CSV データ更新］工程の設定

参照元の CSV データから、選択肢の表示ラベルと選択肢IDにあたる2つのカラムを抽出し、それぞれ個別の［文字型（複数行）］データ項目に保存します。

［クエリ］

選択肢の表示ラベルおよび選択肢IDのカラムを抽出するクエリを記述します。

［保存設定］

［C4: クエリ結果の保存方法］で「各カラムの値を改行区切りでデータ項目に保存する」を選択します。
［C4a: クエリ結果を保存するデータ項目］で、クエリ結果の各カラムに対して保存先のデータ項目を個別に指定します。

設定例

クエリ例

SELECT "氏名","メールアドレス"
FROM "名簿"

［C1b: クエリからアクセスする際のテーブル名］で「名簿」と設定したデータから、「氏名」カラムと「メールアドレス」カラムの値を抽出しています。

C4a（保存先データ項目）

クエリ結果のカラム	保存先データ項目
1番目のカラム（氏名）	文字型（複数行）「表示ラベル」
2番目のカラム（メールアドレス）	文字型（複数行）「選択肢ID」

入出力結果

参考：ヘルプページ「CSV データ更新」

4. ［選択肢マスタ更新］工程の設定

［CSV データ更新］で出力した2つの［文字型（複数行）］データ項目を選択肢として参照する［選択型］データ項目から、選択肢マスタファイルを作成または更新し、アドオンとして登録します。対象の［選択型］データ項目では、あらかじめ［文字型（複数行）］データ項目を選択肢として参照するよう設定しておきます。

［更新するアドオンの種別］

選択肢マスタ（アプリ共有アドオン）：［アプリ共有アドオン］に登録する場合に指定します。
選択肢マスタ（アドオン）：アプリ固有のアドオンとして登録する場合に指定します。

［選択肢マスタを更新するユーザ］

［Me］ボタンをクリックすると操作ユーザが指定されます。
指定するユーザには、アドオン種別に応じた管理権限（選択肢マスタ（アプリ共有アドオン）＝システム管理権限／選択肢マスタ（アドオン）＝アプリ管理権限）が必要です。

［選択肢一覧を保存する選択型データ項目］

プルダウンから［選択型］データ項目「選択肢マスタ作成／更新用選択肢」を指定します。

［アドオンとして保存する際の名前］

選択肢マスタファイルのファイル名を指定します（例：choice-master-name-email.xml）。拡張子（.xml）まで含めて指定します。

参考：ヘルプページ「選択肢マスタ更新」

5. 動作確認

設定が完了したら、先頭の［開始イベント］からデバッグ実行してみましょう。ヒューマンタスクで参照元の CSV データを入力すると、以降の処理はすべて自動で完了します。処理結果は、［選択肢マスタ更新］の［更新するアドオンの種別］の設定に応じて、以下の場所で確認できます。

選択肢マスタ（アプリ共有アドオン）の場合：［システム設定］＞［アプリ共有アドオン］＞［選択型データ項目で使用する選択肢マスタ］
選択肢マスタ（アドオン）の場合：アプリ詳細画面の［アプリ］＞［アドオンの管理］＞［選択型データ項目で使用する選択肢マスタ］

いずれの場合も、［アドオンとして保存する際の名前］で指定した名前のファイルが一覧に追加されていれば成功です。一覧画面では内容の確認やファイルのダウンロードができます。

6. まとめ

［CSV データ更新］の「各カラムの値を改行区切りでデータ項目に保存する」機能と［選択肢マスタ更新］を組み合わせれば、外部から入手した CSV（顧客リストや社員名簿など）から、Questetra BPM Suite の選択肢マスタを自動で作成・登録するフローを構築できます。名簿の変更に合わせてフローを再実行するだけで選択肢マスタを最新化できるため、選択肢の更新や管理の手間を大幅に削減できます。