AX からロボットにスクリプトを移行する

重要

スクリプトの移行は、移行の前の段階を完了した場合にのみ行ってください。詳細については、ロボットで AX リポジトリ構造を再作成するを参照してください。

ロボットで再作成する AX の各自動プロセスについて、関連するスクリプトを移行する必要があります。すべてのアナリティクス スクリプトとサブスクリプトまたはヘルパー スクリプトを移行する必要があります。

直接 AX からロボットにスクリプトを移行することはできません。自分のコンピューターなど Analytics がインストールされている中間の場所に AX のスクリプトをエクスポートする必要があります。必要な準備作業を完了した後に、中間の場所からロボットにスクリプトをコミット（アップロード）します。

ロボットの後方互換性

一般的に、ロボットは、可能なかぎり AX との後方互換性を維持するように設計されています。ほとんどの AX スクリプトは修正せずにロボットで動作します。

AX 固有の設計に依存するスクリプトは調整する必要があります。例：

  • AX 運用データベースにアクセスし、ジョブ スケジュールまたはログを読み取るスクリプト
  • ロボット エージェント サーバーでは無効なサーバー リソースへの絶対パスを含むスクリプト

ロボットで使用するためにアナリティクス スクリプトを調整する際にサポートが必要な場合は、Diligent サポートまでお問い合わせください。

AX からスクリプトをエクスポートする

移行を開始するには、［エクスポート］オプションを使用して、AX からスクリプトをエクスポートします。スクリプトは、スクリプトを含む分析アプリにエクスポートされます。エクスポートされた分析アプリはそれぞれ、エクスポート先で個別の Analytics プロジェクトになります。

この手順では、中間の場所して自分のコンピューターを使用することを前提としています。

  1. エクスポートされたスクリプトを保存するためのフォルダーをコンピューターで作成します。
  2. AX Server Explorer で、エクスポートするスクリプトを含む分析アプリを選択します。

    Ctrl キーを押しながらクリックすると、同じ分析アプリ親フォルダーで複数の分析アプリを選択できます。親フォルダーを選択すると、フォルダーのすべての分析アプリをエクスポートします。

  3. ［ファイル > エクスポート］を選択します。
  4. ［エクスポート］ダイアログボックスで、両方のオプションが選択されていないことを確認します。
    • エクスポートしたファイルで作業しますか?
    • 選択した定義と一緒にデータ ファイルをエクスポートする
  5. ［参照］をクリックして、スクリプトを保存するために作成したフォルダーを選択し、［OK］をクリックします。
  6. ［OK］をクリックして、分析アプリをエクスポートします。

    スクリプトは分析アプリの指定した場所にエクスポートされます。各分析アプリは Analytics スクリプトに変換されます。

  7. 移行する準備が完了したその他のスクリプトにも同じ手順を繰り返します。

リンクされたアナリティクス スクリプト

AX とは異なり、ロボットはリンクされたアナリティクス スクリプトをサポートしません。AX でリンクされたアナリティクス スクリプトを使用する場合は、マスター アナリティクス スクリプトをエクスポートしてから、必要な各ロボットにコミットします。

必要な準備作業を実行する

次の場合、AX からエクスポートした後に、スクリプトをロボットにコミットできます。

  • 自動プロセスに関連付けられたすべてのスクリプトが単一の Analytics プロジェクトにある
  • 自動プロセスで連続で実行する必要があるすべてのアナリティクス スクリプト：
    • 適切な英数字の命名規則を使用する
    • 適切なアナリティクス タイプである（導入されている場合）

アナリティクス チェーン

AX とは異なり、ロボットはアナリティクス チェーンをサポートしません。アナリティクス チェーンを使用する場合は、スクリプトをロボットにコミットする前に準備作業を実行しなければならない場合があります。詳細については、ロボットでアナリティクス チェーンを複製するを参照してください。

スクリプトをロボットにコミットする (アップロードする)

自動プロセスに関連付けられたすべてのスクリプトが単一の Analytics スクリプトに含まれ、適切な名前が付けられると、スクリプトをロボットにコミットできます。

