Diligent One プロジェクトのデータをインポートする

Analytics テーブルを作成するには、Diligent One プロジェクトで操作する権限があるプロジェクトからデータをインポートします。

プロジェクトからは Diligent One インスタンスのすべてのアクティブなプロジェクトに含まれるすべてのテキスト情報を集合的に含む、さまざまなタイプのテーブルをインポートできます。

当該の情報を活用する方法

プロジェクトからインポートされた情報を使用して、さまざまな種類の分析を実行できます。例：

• あるプロジェクトの未完了の情報を見つける方法として、キーフィールドでインポートされたテーブルを結合する

  詳細については、プロジェクトからインポートされたテーブルの結合を参照してください。

• Tableau や Microsoft Power BI

  などのさまざまなレポートツールでの使用を目的に、Analytics から情報をエクスポートするサードパーティ レポート アプリケーションからの Analytics への接続詳細については、

  を参照してください。

レコード長の制限

Analytics にインポートできる最大レコード長は 32,767 文字または 16,383 Unicode 文字です。

最大値を超えるデータをプロジェクトからインポートしようとすると、エラーメッセージが表示され、インポートが失敗します。インポートから大きい説明文フィールドを削除し、レコード長を削減してください。

もう一つの方法は、Analytics のコマンドラインで IMPORT GRCPROJECT コマンドを使用してインポートを実行することです。このコマンドを使用するとき、CHARMAX パラメーターを含めることができます。これを使用すると、インポートするフィールドごとに最大文字数を指定できます。詳細については、IMPORT GRCPROJECT コマンドを参照してください。

手順

1. ［インポート］ > ［Diligent One］ > ［プロジェクト］の順に選択します。
2. ［インポートするデータの選択］ダイアログ ボックスで、組織フォルダーをダブルクリックします。
3. インポートするテーブルのフォルダーをダブルクリックします。

   メモ

   一度に Analytics にインポートできるテーブルは 1 つだけです。共通キー フィールドがある場合は、プロジェクトからインポートされたテーブルを後から結合できます。

4. インポートするフィールドを選択するか、［すべて選択］を選択し、テーブル全体をインポートして［OK］をクリックします。

   データがプロジェクトからインポートされます。インポートされたテーブルの使用性を改善するには、HTML マークアップがあるリッチテキストフィールドが最後に配置されます。

5. ［データ ファイルを別名で保存］ダイアログ ボックスで、Analytics データ ファイルのファイル名を入力し、必要であれば、そのファイルを保存する場所を変更して、［保存］をクリックします。
6. Analytics プロジェクトに追加する Analytics テーブルの名前について、デフォルトの名前をそのまま用いるか、または別の名前を入力して、［OK］をクリックします。

   メモ

   Analytics のテーブル名は、最長で 64 文字の英数字（拡張子 .FIL を含まない）に制限されます。名前にはアンダースコア文字（_）を使用できますが、他の特殊文字やスペースは使用できません。名前の先頭を数字にすることはできません。

プロジェクトからインポートされたテーブルの結合

プロジェクト アプリから Analytics にテーブルをインポートした後、テーブルを結合し、作業していたプロジェクトのテキスト情報の一部またはすべてを作成できます。

以下の図は、プロジェクトのさまざまなテーブルが関連付けられる方法を示し、インポートが完了した後にテーブルを結合するために使用できる共通キー フィールドを提供します。

問題テーブルおよび時間入力テーブルの target_type フィールドはキーフィールドではありません。このフィールドは、キーフィールドではなく、個々の問題または時間入力を関連付ける特定のテーブルの種類を指定するものです。target_type フィールドを使用して、結合をフィルタリングし、関心があるテーブル関係のみが含まれます。

パスワード要件

パスワードが必要ではない

Analytics のコピーをアクティベーションするためにオンラインアクティベーションを使用した場合は、Diligent One からインポートするパスワードを指定する必要がありません。パスワードは自動的に作成され、コンピューターに保存されたアクティベーション情報に基づいて Diligent One に送信されます。

パスワードが必要

次のどちらの状況でも、Diligent One からインポートするためにパスワードを指定する必要はありません。

• オフラインアクティベーションを使用して Analytics のコピーをアクティブ化した場合

• スクリプトを使用して Diligent One からインポートし、ロボットでスクリプトを実行した場合

必須のパスワード値は、Diligent One アクセス トークンです。

Diligent One アクセス トークンを取得する

新しいアクセストークンを作成する理由がない場合は、既存のトークンを使用してください。既存のトークンが機能しない場合は、新しいトークンを作成してください。既存のトークンを使用すると、管理する必要があるトークン数が減ります。

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

   • Analytics メインメニューで［ツール］ > ［Diligent One アクセス トークン］の順に選択します。

   • スクリプト エディター内を右クリックし、［挿入］ > ［Diligent One トークン］の順に選択します。

   ［API トークンを管理］ページがお使いのブラウザーで開きます。最初に Diligent One にサインインすることを求められる場合があります。

   Analytics からの［API トークンを管理］ページへのアクセスが便利です。Diligent One にサインインし、Analytics を使用せずにユーザープロファイルからこのページにアクセスすることもできます。

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

   • 既存のトークンを使用する

     1. ［トークン］列で、使用するトークンをクリックします。

     2. Diligent One アカウントのパスワードを入力し、［確認Diligent One］をクリックします。

        マスクされていないトークンが表示されます。

     3. ［コピー ］をクリックしてトークンをコピーします。

        ヒント

        トークンが含まれているこのダイアログボックスは、そのトークンを貼り付けるまで閉じないでください。

   • 新しいトークンを作成する

     1. ［トークンを追加］ > ［Analytics］をクリックします。

     2. ［新しい Analytics トークン］サイド パネルで、次の情報を指定します。

        フィールドまたはオプション	説明
        説明	次のような有用な情報を提供する説明を入力します。 トークンの目的 トークンの使用場所 - 例えば、Analytics スクリプトの名前と場所、ロボットのタスクの名前と場所など。
        トークンの有効期限	有効 指定した日数後にトークンの有効期限が切れます 無効 トークンの有効期限はありません メモ あなたの組織には、トークンを一定期間後に失効させるセキュリティポリシーがあるかもしれません。有効期限付きのトークンを作成することは良い習慣です。Diligent One では、有効期限の前に自動でメール通知が送られます。
        有効期限が切れるまでの日数	トークンの有効期限が切れるまでの日数を指定します (1～365)。
        パスワード	Diligent One アカウントのパスワードを入力します。

     3. ［トークンを生成］をクリックします。

     4. ［コピー ］をクリックしてトークンをコピーします。

        ヒント

        トークンが含まれているこのサイド パネルは、トークンを貼り付けるまで閉じないでください。

3. 使用しているデータアクセスとパスワード定義方法に応じて、次のいずれかを実行します。

   Analytics ユーザーインターフェイス

   コピーしたトークンを、Diligent One に手動でアクセスする際に表示されるパスワードプロンプトに貼り付けます。

   Analytics スクリプト

   • PASSWORD コマンド コピーしたトークンをスクリプト実行中に表示されるパスワードプロンプトに貼り付けます。

   • SET PASSWORD コマンド コピーしたトークンを、スクリプト内の SET PASSWORD コマンド構文の適切な位置に貼り付けます。

4. Launchpad で、トークンが含まれているダイアログボックスまたはサイド パネルを閉じます。

   新しいトークンを作成した場合は、部分的にマスクされたバージョンのトークンが、トークンのリストに追加されます。

   詳細については、Diligent One アクセス トークンの作成と管理を参照してください。