EXPORT コマンド

概念情報

データのエクスポート

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

ロボット アプリへのデータのエクスポートDiligent One

指定されたファイル形式に、または Analytics 内のリザルト アプリまたはロボット アプリに、結果 からデータをエクスポートします。

メモ

EXPORT コマンドで古い Excel ファイル (*.xls) や Microsoft Access ファイル (*.mdb) を扱うには、Microsoft 365 Access Runtime (32-bit) がインストールされている必要があります。詳細については、「以前の Excel (*.xls) または Access ファイル (*.mdb) の操作」を参照してください。

構文

EXPORT {<FIELDS> フィールド名 <AS エクスポート名> <...n>|<FIELDS> ALL <EXCLUDE フィールド名 <...n>>} <UNICODE> エクスポート形式 <SCHEMA> <PASSWORD番号> TO {ファイル名|aclgrc_id|highbond_api_url} <OVERWRITE> <IF テスト> <WHILE テスト> <{FIRST 範囲|NEXT 範囲}> <APPEND> <KEEPTITLE> <SEPARATOR 文字> <QUALIFIER 文字> <WORKSHEET ワークシート名> <DISPLAYNAME>

パラメーター

名前 説明
FIELDS フィールド名 AS エクスポート名 <...n> | FIELDS ALL

エクスポートするフィールド。

  • FIELDS フィールド名指定されたフィールドをエクスポートします。

    範囲をフィールド名で分けます。フィールドは一覧の順序でエクスポートされます。

    任意で "AS エクスポート名" を使って、エクスポート ファイル内のフィールドとは異なる名前を追加することもできます。エクスポート名は引用符で囲みます。

    Diligent One 結果 ( ACLGRC ) へのエクスポートを行う場合は、AS と DISPLAYNAME パラメーターを組み合わせることもできます。詳細については、「Diligent One のリザルトにエクスポートを行う際の DISPLAYNAME と AS の相互作用」を参照してください。

  • FIELDS ALLテーブルのすべてのフィールドをエクスポートします

    フィールドは、テーブル レイアウトに現れる順序と同じ並びでエクスポートされます。
EXCLUDE field_name

任意

FIELDS ALL を使用してエクスポートするときにのみ有効です。

コマンドから除外するフィールド。EXCLUDE では、指定したフィールドを除外して、ALL キーワードを微調整できます。

EXCLUDE は、FIELDS ALL の直後、または 1 つ以上の関連テーブルのフィールドを含める場合は ALL キーワードの最後の出現の直後に続く必要があります。例：

FIELDS ALL EXCLUDE field_1 field_2
FIELDS ALL 関連テーブル名.ALL EXCLUDE field_1 field_2

UNICODE

任意

Analytics の Unicode 版でのみ利用可能です。テキストファイル、区切り文字付きテキストファイル、XML ファイル、Windows クリップボード出力にのみ適用されます。(ASCII、DELIMITED、XML、CLIPBOARD)

Unicode UTF-16 LE 文字エンコードが適用されている Analytics データをエクスポートします。

  • Unicode を指定エクスポートしているデータが拡張 ASCII (ANSI) によってサポートされていない場合
  • Unicode を指定しないエクスポートしているデータのすべての文字が拡張 ASCII (ANSI) によってサポートされている場合

    エクスポートされたデータは拡張 ASCII (ANSI) としてエンコードされます。

    メモ

    サポートされていない文字はエクスポートされたファイルから省略されます。

詳細については、 Diligent Unicode 製品を参照してください。
エクスポート形式

出力ファイル形式または宛先。

