XML エンティティを操作

ドキュメントのダウンロード

サイトマップ

用語集

検索

e-docs > WebLogic Integration > BPM トピック > WebLogic Integration Studio ユーザーズガイド > XML エンティティを操作

WebLogic Integration Studio ユーザーズガイド

XML エンティティを操作

この章では、Studio を使用して XML エンティティの取り出し、構成、および保存を行う方法を説明します。

XML ドキュメント管理タスクの概要

いくつかのワークフローアクションには、ワークフローに埋め込まれているフリーフォーム XML ドキュメントやタイプ指定 XML ドキュメントの作成、編集、およびエクスポートに使用できる XML エディタが内蔵されています。XML ファインダを使用すると、さまざまなソース内の XML エンティティを検索し、そのエンティティを別のタイプのストレージで保存できます。XML ドキュメントのコンテンツとストレージの管理は次のように行います。

（省略可能）既存の XML エンティティをファイルシステムからリポジトリにインポートします。このエンティティには、XML ドキュメントテンプレートやインスンタンス、XML スキーマドキュメントなどが含まれます。その手順は、リポジトリにあるエンティティの管理で説明されています。

あるいは、前にエクスポートした XML エンティティを既存のワークフローパッケージからインポートします。詳細については、ワークフローパッケージのインポートの手順を参照してください。
アクションワークフロー変数を設定、XML イベントをポスト、XML をクライアントに送信、XSL 変換、および例外ハンドラの呼び出しを既存のノードまたはアクションに追加します。最初の 3 つのアクションについては、アクションの定義を参照してください。例外ハンドラの呼び出しアクションについては、例外ハンドラを呼び出すを参照してください。
アクションダイアログボックスで XML ドキュメントを構成、インポート、および編集します。手順の詳細は、XML ドキュメントの作成と編集を参照してください。
（省略可能） XML ファインダを使用して XML エンティティをファイルシステムまたは XML リポジトリデータベースから取り出してワークフローにインポートします。手順の詳細は、XML エンティティを取り出すを参照してください。
（省略可能） XML ファインダを使用して、ワークフローに埋め込まれた XML ドキュメントをファイルシステムまたは XML リポジトリデータベースにエクスポートします。手順の詳細は、XML エンティティをエクスポートするを参照してください。

注意: XML ドキュメントを作成するダイアログボックスでは XML 要素値を式として入力する必要があるため、XML ドキュメントの定義を始める前に、ワークフロー式言語と Studio の Expression Builder ツールの学習も必要です。ワークフロー式に関する詳細については、ワークフロー式の使用法を参照してください。

XML ドキュメントの作成と編集

次のアクションダイアログボックスには、ワークフローテンプレート定義内に保存された整形式の XML ドキュメントの作成、インポート、および編集に使用する、組み込み XML エディタが含まれています。

[ワークフロー変数を設定]
[XML イベントをポスト]
[XML をクライアントに送信]
[例外ハンドラの呼び出し]
図7-1 アクションダイアログボックスの XML エディタ

XML エディタには、次の標準 XML マークアップから成るノードで構成される XML ドキュメントが、ツリー構造で表示されます。

Elements (要素)
Attributes （属性）
Comments (コメント)
CDATA sections (CDATA セクション)
Processing instructions (処理手順)

左ペインには要素および属性のタグなどのメタデータが表示され、右ペインには各タグに対する実際のデータ値が表示されます。

Studio のダイアログボックスで作成および編集するドキュメントは、実際には、実行時に XML ドキュメントのインスタンスを生成するために使われる XML ドキュメントのテンプレートです。つまり、要素および属性に対してワークフローの式を使用して実行時に値を生成し、これらのノードのうちの 1 つから Expression Builder を起動してユーザ指定の式を作成できます。要素と属性のデータはワークフローの式構文に従う必要があるため、文字列をすべて引用符で囲みます。入力した値が有効なワークフロー式でない場合、たとえば文字列が引用符で囲まれていない場合やバックスラッシュの前にエスケープ文字がない場合は、アイコンがその前に表示されます。ワークフロー式の言語、および Expression Builder の使い方については、ワークフロー式の使用法を参照してください。

