EXPORT コマンド

Concept Information

データのエクスポート

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

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

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

メモ

EXPORT コマンドで古い Excel ファイル (*.xls) や Microsoft Access ファイル (*.mdb) を扱うには、32 ビット Microsoft Access データベースエンジンがインストールされている必要があります詳細については、Microsoft Access データベースエンジンを除外するオプションを参照してください。

構文

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 フィールド名

省略可能

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) によってサポートされていない場合
  • エクスポートしているデータのすべての文字が拡張 ASCII (ANSI) によってサポートされている場合は、Unicode を指定しないでください

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

    メモ

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

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

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

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

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

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

  • ACLGRC – Diligent One リザルトDiligent OneResults
  • ASCII – ASCII プレーンテキスト (*.txt)
  • CLIPBOARD – Windows クリップボード
  • DBASE – dBASE 互換ファイル (*.dbf)
  • DELIMITED – 区切り文字付きテキストファイル (.del)、またはカンマ区切り値ファイル（.csv）
  • EXCEL – Microsoft Excel 1997 ～ 2003 と互換性のある Excel ファイル (*.xls)
  • HBDATA – Diligent One ロボット アプリの HighBond ロボットまたはワークフローロボットに対して圧縮されたカンマ区切り値ファイル (*.csv.gz)HighBond robotWorkflow robotDiligent OneRobots
  • 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 の直前またはコマンド構文の文字列の最後に配置する必要があります。

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

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

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

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

PASSWORD 番号は不要です。

Windows レジストリに保管されている現在のユーザーの HighBond アクセストークンが自動的に使用されます
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 条件を使って、各レコードの業者名をテストします。

GROUP
  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"

リザルト アプリの例

Diligent One のリザルト アプリへのデータのエクスポート

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

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 パラメーターは、タスクに保存され暗号化されたパスワード値を参照します。必須のパスワードは有効な HighBond アクセストークンです。詳細については、パスワード定義の作成とパスワード値の指定を参照してください。

COMMENT
//Analytics データのリザルトへのエクスポート
//PASSWORD 1 HighBond アクセストークン
//RESULT LOG
END

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

ロボット アプリの例

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

メモ

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

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

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

Diligent One ロボットで Trans_May テーブルから特定のフィールドを、圧縮した 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 パラメーターは、タスクに保存され暗号化されたパスワード値を参照します。必須のパスワードは有効な HighBond アクセストークンです。詳細については、パスワード定義の作成とパスワード値の指定を参照してください。

COMMENT
//ロボットへの分析エクスポート Analytics データ
//PASSWORD 1 HighBond アクセストークン
//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

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

Diligent One ロボットで Trans_May テーブルすべてのフィールドを圧縮した CSV ファイル (*.csv.gz) にエクスポートします。Diligent OneRobots

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 を指定し、除外するフィールドを指定する

Diligent One ロボットで Vendor テーブルから最終有効日およびレビュー日フィールドを除くすべてのフィールドを圧縮された CSV ファイル (*.csv.gz) にエクスポートします。Diligent OneRobots

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 テーブルでもエクスポートは行えますが、上限を超えた分のレコードは無視されエクスポートされません。
フィールドの長さ
  • 特定のフィールド長上限なし
  • フィールド長の合計が、レコード全体の長さ上限である 32 KB

    （非 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 システム管理者およびリザルト管理者は、Diligent One 組織、または管理する組織のすべてのコレクションで自動的にProfessional 部門長のロールを取得します。

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

エクスポートの制限事項

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

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

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

フィールドの追加

(OVERWRITE 指定なし)

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

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

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

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

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

メモ

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

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

パスワード要件

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

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

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

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

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

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

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

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

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

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

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

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

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

パスワード定義方法

方法 説明

PASSWORD アナリティクス タグ

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

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

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

PASSWORD コマンド

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

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

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

SET PASSWORD コマンド

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

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

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

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

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

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

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

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

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

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