Salesforce Docs Portal

Anypoint Studio を使用した Workday Connector 16.1 の設定

Anypoint Studio (Studio) エディターは、Mule アプリケーション、プロパティ、および設定ファイルの設計と更新に役立ちます。

Studio でコネクタを追加および設定する手順は、次のとおりです。

  1. Mule プロジェクトを作成します。

  2. コネクタを Mule プロジェクトに追加します。

  3. コネクタのフローのソースを設定します。

  4. フローにコネクタの操作を追加します。

  5. コネクタのグローバル要素を設定します。

「アプリケーションログの表示」​で説明されているように、コネクタを実行するときに、アプリケーションログを表示して問題を確認できます。

Studio で初めてコネクタを設定する場合は、​「Anypoint Studio を使用したコネクタの設定」​を参照してください。このトピックを参照した後、コネクタ項目についての詳細情報が必要な場合は、​「Workday Connector リファレンス」​を参照してください。

Mule プロジェクトを作成する

Studio で、コネクタを追加および設定する新しい Mule プロジェクトを作成します。

  1. Studio で、​[File (ファイル)] > [New (新規)] > [Mule Project (Mule プロジェクト)]​ を選択します。

  2. Mule プロジェクトの名前を入力して、​[Finish (完了)]​ をクリックします。

コネクタを Mule プロジェクトに追加する

Workday Connector を Mule プロジェクトに追加して、XML コードにコネクタの名前空間およびスキーマの場所を自動的に入力し、プロジェクトの ​pom.xml​ ファイルに必須の連動関係を追加します。

  1. [Mule Palette (Mule パレット)]​ ビューで、​[(X) Search in Exchange ((X) Exchange 内を検索)]​ をクリックします。

  2. [Add Dependencies to Project (連動関係をプロジェクトに追加)]​ で、検索項目に「​workday​」と入力します。

  3. [Available modules (使用可能なモジュール)]​ で ​[Workday Connector]​ をクリックします。

  4. [Add (追加)]​ をクリックします。

  5. [Finish (完了)]​ をクリックします。

Studio でコネクタを Mule プロジェクトに追加しても、Studio ワークスペースの他のプロジェクトはそのコネクタを使用できません。

ソースの設定

入力元 (リスナー) は、指定された条件が満たされたときにフローを開始します。

次の入力元のいずれかを設定して、Workday Connector で使用できます。

  • On Modified Objects​
    Workday でオブジェクトが作成されたときにアプリケーションを開始します。

  • HTTP Listener​
    設定されたホストとポートで要求を受信するたびにフローを開始する

  • Scheduler​
    時間ベースの条件が満たされたときにフローを開始する

On Modified Objects​ 入力元を設定するには、次の手順に従います。

  1. [Mule Palette (Mule パレット)]​ ビューで、​[Workday] > [On Modified Objects]​ を選択します。

  2. [On Modified Objects]​ 入力元を Studio キャンバスにドラッグします。

  3. [On Modified Objects]​ 設定画面で、必要に応じて ​[Display Name (表示名)]​ 項目の値を変更します。

  4. 次の項目に必須情報を入力します。

    Studio 項目 説明

    Connector configuration (コネクタ設定)

    [Global Element Properties (グローバル要素プロパティ)] 設定名。

    Object type (オブジェクト種別)

    Workday オブジェクトの種別

    Scheduling Strategy (スケジュール戦略)

    ソースにデータをポーリングできる方法が指示されます。この項目には 2 つのオプションを使用できます。

    • Fixed Frequency (一定間隔)​
      指定されたミリ秒数、秒数、分数、時間数、または日数でデータをポーリングします。デフォルト値は 1000 ミリ秒です。

    • Cron​
      指定された期間の月の毎週金曜日など、検索条件に基づいてデータをポーリングする式を受け入れます。例については​「Cron 式」​を参照してください。

  5. [Connector configuration (コネクタ設定)]​ 項目の横にあるプラス記号 (​+​) をクリックして、アプリケーション内の ​On Modified Objects​ 操作のすべてのインスタンスで使用できる​グローバル要素を設定します​。

フローにコネクタの操作を追加する

フローにコネクタの操作を追加すると、そのコネクタで実行する特定の操作をすぐに定義できます。

Workday Connector の操作を追加するには、次の手順に従います。

  1. [Mule Palette (Mule パレット)]​ ビューで ​[Workday]​ を選択し、目的の操作を選択します。

  2. その操作を Studio キャンバスの入力元の右にドラッグします。

各 Workday 操作では Anypoint Studio に独自の必須項目があります。詳細は、​「Workday リファレンス」​を参照してください。

グローバル要素の設定