次のいずれかのオプションを指定します。

  • ACCESS – Microsoft Access データベース ファイル (*.mdb)

    デフォルトで、データは Unicode としてエクスポートされます。

  • ACLGRC – Diligent One 結果
  • ASCII – ASCII プレーン テキスト (*.txt)
  • CLIPBOARD – Windows クリップボード
  • DBASE dBASE 互換ファイル (*.dbf)
  • DELIMITED – 区切り文字付きテキスト ファイル (*.del)、またはカンマ区切り値ファイル (*.csv)
  • EXCEL – Excel 1997 ～ 2003 と互換性がある Microsoft Excel ファイル (*.xls)
  • HBDATA – Diligent Oneロボットアプリの HighBond ロボット または ワークフローロボット に対して圧縮されたカンマ区切り値ファイル (*.csv.gz)
  • JSON – JSON ファイル (*.json)
  • LOTUS – Lotus 123 ファイル
  • WDPF6 – Wordperfect 6 ファイル
  • WORD – MS Word ファイル (*.doc)
  • WP – Wordperfect ファイル
  • XLS21 – Microsoft Excel バージョン 2.1 のファイル (*.xls)
  • XLSX – Microsoft Excel ファイル (*.xlsx)

    デフォルトで、データは Unicode としてエクスポートされます。

  • XML – XML ファイル (*.xml)

SCHEMA

任意

XML ファイルへの出力のみに適用されます。(XML)

エクスポートされた XML ファイルに XML スキーマを含めます。XML スキーマには、フィールドのデータ型など、XML ファイルの構造を記述するメタデータが含まれています。

ファイルがエクスポートされたら、スキーマに対してファイルを検証することができます。

PASSWORD 番号

任意

Diligent One アプリにのみ適用されます。(ACLGRC、HBDATA)

使用するパスワード定義。

実際のパスワードを入力することを求めたり指定したりするのには、PASSWORD 番号の構文は使用しません。パスワード定義とは、以前に PASSWORD コマンドか SET PASSWORD コマンドを使用して入力または設定されたパスワードのことです。

番号はパスワード定義の番号です。たとえば、以前に 2 つのパスワードをスクリプトで設定したり入力したりしている場合、またはアナリティクス スクリプトをスケジュールしている場合、PASSWORD 2 により、2 番目のパスワードを使用することを指定します。

パスワードの入力または設定の詳細については、次を参照してください。

PASSWORD 番号 は、TO の直前またはコマンド構文の文字列の最後に配置する必要があります。

必須のパスワード値は、Diligent One アクセス トークン アクセス トークンです。詳細については、「パスワード定義の作成とパスワード値の指定」を参照してください。

PASSWORD 番号は必要な場合と不要な場合があります。スクリプトを実行する環境によって異なります。

スクリプトが実行される環境 PASSWORD 番号要件
Analytics

（オンライン アクティベーション）

PASSWORD 番号は不要です。

Windows レジストリに保管されている現在のユーザーの Diligent One アクセス トークン アクセス トークンが自動的に使用されます。
Analytics

（オフライン アクティベーション）

PASSWORD 番号は必要です。
ロボット
TO ファイル名

ファイルにエクスポートする場合にはファイルの名前。

必要に応じて、絶対ファイル パスまたは相対ファイル パスのいずれかを含めることができますが、その Windows フォルダーは既に存在している必要があります。ファイル名の値は引用符で囲まれた文字列として指定する必要があります。

メモ

カンマ区切り値ファイル (*.csv) にエクスポートするには、ファイル名の一部として .csv ファイル拡張子を指定する必要があります。例：vendors.csv

TO aclgrc_id

Diligent One リザルト アプリにエクスポートするにはリザルトの宛先。(ACLGRC)

aclgrc_id 値には、リザルトの統制テストの ID 番号が含まれている必要があるほか、北米（US）以外のデータ センターへエクスポートする場合には、そのデータセンターのコードも含まれている必要があります。aclgrc_id 値は引用符で囲む必要があります。

統制テスト ID 番号とデータセンターコードは、記号（@）で区切られる必要があります。たとえば、TO "99@eu"

統制テスト ID 番号がわからない場合は、Analytics のユーザーインターフェイスを使用して、リザルトへのエクスポートを開始します。統制テスト ID 番号を特定したら、エクスポートをキャンセルします。詳細については、「 Diligent One における 結果 アプリへの例外のエクスポート」を参照してください。

