プロジェクトの一括インポート

時間のかかる手動のデータ入力を避けたい、あるいは別のシステムからデータを移行する場合には、プロジェクトを一括でインポートします。

一括インポートのセッションを使用すると、直ちに複数のプロジェクトを更新することもできます。詳細については、「既存のプロジェクトを一括で更新」を参照してください。

機能の仕組み

新しい一括インポート セッションを開き、Launchpad の一括インポートページから Excel テンプレートをダウンロードします。テンプレートにデータを用意し、一括インポート ページでテンプレートをアップロードします。

アップロード済みプロジェクトのありか

プロジェクトをアップロードしたら、そのデータはプロジェクトアプリで利用できます。

ワークフロー

アクセス許可

システム管理者のみが、一括インポートから Diligent One のリソースを一括でアップロードできます。

新しいプロジェクトを一括で更新する

新しい一括インポート セッションを開き、Excel テンプレートをダウンロードします。

1. Launchpad を開きます。

   メモ

   会社において Launchpad で複数のインスタンスを使用している場合は、該当するインスタンスがアクティブであることを確認します。

2. ［プラットフォームの設定］>［組織］を選択します。

   ［組織］のオプションが表示されない場合、サインインに使用されたアカウントには管理者権限がありません。

3. ［一括インポート］から、［大半のリソースを管理］をクリックします。

   新しい一括インポート セッションが開始され、URL にセッション ID が付加されます。

   注意

   新しいリソースを追加するには、常に新しいセッションを開始する必要があります。

   詳細はこちら

   例えば、200 エンティティを 2 バッチ (100＋100) でインポートしたい場合などです。同じセッションでバッチを次々にアップロードすると、2 番目のバッチをアップロードした後、1 番目のバッチでアップロードされたデータが 2 番目のバッチのデータで置き換えられてしまうのですが。このデータ損失を避けるために、常に 1 つのセッションで最初のバッチをアップロードし、次のバッチのために新しいセッションを開始してください。同様に、さらに新しいリソースを追加するために新しいセッションを開始します。

   メモ

   以前のセッションを使用して、以前にアップロードされたデータを更新することができます。詳細については、「一括インポートの更新機能」を参照してください。

4. ［リソースを選択］の下で、リソースの種類で次のオプションの 1 つを選択します。

   • ［プロジェクト］>［プロジェクトの種類］プロジェクトの種類別にプロジェクトを作成します。テンプレートは動的で、選択したプロジェクトの種類の構成が組み込まれています。この方法を用いると、特定のプロジェクトの種類に属する複数の Diligent One リソース（目標、リスク、統制、軽減）を作成することができます。
   • すべてのリソース プロジェクト、フレームワーク、目標、リスク、統制、軽減、問題、アクション、要求、エンティティ、およびコンプライアンス マップなど、すべてのリソースを一度に一括してインポートすることができます。このテンプレートは静的で、リソースの構成を手動で把握する必要があるため、完了するために多少の労力を要します。
5. ［.xslx テンプレートのダウンロード］をクリックします。

   Excel テンプレートは、ローカル マシンに保存されます。

テンプレートにデータを準備する

