要求の一括インポート

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

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

機能の仕組み

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

要求をプロジェクトに、または目標、説明文などのプロジェクト内のコンポーネントに、一括でアップロードできます。

要求のアップロード先は?

要求をアップロードしたら、データは次の場所で利用できます:

  • 要求タブ
  • タスクの追跡ツールアプリ
  • 目標、説明文などのプロジェクト内のコンポーネント (targetTypetargetId がテンプレート内に記述されている場合).詳細については、テンプレートにデータを準備するを参照してください。

作業を開始する前に

要求のインポートを開始する前に、一括インポートから Projects ワークシートに入力するか、またはユーザーインターフェイスを使用して、プロジェクトを作成する必要があります。

メモ

一括インポートを使用すると、一度のインポートで多くの Diligent One リソースを作成できます。必要なすべてのリソースをワークシートに入力し、すべてを一括でインポートできます。

ワークフロー

アクセス許可

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

新しい要求を一括でアップロードする

メモ

  • インターフェイス用語はカスタマイズ可能であり、フィールドとタブも設定可能です。ご利用の Diligent One インスタンスでは、一部の用語、フィールド、およびタブが異なる可能性があります。
  • 必須フィールドが空白のままの場合、「このフィールドは必須です」という警告メッセージが表示されます。一部のカスタムフィールドにはデフォルト値が設定されている場合があります。

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

  1. Launchpad を開きます。

    メモ

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

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

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

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

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

    注意

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

    メモ

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

  4. リソースの選択]の[リソースの種類]で[すべてのリソース]を選択します。

  5. .xslx テンプレートのダウンロード]をクリックします。

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

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

  1. ダウンロードされたテンプレート (HighBond_Template.xlsx) を開き、Requests ワークシートに進みます。
  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 のユーザーインターフェイスからリソースを追加/更新する場合、これらは利用できません。

    ccContacts

    要求を実行する責任者であるユーザーの電子メール ID を指定します。

    ヒント

    複数の電子メール ID はカンマで区切って追加できます。

    description

    必須

    ドキュメント名、バージョン番号、部門など、要求された情報を説明します。ここで情報が見つかる可能性があります。

    ヒント

    テキストの書式を設定するには、HTML タグを使用します。例:<b>、<i>、<ol>、<ul>。

    要求の詳細については、ドキュメントの要求を参照してください。

    dueDate

    要求が実行される期限を指定します。

    日付は YYYY-MM-DD の形式でなければなりません。

    emailMessage

    電子メールの本文をカスタマイズできます。

    emailSubject

    電子メールの件名行をカスタマイズできます。

    owner

    条件付きで必須

    要求を実行する責任者の名前を指定します。

    このフィールドに Diligent One ユーザー以外のユーザーを追加するのに最適です。

    このフィールドは、ownerUser フィールドが空白の場合は必須になります。

    ownerEmail

    条件付きで必須

    要求を実行する責任者の電子メール ID を指定します。

    このフィールドに Diligent One ユーザー以外のユーザーを追加するのに最適です。

    ownerUser

    条件付きで必須

    要求を実行する責任者のユーザー ID (UID) または電子メール ID を指定します。

    ユーザーの UID を取得する方法について説明します

    非 Diligent One ユーザーをこのフィールドに追加することはできません。

    このフィールドは、owner フィールドが空白の場合は必須になります。

    ownerUser を指定すると、ownerownerEmail フィールドにある値を上書きします。

    メモ

    このフィールドに追加するユーザーは既に該当するプロジェクト/フレームワークに割り当てられていることを確認してください。

    ユーザー ロールの割り当てについては、参照してください プロジェクトとフレームワークにおけるユーザー ロールの割り当て

    position

    要求が表示される順序を指定します。

    projectId

    必須

    この要求の配置先のプロジェクト ID を指定します。

    例:

    https://stark.projects.highbond.com/audits/
    90305/dashboard
    (90305 は、プロジェクト ID です)。

    メモ

    また、このフィールドには、現在のテンプレートに追加した新しいプロジェクトの参照 ID を指定することができます。これにより、テンプレートをアップロードする際に、要求とプロジェクトが関連付けられます。

    一括インポートでの Diligent One リソースの関連付けの詳細については、「一括インポートでリソースのリンクに参照 ID を使用する場合」を参照してください。

    received

    は、次の要求の状態を指定します。

    • True: 受領済み
    • False: オープン。

    デフォルトでは偽になっています。

    requestorUser

    必須

    ドキュメントを要求するユーザーのユーザー ID (UID) または電子メール ID を指定します。

    ユーザーの UID を取得する方法について説明します

    sendRecurrentNotifications

    要求所有者に電子メールを送信するかどうか、および指定された繰り返しスケジュールについて CC で送る担当者を指定します。

    • True: 定期スケジュールについて電子メールを送信します。
    • False: 電子メールのスケジュールをオフにします。

    繰り返しリマインダーの詳細については、定期的な要求アラームの送信を参照してください。

    ccUsers

    要求を実行する組織内の責任者であるユーザーのユーザー ID (UID) または電子メール ID を指定します。

    ユーザーの UID を取得する方法について説明します

    targetType

    この要求を配置する必要があるコンポーネントタイプを指定します。

    ターゲット タイプは以下のいずれかでなければなりません。

    • projects
    • project_files
    • objectives
    • narratives
    • risks
    • controls
    • walkthroughs
    • control_test_plans
    • control_tests
    • issues
    • walkthrough_summaries
    • project_plannings
    • project_results
    • risk_control_matrices
    • testing_rounds

    デフォルトはプロジェクトです。

    重要

    上記と全く同じ用語を使用します。

    メモ

    このフィールドでは英語のデフォルト値のみを使用します。カスタムの英語の値およびローカライズされた (英語以外) 値は、まだ一括インポートでサポートされていません。

    各コンポーネントで使用するターゲット ID については、 プロジェクト コンポーネントのターゲット タイプおよび ID

    targetId

    必須

    この要求の配置先のリソース ID を指定します。リソース ID は URL にあります。

    例:

    https://stark.projects.highbond.com/audits/
    90305/objectives/94778

    90305 はプロジェクト ID、94778 は目標 ID です)。

    targetId フィールドでは、次のいずれかを実行できます。

    • プロジェクトの下に問題を配置したい場合に、プロジェクト ID を指定します (これは、projectId フィールドで説明した ID と同じ ID です)。

    • プロジェクトのコンポーネントの下に問題を配置したい場合に、コンポーネント ID(上記の例では目標 ID)を指定します 。プロジェクト ID は projectId フィールドで説明した内容と同じ内容でなければなりません。

    各コンポーネントで使用するターゲット ID については、 プロジェクト コンポーネントのターゲット タイプおよび ID

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

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

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

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

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

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

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

