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

Concept Information

IMPORT GRCRESULTS コマンド

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

メモ

リザルトでは、統制テストは「データ アナリティクス」と言います。

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

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

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

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

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

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

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

レコード長の制限

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

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

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

手順

メモ

Diligent One に接続するときには、パスワードを指定することが必要な場合があります。詳細については、パスワード要件を参照してください。

  1. ［インポート］> ［HighBond］> ［リザルト］を選択します。HighBond
  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 からインポートし、ロボットでスクリプトを実行した場合

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

HighBond アクセストークンを取得

注意

アカウントパスワードのようにアクセストークンを保護してください。Diligent One アカウント固有の情報が含まれます。アクセストークンを共有しないでください。

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

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

    • Analytics メインメニューで［ツール］ > ［HighBond アクセストークン］を選択します。HighBond Access Token

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

    ［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 で、トークンが含まれているダイアログボックスまたはサイド パネルを閉じます。

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

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