Salesforceの統合

リード、取引先、商談、ケース、契約にどこからでもアクセスできるように、Salesforceと統合します。

以下のプロセスを使用して、Salesforce統合を有効にします。前提条件を満たしていることを確認してから、Salesforce統合をセットアップします。このプロセスを完了すると、Citrixマイクロアプリの使用によって実行されたすべてのアクションを含む、既存のレベルの監査ログが保持されます。

追加設定不要のSalesforceマイクロアプリの一覧については、「Salesforceマイクロアプリの使用」を参照してください。

必須条件の確認

Salesforceでこの統合をセットアップした後、Citrix Workspaceマイクロアプリに統合を追加するには、以下のアーティファクトが必要になります:

  • ユーザー名
  • パスワード
  • セキュリティトークン

OAuth 2.0の場合:

  • コンシューマーキー
  • コンシューマーシークレット

注:

利用可能な場合は、サービス認証方法として常にOAuth 2.0を使用することをお勧めします。OAuth 2.0は、統合が、構成済みのマイクロアプリとの最大限のセキュリティコンプライアンスを満たすことを保証します。

統合ではSalesforceインスタンスへの定期的なAPIアクセスが必要なので、Salesforceで専用のユーザーアカウントを作成することをお勧めします。その後、そのアカウントを使用してSalesforce統合を構成します。このアカウントでは以下が必要です:

  • 完全なデータアクセス特権が付与されている
  • APIが有効になっている
  • 2要素認証が許可されていない

専用アカウントを使用すると、Workspaceで実行されたアクティビティを区別できるので、監査ログに役立ちます。このページには、Salesforce ClassicとSalesforce Lightning Experienceの両方のチュートリアルが含まれています。両方のチュートリアルは、ユーザーがSalesforceのシステム管理者であることを前提としています。

注:

Salesforceの「Contact」および「Group」エディションは、APIをサポートしていません。「Professional」エディションでは、自動的にAPIがサポートされているわけではありません。ただし、リクエストに応じてサポートを有効にできます。

また、SalesforceではAPI要求の数が制限されています。大量のデータを頻繁に同期する予定がある場合は、「Salesforce API要求の制限と割り当て」を参照してください。

  • Citrix GatewayがSalesforceのシングルサインオンに対応するように構成して、ユーザーがログインすると、再度資格情報を入力しなくても自動的に再ログインできるようにします。Salesforceシングルサインオンの構成の手順に従ってください。SSOの構成について詳しくは、「Citrix Gatewayサービス」を参照してください。

新しいプロファイルの追加

次の手順を実行します:

  1. www.salesforce.comにログインします。
  2. [Setting] アイコンに移動して、[Setup]>[Administration]>[Manage Users]>[Profiles]>[New Profile]と選択します。
  3. [Existing Profile][System Administrator] に設定して、このプロファイル用に作成するユーザーが完全なデータアクセス特権を持つようにします。
  4. プロファイル名を入力し、[Save]を選択します。以下の手順で新規ユーザーとしてプロファイルを追加する際には、簡単に参照できるように、Citrix Workspaceアクセスなどのプロファイル名をつけることをお勧めします。

    プロファイルパネルが開き、新しいプロファイルが表示されます。

作成したプロファイルのAPIアクセスの有効化

  1. [Profile] パネルで、[Edit]を選択します。
  2. [Administrative Permissions]まで下にスクロールして、 [API Enabled]チェックボックスをオンにします。
  3. (オプション)パスワードの有効期限を無効にするには、 [Password Never Expires]チェックボックスをオンにします。

    注:

    このオプションを使用すると、潜在的なセキュリティの脆弱性が生じます。

  4. [保存] を選択します。

コールバックURLの追加