ドキュメントの新規作成、および既存のドキュメントの編集には、フリーフォームモードとコンテンツ型モードの 2 つのモードがあります。フリーフォームモードでは、コンテンツタイプの検証を行わずにドキュメントを作成および編集します。特定のコンテンツタイプに従う必要のない整形式の XML ドキュメントを生成するときには、フリーフォームモードを使用します。フリーフォームモードでの XML ドキュメント作成の詳細は、フリーフォームドキュメントを作成するを参照してください。

コンテンツタイプモードでは、ドキュメントを検証する基準となる既存の外部スキーマドキュメントをロードすることで新規または既存ドキュメントのコンテンツタイプを指定します。ドキュメントの作成または編集処理中に、ドキュメントの有効性を何度でも検証できます。コンテンツ型の指定されたドキュメントでの作業については、タイプ指定ドキュメントを操作するを参照してください。

既存のフリーフォームおよびタイプ指定ドキュメントをリポジトリまたはディスク上のファイルからインポートすること（既存のドキュメントをインポートする参照）や、コンテンツタイプを既存ドキュメントに追加すること（既存のドキュメントへの新しいコンテンツタイプを設定する参照）も可能です。

さらに、Studio で作成または編集されたドキュメントテンプレートをリポジトリまたはディスク上のファイルにエクスポートすることが可能です。アクションダイアログボックスから XML ドキュメントをエクスポートする方法については、XML エンティティをエクスポートするを参照してください。

XML ドキュメントの作業に使用するダイアログボックス内には、次の表に示すツールバーが表示されます。XML ドキュメントの作成、インポート、編集、およびコンテンツタイプの設定方法については、後の節で説明します。

表7-1 XML エディタのツールバーボタンとキーボードショートカット

ボタン	キーボードショートカット	目的
	〔Ctrl〕+〔q〕	リポジトリ、ディスク上のファイル、または URL 位置から、編集対象の既存の XML ドキュメントを取り出す。詳細については、XML エンティティを取り出すを参照。
	〔Ctrl〕+〔w〕	ワークフロー内の XML メッセージをリポジトリまたはディスク上のファイルに保存する。詳細については、XML エンティティをエクスポートするを参照。
	〔Ctrl〕+〔t〕	XML ドキュメントのコンテンツタイプとして設定するスキーマドキュメントを取り出す。詳細については、タイプ指定ドキュメントを操作するを参照。
	〔Ctrl〕+〔k〕	コンテンツタイプとして現在設定されているスキーマファイルのコンテンツを表示する。詳細については、タイプ指定ドキュメントを検証するを参照。
	〔Ctrl〕+〔l〕	ドキュメントが有効な XML で、現在のコンテンツタイプに従っているかどうかを調べる。詳細については、タイプ指定ドキュメントを検証するを参照。
	〔Delete〕	選択したノードを削除する、または文書型宣言が選択されている場合は、現在のドキュメントからコンテンツタイプ定義を取り除く。
	〔Ctrl〕+〔Insert〕	選択した要素と同じレベルに、要素ノードを追加する。
	〔Insert〕	ドキュメントのルート要素ノードを追加する、または選択した要素の下位レベルの要素を追加する。
	〔Ctrl〕+〔a〕	選択した要素に属性ノードを追加する。
	〔Ctrl〕+〔p〕	処理手順ノードを追加する。
	〔Ctrl〕+〔m〕	コメントノードを追加する。
	〔Ctrl〕+〔n〕	CDATA セクションノードを追加する。
	〔Ctrl〕+〔↑〕	選択したノードを、同じレベル内で上に移動する。
	〔Ctrl〕+〔↓〕	選択したノードを、同じレベル内で下に移動する。
	〔Ctrl〕+〔→〕	選択したノードを、下位レベルに移動する。
	〔Ctrl〕+〔←〕	選択したノードを、上位レベルに移動する。

フリーフォームドキュメントを作成する

フリーフォームドキュメントを作成する手順は、次のとおりです。

