Diligent One 結果データのインポート

Analytics テーブルを作成するには、Diligent One リザルトで操作する権限があるコレクションからデータをインポートします。コレクションの個別の統制テストからデータテーブルまたは解釈をインポートできます。

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

リザルトからデータを 結果 にインポートする機能により、例外に対して二次的またはフォローアップ分析を実行できます。分析を実行した後、往復処理でデータをリザルトにエクスポートできます。詳細については、 Diligent One における 結果 アプリへの例外のエクスポートを参照してください。

リザルト データを往復するときのフィールド名の考慮事項

リザルトと 結果 間でデータを往復する場合は、リザルト テーブルのすべてのフィールド名がより厳しい Analytics フィールド名要件を満たすことを確認する必要があります。そうでない場合、Analytics とリザルト データが一致しないおそれがあります。

たとえば、リザルト フィールド名の特殊文字は、 結果 にインポートされるときに自動的にアンダースコアに変換されます。これは、フィールド名がリザルトの元の名前と一致しないことを意味します。後から Analytics データをリザルトの元のテーブルにエクスポートする場合は、フィールドが正しく一致しません。

往復するデータでこの問題を回避するには、CSV または Excel ファイルからリザルトにデータをアップロードする前に、以下の 結果 フィールド名要件を満たしていることを確認します。

• 特殊文字またはスペースがない
• 数字で始まらない
• 英数文字またはアンダースコア文字（ _ ）のみを含む

レコード長の制限

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

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

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

手順

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

   メモ

   次の場合にデータにアクセスするために必要な権限がありません。

   • 統制テストを含むコレクションが表示されません
   • 制御テストにアクセスしようとすると、［解釈のリストの取得エラー］というメッセージが表示されます。

   詳細については、 結果 での権限とロールの割り当てを参照してください。

   アクセス許可の支援が必要な場合は、社内の Diligent One アカウント管理者、またはリザルトの管理者にお問い合わせください。

4. Analytics にインポートする次のテーブルのいずれかを選択します。
   • 解釈（存在する場合）
   • 監査証跡
   • コメント
   • 結果テーブル（テーブル フィールド選択フォルダーをダブルクリック）

   メモ

   一度に Analytics にインポートできるテーブルは 1 つだけです。

   ヒント

   レコード ID をキー フィールドとして、Analytics で結果テーブル、監査証跡、コメントを結合できます。結合で主テーブルとして結果テーブルを使用します。

5. 結果テーブルをインポートする場合、次のカテゴリからインポートする個別のフィールドを選択します。
   • メタデータユーザーが生成し、システムが生成したワークフロー情報を含むフィールド
   • その他のコレクションとコントロールのテスト名、およびレコード ID

     Analytics で結果テーブルを結合する場合は、必ずレコード ID を選択します。

   • データフィールド：結果 にインポートされたデータまたは 結果 アンケートの回答を含んでいる
   • すべて選択テーブル全体をインポートします
6. ［OK］をクリックします。

   データは 結果 からインポートされます。

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

   メモ

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

パスワード要件

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

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

パスワードが必要です

次のどちらの状況でも、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 のパスワードを入力し、［確認］をクリックします。

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

     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 アクセス トークンの作成と管理を参照してください。