Spectrum OnDemand (SPOD) 統合によるアドレス検証 - Automate_Evolve - Automate_Studio_Manager

Web フォームでの住所確認は、ビジネスパートナー、顧客、またはサプライヤーの作成または更新などの一般的なユースケースです。SPOD は、ジオコーディング情報を追加するオプションを使用して、特定の地域またはグローバルに住所を検証するための Web サービスを提供します。

このサービスは、住所行、地域、国、および郵便番号から都市を導き出す、住所、都市、地域、および国から郵便番号を導き出すなど、所定の入力を通じて欠損値を導き出すことができます。サービスがニーズを満たすかどうかをテストしてください。

SPOD オファリングの詳細については、次のドキュメントを参照してください。

•Spectrum OnDemand サービス

•SPOD 住所バリデーション

前提条件

以下は、Evolve フォームで SPOD サービスを使用するための前提条件です。

ヘッダーパラメータの入力フィールドを含む REST Web サービスエンドポイント。
基本認証資格情報、ユーザー ID およびパスワード。
出力用の JSON ペイロード。

さまざまな地域のサポート、Global Address Validation、入力と出力のカスタマイズなどのカスタマイズは、SPOD サービスを通じて行うことができます。

注:

Evolve で、ドキュメントの「API 呼び出しに関する既知の制限」を参照してください。たとえば、フィールドの名前で「.」 (ピリオド) に変更し、Evolve フォームでそれらを正常に使用するよう SPOD サービスに要求できます。

Evolve ソリューションで SPOD サービスを実装する

Evolve ソリューションで SPOD サービスを実装する手順は次のとおりです。

オプション: API テストツール (Postman など) で API 呼び出しをテストして、必要に応じて機能することを確認し、JSON 出力構造を確認します。
Evolve の REST API データ接続 > 接続を作成します。これは、Evolve ソリューションで参照できます。
1. 接続タイプを選択: REST API
2. SPOD サイトの URL を追加します。例 https://prestaging.spectrum.precisely.com/rest
3. 認証を選択: 基本
4. SPOD 資格情報を入力する
5. 日付形式の種類を選択: ISO
6. [Composer に適用する] チェックボックスを選択する
7. [保存] をクリックします。
  
  注:
  データ接続は、ステージング、QA、実稼働など、さまざまな SPOD サイトに設定できます。
Composer で、データ接続を追加します。
1. データ接続名を入力する
2. タイプを選択: REST API
3. Evolve で作成した SPOD データ接続を選択する
4. URL は、データ接続で入力したものにデフォルト設定されます
5. 住所バリデーション用の HTTP 操作 GET を選択します
6. 追加して、URL ビルダーで URL を完成させます。
SPOD サービス名と、JSON で返される結果の指定。例: /ValidateMailingAddressPremium/results.json
- Address Validation サービスの入力パラメータ
&Data.AddressLine1=[/my:myFields/my:BP_Address_Addr1]
- 入力パラメータは Data.AddressLine1 です
- フォームフィールドの値を使用する BP_Address_Addr1 値として
式ビルダーを使用して、値として solution/form フィールドを簡単に選択できるようにします

- 完全な URL の例:

https://staging.spectrum.precisely.com/rest/ ValidateMailingAddressPremium/results.json?

&Data.AddressLine1=[/my:myFields/my:BP_Address_Addr1]

&Data.AddressLine2=[/my:myFields/my:BP_Address_Addr2]

&Data.City=[/my:myFields/my:BP_Address_City]

&Data.StateProvince=[/my:myFields/my:BP_Address_State]

&Data.PostalCode=[/my:myFields/my:BP_Address_Zip]

&Data.Country=[/my:myFields/my:BP_Address_CountryCode]

出力は、API 出力スキーマで指定する必要があります。選択したサービスに基づいて、可能な出力フィールドの数が異なる場合があります。例:

    { 		"Output": [ 			{ 					"AddressLine1": "string", 					"AddressLine2": "string", 					"AddressLine3": "string", 					"City": "string", 					"StateProvince": "string", 			    	"PostalCode": "string", 				    "Country": "string", 					"HouseNumber": "string", 					“Status” : ”string”, 					"StatusCode": "string", 					"StatusDescription": "string", 					"Confidence": "integer", 			 } 		  ] 		}

フォームフィールドは、SPOD サービスからの出力フィールドとなる任意の Composer データ接続で作成できます。
フィールドをフォームにマップします。
1. 入力フィールド - 入力フィールドは、選択した SPOD サービスによって異なる場合があります。例としては、住所行 1、住所行 2、都市、都道府県、郵便番号、国などがあります。これは、データ接続が入力を渡すために URL ビルダーで使用されます。SPOD Address Validation Web サービスに渡される入力値を含む address 要素またはその他のフォームフィールドを使用できます。
2. 出力フィールド - SPOD サービスのフォームフィールドを作成するには、データ接続を右クリックし、必要なフィールドを選択します。SPOD サービスは、使用される API 出力スキーマに基づいて出力フィールドを生成します。結果は、単一のアドレスか複数のアドレスかに関係なく、内容が繰り返されます。フォームで必要に応じてそれらをマッピングします。アドレスとなる繰り返しコンテンツ suggestions/corrections 繰り返しテーブルまたは選択可能テーブルにマップできます。
フォームに Web サービスコントロールを追加し、それを SPOD Web サービスにマップします。ボタンまたはルールを追加して、Web サービスをトリガーします。
ソリューションをデプロイします。

Spectrum OnDemand (SPOD) 統合によるアドレス検証 - Automate_Evolve - Automate_Studio_Manager - 20.3

Automate Evolve ユーザーガイド