指定されたファイル形式に、または HighBond のリザルトに、Analytics からデータをエクスポートします。
構文
EXPORT {<FIELDS> フィールド名 <AS エクスポート名> <...n>|<FIELDS> ALL <EXCLUDE フィールド名 <...n>>} <UNICODE> エクスポート タイプ <SCHEMA> PASSWORD 数値 TO {ファイル名|aclgrc_id} <OVERWRITE> <IF テスト> <WHILE テスト> <{FIRST 範囲|NEXT 範囲}> <APPEND> <KEEPTITLE> <SEPARATOR 文字> <QUALIFIER 文字> <WORKSHEET ワークシート名> <DISPLAYNAME>
パラメーター
| 名前 | 説明 | |||||||
|---|---|---|---|---|---|---|---|---|
| FIELDS フィールド名 AS エクスポート名 <...n> | FIELDS ALL |
エクスポートするフィールド。
|
|||||||
| EXCLUDE フィールド名 省略可能 |
FIELDS ALL を使用してエクスポートするときにのみ有効です。 コマンドから除外するフィールド。EXCLUDE では、指定したフィールドを除外して、FIELDS ALL を微調整できます。 EXCLUDE はただちに FIELDS ALL に従う必要があります。例： FIELDS ALL EXCLUDE field_1 field_2 |
|||||||
|
UNICODE 省略可能 |
Analytics の Unicode 版でのみ利用可能です。テキスト (ASCII)、区切られたテキスト (DELIMITED)、および XML ファイルのみ、および Windows クリップボードCLIPBOARD) 出力に適用されます。 Unicode UTF-16 LE 文字エンコードが適用されている Analytics データをエクスポートします。
詳細については、Galvanize の Unicode 製品を参照してください。 |
|||||||
| エクスポート形式 |
以下のオプションのいずれかを使用して、ファイルの出力形式または宛先を指定します。
|
|||||||
| SCHEMA 省略可能 |
XML ファイルへの出力のみに適用されます。 エクスポートされた XML ファイルに XML スキーマを含めます。XML スキーマには、フィールドのデータ型など、XML ファイルの構造を記述するメタデータが含まれています。 ファイルがエクスポートされたら、スキーマに対してファイルを検証することができます。 |
|||||||
| PASSWORD 番号 |
HighBond のリザルト（ACLGRC）にのみ適用されます。 使用するパスワード定義。 実際のパスワードを入力することを求めたり指定したりするのには、PASSWORD 番号の構文は使用しません。パスワード定義とは、以前に PASSWORD コマンドか SET PASSWORD コマンドを使用して入力または設定されたパスワードのことです。 番号はパスワード定義の番号です。たとえば、以前に 2 つのパスワードをスクリプトで設定したり入力したりしている場合には、PASSWORD 2 により、2 番目のパスワードを使用することを指定するなどします。 パスワードの入力または設定の詳細については、次を参照してください。 PASSWORD 番号 は、TO の直前またはコマンド構文の文字列の最後に配置する必要があります。 必須のパスワード値は、HighBond アクセス トークンです。詳細については、HighBond のリザルトへのエクスポートを参照してください。 メモ PASSWORD は必要な場合と不要な場合があります。スクリプトを実行する環境によって異なります。
|
|||||||
| TO ファイル名 | ACL GRC ID |
エクスポート先：
|
|||||||
| OVERWRITE 省略可能 |
HighBond のリザルト（ACLGRC）にのみ適用されます。
対象とする統制テスト（テーブル）の解釈は、上書きか追加かには関係なく、インポートされたデータを反映するために動的に更新されます。 |
|||||||
| IF テスト 省略可能 |
各レコードを処理するために真である必要がある条件式。コマンドは、その条件を満たすレコードに対してのみ実行されます。 メモ IF パラメーターは、任意の範囲パラメーター（WHILE、FIRST、NEXT）が適用された後に、テーブルに残るレコードに対してのみ評価されます。 |
|||||||
| WHILE テスト 省略可能 |
各レコードを処理するために真である必要がある条件式。条件が false と評価するか、テーブルの最後に達したら、コマンドは実行を中止します。 メモ WHILE を FIRST または NEXT とともに使用する場合は、1 つの制限に達するとすぐに、レコードの処理が停止します。 |
|||||||
| FIRST 範囲 | NEXT 範囲 省略可能 |
処理するレコード数：
範囲は処理するレコード数を指定します。 FIRST と NEXT を省略すると、すべてのレコードがデフォルトで処理されます。 |
|||||||
| APPEND 省略可能 |
テキスト（ASCII）および区切り文字付きテキスト（DELIMITED）ファイルのみに適用されます。 コマンドの出力を既存ファイルに上書きしないで、そのファイルの末尾に追加します。 メモ コマンドの出力と既存のファイルの構造が同一であるようにする必要があります。
出力は、既存ファイルとの間でファイル構造が違っている場合でも、Analytics によって既存ファイルに追加されます。出力と既存のファイルの構造が一致しない場合は、データが混在、不足、不正確になります。 |
|||||||
| KEEPTITLE 省略可能 |
テキスト ファイル（ASCII）、区切り文字付きテキスト、カンマ区切り値ファイル（DELIMITED）にのみ適用されます。 Analytics フィールド名とエクスポートされたデータを含めます。省略された場合、フィールド名は出力ファイルに表示されません。 |
|||||||
|
SEPARATOR 文字 省略可能 |
区切り文字付きテキストおよびカンマ区切り値ファイル（DELIMITED）にのみ適用されます。 フィールド間の区切りとして使用する文字。文字は引用符で囲まれた文字列として指定する必要があります。 デフォルトでは、カンマが使用されます。カンマ区切り値ファイルにエクスポートしている場合は、カンマ以外の文字を指定しないでください。 |
|||||||
|
QUALIFIER 文字 省略可能 |
区切り文字付きテキストおよびカンマ区切り値ファイル（DELIMITED）にのみ適用されます。 フィールド値を折り返すためと識別するためにテキスト修飾子として使用する文字。文字は引用符で囲まれた文字列として指定する必要があります。 デフォルトでは、二重引用符が使用されます。 |
|||||||
|
WORKSHEET ワークシート名 省略可能 |
Microsoft Excel (.xlsx) ファイルにのみ適用されます。 新規または既存の Excel ファイルに作成される Excel ワークシートの名前。 デフォルトでは、ワークシート名としてエクスポートする Analytics テーブルの名前が使用されます。 ワークシート名には、英数文字とアンダースコア文字（ _ ）のみを含めることができます。名前に特殊文字や空白を使用したり、名前を数字で始めることはできません。値を引用符で囲むのは任意です。 エクスポートするときに Excel ワークブックとワークシートを上書きする詳細については、WORKSHEET パラメーターと上書きを参照してください。 |
|||||||
|
DISPLAYNAME 省略可能 |
HighBond のリザルト（ACLGRC）にのみ適用されます。 フィールド名自体に影響を与えることなく表示名がリザルトの列見出しに表示されるように、フィールド名をフィールド名として、表示名を表示名としてエクスポートします。 DISPLAYNAME を AS と組み合わせて使用することもできます。詳細については、HighBond のリザルトにエクスポートを行う際の DISPLAYNAME と AS の相互作用を参照してください。 |
例
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_No（ベンダー番号）
- 業者名
- 業者番地
- 業者市区郡
- 業者都道府県
- 業者郵便番号
- 前回有効日
- レビュー日
エクスポートするフィールドを指定する
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 '"'
すべてのフィールドをカンマ区切り値ファイルにエクスポート
Vendor テーブル内のフィールドをカンマ区切り値ファイルにエクスポートします。
OPEN Vendor EXPORT FIELDS ALL DELIMITED TO "VendorExport"
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
HighBond のリザルトへのデータのエクスポート
AR_Exceptions テーブル内の特定のフィールドを HighBond のリザルトにエクスポートするとします。対象統制テスト（テーブル）内の既存のデータを上書きします。
OPEN AR_Exceptions EXPORT FIELDS No Due Date Ref Amount Type ACLGRC PASSWORD 1 TO "10926@us" OVERWRITE
備考
このコマンドの動作の詳細については、データのエクスポートを参照してください。
EXPORT と GROUP コマンドの使用
ほとんどのエクスポート形式は、GROUP コマンドを使ってデータを複数ファイルへ同時にエクスポートすることができます。
Microsoft Excel および Microsoft Access にデータをエクスポートする場合は、同時に 1 つのファイルのみ作成することができます。
Excel へのエクスポート
データを Excel ファイルにエクスポートするときには、以下の制限事項があります。
| レコード数 |
この最大件数を超える Analytics テーブルでもエクスポートは行えますが、上限を超えた分のレコードは無視されエクスポートされません。 |
|---|---|
| フィールドの長さ |
|
| フィールド名の長さ |
|
WORKSHEET パラメーターと上書き
Analytics テーブルから Excel ファイルにエクスポートするときに WORKSHEET コマンドを使用する場合としない場合の結果は、以下で説明します。
| 一致 |
説明 |
使用される WORKSHEET パラメーター | 使用されない WORKSHEET パラメーター |
|---|---|---|---|
| 一致する Excel ファイル名がない |
|
指定された名前のワークシートで新しい Excel ファイルが作成される | エクスポートされた Analytics テーブルの名前を使用するワークシートで、新しい Excel ファイルが作成される |
|
一致する Excel ファイル名がある 一致するワークシート名がある |
|
指定された名前のワークシートが既存の Excel ファイルに追加される | エクスポートされた Analytics テーブルの名前を使用するワークシートで、既存の Excel ファイルが新しい Excel ファイルによって上書きされる |
| Excel ファイル名とワークシート名が一致する |
|
最初に Analytics から作成された場合は、指定された名前のワークシートが既存のワークシートを上書きします。 既存のワークシートが最初に直接 Excel で作成された場合は、エラー メッセージが表示され、エクスポート処理がキャンセルされます。 |
エクスポートされた Analytics テーブルの名前を使用するワークシートで、既存の Excel ファイルが新しい Excel ファイルによって上書きされる |
HighBond のリザルトへのエクスポート
以下の表では、リザルトで統制テストにエクスポートする方法の詳細について説明しています。
|
項目 |
詳細 |
|---|---|
|
必要なアクセス許可 |
リザルトの統制テストへ結果をエクスポートする機能は、特定の HighBond 役割の割り当て、または管理者特権を必要とします。
|
|
エクスポートの制限事項 |
統制テストにエクスポートする際、次の制限が適用されます。
同じ統制テストへは、複数回～全体の上限回数までエクスポートを行うことができます。 |
|
フィールドの追加 (OVERWRITE 指定なし) |
既存のフィールドと一致する物理フィールド名がある場合は、Analytics テーブル内の順序に関係なく、エクスポートされたフィールドは統制テストの既存のフィールドの最後に追加されます。 Analytics では、物理フィールド名はテーブル レイアウトの名前です。既存のフィールド名に一致しないエクスポートされるフィールドは、リザルトのテーブルに追加列として追加されます。 Analytics とリザルトのフィールドの表示名は、考慮されません。ただし、オプションの AS エクスポート名 パラメーターを使用する場合に、DISPLAYNAME を使用しないときは、エクスポート名 値が物理フィールド名として使用されます。 アンケート フィールドの末尾にデータを追加するときには、リザルトの列の表示名は、アンケート構成で指定された名前のままです。 対象統制テストの主キー フィールドが指定されている場合、最後に追加は異なる方法で動作します。詳細については、HighBond リザルトへの例外のエクスポートを参照してください。 メモ リザルトと Analytics の間でデータを往復し、データがリザルトで不一致になる場合は、不一致のフィールド名がある可能性があります。 詳細については、リザルト データをインポートおよびエクスポートするときのフィールド名の考慮事項を参照してください。 |
|
PASSWORD コマンド PASSWORD コマンドを使用して、HighBond に接続するための番号付けされたパスワード定義を作成した場合、パスワードの値が指定されていないと、スクリプトを接続しようとするときにパスワード プロンプトが表示されます。 詳細については、PASSWORD コマンドを参照してください。 SET PASSWORD コマンド SET PASSWORD コマンドを使用して、 HighBond に接続するための番号付けされたパスワード定義を作成した場合、パスワードの値が指定されていれば、パスワード プロンプトは表示されません。これは、無人で実行するように設計されたスクリプトに適しています。 詳細については、SET PASSWORD コマンドを参照してください。 HighBond アクセス トークンを取得 どの方法を用いてパスワード定義を作成したかにかかわらず、パスワードには値として HighBond アクセス トークンを指定する必要があります。このトークンは Launchpad で生成できます。 注意 生成されるアクセス トークンは Launchpad へのサインインに使用するアカウントと一致します。他のユーザーが使用するスクリプトを作成する場合は、そのスクリプト内に自身のアクセス トークンを指定することは不適切です。
|
HighBond のリザルトにエクスポートを行う際の DISPLAYNAME と AS の相互作用
下記のマトリクスは、Analytics からリザルトにフィールド名をエクスポートする際の DISPLAYNAME パラメーターと AS の相互作用を示しています。
| AS を指定しない場合 | AS を指定した場合 | |
|---|---|---|
| DISPLAYNAME を指定しない場合 | Analytics のフィールド名が、リザルトのフィールド名と表示名になります。 | リザルトのフィールド名と表示名が、AS パラメーターの表示名になります。 |
| DISPLAYNAME を指定した場合 | Analytics のフィールド名が、リザルトのフィールド名になります。Analytics の表示名が、リザルトの表示名になります。 | Analytics のフィールド名が、リザルトのフィールド名になります。リザルトの表示名が、AS パラメーターの表示名になります。 |