XML エディタを含むアクションダイアログボックスで、[子を追加] ボタンをクリックしてルート要素をドキュメントに追加します。デフォルトの要素名が選択された状態で表示されます。
デフォルト名 element を変更するには、新しい名前を入力して上書きします。
要素に値を追加するには、右ペインで要素の横にあるフィールドをダブルクリックし、ワークフローの式構文を使って値を入力します。
表 7-1 に示すツールバーボタンを使用する、またはXML ドキュメントを編集するに示す手順に従って、ドキュメントにノードと値をさらに追加します。
ドキュメントの作成が完了したときに、次の操作のうち 1 つを行います。

既存のドキュメントをインポートする

Studio の XML エディタで作成後にエクスポートした、またはその他のメソッドで作成されたフリーフォームおよびコンテンツ型の XML ドキュメントは、両方ともインポートできます。コンテンツ型のドキュメントのインポートについては、タイプ指定ドキュメントのインポートについてを参照してください。

既存 XML ドキュメントをワークフローにインポートすると、XML エディタによって XML ドキュメントが次の 2 種類に区別されます。

Studio の XML エディタで前にエクスポートされた XML ドキュメント。つまり、ワークフロー式構文に即した要素値と属性値を含むワークフロー XML ドキュメント テンプレート。
別の方法で作成された XML ドキュメント。つまり、標準 XML 値を含む XML ドキュメント インスタンス。

Studio から作成およびエクスポートされたワークフロー XML ドキュメントテンプレートでは、要素および属性の文字列の値が引用符で囲まれていますが、その他のドキュメントのインスタンスでは、通常、囲まれていません。そのため、Studio のアクションダイアログボックス以外で作成された XML ドキュメントでは、ドキュメントを XML テンプレートに変換するよう求められます。変換処理を行うと、必要に応じてすべての要素および属性の値が引用符で囲まれるため、手動で挿入する必要はありません。

注意: Studio では、前のバージョンの WebLogic Process Integrator からエクスポートされた XML ドキュメントはドキュメントテンプレートとして認識されないため、この場合も、これらのドキュメントを XML ドキュメントにコンバートするよう要求されます。XML エディタが余分な引用符を挿入しないように、インポートしたドキュメントを変換しないでください。

既存のフリーフォームまたはコンテンツ型 XML ドキュメントをインポートする手順は、次のとおりです。

アクションダイアログボックスで [インポート] ボタンをクリックし、XML ファインダを表示します。
XML エンティティを取り出すの手順に従って、XML ファインダを使用してさまざまなソースからドキュメントを選択します。ドキュメントがドキュメントテンプレートとして検出されなかった場合、「値を二重引用符で囲む」というメッセージが表示されます。
図7-2 [値を二重引用符で囲む] ダイアログボックス
次の操作を行います。
- 旧バージョンの WebLogic Process Integrator から作成およびエクスポートされたドキュメントの場合は、[いいえ] をクリックします。
- その他のメソッドによって作成されたドキュメントの場合は、[はい] をクリックします。
ドキュメントが XML エディタにインポートされます。
必要に応じて、表 7-1 に示すツールバーボタンを使用するか、または XML ドキュメントを編集するに示す手順に従って、ノードと値を追加および編集します。
（省略可能）コンテンツ型のドキュメントでは、タイプ指定ドキュメントを検証するの手順に従って、ドキュメントの検証を行います。
（省略可能）別のドキュメントをインポートして現在のドキュメントと置き換えるには、[インポート] ボタンをクリックします。現在のドキュメントを上書きするプロンプトが表示されたら、[はい] をクリックしてインポートを続行します。または [いいえ] をクリックして取り消します。
ドキュメントの編集が完了したときに、次の操作のうち 1 つを行います。

XML ドキュメントを編集する

新規またはインポートされた、フリーフォームまたはコンテンツ型のドキュメントの編集手順は、一般的に次のとおりです。コンテンツ型のドキュメントを編集する際の詳細は、タイプ指定ドキュメントを操作するを参照してください。

表7-2 XML ドキュメントの編集

