AX からロボットにデータを移行する

重要

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

AX リポジトリに次の一覧のデータの種類のいずれかが含まれている場合、データをロボットに移行しなければならない場合があります。データの本質によっては、既存のテーブルを物理的に AX から移行するよりも、スクリプトを使用して新しいデータのインスタンスをロボットにインポートした方が速く簡単で、適切な場合があります。

AX リポジトリに移行または再作成が必要なデータが含まれていない場合は、移行の次の段階に進むことができます。ロボットで自動 AX プロセスを再作成する

データの種類 AX の場所
Analytics データ テーブル データ サブフォルダー
Excel や *.csv などの入力ファイル 関連ファイル サブフォルダー

Analytics データ テーブルの再作成または移行

この一般的なガイドラインは、ロボットで Analytics データ テーブルを再作成するか、AX から移行するかどうかを決定する際に役立ちます。

  • 再作成 アナリティクス スクリプトが実行されるたびに上書きされるデータ テーブルは、AX から移行するのではなく、ロボットで再作成できます。
  • 移行 アナリティクス スクリプトが実行されるたびにレコードが最後に追加されるデータ テーブルは移行します。

メモ

データ テーブルを移行するときには、データ フォルダーのすべてのデータ テーブルがグループとして移行されます。このため、データ フォルダーに上書きされるテーブルと最後に追加されるテーブルが含まれている場合、すべてのテーブルが移行されます。

最初にロボットを作成する

Analytics データ テーブルを再作成する場合でも移行する場合でも、まず、ロボットでテーブルを格納するための適切なロボットを作成したことを確認する必要があります。まだ必要なロボットが作成されていない場合は、ここで作成する必要があります。詳細については、ロボットを作成し、内容と自動プロセスを構造化するを参照してください。

ロボットでデータ テーブルを使用する方法によって、テーブルを格納するための個別のロボットを構造化する方法が決まります。

想定される Analytics データ テーブルの使用方法 ロボットの構造
データソースからインポートされたデータの単一のコピーを格納および保護し、他のロボットの複数の自動プロセスによってリンクできるようにします。 「Source Data」といった名前のロボットを作成します。さまざまな種類のソースデータに合わせて別個のコンテナーが必要な場合は、複数のロボットを作成します。例：「SAP Source Data」、「Oracle Source Data」
同じ自動プロセスの一部、または複数の自動プロセスとして、後続のアナリティクス スクリプトを入力を指定します。 自動プロセスに必要なすべてのスクリプトとデータ テーブルを格納するロボットを作成します。例：「A_01_AP analytic tests」

データ テーブルの再作成

アナリティクス スクリプトが実行されるたびに上書きされる Analytics データ テーブルは、AX から移行するのではなく、ロボットで再作成します。テーブルを作成するスクリプトがロボットで実行されるとすぐにテーブルが上書きされるため、この状況でテーブルを移行すると、作業が無駄になります。

たとえば、SAP または Oracle インストールから月次取引テーブルをインポートし、前月のテーブルを上書きする場合、最も簡単な方法は、テーブルを AX にインポートするために使用するのと同じアナリティクス スクリプトを使用して、月次テーブルをロボットにインポートすることです。

同様に、自動分析が実行されるたびに上書きされるデータ テーブルは、移行するのではなく、ロボットで分析を実行することで再作成します。

ロボットでデータ テーブルを再作成するオプション

次のオプションのいずれかを使用して、ロボットでデータ テーブルを再作成できます。

  • 自動プロセス全体を実行する
  • 自動プロセスの一部のみを実行する
  • セットアップ スクリプトを使用してデータ テーブルを初期化する

自動プロセス全体を実行する

自動プロセスに関連付けられたスクリプトを移行した後に、スクリプトを格納するロボットでタスクを作成し、一時的にタスクを実行します。タスクが正常に実行された場合、スクリプトで出力されたすべてのデータ テーブルがタスクを含むロボットで再作成されます。

このオプションではすべての分析が実行され、自動プロセスに関連付けられたすべての出力結果が作成されます。この時点でデータ テーブルのみを再作成する場合は、次に示すその他のオプションのいずれかを使用します。

自動プロセスの一部のみを実行する

自動プロセスをいくつかの部分に整理した場合は、データ テーブルを作成するスクリプトのみを実行するタスクを作成します。たとえば、自動プロセスのインポート部分、またはインポートと準備部分にあるスクリプトのみを実行します。