1. ダウンロードしたテンプレートを開き、Projects ワークシートに移動します。動的テンプレートである場合、ワークシートの名前はリソースとそのプロジェクトの種類 ID の組み合わせになります。例：Projects-85692.
2. テンプレートにデータをコピー＆ペーストするか、データを入力します。データ入力については、「コンテンツ作成のヒント」をご覧ください。
   メモ

   • Add-In for Excel を使用する場合は、Excel テンプレートを修正する前に、ACL Add-In オプションを必ず無効にしてください。手順については、Add-In for Excel の構成を参照してください。
   • ワークシート名またはフィールドを変更しないでください。これらは大文字小文字が区別されるものであり、修正してはいけません。
   • 一度にアップロード可能な最大行数は 2000 です (すべてのワークシートを含む)。

   フィールド	説明
   referenceId 必須	リソースに対しての一意の ID を指定します。これは、ワークシートの各行に対して一意でなくてはなりません。 ここにはテキストと数値の組み合わせを含めることができ、最大項目長は 255 文字です。 このフィールドは、テンプレートの各行のプライマリーキーです。このリソースをもう一度更新したい場合にこのキーが必要になります。 重要 参照 ID を使用して、リソースをすぐに相互に関連付けることができます。例えば、同じアップロードで、新しいプロジェクトとそのプロジェクトに関連する新しい目標を作成することができます。これは、必須フィールドに referenceId を指定して、プロジェクトと目標の間にリンクを作成することで実行できます。 一括インポートでの Diligent One リソースの関連付けの詳細については、「一括インポートでリソースのリンクに参照 ID を使用する場合」を参照してください。 メモ 「一括インポート」を使用してリソースを追加または更新する場合は、参照 ID が必要です。Diligent One のユーザーインターフェイスからリソースを追加/更新する場合、これらは利用できません。
   name 必須	プロジェクトを説明する名前を入力します。 120 文字を上限とします。 プロジェクトの詳細については、「プロジェクトの進捗状況の作成」を参照してください。
   status	プロジェクトの現在の進捗状況を指定します。 選択可能な進捗状況は以下のとおりです。 draft proposed active completed デフォルトの進捗状況は「アクティブ」です。 メモ このフィールドでは英語のデフォルト値のみを使用します。カスタムの英語の値およびローカライズされた (英語以外) 値は、まだ一括インポートでサポートされていません。 プロジェクトの進捗状況については、プロジェクトの進捗状況の設定を参照してください。
   description	プロジェクトの詳細な説明を指定します。 ヒント テキストの書式を設定するには、HTML タグを使用します。例：<b>、<i>、<ol>、<ul>。 プロジェクトの詳細については、「プロジェクトの作成」を参照してください。
   background	プロジェクトの背景状況を指定します。
   budget	プロジェクトに割り当てられた合計時間を指定します。
   certification	プロジェクトの認定機能の進捗状況を指定します。 True： 有効。 False： 無効。 デフォルトは false です。 詳細については、「認定プログラムの作成」を参照してください。
   managementResponse	プロジェクトの総合評価への経営者の応答を指定します。
   maxSampleSize	プロジェクトで定義されているテストラウンド間で分割された合計サンプル サイズを指定します。 デフォルトは 0 です。 このフィールドは、ワークフローに依存する、プロジェクトの種類によって異なります。詳細については、手続きの実行および統制のテストを参照してください。
   numberOfTestingRounds	プロジェクトで実行されるテストラウンドの回数を指定します。 デフォルトは 0 です。 このフィールドは、ワークフローに依存する、プロジェクトの種類によって異なります。詳細については、手続きの実行および統制のテストを参照してください。
   opinion	プロジェクトの結果の最終評価を指定します。
   opinionDescription	備考や推奨を含む、プロジェクトの結果に関する正式な説明を指定します。
   purpose	プロジェクトの意図した結果、目的、目標を指定します。
   startDate 必須	プロジェクトの開始をスケジュールしている日付を指定します。 日付は YYYY-MM-DD の形式でなければなりません。
   targetDate 必須	プロジェクトの完了をスケジュールしている日付を指定します。 日付は YYYY-MM-DD の形式でなければなりません。
   projectTypeId 必須 (静的テンプレートのみ)	プロジェクトに関連するプロジェクトの種類を示します。 プロジェクトの種類 ID は、そのプロジェクトの種類に移動する時の URL で利用できます。 例： https://stark.projects.highbond.com/audit_types /36245/description（36245 は、プロジェクトの種類 ID です）。 詳細については、「ワークフローとプロジェクトの種類」を参照してください。
   scope	プロジェクトがカバーする事項を指定します。 詳細については、「プロジェクトの計画」を参照してください。
   controlPerformance	プロジェクトの統制パフォーマンス機能の進捗状況を指定します。 True：有効。 False：無効。 デフォルトは false です。 詳細については、統制パフォーマンスのスケジューリングを参照してください。
   riskAssurance	プロジェクトのリスク保証機能の進捗状況を指定します。 True：有効。 False：無効。 デフォルトは false です。 詳細については、リスク保証の使用開始方法を参照してください。
   entities	プロジェクトの項目にタグ付けされたエンティティのエンティティ ID を指定します。 エンティティに移動すると、URL の中にエンティティ ID が表示されます。 例： https://stark.projects.highbond.com/ auditable_entities/33055（33055 は、エンティティ ID です）。 複数の ID をカンマで区切って指定できます。 メモ または、このフィールドには、現在のテンプレートに追加した新しいエンティティの参照 ID を指定することができます。これにより、テンプレートをアップロードするときに、プロジェクトとエンティティが関連付けられます。 一括インポートでの Diligent One リソースの関連付けの詳細については、「一括インポートでリソースのリンクに参照 ID を使用する場合」を参照してください。 エンティティの詳細については、エンティティのタグ付けの設定を参照してください。
   tagList	プロジェクトに関連付けられたタグのカンマ区切りのリスト。詳細については、「プロジェクトのトリガー」を参照してください。 メモ 値の先頭が角括弧であるか、カンマ、セミコロン、または改行が含まれている場合は、値を二重引用符（" "）で囲みます。
   customAttributes_1_term - customAttributes_n_term	1～n のカスタム属性フィールドを指定します。 Excel テンプレートのカスタム属性は、テンプレートの種類によって、以下のように異なります。 プロジェクト > プロジェクトの種類：デフォルトでは、プロジェクトの種類で定義されたカスタム属性フィールドがテンプレートに含まれます。 すべてのリソース：カスタム属性フィールド（期間と値の両方）を手動で確認し、入力する必要があります。テンプレートには、カスタム属性の期間と値の 1 つのペアが表示され、必要に応じてさらに 9 つのペアを追加することができます。追加するには、customAttributes_2_term、customAttributes_2_value などのように、カウンターを追加して同じ命名規則に従ってください。 プロジェクト、フレームワーク、およびそれらのコンポーネントのカスタム属性は、プロジェクトの種類で定義されます。カスタム属性の詳細については、用語、フィールド、通知のカスタマイズを参照してください。
   customAttributes_1_value - customAttributes_n_value	1～n のカスタム属性値を指定します。 Excel テンプレートのカスタム属性は、テンプレートの種類によって、以下のように異なります。 プロジェクト > プロジェクトの種類：デフォルトでは、プロジェクトの種類で定義されたカスタム属性フィールドがテンプレートに含まれます。 すべてのリソース：カスタム属性フィールド（期間と値の両方）を手動で確認し、入力する必要があります。テンプレートには、カスタム属性の期間と値の 1 つのペアが表示され、必要に応じてさらに 9 つのペアを追加することができます。追加するには、customAttributes_2_term、customAttributes_2_value などのように、カウンターを追加して同じ命名規則に従ってください。 プロジェクト、フレームワーク、およびそれらのコンポーネントのカスタム属性は、プロジェクトの種類で定義されます。カスタム属性の詳細については、用語、フィールド、通知のカスタマイズを参照してください。 メモ 値の先頭が角括弧であるか、カンマ、セミコロン、または改行が含まれている場合は、値を二重引用符（" "）で囲みます。 例："[2021]"、"First, second asset"、"This is important; this too" 複数選択フィールドの場合、各値をカンマで区切ることで複数の値を追加することができます。 ドロップダウンリストまたは複数選択フィールドでは、値がオプションで提供されたものとまったく同じであることを確認してください。

   メモ

   動的テンプレートで、ドロップダウンフィールドの場合、ドロップダウンリストのオプションは、最初の行にのみ表示されます。より多くの行にオプションを表示するには、最初の行をコピーして、必要な行に貼り付けます。