目的	操作
ドキュメント内を移動する	左ペインですべてのノードを展開する。右ペインの右側にあるスクロールバーを使用する、または〔Tab〕、〔↑〕、〔↓〕を押して、ドキュメント内を上下に移動する。
フリーフォームドキュメントの最初の要素を追加する	[子を追加] ボタンをクリックする、または〔Insert〕を押す。
要素にサブ要素を追加する	左ペイン内で要素を選択し、[子を追加] ボタンをクリックする、または〔Insert〕を押す。
別の要素と同じレベルに要素を追加する	左ペイン内で要素を選択し、[兄弟を追加] ボタンをクリックする、または〔Ctrl〕+〔Insert〕を押す。
要素名を編集する	左ペインで要素をダブルクリックしてエントリフィールドを表示する。必要に応じて要素名を変更する。
要素に属性を追加する	左ペイン内で要素を選択し、[属性を追加] ボタンをクリックする、または〔Ctrl〕+〔a〕を押す。
属性名を編集する	左ペインで属性をダブルクリックしてエントリフィールドを表示する。必要に応じて属性名を変更する。
要素または属性の値を編集する	右ペイン内で、値を追加または編集する要素または属性の横にある線をダブルクリックする。エントリフィールドが表示されるので値を入力する。または [式] ボタンをクリックして [Expression Builder] を呼び出し、有効なワークフロー式を構築する。文字列は二重引用符で囲む必要がある。構文が無効な場合、エントリの横に赤い X が表示される。ワークフローの式の定義については、ワークフロー式の使用法を参照。
コメントノードを追加する	左ペイン内でコメントを追加する要素を選択し、[コメントを追加] ボタンをクリックする、または〔Ctrl〕+〔m〕を押す。
処理手順を追加する	左ペイン内で、処理手順を追加する要素を選択し、[処理手順を追加] ボタンをクリックする、または〔Ctrl〕+〔p〕を押す。
処理手順のターゲットを変更する	左ペインで処理手順をダブルクリックしてエントリフィールドを表示する。必要に応じて処理手順対象を変更する。
CDATA セクションを追加する	左ペイン内で、CDATA セクションを追加する要素を選択し、[CDATA を追加] ボタンをクリックする、または〔Ctrl〕+〔n〕を押す。
コメント、処理手順、または CDATA セクションの値の編集	右ペインで、値を編集するコメント、処理手順、または [CDATA] アイコンの横にあるラインをダブルクリックする。エントリフィールドが表示されるので値を入力する。
ノードの順序を変更する	移動する要素、属性、コメント、処理手順、または CDATA セクションを選択し、[ノードを上に移動] または [ノードを下に移動] ボタンをクリックする、または〔Ctrl〕+〔↑〕または〔Ctrl〕+〔↓〕を押す。
ノードの階層的レベルを変更する	レベルを変更する要素、コメント、処理手順、または CDATA セクションを選択し、[ノードを右に移動] または [ノードを左に移動] ボタンをクリックする、または〔Ctrl〕+〔→〕または〔Ctrl〕+〔←〕を押す。
ノードを削除する	左右いずれかのペイン内で、削除する要素または属性を選択して、[削除] ボタンをクリックする、または〔Delete〕を押す。

タイプ指定ドキュメントを操作する

既存の外部スキーマに基づいて XML ドキュメントを作成することができます。内部 DTD 宣言はサポートされていません。

また、既存ドキュメントをスキーマに基づいてインポートすることや、XML エディタに既にロードされているドキュメントのコンテンツタイプを設定することも可能です。

参照スキーマの格納について

WebLogic Integration サーバは、XML ドキュメントテンプレートに関連付けられているスキーマドキュメントに実行時にアクセスできなければならないため、Studio XML ドキュメントによって参照されるスキーマは URL でアクセスできる場所にある XSD ファイルとして、またはリポジトリ内のエンティティとして存在する必要があります。

注意: URL が WebLogic Integration サーバと異なるマシン上の場所を指す場合、実行時に処理エンジンが XML ドキュメントのインスタンスを生成しても、URL で参照するシステムが非アクティブな状態である危険性があります。このような場合、サーバ例外が発生します。XSD ファイルは、実行時に確実にアクセスできる場所（WebLogic Integration サーバのファイルシステム上など）に格納するようにしてください。また、使用する URL が実行時において有効で、必要なリソースの正しい場所を指すことも確認してください。

スキーマリソースをリポジトリに格納しておくと、頻繁にアクセスされるドキュメントの取り出しが容易になる場合があります。リソースをリポジトリにインポートする手順については、リポジトリにあるエンティティの管理を参照してください。