データセンターのコードは、どの地域の Diligent One サーバーにデータをエクスポートするのかを指定します。

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

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

TO highbond_api_url

Diligent One リザルト アプリにエクスポートするにはリザルトの宛先。(HBDATA)

メモ

ACL ロボット にはエクスポートできません。HighBond ロボット ロボットまたはワークフローロボットにエクスポートする必要があります。

highbond_api_url 値は、宛先ロボットの HighBond API 要求 URL です。以下のエクスポート例では、*.csv.gz ファイルが次の宛先にエクスポートされます。

  • ID 番号 52053 のロボット

  • ID 番号 1000236 の Diligent One 組織

  • Diligent One 北米 (US) のデータセンター内

TO "https://apis-us.highbond.com/v1/orgs/1000236/robots/52053/working_files?env=development"

env クエリ文字列パラメーターを使用して、ファイルをロボットの開発モードにエクスポートするか本番モードにエクスポートするかを指定します。

開発モード

（デフォルト）

  • ?env=development

または

  • クエリ文字列を指定しない
本番モード

  • ?env=production

OVERWRITE

任意

Diligent One アプリにのみ適用されます。(ACLGRC、HBDATA)

  • OVERWRITE 指定対象統制テスト（テーブル）またはロボットのすべての既存のデータが、エクスポートされたデータによって上書きされます。データを上書きするには、ターゲット コレクションで、Professional 部門長 部門長ロールが必要です。

  • OVERWRITE 省略対象統制テスト（テーブル）のすべての既存のデータの最後に、エクスポートされたデータが追加されます。詳細については、「Diligent One のリザルトへのエクスポート」を参照してください。

    ロボットの *.csv.gz ファイルでは、この追加動作はサポートされていません。

対象とする統制テスト（テーブル）の解釈は、上書きか追加かには関係なく、インポートされたデータを反映するために動的に更新されます。
IF テスト

任意

各レコードを処理するために真である必要がある条件式。コマンドは、その条件を満たすレコードに対してのみ実行されます。

メモ

IF パラメーターは、任意の範囲パラメーター（WHILE、FIRST、NEXT）が適用された後に、テーブルに残るレコードに対してのみ評価されます。
WHILE テスト

任意

各レコードを処理するために真である必要がある条件式。条件が false と評価するか、テーブルの最後に達したら、コマンドは実行を中止します。

メモ

WHILE を FIRST または NEXT とともに使用する場合は、1 つの制限に達するとすぐに、レコードの処理が停止します。
FIRST 範囲 | NEXT 範囲

任意

処理するレコード数：

  • FIRST指定されたレコード数に達するまで、最初のレコードから処理を開始します
  • NEXT指定されたレコード数に達するまで、現在選択されているレコードから処理を開始します

範囲は処理するレコード数を指定します。

FIRST と NEXT を省略すると、すべてのレコードがデフォルトで処理されます。

APPEND

任意

テキストファイルと区切り文字付きテキストファイルのみに適用されます。(ASCII、DELIMITED)

コマンドの出力を既存ファイルに上書きしないで、そのファイルの末尾に追加します。

メモ

コマンドの出力と既存のファイルの構造が同一であるようにする必要があります。

  • 同じフィールド
  • 同じフィールド順序
  • 一致するフィールドが同じ長さ
  • 一致するフィールドが同じデータ型

出力は、既存ファイルとの間でファイル構造が違っている場合でも、Analytics によって既存ファイルに追加されます。出力と既存のファイルの構造が一致しない場合は、データが混在、不足、不正確になります。

KEEPTITLE

任意

テキストファイル、区切り文字付きテキストファイル、カンマ区切り値ファイルのみに適用されます(ASCII、DELIMITED)

Analytics フィールド名とエクスポートされたデータを含めます。省略された場合、フィールド名は出力ファイルに表示されません。

