Integration der Employee Survey App

Mit der Employee Survey App können Sie ein neues Umfrageformular senden und vorhandene Umfrageformulare direkt in Citrix Workspace verwalten. Die Mikroapps beziehen sich auf folgende Workflows:   

• Mit der Mikroapp Umfrage verwalten können Citrix Podio-Administratoren die vorhandenen Umfrage-Apps in Citrix Workspace verwalten.
• Die Mikroapp Umfrageformular sendet Benachrichtigungen für alle in Citrix Podio geplanten Umfragen an alle Abonnenten und nimmt Feedback von Benutzern in Citrix Workspace entgegen.

Unabhängig davon, wann Sie Ihre Technologielösung einführen, müssen Sie wissen, ob Ihre Lösung die Anforderungen der Benutzer erfüllt und ihre Produktivität durch eine optimierte digitale Workspace-Benutzeroberfläche steigert. Die Integration von Mitarbeiterumfragen ermöglicht es Ihnen, jederzeit Feedback von Endbenutzern zu erhalten. Die Umfrage bietet Ihnen nicht nur die Möglichkeit, erreichbar zu sein und Benutzer bei Bedarf zu unterstützen, sondern Sie erhalten auch nützliche Daten und können damit das Benutzererlebnis weiter anpassen. Die Vorlage enthält vorgefertigte, konfigurierbare Umfragen, die auf Best Practices zur Mitarbeiter- und Endbenutzererfahrung basieren. Sie können leicht weitere Umfragen hinzufügen, um Feedback zu jedem Aspekt der Mitarbeitererfahrung zu erhalten. Weitere Informationen zur Endbenutzererfahrung bietet das End User Experience Kit im Citrix Success Center.

Senden Sie uns Ihr Feedback! Bitte geben Sie Feedback zu dieser Integrationsvorlage. Unser Team überprüft unser zugehöriges Forum täglich auf gemeldete Probleme.

Ausführliche Informationen zu den Mikroapps finden Sie unter Verwenden von Employee Survey App-Mikroapps.

Prüfung der Voraussetzungen

Nach dem Einrichten dieser Integration mit der Umfrage-App benötigen Sie diese Artefakte, um die Integration in Citrix Workspace-Mikroapps hinzuzufügen:

• Basis-URL: https://api.podio.com
• Umfrage-Admin-App-ID: Geben Sie die App-ID “Meine Umfragen” ein. Siehe Erfassen von App-ID und App-Token.
• Rückruf-URL: https://{yourmicroappserverurl}.us.iws.cloud.com/admin/api/gwsc/auth/serverContext
• Autorisierungs-URL: https://podio.com/oauth/authorize
• Token-URL: https://podio.com/oauth/token
• Client-ID: Die Client-ID ist die Zeichenfolge, die die eindeutigen Angaben des Autorisierungsservers zur Clientregistrierung darstellt.
• Geheimer Clientschlüssel: Der geheime Clientschlüssel ist eine eindeutige Zeichenfolge, die beim Einrichten der Zielanwendungsintegration ausgegeben wird.
• Zugriffstokenparameter: Geben Sie die Parameter für Name und Wert gemäß den folgenden Anweisungen ein:
  • app_id: Geben Sie die App-ID der Podio-Workspace-App ein. Siehe Erfassen von App-ID und App-Token.
  • app_token: Geben Sie den App-Token der Podio-Workspace-App ein. Siehe Erfassen von App-ID und App-Token.
  • grant_type: App

Hinweis:

Sofern verfügbar, sollten Sie stets OAuth 2.0 zur Dienstauthentifizierung verwenden. OAuth 2.0 stellt sicher, dass Ihre Integration höchste Sicherheitsansprüche mit Ihrer konfigurierten Mikroapp erfüllt.

Erstellen eines Dienstkontos

Für die Integration ist ein regulärer Zugriff auf Ihre Umfragen-App-Instanz erforderlich. Wir empfehlen, ein dediziertes Benutzerkonto zu erstellen. Dieses Konto muss über vollständige Administratorrechte verfügen. Weitere Informationen finden Sie in der Podio-API-Dokumentation.

Aktivieren von APIs

Die Anzahl an API-Anforderungen, die an bestimmte Ressourcen gestellt werden können, ist begrenzt. Wir empfehlen Folgendes: Dokumentation zur API-Beschränkung.

Konfigurieren des OAuth-Clients

Erfassen Sie die Client-ID und den geheimen Clientschlüssel in Podio, um sie im Konfigurationsbildschirm der Mikroappintegration für die Authentifizierung einzugeben.

