時間入力の一括インポート

時間のかかる手動でのデータ入力を回避したり、他のシステムからのデータ移行が必要とされたりする場合は、時間入力を一括インポートします。

また、一括インポートのセッションを使用して、複数の時間入力を一度に更新することもできます。

機能の仕組み

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

アップロードされた時間入力はどこにありますか?

時間入力をアップロードしたら、データは次の場所から利用できます。

  • タイムシート アプリ
  • プロジェクトアプリ

ワークフロー

メモ

プロジェクトの作成が必要になるのは、時間入力をプロジェクトに関連付けたい場合のみです。

アクセス許可

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

新しい時間入力の一括アップロード

メモ

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

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

  1. Launchpad を開きます。

    メモ

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

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

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

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

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

    注意

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

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

    メモ

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

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

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

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

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

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

    Date

    必須

    時間入力の日付を指定します。

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

    時間

    必須

    費やした時間を時間単位で指定します。

    1 日に複数の時間入力が可能ですが、合計は 24 時間以下でなければなりません。

    clientDelay

    プロジェクトが遅延しているかどうかを指定します。

    • true：プロジェクトは遅延しています。
    • false：プロジェクトはスケジュールどおりです。

    assignedUserId

    時間入力に割り当てられたユーザーを指定します。

    description

    時間入力の詳細な説明を指定します。

    ヒント

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

    position

    リスト内の時間入力の順序を指定します。

    targetId

    条件付きで必須

    この時間入力を配置する必要があるリソース ID を指定します。

    例：プロジェクトのホームページ、計画やフィールドワークのタブ、など。

    リソース ID は URL にあります。

    例：

    https://stark.projects.highbond.com/audits
    /1494/time_entries    。1494 はプロジェクト ID です。

    メモ

    以下のいずれか 1 つにのみ記入する必要があります。

    • ターゲット ID とターゲットタイプ: プロジェクトと関連付けられた時間入力。
    • カテゴリ ID: 非プロジェクト時間カテゴリに関連付けられた時間入力。

    targetType

    条件付きで必須

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

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

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

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

    メモ

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

    メモ

    以下のいずれか 1 つにのみ記入する必要があります。

    • ターゲット ID とターゲットタイプ: プロジェクトと関連付けられた時間入力。
    • カテゴリ ID: 非プロジェクト時間カテゴリに関連付けられた時間入力。

    categoryId

    条件付きで必須

    非プロジェクト時間カテゴリの ID を指定します。

    このフィールドには、現在のテンプレートに追加した新しい非プロジェクト時間カテゴリの参照 ID を指定できます。

    メモ

    以下のいずれか 1 つにのみ記入する必要があります。

    • ターゲット ID とターゲットタイプ: プロジェクトと関連付けられた時間入力。
    • カテゴリ ID: 非プロジェクト時間カテゴリに関連付けられた時間入力。
  3. テンプレートを保存して閉じます。

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

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

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

以下の表には、Excel テンプレートにコンテンツを素早くかつ効率的に準備する上で使用できるさまざまなヒントが記載されています。

タスク 手順
一画面でテンプレートとソースドキュメントの両方を表示

Windows ユーザー：

Windows キー、および右または左矢印を押します。

Mac ユーザー：

ウィンドウをドラッグし、画面の半分に広げます。
テンプレートの複数のセルからデータをコピー＆ペーストする
  1. Excel で適切なセルを選択します。
  2. Ctrl+C を押します。
  3. データを貼り付ける先の該当するセルをクリックします。
  4. CTRL + V を押して貼り付けます。
数字または式をテキストとして処理する Excel で、式の数字の前にアポストロフィーを挿入します。
列幅または行の高さを変更しデータに自動的に適合させる
Excel で次のいずれかを行います。
  • 変更する列を選択し、選択された列見出しの右側の境界線をダブルクリックします。
  • 変更する行を選択し、選択された行の下の境界線をダブルクリックします。