インスタンス構成にカスタムURLを追加して、プライベートデータへのアクセスを許可し、OAuth認証済みユーザーアクションを有効にします。

  1. 管理者としてSalesforceにログオンします。
  2. [Platform Tools]>[Apps]>[App Manager] の順に移動します。
  3. [New Connected App] を選択します。
  4. [Basic Information] で 、次のフィールドに入力します:
    • 接続されているアプリの名前
    • API名
    • 取引先責任者メールアドレス
  5. [API] で、[Enable OAuth Settings] チェックボックスをオンにします。
  6. [Callback URL] フィールドに、次の承認済みリダイレクトURLをマイクロアプリサーバーURLを指定して追加します:

    • https://{yourmicroappserverurl}/admin/api/external-services/com.sapho.services.salesforce.SalesforceService/auth/serverContext
    • https://{yourmicroappserverurl}/app/api/auth/serviceAction/callback
  7. [Selected OAuth Scopes] の横で、[Available OAuth Scopes] の下の以下のスコープを選択してから、[Add] を選択して [Selected OAuth Scopes] フィールドに移動します:
    • ユーザーデータへのアクセスおよび管理(api)
    • ユーザーの基本情報へのアクセス(id、profile、email、address、phone)
    • 任意の時間にユーザーの要求を実行(refresh_token、offline_access)
  8. [保存] を選択します。

(オプション)ログインIP範囲の制限

組織がユーザープロファイルのIP範囲を設定している場合、ログインアクセスをユーザーレベルで制御できます。ユーザーのプロファイルで許可されるIPアドレスの範囲を指定します。詳しくは、「拡張プロファイルユーザーインターフェイスでのログインIP範囲の制限」を参照してください。

ログインIP範囲を制限する場合は、以下の手順でセキュリティトークンを生成する必要はありません。

新しいユーザーの追加

Salesforceへの接続に使用される専用ユーザーアカウントを作成します。前の手順で追加した新しいプロファイルを使用して、「新しいプロファイルの追加」の手順に従います。

次の手順を実行します:

  1. [セットアップ]>[管理]>[ユーザーの管理]>[ユーザー]>[新規ユーザー] と選択します。
  2. 赤の必須フィールドに入力します。
  3. ユーザーライセンスSalesforceに設定します。
  4. プロファイルシステム管理者に設定します。
  5. [保存] をクリックします。

新しいユーザーのセットアップ

専用のユーザーアカウントを追加すると、指定したアドレスにメールが届きます。

次の手順を実行します:

  1. メールを見つけて、指示に従ってリンクをクリックします。
  2. Salesforceにログインします。
  3. パスワードとパスワードの質問を設定します。

セキュリティトークンの生成

専用ユーザープロファイルのログインIP範囲を制限した場合は、この手順をスキップできます。ホワイトリストのIPブロックからSalesforce APIに接続するアカウントには、セキュリティトークンは必要ありません。

次の手順を実行します:

  1. ログインしてアカウント名を選択します。
  2. [My Settings]>[Personal]>[Reset My Security Token] と選択します。
  3. [Reset My Security Token] を選択します。

    新しいセキュリティトークンが、このアカウントの個人設定で指定したメールアドレスに送信されます。このアカウントのパスワードがリセットされるたびに、新しいセキュリティトークンも取得します。

これで統合の追加を完了できます。Salesforceサービス定義の入力フィールドに、専用ユーザーアカウントのユーザー名パスワードを入力します。

IPをホワイトリストに登録した場合、セキュリティトークンを入力する必要はありません。登録しなかった場合は、専用アカウントのメールボックスに送信されたセキュリティトークンを貼り付けます。

クエリのフィルタリング

ほとんどのSalesforceエンティティは、フィルタリングをサポートしています。定義済みのクエリから選択するか、Salesforce SOQL言語を使用して自分のカスタムクエリを作成します。詳しくは、「Salesforce Object Query Languageドキュメント」を参照してください。

Citrix Workspaceマイクロアプリへの統合の追加

Salesforce統合をCitrix Workspaceマイクロアプリに追加して、アプリケーションに接続します。これにより、通知とアクションが設定済みとなっている追加設定不要のマイクロアプリを、Workspace内で使用できるようになります。

