構成オプションの一括プロビジョニング

オプションの構成オプションを作成または変更するには、新しいまたは変更後のオプションと値を含むコンマ区切り値 (CSV) ファイルをアップロードします。各オブジェクトの該当する列にオプションと値を入力するか、設定済みのオプションと値を変更します。GAX にアップロードすると、[操作] 列で指定した操作に基づいて、ファイルにリストされているオプションの作成または変更が行われます。

GAX を使用して、選択したオプションの情報をダウンロード (またはエクスポート) することもできます。また、このダウンロード データを使用して、データ アップロード用の「テンプレート」を適宜作成できます。

このインポート/エクスポート オプションの機能は、すべてのオブジェクト タイプで使用可能です。

オプションのエクスポート

GAX では、選択したオプションをスプレッドシートにエクスポートできます。必要に応じてスプレッドシートを変更し、それを .csv または .cfg ファイルに保存して GAX にアップロードすることが可能です。または、データ (列ヘッダーは除く) を削除すると、将来にわたって、その「空」のテンプレートを構成オプションのアップロードに使用できます。

オプションをエクスポートするには、次を行います。

1. Configuration Manager で、オプションをエクスポートするオブジェクトの [オプション] タブを開きます。
2. エクスポートするセクションとオプションを選択します。
3. 右上にあるオプション リストの上の [詳細] メニューで、[エクスポート] をクリックします。
4. [エクスポート オプション] ダイアログ ボックスで、出力ファイルのフォーマット (CFG または CSV) を選択して、[エクスポート] をクリックします。
   出力ファイルが作成され、ブラウザにダウンロードされます。次のようなファイル名になります。
        <object type>_annex_<object DBID>.csv または cfg
   以下に例を示します。
        CfgPerson_annex_6378.cfg または CfgPerson_annex_6378.cfg

ファイルのアップロード

一括更新をアップロードする前に、スプレッドシートにデータを入力して、CSV ファイルとして保存する必要があります。次の推奨事項に注意してください。

• オブジェクトへの新しいオプションの追加が更新の大半を占める場合、空のテンプレートを作成して適切な値を入力します。
• 主に既存のオプションを変更する場合、変更予定のオプションのみをエクスポートして、変更を加えます。

データを GAX にアップロードするには、次を行います。

1. Configuration Manager で、オプションをアップロードするオブジェクトの [オプション] タブを開きます。
2. 右上にあるオプション リストの上の [詳細] メニューで、[インポート] をクリックします。
3. [オブジェクトのインポート] ダイアログ ボックスで次を行います。
   1. [ファイルの選択] をクリックして、変更した .csv または .cfg を選択します。
   2. ファイル内の値が、オブジェクトに既に存在するいずれのオプションに対しても、正確かつ最新であることを確認できている場合は、[既存のオプションを上書き] を選択します。そうでない場合は、チェックボックスをオフのままにします。
   3. [アップロード] をクリックします。
4. レコードが処理されると、結果の概要を示す [操作完了] ダイアログ ボックスが表示されます。[閉じる] をクリックして [オプション] タブに戻ります。

ソース ファイル

GAX では、構成オプションのインポートとエクスポートに .csv (コンマ区切り値) と .cfg ファイルを使用します。両方のフォーマットで、文字列オプションのインポートとエクスポートのみがサポートされます。他のタイプの構成オプションは無視され、インポートまたはエクスポートされません。このファイル内の文字列は、すべて UTF-8 でエンコードされていなければなりません。

重要

ファイルの内容は 1 つのオブジェクトだけに関連しています。

CSV ソース ファイルでは、各行が、1 つの構成オプションを表しています。ソース ファイルには、同じオプションが、複数含まれることはありません。構成オプション セクションが、オブジェクトの構成に存在しない場合は作成されます。ソース ファイルの範囲内で、オプションの一意の識別子となるのが、セクションフィールドとキーフィールドの組み合わせです。 ファイルには 3 つの列があり、各列が、構成オプションのセクション、オプションの名前 (キー)、オプションの値を示しています。また、ファイルの最初の行には、エントリを示す Section、Key、Value という名前がついています。列の順序は重要ではありません。各列のエントリの後にコンマが挿入されます。 ソース ファイルには各オプションに関する以下の情報が含まれます。

名前	種類	必須	説明
섹션	文字列	はい	構成ファイルの名前。
キー	文字列	はい	オプションの名前。
값	文字列	いいえ	オプションの新しい値。

CFG ファイルでは、セクションとオプションをそれぞれ個別の行で指定します。セクション名は角かっこで囲みます。各セクションの後に、そのセクションのオプションを該当の値とともにリスト化します。以下に例を示します。

[section_name1]
option-name1=option_value2
...
option_nameN=option_valueN

[section_name2]
option-nameN+1=option_valueN+1
...

例

次のデータを GAX にアップロードして、2 つの新しいオプションを 1 つの既存のユーザー オブジェクトに追加します。

섹션	キー	값
gaxproperties	datemodified	1478163902397
htcc	roles	エージェント

このデータを CSV ファイルにすると、次のようになります。

Section,Key,Value
gaxproperties,datemodified,1478163902397
htcc,roles,Agent

同じ情報を CFG ファイルで GAX からエクスポートすると、次のようになります。

[gaxproperties]
datemodified=1478163902397
[htcc]
roles=Agent