Diligent One のリザルト アプリへの例外のエクスポート

コンセプト情報

EXPORT コマンド

Diligent One を使用している場合は、Analytics テーブルの例外データをリザルトのテーブルにエクスポートすることができます。例外をエクスポートするには、Analytics からデータをエクスポートする標準的な手順を使用できますが、異なる点が若干あります。

リザルトは、改善およびワークフローを自動化するアプリであり、例外データの管理、およびアンケートによる人間の背景の追加を行い、監視をトリガーとメトリクスで継続します。詳細については、リザルトでのデータの操作を参照してください。

セキュリティ要件

リザルトの統制テストへ例外データをエクスポートする機能は、特定の Diligent One のロールの割り当て、または管理者特権を必要とします。

  • リザルトコレクションの Professional ユーザーまたは Professional 部門長のロールを担うユーザーは、そのコレクション内のあらゆる統制テストに結果をエクスポートすることができます。

    メモ

    Professional 部門長のロールのユーザーのみが統制テストの既存のデータをエクスポートおよび上書きできます。

  • Diligent One アカウント管理者およびリザルト管理者は、管理している Diligent One インスタンス内のすべてのコレクションにおいて、自動的に Professional 部門長のロールを取得します。

詳細については、リザルト アプリアクセス許可を参照してください。

エクスポートの制限事項

例外データをリザルト内の統制テストにエクスポートする際の制限事項を下に示します。

これらの制限内では、同じ統制テストに複数回エクスポートできます。統制テストにすでにデータが存在する場合は、それを上書きする、または新しいデータを追加するオプションがあります。

メモ

統制テストに最大 100,000 レコードエクスポートできますが、より小さく、より明確な例外セットを作成する方がよいでしょう。

項目 最大
エクスポートあたりのレコード数 100,000
統制テストあたりのレコード数 100,000
レコードあたりのフィールド数 500
フィールドあたりの文字数 256

Analytics とリザルトとの間でフィールドを一致させる

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 で表示名を変更した場合でも、リザルトの列の表示名は、アンケート構成で指定された名前のままです。

上書きオプションとリザルト主キー

Analytics から既存のリザルト テーブルに例外データをエクスポートするときには、エクスポートされたデータをテーブルの最後に追加するか、テーブルを完全に上書きするオプションがあります。

リザルト テーブルのフィールドが主キーに指定されていて、エクスポートしているデータに対応するフィールドが含まれている場合は、エクスポート処理の動作が少し異なります。（リザルトでの主キーの指定の詳細については、主キーの指定を参照してください。）

次の表は、さまざまな可能性をまとめたものです。

  リザルトに主キーがない リザルトにおける主キー
［上書き］オプションが選択されていない エクスポートされたデータは既存のリザルト テーブルの最後に追加されます
  • 一致する値 リザルトの主キー フィールドと対応するフィールドが Analytics からエクスポートされたフィールドに、一致する値が存在するResults場合、リザルトのレコードはエクスポートされたレコードに存在する値で更新されます。
  • 一致する値がない リザルトの主キー フィールドと対応するフィールドが Analytics からエクスポートされたフィールドに、一致する値が存在しに場合、リザルトのResultsレコードは更新されず、エクスポートされたレコードはテーブルの最後に追加されます。
［上書き］オプションが選択されている エクスポートされたデータは既存のリザルト テーブルを置換（上書き）します エクスポートされたデータは既存のリザルト テーブルを置換（上書き）します

リザルトへの例外のエクスポート

メモ

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

エクスポートするフィールドを指定する

  1. エクスポートする例外データが格納されたテーブルを開きます。
  2. ［データ > エクスポート］を選択します。
  3. ［メイン］タブで、次のいずれかを選択します。
    • フィールド エクスポートするフィールドを指定します

      このオプションを選択すると、テーブル レイアウトの物理フィールド名を使用して、フィールドがエクスポートされます。

      フィールドの名前変更の詳細については、テーブル レイアウトのフィールドの名前を変更するを参照してください。

    • ビュー 現在のビューのすべてフィールドをエクスポートします

      オプションを選択すると、列表示名を使用して、フィールドがエクスポートされます。フィールドは、ビューに現れる順序と同じ並びでエクスポートされます。

      列の名前変更の詳細については、ビュー内の列名の変更を参照してください。

  4. ［フィールド］を選択した場合は、次のいずれかを行います。
    • ［エクスポートフィールド］リストからエクスポートするフィールドを選択します。

      ヒント

      隣接する複数のフィールドを選択するには、Shift キー + クリックを、隣接していない複数のフィールドを選択するには、Ctrl キー + クリックを利用できます。

    • ［エクスポートフィールド］をクリックして、フィールドを選択するか、または式を作成します。

