Diligent One における 結果 アプリへの例外のエクスポート

概念情報

EXPORT コマンド

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

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

セキュリティ要件

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

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

    メモ

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

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

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

エクスポートの制限事項

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

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

メモ

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

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

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

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

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

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

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

メモ

アンケート フィールドの末尾にデータを追加するときには、結果 で表示名を変更した場合でも、リザルトの列の表示名は、アンケート構成で指定された名前のままです。

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

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

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

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

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

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

メモ

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

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

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

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

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

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

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

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

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

      ヒント

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

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

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

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

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

      メモ

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

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

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

    • 結果 テーブルを置換（上書き）する

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

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

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

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

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

     フィールドのエクスポートビューのエクスポート
    ［フィールド表示名を含める］を選択した場合結果 のフィールド名が、リザルトのフィールド名になります。結果 の表示名が、リザルトの表示名になります。
    ［フィールド表示名を含める］を選択解除した場合結果 のフィールド名が、リザルトのフィールド名と表示名になります。

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

    メモ

    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 番号とデータ センター コードが設定されています。

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

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

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

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

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

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

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

    メモ

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

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

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

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

パスワード要件

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

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

パスワードが必要です

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

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