次の手順を実行します:

  1. 概要ページから、[はじめに]を選択します。

    [統合の管理]ページが開きます。

  2. [新しい統合を追加] および [Citrix提供のテンプレートから新しい統合を追加する] を選択します。
  3. Salesforceタイルを選択します。
  4. 統合の名前を入力します。

    Salesforceのコネクタのパラメーター、ユーザー名、パスワード、ユーザー認証、セキュリティトークン

  5. 前の手順で収集したサービス認証コネクタのパラメーターを入力します。
    • ターゲットシステムサービス認証の [ユーザー名][パスワード] の資格情報を入力します。
    • [認証方法] で「OAuth 2. 0」を選択します。
      • 前提条件の手順で収集したコンシューマーキーコンシューマーシークレットを入力します。
    • [セキュリティトークン] を入力します。
    • サンドボックス環境にデータを読み込む必要がある場合は、[サンドボックス] を切り替えます。
  6. [追加] を選択します。

[マイクロアプリ統合] ページが開き、追加した統合とそのマイクロアプリが表示されています。ここから別の統合を追加したり、追加設定不要のマイクロアプリのセットアップを続行したり、この統合用の新しいマイクロアプリを作成したりできます。

これで、最初のデータ同期を設定して実行する準備ができました。統合アプリケーションからマイクロアプリプラットフォームに大量のデータをプルできるので、[テーブル] ページを使用して、最初のデータ同期のエンティティをフィルタリングし、同期を高速化することをお勧めします。

詳しくは、「統合の構成」で「必要なエンティティの確認」および「データ同期の設定」を参照してください。

APIエンドポイントとテーブルエンティティについて詳しくは、「Salesforceコネクタの仕様」を参照してください。

Salesforceマイクロアプリの使用

既存のアプリケーション統合には、追加設定不要のマイクロアプリが付属しています。これらのマイクロアプリから開始して、ニーズに合わせてカスタマイズします。

Salesforceマイクロアプリ

Salesforce統合には、以下の設定済みで追加設定不要のマイクロアプリが付属しています:

取引先: 取引先を検索、表示、編集します。

通知またはページ ユースケースワークフロー
取引先割り当て(既存)通知 取引先の所有者が変更されると、新しい所有者は通知を受け取ります。
取引先割り当て(新規)通知 新しい取引先がユーザーに割り当てられると、ユーザーは通知を受け取ります。
取引先の詳細ページ 取引先責任者や取引先責任者の詳細へのリンクなどの詳細を含む取引先のビューを提供します。
取引先責任者の詳細ページ 取引先責任者の詳細の読み取り専用ビューを提供します。
取引先の編集ページ 取引先への編集を送信するためのフォームを提供します。
私の取引先ページ パーソナライズされた取引先一覧を提供します。

ケース: 割り当てられているケースを検索、表示、編集します。

通知またはページ ユースケースワークフロー
ケース割り当て(既存)通知 ケースの所有者が変更されると、新しい所有者は通知を受け取ります。
ケース割り当て(新規)通知 新しいケースがユーザーに割り当てられると、ユーザーは通知を受け取ります。
取引先関連新規ケース通知 ユーザーの取引先に関連する新しいケースが作成されると、ユーザーは通知を受け取ります。
取引先の詳細ページ 取引先責任者や取引先責任者の詳細へのリンクなどの詳細を含む取引先のビューを提供します。
ケースの詳細ページ ケースのビューと、編集ページを開くためのボタンを提供します。
取引先責任者の詳細ページ 取引先責任者の詳細の読み取り専用ビューを提供します。
ケースの編集ページ ケースへの編集を送信するためのフォームを提供します。
私のオープンケースページ パーソナライズされたユーザーに割り当てられているケースの一覧を提供します。

取引先責任者: 取引先責任者を検索、表示、編集します。

通知またはページ ユースケースワークフロー
取引先責任者割り当て(既存)通知 取引先責任者の所有者が変更されると、新しい所有者は通知を受け取ります。
取引先責任者割り当て(新規)通知 新しい取引先責任者がユーザーに割り当てられると、ユーザーは通知を受け取ります。
取引先責任者の詳細ページ 取引先責任者のビューと、編集ページを開くためのボタンを提供します。
取引先責任者の編集ページ 取引先責任者への編集を送信するためのフォームを提供します。
私の取引先責任者ページ パーソナライズされた取引先責任者の一覧を提供します。

