---
schema_version: "1"
id: 7bc9d8e56998b2888fb91708b7d51233ab62c6820637bdd5cc74788bec9fb19c
title: Workday - コネクタのバージョン 12.0 へのアップグレード - Mule 4
collection: mulesoft
version: current
locale: ja-jp
portal_url: https://docs.salesforce.com/mulesoft/current/ja-jp/workday-connector/12.0/workday-connector-upgrade-migrate.md
canonical_url: https://docs.mulesoft.com/jp/workday-connector/12.0/workday-connector-upgrade-migrate
source_site: docs.mulesoft.com
content_type: documentation
content_hash: 4d9056c1059cd4a09df4890b94c5aeb2f8b40e5f5cdbfd0f79e737c06d6a497d
description: MuleSoft Documentation Site
release: "12.0"
latest: false
---
# Workday - コネクタのバージョン 12.0 へのアップグレード - Mule 4

Workday 用 Anypoint Connector (Workday Connector) をバージョン 12.0.0 にアップグレードします。

## [](#サポートされているアップグレードパス)サポートされているアップグレードパス

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 50%;">
<col style="width: 50%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">開始バージョン</th>
<th class="tableblock halign-left valign-top">終了バージョン</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>11.1.x</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>12.0.0</p>
</div></div></td>
</tr>
</tbody>
</table>

## [](#このリリースでの変更)このリリースでの変更

このリリースには、次の変更が含まれています。