タスクが正常に実行された場合は、インポートされたデータ、またはインポートおよび準備されたデータが格納されたデータ テーブルが、タスクを含むロボットで再作成されます。出力結果は作成しません。

セットアップ スクリプトを使用してデータ テーブルを初期化する

「Source Data」ロボットなどのインポートされたデータ用に集中管理された場所を作成した場合は、セットアップ アナリティクス スクリプトを作成して、ロボットでデータ テーブルを 1 回だけ初期化できます。

Analytics で、ACCESSDATA や IMPORT ODBC などのデータをインポートするために使用するすべての ACLScript コマンドを収集する単一のアナリティクス スクリプトを作成します。スクリプトを「Source Data」ロボットにコミットし、スクリプトを実行するタスクを作成します。タスクは一時的に実行するか、夜間に実行されるようにスケジュールできます。タスクが正常に実行された場合は、インポートされたデータが格納されたデータ テーブルが「Source Data」ロボットで再作成されます。

メモ

セットアップ スクリプトの単一のインポートが失敗した場合は、タスクが失敗し、その後の処理は中断されます。多数のインポートを実行する場合は、複数のセットアップ スクリプトに分け、各スクリプトに個別のタスクを作成できます。このようにすると、1 回インポートが失敗したことで、他のインポートが中断されることがなくなります。

データ テーブルの移行

アナリティクス スクリプトが実行されるたびにレコードが最後に追加される Analytics データ テーブルは、ロボットで再作成するのではなく、AX から移行します。この状況では、テーブルに格納された、蓄積された履歴データを保持するためにテーブルの移行が必要です。

たとえば、SAP または Oracle インストールから月次取引テーブルをインポートし、累積する年次テーブルの最後にレコードを追加する場合は、年次テーブルをロボットに移行する必要があります。

同様に、自動分析が実行されるたびにレコードが最後に追加されるデータ テーブルは、再作成するのではなく、ロボットに移行します。

ロボットにデータ テーブルを移行する手順

Diligent サポートは、AX の履歴データ テーブルをロボットに移行するのを支援するためにスクリプトを提供しています。最初のスクリプトは AX のデータ テーブルをネットワーク上の中間の場所にエクスポートします。2 番目のスクリプトは中間の場所のデータ テーブルをロボットにインポートします。

AX とは異なり、ユーザー インターフェイスから Analytics テーブルを直接ロボットにアップロードできないため、移行スクリプトが必要です。

メモ

スクリプトは個別の AX フォルダー レベルと個別のロボット レベルで動作します。エクスポートするデータ テーブルが格納された各フォルダーと、データ テーブルをインポートする各ロボットで、スクリプトを繰り返し実行する必要があります。

ネットワーク上で中間の場所を作成する

AX のデータ テーブルをロボットに移行するときに履歴データ テーブルを格納するための一時フォルダーを作成します。自分のコンピューター上でフォルダーを作成できますが、移行するデータの量が大きい場合は、一般的にネットワーク上のフォルダーを使う方が便利です。

フォルダーは、該当するサーバーで AX とロボット エージェント Windows サービスを実行するサービス アカウントからアクセスできる必要があります。いずれのアカウントもフォルダーへのフル コントロール アクセス権が必要です。Windows サービスの名前：

  • ACL Analytics Exchange Service
  • ロボット エージェント

AX で EXECUTE コマンドを有効にする

AX で EXECUTE コマンドが有効でない場合は、有効にする必要があります。

注意

デフォルトでは、AX で EXECUTE コマンドは無効です。通常、コマンドを無効にする場合は、履歴データ テーブルの移行が完了した後にもう一度無効にしてください。

  1. ブラウザーで、AX Server Configuration Web アプリケーションにログインします。

    デフォルトでは、AX Server Configuration Web アプリケーションは、https://<ax サーバー名>/aclconfig にあります。

  2. ［サーバー > 設定］の下で［EXECUTE コマンドを許可しますか?］の［はい］をクリックします。
  3. ［サーバー設定の更新］をクリックします。

データ フォルダーの内容を整理する

重要

ロボットで移行先ロボットに必要なテーブルについて考えてください。データ フォルダーを整理した後、同じ移行先ロボットにあるテーブルのみが残ります。

AX でエクスポート スクリプトを実行する前に、ロボットの同じ移行先ロボットに必要なテーブルのみが、エクスポートするデータ フォルダーに含まれていることを確認してください。