契約: 契約を検索、表示、編集します。

通知またはページ ユースケースワークフロー
契約更新通知 契約の詳細が変更されると、契約の所有者は通知を受け取ります。
契約期限切れ通知 契約が終了日前後に定義されたしきい値(たとえば、デフォルトでは3日)を経過すると、所有者は通知リマインダーを受け取ります。
新規契約の有効化申請通知 新しい保留中の契約有効化承認依頼がユーザーに割り当てられると、ユーザーは通知を受け取ります。
取引先の詳細ページ 取引先責任者や取引先責任者の詳細へのリンクなどの詳細を含む取引先のビューを提供します。
取引先責任者の詳細ページ 取引先責任者の詳細の読み取り専用ビューを提供します。
契約の詳細ページ 契約のビューと、編集ページを開き契約を有効化するためのボタンを提供します。
契約の編集ページ 契約への編集を送信するためのフォームを提供します。
私の保留中の契約有効化申請ページ パーソナライズされた保留中の契約有効化申請一覧を提供します。

取引先の作成: 新しい取引先を作成します。

通知またはページ ユースケースワークフロー
取引先の作成ページ 新しい取引先を送信するためのフォームを提供します。

ケースの作成: 新しいケースを作成します。

通知またはページ ユースケースワークフロー
ケースの作成ページ 新しいケースを送信するためのフォームを提供します。

取引先責任者の作成: 新しい取引先責任者を作成します。

通知またはページ ユースケースワークフロー
取引先責任者の作成ページ 新しい取引先責任者を送信するためのフォームを提供します。

契約の作成: 新しい契約を作成します。

通知またはページ ユースケースワークフロー
契約の作成ページ 新しい契約を送信するためのフォームを提供します。

行動の作成: 新しい行動を作成します。

通知またはページ ユースケースワークフロー
行動の作成ページ 新しい行動を送信するためのフォームを提供します。

リードの作成: 新しいリードを作成します。

通知またはページ ユースケースワークフロー
リードの作成ページ 新しいリードを送信するためのフォームを提供します。

商談の作成: 新しい商談を作成します。

通知またはページ ユースケースワークフロー
商談の作成ページ 新しい商談を送信するためのフォームを提供します。

タスクの作成: 新しいタスクを作成します。

通知またはページ ユースケースワークフロー
タスクの作成ページ 新しいタスクを送信するためのフォームを提供します。

行動: 行動を検索、表示、編集します。

通知またはページ ユースケースワークフロー
行動リマインダー通知 行動が活動日時前後に定義されたしきい値(たとえば、デフォルトでは1時間)を経過すると、所有者は通知リマインダーを受け取ります。
取引先の詳細ページ 取引先責任者や取引先責任者の詳細へのリンクなどの詳細を含む取引先のビューを提供します。
取引先責任者の詳細ページ 取引先責任者の詳細の読み取り専用ビューを提供します。
行動の編集ページ 行動への編集を送信するためのフォームを提供します。
行動の詳細ページ 行動のビューと、編集ページを開くためのボタンを提供します。
私の行動ページ パーソナライズされた行動一覧を提供します。

リード: リードを検索、表示、編集、変換します。

通知またはページ ユースケースワークフロー
リード割り当て(既存)通知 リードの所有者が変更されると、新しい所有者は通知を受け取ります。
リード割り当て(新規)通知 新しいリードがユーザーに割り当てられると、ユーザーは通知を受け取ります。
リードの変換ページ リードを変換するためのフォームを提供します。
リードの編集ページ リードへの編集を送信するためのフォームを提供します。
私のアクティブなリードページ パーソナライズされたリード一覧を提供します。

商談: 商談を検索、表示、編集します。

