# tAddressRowCloud

オンラインサービスを使って、クラウド内の海外アドレスを検証し、フォーマットします。

tAddressRowCloudを使用すると、ソフトウェアをインストールしなくても、アドレスデータを解析し、フォーマット済みアドレスをすばやく正確に取得できます。

アドレスデータは、Loqate, MelissaData, Google、QASなどの複数のプロバイダーから得た最新のオンライン参照データに照らして訂正されます。tAddressRowCloudは、国名や郵便番号など欠けているアドレスデータの代替データを提案し、アドレスに緯度や経度などの他のエレメントが追加されます。

Google Places APIの利用規約については、[Terms of Service](https://developers.google.com/maps/terms?hl=en)をご覧ください。

デフォルトで、このコンポーネントはTalend Studioと共には出荷されていません。機能マネージャーを使ってインストールする必要があります。 詳細は、[機能マネージャーを使って機能をインストール](https://help.qlik.com/talend/r/ja-JP/8.0/studio-user-guide/install-features-to-talend-studio)をご覧ください。

## tAddressRowCloudの標準プロパティ

これらのプロパティは、標準ジョブのフレームワークで実行されているtAddressRowCloudを設定するために使われます。

標準のtAddressRowCloudコンポーネントは、データクオリティファミリーに属しています。

このコンポーネントは、Talend Data Management Platform、Talend Big Data Platform、Talend Real-Time Big Data Platform、Talend Data Services Platform、Talend Data Fabricで利用できます。

## 基本設定

| プロパティ | 説明 |
| --- | --- |
| スキーマ | <ul> <li> <p>スキーマとは行の説明のことです。処理して次のコンポーネントに渡すフィールド(カラム)数を定義します。Sparkジョブを作成する場合、フィールドの命名時は予約語の<kbd>line</kbd>を避けます。</p> </li> <li> <p> <span>[Built-in] (組み込み)</span>: そのコンポーネントに対してのみスキーマを作成し、ローカルに保管します。</p> </li> <li> <p> <span>[Repository] (リポジトリー)</span>: スキーマは作成済みで、リポジトリーに保管されています。さまざまなプロジェクトやジョブデザインで再利用できます。</p> </li> </ul> |
| [Edit Schema] (スキーマを編集) | [...]ボタンをクリックして、アドレスデータの入力スキーマと出力スキーマを定義します。<br><br>tAddressRowCloudの出力スキーマに、処理アドレスの検証ステータスを提供するVerificationLevelカラムなど、複数の読み取り専用アドレスカラムが表示されます。このカラムの検証レベルは Talend によって定義されます。詳細は、[tAddressRowCloudのアドレス検証レベル](https://help.qlik.com/talend/ja-JP/components/8.0/address-standardization/taddressrowcloud-taddressrowcloud-address-verification-levels-in-taddressrowcloud-standard-component-enterprise-the)をご覧ください。<br><br>出力スキーマが住所プロバイダーによるため、詳細はそのWebサイトをご覧ください。<br><br>また、ジョブの実行時、コンポーネント基本設定で選択するアドレスプロバイダーによっては一部の出力カラムが空の場合があります。 |
| [Address Provider] (アドレスプロバイダー) | 入力アドレスの検証とフォーマットの実行対象にする参照データのプロバイダーをリストから選択してください。<br><br>アドレスプロバイダーのリストには、Google、Loqate、QAS、MelissaDataなどがあります。 |
| [License/API key] (ライセンス/APIキー) | リストから選択したアドレスプロバイダーが提供するライセンスまたはAPIキーを入力します。プロバイダーのWebサイトにアクセスし、ライセンス/APIキーを登録し、取得する必要があります。<br><br>キーを入力し、フィールドの横にある[…]ボタンをクリックします。<br><br>プロバイダーにGoogleを選択する場合、Google Places APIが使われます。キーをGoogle Developer Console (https://developers.google.com/console/help/new/)で生成してこのフィールドで設定してください。 |
| [Processing Mode] (処理モード) | このオプションはLoqateプロバイダーにしか適用されません。<br><br>使用するアドレス検証のモードをリストから選択します。<br><br><ul> <li> <span>[Verify and Geocode] (検証とジオコード)</span> (デフォルトで選択済み): このモードでは、住所が標準化および修正されて、緯度と経度の情報が追加されます。 <p>入力スキーマで住所カラムと国カラムを定義して、<span>[Mapping] (マッピング)</span>テーブルに追加する必要があります。</p> </li> <li> <p>                               -<span>[Verify only] (検証のみ)</span>: このモードでは、緯度と経度の情報が追加されずに、アドレスが標準化および修正されます。</p> <p>入力スキーマで住所カラムを定義して、<span>[Mapping] (マッピング)</span>テーブルに追加する必要があります。</p> </li> </ul><br><br>情報メモ注: これらの処理モードではクレジットがさらに必要となります。詳細は、[Loqate Webサイト](https://www.loqate.com/)をご覧ください。 |
| Country | このオプションはQASプロバイダーにしか適用されません。<br><br>入力アドレスに対応する国をリストから選択します。<br><br>プロバイダーにQASを選択する場合、QAS Pro OnDemandサービスが使われます。Experianのアドレス検証については、製品シート(https://www.edq.com/globalassets/product-sheets/address-verification.pdf)をご覧ください。 |
| [QAS OnDemand username] (QAS OnDemandユーザー名) | このオプションはQASプロバイダーにしか適用されません。<br><br>QASが提供するライセンスにあるユーザー名を入力します。<br><br>ユーザー名はQAS OnDemandポータルで確認できます。 |
| [Password] (パスワード) | このオプションはQASプロバイダーにしか適用されません。<br><br>QASが提供するライセンスにあるパスワードを入力します。<br><br>パスワードはQAS OnDemandポータルで確認できます。 |
| [Use security mode to connect] (セキュリティモードを使用して接続) | このチェックボックスをオンにすると、セキュアモードでクラウドに接続されます。パフォーマンスにやや影響することがあります。<br><br>アドレスプロバイダーによっては、このチェックボックスを使用できないことがあります。 |
| [Mapping] (マッピング) | Address field (アドレスフィールド): テーブルに行を追加して、入力アドレスを入れるフィールドを定義済みアドレスリストから選択します。<br><br>アドレスリストには、すべてのアドレスプロバイダーに対応する[Address] (アドレス)、[PostalCode] (郵便番号)、[Locality] (地域)、[AdministrativeArea] (管理領域)、[Country] (国)の各カラムが含まれています。<br><br>[Input Column] (入力カラム): テーブルに行を追加して、入力スキーマからのアドレスを入れるカラムをリストで選択します。入力スキーマには、1つ以上のカラムを含めることができ、アドレスデータを表示しないカラムを含めることができます。 |
| [Use Additional Output] (追加の出力を使用) | このオプションはQASプロバイダーには使用できません。<br><br>このチェックボックスをオンにし、[Output Mapping] (出力のマッピング)を使って、さらに多くのアドレスカラムを出力スキーマに追加します。<br><br>[Address field] (アドレスフィールド): テーブルに行を追加して、出力したいその他の情報のフィールドを定義済みアドレスリストから選択します。<br><br>これらの定義済みアドレスフィールドは、[Address Provider] (アドレスプロバイダー)リストで選択したプロバイダーによって異なります。その他のアドレスリストの詳細は、プロバイダーのWebサイトをご確認ください。<br><br>[Output Column] (出力カラム): その他のアドレス情報を入れるカラムをリストから選択します。最初にこれらのカラムをtAddressRowCloud出力スキーマに[Edit Schema] (スキーマを編集)ボタンで追加します。<br><br>tAddressRowCloudは、アドレスフィールドの値を[Output Column] (出力カラム)の出力カラムにマッピングします。<br><br>入力カラムの正確な名前を持つ[Output Address] (出力結果アドレス)テーブルに出力カラムを1つ含める場合、入力カラムの値は、コンポーネントからの値で上書きされます。 |
| [Die on error] (エラー発生時に強制終了) | このチェックボックスを選択すると、エラー発生時にジョブの実行が停止されます。<br><br>エラーの発生した行をスキップし、エラーが発生していない行の処理を完了するには、このチェックボックスをオフにします。エラーをスキップしたら、[Row] (行)&gt; [Reject] (リジェクト)リンクを使用してエラーの発生した行を収集できます。 |

## 詳細設定

| プロパティ | 説明 |
| --- | --- |
| [tStat Catcher Statistics] (tStatCatcher統計) | このチェックボックスを選択すると、コンポーネントレベルでログデータを収集できます。 |

## グローバル変数

| 変数 | 説明 |
| --- | --- |
| グローバル変数 | ERROR\_MESSAGE: エラーが発生した時にコンポーネントによって生成されるエラーメッセージ。これはAfter変数で、文字列を返します。この変数はコンポーネントにこのチェックボックスが存在し、[Die on error] (エラー発生時に強制終了)がオフになっている場合のみ機能します。<br><br>Flow変数はのコンポーネントの実行中に機能し、After変数はコンポーネントの実行後に機能します。<br><br>フィールドまたは式に変数を入力する場合は、Ctrl + スペースを押して変数リストにアクセスし、使用する変数を選択します。<br><br>変数の詳細は、[コンテキストと変数を使用](https://help.qlik.com/talend/r/ja-JP/8.0/studio-user-guide/contexts-and-variables)をご覧ください。 |

## 使用方法

| 使用方法のガイダンス | 説明 |
| --- | --- |
| **使用ルール** | このコンポーネントは、通常、中間コンポーネントとして使用されます。入力コンポーネントと出力コンポーネントが必要です。<br><br>このコンポーネントにより、[Row] (行) &gt; [Main] (メイン)リンクを使ってデータフローを作成したり、[Row] (行) &gt; Reject (リジェクト)リンクでリジェクトフローを作成してエラーのあるデータをフィルタリングしたりできます。 |

**関連概念**

[クラウドで参照データと比較して住所を解析](https://help.qlik.com/talend/ja-JP/components/8.0/address-standardization/taddressrowcloud-tfixedflowinput-tfileoutputexcel-tfileoutputexcel-parsing-addresses-against-reference-data-in-cloud-standard-component-enterprise-this)