クイックスタート

概要

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

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

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

前提条件

はじめる前に

1. Salesforce のセットアップ手順を完了します。
2. 新しいオートメーション プロジェクトを作成します。

   1. UiPath Studio を開きます。

   2. [新しいプロジェクト] の [プロセス] をクリックします ([新しい空のプロセス] ウィンドウが開きます)。

   3. プロジェクトの [名前]、[場所]、[説明] を入力します。

   4. [Create] をクリックします。

      

3. UiPath.Salesforce.Activities パッケージをインストールします。
   1. [デザイン] リボンの [パッケージを管理] をクリックします ([パッケージを管理] ウィンドウが開きます)。
   2. [すべてのパッケージ] の下の [オフィシャル] をクリックします。
   3. 検索バーに「Salesforce」と入力します。
   4. [インストール] をクリックし UiPath.Salesforce.Activities のライセンスに同意します。

      • UiPath Studio パッケージの詳細については、『Studio ガイド』の「パッケージの管理」をご覧ください。

        

手順

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

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

注:

以下の手順は、 String を SecureStringに変換する方法を示すことを目的としています。わかりやすくするため、また実用的なサンプルをすばやく作成できるように、変換はプロジェクト シーケンス内で行われ、資格情報の値を変数として入力する必要があります。これは、共有可能なプロジェクトやサンプル以外のプロジェクトを作成する場合に推奨されません。共有可能なプロジェクトやサンプル以外のプロジェクトを作成する際に、 コンシューマー シークレット、 パスワード、 セキュリティ トークン をローカル ソースから取得する外部ワークフローを作成して参照できます (例: .txt。Xlsxファイル) を選択し、AND 引数を使用して変換を実行します。

String を SecureString に変換する

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

   1. [左辺値 (To)] プロパティに、2 番目の SecureString 変数を入力します (例: password)。

   2. [値] プロパティに、最初の SecureString 変数を入力します (例: _securePassword)。

      

5. 次の 3 つの変数を作成します。
   1. String。コンシューマー シークレットを [既定値] の値として設定します (例: [名前]: textPassword、[既定値]: "4FA94...")。
   2. SecureString。New SecureString() を [既定値] の値として設定します (例: [名前]: secureConsumerSeret、[既定値]: New SecureString())。
   3. SecureString (例: [名前]: consumerSecret)。
      • SecureString 変数ではすべて System.Security.SecurityString 型を選択します。
   4. 手順 2 ～ 5 を繰り返し、コンシューマー シークレットの String を SecureString に変換します。
6. 次の 3 つの変数を作成します。
   1. String。セキュリティ トークンを [既定値] の値として設定します (例: [名前]: textPassword、[既定値]: ""MUc2B...")。
   2. SecureString。New SecureString() を [既定値] の値として設定します (例: [名前]: secureSecurityToken、[既定値]: New SecureString())。
   3. SecureString (例: [名前]: securityToken)。
      • SecureString 変数ではすべて System.Security.SecurityString 型を選択します。
   4. 手順 2 ～ 5 を繰り返し、セキュリティ トークンの String を SecureString に変換します。

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

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

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

1. プロジェクトに [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 ログイン のユーザー名 を入力します (例: "[e-mail]")

   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 の値が必要です。

         • [種類] フィールドを例にとると、既定では、選択リストには下の画像 (Salesforce アカウント画面) に示す値が含まれます。[ ラベルと値を書式設定] アクティビティを使用して、有効な String 値をプレビューできます (以下の例を参照)。

           

       • [完了] をクリックします。

         

   16. [SalesforceOutput] プロパティに、SalesforceStatus 型変数を作成して入力します (例: insertRecordStatus)。

       

2. [レコードを挿入] アクティビティの後に [ファイルをアップロード] アクティビティを追加します。

   1. ファイルの [説明]、[ファイル パス]、[タイトル] を入力します。

   2. [出力 ID] プロパティに、新しい String 型変数を作成して入力します (例: newFileID)。

   3. [SalesforceStatus] プロパティに、新しい SalesforceStatus 型変数を作成して入力します (例: uploadFileStatus)。

      

3. [レコードを取得] アクティビティの後に [ファイルを割り当て] アクティビティを追加します。

   1. [ID] プロパティに、[ファイルをアップロード] アクティビティに対して作成した String 変数を入力します (例: newFileID)。

   2. [レコード ID] プロパティに、[アクティビティを挿入] アクティビティに対して作成した String 変数を入力します (例: newAccountID)。

   3. [共有の種類] の値を入力します (例: 推測を表す "I")。

   4. [表示] の値を入力します (例: "AllUsers")。

   5. [SalesforceStatus] プロパティに、新しい SalesforceStatus 型変数を作成して入力します (例: assignFileStatus)。

      

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

1. レコードが挿入され、ファイルがアップロードされて挿入されたレコードに割り当てられたことを確認するために、[ファイルを割り当て] アクティビティの後にアクティビティを 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. [開始] をクリックし、出力ウィンドウの結果を確認します。

      

2. 結果をさらに確認するには、Salesforce 組織にログインし、自身の [取引先] および [ファイル] に移動して、新たに追加された内容を確認します。

   

   

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

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