tMicrosoftCrmInput標準プロパティ - Cloud - 8.0

Microsoft CRM

Version
Cloud
8.0
Language
日本語 (日本)
Product
Talend Big Data
Talend Big Data Platform
Talend Data Fabric
Talend Data Integration
Talend Data Management Platform
Talend Data Services Platform
Talend ESB
Talend MDM Platform
Talend Open Studio for Big Data
Talend Open Studio for Data Integration
Talend Open Studio for ESB
Talend Real-Time Big Data Platform
Module
Talend Studio
Content
ジョブデザインと開発 > サードパーティーシステム > ビジネスアプリケーション > Microsoft CRM
データガバナンス > サードパーティーシステム > ビジネスアプリケーション > Microsoft CRM
データクオリティとプレパレーション > サードパーティーシステム > ビジネスアプリケーション > Microsoft CRM

このプロパティは[Standard] (標準)ジョブフレームワークで実行するtMicrosoftCrmInputの設定で使用されます。

[Standard] (標準) tMicrosoftCrmInputコンポーネントは、ビジネスファミリーに属しています。

このフレームワーク内のコンポーネントは、すべてのTalend製品で使用できます。

基本設定

[Authentication Type] (認証タイプ)

特定のCRMデプロイモデルに対応する認証タイプを選択します。
  • ON_PREMISE: CRMはインハウスで顧客自身のサーバーにインストールされ、ライセンスは必要なインフラストラクチャーと共に購入されます。

  • ONLINE: 顧客は、Microsoftがデータセンターにホストしているクラウドベースサブスクリプションサービスの一部としてCRMにアクセスします。

[CRM Version] (CRMバージョン)

ON-PREMISE CRMデータベースのバージョン、すなわち、CRM 2011CRM 2015、またはCRM 2016を選択します。

ON-PREMISE 2016はApache Olingo OData 4.0ライブラリーを使用して実装されます。詳細は、http://olingo.apache.org/doc/odata4/index.htmlを参照してください。

[Mode] (モード)

ON-PREMISE CRM2016認証モード、NTLM、またはOAUTH 2.0を選択します。

このオプションは、[Authentication Type] (認証タイプ)ドロップダウンリストでON_PREMISEを選択し、[CRM Version] (CRMバージョン)ドロップダウンリストでCRM 2016を選択している場合に利用できます。

[API Version] (APIバージョン)

ONLINE CRMデータベースのAPIバージョン、すなわち、v2007v2011v2016v2018のいずれかを選択します。

ONLINE 2016と2018は、MS Dynamics WebAPI v8.1 (2016)とv9.1 (2018)を使って実装されています。詳細は、https://docs.microsoft.com/en-us/dynamics365/customer-engagement/developer/use-microsoft-dynamics-365-web-api?view=dynamics-ce-odata-9を参照してください。

デフォルト値で定義されているv2018 (v2016 を選択する時はv8.1を使用)を選択する時は、Service Root URLをWebAPI v9.1以降に設定する必要があります。

[Registered application type] (登録済みのアプリケーションタイプ)

アプリケーションのタイプ、すなわち、Native AppまたはWeb App with delegated permissionsを選択します。

このオプションは、Microsoft CRM ONLINE 2016および2018に使用できます。

[Microsoft WebService URL] (Microsoft WEBサービスURL)

オンプレミスMicrosoft CRMサーバーのWebサービスURL。

このオプションは、Microsoft CRM ON-PREMISE 2011に使用できます。

[OrganizeName] (組織名)

Microsoft CRMデータベースにアクセスする必要のある組織の名前。

このオプションは、Microsoft CRM ON-PREMISE 2011、ONLINE 2007、ONLINE 2011に使用できます。

[Username] (ユーザー名)[Password] (パスワード)

Microsoft CRMデータベースへのアクセスに必要とされるユーザー認証データ。

パスワードを入力するには、パスワードフィールドの横にある[...]ボタンをクリックし、ポップアップダイアログボックスにパスワードを二重引用符の間に入力し、[OK] をクリックして設定を保存します。

[Domain] (ドメイン)

Microsoft CRMデータベースがホストされているサーバーのドメイン名。

このオプションは、Microsoft CRM ON-PREMISE 2011および2016に使用できます。

[Host] (ホスト)

Microsoft CRMデータベースサーバーのIPアドレス。

このオプションは、Microsoft CRM ON-PREMISE 2011、ON-PREMISE 2016、ONLINE 2007に使用できます。

[Port] (ポート)

Microsoft CRMデータベースサーバーのリスニングポート番号。

このオプションは、Microsoft CRM ON-PREMISE 2011に使用できます。

[Organization Wsdl URL] (組織のWsdl URL)

組織サービスのWSDL URL。

このオプションは、Microsoft CRM ON-PREMISE 2015に使用できます。

[Security Service URL] (セキュリティサービスURL)

Security Token ServiceのURL。

このオプションは、Microsoft CRM ON-PREMISE 2015に使用できます。

[Trust Certificate] (証明書)

証明書ファイルへのパス。

このオプションは、Microsoft CRM ON-PREMISE 2015に使用できます。

