ロード・ファイル形式の要求

このトピックでは、要求アイテムのロードに使用されるMicrosoft Excelスプレッドシートの形式について説明します。

考慮事項

• スプレッドシート・ファイルの各ワークシートは、ビューポイントに対応しています。

• 複数のワークシートを複数のビューポイントにロードできます。

• ワークシート(および対応するビューポイント)では、30文字以下のラベルを使用する必要があります。

  注:

  ビューポイント名が30文字を超える場合、要求アイテムをビューポイントにロードする際、ワークシートに使用するラベルを作成する必要があります。ラベルの使用の詳細は、ビューポイントの検査を参照してください。

• スプレッドシートは、標準列のプロパティ値を導出するための式を含むことができます。スプレッドシートの式は、アプリケーション固有のプロパティ(FCGL、PLN)やカスタム・プロパティでも使用できます。式の値が空と等しいプロパティ・セルはスキップされます。式の値が<clear>または<blank>と等しいプロパティ・セルです。

• ワークシートは、左から右の順序で処理されます。

• インポート・ファイルで重複する行は、ロード時に処理されません。

• サポートされるロケールの日付とタイムスタンプは、次のJava日付形式パターンのいずれかである必要があります。

  • Short

  • Default

  • Long

  • Medium

  注:

  Java日時形式については、事前定義された形式の使用を参照してください。

• 10,000を超えるノードがある場合、10,000未満のノードを含む複数のロード・ファイルを作成します。

• 親が不明な階層ビューポイントに追加または挿入されたノードの場合は、「親」列で<Unknown>キーワードを使用して、親の値を計算し、要求アイテムごとに格納します。管理者は、親値を計算するための式を定義しておく必要があります。ノードの親の計算および保管を参照してください。

• 追加または挿入されるノードの名前を計算するには、名前列を空白のままにするか、<cn>キーワードまたは<cn ####>キーワードを使用します。ノードは、名前値を計算するように設定する必要があります。ノードの名前の計算および保管を参照してください。

列の考慮事項

• スプレッドシートには、予約された列名またはプロパティの名前と一致する列ヘッダーが必要です(予約された列名を参照)。

  注:

  名前列がない場合、シートをロードできません。

• プロパティの列ヘッダーは、プロパティ名またはプロパティのカスタム表示ラベル(設定されている場合。このオプションはビューポイント・インスペクタのプロパティ・タブで設定されます)で構成される必要があります。プロパティ名にネームスペースを含めることはできません。たとえば、Core.Descriptionは無効です。
• ロード・ファイルに代替名プロパティの列がある場合:
  • ロード先のノード・タイプに代替名プロパティが含まれる場合、ファイルのロード時に次の操作が実行されます:
    • 行にノード名が含まれる場合、代替名が代替名列にロードされます。
    • 行にノード名が含まれない場合、代替名を使用して、代替名プロパティ値が同一の一致するノードがビューポイントで検索されます。

  • ロード先のノード・タイプに代替名プロパティが含まれない場合、列は無視されます。

• 列の順序は任意です。
• 列のヘッダーが予約された列名またはプロパティ名と一致しない場合、その列は無視されます。つまり、スプレッドシートにはロードされないコメントを含めることができます。

行の処理順序

要求ファイルからレコードをロードする際、親ノードが子ノードより先にビューポイントに追加されるように、ロード・プロセスによってファイル・コンテンツがソートされます。これにより、ロード・ファイルで子ノードの行がその親ノードの行より前にある場合に、検証エラーを回避します。

たとえば、次のロード・ファイルでは、親の行Analyticsがあり、ファイル内でそれよりも前に2つの子の行EmilyおよびJackがあり、その両方がAnalyticsを親としています:

このファイルがロードされると、Analyticsが最初に追加され、次にEmily、JackおよびMaryが追加されるように、ロード・プロセスによりコンテンツがソートされます。

<Blank>および<Clear>処理と空のフィールド

要求ロード・ファイルに<blank>または<clear>キーワードを入力する場合と、セルを空のままにする場合とでは、要求ファイルの処理時に異なる処理が実行されます:

• <clear>キーワードにより、既存の値がプロパティからクリアされます。
• <blank>キーワードにより、空白の定義済のプロパティ値が設定されます。
• ファイル内の空のセルは無視されます。

<blank>および<clear>キーワードと空のセルはすべてのデータ型でサポートされています。ただし、リスト・データ型の場合、リスト内の空白エントリはサポートされません。つまり、リスト自体は空にできますが、リスト内のエントリは空にできません。

次に例を示します:

• リスト値: '<blank>'はサポートされます。リストに空白をインポートすると、リスト内の既存の定義済値、継承値またはデフォルト値が上書きされることに注意してください。
• リスト値: 'A,B,C'はサポートされます。
• リスト値: 'A,,C'はサポートされません。

予約された列名

考慮事項

• プロパティが予約された列と同じ名前を持つ場合、代替列名を使用できます。サポートされる代替名は、以下を参照してください。

• スプレッドシートがリストのビューポイントにロードされる場合、階層の列とアクションは無視されます。たとえば、移動および挿入アクションはリスト・ビューポイントで無視されます。

表10-2 アクション・コード

アクション・コード	説明
Add	新しいノードを作成します。
Delete	ノードを削除します。
<Empty cell>	Action Codeセルが空の場合、行はUpdateアクション・コードを使用して処理されます。
Insert	既存のノードを、階層のParentおよびParent Node Typeセルで指定されたノードの下に挿入します。
Move	既存のノードを階層の新しい位置に移動し、ノードを既存の位置から除去します。
Prop_Update	既存のノードのプロパティ値のみを更新します。他のアクションを実行するにはUpdateアクション・コードを使用します。 定義済みプロパティのプロパティ値をクリアできます。プロパティ値をクリアすると、格納値が削除され、値はデフォルト値または継承値に戻ります。たとえば、下のProp_Updateアクションは説明値をクリアします。
Rename	既存のノードの名前を変更します。
Reorder	階層ビューポイントのノードを並べ替えます。 ノードを並べ替えることができるのは、そのタイプのノード(親または最下位ノード)の並替えを許可する階層セットを使用するビューポイントのみです。詳細は、ノードの並替えを参照してください。
Remove	ノードを指定した親ノードから除去します。
Update	既存のノードのプロパティ値を更新します。 このようなアクションが必要であることを行のセルが示している場合、Updateアクションで追加アクションも実行されます。次に、この仕組みについて説明します。 ノードが存在しない場合、ノードが追加されます。ビューポイントが階層である場合、ParentおよびParent Node Typeセルで指定された階層の位置にノードが挿入されます。 ビューポイントが階層で、ノードは存在するが指定した親の下にない場合、実行されるアクションは、階層セットで共有ノードが許可されるかどうかに依存します。 共有ノードが許可される場合、ノードは指定した親の下に挿入されます。 共有ノードが許可されない場合、ノードは指定した親の下に移動されます。 プロパティで空白が許可される場合、プロパティを空白値に更新できます。セルで<空白>インジケータを使用する必要があります。空のセルは、同じ結果を生成しません。 たとえば、下の更新アクションは、法的エンティティ・プロパティを空白値に設定します。説明のセルが空白であっても、EMAの既存の説明は変更されません。