SEPARATOR 文字

任意

区切り文字付きテキストファイルとカンマ区切り値ファイルのみに適用されます。(DELIMITED)

フィールド間の区切りとして使用する文字。文字は引用符で囲まれた文字列として指定する必要があります。

デフォルトでは、カンマが使用されます。カンマ区切り値ファイルにエクスポートしている場合は、カンマ以外の文字を指定しないでください。

QUALIFIER 文字

任意

区切り文字付きテキストファイルとカンマ区切り値ファイルのみに適用されます。(DELIMITED)

フィールド値を折り返すためと識別するためにテキスト修飾子として使用する文字。文字は引用符で囲まれた文字列として指定する必要があります。

デフォルトでは、二重引用符が使用されます。

WORKSHEET ワークシート名

任意

Microsoft Excel *.xlsx ファイルのみに適用されます。(XLSX)

新規または既存の Excel ファイルに作成される Excel ワークシートの名前。最大 31 文字まで指定できます。

デフォルトでは、ワークシート名としてエクスポートする Analytics テーブルの名前が使用されます。31 文字以上の名称は切り捨てられます。

ワークシート名には、英数文字とアンダースコア文字 ( _ ) のみを含めることができます。名前に特殊文字や空白を使用したり、名前を数字で始めることはできません。値を引用符で囲むのは任意です。

エクスポートするときに Excel ワークブックとワークシートを上書きする詳細については、WORKSHEET パラメーターと上書きを参照してください。

DISPLAYNAME

任意

Diligent One リザルトにのみ適用されます。(ACLGRC)

フィールド名自体に影響を与えることなく表示名がリザルトの列見出しに表示されるように、フィールド名をフィールド名として、表示名を表示名としてエクスポートします。

DISPLAYNAME を AS と組み合わせて使用することもできます。詳細については「Diligent One のリザルトにエクスポートを行う際の DISPLAYNAME と AS の相互作用」を参照してください。

例

Excel の例

区切り文字付きファイルの例

カンマ区切り値 (CSV) ファイルの例

リザルト アプリの例

ロボット アプリの例

Excel の例

Excel .xlsx ファイルにデータをエクスポートします。

Vendor テーブル内の特定のフィールドを Excel *.xlsx ファイルにエクスポートするには、次のようにします。

OPEN Vendor
EXPORT FIELDS Vendor_No Vendor_Name Vendor_City XLSX TO "VendorExport"

ワークシート名を指定して、データを Excel .xlsx ファイルへエクスポートする

Vendor テーブル内の特定のフィールドを Excel *.xlsx ファイル内での Vendors_US というワークシートにエクスポートするには、次のようにします。

OPEN Vendor
EXPORT FIELDS Vendor_No Vendor_Name Vendor_City XLSX TO "VendorExport" WORKSHEET Vendors_US

区切り文字付きファイルの例

すべてのフィールドを区切りファイルにエクスポートする

Vendor テーブル内のフィールドを以下の 2 つの区切り文字付きテキスト ファイルにエクスポートします。

OPEN Vendor
EXPORT FIELDS ALL DELIMITED TO "VendorExport"

フィールドのサブセットを区切りファイルにエクスポートする

テーブルのフィールドのサブセットを外部ファイルにエクスポートする際には、2 つのオプションがあります。

  • エクスポートする個別のフィールドを指定する
  • FIELDS ALL を指定し、エクスポートから除外するフィールドを指定する

ヒント

最も作業が少ない方法を使用してください。

次の例は、8 つのフィールドがある Vendor テーブルを参照します。

  • ベンダー番号
  • 業者名
  • 業者番地
  • 業者市区郡
  • 業者都道府県
  • 業者郵便番号
  • 前回有効日
  • レビュー日

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

Vendor テーブル内のフィールドを以下のすべての区切り文字付きテキスト ファイルにエクスポートします。