[Discovery service endpoint] (検索サービスエンドポイント)

CRMオンライン検索サービスエンドポイント。

Microsoftリージョナル検索サービスが非推奨にされたため、このhttps://globaldisco.crm.dynamics.com/api/discovery/v2.0/InstancesというエンドポイントURLを使って、このフィールド内のエンドポイントURLを置換することを忘れないでください。

関連情報は、エラーコード: DynamicsFailedToConnectというトピックを、Azure Data Factoryコネクターのトラブルシューティングおよびコードを変更してグローバル検索サービスで参照してください。

このオプションは、Microsoft CRM ONLINE 2011に使用できます。

[Service Root URL] (サービスのルートURL)

接続するサービスのルートURL。

このオプションは、Microsoft CRM ON-PREMISE 2016、ONLINE 2016、2018に使用できます。

Application ID (アプリケーションID)

Azureポータルでアプリケーションを登録する時にAzure ADによってアプリケーションに割り当てられるユニークなクライアントID。このフィールドに表示されているデフォルトクライエントIDはテスト用です。ご自分の現行のクライエントIDを適用する必要があります。クライエントIDの適用に関する詳細は、 クイックスタート: Microsoft IDプラットフォームでアプリケーションを登録を参照してください。

このプロパティは、Microsoft CRM ONLINE 2011、2016、2018で使用できます。

[Application secret] (アプリケーションシークレット)

Webアプリケーション用のアクセスキー。この値を取得する方法は、アプリケーションに権限を付与を参照してください。

このプロパティは、[Registered application type] (登録済みのアプリケーションタイプ)ドロップダウンリストでWeb App with delegated permissionsが選択されている時に使用できます。

[OAuth authorization endpoint] (OAuth認証エンドポイント)

OAuthの検索に使用するOAuth認証エンドポイント。詳細は、エンドポイントを参照してください。

このプロパティは、Microsoft CRM ONLINE 2011、2016、2018で使用できます。

[Redirect URL] (リダイレクトURL)

OAuth 2.0のリダイレクトURLを入力します。

このフィールドは、[Mode] (モード)ドロップダウンリストでOAUTH 2.0が選択されている場合に使用できます。

[Time out (second)] (タイムアウト(秒))

接続を閉じる前にCRMサーバーからの応答メッセージを待機する秒数。

[Entity] (エンティティ)/[EntitySet]

該当するエンティティ/エンティティセットをリストから選択するか、またはCustomEntity/CustomEntitySetをリストから選択し、[Custom Entity Name] (カスタムエンティティ名)フィールドが表示されたら、エンティティ/エンティティセットの名前を指定し、カスタムエンティティ/エンティティセットのスキーマを定義します。

[Schema] (スキーマ)および[Edit schema] (スキーマを編集)

スキーマとは行の説明のことです。処理して次のコンポーネントに渡すフィールド(カラム)数を定義します。Sparkジョブを作成する場合、フィールドの命名時は予約語のlineを避けます。

  • [Built-in] (組み込み): そのコンポーネントのみのスキーマを作成して、ローカルに保存します。

  • [Repository] (リポジトリー): スキーマは作成済みで、リポジトリーに保管されています。さまざまなプロジェクトやジョブデザインで再利用できます。

スキーマを変更するには[Edit schema] (スキーマを編集)をクリックします。現在のスキーマがリポジトリータイプの場合は、3つのオプションを使用できます。

  • [View schema] (スキーマの表示): スキーマのみを表示する場合は、このオプションを選択します。

  • [Change to built-in property] (組み込みのプロパティに変更): ローカルで変更を行うためにスキーマを組み込みに変更する場合は、このオプションを選択します。

  • [Update repository connection] (リポジトリー接続を更新): リポジトリーに保存されているスキーマに変更を加え、変更後にそのコンテンツをすべてのジョブにプロパゲートするかどうかを決める場合は、このオプションを選択します。変更を現在のジョブにのみ反映する場合は、変更後、[No] (いいえ)を選択し、[Repository Content] (リポジトリーのコンテンツ)ウィンドウで再びこのスキーマのメタデータを選択します。

このコンポーネントのスキーマは、指定されたエンティティに関連しています。

[Custom filter] (カスタムフィルター)

このチェックボックスをオンにすると、表示されたフィールドでcontainsendswithstartswithなどの標準のODataクエリーファンクションを使用する検索条件を指定できます。サポートされているクエリー関数の詳細は、『Web APIを使用したクエリーデータ』の標準クエリー関数の説明を参照してください。

このオプションは、Microsoft CRM ON-PREMISE 2016、ONLINE 2016、2018に使用できます。

[Logical operator used to combine conditions] (条件の結合に使用する論理演算子)

[Conditions] (条件)テーブルで定義された条件の結合に使用する論理演算子を選択します。

  • [And] (および): すべての条件を満たすレコードが結果セットに含まれます。

  • [Or] (または): いずれかの条件を満たすレコードが結果セットに含まれます。

条件

