# データマッピングのためのWebサービス呼び出し

### データ処理のためのWebサービス

データ統合およびETLのためのWebサービス連携- SOAP Webサービスを呼び出す
- RESTfulなWebサービスを呼び出す 
- [OpenAPI 定義をインポートします](#openapi)
- 汎用的なHTTPウェブサービスに対応
- 柔軟な設定と入力パラメータ
- 処理結果をマッピングコンポーネントまたはファイルに渡します

- [Shopify/GraphQL対応](convert-shopify-graphql.md)
- JSON/XMLスキーマの自動生成
- AI APIを呼び出し、データ処理を実行します
- 処理結果をマッピングコンポーネントまたはファイルに渡します
- WS-セキュリティ機能のサポート
- OAuth 2.0への対応
- SOAP Webサービスの構築 [視覚的に](/manual/Mapforce/mapforceenterprise/mffmapforceandwebservices.html)

## データマッピングにおけるWebサービス連携

それに加えて [Shopify/GraphQL API への呼び出し](convert-shopify-graphql.md) MapForceでは、マッピング処理の中で、SOAPやRESTのWebサービスを直接呼び出すことができます。マッピング処理内にWebサービスの呼び出しを挿入し、入力パラメータやユーザー名/パスワード、その他の認証情報を設定できます。Webサービスの出力結果を別のコンポーネントに渡したり、ファイルに書き込んだりするために、出力コンポーネントをWebサービスに接続できます。

MapForceは、メッセージ本文にカスタムのリクエストやレスポンス構造を通常含む、汎用的なHTTP Webサービスにも対応しています。MapForceは、リクエストまたはレスポンスの本文で、JSONまたはXMLデータを使用できます。これにより、XMLまたはJSON構造を必要とする、または返す、ほぼすべてのHTTP Webサービスを呼び出すことが可能です。

[MapForce Webサービス](https://www.altova.com/images/mapforce_web_service.png)

Webサービス呼び出し定義ダイアログで、手動で設定を定義することができます。この機能を使用すると、開発者はテンプレートURLに基づいて設定を定義できます。これは、開発者がWebブラウザ上でWebサービス呼び出しをテストおよび調整する際に便利です。なぜなら、ブラウザからURLをコピーして、それをテンプレートとして利用できるからです。

具体的な事例をお探しですか？以下に、詳細な解説をご用意しました [ウェブサービスにおけるデータ統合。](https://www.altova.com/blog/web-service-data-integration/)

### ウェブサービスセキュリティのサポート {#ws-security}

MapForceは、クライアント証明書とHTTPS経由でのWebサービス呼び出しを通じて、WS-Security（Webサービスセキュリティ）規格に基づく認証をサポートしています。安全な通信を確立するために必要なパラメータは、データマッピングの一部として定義されているため、実行は自動化されています。

### OAuthのサポート {#oauth}

OAuth 2.0は、認証のためのオープンな標準規格であり、パスワードの代わりにアクセス トークンを使用して、クライアントアプリケーションがウェブリソースに安全かつ委任されたアクセス権を付与する方法を提供します。MapForceには、OAuth 2.0認証を必要とするWebサービスを呼び出すための機能が組み込まれています。

これは、アクティブなマッピングプロジェクト内で右クリックして開く「認証情報マネージャー」で有効にできます。 認証情報オブジェクトを使用することで、OAuthの認証情報を、[MapForce Server](../mapforce-server.md) や[FlowForce Server](../flowforceserver.md) などの他の実行環境に転送することができます。

## AIを活用したデータ統合のためのAPI呼び出し

OpenAIのGPT-4のような多くのAIシステムがAPIを通じて利用できるため、MapForceにおけるデータ変換プロジェクトに、これらのシステムの機能をすぐに組み込むことができます。 

MapForceに組み込まれた、コーディング不要のツールを使用することで、ウェブサービスのリクエストを定義し、OpenAI API、Azure OpenAI API、AWS AI Servicesなど、様々なAPIへの接続を容易に設定できます。これにより、あらゆるデータマッピングプロジェクトにおいて、[AIを活用したデータ処理](ai-data-integration.md) を可能にします。

[ウェブサービスを利用する際には、AIを活用したデータ変換が不可欠です](https://www.altova.com/images/data-integration-with-ai.png)

MapForceでAI機能を設定するための主な手順は以下の通りです 

- データマッピングプロジェクトにWebサービスコンポーネントを組み込むことで、ソースデータを処理し、それをターゲットとなるデータ構造に書き込むことができます
- ウェブサービスの呼び出し設定は、以下の情報を用いて行います： APIのURL貴組織のログイン情報APIの呼び出しに対応するJSON形式のリクエストとレスポンスのスキーマ（これらはMapForceやXMLSpyで自動生成できます）
- 必要に応じて、マッピングプロジェクトの設定を続けてください

あるいは、RESTfulサービスに関するOpenAPI定義ファイル（以下に記載）をインポートすると、MapForceが自動的にその呼び出し構造を処理し、手動での設定作業が不要になります。 

## OpenAPI 定義をインポートします

REST Webサービスへの呼び出しを設定するには、WebサービスのURL、リクエスト方法（例：GET、POST、PUT）、リクエストとレスポンスの構造（例：XML、JSON、カスタムMIMEタイプ）、およびパラメータなどの詳細情報を指定する必要があります。これらの情報は、手動で入力するか、詳細情報を含むWADLファイルまたはURLを指定するか、OpenAPIの定義をインポートすることで設定できます。 

OpenAPI Specification (OAS)は、RESTful APIを定義し、記述するための標準化された形式です。これは、APIの構造、エンドポイント、リクエストとレスポンスの形式、パラメータ、認証方法など、APIの様々な側面を、プログラミング言語に依存しない方法で記述するためのものです。

必要なウェブサービスを記述したOpenAPIファイルを指定すると、MapForceは自動的にその呼び出しの構造を処理し、グラフィカルなデータマッピングコンポーネントとして表示します。これにより、手動での設定が不要になり、ウェブサービスとの連携プロセスが大幅に効率化されます。

[データ統合のために、OpenAPI 定義をインポートします](https://www.altova.com/images/openapi-mapforce.png)


## Call to Action

[既存のお客様は、こちらから最新バージョンにアップデートできます。](download.md)
[今すぐ、MapForceの無料試用版をダウンロードしてください。](download.md)