Page tree

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Sv translation
languageja

Teamstudio Exportのアーカイブファイルは独自のAPIやツールを必要とせずにシンプルにアクセスできるように設計されています。アーカイブ内の全てのファイルは、XMLまたは平文のいずれかのテキスト形式になっています。これらのファイルは、一般のZip圧縮を使用して一つのファイルに統合されています。

ディレクトリ構造

アーカイブファイルを調べる最も簡単な方法はzip拡張子を追加して、Windowsエクスプローラーでファイルを開くことです。

データフォルダ

データフォルダには、データベース内の全てのデータ文書ファイルが含まれています。各ファイルがIBMのDXL形式に基づいたXMLになっています。そのままの状態で大部分は理解できますが、一方でDXLのためのDTDもDomino DTDから入手することができます。各ファイルの名前は<文書ID>.dxlとなっており、8桁の16進数で表示されます。

デザインフォルダ

デザインフォルダはデータフォルダと同じ形式であり、Notes IDによって名付けされているデザイン要素のDXLファイルも含みます。

Info

Dominoはバイナリとデフォルト、二種のDXLスタイルを持つことを可能にしています。どちらも標準的なテキストベースのXMLですが、バイナリモード内において複雑なデータ値はnsfファイルに格納されている生のバイナリデータのBase-64エンコードバージョンでエクスポートされます。Teamstudio Exportではバイナリモードを使用しません、なぜなら高い正確性をもたらす一方で、ドミノ内部のデータ構築に関する深い知識なしに読み取ることは不可能だからです。その代わりに、Teamstudio Exportは複雑なデータ値でも人間が読めるXML要素に変換するデフォルトモードを使用しています。この形式ではアーカイブでは解釈できないバイナリデータを全て保持しますが 、一方でデータの一部分が消失する可能性は極僅かです。また作業環境下で最新バージョンのNotesを使用することで、XMLの詳細が消える可能性を軽減することができます。

プロファイルフォルダ

プロファイルフォルダはデータフォルダと同じ形式であり、Notes IDによって名付けされているプロファイル文書のDXLファイルも含みます。

Info

プロファイルフォルダはアーカイブ、バージョン2にて追加されました。

ビュー

ビューフォルダには、 データベース内すべてのビューとフォルダに対してのXMLファイルが含まれています。データやデザインのフォルダとは異なり、ビューデータにはIBM基準というものがありません。実際のフォーマットは、以下の要素を持つ非常に単純なUTF-8エンコードされたXMLです。

ビュー

文書、カテゴリーそしてトータル要素の並びを持つルート要素です。

カテゴリー

ビュー内にあるカテゴリー行に対応するコンテナ要素です。単一でオプションの属性を持ち、行の中のカテゴリーされた値がどれほどのスペースを持つかを識別しカラム内でインデントされます。この属性を省略すると、値はインデントされません。インデントカテゴリーはa\bのような値がコラムに含まれている場合に発生し、これによりビューに2つのカテゴリー行が生成されます。最初の値(a)のインデントは0となり、2つめの値(b)のインデントは1になります。カテゴリー要素には値要素の順序も含まれます。

文書

ビュー内の文書の行に対応するコンテナ要素です。すべての文書要素には文書にある8桁で16進数のNote IDを特定するためのNote ID属性があります。カテゴリーと同様、オプションとしてインデント属性もあり、最後のデータ値をそのコラム内でインデントする必要があるスペースの数を指定しています。インデントされた文書はレスポンス文書による階層表示を使用しており、文書がレスポンス文書、またはレスポンスに対するレスポンス文書である場合に発生します。文書要素には値要素の順序も含まれます。

合計

ビューの合計(または平均、ビュー定義に依存します)を含むコンテナ要素です。合計要素には一連の値要素が含まれます。

ビューコラム値のラッパーです。各カテゴリー、文書、およびトータル要素には、列値の1つ、またはそれ以上の値要素が含まれています。それ以外の場合は、標準DXL形式の値がそのまま含まれます。 (例. <text>, <number>, など.)

acl.dxl

ACLデータベースのDXLの表現となる

Info

ACLはアーカイブ、バージョン2から追加されます。

db.dxl

このファイルは、データベースから空のコレクションをエクスポートするDXLによって作成されます。レプリカIDなどのデータベースレベルの情報を取得します。

log.txt

DXLエクスポート時に生成される平文のログファイルです。エクスポート時に生成されたエラーと警告、およびデバッグ情報のトーレスをします。このファイルエラーや警告はアーカイブ作成時にユーザーに表示されますが、将来のもしもの時の参照のためにログファイルを保持します。

Info

log.txtは、アーカイブバージョンが3以降ではUTF-8としてエンコードされています。以前のバージョンでは、 お使いのPC設定によるものとLMBCSが混在しているため、エンコーディング面で一貫性がありませんでした。

meta.xml

主にチームスタジオがUIを維持するために使用するメタデータファイルです。以下の属性を持つた単一のアーカイブ要素で構成されています。

  • server - データベースがアーカイブされたサーバー
  • path - そのサーバー上のデータベースのパス
  • title - データベースのタイトル
  • archiveDate - アーカイブ日付 アーカイブが作成したタイムスタンプ。これはTeamstudio Exportでのみ使用されるため、.NET対応の形式で保存されます。具体的には、値は1/1/0001 00:00 グレコリオ歴からで10msずつ刻みます。.NETDateTime(System.DateTimeを参照)と同じ起点ですが、Notesは10msで時刻を格納するだけなので、DateTime.Ticks100000で割って100nsから10msへと変換しています。
  • archiveVersion - アーカイブバージョン – アーカイブの形式についての重要な変更を示すバージョンのインジケーターになります。現在は「2」に設定されています。将来的なリリースでは、アーカイブバージョンを使用して再アーカイブする必要のあるデータベースが特定できます。下記のアーカイブバージョン履歴(アーカイブバージョン履歴)をご覧ください。
  • demoMode - デモモードこちらはオプションになります。各ビューの入力数を制限するエクスポートのデモバージョンを使用してアーカイブを生成する場合はTrueに設定します。Falseまたは省略された場合は、アーカイブはエクスポート完全版で生成されたことを意味します。

unidindex.txt

これは、Note IDUniversalNoteID(UNID)にマップするためにエクスポート中に作成される平文のCSVファイルです。Teamstudio Export自体は文書IDを利用して文書を識別しますが文書リンクはUNIDを使用するためHTMLエクスポート中にUNIDをファイル名に変換するための索引が必要です。

Anchor
versions
versions
アーカイブバージョン履歴

NumberDate

Export Version

Comments
11月 20181.0.0初期リリース
22月 20181.0.1データベースACLおよびプロファイル文書のサポートを追加

サポート

アーカイブファイル形式は公的にサポートされています。ファイル形式に関する質問は、teamstudio.comまでお問い合わせください