リファレンス データ - Automate_Evolve - Automate_Studio_Manager - 20.3

Automate Evolve ユーザー ガイド

Product type
ソフトウェア
Portfolio
Integrate
Product family
Automate
Product
Automate > Automate Evolve
Version
20.3
Language
日本語
Product name
Automate Evolve
Title
Automate Evolve ユーザー ガイド
Topic type
概要
リファレンス
管理
First publish date
2018

アプリケーションでリファレンス データを作成して保存できます。リファレンス データ アプリを使用すると、リポジトリを作成して、ユーザーがスキーマを定義し、リファレンス データを保存し、リファレンス データを更新できます。詳細については、「リファレンス データの使用」を参照してください。

リファレンス データは、参加者のリストにすることができます。また、ルックアップ データ (ドロップダウン リストの作成用)、処理 データ、または処理間データの場合もあります。リファレンス データは、ビジネス 処理を構築するために外部データを必要とするフォームまたは Excel ソリューションで参照されます。

リファレンス データをフォームまたは カスタム Excel ソリューションで使用するには、ソリューション設計者は最初にデータ接続を作成し、次にそのデータ接続をソリューション内で使用します。データ接続のリファレンス データ型を作成する方法の詳細については、「 データ接続 」ページを参照してください。

アプリの範囲

リファレンス データ ソリューションは、ローカルまたはグローバルにすることができます。

ローカル – ローカル リファレンス データは、特定のアプリのリファレンス データ ライブラリで定義されており、その特定のアプリのソリューションでのみ使用できます。

グローバル グローバル リファレンス データはリファレンス データ アプリで定義され、すべてのアプリのすべてのソリューションで利用できます。

リファレンス データの場所

グローバル リファレンス データ アプリ - グローバル管理者またはアプリに個別に割り当てられた別のユーザーは、[アプリの選択] ドロップダウン リストで、他のアプリとともにリファレンス データ アプリを一覧表示できます。

このアプリは、グローバル管理者が初めてアプリケーションにログインしたときにデフォルトで一覧表示されます。

ローカル リファレンス データ - リファレンス データは、そのアプリの [ソリューション] メニューのリファレンス データ ライブラリで利用できます。

リファレンス データ ライブラリ

リファレンス データ ライブラリは、リファレンス データ用にデフォルトで作成される別個のライブラリです。このライブラリでリファレンス データ リストを作成および管理できます。追加のライブラリを作成して、リファレンス データを論理的に分離することもできます。これらの追加ライブラリの作成、読み取り、更新、および削除の権限 ( 「権限の管理」を参照) は、標準のソリューションおよびライブラリの権限と同じです。

リファレンス データ ソリューションを作成する

リファレンス データ ソリューションを作成および公開するには、リファレンス データ ライブラリに対するソリューション開発者の権限が必要です。

リファレンス データ ソリューションを作成するには、次の手順を実行します。

  1. グローバル - ユーザー インターフェイスの右上にあるアプリ選択ドロップダウン リストからリファレンス データを選択します

    ローカル (アプリ固有) - [ソリューション]メニューに移動し、[リファレンス データ リスト] をクリックします。

  2. [スキーマの追加] をクリックします。[スキーマの追加] ページが表示されます。
  3. スキーマ名、カテゴリ、および説明を入力します。
    注:

    スコープ フィールドは、手順 1 での選択に応じて事前に入力されています。

  4. [次へ] をクリックします。スキーマ作成手順が表示されます。以下のオプションから選択できます。
    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 として保持してください。
    2. クエリから作成 このオプションを使用すると、スキーマ/列を Studio Query スクリプトから作成できます。Query ファイルのすべての出力フィールドと条件フィールドは、リファレンス データ スキーマに表示されます。

      注:

      列を変更することはできません。ただし、更新されたスクリプトをアップロードしてスキーマを更新することはできます。

      [ファイルの選択] をクリックして、Studio Query スクリプトを参照します。

    3. Excel から作成 既存の Excel ファイルからスキーマを作成できます。シート名を選択して、ヘッダー名をフェッチしてフィールド名を作成することができます。画面に表示される詳細からフィールド タイプ情報を変更できます。

      [ファイルの選択] をクリックして、Excel ファイルを参照します。

      furtherinformation: 詳しい情報:
      • Excel シートの最初の行からヘッダーを読み取り、Excel シートの 2 番目の行からデータ型を読み取ります。列にデータまたは型が設定されていない場合は、デフォルトで string (max) に設定されています。
      • マッピングはヘッダー列と同じように機能します。ヘッダーが列 C で始まる場合、マッピングは同じ列で始まります。
  5. [次へ] をクリックします。[マップ] ページで、対応する [マップ先] 列に選択範囲を入力して、入力したフィールドを Excel 列にマップします。

    furtherinformation: 詳しい情報:
    • デフォルトのマッピングが実装された後、マッピングを変更するオプションがあります (必須ではありません)。ヘッダーは同じ列に書き込まれます。
    • シートにデータが含まれていて、マッピングが列 A から始まる場合、シートは列 A から始まる連続した列にマッピングされます。
    • シートに列 A、C、E、F、G、J、および L で定義されたヘッダーが含まれている場合、リファレンス データは同じ列にマップされます。
    • この定義されたマッピングを含む新しい Excel ファイルが作成されます。ユーザーがアップロードしたテンプレートは使用されません。
  6. [Submit] をクリックします。ソリューションはドラフトとして保存され、リファレンス データ ライブラリの [ソリューション] タブに一覧表示されます。