エクスポートおよびインポート スクリプトは一括処理を使用して、データ フォルダー、一時保存フォルダー、ロボットの単一の移行先ロボット間でグループとしてテーブルと関連付けられたデータ ファイルをコピーします。個別のテーブルをエクスポートまたはインポート対象として選択することはできません。

データ フォルダーのすべてのテーブルが単一のロボットと一致する場合、これ以上の整理は必要ありません。データ フォルダーのテーブルと単一のロボットが完全に一致しない場合は、エクスポートする前に一致させる必要があります。

データ フォルダーとロボットとの間でテーブルを一致させる方法

状況に応じて、次の方法のいずれかを使用して、データ フォルダーとロボットとの間でテーブルを一致させることができます。

  • ステージング データ フォルダーを作成するエクスポートする前にデータ テーブルをステージングするための新しいコレクションとフォルダーを作成します。単一の移行先ロボットと一致するテーブルをステージング データ フォルダーにコピーし、そこからエクスポートします。

    一定期間の間 AX とロボットを並列で実行し、既存のデータ フォルダーの内容をそのままにしておきたい場合には、この方法を使用します。

  • 既存のデータ フォルダーを編集するエクスポートする前に、既存のデータ フォルダーから一致しないテーブルを削除または移動します。単一の移行先ロボットと一致しないすべてのテーブルを削除または移動します。

    注意

    既存のデータ フォルダーに対して必要な修正を行うと AX の自動プロセスが中断される場合にのみ、この方法を使用してください。

データ フォルダーで異なるテーブルおよびレイアウトの種類を処理する方法

重要

AX でエクスポート スクリプトを実行する前に、データ フォルダーに表示できるテーブルとレイアウトの種類に関する次の情報を確認してください。既存のデータ フォルダーを編集する場合は、必要に応じてテーブルやレイアウトを削除または移動してください。

テーブル レイアウトの種類 データ フォルダー要件

スタンドアロン テーブル

 移行先ロボットに配置する単独のテーブルのみを含めます。

共有テーブル

移行先ロボットに配置する共有テーブルのみを含めます。

AX 共有テーブル機能はロボットに移行されません。

マスター テーブル

移行先ロボットに配置するマスター テーブルのみを含めます。

テーブル間のリンク関係は移行されず、ロボットで再作成することもできません。

リンクされたテーブル

リンクされたテーブルをエクスポートする場合は、一時保存場所にある他のテーブルのように、リンク解除されたテーブルと関連付けられたデータ ファイルになります。この場合、想定通りの結果にならない場合もあります。

テーブルのリンクをロボットでも維持する場合は、AX のデータ フォルダーからリンクされたテーブルを削除し、ロボットでリンクを再作成します。

スタンドアロン レイアウト

データ フォルダーからテーブル レイアウトを削除します。スクリプトでは、すべてのデータ テーブルがソースデータ ファイルに関連付けられている必要があります。

レイアウトについては、テーブルの［概要］タブの［データ ソース］プロパティに、「このデータ定義にはデータ ソースが関連付けられていません」と表示されます。

マスター レイアウト

リンク レイアウト

Diligent Connect からの移行スクリプトのダウンロード

  1. https://connect.diligent.com/hbfrontdoor/login?startURL=/s/article/Project-migration-from-AX-to-Robots に移動します。
  2. ［添付ファイル］の下で、ダウンロードする［Table_Migration］Analytics プロジェクトをクリックします。

    メモ

    プロジェクトが表示されない場合は、Diligent One アカウント資格情報を使用して、Diligent Connect にログインしなければならない場合があります。

移行スクリプトを使用して、Analytics プロジェクトを AX にインポートする

  1. AX Client を開いてログインします。
  2. Server Explorer で、エクスポートする履歴データ テーブルを含むフォルダーを選択します。
  3. ［ファイル > インポート］を選択して、［Table_Migration］Analytics プロジェクトをダウンロードした場所に移動します。
  4. プロジェクトを選択して、［開く］をクリックします。
  5. ［インポート先の選択］ダイアログボックスで、正しいフォルダーが選択されていることを確認し、［インポート］をクリックします。

    プロジェクトがインポートされ、分析アプリ フォルダーに追加されます。