3. テンプレートを保存して閉じます。

コンテンツを準備する場合のヒント

コンテンツの準備には以下のことを行います。

• ソースデータの Excel テンプレートへのコピー＆ペースト
• 該当する場合、Excel テンプレートへのデータの入力
• 一括アップロードを準備する際のテンプレートの保存

一括インポートでの参照 ID を使用したリソースのリンク

参照 ID は、一括インポート Excel テンプレートのフィールドです。すべてのワークシートの最初のフィールドであり、すべてのリソースで利用可能です。ワークシート内の各レコードに一意の識別子です。

参照 ID を使えば、Diligent One のリソースをすぐに相互に関連付けることができます。例えば、プロジェクトと、そのプロジェクトに関連する目標を同じインポートで作成できます。これは、必須フィールドに referenceId を指定することで実行できます。

データをアップロード

次のいずれかを実行します。

• テンプレートをブラウザウィンドウにドラッグ＆ドロップします。
• ［コンピューターから選択］をクリックして、コンピューターから更新されたテンプレートを選択します。

  1 つの Excel テンプレートのみを一度にアップロードできます（各ファイルは別々に検証されます）。

結果 プロセスの結果に基づき、成功または失敗のメッセージが表示され、最新セッションがセッションテーブルに更新されます。

一括インポートのセッション