順次数値データを入力する
  1. Excel の適切なセルに順番検査の最初の数字を入力します。
  2. そのセルを選択します。
  3. セルの右下隅にカーソルを移動し、 順番検査を終了すべき場所に、ラインで囲まれたエリアをドラッグします。
  4. ［自動入力オプション］をクリックします。
  5. ［入力シリーズ］を選択します。
式を使用してデータを計算する
  1. Excel で適切なセルをクリックします。
  2. 式を［fx ］フィールドに入力します。

    一般的な式のいくつかは以下のとおりです。

    • SUM - 2 つまたは複数の数字を一緒に追加できます。

      例: =SUM(A1:B5)

    • COUNT - セルに数字がある範囲のセルの数をカウントします。

      例: =COUNT(A1:A10)

    • TRIM - 単語間の 1 スペースを除き、セル内にあるスペースを取り除きます。

      例: =TRIM(A1)

    • LEN - 1 セル内にある文字数をカウントします。

      例: =LEN(A1)
1 つの列のデータを並び替える、またはフィルターする
  1. Excel で次のいずれかを行います。
    1. ［ホーム > 並べ替え & フィルター］をクリックします。
    2. ［データ > フィルター］をクリックします。

      列見出しの見出し名の横に矢印があります。

  2. フィルター処理する列に移動し、見出しの横にある矢印をクリックします。

    並べ替えおよびフィルター用のウィンドウが開きます。

  3. 必要に応じて、列のデータの並べ替えまたはフィルター処理をします。

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

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

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

例 1

シナリオ

一括インポートを使用して、1 回のアップロードで以下を実現したい。

  • 新規プロジェクトを作成する。
  • 新しいオブジェクトを作成し、それを新しいプロジェクトに関連付けます。

プロセス

Excel のテンプレートをダウンロードし、開きます。Projects ワークシートに移動し、referenceId を含む必須フィールドに入力します。新しいプロジェクトの referenceId をコピーします。

次に、Objectives ワークシートに移動し、新しい目標の詳細を追加し、parentResourceId フィールドに Projects ワークシートからコピーした referenceId を貼り付けます。こうすることで、新しい目標を新しいプロジェクトに関連付けることができます。

結果

テンプレートをアップロードすると、次のようなことが起こります。

  • 新しいプロジェクトが作成されます。
  • 新しい目標が作成され、その新しい目標は新しいプロジェクトに関連付けられます。

例 2

シナリオ

一括インポートを使用して、1 回のアップロードで以下を実現したい。

  • 新しいプロジェクトを 1 つ作成する。
  • 新しい目標を 1 つ作成し、それを新しいプロジェクトに関連付ける。
  • 新しいリスクを 2 つと新しいコントロールを 2 つ作成し、それらを新しい目標に関連付ける。

プロセス

Excel のテンプレートをダウンロードして開き、Projects ワークシートに新規プロジェクトの詳細（referenceId やその他の必須フィールドなど）を追加していきます。新しいプロジェクトの referenceId をコピーします。

次に、Objectives ワークシートに移動して、新しい目標を追加し、目標の parentResourceId フィールドに Projects ワークシートからコピーした新しいプロジェクトの referenceId を貼り付けます。これで、新しいオブジェクトの referenceId がコピーされました。

次に、Risks ワークシートに移動して、新しいリスクを追加し、各リスクの objectiveIdフィールドに、Objectives ワークシートからコピーした新しい目標の referenceId を貼り付けます。

最後に、Controls ワークシートに移動して、新しいコントロールを追加し、各コントロールの objectiveId フィールドに、Objectives ワークシートからコピーした新しいオブジェクトの referenceId を貼り付けます。

結果

テンプレートをアップロードすると、次のようなことが起こります。

  • 新しいプロジェクトが 1 つ作成されます。
  • 新しい目標が 1 つ作成され、新しいプロジェクトに関連付けられます。
  • 新しいリスクが 2 つと新しいコントロール 2 つ作成され、新しい目標に関連付けられます。

データをアップロード

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

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

    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 日に開始される一括インポートセッションで利用可能になります。この日付より前のセッションではテンプレートをダウンロードできません。

既存の時間入力を一括で更新

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

