「オブジェクトのアップサート」アクティビティー

このアクティビティーは、Saleforce.com で既存のオブジェクトを更新したり新規オブジェクトを作成したりする場合に使用します。

このタスクについて

このアクティビティーでは、外部 ID (通常は外部キー) によって、Salesforce.com で既存のオブジェクトを更新するのか 新規オブジェクトを作成するのかが判別されます。

Salesforce.com API では、1 回の Upsert 呼び出しで作成できるオブジェクトの数が 200 個のオブジェクトに 制限されていますが、Cast Iron® Salesforce.com コネクターではそのような制限はありません。 「オブジェクトの Upsert」アクティビティーを使用すれば、無制限の数のオブジェクトを作成できます。

オブジェクトの Upsert」アクティビティーを使用するには、以下のようにします。

手順

  1. アクティビティー」タブで「Salesforce.com」ディレクトリーを開き、「オブジェクトのアップサート」アクティビティーを見つけます。
  2. アクティビティーをオーケストレーションに追加します。 アクティビティーの「チェックリスト」「要約」が、オーケストレーションの下に表示されます。
  3. Salesforce.com エンドポイントを選択します。 Salesforce.com エンドポイントの作成または編集についての説明は、『Salesforce.com エンドポイントの作成または編集』を参照してください。
  4. Salesforce.com オブジェクト・タイプとオブジェクト・フィールド設定を選択して、アクティビティーを構成します。
    注: 選択できるオブジェクト・タイプは、 統合アプライアンスが更新または作成できるオブジェクト・タイプで、かつ、 少なくとも 1 つの「外部 ID」フィールドが含まれている オブジェクト・タイプのみです。 オブジェクト・タイプを選択すると、 「構成」ペインの 「外部 ID」フィールドにオブジェクト・タイプで定義された外部 ID が Studio から表示されます。 「外部 ID」リストにリストされる ID は編集できません。 選択する外部 ID は必須フィールドです。 このフィールドは、「オブジェクト・フィールド設定」テーブルからクリアできません。 使用可能な外部 ID が 1 つのみの場合は、このフィールドが Studio によって「オブジェクト・フィールド設定」テーブルで自動的に選択されます。
  5. このアクティビティーの「再試行」パラメーターと「タイムアウト」パラメーターを指定します
  6. このアクティビティーの入力をマップします。
  7. このアクティビティーの出力をマップします。

タスクの結果

「オブジェクトのアップサート」アクティビティーの入力をマップする

  1. チェックリスト」で「入力のマップ」を選択します。 「アクティビティーへ」パネルに objects エレメントが表示されます。
  2. デフォルト・ノードを 右クリックして「オプション・パラメーターの表示」を 選択し、このアクティビティーに対して以下のオプション入力パラメーターを表示します。
    • AssignmentRuleHeader
    • MruHeader
    • EmailHeader
    • CallOptions
    • connection
    • sessionInfo
  3. 入力の選択...」をクリックして、マップの入力変数を選択します。 変数の作成についての説明は、『変数の作成』を参照してください。
  4. 必要に応じて、入力パラメーターを変数にマップします。 マッピングの説明については、『マップの作成』を参照してください。

このアクティビティーでは、以下のオプション入力パラメーターがサポートされます。

  • AssignmentRuleHeader
  • EmailHeader
  • MruHeader

オプション・フィールド・エレメントとヌル可能フィールド・エレメントの動作は以下のとおりです。

  • Salesforce.com サーバーがフィールドの値を提供しない場合、統合アプライアンスはオプション・フィールドを更新しません。
  • ヌル可能フィールドで xsi:nil 属性を true に設定した場合、統合アプライアンスは、 更新時にそのフィールドをヌルに設定します。
    注: フィールドを空ストリングに設定しても、フィールドはヌルに設定されません。

「オブジェクトのアップサート」アクティビティーの出力をマップする

  1. 「チェックリスト」で、「出力のマップ」を選択します。 「アクティビティーから」パネルに upsertResults エレメントが表示されます。
  2. 出力の選択...」をクリックして、マップの出力変数を選択します。 変数の作成についての説明は、『変数の作成』を参照してください。
  3. 必要に応じて、出力パラメーターを変数にマップします。 マッピングの説明については、『マップの作成』を参照してください。