Employee Survey Appの統合
Employee Survey Appを展開して、Citrix Workspaceから新しいアンケートフォームの送信と既存のアンケートフォームの管理を行います。次のワークフローは、マイクロアプリで対応します：
- アンケートの管理マイクロアプリは、Citrix Podio管理者がCitrix Workspaceで既存のアンケートアプリをメンテナンスするためのものです。
- アンケートフォームマイクロアプリは、Citrix Podioでスケジュールされたすべてのアンケートについての通知をすべてのサブスクライバーに送信し、Citrix Workspaceでユーザーフィードバックを受信します。
自分のテクノロジーソリューションをいつ展開するかに関係なく、自分のソリューションがエンドユーザーのニーズを満たしており最適なデジタルワークスペース環境を通じて生産性を向上させているかどうかが分かるように、エンドユーザーのエクスペリエンスを理解することが重要です。従業員アンケートの統合により、いつでも簡単にエンドユーザーからフィードバックを受け取ることができます。アンケートにより、ユーザーから意見を聞き、必要なサポートを提供できるようになるだけでなく、取得した情報も、情報を入手し続けそれに応じてユーザーのエクスペリエンスを管理するために役立ちます。テンプレートには、従業員とエンドユーザーのエクスペリエンスのベストプラクティスに基づく、事前に作成されたカスタマイズ可能なアンケートが含まれています。簡単にアンケートを追加して、従業員のエクスペリエンスのどの側面についてでもフィードバックを収集できます。エンドユーザーのエクスペリエンスについて詳しくは、Citrix Success Centerで『End User Experience Kit』を確認してください。
ご意見、ご要望をお聞かせください。この統合テンプレートに関するフィードバックをお送りください。また、問題についてはサポートチームが専用のフォーラムを毎日確認いたします。
マイクロアプリの包括的な説明について詳しくは、「Employee Survey Appマイクロアプリの使用」を参照してください。
必須条件の確認
このアンケートアプリとの統合をセットアップした後、Citrix Workspaceマイクロアプリにこの統合を追加するには、以下のアーティファクトが必要になります：
-
ベースURL：
https://api.podio.com - アンケート管理アプリID: 「マイアンケート」のアプリIDを入力します。「アプリIDとアプリトークンの収集」を参照してください。
-
コールバックURL：
https://{yourmicroappserverurl}.us.iws.cloud.com/admin/api/gwsc/auth/serverContext -
認証URL：
https://podio.com/oauth/authorize -
トークンURL：
https://podio.com/oauth/token - クライアントID：クライアントIDは、承認サーバー固有のクライアント登録情報を表す文字列です。
- クライアントシークレット：クライアントシークレットは、ターゲットアプリケーション統合のセットアップ時に発行される一意の文字列です。
-
アクセストークンパラメーター：以下の手順に従って、名前と値のパラメーターを入力します：
- app_id：PodioワークスペースのアプリIDを入力します。「アプリIDとアプリトークンの収集」を参照してください。
- app_token：Podioワークスペースのアプリトークンを入力します。「アプリIDとアプリトークンの収集」を参照してください。
- grant_type：app
注：
利用可能な場合は、サービス認証方法として常にOAuth 2.0を使用することをお勧めします。OAuth 2.0は、統合が、構成済みのマイクロアプリとの最大限のセキュリティコンプライアンスを満たすことを保証します。
サービスアカウントの作成
統合には、アンケートアプリのインスタンスへの定期的なアクセスが必要です。専用のユーザーアカウントを作成することをお勧めします。このアカウントには、すべての管理者権限が必要です。詳しくは、Podio APIのドキュメントを参照してください。
APIの有効化
特定のリソースに対して実行できるAPI要求の数は限られているため、次のドキュメントを参照することをお勧めします：APIの制限事項に関するドキュメント。
OAuthクライアントの構成
PodioでクライアントIDとクライアントシークレットを収集して、認証のために ［マイクロアプリ統合構成］ 画面を開きます。
- Podioワークスペースアプリケーション管理者として、Podio開発者サイトにログインします：Podio
- ［Generate Your API Key］ を選択します。
- ［Get an API key now］ を選択します。
- ［Application name］ にアプリケーション名を入力します。
-
［Full domain (without protocol) of your return URL］ にマイクロアプリのインスタンスURLを入力します。URL
{yourmicroappserverurl}のこのセクションは、テナント部分、リージョン部分、環境部分で構成されています：https://{tenantID}.{region(us/eu/ap-s)}.iws.cloud.com。 - ［Generate API Key］ を選択します。
-
［Your API keys］ で、追加したアプリケーションの ［Client ID］ および ［Client Secret］ の値をコピーして保管します。これらの値は、統合を設定するときに入力します。
詳しくは、「クライアントIDとクライアントシークレットの収集」を参照してください。
アプリIDとアプリトークンの収集
PodioからアプリIDとアプリトークンを収集し、ユーザーではなくアプリとして認証します。アプリIDアクセスにより、ユーザーは関連するPodioワークスペース内のアプリのデータにのみアクセスできます。このIDは、PodioワークスペースのPodioアプリから収集します。ワークスペースに複数のアプリがある場合は、ワークスペースに関連付けられている任意のアプリIDを使用できます。
- Podioにログインして、Podioアプリに移動します。
-
アプリ名の横にあるツールアイコンを選択します。スクリーンショットでは、例としてBroadcastアプリの手順を示しました。
-
［アプリケーション］ で ［開発者］ を選択します。
-
アプリケーションIDのフィールドとトークンのフィールドをコピーして保存します。これらの値は、統合を設定するときに、［アクセストークンパラメーター］として入力します。
このページの ［アプリケーションフィールド］ の下にも、フィールドとサンプルJSON値があります。Podioでのアプリエントリの操作について詳しくは、「アイテムの操作」を参照してください。
新しいアンケートアプリの通知を送信する方法
Employee Survey Appを使用して、複数のWebフォーム/アンケートフィードバックフォームのスケジュールを設定します。
注
識別のために必須フィールドとして、Eメールや名前などの自己識別フィールドをアンケートフォーム内に追加することをお勧めします。
次の手順に従って、Citrix Workspaceでアンケートをスケジュールします。
- Citrix Podioインスタンスにログインし、Podio App Marketにアクセスして、Citrix Workspace Employee Surveysアプリパックを入手します： Podioのアプリ市場 - Citrix Workspace Employee Surveys
- ［このパック内のアプリケーション］ の下で ［My Surveys］ を選択します。
- ［Surveyを追加］ を選択し、送信してフィードバックを取得したい ［Survey Name］ を入力します。アンケート通知を起動する日付を ［Launch Date］ で選択します。
- ［Status］ で ［Enable Survey］ を選択すると通知が生成され、［Disable Survey］ を選択すると同じものが直ちにCitrix Workspaceから無効化されます。
- ［Survey Description］ に通知本文の内容を入力します。この内容は、サブスクライバーのフィードカードに表示されます。
- アンケートフォームの ［Response App Id］ に入力します。入力する値は、管理者が通知のためにユーザーに送信するIDです。
- 選択した日付にサブスクライバーへの通知を自動的に無効にするには、［Expire After］ で日付を選択します。
- 管理者がスケジュールを設定しユーザーからフィードバックを取得する、Podioで作成したWebフォームアプリにアクセスし、［設定］ を選択し、［ウェブフォーム］ オプションを選択します。
-
［許可されているドメイン］ セクションで、アンケートアプリのWebフォームの構成にWSIワークスペースドメインを追加します。たとえば、
{yourmicroappserverurl}.cloud.comです。 - ［保存］ および ［共有 を選択します。
Citrix Workspaceマイクロアプリへの統合の追加
Podio統合をCitrix Workspaceマイクロアプリに追加して、アプリケーションに接続します。認証オプションは事前に選択されています。プロセスの完了時に、これらのオプションが選択されていることを確認してください。これにより、通知とアクションが設定済みとなっている追加設定不要のマイクロアプリを、Workspace内で使用できるようになります。
次の手順を実行します：
- ［マイクロアプリ統合］ ページで ［新しい統合を追加］ および ［Citrix提供のテンプレートから新しい統合を追加する］ を選択します。
- Podioタイルを選択します。
- 統合の統合名を入力します。
-
コネクタのパラメーターを入力します。
- インスタンスのベースURLを入力します：
https://api.podio.com - アイコンライブラリから統合のアイコンを選択するか、デフォルトのアイコンのままにしておきます。
- インスタンスのベースURLを入力します：
- アンケート管理アプリIDを入力します。「アプリIDとアプリトークンの収集」を参照してください。
-
前の手順で収集したサービス認証とコネクタのパラメーターを入力します。
-
［サービス認証］ で ［認証方法］ メニューから ［OAuth 2.0］ を選択して認証の詳細を完了します。認証オプションは事前に選択されています。プロセスの完了時に、これらのオプションが選択されていることを確認してください。OAuth 2.0セキュリティプロトコルを使用して、委任されたアクセスの要求/承認トークンを生成します。利用可能な場合は、サービス認証方法として常にOAuth 2.0を使用することをお勧めします。OAuth 2.0は、統合が、構成済みのマイクロアプリとの最大限のセキュリティコンプライアンスを満たすことを保証します。
- ［許可の種類のフロー］ メニューで ［認証コード］ を選択します。
- ［許可の種類の値］ フィールドに「authorization_code」と入力します。
-
［コールバックURL］ は事前に入力されています：
https://{yourmicroappserverurl}.us.iws.cloud.com/admin/api/gwsc/auth/serverContext。 - ［トークン認証］ メニューから ［要求の本文］ を選択します。
- ［トークンコンテンツの種類］ メニューから ［URLエンコード形式］ を選択します。
-
［認証URL］ は事前に入力されています：
https://podio.com/oauth/authorize。 -
［トークンURL］ は事前に入力されています：
https://podio.com/oauth/token。 - ［クライアントID］ を入力します。クライアントIDは、承認サーバーに固有のクライアント登録情報を表す文字列です。このIDとクライアントシークレットは、「OAuthクライアントの構成」の手順で収集してあります。
- ［クライアントシークレット］ を入力します。クライアントシークレットは、「OAuthクライアントの構成」の手順でクライアントIDとともに発行された一意の文字列です。
-
［アクセストークンパラメーター］ で次のように値を入力します：詳しくは、「アプリIDとアプリトークンの収集」を参照してください：
- app_idの横に、収集したアプリIDを入力します。
- app_tokenの横に、収集したアプリトークンを入力します。
- grant_typeについては、「app」と入力します。
- ［要求レート制限］ トグルが有効になっており、1分あたりの要求数が1000に設定されています。
- ［要求タイムアウト］ フィールドに「120」と入力します。
- ［保存］ を選択して続行します。
これで、最初のデータ同期を設定して実行する準備ができました。同期ルール、スケジュールを満たさない同期、および拒否ルールについて詳しくは、「データの同期」を参照してください。
APIのエンドポイントとテーブルエンティティについて詳しくは、「Employee Survey Appコネクタの仕様」を参照してください。
Employee Survey Appマイクロアプリの使用
既存のアプリケーション統合には、追加設定不要のマイクロアプリが付属しています。これらのマイクロアプリから開始して、ニーズに合わせてカスタマイズします。
アンケートフォーム： 新しいアンケートについての通知を提供し、ユーザーがアンケートフォームを表示および送信できるようになります。
| 通知またはページ | ユースケースワークフロー |
|---|---|
| 新規アンケートの通知 | アンケート管理アプリを介して開始された新しいすべてのフォームを、Citrix Workspaceに表示できるようになります。 |
| ［アンケートフォーム］ページ | ユーザーがCitrix Workspaceからアンケートに回答およびアンケートを送信できます。 |
アンケートの管理： アンケートアプリの管理者が、Citrix Workspaceからスケジュール済みアンケートフォームを管理できます。このマイクロアプリは、Employee Survey App管理者メンバー専用です。
注
My SurveysPodio管理アプリでは、限られた数のアンケートレコードを保持することをお勧めします。
| 通知またはページ | ユースケースワークフロー |
|---|---|
| ［マイアンケート］ページ | 管理者によって作成された、すべてのスケジュール済みアンケートフォームが一覧表示されます。 |
| ［アンケートの管理］ページ | 管理者が、ステータスの変更、開始日、期限切れになる日付など、スケジュール済みアンケートフォームを管理できます。 |