IMPORT XML コマンド

XML ファイルを定義およびインポートして、Analytics テーブルを作成します。

構文

IMPORT XML TO テーブル インポートファイル名 FROM ソースファイル名 [フィールド構文] <...n>
フィールド構文 ::=
FIELD 名前  AT 開始位置 DEC value WID バイト PIC 書式 AS 表示名 RULE xpath 式

パラメーター

名前 説明
TO テーブル

データをインポートする Analytics テーブルの名前。

メモ

テーブルの名前は、64 文字までの英数字に制限されます。 名前にはアンダースコア文字(_)を使用できますが、他の特殊文字やスペースは使用できません。 名前の先頭を数字にすることはできません。

インポートファイル名

作成する Analytics データ ファイルの名前。

インポートファイル名、.FIL ファイル拡張子を持つ引用符で囲まれた文字列として指定します。 例:"Invoices.FIL".

デフォルトでは、データ ファイル(.FIL)は、Analytics プロジェクトが入っているフォルダーに保存されます。

既存の異なるフォルダーにデータ ファイルを保存するには、絶対または相対ファイル パスを指定します。

  • "C:\data\Invoices.FIL"
  • "data\Invoices.FIL"

FROM ソースファイル名

ソース データ ファイルの名前。 ソース ファイル名は引用符で囲む必要があります。

ソース データ ファイルが Analytics プロジェクトと同じフォルダーに位置しない場合、ファイルの位置を指定するために絶対パスまたは相対パスを使用する必要があります。

  • "C:\data\ソース ファイル名"
  • "data\ソース ファイル名"
FIELD 名前

インポートするソース データ ファイル内の個別フィールドの名前およびデータ型。 フィールドをインポート対象から除外する場合は、そのフィールドを指定しないでください。

については、フィールド データ型の識別子を参照してください。

AT 開始位置

Analytics データ ファイル内のフィールドの開始バイトを指定します。

メモ

非 Unicode 版 Analytics 1 バイト = 1 文字
Unicode 版 Analytics 2 バイト = 1 文字

Unicode 版 Analytics では、一般的に、奇数で開始するバイト位置を指定してください。 偶数の開始位置を指定すると、文字が正しく表示されない可能性があります。

DEC

数値フィールドの小数点以下の桁数

WID バイト

Analytics テーブル レイアウトにおけるフィールドの長さ(バイト数)

メモ

非 Unicode 版 Analytics 1 バイト = 1 文字
Unicode 版 Analytics 2 バイト = 1 文字

Unicode 版 Analytics では、偶数バイトのみを指定します。 奇数バイトを指定すると、文字が正しく表示されない可能性があります。

PIC 書式

メモ

数値フィールドまたは日付時刻フィールドにのみ適用されます。

  • 数値フィールド Analytics のビューとレポートに含まれる数値の表示形式。
  • 日付時刻フィールドソース データの日付時刻値の物理形式(日付時刻文字、区切り文字の順など)

    メモ

    日付時刻フィールドの場合、形式はソース データの物理形式と正確に一致する必要があります。 たとえば、ソース データが 12/31/2014 である場合は、書式を "MM/DD/YYYY" として入力します。

書式は引用符で囲む必要があります。

AS 表示名

新しい Analytics テーブルのビューにおけるフィールドの表示名(代替列見出し)。

表示名の値は引用符で囲まれた文字列。 列見出しを改行したい場合は、語句の間にセミコロン(;)を入れます。

フィールドの定義時には、AS は必須です。 表示名をフィールド名と同じにしたい場合は、空の表示名を入力します。つまり、次の構文を使用します。AS "" 2 つの二重引用符の間にスペースがないことを確認してください。

RULE xpath式

xpath 式は XML ファイルからフィールド内容を選択するために使用されます。

xpath は XML ファイルのデータにアクセスする標準的な方法です。 たとえば、acct/title/text() は XML ファイルの <title> タグ内のテキストを取得します。

XML ファイルのデータを Analytics テーブルにインポートする

次の例では、XML ファイルのデータを Employees という名前の Analytics テーブルにインポートしています。

IMPORT XML TO Employees "Employees.fil" FROM "emp.XML" FIELD "Empno" C AT 1 DEC 0 WID 6 PIC "" AS "" RULE "/RECORDS/RECORD/Empno/text()" FIELD "First" C AT 7 DEC 0 WID 13 PIC "" AS "" RULE "/RECORDS/RECORD/First/text()" FIELD "Last" C AT 20 DEC 0 WID 20 PIC "" AS "" RULE "/RECORDS/RECORD/Last/text()" FIELD "HireDate" D AT 40 DEC 0 WID 10 PIC "YYYY-MM-DD" AS "" RULE "/RECORDS/RECORD/HireDate/text()" FIELD "Salary" N AT 50 DEC 2 WID 8 PIC "" AS "" RULE "/RECORDS/RECORD/Salary/text()"

備考

メモ

このコマンドの動作の詳細については、Analytics のヘルプを参照してください。

フィールド データ型の識別子

以下の表は、FIELD でデータを指定するときに使用する必要がある文字の一覧を示します。 各文字は Analytics データ型の 1 つに対応します。

たとえば、文字データ型が必要な姓フィールドを定義する場合は、"C": FIELD "Last_Name" C と指定します。

詳細については、Analytics データ型を参照してください。

メモ

データ定義ウィザードを使用して EBCDIC、Unicode、または ASCII フィールドを含むテーブルを定義する場合、それらのフィールドには自動的に文字 "C"(CHARACTER 型)が割り当てられます。

IMPORT ステートメントを手作業で入力するか、既存の IMPORT ステートメントを編集する場合、EBCDIC または Unicode フィールドに対して、より特有の文字 "E" または "U" に置き換えることができます。

文字

Analytics データ型

A

ACL

B

BINARY

C

CHARACTER

D

DATETIME

E

EBCDIC

F

FLOAT

G

ACCPAC

I

IBMFLOAT

K

UNSIGNED

L

LOGICAL

N

PRINT

P

PACKED

Q

BASIC

R

MICRO

S

CUSTOM

T

PCASCII

U

UNICODE

V

VAXFLOAT

X

NUMERIC

Y

UNISYS

Z

ZONED