連携アクティビティ (クラシック)

最終更新日時 2024年12月13日

クイックスタート

概要

このガイドの目的は、実用的なサンプルを作成することにより、Salesforce 組織への接続をすばやく確認したり、含まれるアクティビティの入力/出力データ型に習熟したりできるようにすることです。

このページの手順を完了すると、以下のアクションを実行するオートメーションシーケンスが使用できるようになります。

Salesforce 資格情報の SecureString 変数を作成します ([メソッドを呼び出し])。
SecureString 資格情報を使用して Salesforce 組織への接続を確立します ([Salesforce アプリケーションスコープ])。
新しい Salesforce アカウントレコードを作成します ([レコードを挿入])。
ファイルを Salesforce 組織にアップロードします ([ファイルをアップロード])。
アップロードしたファイルを新しい Salesforce 取引先レコードに割り当てます ([ファイルを割り当て])。
各 SalesforceStatus オブジェクトを出力することにより、[レコードを挿入]、[ファイルをアップロード]、[ファイルを割り当て] のアクティビティの結果を検証します。

前提条件

はじめる前に

Salesforce のセットアップ手順を完了します。
新しいオートメーションプロジェクトを作成します。
1. UiPath Studio を開きます。
2. [新しいプロジェクト] の [プロセス] をクリックします ([新しい空のプロセス] ウィンドウが開きます)。
3. プロジェクトの [名前]、[場所]、[説明] を入力します。
4. [作成] をクリックします。
UiPath.Salesforce.Activities パッケージをインストールします。
1. [デザイン] リボンの [パッケージを管理] をクリックします ([パッケージを管理] ウィンドウが開きます)。
2. [すべてのパッケージ] の下の [オフィシャル] をクリックします。
3. [検索] バーに「Salesforce」と入力します。
4. [インストール] をクリックし UiPath.Salesforce.Activities のライセンスに同意します。
  - UiPath Studio パッケージの詳細については、『Studio ガイド』の「パッケージの管理」をご覧ください。

手順

プロジェクトをビルドする

[Salesforce アプリケーションスコープ] アクティビティでは、コンシューマーシークレット、パスワード、セキュリティコンポーネントの入力プロパティに SecureString データ型が必要です。これらの SecureString データ型を取得するには、「セットアップ」ガイドの「資格情報を取得する」の手順を実行する際にこれらのプロパティに対して保存した String の値を変換します。

注:

以下の手順は、String を SecureString に変換する方法を説明するためのものです。簡素化のため、および実用的なサンプルをすばやく作成できるようにするため、この変換はプロジェクトシーケンス内で実行され、ユーザーが資格情報の値を変数として入力する必要があります。共有可能なプロジェクトやサンプルではないプロジェクトを作成する場合には、この方法はお勧めしません。

共有可能なプロジェクトまたはサンプル以外のプロジェクトを作成する場合は、コンシューマーシークレット、パスワード、セキュリティトークンをローカルソース (例: .txt、.xlsx ファイル) から取得し、入力引数と出力引数を使用して変換を実行する外部ワークフローを作成して参照できます。

String を SecureString に変換する

次の 3 つの変数を作成します。
1. Salesforce ログインパスワードを既定値とする String (例: [名前]: textPassword、[既定値]: "UiPath123")
2. SecureString。New SecureString() を [既定値] の値として設定します (例: [名前]: securePassword、[既定値]:New SecureString())。
3. SecureString (例: [名前]: password)。
  - SecureString 変数ではすべて System.Security.SecurityString 型を選択します。
4. 新しいステートメントをプロセスに追加します。
- 推奨: [表示名] を "Create SecureString - Password" などに変更して、目的を簡単に特定できるようにします。
[シーケンス] 内部にアクティビティを追加します。
1. [ TypeArgument ] プロパティで、[ System.Char] を選択します。
2. [値] プロパティに、String 変数を入力します (例: textPassword)。
[繰り返し (コレクションの各要素)] アクティビティに、[メソッドを呼び出し] アクティビティを追加します ([プログラミング] > [実行] > [メソッドを呼び出し])。
1. [ターゲットオブジェクト] プロパティに、最初の SecureString 変数を入力します (例: securePassword)。
  - [ターゲット型] プロパティが (null) であることを確認します ([ターゲットオブジェクト] または [ターゲット型] のどちらかを使用できます。両方を使用することはできません)。
