LotusScript で XML を使用する

NotesXMLProcessor 基本クラス

NotesXMLProcessor クラスは、XML を処理する LotusScript クラスの基本クラスです。この基本クラスを直接使用することはありませんが、そのプロパティとメソッドをほかの XML クラスで使用できます。

NotesXMLProcessor のプロパティは次のとおりです。

• ExitOnFirstFatalError (読み書き可能、論理値) が True の場合、致命的なエラーが発生したら処理を終了します。
• Log (読み込み専用、文字列) には、プロセッサによって生成されたエラーが含まれます。
• LogComment (読み書き可能、文字列) は、ログの先頭に追加されるコメントです。

NotesXMLProcessor のメソッドは次のとおりです。

• SetInput は、XML 処理の入力を指定します。
• SetOutput は、XML 処理の出力を指定します。
• Process は、XML データ変換を開始します。

複数の XML プロセスで基本プロパティとメソッドしか使用しない場合は、サブルーチンを 1 つ使用することでプログラムを簡素化できます。例えば、処理を開始してからログを検査するサブルーチンを 1 つ作成します。サブルーチンを呼び出すたびに、パラメータとして適切な XML オブジェクトを指定します。

パイプライン

パイプラインを使用すると、複数の操作を組み合わせて、ある XML プロセスの出力を別の XML プロセスの入力にすることができます。例えば、Domino データを DXL として書き出し、それを既知の XML の語彙に変換し、さらに XML を HTML に変換する標準アプリケーションを適用するとします。各プロセスは、次のプロセスにその出力を渡します。そのとき、中間の結果を保存するのではなく、パイプラインを使用して結果を渡します。

XML プロセッサは、処理前に入力と出力を指定する必要があります。その指定は、XML オブジェクトの作成時、または後から SetInput と SetOutput を使用して行います。処理は、Process を使用して開始します。

パイプラインを使用するには、入力または出力を XML プロセッサとして指定します。例えば、書き出された DXL を DOM 処理に流し込む場合、NotesDXLExporter オブジェクトの出力が NotesDOMParser オブジェクトになるように指定するか、 NotesDOMParser オブジェクトの入力が NotesDXLExporter オブジェクトになるように指定します。処理を開始する前に、パイプラインのすべてのオブジェクトの入力と出力を指定します。パイプラインの先頭のプロセッサで処理を開始すると、後続のすべてのプロセッサの処理が開始されます。

パイプラインを簡単に設定するには、パイプラインの最後のプロセッサ以外のすべてのプロセッサの入力だけを指定します。最後のプロセッサに対しては、入力だけでなく出力も指定します。

次の表に、XML プロセッサで使用できる入力と出力を示します。

DXL の書き出しと呼び出し

NotesDXLExporter class クラスは、Domino データを DXL に変換します。NotesSession で CreateDXLExporter メソッドを使用して、NotesDXLExporter オブジェクトを作成します。書き出しプロセスへの入力としては、NotesDatabase、NotesDocument、NotesDocumentCollection、NotesNoteCollection の各オブジェクトを使用できます。出力としては、NotesStream オブジェクトまたは NotesRichTextItem オブジェクト、あるいはほかの XML プロセッサのいずれかを使用できます。

書き出しを開始するには、Process または Export を使用します (パイプラインなし)。

NotesDXLExporter クラスには、次のプロパティがあります。

NotesDXLImporter クラスは、DXL を Domino データに変換します。NotesSession で CreateDXLImporter メソッドを使用して、NotesDXLImporter オブジェクトを作成します。呼び出しプロセスの入力としては、文字列、NotesStream オブジェクトまたは NotesRichTextItem オブジェクト、あるいはほかの XML プロセッサのいずれかを使用できます。出力は NotesDatabase オブジェクトです。

呼び出しプロセスは、新しく呼び出された文書の文書 ID のリストを作成します。これらの文書 ID には、GetFirstNoteId メソッドと GetNextNoteId メソッドを使用してアクセスできます。

呼び出しを開始するには、Process または Import を使用します (パイプラインなし)。

NotesDXLImporter クラスには、次のプロパティがあります。

XSLT を介して DXL データを変換する

XSLT を介して DXL データを変換するには:

• NotesSession で CreateXSLTransformer メソッドを使用して、NotesXSLTransformer オブジェクトを作成します。
• CreateXSLTransformer か Transform の input パラメータ、または SetInput メソッドを使用して、入力する DXL データを指定します。
• CreateXSLTransformer の output パラメータ、Transform の戻り値、SetOutput メソッドを使用して、出力する DXL データを指定します。
• CreateXSLTransformer か Transform の styleSheet パラメータ、または SetStyleSheet メソッドを使用して、 XSL スタイルシートを指定します。
• Process または Transform を使用して、変換を開始します。
• AddParameter メソッドを使用してパラメータを追加します。

NotesXSLTransformer クラスには、次のプロパティがあります。

XML データを DOM ツリー構造に解析する

XML を NotesDOMNode オブジェクトの標準 DOM ツリー構造に解析するには:

• NotesSession で CreateDOMParser メソッドを使用して、NotesDOMParser オブジェクトを作成します。
• CreateDOMParser か Parse の input パラメータ、または SetInput メソッドを使用して、入力する XML データを指定します。
• CreateDOMParser か Parse の output パラメータ、または SetOutput メソッドを使用して、出力する XML データを指定します。
• Process または Parse を使用して、DOM ツリーに入力される XML を解析し、 PostDOMParse イベントを開始します。
• Output メソッドを使用して、指定された出力オブジェクトにテキストを出力します。
• Serialize メソッドを使用して、作成された XML を DOM パーサーの出力オブジェクトにコピーします。

NotesDOMParser クラスには、次のイベントがあります。

NotesDOMParser クラスには、次のプロパティがあります。

次に示す特定の NotesDOMNode クラスのメソッドを使用して、DOM ツリーのデータにアクセスします。

• AppendChild メソッド
• Clone メソッド
• RemoveChild メソッド
• ReplaceChild メソッド

XML データを一連のイベントとして解析する

SAX パーサーを使用して XML を解析するには:

• NotesSession で CreateSAXParser メソッドを使用して、NotesSAXParser オブジェクトを作成します。
• CreateSAXParser か Parse の input パラメータ、または SetInput メソッドを使用して、入力する XML データを指定します。
• CreateSAXParser か Parse の output パラメータ、または SetOutput メソッドを使用して、出力する XML データを指定します。
• Process または Parse を使用して、解析を開始します。
• Output メソッドを使用して、指定された出力にテキストを出力します。

NotesSAXParser クラスには、次のイベントがあります。

NotesSAXParser クラスには、次のプロパティがあります。