一方で、新規作成されたドキュメントをエクスポートする場合や、インポート済みのドキュメントを再エクスポートする場合は、リポジトリに保持されるスキーマへの参照はコンテンツタイプ宣言内のエンティティ名でのみ識別され、サードパーティ製の XML パーサでは解決されないこともあります。したがって、エクスポートされた XML ドキュメントが WebLogic Integration の外と内のどちらで使用されるかに応じて、XSD を適切な場所に配置することが重要です。XML ドキュメントを WebLogic Integration の外部で使用する場合、ディスクファイル上にリソースを格納し、URL でアクセスすることをお勧めします。XML ドキュメントを WebLogic Integration 内で使用する場合、XML リポジトリにリソースを格納することをお勧めします。

タイプ指定ドキュメントのインポートについて

文書型宣言を含む既存ドキュメントを外部スキーマドキュメントにインポートすることは可能ですが、内部ドキュメントにインポートすることはできません。設計時に WebLogic Integration サーバが参照スキーマにアクセスできること、および文書型宣言でドキュメントの場所を指定するために有効な URL が使用されていることを確認してください。宣言にドキュメント名のみが含まれていて、完全な場所は含まれていない場合は、WebLogic Integration サーバは参照を解決できず、ドキュメントのインポートは不可能です。

別の方法として、参照スキーマリソースを XML リポジトリに格納することも可能です。この方法では、リポジトリエンティティの名前を文書型宣言に単に指定すれば、WebLogic Integration サーバが参照を解決します。リソースをリポジトリにインポートする手順については、リポジトリにあるエンティティの管理を参照してください。

インポートしたドキュメントを再度エクスポートする場合は、前述の実行時の注意事項をご覧ください。

コンテンツ型ドキュメントのインポート手順については、既存のドキュメントをインポートするを参照してください。

タイプ指定ドキュメントを作成する

XML ドキュメントをスキーマに基づいて作成すると、XML エディタによって以下のコンポーネントから構成されるデフォルトドキュメントが作成されます。

スキーマ定義ドキュメントの場合は、参照スキーマを指定するルート要素内の属性。
すべての必須要素および属性、任意の要素および属性の 1 つのインスタンス。コンテンツタイプ定義によってサポートされる、任意の要素および属性をさらに追加できます。
要素または属性のデフォルト値。定義済みの許容値のセットからデフォルト値を指定します。値を編集して、コンテンツタイプ定義によってサポートされる別の値を指定できます。
処理手順。ドキュメントがワークフロー XML テンプレートであるかどうかを示します。処理手順は見えませんが、エクスポートされたドキュメント内に生成されます。

新しいコンテンツ型ドキュメントを作成する手順は、次のとおりです。

XML エディタを含むアクションダイアログボックスで、[コンテンツタイプを設定] ボタンをクリックします。[XML ファインダ] が表示されます。
XML エンティティを取り出すの手順に従い、[XML ファインダ] を使用して適切なソースからスキーマドキュメントを選択します。コンテンツ型ドキュメントが取得されると、「デフォルトのドキュメントを生成」というメッセージが表示されます。
図7-3 [デフォルトのドキュメントを生成] ダイアログボックス
[はい] をクリックして、デフォルトドキュメントを生成します。[ルート要素を選択してください] ダイアログボックスに、定義したすべての要素が表示されます。
図7-4 [ルート要素を選択してください] ダイアログボックス
ドキュメントのルート要素となる要素を選択し、[OK] をクリックします。デフォルトドキュメントが作成されます。DTD ベースのドキュメントでは、ルート要素の上位にプロログが文書型宣言と一緒に挿入されます。スキーマに基づくドキュメントでは、ルート要素内にスキーマを参照する属性が挿入されます。
表 7-1 のツールバーボタンを使用、またはXML ドキュメントを編集するの手順に従って、ノードと値を必要に応じて追加および編集します。
タイプ指定ドキュメントを検証するの手順に従って、ドキュメントを検証します。
ドキュメントの作成および検証が完了したときに、次の操作のうち 1 つを行います。

既存のドキュメントへの新しいコンテンツタイプを設定する