スクリプトをコミットすると、スクリプトがローカル環境からクラウドベースのロボット アプリにアップロードされます。スクリプトを同じロボットにコミットするたびに、新しいバージョンのスクリプトがスクリプト履歴に作成されるため、「アップロード」ではなく、「コミット」という用語が使用されます。

詳細については、ロボットへの ACL スクリプトのコミット (アップロード)を参照してください。

  1. コミットするスクリプトを使用して、Analytics プロジェクトを開きます。
  2. Analytics メインメニューから、［ファイル］>［スクリプトをコミット］を選択します。

    エラー メッセージが表示される場合は、プロジェクトの 1 つ以上のスクリプトで、アナリティクス ヘッダーまたはスクリプト構文に問題がある場合があります。

    詳細については、Analytics およびロボットにおける ACL スクリプトの開発ワークフローを参照してください。

  3. 必要に応じて、［送信先を選択］ダイアログボックスで、該当する Diligent One インスタンスをダブルクリックします。

    ［ロボットコレクション］と既存のロボットの一覧が表示されます。

  4. ロボットのリストで、スクリプトをコミットするロボットを選択し、［OK］をクリックします。

    スクリプトを含む Analytics プロジェクトと既存ロボットが関連付けられ、次回以降のコミットでロボットを手動で検索する必要がなくなります。

  5. コミットされたスクリプトを説明する簡潔なコミット メッセージを入力し、［OK］をクリックします。

    ロボットでは、開発モードでスクリプトがコミットされます。

  6. ［スクリプトのコミットが成功しました］ダイアログボックスで、2 番目のリンクをクリックして、ロボット アプリで新しくコミットされたスクリプトを調べます。

    ［スクリプト バージョン］タブが開き、コミットされたバージョンのスクリプトが表示されます。

  7. スクリプト バージョンを選択します（vn）。

    ［バージョンの詳細］サイド パネルが開きます。［スクリプト バージョンの変更］の下に、個別のアナリティクス スクリプトと補助スクリプトの名前が一覧表示されます。

  8. Analytics で、［OK］をクリックし、［スクリプトのコミットが成功しました］ダイアログボックスを終了します。

ロボットでアナリティクス チェーンを複製する

メモ

このセクションは、AX でアナリティクス チェーンを使用する場合にのみ該当します。

AX とは異なり、現在、ロボットは、リポジトリのアナリティクス スクリプトを連続して実行されるアナリティクス チェーンに組み立てることをサポートしていません。ロボットで一連のアナリティクス スクリプトを連続して実行するには、次の 2 つの手順を行う必要があります。

  • 単一のロボットにアナリティクス スクリプトを含め、単一のタスクを作成してスクリプトを実行する
  • スクリプト名、アナリティクス タイプを使用して、スクリプト シーケンスを作成する

単一のロボットにアナリティクス スクリプトを含める

単一のロボットに連続して実行するアナリティクス スクリプトを含めます。

単一のロボットにスクリプトを含めるには、まずすべての関連するスクリプトを単一の Analytics スクリプトに含める必要があります。スクリプトをスクリプト バージョンという 1 つのバンドルとして、Analytics プロジェクトからロボットにコミットします。

スクリプトが単一のロボットにコミットされたら、単一のタスクを作成して一連のアナリティクス スクリプトを実行します。

関連付けられたスクリプトを単一の Analytics プロジェクトに含める