OPEN Vendor
EXPORT FIELDS Vendor_No Vendor_Name DELIMITED TO "Vendors" KEEPTITLE SEPARATOR "|" QUALIFIER '"'

FIELDS ALL を指定し、除外するフィールドを指定する

Vendor テーブル内の前回有効日およびレビュー日フィールドを除くすべてのフィールドを、区切り文字付きファイルにエクスポートします。

OPEN Vendor
EXPORT FIELDS ALL EXCLUDE Vendor_Last_Active Vendor_Review_Date DELIMITED TO "Vendor_addresses" KEEPTITLE SEPARATOR "|" QUALIFIER '"'

GROUP を使用して、データを複数の区切り文字付きテキスト ファイルへエクスポートする

Vendor テーブル内の特定のフィールドを以下の 2 つの区切り文字付きテキスト ファイルにエクスポートします。

  • "A" から "M" の業者名の 1 つのファイル
  • "N" から "Z" の業者名の 1 つのファイル

GROUP コマンドと IF 条件を使って、各レコードの業者名をテストします。

グループ
  EXPORT FIELDS Vendor_No Vendor_Name DELIMITED TO "AtoM" IF BETWEEN(UPPER(VENDOR_NAME), "A", "M")
  EXPORT FIELDS Vendor_No Vendor_Name DELIMITED TO "NtoZ" IF BETWEEN(UPPER(VENDOR_NAME), "N", "Z")
END

カンマ区切り値 (CSV) ファイルの例

すべてのフィールドをカンマ区切り値ファイルにエクスポート

Vendor テーブル内のフィールドをカンマ区切り値ファイルにエクスポートします。

OPEN Vendor
EXPORT FIELDS ALL DELIMITED TO "VendorExport"

リザルト アプリの例

結果 のロボット アプリへのデータのエクスポート

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

AR_Exceptions テーブル内の特定のフィールドを Diligent One リザルトにエクスポートするとします。対象統制テスト（テーブル）内の既存のデータを上書きします。

OPEN AR_Exceptions
EXPORT FIELDS No Due Date Ref Amount Type ACLGRC TO "10926@us" OVERWRITE

ロボットでコマンドを実行するために必要なパスワード定義を作成します

EXPORT コマンドで PASSWORD Analytics タグとそれに対応する PASSWORD パラメーターの 2 つの部分からなるパスワード定義を作成します。

//PASSWORD 1 Analytics タグは、ロボットのタスクのパスワード入力パラメーターを作成します。EXPORT コマンドの一致する PASSWORD 1 パラメーターは、タスクに保存され暗号化されたパスワード値を参照します。必須のパスワードは、有効な Diligent One アクセス トークン アクセス トークンです。詳細については、「パスワード定義の作成とパスワード値の指定」を参照してください。

コメント
//ANALYTIC データのリザルトへのエクスポート
//PASSWORD 1 Diligent One アクセス トークン アクセス トークン：
//RESULT LOG
END

OPEN AR_Exceptions
EXPORT FIELDS No Due Date Ref Amount Type ACLGRC PASSWORD 1 TO "10926@us" OVERWRITE

ロボット アプリの例

ロボット のロボット アプリへのデータのエクスポート

メモ

ACL ロボット にはエクスポートできません。HighBond ロボット ロボットまたは ワークフローロボット にエクスポートする必要があります。

ロボットにエクスポートした後のデータへのアクセス方法については、load_working_file() method を参照してください

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

Trans_May テーブル内の特定のフィールドを Diligent One ロボット の圧縮された CSV ファイル (*.csv.gz) にエクスポートするとします。開発モードで、ロボット 52053 に同じ名前のファイルが存在している場合、上書きされます。

OPEN Trans_May
EXPORT FIELDS CARDNUM AS 'CARDNUM' CODES AS 'CODES' DATE AS 'DATE' CUSTNO AS 'CUSTNO' DESCRIPTION AS 'DESCRIPTION' AMOUNT AS 'AMOUNT' HBDATA TO "https://apis-us.highbond.com/v1/orgs/1000236/robots/52053/working_files?env=development" OVERWRITE