プロジェクト コンポーネントのターゲット タイプおよび ID

次のセクションは、該当するプロジェクトコンポーネントのターゲットタイプおよび ID を示します。

要求を配置するコンポーネントに基づいて、Excel テンプレートで関連するターゲット タイプおよび ID を使用します。

データをアップロード

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

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

    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.xlsxErrorLog.xlsx

テンプレートテンプレートをクリックしてダウンロードし、以前にアップロードしたデータを修正することができます。

エラーログエラーログはアップロードが失敗した場合に生成されます。エラーログを確認して、エラーを修正し、テンプレートを再度アップロードできます。

メモ
  • テンプレートとエラーログは、アップロードの日付から最大 18 か月間ダウンロードできます。
  • テンプレートをダウンロードするためのリンクは、2022 年 5 月 13 日に開始される一括インポートセッションで利用可能になります。この日付より前のセッションではテンプレートをダウンロードできません。

既存の要求を一括で更新

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

メモ

一括インポートを使用してアップロードしたリソースのみを更新できます。

トラブルシューティング

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

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

エラー ソリューション
アップロードされたファイル内の行数が 2000 行を超えている可能性があります (すべてのワークシートを含む)。 テンプレートから余分な行を削除し、再アップロードします。
アップロードされたファイルの必須フィールドが空白であるか、見つかりません。 すべての必須フィールド(テンプレートの列の名前が赤とオレンジ色でマーク)には必ず入力するようにしてください。
メモ

必須フィールドにデータを入力しない場合は、行が処理されません。

データフォーマットが正しくありません。

テキストフィールドのデータが有効であり、その項目長が上限の 255 文字を超えないようにしてください。

リッチ テキスト フィールドには文字制限がありません。

データの値が無効であるか、ドロップダウンの値と一致しない場合があります。

例: Requests シートの received フィールドと sendRecurrentNotifications フィールドの値は、True またはFalse でなくてはなりません。

テンプレート内の無効なフィールド。
  • テンプレートに新たにフィールドを追加しないでください。
  • テンプレートからフィールドを削除しないでください。
テンプレートが予期していたフォーマットではない場合があります。

ファイルフォーマットを .xlsx にしてください。

ワークシート名が無効です。

ワークシート名を変更しないでください。

セッションの有効期限が切れている場合があります。

ページを更新し、もう一度アップロードしてください。

セッション ID が無効である可能性があります。 Web セッション ID を使用していることを確認してください。