作成したドキュメントまたはインポートした既存のドキュメントに、コンテンツタイプ定義を適用できます。また、コンテンツタイプドキュメントからコンテンツタイプを削除したり、新規または既存のコンテンツ型ドキュメントのコンテンツタイプを変更することもできます。

フリーフォームドキュメントにコンテンツタイプ定義を適用する手順は、次のとおりです。

以下のいずれか 1 つを実行します。
- フリーフォームドキュメントを作成するの手順に従って、新しいフリーフォームドキュメントを作成します。
- 既存のドキュメントをインポートするに記載の手順 1 ～ 3 に従い、既存のフリーフォームドキュメントをインポートします。
[コンテンツタイプを設定] ボタンをクリックします。[XML ファインダ] が表示されます。
XML エンティティを取り出すの手順に従い、[XML ファインダ] を使用して適切なソースからスキーマドキュメントを選択します。コンテンツ型ドキュメントが取得されると、「デフォルトのドキュメントを生成」というメッセージが表示されます。
図7-5 [デフォルトのドキュメントを生成] ダイアログボックス
[いいえ] をクリックして、既存のドキュメントを保持します。
XML ドキュメントを編集するの説明に従って、ドキュメントを定義します。
タイプ指定ドキュメントを検証するの説明に従って、ドキュメントを検証します。

コンテンツ型ドキュメントからコンテンツタイプ定義を削除する手順は、次のとおりです。

スキーマ型ドキュメントでは、スキーマを参照するルート要素の属性ノードを選択します。
[削除] ボタンをクリックします。コンテンツタイプ定義が削除され、ドキュメントがフリーフォームドキュメントに変わります。

コンテンツ型ドキュメントのコンテンツタイプを変更する手順は、次のとおりです。

スキーマ型ドキュメントでは、スキーマを参照するルート要素の属性ノードを選択します。
ルート要素の上位にある、コンテンツタイプ定義を含むノードを選択します。
[削除] ボタンをクリックします。コンテンツタイプ定義が削除されます。
[コンテンツタイプを設定] ボタンをクリックします。[XML ファインダ] が表示されます。
XML エンティティを取り出すの手順に従い、[XML ファインダ] を使用して適切なソースからスキーマドキュメントを選択します。コンテンツ型ドキュメントが取得されると、「デフォルトのドキュメントを生成」というメッセージが表示されます。
[いいえ] をクリックして、既存のドキュメントを保持します。
XML ドキュメントを編集するの説明に従って、ドキュメントを定義します。
タイプ指定ドキュメントを検証するの説明に従って、ドキュメントを検証します。

タイプ指定ドキュメントを検証する

新規作成またはインポートされたタイプ指定ドキュメントを構成または編集している間は、現在のコンテンツタイプとして設定されているスキーマドキュメントのコンテンツを参照でき、エラーの原因の参照とその修正を同時に可能にする Studio 検証機能を利用できます。

関連付けられているスキーマのコンテンツを参照する手順は、次のとおりです。

[コンテンツタイプ定義を表示] ボタンをクリックします。[コンテンツタイプ定義] ウィンドウが開き、現在のコンテンツタイプ定義ドキュメントのコンテンツが表示されます。
図7-6 [コンテンツタイプ定義] ウィンドウ
[閉じる] をクリックして、ウィンドウを終了します。

新規またはインポートしたコンテンツ型ドキュメントをコンテンツタイプ定義に対して検証する手順は、次のとおりです。

[ドキュメント構造を検証] ボタンをクリックします。ドキュメントが有効かどうかを示すメッセージが表示されます。ドキュメントにエラーが含まれている場合、[検証エラー] ダイアログボックスが開き、エラーの性質および場所が表示されます。
図7-7 [検証エラー] ダイアログボックス
[次へ] または [前へ] をクリックしてエラーのリストをスクロールし、エラーのあるノードを編集します。
[閉じる] をクリックして、ダイアログボックスを閉じます。
[ドキュメント構造を検証] ボタンを再度クリックし、ドキュメントを再検証します。「有効なドキュメント」というメッセージが表示されるまで、手順 1 から 3 を繰り返します。
[OK] をクリックして、[有効なドキュメント] メッセージボックスを閉じます。

XML ファインダによる XML エンティティの取り出しとエクスポート

