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 のみ) |
|
|
ユーザーが入力テーブルまたはフィールドを選択できる
TABLE および FIELD アナリティクス タグは、ユーザーが Analytics テーブルを選択し、テーブルからフィールドを選択できる入力パラメーターを作成し、アナリティクス スクリプトの入力として使用します。ただし、選択できるようにするために、テーブルが格納場所にあらかじめ存在している必要があります。
ユーザーが 1 つ以上の入力テーブルとフィールドを選択できるアナリティクス スクリプトを開発している場合は、DATA タグの前のアナリティクス スクリプトを実行し、適切なテーブルを保存場所に保存する必要があります。
ロボットのソーステーブルセクションで出力テーブルを見つける
任意で、src_ プレフィックスを出力テーブル名に追加し、ロボットの[入力/出力]タブの[ソーステーブル]セクションで出力テーブルを検索することができます。Robots
//DATA src_Invoices
DATA タグと付属するスクリプトの両方で、プレフィックスをテーブルに追加する必要があります。
[ソーステーブル]セクションでは、後続のスクリプトの入力を提供するテーブルを視覚的に区切ることができます。出力テーブル名に src_ プレフィックスがない場合、[ソーステーブル]セクションは[入力/出力]タブに表示されず、すべてのテーブルは[他のテーブル]セクションでデフォルトで検索されます。
クラウドベースのロボット アプリへのアップロード
ロボットインストールでアナリティクス スクリプトを実行し、DATA 指定すると、オンプレミスロボット エージェントから Diligent One のクラウドベースのロボット アプリにテーブル レイアウトのみ(ファイル名、データ型、ファイル長さ)をアップロードします。テーブルデータは、ロボット エージェントディレクトリ内の組織のネットワークにあります。
すべての情報は転送中に暗号化されます。