参照番号テンプレート

ユーザーは、一意の参照番号を生成するためのテンプレートを設定できます。参照番号テンプレートは、静的なテキストと、doc type、WBS、discipline などのドキュメントのメタデータから取得する動的フィールドを、自動的に増加するシーケンシャルイテレーターと組み合わせたものです。このイテレーターにより、2つのドキュメントが同じ参照番号を持つことがないよう保証されます。

参照番号テンプレートは、New > New Reference Numberから独立した再利用可能な名前付きテンプレートとして作成することも、レコードの Reference Number Generation セクションに直接記述することもできます。テンプレートの作成に使用する Jinja 構文は、フローティングツールバーから確認できます。

この機能を設定するユーザー

Newモジュールにアクセスできるユーザー。再利用可能なテンプレートはNew > New Reference Numberから管理し、レコード内で使用するテンプレートはNew > Custom Fields & Configuration > Manage Recordsから設定します。

再利用可能な参照番号テンプレートの作成

New > New Reference Numberを開くと、Generate New Reference Numberダイアログが表示されます。このダイアログでは、個々のレコードとは独立して、名前付きの再利用可能な参照番号テンプレートの一覧を管理できます。

コントロール	説明
Template	保存済みの参照番号テンプレートを一覧表示するドロップダウンです。
Add	新しいテンプレートを作成するためのAdd Jinja Templateダイアログを開きます。
Edit	選択したテンプレートを編集用にAdd Jinja Templateダイアログで開きます。テンプレートが選択されるまで無効化されています。
Delete	選択したテンプレートを削除します。テンプレートが選択されるまで無効化されています。

Add（既存のテンプレートの場合はEdit）をクリックすると、Add Jinja Templateダイアログが開きます。

フィールド	説明
Template Name	テンプレートが保存され、一覧に表示される際の名前です。
Template String (Jinja)	テンプレート文字列です。静的テキスト、動的な Jinja フィールド、$DW_SEQ_XXXXX$ シーケンシャルイテレーターを、以下のサンプルと同じ構文で組み合わせます。

再利用可能な参照番号テンプレートの作成手順

手順	説明
1	New > New Reference Numberに移動します。
2	Addをクリックします。
3	Template Nameを入力します。
4	静的テキスト、動的な Jinja フィールド、$DW_SEQ_XXXXX$ イテレーターを組み合わせて**Template String (Jinja)**を入力します。
5	Createをクリックします。

参照番号テンプレートのサンプル

DRG-{{document.doc_type}}-{{locations[0].Code}}-STATIC-$DW_SEQ_XXXX$

フィールド	説明
DRG	静的な値です。生成されるすべての参照番号でそのまま表示されます。
{{document.doc_type}}	動的フィールドです。生成時にそのドキュメントの doc type に置き換えられます。
{{locations[0].Code}}	動的フィールドです。最初の location のコードに置き換えられます。
STATIC	静的な値です。生成されるすべての参照番号でそのまま表示されます。
$DW_SEQ_XXXX$	シーケンシャルイテレーターです。各ドキュメントに一意の番号を生成します。X の文字数によってゼロパディングの桁数が決まります（XXXX は 0001、XXX は 001 を生成します）。

Record Editor

参照番号フィールドは、Record Editor（New > Custom Fields & Configuration > Manage Recordsからアクセス）内のReference Numberセクションを通じて、レコードテンプレートに追加します。

Edit Record — レコードの他のセクションと並ぶ Reference Number セクション

フィールド	説明
Record Name	レコードテンプレートの名前です。
Allowed Groups	このレコードテンプレートを使用できるグループを制限します。
Record Group	このレコードテンプレートを、整理のために関連するテンプレートとグループ化します。
New Section Name	レコード内の新しいセクションの名前です（例：「Reference Number Generation」）。
New Section Type	新しいセクションのタイプです。参照番号フィールドを追加するにはReference Numberを選択します。
View Live Preview	現在の設定に基づいたレコードテンプレートのライブプレビューを表示します。
Save Changes	レコードテンプレートを保存します。

Reference Number セクションを展開すると、テンプレートを指定する2つの方法が表示されます。保存済みのテンプレートを選択する方法と、直接入力する方法です。

Reference Number Generation セクション — 展開表示

フィールド	説明
Existing Reference Number Templates	New > New Reference Numberで作成したテンプレートを選択します。
Reference Number Template String	テンプレート文字列です。上記で既存のテンプレートが選択されているかどうかにかかわらず、このレコード用に静的テキスト、動的な Jinja フィールド、$DW_SEQ_XXXX$ イテレーターを直接記述します。

Existing Reference Number Templates — ドロップダウンを開いた状態

レコードへの参照番号生成の追加手順

手順	説明
1	New > Custom Fields & Configuration > Manage Recordsに移動します。
2	Create New Recordをクリックします（既存のレコードの場合は鉛筆アイコン）。レコード名を入力し、必要に応じて Allowed Groups と Record Group を設定します。
3	参照番号の動的な値として使用するメタデータフィールド（doc type、WBS、discipline など）を追加します。
4	New Section Nameに参照番号フィールドの名前を入力します（例：「Reference Number Generation」）。New Section TypeでReference Numberを選択します。Addをクリックしてセクションを挿入します。
5	セクションのオプションを展開します。Existing Reference Number Templatesから保存済みのテンプレートを選択するか、静的テキスト、動的な Jinja フィールド、$DW_SEQ_XXXX$ イテレーターを組み合わせてReference Number Template Stringに直接テンプレートを入力します。各要素の間にはダッシュ（-）を入れてください。
6	Save Changesをクリックします。

参照番号の生成手順

手順	説明
1	Newに移動し、該当するレコードテンプレートを選択します。
2	レコード内の必須メタデータフィールドを入力します。
3	Saveをクリックします。確認ダイアログに生成された参照番号が表示され、コピー、ダウンロード、またはそのドキュメントの詳細への移動が可能です。

トラブルシューティング

問題	詳細
参照番号が一意でない	テンプレート文字列に $DW_SEQ_XXXX$ イテレーターが含まれていることを確認してください。含まれていない場合、ドキュメントに同じ参照番号が付与されることがあります。
動的フィールドが空になる	テンプレートで参照しているメタデータフィールド（例：{{document.doc_type}}）がドキュメントに入力されていない可能性があります。生成前に必須フィールドが入力されていることを確認してください。
テンプレート文字列が保存されない	テンプレート文字列を入力する前に、Reference Numberセクションタイプが選択され、セクションが追加されていることを確認してください。
連番のゼロパディングが正しくない	$DW_SEQ_XXXX$ の X の文字数を調整して、パディングの桁数を変更してください。
Existing Reference Number Templates ドロップダウンが空である	再利用可能なテンプレートがまだ作成されていません。先にNew > New Reference Numberからテンプレートを作成してください。

関連する設定

• カスタムフィールド — 参照番号フィールドの動的な取得元として使用されるカスタムフィールドテンプレート
• フローティングツールバー — テンプレート文字列を作成するための Jinja 構文リファレンス