[+]ボタンをクリックして必要な条件を追加し、条件ごとに以下のパラメーターを指定します:

  • [Input column] (入力カラム): セルをクリックし、条件を設定する入力スキーマのカラムを選択します。

  • [Operator] (演算子): セルをクリックし、[Value] (値)カラムで定義されている値と入力カラムの値を比較するために使用する演算子を選択します。このパラメーターの値はEqualNotEqualGreaterThanLessThanGreaterEqualLessEqual、およびLikeになります。

  • [Value] (値): 必要に応じて、引用符の間の値を入力します。Microsft CRM ONLINEまたはON-PREMISEバージョン2016(またはそれ以降のバージョン)を使用している場合、ID(たとえば、salesorderid)であるカラムを使用してデータをフィルター処理するには、IDを変換する式をこのフィールドに入力する必要がありますjava.util.UUID.fromString("your_salesorderid")などのJavaUUIDに変換します。

[Order by] (ソート順)

このチェックボックスをオンにすると、表示されたテーブルのカラムについて、取得したデータを昇順または降順のどちらで並べ替えるか指定できます。複数のソートカラムを指定できます。ソートの階層はカラムを指定する順序に基づきます。つまり、取得したデータは最初のカラムでソートされ、次にその並べ替えられたリストが2番目のカラムでソートされます。

このオプションは、Microsoft CRM ON-PREMISE 2016、ONLINE 2016、2018に使用できます。

詳細設定

[Reuse Http Client] (HTTPクライアントの再利用)

このチェックボックスをオンにして現在の接続を保持するか、オフにして接続を解除します。

このオプションは、Microsoft CRM ON-PREMISE 2015に使用できません。

[Max number of reconnection attempts] (再接続試行最大回数)

トークンが失効した後のMicrosoft CRMデータベースへの再接続試行最大回数。値を0または0未満に設定すると、再接続は試行されません。

このオプションは、Microsoft CRM ON-PREMISE 2016、ONLINE 2011、2016、2018に使用できます。

[Force OAuth resource] (OAuthリソースを強制する)

デフォルト以外のOAuthリソースを使用するには、このオプションを選択します。[Resource] (リソース)フィールドにOAuthリソースのURLを入力します。このオプションが選択されていない場合は、このリソースが[Basic settings] (基本設定)ビューの[Service Root URL] (サービスルートURL)オプションのホストになります。

このフィールドは、[Mode] (モード)ドロップダウンリストでOAUTH 2.0が選択されている場合に使用できます。

[Expand entity] (エンティティを展開)

展開されたエンティティプロパティを取得して、プロパティを専用カラムに書き込みます。展開されたエンティティプロパティは、カラムにJSTON文字列として書き込まれます。

カラムに展開されたエンティティの特定のプロパティを取得し、書き込むには、テーブルの下にあるプラスボタンをクリックしてテーブル内に行を追加します。[Expandable column] (展開可能なカラム)で展開されたエンティティを参照する展開可能なカラムをドロップダウンリストから選択し、[OData query option] (ODataクエリーオプション)カラムに展開されたエンティティの目的のプロパティを入力して、[Destination column] (宛先カラム)カラムでドロップダウンリストから宛先カラムを選択します。

注: 展開可能なカラム名は _で始まり、_valueで終わります。

$select={property_1_name},{property_2_name},...という形式に従って、[OData query option] (ODataクエリーオプション)カラムで1つ以上のプロパティを指定できます。プロパティを少なくとも1つ提供する必要があります。展開されたエンティティのプロパティをすべて取得して書き込むには、このカラムに$select=*と入力します。関連情報は、Olingo V4 Part 5.2: システムクエリーオプション: $select, $expandを使ってODataサービスをビルドする方法を参照してください。

このフィールドは、ON_PREMISE (CRM 2016必須)とONLINE (APIバージョン2016以上必須)の[Authentication Type] (認証タイプ)で使用できます。

[Custom headers] (カスタムヘッダー)

HTTPリクエストにヘッダー値のペアを追加して、特定の目的(たとえば、呼び出しのたびに取得できるページの最大数を取得する)を成し遂げます。詳細は、HTTP 要求の作成とエラーの処理をご覧ください。

ヘッダー値のペアを追加するには、テーブルの下にある[+]ボタンをクリックし、新しい行を追加して、対応するカラムにヘッダー名と値を入力します。

このオプションは、Microsoft CRM ON-PREMISE 2016、ONLINE 2016、2018に使用できます。

[tStatCatcher Statistics] (tStatCatcher統計)

このチェックボックスをオンにすると、ジョブレベルおよび各コンポーネントレベルでジョブ処理メタデータが収集されます。

[Global Variables] (グローバル変数)

NB_LINE

処理された行数。これはAfter変数で、整数を返します。

ERROR_MESSAGE

エラー発生時にコンポーネントによって生成されるエラーメッセージ。これはAfter変数で、文字列を返します。

使用方法

使用ルール

このコンポーネントは通常、ジョブまたはサブジョブの開始コンポーネントとして使い、常に出力リンクが必要です。

制限事項

tMicrosoftCRMInput(ONLINE 2016およびON-PREMISE 2016の両方)で、書き込み専用プロパティのデータの取得はサポートされていません。書き込み専用プロパティに対応するスキーマカラムが、定義済みのスキーマから削除されています。