ロボット でコマンドを実行するために必要なパスワード定義を作成します

EXPORT コマンドで PASSWORD Analytics タグとそれに対応する PASSWORD パラメーターの 2 つの部分からなるパスワード定義を作成します。

//PASSWORD 1 Analytics タグは、ロボットのタスクのパスワード入力パラメーターを作成します。EXPORT コマンドの一致する PASSWORD 1 パラメーターは、タスクに保存され暗号化されたパスワード値を参照します。必須のパスワードは、有効な Diligent One アクセス トークン アクセス トークンです。詳細については、「パスワード定義の作成とパスワード値の指定」を参照してください。

コメント
//ANALYTIC ロボットへの分析データのエクスポート
//PASSWORD 1 Diligent One アクセス トークン アクセス トークン：
//RESULT LOG
END

OPEN Trans_May
EXPORT FIELDS CARDNUM AS 'CARDNUM' CODES AS 'CODES' DATE AS 'DATE' CUSTNO AS 'CUSTNO' DESCRIPTION AS 'DESCRIPTION' AMOUNT AS 'AMOUNT' HBDATA PASSWORD 1 TO "https://apis-us.highbond.com/v1/orgs/1000236/robots/52053/working_files?env=development" OVERWRITE

すべてのフィールドをエクスポート

Trans_May テーブルのすべてのフィールドを Diligent One ロボット の圧縮された *.csv ファイル (*.csv.gz) にエクスポートするには、次のようにします。

OPEN Trans_May
EXPORT FIELDS ALL HBDATA PASSWORD 3 TO "https://apis-us.highbond.com/v1/orgs/1000236/robots/52053/working_files?env=development" OVERWRITE

FIELDS ALL を指定し、除外するフィールドを指定する

Vendor テーブル内の前回有効日およびレビュー日フィールドを除くすべてのフィールドを、Diligent One ロボット の圧縮された *.csv ファイル (*.csv.gz) にエクスポートするには、次のようにします。

OPEN Vendor
EXPORT FIELDS ALL EXCLUDE Vendor_Last_Active Vendor_Review_Date HBDATA PASSWORD 3 TO "https://apis-us.highbond.com/v1/orgs/1000236/robots/52053/working_files?env=development" OVERWRITE

備考

EXPORT と GROUP コマンドの使用

ほとんどのエクスポート形式は、GROUP コマンドを使ってデータを複数ファイルへ同時にエクスポートすることができます。

Microsoft Excel および Microsoft Access にデータをエクスポートする場合は、同時に 1 つのファイルのみ作成することができます。

Excel へのエクスポート

データを Excel ファイルにエクスポートするときには、以下の制限事項があります。

制限 詳細
レコード数
  • Excel 2007 以降 (*.xlsx)16,384 フィールドで最大 1,048,576 レコード（Excel がサポートする最大ワークシート サイズ）
  • Excel 97 および 2003最大 65,536 レコード

この最大件数を超える Analytics テーブルでもエクスポートは行えますが、上限を超えた分のレコードは無視されエクスポートされません。
フィールドの長さ
  • 特定のフィールド長上限なし
  • 結合フィールドの長さは、レコード全長の制限である 32KB を超えることはできない

    （非 Unicode Analytics では 32,765 文字、Unicode Analytics では 16,382 文字）

  • Excel 2.1 の場合は、最大 247 文字
フィールド名の長さ
  • 最大 64 文字
  • Excel 2.1 の場合は、最大 248 文字
ワークシート名の長さ
  • 最大 31 文字

Analytics テーブル名は、ワークシート名として使用する場合には、31 文字を超えていると Excel へのエクスポート時に切り捨てられます。

WORKSHEET パラメーターと上書き