AX でエクスポート スクリプトを実行する

  1. ［Table_Migration］分析アプリで、［Data Tables Export］スクリプトを選択し、［アナリティクス > 実行］を選択します。

    メモ

    ［Data Tables Import］スクリプトは、AX ではなく、ロボット用です。

  2. ［実行］ダイアログボックスで［新しいセットを作成］をオンにして、Export destination などの新しい入力値セットの名前を入力して、［次へ］をクリックします。
  3. ［テーブル ファイル共通フォルダー パス］で、データ ファイルに作成する一時保存フォルダーへのパスを入力し、［次へ］をクリックします。
    • フォルダーが AX と同じサーバーにある場合は、C:\Temp_data_files_storage
      • などのローカル ファイル パスを指定します。
    • ネットワークのフォルダーにファイルをエクスポートしている場合は、 \\<サーバー名>\Temp_data_files_storage などの UNC パスを指定します。
  4. ［実行］ をクリックします。

    結果 データ サブフォルダーのテーブルが保存フォルダーにエクスポートされます。

メモ

UNC パスを指定するときにエクスポート スクリプトが動作しない場合は、AX がインストールされているサーバーに一時保存フォルダーを作成して、テーブル ファイル共通フォルダー パスのローカル ファイル パスを指定します。

この方法では、移行プロセスの次の段階で、一時保存フォルダーのデータ テーブルを手動でコピーしなければならない場合があります。

移行スクリプトを ロボットに コミットする

  1. Table_Migration Analytics プロジェクトを開きます。
  2. Analytics メインメニューから、［ファイル］>［スクリプトをコミット As］を選択します。
  3. 必要に応じて、［送信先を選択］ダイアログボックスで、該当する Diligent One インスタンスをダブルクリックします。

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

  4. ロボットのリストで、データ テーブルの適切な移行先ロボットを選択し、［OK］をクリックします。

  5. Commit data table migration scripts などの簡潔なコミット メッセージを入力し、［OK］をクリックします。

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

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

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

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

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

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

ロボットでタスクを作成し、インポート スクリプトを実行する

  1. ロボットでタスクタブを選択し、タスクを作成をクリックします。

    タスク デザイナーが開きます。

  2. タスクの名前（例：Import data tables）を入力し、［保存］をクリックします。
  3. ［Data Tables Import］で［アナリティクスのアクティブ化 ］を選択します。

    メモ

    ［Data Tables Export］スクリプトは、ロボットではなく、AX 用です。

  4. 下矢印をクリックして、パラメーター セクションを展開します。
  5. ［テーブル ファイル共通フォルダー パス］で、データ ファイルに作成する一時保存フォルダーへのパスを入力します。
    • フォルダーがロボット エージェントと同じサーバーにある場合は、C:\Temp_data_files_storage
      • などのローカル ファイル パスを指定します。
    • ネットワークのフォルダーからファイルをインポートしている場合は、 \\<サーバー名>\Temp_data_files_storage などの UNC パスを指定します。
  6. ページの下部で［最後にスキップ］をクリックして、［タスクを確認し作成する］をクリックします。
  7. ［タスク］タブで、作成したタスクを選択し、［ > 今すぐ実行］をクリックします。

    結果 一時保存フォルダーのデータ テーブルがロボットにインポートされます。［タスク］タブまたは［タスクの実行］タブのいずれかでタスクの進捗を監視しできます。

  8. ［入力/出力］タブを選択して、インポートされたデータ テーブルを表示します。

    ［他のテーブル］セクションにテーブルが表示されます。個別のテーブルを選択し、［テーブルの詳細］サイドパネルを開きます。

    データ テーブルが正常にロボットにインポートされたことを確認したら、一時保存フォルダーの内容全体を削除できます。

メモ

UNC パスを指定するときにインポート スクリプトが動作しない場合は、ロボット エージェントがインストールされているサーバーに一時保存フォルダーを手動でコピーして、テーブル ファイル共通フォルダー パスのローカル ファイル パスを指定します。

一時保存フォルダーをコピーして貼り付けるか、FTP を使用できます。一時保存フォルダーをコピーできない場合は、IT 部門のサポートを依頼してください。

別の AX フォルダーおよびロボットで手順を繰り返す

必要に応じて、別の AX データ フォルダーとロボットでもデータ テーブルの移行プロセスを繰り返します。