注:
  • リファレンス データ スキーマを作成するときに、一意の列を追加できます。
  • ソリューションを公開すると、他のソリューションから参照できるようになります。また、リファレンス データ ソリューションの権限は、公開された後でのみ管理できます。
  • SQL Server で予約されているキーワード (transaction、nvarchar(max)、if など) はフィールド名に使用できません。
  • リファレンス データの名前を変更することはできません。
  • リファレンス データの列名を読み取るさいに、フォームはすべての特殊文字を '_' として扱います。col-1 や col_1 問題が発生する可能性があるため、リファレンス データ スキーマを慎重に作成してください。

リファレンス データ ソリューションを公開する

リファレンス データ ソリューションは、公開された後にのみ他のソリューションで使用できます。

ドラフト形式のリファレンス データ ソリューションを公開するには、次の手順を実行します。

  1. [ソリューション] タブに移動します。
  2. リファレンス データ ライブラリからリファレンス データ ソリューションを選択します。
  3. [アクション] 列の下にある アイコンをクリックし、[公開] をクリックします。
  4. [スキーマの公開] ボックスで、[テンプレートの公開] フィールドで [はい] を選択します。
    1. Excel テンプレートを公開したくない場合は、[データの編集] ボタンを使用して Evolve サイトからリファレンス データにデータを追加できます。
    2. [データの編集] ボタンをクリックすると、値を追加、更新、または削除できるリファレンス データ テーブルのあるページが開きます。
    3. このシナリオにはテンプレート ソリューションが存在しないため、クエリ出力からリファレンス データにアップロードされたデータを編集することもできます。
  5. 次のワークフローのいずれかを選択できます。

    ワークフロー 説明
    データ レビュー プロセスなし ファイルを確認した後、実行する前にファイルを承認する必要はありません。
    レビューして転記 - 1 ステップ

    リファレンス データ ファイルを承認する必要があります。その後、レビューアーがファイルを実行します。実行後、次の [自動実行タイプ] オプションから選択します。

    • なし – ユーザーがファイルを手動で実行します。
    • レビューアー/作成者 –ファイルは自動的に転記されます (自動実行)。
    レビューと転記 - 個別

    リファレンス データ ファイルを承認する必要があります。その後、送信者がファイルを実行します。実行後、次の [自動実行タイプ] オプションから選択します。

    • なし – ユーザーがファイルを手動で実行します。
    • レビューアー/作成者 –ファイルは自動的に転記されます (自動実行)。
    カスタム ワークフロー

    このオプションを選択すると、このリファレンス データ ソリューションのカスタム ワークフロー処理を作成できます。

  6. [公開] をクリックします。ソリューションのステータスが [実稼働] に変わります。これで、Excel アドインまたはリファレンス データ ソリューションの [データの編集] オプションのいずれかを使用してデータを入力できます。
  7. 通知オプションを使用して通知リストに複数のユーザーを追加し、[ソリューションを公開データを追加] アクションおよび [自動実行] アクションがこれらのユーザーに自動的に通知を送信するようにします。

    furtherinformation: 詳しい情報:
    • ステータスがすぐに更新されない場合は、[スキーマの更新] をクリックします。
    • このソリューション テンプレートは、Excel アドインで開くことができます。Excel アドインでデータを入力、検証、および保存することもできます。Excel アドインから Evolve にリファレンス データを送信すると、[ドキュメント] メニューからデータを表示できます (最初にリファレンス データ ファイルを送信したときに使用したリファレンス データ ファイル名を使用します)。
    • [ドキュメント]メニューからリファレンス データのバージョンを追跡できます。