[XML ファインダ] ダイアログボックスを使用すると、XML エンティティを取り出してリポジトリ、ローカルファイルシステム、または URL に保存できます。また、このダイアログボックスには、最近使用した XML エンティティのリストが保持されているため、これらのエンティティを再度使用するときに検索する必要がありません。

XML エンティティとしては、XML ドキュメント、文書型定義（DTD）、スキーマドキュメント（XSD）、MFL (Message Format Language: メッセージフォーマット言語) ファイル、XSL (Extensible Stylesheet Language: 拡張スタイルシート言語) テンプレートドキュメントなどがあります。

XML ファインダにアクセスするには、いくつかの方法があります。XML ファインダにアクセスする方法によって、また、ドキュメントを検索するか保存するかによって、操作方法は異なります。この方法について、以下の節で説明します。

XML エンティティを取り出す

XML エンティティを検索して、次のダイアログボックスにロードできます。

[ワークフロー変数を設定]、[XML をクライアントに送信]、[XML をクライアントに送信] および [例外ハンドラの呼び出し] の各アクションダイアログボックスでは、リポジトリ、ローカルファイルシステム、または URL から既存の XML ドキュメントを検索できます。取り出した XML ドキュメントは、ダイアログボックス内で編集できます。リポジトリまたは URL から既存のスキーマドキュメントを取り出して、構成または編集するドキュメントのコンテンツタイプを設定することも可能です。
[XSL 変換] ダイアログボックスでは、リポジトリまたは URL から XSL ドキュメントの名前を検索して、変換ドキュメントとして使用できます。
[XPath Wizard] では、リポジトリ、ローカルファイルシステム、または URL から XML エンティティを開いて、XPath 式を生成またはテストできます。
[_ツール｜XML ファインダを表示] を選択すると、XML エンティティをローカルファイルシステムまたは URL からリポジトリにインポートできます。詳細については、リポジトリにあるエンティティの管理を参照してください。

最近使用した XML エンティティを取り出す

XML ファインダにより、ワークステーションで最近使用した XML エンティティのリストが保持されます。リスト内のエンティティは、再検索しなくても再使用できます。

最近使用したエンティティのリストからエンティティを取り出す手順は、次のとおりです。

以下のいずれかの操作を行って [XML ファインダ] を開きます。
- [ワークフロー変数を設定]、[XML をクライアントに送信]、[XML イベントをポスト]、または [例外ハンドラの呼び出し] アクションダイアログボックスで、[インポート] ボタンをクリックして XML ドキュメントを取り出します。
- [XPath Wizard] で [開く] ボタンをクリックします。
注意: [履歴] タブは、[XSL 変換] ダイアログボックスや、スキーマドキュメントを開くことのできるダイアログボックスでは使用できません。これらの操作により、実行時に XML ドキュメントインスタンスが作成されるからです。この場合、実行時に処理エンジンがファイルにアクセスできないため、最近使用したエンティティを指定するのは適切ではありません。
[XML ファインダ] ダイアログボックス内の [履歴] タブを選択します。ディスクファイルはファイル名と場所で識別され、リポジトリエンティティはエンティティ名で識別されます。
図7-8 [XML ファインダ] : [履歴] タブ
使用するエンティティを選択します。
（省略可能）エンティティのコンテンツを確認するには、[プレビュー] をクリックして [ドキュメントのプレビュー] ウィンドウを開きます。[OK] をクリックしてウィンドウを閉じます。
エンティティを元のダイアログボックスに戻すには、[OK] をクリックします。

リポジトリから取り出す

リポジトリからエンティティを検索する手順は、次のとおりです。

以下のいずれかの操作を行って [XML ファインダ] を開きます。
[XML ファインダ] ダイアログボックス内の [リポジトリ] タブを選択します。
XML エンティティを検索するフォルダを選択します。
図7-9 [XML ファインダ] : [リポジトリ] タブ
右側の一番上のパネルで、取り出すエンティティを選択します。
（省略可能）エンティティのコンテンツを確認するには、[プレビュー] をクリックして [ドキュメントのプレビュー] ウィンドウを開きます。[OK] をクリックしてウィンドウを閉じます。
エンティティを元のダイアログボックスに戻すには、[OK] をクリックします。

