スプレッドシート・テンプレート設計

スプレッドシート・テンプレートの作成は、5ステップのプロセスです。次のようにします。

テンプレートの一般情報を定義します。
テンプレートのコンテンツとレイアウトを設計します。
必要に応じて、インストラクション・テキストを指定します。
作成、アップロードなどのデータ・セット操作を実行できるロール、およびテンプレートを保守できるロールを識別します
設計をレビューし、テンプレートからテスト・スプレッドシートを生成します。

このトピックでは、このプロセスの設計ステップについて説明します。

「使用可能属性」パネル

「使用可能属性」パネルには、オブジェクトの選択したコンポーネントのすべての属性がリストされます。次のことが可能です。

「表示」フィールドを設定して属性をフィルタします。
別のコンポーネントまたはすべてのコンポーネントを選択します。
ツリー・ビューに切り替えて、コンポーネント階層を表示します。オブジェクトのコンポーネントごとに、属性、フレックスフィールド属性および子コンポーネントの個別のエントリが階層に表示されます。
属性名をクリックして、属性詳細を表示します。
属性を「使用可能属性」パネルから「選択済属性」パネルに移動します。最初の属性を移動すると、コンポーネントの必須属性が自動的に「選択済属性」パネルに移動します。条件付きで必須の属性は移動しません。それらの属性を含めるには明示的に追加する必要があります。

ノート:

「使用可能な属性」パネルに、同じ名前の属性が2つ表示される場合があります。通常、外部オブジェクト参照の場合にこのような重複が発生します。これにより、自由形式テキストを入力するか、値リストから値を選択するかを選択できます。それぞれの名前の前のアイコンに属性タイプが表示されます。

「選択済属性」パネル

「選択済属性」パネルには、属性が追加した順に表示されます。次のことが可能です。

属性の詳細を編集します。たとえば、次のことが可能です。
- 列の見出しを変更します。
- オプションの値を必須にします。
- デフォルト値を指定します。また、デフォルト値を持つ属性など、属性を読取り専用にすることもできます。
- 生成されたスプレッドシートに属性が表示されるかどうかを指定します。
- オプションの属性を無効にします。これらの属性は表示されますが、更新できません。
- 生成されたスプレッドシートにヘルプ・テキストとして表示する摘要を入力します。
- 属性を検証する値リストを構成します。
「ノート」属性を作成します。「ノート」属性を使用して、値リストからの値を情報のみを目的として返します。たとえば、この属性に個人番号を返すPersonNumber属性の値リストがあるとします。これは、「ノート」列でユーザーの姓と名を返すこともできます。「ノート」列を読取り専用にすることができ、複数の「ノート」列に同じ値リストから値が返されるようにできます。「ノート」列のデータはアプリケーションに渡されませんが、情報目的または複数のコントリビュータ間での連携のためにデータ・セットで使用できます。

「ノート」属性を使用して、アップロードする必要がない情報を伝えることもできます。たとえば、人事担当者が対処を求めるために給与管理者に対してスプレッドシートで超過勤務情報を送信している場合があります。
属性の順序を変更します。非表示の属性があるかどうかを判別した後、「順序変更」アイコンをクリックして「属性の順序変更」ダイアログ・ボックスを開きます。
コンポーネントを複製します。このオプションは、「個人電話番号」や「事業所国別仕様その他情報」など、1つのオブジェクトに複数回出現する可能性のあるコンポーネントのために用意されています。

ヒント:
追加インスタンスを作成する前に、コンポーネントの選択済属性を編集します。

ノート: 複製できるのは、子コンポーネントがないオブジェクト階層の最下部にあるコンポーネントのみです。

「選択済属性」パネルに属性を追加すると、次の属性の一部が自動的に追加されます:

属性の選択元レコードを一意に識別するために使用される属性。
子オブジェクトから属性を選択するときに親レコードを一意に識別する属性。
子オブジェクトの選択済属性を複製するか、別の子オブジェクトの属性を含める場合は、親レコードの属性。

ノート: 異なる子オブジェクトまたは複製した子オブジェクトにデータを入力する場合は、親オブジェクトの属性を含めることが重要です。親レコードによってすべての関連データがグループ化されて、スプレッドシート行が確実に一緒にロードされます。

拡張設定

すべての属性を一度に管理するには、「属性定義の拡張オプション」アイコンをクリックします。「属性定義の拡張オプション」ページでは、次のものを管理できます。

基本情報、フレックスフィールド属性および値リスト。
属性キー。データをファイルからスプレッドシートにインポートする場合は、ヘッダーを含めることができます。インポート・ファイルで使用されている属性名は、スプレッドシートでの名前とは異なる場合があります。この場合、「属性キー」フィールドには、インポート・ファイルから名前を含める必要があります。たとえば、事業所コードをその呼称が事業所IDであるファイルからスプレッドシートにインポートできます。データが確実に正常にインポートされるようにするには、「属性キー」の値を「事業所コード」属性の「事業所ID」に設定する必要があります。