スキーマの更新

ドラフト形式のスキーマのみを編集できます。公開済みのスキーマのフィールドを変更する必要がある場合は、[スキーマのコピー] ボタンを使用してスキーマをコピーしてから、新しいスキーマとして保存することをお勧めします。

スキーマを更新するには、次の手順を実行します。

  1. [ソリューション] タブに移動します。
  2. リファレンス データ ライブラリからリファレンス データ ソリューションを選択します。
  3. [スキーマの更新] をクリックします。
  4. 表示される [スキーマの更新] ページで変更を加えます。
  5. [保存] をクリックします。

スキーマのコピー

この機能を使用して、すでに公開されているスキーマのフィールドを変更します。

スキーマをコピーするには、次の手順を実行します。

  1. [ソリューション] タブに移動します。
  2. リファレンス データ ライブラリからリファレンス データ ソリューションを選択します。
  3. [スキーマのコピー] をクリックします。
  4. 名前、カテゴリ、説明を入力します。これにより、新しいリファレンス データが作成されます。
  5. 上記で説明したスキーマの更新オプションを使用してスキーマを変更します。
  6. [Submit] をクリックします。スキーマがリファレンス データ ライブラリに一覧表示されます。
注:

コピーされたスキーマを編集しても、既存のフィールドのスキーマ作成方法または フィールド タイプを変更することはできません。

スキーマ参照

スキーマを参照するには、次の手順を実行します。

  1. [ソリューション] タブに移動します。
  2. リファレンス データ ライブラリからリファレンス データ ソリューションを選択します。
  3. [スキーマの表示] をクリックします。[スキーマの表示] ページに、スキーマ情報が表示されます。

データの表示

Evolve サイトまたは Excel アドインからアップロードされたデータを表示できます。ユーザーは、すべての OData フィルターを適用することもできます。データは、個人情報からユーザーのロケールに従って表示されます。ODC ファイルをエクスポートして Excel にデータをダウンロードできます。ODC Excel ファイルは Windows 認証で実行され、そのユーザーは Evolve ユーザー グループの一部である必要があります。

データを表示するには、次の手順を実行します。

  1. [ソリューション] タブに移動します。
  2. リファレンス データ ライブラリからリファレンス データ ソリューションを選択します。
  3. [データの表示] をクリックします。このページには、リファレンス データ内のデータが表示されます。

データの編集

Excel テンプレートなしで公開されたソリューションの場合、サイトのデータを編集する権限を持つのはソリューションの作成者だけです。検証は、リファレンス データ リストにデータをアップロードするときに Excel で機能するのと同じように機能します。データが入力されていない場合、フィールドのデフォルト値がアップロードされます。

データを編集するには、次の手順を実行します。

  1. [ソリューション] タブに移動します。
  2. リファレンス データ ライブラリからリファレンス データ ソリューションを選択します。
  3. [データの編集] をクリックします。このページでは、一度に 1 行ずつ編集できます。このページでは、既存の行を削除して、リファレンス データに新しい行を追加することもできます。

リファレンス データ アプリ - オンライン ヘルプ

ユーザー アプリのオンライン ヘルプは、次の例外を除いて、リファレンス データ アプリにも同様に適用されます。

アプリ オプション 参照データ アプリのステータス
Transaction ポリシー 表示できません。
優先設定: Transaction データ レビュー 処理 使用不可。
優先設定: Transaction 実行設定 使用不可。
実行設定 --> 一般設定: Transaction スクリプト実行の理由を追加する 使用不可。
実行設定 --> スケジューリング: デスクトップ スケジューリングによる Transaction スクリプト 使用不可。
電子メール テンプレート: Query および参照データ テンプレート これらは利用可能な唯一のテンプレートです。
ライブラリの管理: Query および参照データ ライブラリ これらは利用可能な唯一のライブラリです。
ソリューションの管理: Query および参照データ ソリューション これらは利用可能な唯一のソリューションです。
テンプレート ページ - Excel タブ [Excel] タブは、[テンプレート] ページで使用できる唯一のタブです。