DATA タグ

アナリティクス スクリプトによって出力された Analytics テーブルを、ロボットの中央データ保存場所にコピーすることを指定します。

通常は、後続のアナリティクス スクリプトの入力テーブルとして利用できるよう、Analytics テーブルを格納します。

メモ

Analytics テーブルの中央データ保管場所への保存は、オンプレミスのロボット エージェントを持つ ACL ロボットでのみサポートされています。クラウドベースのロボット エージェントを使用している場合、この機能は使用できません。DATA タグは、クラウドベースのエージェントで実行されるアナリティクス スクリプトでは無視されます。

構文

//DATA テーブル名
  <説明>

パラメーター

名前 説明
テーブル名

格納する Analytics テーブルの名前。

メモ

テーブル名値はアナリティクス スクリプトの Analytics 出力テーブルの名前と正確に一致する必要があります。テーブル名でテーブル名を指定していません。スクリプトで指定されたテーブル名と一致しています。

スクリプトを使ったテーブル名一致を支援するために、テーブル名の中でワイルドカード文字を使用することができます。

テーブル名には変数を使用できません。

ソースデータファイルの名前ではなく、テーブルの名前である必要があります。

正しい記述:

//DATA Missing_Checks

間違った記述:

//DATA Missing_Checks.fil

メモ

データサブフォルダーの既存の Analytics の名前が指定した値と同じ場合、既存のテーブルが上書きされます。

データ テーブル名でサポートされていない文字

テーブル名にはスペースを使用しないでください。

テーブル名では次の文字を使用しないでください。次の文字はサポートされていません。

! @ # $ % ^ & ( ) - + = { } [ ] | \ : ; ' " < > , / . ` ~

ワイルドカード文字

テーブル名の一部が変化する可能性がある場合は、テーブルの名前にワイルドカード文字を使用することができます。たとえば、テーブル名が月によって異なる場合(invoices-jan、invoices-feb など)は、「invoices-*」と指定すれば、月の接尾辞に関係なくテーブルがデータサブフォルダーにコピーされます。

分析スクリプト内のすべての Analytics 出力テーブルをデータサブフォルダーにコピーするために、単一のワイルドカード文字を指定できます:

//DATA *

注意

ワイルドカード文字を使用するときには注意してください。指定するワイルドカードパターンが意図していないテーブルと一致する場合、既存のデータテーブルが意図せず上書きされる場合があります。

ベストプラクティスとして、テーブル名値をできるかぎり具体的にします。必要な場合にのみワイルドカード文字を使用してください。

ロボットへのアップロード

ロボットへのアップロードについては、クラウドベースのロボット アプリへのアップロードを参照してください。Robots

説明

省略可能

出力テーブルやその他の情報に関する説明テキスト。説明を複数行で指定することはできますが、行を飛ばすことはできません。

説明は、アナリティクス ヘッダーにのみ存在するものであり、ロボットのエンドユーザーには表示されません。

Analytics テーブルを格納場所にコピーする

次のアナリティクス ヘッダーは、関連付けられたスクリプトで出力されるインボイステーブルが格納場所にコピーされることを指定します:

COMMENT
//ANALYTIC テーブルのインポート
//DATA Invoices
END
IMPORT DELIMITED TO Invoices "Invoices.fil" FROM "Invoices.csv" 0 SEPARATOR "," QUALIFIER '"' CONSECUTIVE STARTLINE 1 KEEPTITLE ALLCHAR ALLFIELDS

備考

出力テーブルの格納

出力テーブルは自動的に格納場所にコピーされません。格納したいテーブルごとに DATA タグを使用する必要があります。必要に応じて、1 つのアナリティクス ヘッダーに複数の DATA タグを含めることができます。

DATA タグを使用するとき

次の 2 つの状況では、DATA タグを使用して、Analytics テーブルを格納する必要があります。Analytics

  • 出力テーブルが後続のアナリティクス スクリプトの入力として使用される
  • ユーザーがアドホックでアナリティクス スクリプトをスケジュールまたは実行するときに、入力テーブルまたはフィールドを選択できる

メモ

データ分析プロセス全体が単一のアナリティクス スクリプトを使用して完了する場合、DATA タグを使用する必要はありません。

DATA タグは、結果テーブルを指定するために使用するものではありません。代わりに RESULT タグを使用します。詳細については、RESULT タグを参照してください。

出力テーブルが後続のアナリティクス スクリプトの入力として使用される

展開環境および関連付けられたスクリプトの構造によっては、DATA タグを使用して、後続のアナリティクス スクリプトで使用するための Analytics 出力テーブルを格納しなければならない場合があります。

アナリティクス スクリプト処理中に、ロボットは一時ディレクトリを使用して、Analytics 出力テーブルを格納してアクセスするため、DATA タグを使用する必要がない場合があります。

以下の表は指針です。

展開環境 DATA タグを使用する場合 DATA タグを使用する必要がない場合
ロボット

(Enterprise Edition のみ)

  • 1 つのロボットのタスク内で出力された Analytics テーブルが、別のロボットのタスクの入力として必要である
  • Analytics テーブルが出力され、単一のロボットのタスクでの一連のアナリティクス スクリプト実行中に後から入力される
  • データ分析プロセス全体が単一のアナリティクス スクリプトを使用して完了する

ユーザーが入力テーブルまたはフィールドを選択できる

TABLE および FIELD アナリティクス タグは、ユーザーが Analytics テーブルを選択し、テーブルからフィールドを選択できる入力パラメーターを作成し、アナリティクス スクリプトの入力として使用します。ただし、選択できるようにするために、テーブルが格納場所にあらかじめ存在している必要があります。

ユーザーが 1 つ以上の入力テーブルとフィールドを選択できるアナリティクス スクリプトを開発している場合は、DATA タグの前のアナリティクス スクリプトを実行し、適切なテーブルを保存場所に保存する必要があります。

ロボットのソーステーブルセクションで出力テーブルを見つける

任意で、src_ プレフィックスを出力テーブル名に追加し、ロボットの[入力/出力]タブの[ソーステーブル]セクションで出力テーブルを検索することができます。Robots

//DATA src_Invoices

DATA タグと付属するスクリプトの両方で、プレフィックスをテーブルに追加する必要があります。

ソーステーブル]セクションでは、後続のスクリプトの入力を提供するテーブルを視覚的に区切ることができます。出力テーブル名に src_ プレフィックスがない場合、[ソーステーブル]セクションは[入力/出力]タブに表示されず、すべてのテーブルは[他のテーブル]セクションでデフォルトで検索されます。

クラウドベースのロボット アプリへのアップロード

ロボットインストールでアナリティクス スクリプトを実行し、DATA 指定すると、オンプレミスロボット エージェントから Diligent One のクラウドベースのロボット アプリにテーブル レイアウトのみ(ファイル名、データ型、ファイル長さ)をアップロードします。テーブルデータは、ロボット エージェントディレクトリ内の組織のネットワークにあります。

すべての情報は転送中に暗号化されます。