エクスポート オプションを選択する

  1. ［エクスポート形式］ドロップダウンリストから［Diligent One］をクリックします。
  2. 次のいずれかを実行します。
    • リザルトテーブルの最後に追加する

      エクスポートされたデータをリザルトの既存のテーブルの最後に追加する場合は、［上書き］をオフにします。

      メモ

      既存のリザルトフィールドに Analytics フィールドを追加できるのは、両者間で一致する物理フィールド名がある場合に限ります。各アプリケーション内でのフィールドの表示名は問いません。Analytics では、物理フィールド名はテーブル レイアウトの名前です。

      2 つのアプリケーションにおけるフィールドの順序はフィールド名一致に影響しません。

      リザルトテーブルのフィールドの物理名と一致しない物理名があるエクスポートされたフィールドは、テーブルに新しい列を作成します。

    • リザルト テーブルを置換（上書き）する

      リザルトで既存のテーブルを置換する場合は、［上書き］を選択します。

    詳細については、上書きオプションとリザルト主キーを参照してください。

  3. （任意）列の表示名をリザルトにエクスポートするには、［フィールド表示名を含める］を選択します。

    このオプションを選択すると、リザルトで、列の表示名と物理名が、Analytics の名前と同じになります。

    ［フィールド表示名を含める］を選択しない場合、結果は、フィールドまたはビューのどちらでエクスポートしているのかによって異なります。

     フィールドのエクスポートビューのエクスポート
    フィールド表示名を含めるが選択リザルトのフィールド名は Analytics のフィールド名です。Analytics の表示名が、リザルトの表示名になります。
    フィールド表示名を含めるが選択されていないAnalytics の表示名が、リザルトのフィールド名になります。

    Analytics の表示名が、リザルトのフィールド名と表示名になります。

    メモ

    Analytics のバージョン 14.1 より前からビューをエクスポートする方法で最初に作成されたリザルトテーブルの最後にビューを追加する場合は、［フィールド表示名を含める］を選択しないでください。このようにすると、リザルトの名前と異なるフィールド名の列がエクスポートされる可能性があります。この場合、リザルトで新しい列が作成され、アプリケーション間でデータの整合性がとれなくなります。

エクスポートの最終処理

  1. 現在のビューの中に処理から除外したいレコードがある場合は、［If］テキスト ボックスに条件を指定します。直接入力するか、または［If］ボタンをクリックし、式ビルダーを利用して IF ステートメントを作成します。

    メモ

    If 条件は、任意の範囲オプション（先頭、次へ、While）が適用された後に、テーブルに残るレコードに対してのみ評価されます。

    IF ステートメントは、ビュー内のすべてのレコードを判断し、指定された条件を満たさないレコードを除外します。

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

    エクスポート先テーブルの ID 番号がわかっている場合：

    To テキストボックスに ID 番号を入力します。

    • 番号を入力します。引用符は付けないでください。たとえば、99 のように入力します。
    • 数字のみを入力します。ファイル名を入力してはいけません。
    • 北米（米国）以外のデータセンターにエクスポートする場合は、データセンターコードも指定する必要があります。統制テストの ID 番号とデータセンターコードは、アットマーク（@）で区切る必要があります。たとえば、99@eu と指定します。データセンターコードは、どの地域の Diligent One サーバーにデータをエクスポートするのかを指定します。

      • af – アフリカ（南アフリカ）
      • ap – アジア太平洋（シンガポール）
      • au – アジア太平洋（オーストラリア）
      • ca – 北米（カナダ）
      • eu – ヨーロッパ（ドイツ）
      • jp – アジア太平洋（東京）
      • sa – 南米（ブラジル）
      • us – 北米（米国）

      組織の Diligent One インスタンスに対して承認されているデータセンターコードのみを使用できます。北米のデータセンターがデフォルトであるため、@us を指定するのはオプションです。

    エクスポート先テーブルの ID 番号がわかっていない場合または新しいテーブルを作成する場合：

    1. To を選択し、［宛先テストを選択］ダイアログボックスで該当する分析フォルダーに移動します。
    2. 次のいずれかを実行します。
      • 既存のテーブルを選択し、［OK］をクリックします。
      • ［新しいデータ アナリティクス］フィールドに名前を入力し、［作成］をクリックします。

      ［エクスポート］ダイアログボックスに戻ります。統制テスト ID 番号とデータセンターコードは ［To］テキストボックスに事前に入力されます。

  3. ［詳細］タブをクリックします。

  4. ［適用範囲］パネルで、適切なオプションを選択します。

    • すべて
    • 先頭
    • 次へ
    • While
    適用範囲オプション 詳細
    すべて (デフォルト) ビュー内のすべてのレコードを処理することを指定します。
    先頭 テキストボックスに数を入力します。ビュー内の先頭レコードから処理が開始され、指定した件数のレコードのみが処理対象とされます。
    次へ テキストボックスに数を入力します。ビュー内の現在選択したレコードから処理が開始され、指定した件数のレコードのみが処理対象とされます。行内のデータではなく、ビュー内の左端列で実際のレコード番号が選択されている必要があります。
    While

    WHILE ステートメントを使用して、特定の条件または条件のセットに基づいてビュー内のレコードの処理を制限します。

    ［While］テキストボックスに条件を入力するか、または［While］ボタンをクリックし、式ビルダーを利用して WHILE ステートメントを作成します。

    WHILE ステートメントでは、指定した条件が true と評価される間のみ、ビュー内のレコードを処理することができます。条件が false と評価されるとすぐに処理が終了し、それ以上レコードは判断されません。

    While オプションは、"すべて"、"先頭"、または "次" オプションと組み合わせて使用することができます。1 つの制限に達するとすぐに、レコードの処理が停止します。

    メモ

    ［先頭］または［次］オプションは、テーブル内のレコードの物理的な順序またはインデックス付けされた順序のいずれかを参照します。［先頭］または［次］では、テーブル ビューに適用されたフィルタリングまたはクイック ソートは無視されます。ただし、分析操作の出力結果ではすべてのフィルターを考慮します。

    ビューでクイック ソートが実行されている場合、"次" は "先頭" のように動作します。

  5. ［OK］をクリックします。

    例外データがリザルトへエクスポートされる間は進捗インジケーターが表示されます。エクスポートの操作が完了すると、そのエントリがログに記録されます。

パスワード要件

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

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

パスワードが必要

次のどちらの状況でも、リザルトにエクスポートするためにパスワードを指定する必要があります。

  • オフラインアクティベーションを使用して 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 アクセス トークンの作成と管理を参照してください。