マイクロアプリ

SocialChorusの統合

SocialChorus統合を展開することで、管理職からの重要事項を伝達することや、記事、リンク、メモなどのコンテンツをさまざまなチャネルを通じて従業員間で共有することができます。ただし、画像やメディアは表示されません。

ユーザーは、お勧めのチャネルに投稿された過去7日間のコンテンツを表示できます。適切な選択をすれば、ユーザーはさまざまなチャネルに投稿されたすべての注目コンテンツを表示できます。また、過去5日間に投稿されたフォロー中のチャネルに投稿されたすべてのコンテンツを表示することもできます。コンテンツに関するすべての詳細(タイトル、概要、本文、公開日など)は、個々のページに表示されます。投稿されたコンテンツは、ボタンをクリックするだけでテストインスタンスで表示できます。

SocialChorusでプログラムマネージャーロールが割り当てられたユーザーは、チャネルをお勧めとしてマークしたり、SocialChorusのチャネル管理UIを使用して、ある記事を注目記事として設定できます。このようなコミュニケーションチャネルはたとえば、上級管理職からの伝達事項や、またはユーザーグループまたはすべてのユーザーを対象とする注目記事などが考えられます。

注:

ご意見・ご要望をお待ちしています。この統合テンプレートに関するフィードバックをお送りください。また、問題についてはサポートチームが専用フォーラムを毎日確認いたします。

SocialChorusマイクロアプリの詳細については、「SocialChorusマイクロアプリの使用」を参照してください。

必須条件の確認

Citrix Workspaceマイクロアプリに統合を追加するには、次のアーティファクトが必要です:

  • ベースURL:https://partner.socialchorus.com/
  • トークンURL:https://auth.socialchorus.com/oauth/token
  • クライアントID:クライアントIDは、承認サーバーに固有のクライアント登録情報を表す文字列です。クライアントIDとクライアントシークレットについては、SocialChorusのアカウント代表者にお問い合わせください。
  • クライアントシークレット:クライアントシークレットは、ターゲットアプリケーション統合のセットアップ時に発行される一意の文字列です。

統合ではSocialChorusインスタンスへの定期的なアクセスが必要なので、SocialChorusで専用のユーザーアカウントを作成することをお勧めします。このサービスアカウントには、完全な管理者権限とアクセス許可が必要です。

注:

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

APIの有効化

SocialChorus APIは、有料アカウントのWebサービスを介してデフォルトで有効になっています。これには、ベンダーとの別途契約が必要になる場合があります。特定のリソースに対して実行できるAPI要求の数は限られているため、SocialChorus APIガイダンスを確認することをお勧めします:SocialChorus APIガイダンス

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

SocialChorus統合をCitrix Workspaceマイクロアプリに追加して、アプリケーションに接続します。認証オプションは事前に選択されています。プロセスの完了時に、これらのオプションが選択されていることを確認してください。これにより、通知とアクションが設定済みとなっている追加設定不要のマイクロアプリを、Workspace内で使用できるようになります。

次の手順を実行します:

  1. [マイクロアプリ統合] ページで [新しい統合を追加] および [Citrix提供のテンプレートから新しい統合を追加する] を選択します。
  2. SocialChorusタイルを選択します。
  3. 統合の [統合名] を入力します。
  4. コネクタのパラメーターを入力します。

    • インスタンスの [ベースURL] https://partner.socialchorus.com/ を入力します:
    • アイコンライブラリから統合のアイコンを選択するか、デフォルトのアイコンのままにしておきます。

    SocialChorus設定1

  5. [サービス認証][認証方法] メニューから [OAuth 2.0] を選択して認証の詳細を完了します。認証オプションは事前に選択されています。プロセスの完了時に、これらのオプションが選択されていることを確認してください。OAuth 2.0セキュリティプロトコルを使用して、委任されたアクセスの要求/承認トークンを生成します。利用可能な場合は、サービス認証方法として常にOAuth 2.0を使用することをお勧めします。OAuth 2.0は、統合が、構成済みのマイクロアプリとの最大限のセキュリティコンプライアンスを満たすことを保証します。

    1. [許可の種類のフロー] メニューから [クライアント資格情報] を選択します。
    2. [許可の種類の値] には「client_credentials」を入力します。
    3. [トークン認証] メニューから [認証ヘッダー] を選択します。
    4. [トークンコンテンツの種類] メニューから [URLエンコード形式] を選択します。
    5. [トークンURL] に次のURLを入力します:https://auth.socialchorus.com/oauth/token
    6. [クライアントID] を入力します。クライアントIDは、承認サーバーに固有のクライアント登録情報を表す文字列です。OAuthサーバーを構成したときに、クライアントIDとシークレットを収集します。
    7. [クライアントシークレット] を入力します。クライアントシークレットは、ターゲットアプリケーション統合のセットアップ時に発行される一意の文字列です。

    SocialChorus設定2

  6. [アクセストークンパラメーター] を空のままにします。
  7. [要求レート制限を有効にする] トグルを有効にします。[要求数] に「1000」と入力し、[時間間隔]には[1分]を選択します。
  8. [要求タイムアウト] フィールドに「120」と入力します。
  9. (オプション)サポートのために24時間のログを保持するには、[ログ] を有効にします。
  10. [保存] を選択して続行します。

    SocialChorus設定3

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

