tMarketoCampaignの標準プロパティ - 7.3

Marketo

Version
7.3
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 Real-Time Big Data Platform
Module
Talend Studio
Content
ジョブデザインと開発 > サードパーティーシステム > ビジネスアプリケーション > Marketo
データガバナンス > サードパーティーシステム > ビジネスアプリケーション > Marketo
データクオリティとプレパレーション > サードパーティーシステム > ビジネスアプリケーション > Marketo
Last publication date
2024-02-22

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

標準tMarketoCampaignコンポーネントは、ビジネスファミリーとCloudファミリーに属しています。

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

基本設定

[Property Type] (プロパティタイプ)

接続の詳細を設定する方法を選択します。

  • [Built-In] (組み込み): このコンポーネントの接続の詳細がローカルに設定されます。関連するすべての接続のプロパティ値を手動で指定する必要があります。

  • [Repository] (リポジトリー): [Repository] (リポジトリー) > [Metadata] (メタデータ)で一元的に保存された接続の詳細が、このコンポーネントによって再使用されます。このチェックボックスの横にある [...] ボタンをクリックし、表示された [Repository Content] (リポジトリーのコンテンツ)ダイアログボックスで、再使用する接続の詳細を選択すると、関連するすべての接続のプロパティに値が自動的に入力されます。

[Connection Component] (接続コンポーネント)ドロップダウンリストから、他の接続コンポーネントを選択した場合、これらのプロパティは、利用できません。

[Connection Component] (接続コンポーネント)

ドロップダウンリストから、Marketoへの接続を設定するために接続の詳細を使うコンポーネントを選択します。

エンドポイントのアドレス

Marketo WebサービスのAPIエンドポイントURLを入力します。APIエンドポイントURLは、Marketo[管理者] > [Webサービス]パネルにあります。

[Client access ID] (クライアントアクセスID)

Marketo WebサービスにアクセスするためのクライアントIDを入力します。

クライアントIDとクライアントシークレットキーは、Marketoの[Admin] (管理者) > LaunchPointパネルにあります。アクセスするサービスの[View Details] (詳細の表示)をクリックしてください。詳細な情報が必要な場合は、Marketoのサポート(support@marketo.com)への問い合わせも可能です。

[Secret key] (シークレットキー)

Marketo Webサービスにアクセスするためのクライアントシークレットキーを入力します。

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

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

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

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

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

このコンポーネントのスキーマは事前定義されており、選択したAPIモード、選択した操作、または指定したカスタムオブジェクトによって異なります。

APIモードが変更された場合は、[Connection Component] (接続コンポーネント)ドロップダウンリストから、コンポーネントを切り替えて(tMarketoConnectionコンポーネントによって作成された接続を再利用する場合のみ)、[Operation] (操作)ドロップダウンリストから、実行する操作を変更して、スキーマカラムを手動で更新する必要があります。

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

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

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

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

このコンポーネントは、ダイナミックスキーマ機能の利点を備えているので、ソースファイルから不明なカラムを取得したり、各カラムを個別にマッピングしなくてもソースからカラムを一括してコピーしたりできます。ダイナミックスキーマの詳細は、Talend Studioユーザーガイドをご覧ください。

このダイナミックスキーマ機能は、テーブルの不明なカラムを取得する目的で設計されており、この目的に限り使用をお勧めします。テーブルの作成で使用することは勧められていません。

このコンポーネントのダイナミックスキーマ機能は、REST APIモードでのみサポートされています。

アクション

ドロップダウンリストから、実行する次のいずれかの操作を選択します。

  • [get] (取得): 次を含むキャンペーンの詳細を取得します: Ids(Commas separated)Campaign(s) (Commas separated)Program(s)(Commas separated)Workspace(s)(Commas separated)
  • getById: キャンペーンIDでキャンペーンの詳細を取得します。
  • [schedule] (スケジュール): キャンペーンを計画します。
  • [trigger] (トリガー): 以下によってキャンペーンをトリガーします。
    • [request] (リクエスト): キャンペーンをリクエストします。
    • [activate] (有効化): キャンペーンを有効化します。
    • [deactivate] (無効化): キャンペーンを無効化します。
リードの一括処理

リードを一括で処理するには、このチェックボックスをオンにします。

このチェックボックスは、[Action] (アクション)ドロップダウンリストでtriggerが選択され、[Trigger] (トリガー)ドロップダウンリストでrequestが選択されている場合にのみ使えます。

バッチサイズ バッチで処理するリードの数を指定します。最大サイズは100リードです。
このフィールドは、次の場合にのみ使えます。
  • [Action] (アクション)ドロップダウンリストでgetが選択されている。または
  • [Action] (アクション)ドロップダウンリストでtriggerが選択され、[Trigger] (トリガー)ドロップダウンリストでrequestが選択されている。
ProgramNameへのクローン キャンペーンのクローンを作成するプログラムを指定します。

このフィールドは、[Action] (アクション)ドロップダウンリストでscheduleが選択されている場合にのみ使えます。

実行場所 キャンペーンを実行する時間を指定します。

このフィールドは、[Action] (アクション)ドロップダウンリストでscheduleが選択されている場合にのみ使えます。

トークン プログラムで使うトークンを追加します。

このフィールドは、[Action] (アクション)ドロップダウンリストでscheduleまたはtriggerが選択されている場合にのみ使えます。

マッピング

このテーブルを完成させて、コンポーネントスキーマのカラム名をMarketoのカラム名にマッピングします。デフォルトでは、[Column name] (カラム名)フィールドのカラム名は、スキーマ内のカラム名と同じです。

Marketoの一部のカラム名には、コンポーネントスキーマでは許可されていない空白が含まれている場合があるため、[Marketo column] (Marketoカラム名)カラムで対応するカラムフィールドを指定する必要があります。スキーマで定義されたカラム名がMarketoのカラム名と同じである場合、カラムマッピングの設定は不要です。

REST APIモードの[Operation] (操作)リストから CustomObjectが選択されている場合、このテーブルは使えません。

[Die on error] (エラー発生時に強制終了)

このチェックボックスをオンにすると、エラー発生時にジョブの実行が停止されます。

詳細設定

APIモード

Marketo APIモード(REST API (デフォルト)またはSOAP APIを選択します。

Marketo REST APIの詳細は、http://developers.marketo.com/documentation/rest/をご覧ください。

Marketo SOAP APIの詳細は、http://developers.marketo.com/documentation/soap/をご覧ください。

Timeout (タイムアウト)

Marketo Webサービスへの接続の試行が終了するまでのタイムアウト値(ミリ秒)を入力してください。

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

試行を断念するまでのMarketo Webサービスに対する再接続試行の最大回数を入力します。

[Attempt interval time] (試行間隔)

その後の再接続試行までの間隔(ミリ秒)を入力します。

[tStatCatcher Statistics] (tStatCatcher統計)

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

グローバル変数

NUMBER_CALL

呼び出し回数。これはAfter変数で、整数を返します。

ERROR_MESSAGE

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

使用方法

使用ルール

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