一括インポートでのセッションとは、Diligent One リソースをインポートするための一連のユーザー操作のことです。各ユーザーのセッションは、セッションテーブルに記録されます。

セッションテーブルには次の情報が含まれています。

フィールド名	説明
Web セッション	Web セッションのリストを示します。 Web セッションとは、一括インポート ユーザーインターフェイスを使用して完了したセッションを指します。一括インポート ページを開くたびに、新しいセッションが開始されます。
API セッション	API セッションのリストを示します。 API セッションとは、Postman などの API プラットフォームを使用して完了したセッションのことです。
更新	セッション テーブルを再読み込みします。
セッション ID	セッション識別子。 Web セッションでは、セッション ID をクリックすることで特定のセッションに移動でき、URL にセッション ID が追加されます。 例：https://stark.bulkimporter.highbond.com/import/bcc1e04e-4cd3-46d2-a8be-0b9083baccdc。 bcc1e04e-4cd3-46d2-a8be-0b9083baccdc はセッション ID です。 メモ Web セッションと API セッションのセッション ID は似ていますが、エラーを避けるため、ID を入れ替えないようにしてください。
日付	セッションの日時を表示します。データを昇順または降順に並べ替えることができます。
アップロード方法	ユーザー名を表示します。
進捗状況	アップロードの状態 (成功または失敗) を示します。 状態をクリックすると、完了したインポートの詳細が表示されます。
ファイル名	アップロードされたテンプレートとエラーログの名前を表示します。例：HighBond_Template.xlsx、ErrorLog.xlsx。 テンプレートテンプレートをクリックしてダウンロードし、以前にアップロードしたデータを修正することができます。 エラーログエラーログはアップロードが失敗した場合に生成されます。エラーログを確認して、エラーを修正し、テンプレートを再度アップロードできます。 メモ テンプレートとエラーログは、アップロードの日付から最大 18 か月間ダウンロードできます。 テンプレートをダウンロードするためのリンクは、2022 年 5 月 13 日に開始される一括インポートセッションで利用可能になります。この日付より前のセッションではテンプレートをダウンロードできません。

既存のプロジェクトを一括で更新

セッションを使用した一括インポートでは、直ちに複数の項目を更新できます。

トラブルシューティング

セッション テーブルからエラー ログをダウンロードして確認できます。一般的な一括アップロードエラーについて理解し、エラーの修正方法を学びます。

次の表は、テンプレートをアップロードする際に発生する場合のある潜在的なエラーの一覧です。

エラー	ソリューション
アップロードされたファイル内の行数が 2000 行を超えている可能性があります (すべてのワークシートを含む)。	テンプレートから余分な行を削除し、再アップロードします。
アップロードされたファイルの必須フィールドが空白であるか、見つかりません。	すべての必須フィールド（テンプレートの列の名前が赤とオレンジ色でマーク）には必ず入力するようにしてください。 メモ 必須フィールドにデータを入力しない場合は、行が処理されません。
データフォーマットが正しくありません。	テキストフィールドのデータが有効であり、その項目長が上限の 255 文字を超えないようにしてください。 リッチ テキスト フィールドには文字制限がありません。
データの値が無効であるか、ドロップダウンの値と一致しない場合があります。	例: Requests シートの received フィールドと sendRecurrentNotifications フィールドの値は、True またはFalse でなくてはなりません。
テンプレート内の無効なフィールド。	テンプレートに新たにフィールドを追加しないでください。 テンプレートからフィールドを削除しないでください。
テンプレートが予期していたフォーマットではない場合があります。	ファイルフォーマットを .xlsx にしてください。
ワークシート名が無効です。	ワークシート名を変更しないでください。
セッションの有効期限が切れている場合があります。	ページを更新し、もう一度アップロードしてください。
セッション ID が無効である可能性があります。	Web セッション ID を使用していることを確認してください。