ファイルシステムから取り出す

ローカルディスクドライブ上のファイル、またはローカルマシンにマップされたあらゆるネットワークドライブから、コンテンツを検索できます。

ローカルファイルシステムからエンティティを取り出す手順は、次のとおりです。

以下のいずれかの操作を行って [XML ファインダ] を開きます。
- [ワークフロー変数を設定]、[XML をクライアントに送信]、[XML イベントをポスト]、または [例外ハンドラの呼び出し] アクションダイアログボックスで、[インポート] ボタンをクリックして XML ドキュメントを取り出します。
- [XPath Wizard] で [開く] ボタンをクリックします。
注意: [ファイル] タブは、[XSL 変換] ダイアログボックスや、スキーマドキュメントを開くことのできるダイアログボックスでは使用できません。これらの操作により、実行時に XML ドキュメントインスタンスが作成されるからです。この場合、実行時に処理エンジンがローカルファイルシステムにアクセスできないため、ローカルファイルシステム上にファイルを指定するのは適切ではありません。
[XML ファインダ] ダイアログボックス内の [ファイル] タブを選択します。
図7-10 [XML ファインダ] : [ファイル] タブ
[参照] フィールドに、XML エンティティを検索するドライブおよびフォルダを指定します。必要に応じて、[参照] フィールドの右にあるボタンを使用します。
ファイルのリストから、検索するエンティティを選択します。
（省略可能）エンティティのコンテンツを確認するには、[プレビュー] をクリックして [ドキュメントのプレビュー] ウィンドウを開きます。[OK] をクリックしてウィンドウを閉じます。
エンティティを元のダイアログボックスに戻すには、[OK] をクリックします。

URL から取り出す

URL を使って、ローカルマシン、ネットワーク上のリモートマシン、またはその他の外部システムの場所を指定できます。リモートマシンの場所は、ローカルマシン上のドライブにマップされている必要があります。

URL からエンティティを取り出す手順は、次のとおりです。

以下のいずれかの操作を行って [XML ファインダ] を開きます。
[XML ファインダ] ダイアログボックス内の [URL] タブを選択します。
図7-11 [XML ファインダ] : [URL] タブ
[URL] フィールドに、検索する XML エンティティのプロトコル、サーバ、パス、およびファイル名を含む完全な URL を入力します。
（省略可能）エンティティのコンテンツを確認するには、[プレビュー] をクリックして [ドキュメントのプレビュー] ウィンドウを開きます。[OK] をクリックしてウィンドウを閉じます。
エンティティを元のダイアログボックスに戻すには、[OK] をクリックします。

XML エンティティをエクスポートする

Studio で作成された XML ドキュメントは以下のダイアログボックスで保存できます。

[ワークフロー変数を設定]、[XML をクライアントに送信]、[XML イベントをポスト] および [例外ハンドラの呼び出し] の各アクションダイアログボックスでは、アクション内に作成した XML ドキュメントを、リポジトリまたはローカルファイルシステムに保存できます。保存したドキュメントは、別のワークフローアクション、ノード、またはテンプレート定義で再使用できます。
[ツール｜XML ファインダを表示] を選択すると、XML リポジトリに格納されている XML エンティティをファイルシステムにエクスポートできます。詳細については、リポジトリにあるエンティティの管理を参照してください。

アクションダイアログボックスからエクスポートされたドキュメントは、標準 XML エスケープシーケンス（"）でフォーマットされ、要素と属性の値は引用符で囲まれます。コンテンツ型ドキュメントでは、DOCTYPE を含むプロログ、および有効性を示すエピログも挿入されます。

リポジトリへエクスポートする

XML ドキュメントテンプレートをアクションダイアログボックスからリポジトリにエクスポートすると、エントリが 2 段階の手順で作成されます。最初に、空のエンティティが作成されます。次に、エンティティにドキュメントテンプレートのコンテンツが入力されます。このため、コンテンツが実際に入力されるまで、ドキュメントのプレビューは不可能です。コンテンツの入力は、XML ファインダの終了時に行われます。

アクションダイアログボックスのエンティティをリポジトリに保存する手順は、次のとおりです。