メモ

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

機能の仕組み

一括インポートページから以前のセッションを開きます。以前のセッションでアップロードされたテンプレートを開き、必要な変更を行います。次に、一括インポートページでテンプレートをアップロードします。

重要

  • 前のセッションを使用して、以前にアップロードされたデータを変更したり、訂正したりします。
  • 新しいリソースが、以前にアップロードされたデータに関連する場合でも、新しいセッションを始め、アップロードします。

例: 前のセッションで、1つのプロジェクトと数個の目標をアップロードしました。これらのリソースを更新するためには、同じセッションを開きます。リスク、統制、またはこのプロジェクトや目標に関連するその他のリソースをアップロードしたい場合は、新しいセッションを始めます。

更新する前の要件

更新する前に、次のことを実行する必要があります:

  1. 選択するセッションを決めます。これは、アップロードされたデータがセッションにリンクされているために必要になります。したがって、更新したいデータにリンクされたセッションを開く必要があります。セッションの詳細については、一括インポートのセッションを参照してください。

  2. 選択したいセッションにアップロードされる Excel テンプレートにアクセスできることを確認します。テンプレートには、テンプレートの各行における一意の識別子である参照 ID が含まれています。これらがデータの更新に必要になります。参照 ID の詳細については、テンプレートにデータを準備するを参照してください。

    注意

    データは、該当するセッションと参照 ID に基づいて更新されます。セッションと参照 ID 間に不一致がある場合は、重複が発生するかエラーになる場合があります。

更新する手順

メモ

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

以前のセッションを開く

メモ

初めて一括インポートページを開く時は、前のセッションは利用できません。セッションの詳細を確認するには、数なくとも1回はアップロードする必要があります。

セッションの詳細については、一括インポートのセッションを参照してください。

  1. Launchpad を開きます。

    メモ

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

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

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

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

  4. ［セッション］画面にスクロールダウンし、自分の好みのセッション ID をリックします。

    結果 セッションは、URL に追加された選択したセッション ID を使って読み込みます。

    メモ

    以前にアップロードされたデータを更新したい、適切なセッションを選択するようにします。セッションと参照 ID 間に不一致がある場合は、重複が発生するかエラーになる場合があります。詳細については、「更新する前の要件」を参照してください。

テンプレートでデータを更新

  1. 前の手順で選択したセッションでアップロードされた Excel テンプレートを開きます。このファイルには、参照 ID と共に、以前にアップロードされたデータが含まれています。詳細については、「更新する前の要件」を参照してください。

    メモ

    ACL Add-In オプションは、Excel テンプレートを修正する前に無効にするようにしてください。そうしない場合はアップロードできません。ACL Add-In の詳細については、Add-In for Excel の設定を参照してください。

  2. 該当するワークシートに進み、参照 ID に基づいてデータを更新します。このフィールドの詳細については、次を参照してください: テンプレートにデータを準備する

    メモ

    更新される以前にアップロードされたデータに基づき、参照 ID に対応する値を更新するようにします。不一致がある場合は、重複が発生するかエラーになる場合があります。

  3. ファイルを保存して閉じます。

データをアップロード

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

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

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

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

トラブルシューティング

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

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

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

必須フィールドにデータを入力しない場合は、行が処理されません。
データフォーマットが正しくありません。

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

リッチ テキスト フィールドには文字制限がありません。
データの値が無効であるか、ドロップダウンの値と一致しない場合があります。

例: Requests シートの received フィールドと sendRecurrentNotifications フィールドの値は、True またはFalse でなくてはなりません。
テンプレート内の無効なフィールド。
  • テンプレートに新たにフィールドを追加しないでください。
  • テンプレートからフィールドを削除しないでください。
テンプレートが予期していたフォーマットではない場合があります。

ファイルフォーマットを .xlsx にしてください。
ワークシート名が無効です。

ワークシート名を変更しないでください。
セッションの有効期限が切れている場合があります。

ページを更新し、もう一度アップロードしてください。
セッション ID が無効である可能性があります。 Web セッション ID を使用していることを確認してください。