---
schema_version: "1"
id: f61171f213538c70feb2406735147cdf38b899c59981e5f8ebde79ec425e1f9c
title: Microsoft Dynamics GP Connector
collection: mulesoft
version: current
locale: ja-jp
portal_url: https://docs.salesforce.com/mulesoft/current/ja-jp/microsoft-dynamics-gp-connector/2.1/index.md
canonical_url: https://docs.mulesoft.com/jp/microsoft-dynamics-gp-connector/2.1/
source_site: docs.mulesoft.com
content_type: documentation
content_hash: e9c3b3fc5088733f911c441c89d141db1f8dcd63cc7abc34f1b1d63b5fffc45e
description: MuleSoft Documentation Site
release: "2.1"
latest: true
---
# Microsoft Dynamics GP Connector

Microsoft Dynamics GP Connector v2.1

Microsoft Dynamics GP 用 Anypoint Connector を使用して、Mule アプリケーションは Microsoft Dynamics Great Plains (GP) Web サービスとやりとりすることができます。

リリースノート: [Microsoft Dynamics GP Connector リリースノート](https://docs.mulesoft.com/jp/release-notes/connector/microsoft-dynamics-gp-connector-release-notes-mule-4)​  
Exchange: [Microsoft Dynamics GP Connector](https://www.mulesoft.com/exchange/com.mulesoft.connectors/mule-microsoft-dynamics-gp-connector/)

## [](#始める前に)始める前に

この情報を使用するには、Microsoft Dynamics GP、Mule Runtime Engine (Mule)、Anypoint Connector、Anypoint Studio、Mule の概念、Mule フローの要素、グローバル要素に精通している必要があります。

このコネクタを使用するには次が必要です。

- Microsoft Dynamics GP インスタンス。
- Kerberos 接続に使用する有効なログイン情報。
- MuleSoft Enterprise ライセンス。

## [](#pom-ファイル情報)POM ファイル情報

```xml
<dependency>
  <groupId>com.mulesoft.connectors</groupId>
  <artifactId>mule-microsoft-dynamics-gp-connector</artifactId>
  <version>x.x.x</version>
  <classifier>mule-plugin</classifier>
</dependency>
```

`x.x.x`​ を使用しているコネクタに対応するバージョンに置き換えます。

最新の ​`pom.xml`​ ファイル情報を取得するには、​ [Anypoint Exchange](https://www.mulesoft.com/exchange/)​ でコネクタにアクセスし、​**\[Dependency Snippets (連動関係スニペット)\]**​ をクリックします。

## [](#studio-プロジェクトへのコネクタの追加)Studio プロジェクトへのコネクタの追加

Anypoint Studio には、Studio プロジェクトにコネクタを追加する 2 つの方法があります。Studio タスクバーの Exchange ボタンから追加するか、\[Mule Palette (Mule パレット)\] ビューから追加します。

### [](#exchange-を使用してコネクタを追加する)Exchange を使用してコネクタを追加する

1. Studio で Mule プロジェクトを作成します。
2. Studio タスクバーの左上にある Exchange アイコン ​**(X)**​ をクリックします。
3. Exchange で、​**\[Login (ログイン)\]**​ をクリックし、Anypoint Platform のユーザー名とパスワードを指定します。
4. Exchange で、「gp」を検索します。
5. コネクタを選択して ​**\[Add to project (プロジェクトに追加)\]**​ をクリックします。
6. 画面の指示に従ってコネクタをインストールします。

### [](#studio-でコネクタに追加する)Studio でコネクタに追加する

1. Studio で Mule プロジェクトを作成します。
2. \[Mule Palette (Mule パレット)\] ビューで、​**\[(X) Search in Exchange ((X) Exchange 内を検索)\]**​ をクリックします。
3. **\[Add Modules to Project (モジュールをプロジェクトに追加)\]**​ で、検索項目に「gp」と入力します。
4. **\[Available modules (使用可能なモジュール)\]**​ で、このコネクタの名前をクリックします。
5. **\[Add (追加)\]**​ をクリックします。
6. **\[Finish (完了)\]**​ をクリックします。

### [](#studio-で設定する)Studio で設定する

1. コネクタ操作を Studio キャンバスにドラッグします。
2. コネクタのグローバル要素を設定します。
    
    ![Microsoft Dynamics GP の \[Global Elements Properties (グローバル要素プロパティ)\] 設定ウィンドウ](_images/ms-dynamics-gp-anypoint-config.png)

## [](#ユースケース-studio)ユースケース: Studio

- [顧客を作成する](#use-case-1)
- [顧客を取得する](#use-case-2)
- [顧客を更新する](#use-case-3)
- [顧客を削除する](#use-case-4)
- [顧客リストを取得する](#use-case-5)

### [](#use-case-1)顧客を作成する

![顧客の作成ユースケースのフロー](/mulesoft/current/ja-jp/microsoft-dynamics-gp-connector/2.1/_images/ms-dynamics-gp-create-customer.png)

1. \[Mule Palette (Mule パレット)\] から、\[HTTP Listener (HTTP リスナー)\] 要素をキャンバスにドラッグし、デフォルトの設定を使用しますが、パスは /createCustomer に設定します。
2. \[HTTP Listener (HTTP リスナー)\] 要素の横に \[Transform Message (メッセージを変換)\] 要素をドラッグし、以下を追加します。
    
    ```dataweave
    %dw 2.0
    output application/xml
    ns ns0 http://schemas.microsoft.com/dynamics/gp/2010/01
    ns ns01 http://schemas.datacontract.org/2004/07/Microsoft.Dynamics.Common
    ns ns02 http://schemas.datacontract.org/2004/07/Microsoft.Dynamics.GP
    ns xsi http://www.w3.org/2001/XMLSchema-instance
    ---
    {
    	ns0#CreateCustomer: {
    		ns0#customer: {
    			ns02#Key: {
    				ns02#Id: attributes.queryParams.customerKeyID
    			},
    			ns02#Name: attributes.queryParams.customerName
    		},
    		ns0#context: {
    			ns01#OrganizationKey @(xsi#"type": "ns01:CompanyKey") : {
    				ns01#Id: attributes.queryParams.companyKeyID
    			}
    		}
    	}
    }
    ```
3. \[Transform Message (メッセージを変換)\] 要素の横に Microsoft Dynamics GP Connector をドラッグします。
4. 設定を行い、必須項目を入力します。これは、フローにドラッグされる他の Dynamics GP Connector にも当てはまります。
5. \[Create Entity (エンティティを作成)\] 操作を選択します。ドロップダウンリストから \[Customer (顧客)\] エンティティを選択します。\[Input Reference (入力参照)\] はそのままにします。
6. コネクタの横に \[Set Payload (ペイロードを設定)\] 要素をドラッグし、値を ​`Success`​ に設定します。

### [](#use-case-2)顧客を取得する

![顧客の取得ユースケースのフロー](/mulesoft/current/ja-jp/microsoft-dynamics-gp-connector/2.1/_images/ms-dynamics-gp-get-customer.png)

1. \[Mule Palette (Mule パレット)\] から、\[HTTP Listener (HTTP リスナー)\] 要素をキャンバスにドラッグし、デフォルトの設定を使用しますが、パスは /getCustomer に設定します。
2. \[HTTP Listener (HTTP リスナー)\] 要素の横に \[Transform Message (メッセージを変換)\] 要素をドラッグし、以下を追加します。
    
    ```dataweave
    %dw 2.0
    output application/xml
    ns ns0 http://schemas.microsoft.com/dynamics/gp/2010/01
    ns ns01 http://schemas.datacontract.org/2004/07/Microsoft.Dynamics.GP
    ns ns02 http://schemas.datacontract.org/2004/07/Microsoft.Dynamics.Common
    ns xsi http://www.w3.org/2001/XMLSchema-instance
    ---
    {
    	ns0#GetCustomerByKey: {
    		ns0#key: {
    			ns01#Id: attributes.queryParams.customerKeyID
    		},
    		ns0#context: {
    			ns02#OrganizationKey @(xsi#"type": "ns02:CompanyKey") : {
    				ns02#Id: attributes.queryParams.companyKeyID
    			}
    		}
    	}
    }
    ```
3. \[Transform Message (メッセージを変換)\] 要素の横に Microsoft Dynamics GP Connector をドラッグします。
4. \[Get Entity By Key (キーでエンティティを取得)\] 操作を選択します。ドロップダウンリストから \[Customer (顧客)\] エンティティを選択します。\[Input Reference (入力参照)\] はそのままにします。
5. コネクタの横に \[Transform Message (メッセージを変換)\] 要素をドラッグし、以下を追加します。
    
    ```dataweave
    %dw 2.0
    output application/json
    ---
    payload
    ```

### [](#use-case-3)顧客を更新する

![顧客の更新ユースケースのフロー](/mulesoft/current/ja-jp/microsoft-dynamics-gp-connector/2.1/_images/ms-dynamics-gp-update-customer.png)

1. \[Mule Palette (Mule パレット)\] から、\[HTTP Listener (HTTP リスナー)\] 要素をキャンバスにドラッグし、デフォルトの設定を使用しますが、パスは /updateCustomer に設定します。
2. \[HTTP Listener (HTTP リスナー)\] 要素の横に \[Transform Message (メッセージを変換)\] 要素をドラッグし、以下を追加します。
    
    ```dataweave
    %dw 2.0
    output application/xml
    ns ns0 http://schemas.microsoft.com/dynamics/gp/2010/01
    ns ns01 http://schemas.datacontract.org/2004/07/Microsoft.Dynamics.Common
    ns ns02 http://schemas.datacontract.org/2004/07/Microsoft.Dynamics.GP
    ns xsi http://www.w3.org/2001/XMLSchema-instance
    ---
    {
    	ns0#GetCustomerByKey: {
    		ns0#key: {
    			ns02#Id: attributes.queryParams.keyId
    		},
    		ns0#context: {
    			ns01#OrganizationKey @(xsi#"type": "ns01:CompanyKey") : {
    				ns01#Id: attributes.queryParams.companyKeyID
    			}
    		}
    	}
    }
    ```
3. この \[Transform Message (メッセージを変換)\] に「updatedComment」という変数を作成し、次の値を設定します。
    
    ```dataweave
    %dw 2.0
    output application/java
    ---
    {
    	comment1: payload.customer.comment1
    }
    ```
4. \[Transform Message (メッセージを変換)\] 要素の横に Microsoft Dynamics GP Connector をドラッグします。
5. \[Get Entity By Key (キーでエンティティを取得)\] 操作を選択します。ドロップダウンリストから \[Customer (顧客)\] エンティティを選択します。\[Input Reference (入力参照)\] はそのままにします。
6. コネクタの横に \[Transform Message (メッセージを変換)\] 要素をドラッグし、以下を追加します。
    
    ```dataweave
    %dw 2.0
    output application/java
    ---
    %dw 2.0
    output application/xml
    ns ns0 http://schemas.microsoft.com/dynamics/gp/2010/01
    ns ns01 http://schemas.datacontract.org/2004/07/Microsoft.Dynamics.Common
    ns ns02 http://schemas.datacontract.org/2004/07/Microsoft.Dynamics.GP
    ns xsi http://www.w3.org/2001/XMLSchema-instance
    ---
    {
    	ns0#UpdateCustomer: {
    		ns0#customer: {
    			ns02#Comment1: vars.comment1,
    			ns02#Key: {
    				ns02#Id: payload.key.id
    			},
    			ns02#Name: payload.name
    		},
    		ns0#context: {
    			ns01#OrganizationKey @(xsi#"type": "ns01:CompanyKey") : {
    				ns01#Id: attributes.queryParams.companyKeyID
    			}
    		}
    	}
    }
    ```
7. \[Transform Message (メッセージを変換)\] 要素の横に Microsoft Dynamics GP Connector をドラッグします。
8. \[Update Entity (エンティティを更新)\] 操作を選択します。ドロップダウンリストから \[Customer (顧客)\] エンティティを選択します。\[Input Reference (入力参照)\] はそのままにします。
9. コネクタの横に \[Set Payload (ペイロードを設定)\] 要素をドラッグし、値を ​`Success`​ に設定します。

### [](#use-case-4)顧客を削除する

![顧客の削除ユースケースのフロー](/mulesoft/current/ja-jp/microsoft-dynamics-gp-connector/2.1/_images/ms-dynamics-gp-delete-customer.png)

1. \[Mule Palette (Mule パレット)\] から、\[HTTP Listener (HTTP リスナー)\] 要素をキャンバスにドラッグし、デフォルトの設定を使用しますが、パスは /deleteCustomer に設定します。
2. \[HTTP Listener (HTTP リスナー)\] 要素の横に \[Transform Message (メッセージを変換)\] 要素をドラッグし、以下を追加します。
    
    ```dataweave
    %dw 2.0
    output application/xml
    ns ns0 http://schemas.microsoft.com/dynamics/gp/2010/01
    ns ns01 http://schemas.datacontract.org/2004/07/Microsoft.Dynamics.GP
    ns ns02 http://schemas.datacontract.org/2004/07/Microsoft.Dynamics.Common
    ns xsi http://www.w3.org/2001/XMLSchema-instance
    ---
    {
    	ns0#DeleteCustomer: {
    		ns0#key: {
    			ns01#Id: attributes.queryParams.customerKeyID
    		},
    		ns0#context: {
    			ns02#OrganizationKey @(xsi#"type": "ns02:CompanyKey") : {
    				ns02#Id: attributes.queryParams.companyKeyID
    			}
    		}
    	}
    }
    ```
3. \[Transform Message (メッセージを変換)\] 要素の横に Microsoft Dynamics GP Connector をドラッグします。
4. \[Delete Entity (エンティティを削除)\] を選択します。ドロップダウンリストから \[Customer (顧客)\] エンティティを選択します。\[Input Reference (入力参照)\] はそのままにします。
5. コネクタの横に \[Set Payload (ペイロードを設定)\] 要素をドラッグし、値を ​`Success`​ に設定します。

### [](#use-case-5)顧客リストを取得する

![顧客リストの取得ユースケースのフロー](/mulesoft/current/ja-jp/microsoft-dynamics-gp-connector/2.1/_images/ms-dynamics-gp-get-customer-list.png)

1. \[Mule Palette (Mule パレット)\] から、\[HTTP Listener (HTTP リスナー)\] 要素をキャンバスにドラッグし、デフォルトの設定を使用しますが、パスは /getCustomerList に設定します。
2. \[HTTP Listener (HTTP リスナー)\] 要素の横に \[Transform Message (メッセージを変換)\] 要素をドラッグし、以下を追加します。
    
    ```dataweave
    %dw 2.0
    output application/xml
    ns ns0 http://schemas.microsoft.com/dynamics/gp/2010/01
    ns ns01 http://schemas.datacontract.org/2004/07/Microsoft.Dynamics.Common
    ns ns02 http://schemas.datacontract.org/2004/07/Microsoft.Dynamics.GP
    ns xsi http://www.w3.org/2001/XMLSchema-instance
    ---
    {
    	ns0#GetCustomerList: {
    		ns0#criteria: {
    			ns02#Name: {
    				ns01#Like: attributes.queryParams.like
    			}
    		},
    		ns0#context: {
    			ns01#OrganizationKey @(xsi#"type": "ns01:CompanyKey") : {
    				ns01#Id: attributes.queryParams.companyKeyID
    			}
    		}
    	}
    }
    ```
3. \[Transform Message (メッセージを変換)\] 要素の横に Microsoft Dynamics GP Connector をドラッグします。
4. \[Get Entity List (エンティティリストを取得)\] を選択します。ドロップダウンリストから \[Customer (顧客)\] エンティティを選択します。\[Input Reference (入力参照)\] はそのままにします。
5. コネクタの横に \[Transform Message (メッセージを変換)\] 要素をドラッグし、以下を追加します。
    
    ```dataweave
    %dw 2.0
    output application/json
    ---
    payload
    ```

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

[MuleSoft ヘルプセンター](https://help.mulesoft.com)