Analytics テーブルから Excel ファイルにエクスポートするときに WORKSHEET コマンドを使用する場合としない場合の結果は、以下で説明します。

一致

説明

 使用される WORKSHEET パラメーター 使用されない WORKSHEET パラメーター
一致する Excel ファイル名がない
  • TO に指定されたファイル名の値が既存のどの Excel ファイルの名前とも一致しない
 指定された名前のワークシートで新しい Excel ファイルが作成される エクスポートされた Analytics テーブルの名前を使用するワークシートで、新しい Excel ファイルが作成される

一致する Excel ファイル名がある

一致するワークシート名がある
  • TO に指定されたファイル名の値と既存の Excel ファイルの名前が一致する
  • WORKSHEET に指定されたワークシート名が Excel ファイルのワークシート名と一致しない
 指定された名前のワークシートが既存の Excel ファイルに追加される エクスポートされた Analytics テーブルの名前を使用するワークシートで、既存の Excel ファイルが新しい Excel ファイルによって上書きされる
Excel ファイル名とワークシート名が一致する
  • TO に指定されたファイル名の値と既存の Excel ファイルの名前が一致する
  • WORKSHEET に指定されたワークシート名が Excel ファイルのワークシート名と一致する

最初に Analytics から作成された場合は、指定された名前のワークシートが既存のワークシートを上書きします。

既存のワークシートが最初に直接 Excel で作成された場合は、エラーメッセージが表示され、エクスポート処理がキャンセルされます。

 エクスポートされた Analytics テーブルの名前を使用するワークシートで、既存の Excel ファイルが新しい Excel ファイルによって上書きされる

Diligent One のリザルトへのエクスポート

以下の表では、リザルトで統制テストにエクスポートする方法の詳細について説明しています。

アイテム

詳細

必要なアクセス許可

結果 の統制テストへ結果をエクスポートする機能は、特定の Diligent One の役割の割り当て、または管理者特権を必要とします。

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

    メモ

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

  • Diligent One システム管理者およびリザルト管理者は、システム管理者 組織、または管理する組織のすべてのコレクションで自動的にプロフェッショナル部門長の役割を取得します。

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

エクスポートの制限事項

統制テストにエクスポートする際、次の制限が適用されます。

  • エクスポートごとに最大 100,000 レコード
  • 統制テストごとに最大 100,000 レコード
  • レコードごとに最大 500 フィールド
  • フィールドごとに最大 256 文字

同じ統制テストへは、複数回～全体の上限回数までエクスポートを行うことができます。

フィールドの追加

(OVERWRITE 指定なし)

既存のフィールドと一致する物理フィールド名がある場合は、Analytics テーブル内の順序に関係なく、エクスポートされたフィールドは統制テストの既存のフィールドの最後に追加されます。

Analytics では、物理フィールド名はテーブル レイアウトの名前です。既存のフィールド名と一致しないエクスポートされたフィールドは 結果 のテーブルに新しい列として追加されます。

Analytics とリザルトのフィールドの表示名は、考慮されません。ただし、オプションの AS export_name パラメーターを使用する場合に、DISPLAYNAME を使用しないときは、export_name 値が物理フィールド名として使用されます。

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

対象統制テストの主キー フィールドが指定されている場合、最後に追加は異なる方法で動作します。詳細については、「 Diligent One における 結果 アプリへの例外のエクスポート」を参照してください。

メモ

リザルトと 結果 の間でデータを往復し、データがリザルトで不一致になる場合は、不一致のフィールド名がある可能性があります。

詳細については、「リザルト データをインポートおよびエクスポートするときのフィールド名の考慮事項」を参照してください。

パスワード要件

「パスワード定義の作成とパスワード値の指定」を参照してください。

Diligent One のリザルトにエクスポートを行う際の DISPLAYNAME と AS の相互作用

下記のマトリクスは、Analytics からリザルトにフィールド名をエクスポートする際の DISPLAYNAME パラメーターと AS の相互作用を示しています。

  AS を指定しない場合 AS を指定した場合
