XML ファイルコンテンツの定義
XML ファイルは 1 つしかロードできません。ただし、1 つのファイルに複数の連続を含めることができます。ファイルに複数の連続がある場合、それぞれの連続は一意の名前である必要があります。たとえば、以下の XML ファイルでは 2 つの連続が定義されています。
<?xml version="1.0" encoding="UTF-8"?>
<scheme>
<series name = "name1">
<value>P1</value>
<value>P2</value>
<value>P3</value>
</series>
<series name = "name2">
<value>A_1</value>
<value>A_3</value>
<value>A_5</value>
</series>
</scheme>
このセクションで定義しているとおり、バージョン管理をファイルベースのバージョン管理に設定する既成のオブジェクト初期化規則はありません。ロードするファイルを使用するファイルベースのハーバードシリーズを作成して、そのシリーズを 1 つ以上のバージョン管理のオブジェクト初期化規則に指定できます。
XML ファイルでは、ピリオド (.) またはアットマーク (@) 以外の英数字を連続名に使用できます。XML ファイルで指定するシリーズ名は、バージョン管理規則の引数で使用する名前を生成するために wt.series.HarvardSeries に追加する必要がある名前です。たとえば、シリーズ名が name1 の場合、含める引数は wt.series.HarvardSeries.name1 となります。
<value> 要素の値は、以下の条件を満たす一意の値のセットにすることができます。
• それぞれの値で指定できる文字数に上限はありませんが、文字数の多い値を使用すると、オブジェクト名が表示先のユーザーインタフェースフィールドよりも長くなる場合があります。
• 値を空にすることはできません。少なくとも 1 つの空白以外の文字を含んでいる必要があります。
• wt.properties wt.series.HarvardSeries.delimiter プロパティで定義されている連続の区切り記号を値に含めることはできません。デフォルトの連続の区切り記号はピリオド (.) です。
• 空白はリビジョンラベルの中では使用できません。
• リビジョンラベルに指定する値は、連続全体の中で一意である必要があり、同じ値を複数回指定することはできません。ただし、1 つの連続に含まれている値を別の連続で使用することはできます。
ファイル内の値の順序によって、オブジェクトの改訂時にバージョン指定子として使用される値の順序が決まります。
|
XML バージョン化ファイルを通じて設定されたファイルベースのバージョン化の値は修正できます。ただし、すべての変更は、バージョン化を使用する前に実行する必要があります。すでに使用されている値を変更すると、バージョンの更新時に予期しない結果が発生する場合があります。バージョン管理スキームを変更する必要がある場合は、リビジョンラベルに指定する値がバージョン管理スキーム全体で一意であることを確認します。また、すでに使用されているシリーズから値を除去しないでください。ただし、 リビジョンラベルのレガシー値の調整で説明されているように、新しいリビジョンラベルに使用しない値のレガシー属性を含めることはできます。同じ値を複数回指定することはできません。また、すでに使用された連続の名前を除去すると、その連続を使用する既存のオブジェクトで問題が生じます。たとえば、それらのオブジェクトは改訂できず、オブジェクトの作業版数履歴を表示できなくなります。
|
このシリーズの作成方法の詳細については、
ファイルベースまたは状態ベースのバージョン化スキームの設定を参照してください。