1. Melden Sie sich mit Administratorrechten für die Podio-Workspace-App an der Podio Developer-Site an: Podio.
2. Wählen Sie Generate Your API Key.
3. Wählen Sie Get an API key now.
4. Geben Sie einen Namen für Application name ein.
5. Geben Sie die URL Ihrer Mikroappsinstanz für Full domain (without protocol) of your return URL ein. Dieser Abschnitt der URL {yourmicroappserverurl} setzt sich zusammen aus dem Mandanten, der Region und der Umgebung: https://{tenantID}.{region(us/eu/ap-s)}.iws.cloud.com.
6. Wählen Sie Generate API Key.

7. Kopieren und speichern Sie unter Your API keys die Werte für Client ID und Client Secret für die soeben hinzugefügte Anwendung. Diese Werte geben Sie beim Einrichten der Integration ein.

   

Weitere Informationen finden Sie unter Erfassen von Client-ID und geheimem Clientschlüssel.

Erfassen von App-ID und App-Token

Erfassen Sie die App-ID und den App-Token aus Podio, um sich als App und nicht als Benutzer zu authentifizieren. Bei Zugriff per App-ID können Benutzer nur auf Daten von Apps im zugehörigen Podio-Workspace zugreifen. Sie erfassen diese ID aus der Podio-App für den Podio-Workspace. Wenn Sie mehrere Apps in einem Workspace haben, können Sie jede der mit dem Workspace verbundenen App-IDs verwenden.

1. Melden Sie sich bei Podio an und navigieren Sie zu Ihrer Podio-App.

2. Wählen Sie das Werkzeugsymbol neben dem App-Namen. In den Screenshots sind die Schritte für die Broadcast-App beispielhaft dargestellt.

   

3. Wählen Sie unter APP die Option Developer.

   

4. Kopieren und speichern Sie die Felder App ID und Token. Diese Werte geben Sie beim Einrichten der Integration als Zugriffstokenparameter ein.

   

Unter App fields können Sie auch die Felder und JSON-Beispielwerte auf dieser Seite anzeigen. Weitere Informationen zum Arbeiten mit App-Einträgen in Podio finden Sie unter Working with items.

Senden von App-Benachrichtigungen bei neuer Umfrage

Mit der Employee Survey App können Sie mehrere Web- oder Umfrageformulare für Feedback planen.

Hinweis

Wir empfehlen, alle Felder zur Selbstidentifizierung, wie E-Mail oder Name, als erforderliche Felder im Umfrageformular hinzuzufügen.

Führen Sie die folgenden Schritte aus, um eine Umfrage in Citrix Workspace zu planen.

1. Melden Sie sich bei Ihrer Citrix Podio-Instanz an, gehen Sie zum Podio App Market und laden Sie das App-Pack “Citrix Workspace Employee Surveys” herunter: Podio App Market - Citrix Workspace Employee Surveys
2. Wählen Sie unter Apps in this pack die App My Surveys.
3. Wählen Sie Add Survey und geben Sie unter Survey Name einen Umfragenamen ein, den Sie zum Senden und Empfangen von Feedback verwenden möchten. Wählen Sie unter Launch Date ein Datum für das Auslösen der Umfragebenachrichtigung.
4. Wählen Sie für Enable_Survey die Option Status, um eine Benachrichtigung zu generieren, und wählen Sie Disable_Survey, um diese sofort in Citrix Workspace zu deaktivieren.
5. Geben Sie unter Survey Description den Benachrichtigungstext ein. Dieser wird Abonnenten dann auf der Feedkarte angezeigt.
6. Geben Sie die Response App Id für das Umfrageformular ein. Dies ist die ID, die der Administrator an Benutzer zur Benachrichtigung senden möchte.
7. Wählen Sie unter Expire After das Datum, ab dem Benachrichtigungen an Abonnenten automatisch zu deaktivieren sind.
8. Navigieren Sie zu von Podio erstellten Webformular-Apps, für die der Administrator einen Zeitplan erstellen und Benutzerfeedback erhalten möchte. Wählen Sie Settings und dann die Option Webforms.
9. Fügen Sie im Abschnitt Allowed Domain die WSI-Workspace-Domäne in der Webformular-Konfiguration der Umfrage-Apps hinzu. Beispiel: {yourmicroappserverurl}.cloud.com.
10. Wählen Sie Save und Share.

Hinzufügen der Integration zu Citrix Workspace-Mikroapps

Fügen Sie die Podio-Integration zu Citrix Workspace-Mikroapps hinzu, um eine Verbindung zu Ihrer Anwendung herzustellen. Die Authentifizierungsoptionen sind vorausgewählt. Stellen Sie sicher, dass diese Optionen ausgewählt sind, wenn Sie den Vorgang abschließen. Dadurch werden vorkonfigurierte Mikroapps mit Benachrichtigungen und Aktionen bereitgestellt, die in Ihrem Workspace sofort einsatzbereit sind.

Führen Sie folgende Schritte aus:

