メインコンテンツにスキップ
ドキュメント
ドキュメント
Adaptive Planning
最終更新: 2023-06-23
Workday Adaptive Planning データ エージェント マネージャの設定

Workday Adaptive Planning データ エージェント マネージャの設定

Workday Adaptive Planning データ エージェント マネージャをお使いのパソコンにインストールした後、起動して設定を行う必要があります。

前提条件

  • 必要な権限: "インテグレーション" > "データ デザイナー"
  • Adaptive Planning の有効な ユーザー名とパスワードへのアクセス権があることを確認します。
  • お使いのネットワークで許可されていることを確認してください
    *.adaptiveplanning.com
     ドメイン、およびコンピュータ上でポート 443 が開いていること。

ナビゲーション

Compass.png ナビゲーション メニューから、
"インテグレーション"
"インテグレーション設定"
 へ移動します。

ステップ

  1. Workday Adaptive Planning データ エージェント マネージャを起動し、接続を確認します。
  2. Workday Adaptive Planning データ エージェント マネージャを設定します。

Workday Adaptive Planning データ エージェント マネージャの起動と接続の確認

  1. ローカル コンピュータで Workday Adaptive Planning データ エージェント マネージャを検索して起動します。
  2. ログイン プロンプトで
    "Diagnose and Configure Network"
     を選択して、設定およびクラスタ URL ダイアログを開きます。
  3. ネットワークで必要な場合はプロキシ設定を行い、
    "プロキシ設定の更新"
     を選択して保存します。
  4. "サービス インターネット アクセスのテスト"
    、
    "インターネット アクセスのテスト"
     の順に選択し、接続を確認します。
  5. "クラスタ URL"
     を選択し、設定を確認します。デフォルトでは、管理者およびサーバー URL は以下を使用します。
    Adaptive Planning
    adaptiveplanning.com
     ドメイン
  6. 有効な ID でログインしてください
    Adaptive Planning
     ユーザー名とパスワードを入力して、Workday Adaptive Planning データ エージェント マネージャを開きます。インスタンスが Workday に対応しており、Workday のユーザーを と同期させた場合、
    Adaptive Planning
    にアクセスするには、Workday 認証情報を使用する必要があります。Workday の認証情報を使用したデータ エージェントおよびスクリプト エディタへのログインを参照してください。
  7. "サービス インターネット接続" フィールドで、サービス インターネット接続のステータスが明るい緑色で表示されていて、正常な状態になっていることを確認します。
データ エージェント マネージャの
"セットアップ"
 タブから
"リフレッシュ"
 を選択し、選択したサーバーへの接続を再確立します。
"Diagnose and Configure Network"
 を選択して、ネットワーク設定を調整することもできます。
Workday Adaptive Planning データ エージェント マネージャを実行しているコンピュータは、ポート 443 を使用して .adaptiveplanning.com にアクセスできる必要があります。
(任意) アプライアンス クラスタ ベース URL の設定
"診断と構成
 " ボタンを使用すると、アプライアンス クラスタ ベースの URL を設定できます。
ダッシュボード
 カスタム クラスタでアプライアンスとして実行します。このボタンでは、
Adaptive Planning
 サーバー情報変更する前に Adaptive Planning サポートにご連絡ください。
  1. "このクラスタに必要なセットアップ"
     を選択し、クラスタ ベース URL への変更を保存します。
  2. "クラスタ設定の適用"
     を選択し、以下への変更を保存します。
    Adaptive Planning
     サーバー情報を復元するか、
    "デフォルトを復元"
     を選択してデフォルト値を復元します。
  3. データ エージェント マネージャの
    "セットアップ"
     タブの "サービス インターネット接続" フィールドが緑色に変わり、正常な状態になっていることを確認します。
ゲートウェイ URL と地理
ゲートウェイ URL フィールドと地理フィールドは、エージェントのインストールとプロビジョニング時に自動的に入力されます。
"セットアップ" タブの "推奨アクション" がゲートウェイの地理的競合を示している場合、"クラスタ URL" タブで
"地理の切り替え"
 ボタンがアクティブになります。
ゲートウェイ設定や地理設定を変更する前に、Workday カスタマー センターでケースを作成してください。

Workday Adaptive Planning データ エージェント マネージャの設定

