アプリケーションでリファレンス データを作成して保存できます。リファレンス データ アプリを使用すると、リポジトリを作成して、ユーザーがスキーマを定義し、リファレンス データを保存し、リファレンス データを更新できます。詳細については、「リファレンス データの使用」を参照してください。
リファレンス データは、参加者のリストにすることができます。また、ルックアップ データ (ドロップダウン リストの作成用)、処理 データ、または処理間データの場合もあります。リファレンス データは、ビジネス 処理を構築するために外部データを必要とするフォームまたは Excel ソリューションで参照されます。
リファレンス データをフォームまたは カスタム Excel ソリューションで使用するには、ソリューション設計者は最初にデータ接続を作成し、次にそのデータ接続をソリューション内で使用します。データ接続のリファレンス データ型を作成する方法の詳細については、「 データ接続 」ページを参照してください。
アプリの範囲
リファレンス データ ソリューションは、ローカルまたはグローバルにすることができます。
ローカル – ローカル リファレンス データは、特定のアプリのリファレンス データ ライブラリで定義されており、その特定のアプリのソリューションでのみ使用できます。
グローバル – グローバル リファレンス データはリファレンス データ アプリで定義され、すべてのアプリのすべてのソリューションで利用できます。
リファレンス データの場所
グローバル リファレンス データ アプリ - グローバル管理者またはアプリに個別に割り当てられた別のユーザーは、[アプリの選択] ドロップダウン リストで、他のアプリとともにリファレンス データ アプリを一覧表示できます。
このアプリは、グローバル管理者が初めてアプリケーションにログインしたときにデフォルトで一覧表示されます。
ローカル リファレンス データ - リファレンス データは、そのアプリの [ソリューション] メニューのリファレンス データ ライブラリで利用できます。
リファレンス データ ライブラリ
リファレンス データ ライブラリは、リファレンス データ用にデフォルトで作成される別個のライブラリです。このライブラリでリファレンス データ リストを作成および管理できます。追加のライブラリを作成して、リファレンス データを論理的に分離することもできます。これらの追加ライブラリの作成、読み取り、更新、および削除の権限 ( 「権限の管理」を参照) は、標準のソリューションおよびライブラリの権限と同じです。
リファレンス データ ソリューションを作成する
リファレンス データ ソリューションを作成および公開するには、リファレンス データ ライブラリに対するソリューション開発者の権限が必要です。
リファレンス データ ソリューションを作成するには、次の手順を実行します。
-
グローバル - ユーザー インターフェイスの右上にあるアプリ選択ドロップダウン リストからリファレンス データを選択します
ローカル (アプリ固有) - [ソリューション]メニューに移動し、[リファレンス データ リスト] をクリックします。
- [スキーマの追加] をクリックします。[スキーマの追加] ページが表示されます。
- スキーマ名、カテゴリ、および説明を入力します。 注:
スコープ フィールドは、手順 1 での選択に応じて事前に入力されています。
- [次へ] をクリックします。スキーマ作成手順が表示されます。以下のオプションから選択できます。
-
手動で作成 このオプションを使用すると、各列とフィールドを一度に 1 つずつ手動で作成できます。必要に応じて、列を追加し、名前、データ型、および制約を指定できます。
[追加] をクリックします。フィールド名を入力し、[フィールド タイプ] ドロップダウン リストからオプションを選択し、フィールドの長さ (文字列型のフィールドにのみ適用可能) を入力し、この列を必須にする場合は [必須] を選択して、[追加] をクリックします。詳細が画面に表示されます。
furtherinformation: 詳しい情報:-
作成者がデータをリストにアップロードした後、デフォルトのデータがまだ入力されていない場合は、必要な列にデフォルトのデータを追加します。次のフィールドのデフォルト値は次のとおりです。
DateTime: DateTime.Min 時間付きの値 (19010101 00:00:00) Date : DateTime.Min 時間なしの値 (19010101)
Int、Decimal、BigInt: 0
Bit: False
String および String(max): 空白
- DateTime フィールドについて: TimeZone で変換しないでください。代わりに、フィルタが正しく機能するように、それらを DateTime として保持してください。
-
-
クエリから作成 このオプションを使用すると、スキーマ/列を Studio Query スクリプトから作成できます。Query ファイルのすべての出力フィールドと条件フィールドは、リファレンス データ スキーマに表示されます。
注:列を変更することはできません。ただし、更新されたスクリプトをアップロードしてスキーマを更新することはできます。
[ファイルの選択] をクリックして、Studio Query スクリプトを参照します。
-
Excel から作成 既存の Excel ファイルからスキーマを作成できます。シート名を選択して、ヘッダー名をフェッチしてフィールド名を作成することができます。画面に表示される詳細からフィールド タイプ情報を変更できます。
[ファイルの選択] をクリックして、Excel ファイルを参照します。
furtherinformation: 詳しい情報:- Excel シートの最初の行からヘッダーを読み取り、Excel シートの 2 番目の行からデータ型を読み取ります。列にデータまたは型が設定されていない場合は、デフォルトで string (max) に設定されています。
- マッピングはヘッダー列と同じように機能します。ヘッダーが列 C で始まる場合、マッピングは同じ列で始まります。
-
-
[次へ] をクリックします。[マップ] ページで、対応する [マップ先] 列に選択範囲を入力して、入力したフィールドを Excel 列にマップします。
furtherinformation: 詳しい情報:- デフォルトのマッピングが実装された後、マッピングを変更するオプションがあります (必須ではありません)。ヘッダーは同じ列に書き込まれます。
- シートにデータが含まれていて、マッピングが列 A から始まる場合、シートは列 A から始まる連続した列にマッピングされます。
- シートに列 A、C、E、F、G、J、および L で定義されたヘッダーが含まれている場合、リファレンス データは同じ列にマップされます。
- この定義されたマッピングを含む新しい Excel ファイルが作成されます。ユーザーがアップロードしたテンプレートは使用されません。
- [Submit] をクリックします。ソリューションはドラフトとして保存され、リファレンス データ ライブラリの [ソリューション] タブに一覧表示されます。
- リファレンス データ スキーマを作成するときに、一意の列を追加できます。
- ソリューションを公開すると、他のソリューションから参照できるようになります。また、リファレンス データ ソリューションの権限は、公開された後でのみ管理できます。
- SQL Server で予約されているキーワード (transaction、nvarchar(max)、if など) はフィールド名に使用できません。
- リファレンス データの名前を変更することはできません。
- リファレンス データの列名を読み取るさいに、フォームはすべての特殊文字を '_' として扱います。col-1 や col_1 問題が発生する可能性があるため、リファレンス データ スキーマを慎重に作成してください。
リファレンス データ ソリューションを公開する
リファレンス データ ソリューションは、公開された後にのみ他のソリューションで使用できます。
ドラフト形式のリファレンス データ ソリューションを公開するには、次の手順を実行します。
- [ソリューション] タブに移動します。
- リファレンス データ ライブラリからリファレンス データ ソリューションを選択します。
- [アクション] 列の下にある アイコンをクリックし、[公開] をクリックします。
- [スキーマの公開] ボックスで、[テンプレートの公開] フィールドで [はい] を選択します。
- Excel テンプレートを公開したくない場合は、[データの編集] ボタンを使用して Evolve サイトからリファレンス データにデータを追加できます。
- [データの編集] ボタンをクリックすると、値を追加、更新、または削除できるリファレンス データ テーブルのあるページが開きます。
- このシナリオにはテンプレート ソリューションが存在しないため、クエリ出力からリファレンス データにアップロードされたデータを編集することもできます。
-
次のワークフローのいずれかを選択できます。
ワークフロー 説明 データ レビュー プロセスなし ファイルを確認した後、実行する前にファイルを承認する必要はありません。 レビューして転記 - 1 ステップ リファレンス データ ファイルを承認する必要があります。その後、レビューアーがファイルを実行します。実行後、次の [自動実行タイプ] オプションから選択します。
- なし – ユーザーがファイルを手動で実行します。
- レビューアー/作成者 –ファイルは自動的に転記されます (自動実行)。
レビューと転記 - 個別 リファレンス データ ファイルを承認する必要があります。その後、送信者がファイルを実行します。実行後、次の [自動実行タイプ] オプションから選択します。
- なし – ユーザーがファイルを手動で実行します。
- レビューアー/作成者 –ファイルは自動的に転記されます (自動実行)。
カスタム ワークフロー このオプションを選択すると、このリファレンス データ ソリューションのカスタム ワークフロー処理を作成できます。
- [公開] をクリックします。ソリューションのステータスが [実稼働] に変わります。これで、Excel アドインまたはリファレンス データ ソリューションの [データの編集] オプションのいずれかを使用してデータを入力できます。
-
通知オプションを使用して通知リストに複数のユーザーを追加し、[ソリューションを公開データを追加] アクションおよび [自動実行] アクションがこれらのユーザーに自動的に通知を送信するようにします。
furtherinformation: 詳しい情報:- ステータスがすぐに更新されない場合は、[スキーマの更新] をクリックします。
- このソリューション テンプレートは、Excel アドインで開くことができます。Excel アドインでデータを入力、検証、および保存することもできます。Excel アドインから Evolve にリファレンス データを送信すると、[ドキュメント] メニューからデータを表示できます (最初にリファレンス データ ファイルを送信したときに使用したリファレンス データ ファイル名を使用します)。
- [ドキュメント]メニューからリファレンス データのバージョンを追跡できます。
スキーマの更新
ドラフト形式のスキーマのみを編集できます。公開済みのスキーマのフィールドを変更する必要がある場合は、[スキーマのコピー] ボタンを使用してスキーマをコピーしてから、新しいスキーマとして保存することをお勧めします。
スキーマを更新するには、次の手順を実行します。
- [ソリューション] タブに移動します。
- リファレンス データ ライブラリからリファレンス データ ソリューションを選択します。
- [スキーマの更新] をクリックします。
- 表示される [スキーマの更新] ページで変更を加えます。
- [保存] をクリックします。
スキーマのコピー
この機能を使用して、すでに公開されているスキーマのフィールドを変更します。
スキーマをコピーするには、次の手順を実行します。
- [ソリューション] タブに移動します。
- リファレンス データ ライブラリからリファレンス データ ソリューションを選択します。
- [スキーマのコピー] をクリックします。
- 名前、カテゴリ、説明を入力します。これにより、新しいリファレンス データが作成されます。
- 上記で説明したスキーマの更新オプションを使用してスキーマを変更します。
- [Submit] をクリックします。スキーマがリファレンス データ ライブラリに一覧表示されます。
コピーされたスキーマを編集しても、既存のフィールドのスキーマ作成方法または フィールド タイプを変更することはできません。
スキーマ参照
スキーマを参照するには、次の手順を実行します。
- [ソリューション] タブに移動します。
- リファレンス データ ライブラリからリファレンス データ ソリューションを選択します。
- [スキーマの表示] をクリックします。[スキーマの表示] ページに、スキーマ情報が表示されます。
データの表示
Evolve サイトまたは Excel アドインからアップロードされたデータを表示できます。ユーザーは、すべての OData フィルターを適用することもできます。データは、個人情報からユーザーのロケールに従って表示されます。ODC ファイルをエクスポートして Excel にデータをダウンロードできます。ODC Excel ファイルは Windows 認証で実行され、そのユーザーは Evolve ユーザー グループの一部である必要があります。
データを表示するには、次の手順を実行します。
- [ソリューション] タブに移動します。
- リファレンス データ ライブラリからリファレンス データ ソリューションを選択します。
- [データの表示] をクリックします。このページには、リファレンス データ内のデータが表示されます。
データの編集
Excel テンプレートなしで公開されたソリューションの場合、サイトのデータを編集する権限を持つのはソリューションの作成者だけです。検証は、リファレンス データ リストにデータをアップロードするときに Excel で機能するのと同じように機能します。データが入力されていない場合、フィールドのデフォルト値がアップロードされます。
データを編集するには、次の手順を実行します。
- [ソリューション] タブに移動します。
- リファレンス データ ライブラリからリファレンス データ ソリューションを選択します。
- [データの編集] をクリックします。このページでは、一度に 1 行ずつ編集できます。このページでは、既存の行を削除して、リファレンス データに新しい行を追加することもできます。
リファレンス データ アプリ - オンライン ヘルプ
ユーザー アプリのオンライン ヘルプは、次の例外を除いて、リファレンス データ アプリにも同様に適用されます。
アプリ オプション | 参照データ アプリのステータス |
---|---|
Transaction ポリシー | 表示できません。 |
優先設定: Transaction データ レビュー 処理 | 使用不可。 |
優先設定: Transaction 実行設定 | 使用不可。 |
実行設定 --> 一般設定: Transaction スクリプト実行の理由を追加する | 使用不可。 |
実行設定 --> スケジューリング: デスクトップ スケジューリングによる Transaction スクリプト | 使用不可。 |
電子メール テンプレート: Query および参照データ テンプレート | これらは利用可能な唯一のテンプレートです。 |
ライブラリの管理: Query および参照データ ライブラリ | これらは利用可能な唯一のライブラリです。 |
ソリューションの管理: Query および参照データ ソリューション | これらは利用可能な唯一のソリューションです。 |
テンプレート ページ - Excel タブ | [Excel] タブは、[テンプレート] ページで使用できる唯一のタブです。 |