1. Wählen Sie auf der Seite Mikroappintegrationen die Optionen Neue Integration hinzufügen und Neue Integration aus Citrix-Vorlagen hinzufügen.
2. Wählen Sie die Podio-Kachel.
3. Geben Sie einen Integrationsnamen ein.
4. Geben Sie Connectorparameter ein.
   • Geben Sie die Basis-URL der Instanz ein: https://api.podio.com.
   • Wählen Sie ein Symbol für die Integration aus der Symbolbibliothek aus, oder belassen Sie das Standardsymbol.
5. Geben Sie die Umfrage-Admin-App-ID ein. Siehe Erfassen von App-ID und App-Token.

6. Geben Sie die Daten für Serverauthentifizierung und Connectorparameter ein, die Sie in den vorherigen Verfahren erfasst haben.

7. Wählen Sie unter Dienstauthentifizierung im Menü Authentifizierungsmethode die Option OAuth 2.0 und geben Sie die Authentifizierungsdetails ein. Die Authentifizierungsoptionen sind vorausgewählt. Stellen Sie sicher, dass diese Optionen ausgewählt sind, wenn Sie den Vorgang abschließen. Generieren Sie über das Sicherheitsprotokoll OAuth 2.0 einen Anforderungs-/Autorisierungstoken zum delegierten Zugriff. Sofern verfügbar, sollten Sie stets OAuth 2.0 zur Dienstauthentifizierung verwenden. OAuth 2.0 stellt sicher, dass Ihre Integration höchste Sicherheitsansprüche mit Ihrer konfigurierten Mikroapp erfüllt.

   1. Wählen Sie im Menü Gewährungstyp - Prozess die Option Autorisierungscode.
   2. Geben Sie im Feld Gewährungstyp - Wert den Wert authorization_code ein.
   3. Die Rückruf-URL ist vorausgefüllt: https://{yourmicroappserverurl}.us.iws.cloud.com/admin/api/gwsc/auth/serverContext.
   4. Wählen Sie im Menü Tokenautorisierung die Option Anforderungstext.
   5. Wählen Sie im Menü Tokeninhaltstyp die Option URL-codiertes Formular.
   6. Die Autorisierungs-URL ist vorausgefüllt: https://podio.com/oauth/authorize.
   7. Die Token-URL ist vorausgefüllt: https://podio.com/oauth/token.
   8. Geben Sie Ihre Client-ID ein. Die Client-ID ist die Zeichenfolge, die die eindeutigen Angaben des Autorisierungsservers zur Clientregistrierung darstellt. Sie haben diese ID und den geheimen Clientschlüssel im Verfahren Konfigurieren des OAuth-Clients gesammelt.
   9. Geben Sie Ihren geheimen Clientschlüssel ein. Der geheime Clientschlüssel ist eine eindeutige Zeichenfolge, die mit der Client-ID im Verfahren Konfigurieren des OAuth-Clients ausgegeben wird.
8. Geben Sie Werte für Zugriffstokenparameter ein. Weitere Informationen finden Sie unter Erfassen von App-ID und App-Token:
   • Geben Sie die App-ID ein, die Sie neben app_id erfasst haben.
   • Geben Sie den App-Token ein, den Sie neben app_tokenerfasst haben.
   • Geben Sie für grant_type den Wert App ein.
9. Der Umschaltfläche Anforderungsratenlimit ist aktiviert und auf 1000 Anforderungen pro Minute festgelegt.
10. Geben Sie im Feld Anforderungstimeout den Wert 120 ein.
11. Wählen Sie dann Speichern.

Sie können nun die erste Datensynchronisierung festlegen und ausführen. Vollständige Informationen zu Synchronisierungsregeln, zeitlich fehlgeschlagenen Synchronisierungen und zu Vetoregeln finden Sie unter Synchronisieren von Daten.

Weitere Informationen zu API-Endpunkten und Tabellenentitäten finden Sie unter Employee Survey App-Connectorspezifikationen.

Verwenden von Employee Survey App-Mikroapps

Vorhandene Anwendungsintegrationen werden mit vorkonfigurierten Mikroapps geliefert. Beginnen Sie mit diesen Mikroapps und passen Sie sie an Ihre Erfordernisse an.

Umfrageformular: Bietet Benachrichtigungen für neue Umfragen und ermöglicht Benutzern das Anzeigen und Einreichen der Umfrageformulare.

Umfrage verwalten: Ermöglicht dem Umfrage-App-Administrator, die geplanten Umfrageformulare in Citrix Workspace zu verwalten. Diese Mikroapp ist nur für Administratoren der Employee Survey App gedacht.

Hinweis

Wir empfehlen, eine begrenzte Anzahl von Umfrage-Datensätzen in der Podio-Admin-App Meine Umfragen zu speichern.