ネットワーク接続を確立した後、以下の手順を実行します。
  1. Workday Adaptive Planning データ エージェント マネージャで
    "サービス情報とオプション"
     を選択します。
  2. ネットワーク設定を調整しても変更を確認できない場合は、
    "リフレッシュ"
     を数回選択します。
  3. 設定をレビューします。
    • リモート アクセス URL (ホストのヒント):
      (読み取り専用) URL は、Workday Adaptive Planning データ エージェント マネージャとインテグレーション サーバーを接続するゲートウェイを一意的に識別します。
    • データ エージェント サービス ID:
       (読み取り専用) 特定のエージェント サービスを一意的に識別します。エージェント サービス ID がリモート アクセス URL に追加されると、特定のデータ エージェント サービスを指定する完全な URL が生成されます。
    • エージェント当たりの最大ディスク ストレージ (MB):
       各エージェントによって抽出された情報を保存するためのメガバイト単位のディスク ストレージです。無制限の場合は「-1」を入力します。
    • Kettle ジョブ ランナーの数:
       このコンピュータで許可されている Kettle ジョブ ランナーの数 (通常は 1)。ランナーが多いほど RAM が使用されるため、数は少なくすることをお勧めします。
    • ジョブ ランナー当たりの最大メモリ (MB):
       ジョブ ランナーごとの最大メモリ (メガバイト単位)。
    • ジョブ ランナー当たりの最大テンポラリ ディスク容量 (MB):
       ジョブ ランナーごとの最大テンポラリ ディスク容量 (メガバイト単位)。無制限の場合は「-1」を入力します。
    • 信頼済みテナント:
       このコンピュータにログインせずに、インターネット経由でこのコンピュータに新しいエージェントを作成することを許可されているテナントです。"任意のテナントのユーザーがこのパソコンでエージェントを作成できる" を選択することもできます (推奨されません)。ただし、データへのアクセスを制御できない場合があります。
    • ジョブ ランナーによるファイルへのアクセスの制限:
       デフォルトで選択されます。データ エージェントのコントロール下でローカル ファイルへのアクセスを制限します。ファイル システムのすべてのファイルにアクセスするには、オフにします。
    • 詳細ロギング:
       詳細ロギングを選択します。
    • すべての通信を記録:
      すべてのデータベースの入力および、Workday Adaptive Planning データ エージェント マネージャとエージェント間のネットワーク通信を記録します。
    • 印字不可文字をスクラブ:
      入力テキスト ストリームから不正な XML 文字や不要な文字を削除または変換します。必須
      scrubbingRules.txt
       ファイル (不要な文字をさらに削除する場合)詳細については、次のセクション「JDBC および Microsoft Dynamics GP の入力テキスト ストリームから指定された文字を削除」を参照してください。
  4. "データ エージェント サービス ログの表示"
     を選択してログ ファイルを表示することにより、接続の問題をトラブルシューティングします。
  5. "データ エージェント サービス設定の適用"
     を選択して、変更を適用します。
JDBC および Microsoft Dynamics GP の入力テキスト ストリームから指定された文字を削除
データ エージェントが JDBC データ ソースまたは Microsoft Dynamics GP データ ソースを介してデータをロードする場合、データは XML としてローカル ハード ディスクに書き込まれます。この XML には制御文字が含まれている場合があります。
  • タブ (0x9)
  • 改行 (0xA)
  • キャリッジ リターン (0xD)
  • その他の印字不可文字
データ エージェントは、エンコードせずにこれらの XML ファイルにデータをストリーミングします。XML 文字範囲外の制御文字がストリーミングされると、エラーが表示されます。以下を使用して、入力テキスト ストリームから不正な XML やその他の不要な文字を削除または変換できます。
scrubbingRules.txt
 ファイル
  1. 次の名前のテキスト ファイルを作成
    scrubbingRules.txt
     で
    C:\Program Files\Workday Adaptive Planning Data Agent.
     データ エージェント バージョン 7.1.44 以前を使用
    C:\Program Files\Adaptive Data Agent
  2. 削除または変換する文字を以下のリストにリストします:
    scrubbingRules.txt
     ファイル
    • 各行には、「=」で区切られた変更前の文字と変更後の値を含める必要があります。
    • 文字を削除する場合は、変更後の値を空のままにします。各文字は Unicode 値で表されなければなりません。
    • # で始まる行はコメントとして扱われます。
    例
    scrubbingRules.txt
     ファイル コンテンツ:
    
#Tab, New Line and CR

0009=

000A=

000D=

#|=_

007C=005F
  3. Workday Adaptive Planning データ エージェント マネージャを起動します。
  4. "サービス情報とオプション"
     タブを選択し、
    "印字不可文字をスクラブ"
     を選択します。
  5. "データ エージェント サービス設定を適用"
     を選択します。
    "印字不可文字をスクラブ"
    を選択した場合、すべての不正な XML 文字は、入力データに表示されない場合も含め、入力データから消去されます。
    scrubbingRules.txt
     ファイル
  6. データ エージェント ウィンドウ サービスを再起動します。
"印字不可文字をスクラブ" が
 スクリプト化されたデータ ソースに影響を与えることはありません。スクリプト作成を使用して、必要に応じて文字を削除または変換します。

データ エージェント問題のトラブルシューティングに関連するログの検索

問題のトラブルシューティングが必要な場合や、サポートからトラブルシューティングを要求された場合は、以下でログを見つけることができます。
C:Windows\System32\config\systemprofile\AppData\Local\Adaptive AgentService\Agents\<agentId>\Logs\AgentLog.txt
C:Windows\System32\config\systemprofile\AppData\Local\AdaptiveDaemon\DaemonLog.txt