Vault Loader を使うと、お使いの Vault のグループに対して一括アクションを実行することができます。グループを読み込む前に、グループフィールドの名前と値を含む CSV 入力ファイルを準備します。
CSV 入力ファイルの準備
グループの作成
新規グループの作成時には、グループ label__v
のみが必須フィールドで、固有値に設定される必要があります。
グループの更新
グループの更新時には、グループ ID
フィールドが必須です。Vault はグループ ID を使用して既存のグループと入力内容に指定されたドキュメントとを一致させます。
グループの挿入/更新
挿入/更新アクションは、作成と更新の組み合わせです。新規グループの作成と既存のグループ情報の更新に必要なフィールドと値の入力内容を 1 つ作成します。
グループを読み込む方法
グループを作成、更新、挿入/更新するには:
- ローダタブの左側のパネルで、読み込みをクリックします。
- CSV ファイルで選択をクリックし、CSV 入力ファイルを選択します。
- オブジェクトタイプ選択リストで、グループを選択します。
- アクションタイプ選択リストで、作成、更新または挿入/更新を選択します。
- 読み込みの開始をクリックします。
リクエストを処理する前に、Vault が選択された CSV ファイルの検証を実行します。ファイルが有効な場合、Vault がリクエストの処理を開始します。終了すると、Vault 通知とメール (リクエスト詳細および CSV 出力ファイルが添付された) が送信されます。
ファイルバリデーション
グループを作成または更新する Vault Loader ジョブを開始する前に、Vault は選択されている CSV ファイルが特定の基準を満たしていることを確認します:
- 空でない
- 空の列を含まない
- 有効なヘッダー行を含みます。無効なヘッダー行とは、読み込んだレコードのメタデータに一致する列がないものです。
ファイルが有効でない場合、Vault にシステムメッセージが表示され、処理が停止して、新しい CSV ファイルを選択することができます。Vault のメタデータと一致しないヘッダー列がある場合、システムメッセージによりユーザが読み込みを停止したり、これらの列を無視して先に進んだりできるようになります。
グループフィールドおよび値の取得
Vault グループレコードは、標準フィールド一式で設定されます。ID
や create_by__v
などのシステム管理フィールドを除き、ほとんどのユーザフィールドに値を設定することができます。
- 文字列フィールドにユーザ定義の英数文字値を設定します。
- オブジェクト参照フィールドに使用可能な値を設定します。
- 真偽フィールドを True (真) または False (偽) に設定します。
Vault API グループメタデータを参照して、すべてのフィールドがグループオブジェクトに設定されているかを確認します。API またはコマンドラインツールを使用して、Vault ですべてのグループを取得することもできます。
Vault の個別のグループに設定されたフィールドおよび値を表示するには、管理者 > ユーザ & グループ > グループに進み、グループをクリックします。
グループ ID フィールドについて
グループ ID は、システム管理型の数値フィールドで、各新規グループに値が自動的に割り当てられています。ID
フィールドは編集できません。システム管理グループは 1 桁の ID (ID: 1、2、3 など) を持ちます。カスタムグループには、通常大きな値が割り当てられます (ID: 123456789)。
Vault Loader、Vault グループ API、またはコマンドラインツールを使用してグループ ID のリストを取得できます。
Vault の個別グループの ID を確認するには、管理者 > ユーザ & グループ > グループに進み、グループレコードをクリックします。グループ ID は、アドレスバーの URL 末尾に配置されています。
例: myvault.veevavault.com/ui/#admin/users_group/detail=&g=20020002
ユーザ ID フィールドについて
ユーザ ID は、システム管理型の数値フィールドで、各新規ユーザに値が自動的に割り当てられています。ID
フィールドは編集できません。
Vault Loader、Vault グループ API、またはコマンドラインツールを使用してユーザ ID のリストを取得できます。
Vault の個別のユーザの ID を確認するには、管理者 > ユーザ & グループ > ユーザに進み、ユーザレコードをクリックします。ユーザ ID は、アドレスバーの URL 末尾に配置されています。
例: myvault.veevavault.com/ui/#admin/users_group/detail=&u=11001