通知またはページ ユースケースワークフロー
商談割り当て(既存)通知 商談の所有者が変更されると、新しい所有者は通知を受け取ります。
商談割り当て(新規)通知 新しい商談がユーザーに割り当てられると、ユーザーは通知を受け取ります。
取引先の詳細ページ 取引先責任者や取引先責任者の詳細へのリンクなどの詳細を含む取引先のビューを提供します。
取引先責任者の詳細ページ 取引先責任者の詳細の読み取り専用ビューを提供します。
商談の編集ページ 商談への編集を送信するためのフォームを提供します。
私のオープン商談ページ パーソナライズされた商談一覧を提供します。
商談の詳細ページ 商談のビューと、編集ページを開くためのボタンを提供します。

保留中の取引先承認申請: 取引先を検索して承認または却下します。

通知またはページ ユースケースワークフロー
新規取引先の承認申請通知 アクターの承認のために新しい取引先が送信されると、アクターは通知を受け取ります。
取引先の承認ページ 取引先を承認または拒否するためのフォームを提供します。
私の保留中の取引先承認申請ページ パーソナライズされた、保留中の取引先承認申請と承認ページへのリンクの一覧を提供します。

保留中の取引先責任者承認申請: 取引先責任者を検索して承認または却下します。

通知またはページ ユースケースワークフロー
承認が必要な新規取引先責任者通知 アクターの承認のために新しい取引先責任者が送信されると、アクターは通知を受け取ります。
取引先責任者の承認ページ 取引先責任者を承認または拒否するためのフォームを提供します。
私の保留中の取引先責任者承認申請 パーソナライズされた、保留中の取引先責任者承認申請と承認ページへのリンクの一覧を提供します。

保留中の契約承認申請: 契約を検索して承認します。

通知またはページ ユースケースワークフロー
承認が必要な新規契約通知 アクターの承認のために新しい契約が送信されると、アクターは通知を受け取ります。
契約の承認ページ 契約を承認または拒否するためのフォームを提供します。
私の保留中の契約承認申請 パーソナライズされた、保留中の契約承認申請と承認ページへのリンクの一覧を提供します。

タスク: タスクを検索、表示、編集します。

通知またはページ ユースケースワークフロー
タスクリマインダー通知 タスクが活動日時前後に定義されたしきい値(たとえば、デフォルトでは1時間)を経過すると、所有者は通知リマインダーを受け取ります。
取引先の詳細ページ 取引先責任者や取引先責任者の詳細へのリンクなどの詳細を含む取引先のビューを提供します。
取引先責任者の詳細ページ 取引先責任者の詳細の読み取り専用ビューを提供します。
タスクの編集ページ タスクへの編集を送信するためのフォームを提供します。
自分のオープンタスクページ パーソナライズされたタスク一覧を提供します。
タスクの詳細ページ タスクのビューと、編集ページを開くためのボタンを提供します。

選択リストの値のテーブルを追加します

Salesforceのスキーマの性質上、一部のデータはテーブルのエンティティとして使用できません。Salesforceのオブジェクトの選択リストとそのオプションをすべて表示するにはpicklistvalueテーブルを使用してください。

  1. Salesforceのマイクロアプリを開いてページビルダー移動します。
  2. 選択コンポーネントを選択してフィールドへドラッグします。
  3. [プロパティの選択][データ列にマップ] をオフにします。これで、すべてのSalesforceオブジェクトを表示することができます。
  4. [データテーブル] メニューからpicklistvalueを選択します。
  5. [フィルターの編集] を選択してデータフィルターを開きます。
  6. データを取得するオブジェクトフィールドを選択します。[すべての条件の一致が必要] を選択し、保存してフィルターを閉じます。 次のスクリーンショットは、フィルターの設定例を示しています: picklistvalueフィルターの設定 次のスクリーンショットは、アクセスしようとしているデータベースのオブジェクトおよびフィールドを示しています: Salesforceのデータベース例
  7. このコンポーネントの設定を完了します。詳しくは、「ページビルダーのコンポーネント」を参照してください。