ロボットで計画されたデータ構造と一致させるには、別の AX データ フォルダーから同じロボットにデータ テーブルを移行できます。各エクスポート処理の前に一時保存フォルダーを空にしてください。

  • AX でスクリプトをコピーする Table_Migration 分析アプリを AX フォルダー間でコピーすると、スクリプトを簡単に複製できます。Table_Migration プロジェクトを繰り返しインポートする必要はありません。

    メモ

    データ フォルダーを使用している場合は、スクリプトをコピーする必要がありません。必要に応じてステージング データ フォルダーの内容を更新し、同じ場所からエクスポート スクリプトを実行します。

  • 一時保存フォルダーを空にする前のグループのデータ テーブルが正常にロボットにインポートされたことを確認したら、一時保存フォルダーの内容全体を削除します。移行スクリプトは、一時保存フォルダーの複数のデータ フォルダーからデータ テーブルを蓄積するように設計されていません。
  • スクリプトをロボットに再コミットする Table_Migration Analytics プロジェクトのスクリプトを、使用する各ロボットにコミットする必要があります。ロボット間でのスクリプトのコピーはサポートされていません。

ロボットでリンクされたテーブルを作成する

AX でマスターおよびリンク データ テーブルを使用し、ロボットでも引き続きこれらのテーブルを使用したい場合は、ロボットでリンク関係を再作成する必要があります。設定の詳細については、ACL ロボットでのデータ テーブルの共有と関連付けを参照してください。

非 Analytics 関連ファイルをアップロードまたは移行する

ロボットで Excel や *.csv などの非 Analytics 関連ファイルを入力するには、次の 2 つの方法があります。

  • AX からロボットにファイルを移行する
  • ネットワーク上の場所からファイルをアップロードする

ファイルのアップロードに必要な手順はほとんどありません。ファイルの有無に応じて両方のオプションを使用しなければならない場合があります。使用する方法に関係なく、必ず各ファイルの最新バージョンをロボットに入力します。

AX からロボットにファイルを移行する

直接 AX からロボットに関連ファイルを移行することはできません。AX とロボットの両方からアクセス可能な中間の場所（自分のコンピューターなど）に、AX の関連ファイルをエクスポートします。

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

  1. エクスポートされたファイルを保存するためのフォルダーをコンピューターで作成します。
  2. Server Explorer で次のいずれかを実行します。
    • 関連ファイル フォルダーを選択して、フォルダーのすべてのファイルをエクスポートする
    • Ctrl キーを押しながらクリックして関連ファイル フォルダーの個別のファイルを選択する
  3. ［ファイル > エクスポート］を選択します。
  4. ［エクスポート］ダイアログ ボックスで、［エクスポートしたファイルで作業しますか?］をオフにします。
  5. ［参照］をクリックして、ファイルを保存するために作成したフォルダーを選択し、［OK］をクリックします。
  6. ［OK］をクリックして、ファイルをエクスポートします。

    指定した場所にファイルがエクスポートされます。

  7. 移行する他の関連ファイル フォルダーのファイルでもこの手順を繰り返します。
  8. 次の手順を使用して、ファイルのアップロードを続けます。

ネットワーク上の場所からファイルをアップロードする

最新バージョンの関連ファイルがローカルまたはネットワークの場所に保存されている場合は、直接ロボットにアップロードできます。

メモ

関連ファイルは、サイズが 1 GB 未満かつ、許可されたファイルの種類を持っていなくてはなりません。許可されたファイルの種類の一覧については、ロボットで許可されているファイル タイプを参照してください。

  1. Launchpad ホームページ（www.highbond.com）の［監査とアナリティクス］の下で、ロボット アプリをクリックします。

    まだ Diligent One にサインインしていなければ、サインインする必要があります。

  2. ロボットのダッシュボードから、［ACL ロボット］を選択します。
  3. 関連ファイルをアップロードするロボットに移動し、そのロボットを選択して開きます。
  4. ロボットの右上隅で、［開発］をクリックし、開発モードに切り替えます。

    本番モード ヘッダーは明るい背景で、開発モード ヘッダーは暗い背景です。

  5. ［入力/出力］タブでは、次のいずれかを実行します。
    • ドラッグ＆ドロップ お使いのローカル ファイル システムから 1 つ以上のファイルを選択し、［ドラッグ＆ドロップ］アップロード セクションにこれらをドラッグします。
    • ファイルを選択 ［ファイルを選択］をクリックし、ローカル ファイル システムからアップロードするファイルを閲覧し、これを選択し、［開く］をクリックします。

    結果 ファイルが［入力/出力］タブの［ファイル］にアップロードされ、表示されます。

次にすべきこと

1 つ以上の自動プロセスのデータを移行すると、ロボットで自動 AX プロセスを再作成するに進むことができます。