DISPLAYNAME を指定しない場合 結果 のフィールド名が、リザルトのフィールド名と表示名になります。 リザルトのフィールド名と表示名が、AS パラメーターの表示名になります。
DISPLAYNAME を指定した場合 結果 のフィールド名が、Analytics のフィールド名になります。結果 の表示名が、リザルトの表示名になります。 結果 のフィールド名が、Analytics のフィールド名になります。リザルトの表示名が、AS パラメーターの表示名になります。

Diligent One ロボットへのエクスポートに必要なアクセス許可

圧縮 CSV ファイル (*.csv.gz) を ロボット アプリにアップロードする機能には、特定のロボット ロールの割り当て、または管理者権限が必要です。

  • エディター または 所有者 を持つユーザーは、圧縮された CSV ファイルをロボットにアップロードできます。レビュー担当者 ロールを持つユーザーは、アップロードできません。

  • ロボット管理者 は自動的にすべてのロボットのコラボレーターになり、所有者 のロールを持ちます。

  • Professional サブスクリプションを持つ Diligent One システム管理者 システム管理者は、自動的に ロボット管理者 になります。

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

パスワード定義の作成とパスワード値の指定

ロボット でスクリプトを実行してデータを 結果 アプリにエクスポートするまたは圧縮された (*.csv.gz) ファイルを ロボット アプリにアップロードする場合、EXPORT コマンドとともにパスワード定義を含める必要があります。オフラインアクティベーションを使用する場合、同じ要件が Analytics で実行されるスクリプトに適用されます。

どの方法を用いてパスワード定義を作成したかにかかわらず、パスワードには値として Diligent One アクセス トークン アクセス トークンを指定する必要があります。このトークンは Launchpad で生成できます。詳細については、「Diligent One アクセス トークン アクセス トークンを取得する」を参照してください。

パスワード定義方法

方法 説明

PASSWORD アナリティクス タグ

（ロボットで実行するスクリプト用）

PASSWORD アナリティクスタグを使用して、Diligent One に接続するための番号付けされたパスワード定義を作成した場合、スクリプトでパスワードの値が指定されません。ロボットでスクリプトを実行するタスクを作成すると、タスクデザイナーの入力フィールドで実際のパスワードを指定できます。

詳細については、PASSWORD アナリティクスタグを参照してください。

PASSWORD コマンド

（Analytics で実行するスクリプトでは、オフラインアクティベーション）

PASSWORD コマンドを使用して、Diligent One に接続するための番号付けされたパスワード定義を作成した場合、スクリプトでパスワードの値が指定されません。スクリプトで接続しようとすると、パスワードプロンプトが表示されます。

詳細については、PASSWORD コマンドを参照してください。

SET PASSWORD コマンド

（Analytics で実行するスクリプトでは、オフラインアクティベーション）

SET PASSWORD コマンドを使用して、Diligent One に接続するための番号付けされたパスワード定義を作成した場合、スクリプトでパスワードの値が指定されるため、パスワードプロンプトは表示されません。この方法は自動実行用に作成されたスクリプトに適していますが、スクリプトに実際のパスワードがクリアテキストで表示されるため、この状況には適していません。

詳細については、SET PASSWORD コマンドを参照してください。

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. 使用しているパスワード定義方法に応じて次のいずれかを実行します。

    • PASSWORD アナリティクス タグACL ロボット のタスクデザイナーで、コピーしたトークンをパスワードパラメーターフィールドに貼り付けます。

    • PASSWORD コマンドAnalytics で、コピーしたトークンを、スクリプト実行中に表示されるパスワードの確認に貼り付けます。

    • SET PASSWORD コマンドAnalytics で、スクリプトの SET PASSWORD コマンド構文内の適切な位置にコピーしたトークンを貼り付けます。

  4. Launchpad で、トークンが含まれているダイアログボックスまたはサイド パネルを閉じます。

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

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