資料の 英語版 に戻る
XML コンポーザー・ステップ (Hierarchical Data ステージ)
XML Composerステップ (DataStage)
最終更新: 2025年3月12日
指定された構造を使用して XML コンテンツを作成します。
XML ターゲット
- ファイルに書き込む
- 構成するファイルの出力ディレクトリーおよびファイル名接頭部を入力するか、「パラメーターの挿入」をクリックし、出力ディレクトリーおよびファイル名接頭部のパラメーターの名前を選択します。 使用可能なパラメーターは、ジョブで以前に定義したパラメーターと、 IBM® InfoSphere® DataStage®内にある組み込みマクロです。
- ストリングとして渡す
- 追加の処理を行うために、構成された XML ストリングをダウンストリームのステップまたはステージに渡します。
- ラージ・オブジェクトとして渡す
- 構成された XML ストリングをラージ・オブジェクトとして渡します。 最後のターゲット・ステージ (ジョブの最後のステージ) は、Db2 Connector、Oracle Connector、ODBC Connector、Teradata Connector、Websphere MQ Connector などの LOB 対応ステージでなければなりません。 これらのステージは、LOB ロケーター・ストリングを使用して XML データを取得し、それをターゲット・データベースまたはメッセージ・キューに書き込みます。 ジョブには LOB 非対応ステージを含めることができますが、これらのステージで LOB ロケーター・ストリングを変更してはなりません。 ジョブの最後のステージが LOB 対応でない場合、LOB ロケーターはロケーターとして解釈されずに、データとして書き込まれます。
文書ルート
構成する文書を記述する最上位エレメントを選択します。 ライブラリーの名前空間の下に表示されるタイプは、最上位エレメント定義です。 XML スキーマ標準に従うと、最上位エレメントのみが文書を記述できます。 選択する要素の名前は、インスタンス文書内の最上位のエレメント名と一致している必要があります。 例えば、Order 文書を構成する場合は、Order エレメントを選択します。 エレメントを選択すると、そのエレメントの構造を表示して、構成する文書の構造が正しいことを確認することができます。
注: 文書ルートを選択する要素は、以前にスキーマ・ライブラリーにインポートされたリソースからのものです。 XML コンポーザー・ステップの文書ルートが含まれているリソースをインポートする必要がある場合は、「ライブラリーをオープン」タブをクリックして、必要なリソースをインポートします。 次に、アセンブリー・エディターに戻って文書ルートを構成します。
検証
デフォルトでは、XML コンポーザーは「最小の検証」を使用し、違反が発生するとジョブは失敗します。 検証をカスタマイズするために、違反が発生したときに実行するアクションを指定します。
検証ルールの詳細については、XML Composerの検証ルール (DataStage) を参照してください。
マッピング
document_collection 項目へのマッピングを作成します。 この項目をマップする方法によって、1 文書が作成されるか、複数の文書が作成されるかが決まります。 1 つの文書のみを作成するには、入力のルート (トップ) を document_collection にマップします。 複数の文書を作成するには、リスト項目を document_collection 項目にマップします。 これにより、リスト内の項目ごとに 1 つのファイルが作成されます。 マッピングの詳細については、マッピング・テーブルを使う (DataStage)を参照してください。
ヘッダー
XML 出力の先頭に含める追加のオプション情報を指定します。
- XML フラグメントの生成
- XML 宣言、コメント、および処理命令は含めません。
- XML 宣言を含める
- XML 宣言を組み込みます (例:
<?xml version="1.0" encoding="UTF-8">)。 - コメントを組み込む
- 「コメント」フィールドに入力するコメントを組み込みます。
- 処理命令を組み込む
- 「処理命令」フィールドに入力する処理命令を組み込みます。 各処理命令は、<? タグおよび ?> タグで囲みます。
- schemaLocation を組み込む
- 「スキーマ・ロケーション」フィールドに入力された値を設定した
schemaLocation属性を XML ファイルに組み込みます。 - noNamespaceSchemaLocation を組み込む
- 「名前空間なしのスキーマ・ロケーション」フィールドに入力された値を設定した
noNamespaceSchemaLocation属性を XML ファイルに組み込みます。
フォーマット
- エンコード・タイプ
- 文書に使用するエンコードを選択します。 デフォルトのエンコードは UTF-8 です。
- フォーマット・スタイル
- 次に示す、XML 出力に適用するフォーマット・オプションのボックスにチェック・マークを付けます。
- インデント・レベルごとのスペース – XML 出力における各インデント・レベルに使用する文字数を選択します。
- 改行のスタイル – 改行のタイプを選択します。 選択項目は、UNIX (LF)、DOS (CRLF)、または MAC (CR) です。
- タイム・ゾーン – +14:00 から -14:00 の範囲でタイム・ゾーン値を指定します。 コンポーザーの出力データに日付データ・タイプのいずれかのエレメント (time、dateTime、または gMonth) が含まれる場合、コンポーザー・ステップにより、日付データ・タイプは指定されたタイム・ゾーンに従って変換され、変換されたデータがコンポーザーの出力データに追加されます。 コンポーザーの出力データにタイム・ゾーン情報が含まれていない場合、テキスト・フィールドに指定されたタイム・ゾーンがコンポーザーの出力データに追加されます。
「パラメーターの挿入」オプションを選択することで、デザイン時にタイム・ゾーンを指定するのではなく、実行時にタイム・ゾーンが含まれたパラメーターを挿入できます。
- デフォルト値を持つ属性の省略 – デフォルト値を持ち、データ内にある属性の場合、または固定値を持つ属性の場合は、XML 出力から値を省略します。
- NULL エレメントの省略 – データ内にない NULL 可能エレメントの場合は、XML 出力からエレメントを省略します。
- オプションの空エレメントの省略 – XML ノードが空値を持つ場合は、XML 出力からエレメントを省略します。
トピックは役に立ちましたか?
0/1000