単一の自動プロセスに関連付けられたスクリプトが 2 つ以上の Analytics スクリプト間で配布される場合は、ロボットにコミットする前にスクリプトを単一のプロジェクトで統合する必要があります。この状況は、アナリティクス スクリプトが AX のアナリティクス チェーンの一部である場合に生じる可能性があります。

  1. 自動プロセスに関連付けられたすべてのスクリプトを含めるために使用する Analytics プロジェクトを開きます。
  2. ナビゲーターの［総覧］タブで、ツリー ビューの上部にあるプロジェクト名を右クリックし、［別のプロジェクトからコピー > スクリプト］を選択します。
  3. ［プロジェクト ファイルの場所］ダイアログ ボックスで、スクリプトのコピー元となる Analytics プロジェクトを探して選択し、［開く］をクリックします。
  4. ［インポート］ダイアログ ボックスで、次のいずれかの手順を行って、1 つ以上のスクリプトを［インポート先 ＜プロジェクト名＞］リストに追加します。
    • スクリプトをダブルクリックする。
      • 複数のスクリプトを
    • Ctrl キーを押しながらクリックし、右矢印ボタンをクリックする。
    • ［すべて追加］をクリックして、すべてのスクリプトを追加します。
  5. ［OK］をクリックして、コピー先のプロジェクトにスクリプトをコピーします。

    プロジェクト内に同じ名前のスクリプトが既に存在する場合は、コピーしたスクリプト名の末尾に増分数字が付けられます。

  6. 宛先のプロジェクトに含める必要がある他のプロジェクトのスクリプトでもこの手順を繰り返します

スクリプト名、アナリティクス タイプを使用して、スクリプト シーケンスを作成する

スクリプト名

ロボット タスクでは、アナリティクス スクリプトは名前の英数字順に並べ替えられ、順番に実行されます。このため、任意の実行シーケンスを作成するようにアナリティクス スクリプト名を指定してください。

たとえば、シーケンスの最初のスクリプトはプレフィックス A_01 を使用し、2 番目のスクリプトは A_02、B_01 などのようにすることができます。プレフィックス体系を構築すると、追加のスクリプトを後から挿入することが容易になります。サブスクリプトまたはヘルパー スクリプトには、連続命名要件は適用されません。

メモ

ロボットではスクリプト名を変更できないため、ロボットにコミットする前に、Analytics のすべてのスクリプト名が正しいことを確認してください。

アナリティクス タイプ

シーケンスをさらにわかりやすくするために、任意でアナリティクス スクリプトのタイプを指定できます。タイプを指定すると、スクリプトがタスクの個別の領域にグループ化されます。この領域は次のように並べて表示され、順番に実行されます。

  • インポート
  • 準備
  • 分析

各領域では、スクリプトが英数字順に並べ替えられます。スクリプト名に関係なく、タスクは領域内のすべてのスクリプトを実行してから、次の領域に進みます。

詳細については、「ANALYTIC タグ」を参照してください。

アナリティクス スクリプト名を変更し、実行シーケンスを作成する

2 つ以上のアナリティクス スクリプトを順番に実行する場合は、任意の実行シーケンスを作成するように名前を指定する必要があります。詳細については、ロボットでアナリティクス チェーンを複製するを参照してください。

メモ

アナリティクス ヘッダーで指定されたアナリティクス スクリプト名は、ロボットで使用される名前です。ナビゲーターの［総覧］タブのスクリプト名は使用されません。

  1. Analytics で、名前を変更するアナリティクス スクリプトを開きます。
  2. アナリティクス ヘッダーの //ANALYTIC タグで、アナリティクス名を更新し、［開いているプロジェクトを保存 ］をクリックします。

    詳細については、「ANALYTIC タグ」を参照してください。

  3. 名前を変更する必要があるすべてのアナリティクス スクリプトでこの手順を繰り返します。

アナリティクス タイプを指定して、アナリティクス スクリプトをグループ化する

アナリティクス スクリプトをタスクの個別の［インポート］、［準備］、［分析］領域にグループ化する場合は、各スクリプトで対応するアナリティクス タイプを指定する必要があります。アナリティクス スクリプトをグループ化すると、スクリプト シーケンスを作成できますが、必須ではありません。詳細については、ロボットでアナリティクス チェーンを複製するを参照してください。

  1. Analytics で、タイプを指定するアナリティクス スクリプトを開きます。
  2. アナリティクス ヘッダーの //ANALYTIC タグで、アナリティクス タイプを追加し、［開いているプロジェクトを保存 ］をクリックします。

    詳細については、「ANALYTIC タグ」を参照してください。

  3. アナリティクス タイプが必要なすべてのアナリティクス スクリプトでこの手順を繰り返します。

次にすべきこと

1 つ以上の自動プロセスのスクリプトを移行したら、データの移行を開始できます。AX からロボットにデータを移行する