2. [メソッド名] プロパティに「AppendChar」と入力します。
  - AppendChar メソッドは、文字列の後に UTF-16 コード単位を追加するために使用します。
3. [パラメーター] プロパティに、次の値を使用して新しいパラメーターを追加します: [方向]: [入力]、[型]: [System.Char]、[値]: [item]。
[メソッドを呼び出し] アクティビティの後にアクティビティを追加します。
1. [左辺値 (To)] プロパティに、2 番目の SecureString 変数を入力します (例: password)。
2. [値] プロパティに、最初の SecureString 変数を入力します (例: _securePassword)。
次の 3 つの変数を作成します。
1. String。コンシューマーシークレットを [既定値] の値として設定します (例: [名前]: textPassword、[既定値]: "4FA94...")。
2. SecureString。New SecureString() を [既定値] の値として設定します (例: [名前]: secureConsumerSeret、[既定値]: New SecureString())。
3. SecureString (例: [名前]: consumerSecret)。
  - SecureString 変数ではすべて System.Security.SecurityString 型を選択します。
4. 手順 2 ～ 5 を繰り返し、コンシューマーシークレットの String を SecureString に変換します。
次の 3 つの変数を作成します。
1. セキュリティトークンを既定値とする String (例: [名前]: textPassword、[既定値]: ""MUc2B...")
2. New SecureString() を既定値とする SecureString (例: [名前]: secureSecurityToken、[既定値]:New SecureString())。
3. SecureString (例: [名前]: securityToken)。
  - SecureString 変数ではすべて System.Security.SecurityString 型を選択します。
4. 手順 2 ～ 5 を繰り返し、セキュリティトークンの String を SecureString に変換します。

以下の画像のように、3 つの [セキュリティで保護された文字列を作成] シーケンスがプロセス内に作成されました。

SecureString 変数を使用できるようになったので、[ Salesforce アプリケーションスコープ] アクティビティを他の Salesforce アクティビティと一緒に追加できます。

Salesforce アクティビティを追加する

プロジェクトに [Salesforce アプリケーションスコープ] アクティビティを追加します。
1. プロパティ値を入力する前に、接続をテストしましょう。
  1. [設定] ボタンをクリックします (接続ウィザードが開きます)。
  2. サーバーを選択します (開発者組織、または非開発者の運用組織に接続する場合は [本稼働] を選択し、サンドボックス/テスト組織に接続する場合は [テスト] を選択します)。
  3. [コンシューマーキー]、[コンシューマーシークレット]、[ユーザー名]、[パスワード]、[セキュリティトークン] (開発者ログインに必要) を入力します。
  4. [テスト接続] ボタンをクリックし、[接続に成功しました] ウィンドウが表示されるまで待ちます。
    - エラーが発生する場合は、正しいサーバーを選択していることを確認します。次に、「セットアップ」ガイドの「資格情報を取得する」の最後の手順に従ってセキュリティトークンをリセットし、メールで送信される新しい値を入力します。
  5. 接続に成功したら、上記の手順で作成した SecureString 変数を含むプロパティ値を追加できます (接続ウィザードに入力した値はプロパティ値から独立しており、共有されません)。
2. 「資格情報を取得する」の手順の実行時にコピーしたコンシューマーキーの値 (String) を入力します。
3. [コンシューマーシークレット] プロパティに、上記の手順 6 で作成した 2 番目の SecureString 変数を入力します (例: consumerSecret)。
4. [パスワード] プロパティに、上記の手順 1 で作成した 2 番目の SecureString 変数を入力します (例: password)。
5. [サーバー] の値を入力します (「Live」または「Test」)。
6. Salesforce ログインの ユーザー名 を入力します (例: "name@company.com")。
7. [Salesforce 接続] プロパティに、IConnectionService 型変数を作成して入力します (例: salesforceConnection)。
  - この変数は、このガイドの手順を実行する際には使用しませんが、出力変数を作成して、後続のアクティビティで使用できるようにすることをお勧めします。
8. [Salesforce アプリケーションスコープ] アクティビティ内に [レコードを挿入] アクティビティを追加します。
9. このアクティビティの出力プロパティ用に、新しい String 変数を作成します (例: newAccountID)。
10. [設定] ボタンをクリックします (Salesforce オブジェクトウィザードが開きます)。
  - ウィザードの動作について詳しくは、「Salesforce アクティビティについて」のページの「Salesforce オブジェクトウィザード」のセクションをご覧ください。
11. [Salesforce オブジェクト] ドロップダウンリストで、[アカウント] を選択します ([アカウント ID] フィールドと [名前] フィールドが表示されます)。
12. [単一のフィールドを追加] テキストボックスに「Type」 と入力し、Enter キーを押します (これでフィールドが 3 つになりました)。
13. [アカウント ID] フィールドに、手順 1 で作成した String 変数を入力します (例: newAcountID)。
14. アカウントの [名前] を入力します (例: "Salesforce Quickstart")。
15. 有効な [型] の String を入力します (例: "Prospect")。
  - picklist データ型 のすべてのフィールドでは、Salesforce のユーザーインターフェイスに表示されるリストの項目に一致する String 値が必要です。
    - [Type] フィールドを例に取ると、既定では、下の図に示す値が picklist に含まれています ([Salesforce アカウント] 画面から)。[ラベルおよび値の書式を設定] アクティビティを使用して、有効な String 値をプレビューできます (以下の例を参照)。
  - [完了] をクリックします。
16. [SalesforceOutput] プロパティに、SalesforceStatus 型変数を作成して入力します (例: insertRecordStatus)。
[レコードを挿入] アクティビティの後に [ファイルをアップロード] アクティビティを追加します。
1. ファイルの [説明]、[ファイルパス]、[タイトル] を入力します。
2. [出力 ID] プロパティに、新しい String 変数を作成して入力します (例: newFileID)。
3. [SalesforceStatus] プロパティに、新しい SalesforceStatus 変数を作成して入力します (例: uploadFileStatus)。
[レコードを取得] アクティビティの後に [ファイルを割り当て] アクティビティを追加します。
1. [ID] プロパティに、[ファイルをアップロード] アクティビティに対して作成した String 変数を入力します (例: newFileID)。
2. [レコード ID] プロパティに、[アクティビティを挿入] アクティビティに対して作成した String 変数を入力します (例: newAccountID)。
3. [共有の種類] の値を入力します (例: 推測を表す "I")。
4. [表示] の値を 入力します (例: "AllUsers")。
5. [SalesforceStatus] プロパティに、新しい SalesforceStatus 型変数を作成して入力します (例: assignFileStatus)。

プロジェクトをテストする

レコードが挿入され、ファイルがアップロードされて挿入されたレコードに割り当てられたことを確認するために、[ファイルを割り当て] アクティビティの後にアクティビティを 3 つ追加します。
1. 最初の [1 行を書き込み ] アクティビティの [ Text] に、「"Insert Record Success: "+insertRecordStatus.Success.ToString」と入力します。
  - insertRecordStatus は、[レコードを挿入] アクティビティに対して作成した SalesforceStatus 変数です。
2. 2 番目の [1 行を書き込み] アクティビティの [Text] に、「Upload File Success: "+uploadFileSuccess.Success.ToString」と入力します。
  - uploadFileStatus は、[ファイルをアップロード] アクティビティに対して作成した SalesforceStatus 変数です。
3. 3 番目の [1 行を書き込み] アクティビティの [Text] に、「"Upload File Success: "+assignFileSuccess.Success.ToString」と入力します。
  - assignFileStatus は、[ファイルを割り当て] アクティビティに対して作成した SalesforceStatus 変数です。
4. [開始] をクリックし、出力ウィンドウの結果を確認します。
結果をさらに確認するには、Salesforce 組織にログインし、自身の [取引先] および [ ファイル] に移動して、新たに追加された内容を確認します。

これで完了です。 Salesforce アクティビティを含むオートメーションプロジェクトが作成されました。 Salesforce アクティビティについて詳しくは、「アクティビティ」をご覧ください。アクティビティの詳細ページへのリンクが記載されています。

Salesforce の操作の自動化をさらに進めるには、UiPath Connector for Salesforce のドキュメントをご覧ください。UiPath Connector for Salesforce は、Salesforce と UiPath Orchestrator (オンプレミスまたはクラウドのインスタンス) との間に「サーバー – サーバー」接続を作成します。 Flow Builder、プロセスビルダー、またはワークフロー経由で Salesforce から UiPath のジョブを送信したり、キューアイテムを追加したりすることができます。