これで、最初のデータ同期を設定して実行する準備ができました。統合アプリケーションからマイクロアプリプラットフォームに大量のデータをプルできるので、[テーブル] ページを使用して、最初のデータ同期のエンティティをフィルタリングし、同期を高速化することをお勧めします。詳しくは、「必要なエンティティの確認」を参照してください。同期ルール、スケジュールを満たさない同期、および拒否ルールの詳細については、「データの同期」を参照してください。

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

SocialChorusマイクロアプリの使用

既存のアプリケーション統合には、追加設定不要のマイクロアプリが付属しています。これらのマイクロアプリから開始して、ニーズに合わせてカスタマイズします。SocialChorus統合には、以下の設定済みで追加設定不要のマイクロアプリが2つ付属しています。これらのマイクロアプリはいずれも、過去7日間のコンテンツを取得します:

重要なコミュニケーション: 過去7日以内に投稿されたお勧めチャネルから、重要なコミュニケーションを検索して表示します。

通知またはページ ユースケースワークフロー
推奨チャネルの変更(おすすめ)通知 推奨チャネルのおすすめコンテンツのタイル、概要、本文、またはおすすめラベルに変更があった場合、すべてのサブスクライバーに通知が届きます。通知の有効期限は、作成日から7日間です。
推奨チャネルの変更(おすすめ以外)通知 推奨チャネルのおすすめ以外のコンテンツのタイル、概要、本文に変更があった場合、すべてのサブスクライバーに通知が届きます。通知の有効期限は、作成日から7日間です。
新しい推奨記事(おすすめ)通知 推奨タイプのチャネルに新しいおすすめ記事が投稿されると、すべてのサブスクライバーに通知が届きます。通知の有効期限は、作成日から7日間です。
新しい推奨記事(おすすめ以外)通知 推奨タイプのチャネルにおすすめ以外の新しい記事が投稿されると、すべてのサブスクライバーに通知が届きます。通知の有効期限は、作成日から7日間です。
コンテンツの表示ページ 過去7日以内にお勧めチャネルに投稿された全記事の一覧が表示されます。
コンテンツの詳細ページ 記事の詳細を表示するフォームと、SocialChorusで記事を開く [ブログで読む] オプションが表示されます。

最新記事: 過去7日以内に投稿された購読チャネルからコンテンツを検索して表示します。

通知またはページ ユースケースワークフロー
コンテンツの表示ページ 過去7日以内に購読チャネルに投稿された全記事の一覧が表示されます。
コンテンツの詳細ページ 記事の詳細を表示するフォームと、SocialChorusで記事を開く [ブログで読む] オプションが表示されます。

おすすめコンテンツ: このマイクロアプリを使用して、サブスクライブしているチャネルから最近お勧めの連絡事項を取得します。ユーザーは、Citrix Workspaceから検索、画像の表示、およびコンテンツの読み取りを行うことができます。

通知またはページ ユースケースワークフロー
コンテンツの表示ページ ユーザーがすべてのサブスクライブされたチャネルからコンテンツを表示できる、すべてのおすすめコンテンツを含むテーブルが表示されます。ユーザーは、作成者とチャネル名に従ってテーブルを並べ替えることができます。
コンテンツの詳細ページ タイトル、コンテンツの概要、公開日、作成者など、このページで選択したコンテンツに関連するすべての詳細を表示します。ユーザーは、[ブログで読む]を選択して、SocialChorusインスタンスのコンテンツを読むこともできます。
SocialChorusの統合