コネクタを設定する場合、アプリケーション内のそのコネクタのすべてのインスタンスで使用できるグローバル要素を設定することをお勧めします。グローバル要素を設定するには、コネクタが対象の Workday システムにアクセスするために必要な認証ログイン情報を指定する必要があります。Workday Connector では、基本認証と X.509 認証がサポートされています。

Workday Connector のグローバル要素を設定する手順は、次のとおりです。

  1. Studio キャンバスで操作を選択します。

  2. 操作の設定画面で、​[Connector configuration (コネクタ設定)]​ 項目の横にあるプラス記号 (​+​) をクリックし、グローバル要素設定項目にアクセスします。

  3. [General (一般)]​ タブで、​「基本認証」​セクションまたは​「X.509 認証」​セクションの説明に従って接続の認証を設定します。

    ANT スタイルのプロパティプレースホルダーを含む設定ファイルを参照するか (推奨)、グローバル設定プロパティに認証ログイン情報を入力できます。プロパティプレースホルダーを使用する利点とその設定方法については、​「Anypoint Connector 設定」​を参照してください。

  4. [Advanced (詳細)]​ タブで、必要に応じて再接続戦略を含む再接続情報を指定します。

  5. [Test Connection (接続をテスト)]​ をクリックして、Mule が指定されたサーバーに接続できることを確認します。
    [Test Connection (接続をテスト)]​ ボタンを使用して接続性を検証するために、Workday Connector は ​Get_Degrees​ 操作で ​Performance_Management​ サービスを使用します。そのサービスで操作を実行する権限がサービスアカウントにあることを確認してください。

    セキュリティポリシー ドメイン/機能エリア 許可されたセキュリティグループ

    セットアップ: スキルと経験

    ワーカープロファイルとスキル

    • HR 管理者

    • HR システム

    • 実装者

    • 職務および役職管理者

    • 学習管理システム

    実装

    実装者

    特殊 OX Web サービス

    実装

  6. [OK]​ をクリックします。

基本認証

[Global Element Properties (グローバル要素のプロパティ)]​ 画面の ​[General (一般)]​ タブで次の情報を入力し、基本認証を設定します。

項目 説明

Connection (接続)

[インターネットオプション]​ を選択します。

Password (パスワード)

ログイン用のパスワードを入力します。

Host Name (ホスト名)

Workday のいずれかのクラウドサーバーのホスト名を入力します。

Tenant Name (テナント名)

Workday テナント ID を入力します。通常は、​acme_pt1​ のようにサフィックス ​pt1​ が付加されます。 このパラメーターは式をサポートするため、このパラメーターの値を動的に変更できます。たとえば、式を使用してマルチテナント接続を作成できます。

User Name (ユーザー名)

ログイン用のユーザー名を入力します。

x.509 認証

[Global Element Properties (グローバル要素のプロパティ)]​ 画面の ​[General (一般)]​ タブで次の情報を入力し、X.509 認証を設定します。

項目 説明

Connection (接続)

[x.509 Authentication (x.509 認証)]​ を選択します。

ホスト名

Workday クラウドサーバーのホスト名を入力します。

Tenant name (テナント名)

Workday テナント ID を入力します。通常は、​acme_pt1​ のようにサフィックス ​pt1​ が付加されます。 このパラメーターは式をサポートするため、このパラメーターの値を動的に変更できます。たとえば、式を使用してマルチテナント接続を作成できます。

User Name (ユーザー名)

ログイン用のユーザー名を入力します。

Key store path (キーストアのパス)

キーストアファイルの場所を入力します。

Type (型)

キーストア種別を選択します。

Password (パスワード)

キーストアを参照するためのパスワードを入力します。

Alias (別名)

非公開キーのエイリアスを入力します。

Signature Algorithm (署名アルゴリズム)

署名アルゴリズムを入力します。

Digest Algorithm (ダイジェストアルゴリズム)

ダイジェストアルゴリズムを入力します。

Canonicalization algorithm (正規化アルゴリズム)

c14n (正規化) アルゴリズムを入力します。

その他のコネクタ項目の設定

Workday Connector のグローバル要素を設定したら、​「Workday リファレンス」​の説明に従ってコネクタの他の必須項目を設定します。

アプリケーションログの表示

問題を確認するため、アプリケーションログを次の方法で表示できます。

  • アプリケーションを Anypoint Platform から実行している場合、出力は Anypoint Studio のコンソールウィンドウに表示される。

  • コマンドラインから Mule を使用してアプリケーションを実行している場合、アプリケーションログは OS コンソールに表示される。

アプリケーションのログファイル (​log4j2.xml​) でログファイルパスがカスタマイズされていない場合、デフォルトの場所 ​MULE_HOME/logs/<app-name>.log​ でアプリケーションログを表示することもできます。

次のステップ

Studio で Workday Connector を設定したら、​「例」​で説明されている、このコネクタの使用方法を説明した財務管理ユースケースを参照してください。

関連情報