- Workday API を 34.0 にアップグレード
- Workday Student Core Web サービスを呼び出すための `Student Core`​ 操作を追加
- `On New Objects`​ 入力元を、データをより効率よくポーリングする `On Modified Objects`​ 入力元に変更。
    
    詳細は、[​「On Modified Objects 入力元」](#on-modified-objects)​を参照してください。
- ヘッダーを属性として返すようにすべての操作を変更
- 新しい `Response Timeout`​ 項目と `Response Timeout Unit`​ 項目を使用して、入力元 (`On Modified Objects`​) とすべてのコネクタ操作で応答タイムアウトを設定する機能を追加
- 接続タイムアウト項目を、値と時間単位の項目に分割
    
    詳細は[​「接続種別の変更」](#changes-in-connection-types)​を参照してください。
- `Reconnect`​ オブジェクトと `Reconnect Forever`​ オブジェクトから `blocking`​ 項目を削除
- `WORKDAY:UNKNOWN`​ エラー種別を削除

## [](#changes-in-connection-types)接続種別の変更

以下の項目は、値と時間単位の項目に分割されました。

<table class="tableblock frame-all grid-all fit-content spread">
<colgroup>
<col>
<col>
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">v11.1.x の項目</th>
<th class="tableblock halign-left valign-top">変更後</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Connection Idle Timeout (接続アイドルタイムアウト)</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Connection Idle Timeout (接続アイドルタイムアウト) と Connection Idle Timeout Unit (接続アイドルタイムアウト単位)</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Connection Timeout (接続タイムアウト)</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Connection Timeout (接続タイムアウト) と Connection Timeout Unit (接続タイムアウト単位)</p></td>
</tr>
</tbody>
</table>

## [](#on-modified-objects)On Modified Objects 入力元

Workday Connector バージョン 11.1.x の `On New Objects`​ 入力元は、指定された期間の最初から現在まで Workday リソースのデータをポーリングしていました。この処理を Workday インスタンスの各ワーカーに対して行っていたため、インスタンスに数千ものワーカーが含まれている場合は、時間効率が非常に悪くなっていました。

新しい `On Modified Objects`​ 入力元は、常に指定された期間で最新のデータをポーリングします。1 回のポーリングの反復後、この入力元は最も古い瞬間を前回の最も新しい瞬間として設定し、最も新しい瞬間を現在の日付と時刻として設定します。これらのポーリングの変更により、`On Modified Objects`​ 入力元は `On New Objects`​ 入力元よりはるかに効率的になりました。

`On Modified Objects`​ 入力元は、次の Web サービスと操作で使用できます。

- `Human Resources Web Service`​
    
    - `Get Job Profiles`​ 操作
- `Recruiting`​ Web サービス
    
    - `Get Evergreen Requisitions`​ 操作
    - `Get Job Requisitions`​ 操作
- `Staffing`​ Web サービス
    
    - `Get Workers`​ 操作
    - `Get Positions`​ 操作

次の例は、`On Modified Objects`​ 入力元の使い方を示しています。この例の動作は次のようになります。

- `HTTP Listener`​ は、`localhost:8081/put-worker`​ パス上でイベントをリスンします。
    
    `HTTP Listener`​ がこのパス上でイベントを検出すると、最初のフローを開始します。このフローは、新しい役職を作成し、作成された役職に対して新しいワーカーを雇用します。
- `On Modified Objects`​ 入力元は、サーバー上でのデータの変更をリスンします。
    
    新しいワーカーが雇用されたというメッセージを入力元が受け取ると、次のフローを開始します。このフローは、ワーカーの情報を Anypoint Studio コンソールに記録します。

この例のフローをすばやく Mule アプリケーションに読み込むには、次のコードを XML エディターに貼り付けます。必要に応じて、環境に合わせて値を変更します。

```xml
<?xml version="1.0" encoding="UTF-8"?>
<mule xmlns:workday="http://www.mulesoft.org/schema/mule/workday" xmlns:ee="http://www.mulesoft.org/schema/mule/ee/core"
    xmlns:http="http://www.mulesoft.org/schema/mule/http"
    xmlns="http://www.mulesoft.org/schema/mule/core" xmlns:doc="http://www.mulesoft.org/schema/mule/documentation" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.mulesoft.org/schema/mule/core http://www.mulesoft.org/schema/mule/core/current/mule.xsd
http://www.mulesoft.org/schema/mule/http http://www.mulesoft.org/schema/mule/http/current/mule-http.xsd
http://www.mulesoft.org/schema/mule/ee/core http://www.mulesoft.org/schema/mule/ee/core/current/mule-ee.xsd
http://www.mulesoft.org/schema/mule/workday http://www.mulesoft.org/schema/mule/workday/current/mule-workday.xsd">
    <http:listener-config name="HTTP_Listener_config" doc:name="HTTP Listener config" >
        <http:listener-connection host="0.0.0.0" port="8081" />
    </http:listener-config>

    <workday:config-version-34-config
            name="Workday-Config" doc:name="Workday Config version 34"  timeZone="UTC+01:00">
        <workday:basic-authentication-api-v34-connection userName="user" password="password" tenantName="tenant" hostName="host.com"/>
    </workday:config-version-34-config>
    <flow name="create-worker-flow" >
        <http:listener doc:name="/put-worker" config-ref="HTTP_Listener_config" path="/put-worker" />
        <ee:transform doc:name="testData">
            <ee:message>
            </ee:message>
            <ee:variables >
                <ee:set-variable variableName="testData" ><![CDATA[%dw 2.0
output application/java
var randomNumber = randomInt(999999999) as String
---
{
        countryReference: "USA",
        countryReferenceID: "bc33aa3152ec42d4995f4791a106ed09",
        communicationUsageTypeID: "Home",
        currentDate: (now() - |P1D|) as Date,
        employeeEmailAddress: "test_email" ++ randomNumber ++ "@gmail.com",
        employeeFirstName: "Jim",
        employeeLastName: "Jones_" ++ randomNumber,
        employeeTypeID: "Casual",
        jobPositionTitle: "test-position-"  ++ randomNumber,
        jobProfileID: "37600",
        locationID:  "San_Francisco_site" ,
        organizationReferenceID: "Human_Resources_supervisory",
        positionTimeTypeID: "Full_time"
}]]></ee:set-variable>
            </ee:variables>
        </ee:transform>
        <ee:transform doc:name="Prepare Create Position Request">
            <ee:message >
                <ee:set-payload ><![CDATA[%dw 2.0
output application/xml
ns ns0 urn:com.workday/bsvc
---
{
    ns0#Create_Position_Request @(ns0#version: "v33.2"): {
        ns0#Create_Position_Data: {
            ns0#Supervisory_Organization_Reference @(ns0#"Descriptor": "Descriptive"): {
                ns0#ID @(ns0#"type": "Organization_Reference_ID"): vars.testData.organizationReferenceID
            },
            ns0#Position_Data: {
                ns0#Job_Posting_Title: vars.testData.jobPositionTitle
            },
            ns0#Position_Group_Restrictions_Data: {
                ns0#Availability_Date : vars.testData.currentDate,
                ns0#Earliest_Hire_Date: vars.testData.currentDate
            }
        }
    }
}]]></ee:set-payload>
            </ee:message>
        </ee:transform>
        <workday:staffing operation="Create_Position" doc:name="Create Position" config-ref="Workday-Config"/>
        <ee:transform doc:name="Prepare Hire Employee Request">
            <ee:message >
                <ee:set-payload ><![CDATA[%dw 2.0
output application/xml
ns ns0 urn:com.workday/bsvc
---
{
    ns0#Hire_Employee_Request @(ns0#version: "v33.2"): {
        ns0#Hire_Employee_Data:{
            ns0#Applicant_Data: {
            ns0#Personal_Data: {
             ns0#Name_Data: {
               ns0#Legal_Name_Data: {
                ns0#Name_Detail_Data: {
                  ns0#Country_Reference @(ns0#"Descriptor": "Country_Reference"): {
                    ns0#ID @(ns0#"type": "ISO_3166-1_Alpha-3_Code"): vars.testData.countryReference
                },
                ns0#First_Name: vars.testData.employeeFirstName,
                ns0#Last_Name: vars.testData.employeeLastName,
              }
            }
            },
            ns0#Contact_Data: {
                ns0#Email_Address_Data @(ns0#"Delete": "false" , ns0#"Do_Not_Replace_All": "false") : {
                    ns0#Email_Address : vars.testData.employeeEmailAddress,
                    ns0#Usage_Data @(ns0#"Public": "false"): {
                        ns0#Type_Data @(ns0#"Primary": "true") : {
                            ns0#Type_Reference @(ns0# "Descriptor": "Type_Reference"): {
                                ns0#ID @(ns0#"type": "Communication_Usage_Type_ID "): vars.testData.communicationUsageTypeID
                            }
                      }
                    }
                }
            }
          }
        },
        ns0#Organization_Reference @(ns0# "Descriptor": "Organization_Reference"): {
            ns0#ID @(ns0#"type": "Organization_Reference_ID"): vars.testData.organizationReferenceID
        },
        ns0#Position_Reference @(ns0# "Descriptor": "Position_Reference"): {
            ns0#ID @(ns0#"type": "WID"): payload.ns0#Create_Position_Response.ns0#Position_Reference.ns0#ID
        },
        ns0#Hire_Date: vars.testData.currentDate,
        ns0#Hire_Employee_Event_Data: {
            ns0#Employee_Type_Reference @(ns0# "Descriptor": "Hire_Reference"): {
                ns0#ID @(ns0#"type": "Employee_Type_ID "): vars.testData.employeeTypeID
            },
            ns0#Position_Details: {
                ns0#Job_Profile_Reference @(ns0# "Descriptor": "Hire_Reference"): {
                    ns0#ID @(ns0#"type": "Job_Profile_ID "): vars.testData.jobProfileID
                },
                ns0#Location_Reference @(ns0# "Descriptor": "Hire_Reference"): {
                    ns0#ID @(ns0#"type": "Location_ID"): vars.testData.locationID
                },
                ns0#Position_Time_Type_Reference @(ns0# "Descriptor": "Hire_Reference"): {
                    ns0#ID @(ns0#"type": "Position_Time_Type_ID"): vars.testData.positionTimeTypeID
                }
            }
        }
      }
    }
}]]></ee:set-payload>
            </ee:message>
        </ee:transform>
        <workday:staffing operation="Hire_Employee" doc:name="Hire Employee" config-ref="Workday-Config" />
    </flow>
    <flow name="listener-flow" >
        <workday:modified-objects-listener objectType="WORKERS" doc:name="On Modified Objects Listener" config-ref="Workday-Config">
            <scheduling-strategy >
                <fixed-frequency />
            </scheduling-strategy>
        </workday:modified-objects-listener>
        <logger level="INFO" doc:name="Logger - On Modified Objects" message='#[payload]'/>
    </flow>
    </mule>
```

## [](#アップグレード前提条件)アップグレード前提条件

Workday Connector をバージョン 11.1.x からバージョン 12.0.0 にアップグレードする前に、以下の作業を行う必要があります。

1. 以前のバージョンに復元する必要がある場合に備えて、ファイル、データ、設定のバックアップを作成します。
2. Workday Connector v12.0 をインストールし、以前に Workday Connector v11.1.x に含まれていた Workday 操作を置き換えます。

## [](#アップグレード手順)アップグレード手順

Workday Connector v11.1.x から Workday Connector v12.0 にアップグレードする手順は、次のとおりです。

1. Studio で Mule プロジェクトを作成します。
2. \[Mule Palette (Mule パレット)\] ビューで、**\[Search in Exchange (Exchange 内を検索)\]**​ をクリックします。
3. **\[Add Dependencies to Project (連動関係をプロジェクトに追加)\]**​ ウィンドウで、検索項目に「`Workday`​」と入力します。
4. **\[Available modules (使用可能なモジュール)\]**​ セクションで、**\[Workday Connector (Workday Connector)\]**​ を選択し、**\[Add (追加)\]**​ をクリックします。
5. **\[Finish (完了)\]**​ をクリックします。
6. `pom.xml`​ ファイルで `workday-connector`​ 連動関係のバージョンが `12.0.0`​ であることを確認します。

Studio はコネクタを自動的にアップグレードします。

## [](#アップグレードを確認する)アップグレードを確認する

コネクタの最新バージョンをインストールしたら、次の手順に従ってアップグレードを確認します。

1. Studio の **\[Problems (問題)\]**​ または **\[Console (コンソール)\]**​ ビューでエラーがないことを確認します。
2. プロジェクトの `pom.xml`​ ファイルをチェックして、問題がないことを確認します。
3. 接続をテストして、操作が機能することを確認します。

## [](#トラブルシューティング)トラブルシューティング

パラメーターおよびメタデータのキャッシュに問題がある場合は、Studio を再起動してください。

## [](#アップグレードの復元)アップグレードの復元

以前のバージョンの Workday Connector に戻す必要がある場合、プロジェクトの `pom.xml`​ ファイルの `workday-connector`​ 連動関係バージョンを前のバージョン `12.0.0`​ に変更します。

Studio でプロジェクトの `pom.xml`​ ファイルを更新する必要があります。

## [](#関連情報)関連情報

- [Anypoint Connector の概要](https://docs.mulesoft.com/connectors/introduction/introduction-to-anypoint-connectors)
- [MuleSoft ヘルプセンター](https://help.mulesoft.com)