• NotesXMLProcessor は、すべての XML クラスに共通のプロパティとメソッドを含む基本クラスです。
• NotesDXLExporter および NotesDXLImporter は、Lotus Domino と DXL (Domino XML) の間で、データを変換します。
• NotesXSLTransformer は、XSLT を介して DXL を変換します。
• NotesDOMParser は、XML を解析して標準 DOM (Document Object Model) ツリーを構築します。DOM ツリーを操作するには、NotesDOM のその他のクラスを使用します。
• NotesSAXParser は、SAX (Simple API for XML) パーサーを使用して、イベントとして XML を処理します。

• NotesStream は、メモリバッファやファイルに、またはメモリバッファやファイルから、XML をストリーミングします。
• NotesNoteCollection は、NotesDXLExporter 用に Lotus Domino データベースのサブセットを構築します。

メモ COM インターフェース:

• NotesDXLExporter、NotesDXLImporter、NotesStream、および NotesNoteCollection のみサポートします。
• パイプラインはサポートしません。
• ExitOnFirstFatalError、Log、および LogComment プロパティを NotesDXLExporter および NotesDXLImporter に直接実装します。
• DXLExporter に Export を、DXLImporter に Import を、Process、SetInput、SetOutput、および CreateDXLExporter と CreateDXLImporter に渡されるパラメータの代わりに実装します。

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

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

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

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

パイプライン

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

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

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

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

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

プロセッサ	使用できる入力オブジェクト	使用できる出力オブジェクト
NotesDXLExporter	NotesDatabase NotesDocument NotesDocumentCollection NotesNoteCollection	NotesStream NotesRichTextItem NotesDXLImporter NotesDOMParser NotesSAXParser NotesXSLTransformer
NotesDXLImporter	String 型 NotesStream NotesRichTextItem NotesDXLExporter NotesDOMParser NotesSAXParser NotesXSLTransformer	NotesDatabase
NotesDOMParser NotesSAXParser NotesXSLTransformer	String 型 NotesStream NotesRichTextItem NotesDXLExporter NotesDOMParser NotesSAXParser NotesXSLTransformer	NotesStream NotesRichTextItem NotesDXLImporter NotesDOMParser NotesSAXParser NotesXSLTransformer

DXL の書き出しと呼び出し

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

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

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

プロパティ	データ型	説明
ConvertNotesBitmapsToGIF	Boolean 型	(読み書き可能) True の場合、Lotus Domino ビットマップを GIF 形式に変換します。
DoctypeSYSTEM	String 型	(読み書き可能) !DOCTYPE ステートメントの SYSTEM の値。
ForceNoteFormat	Boolean 型	(読み書き可能) False の場合は、フォーマット済みの DXL を書き出します。
OutputDOCTYPE	Boolean 型	(読み書き可能) False の場合は、!DOCTYPE ステートメントを非表示にします。
SchemaLocation	String 型	(読み書き可能) 書き出される DXL のスキーマの URI。
ValidationStyle	Integer 型	(読み書き可能) 書き出される DXL を評価するためのメソッド。

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

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

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

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

プロパティ	データ型	説明
ACLImportOption	Integer 型	(読み書き可能) 呼び出す ACL エントリの処理を示します。
CreateFTIndex	Boolean 型	(読み書き可能) ターゲットデータベースに全文索引が作成されているかどうかを示します。
DesignImportOption	Integer 型	(読み書き可能) 呼び出す設計要素の処理を示します。
DocumentImportOption	Integer 型	(読み書き可能) 呼び出す文書の処理を示します。
ImportedNoteCount プロパティ	Long 型	(読み込み専用) 呼び出した文書の数です。
InputValidationOption	Integer 型	(読み書き可能) XML 宣言ステートメントで指定された DTD を使用して、入力 XML を評価するかどうかを示します。
ReplaceDbProperties	Boolean 型	(読み書き可能) True の場合は、DXL からのデータベースプロパティを置換します。
ReplicaRequiredForReplaceOrUpdate	Boolean 型	(読み書き可能) True の場合、DXL のレプリカ ID とターゲットデータベースがマッチする必要があります。
UnknownTokenLogOption	Integer 型	(読み書き可能) エラーログの記録オプションを示します。

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 メソッドを使用してパラメータを追加します。

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 パーサーの出力オブジェクトにコピーします。

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

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

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

用語集