Diligent One リザルトのデータをインポートする

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

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

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

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

If you are round-tripping data between リザルト and Analytics, you need to ensure that all field names in the リザルト table meet the more stringent Analytics field name requirements.If you do not, you risk misaligning your Analytics and リザルト data.

For example, any special characters in リザルト field names are automatically converted to underscores when they are imported into Analytics, which means the field names no longer match the original names in リザルト.If you then export the Analytics data back to the original table in リザルト, fields are no longer correctly matched.

To avoid this problem with data that you intend to round-trip, make sure that before you upload the data to リザルト from CSV or Excel files it meets these Analytics field name requirements:

• no special characters or spaces
• does not start with a number
• contains only alphanumeric characters, or the underscore character ( _ )

レコード長の制限

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 を含まない）に制限されます。名前にはアンダースコア文字（_）を使用できますが、他の特殊文字やスペースは使用できません。名前の先頭を数字にすることはできません。

パスワード要件

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

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