SurveyMonkey- Spoke

  • Freigeben Version: Washingtondc
  • Aktualisiert 1. Februar 2024
  • 6 Minuten Lesedauer

    • Verwalten Sie Umfragen, Antworten, Sammler usw. im Konto SurveyMonkey- in Ihrer Instanz ServiceNow.

    Apps im Store anfordern

    Besuchen Sie die ServiceNow Store-Website, um alle verfügbaren Apps anzuzeigen und Informationen zum Senden von Anforderungen an den Store zu erhalten. Kumulative Informationen zum Release für alle veröffentlichten Apps finden Sie in den Release-Hinweisen zum ServiceNow Store-Versionsverlauf.

    IntegrationHub-Abonnement

    Diese Spoke erfordert ein Integration Hub-Abonnement. Weitere Informationen finden Sie unter Gesetzliche Zeitpläne − IntegrationHub − Übersicht.

    Spoke-Version

    SurveyMonkey- Spoke v2.0.5 ist die neueste Version.

    Unterstützte Versionen

    Diese Spoke wurde für die SurveyMonkey- API-Version v3 erstellt, ist jedoch möglicherweise mit späteren Versionen kompatibel.

    Spoke-Anforderungen

    Administratorzugriff auf SurveyMonkey- API Developer Portal.

    Spoke-Abhängigkeiten

    Wenn Sie Probleme beim Installieren der App haben, stellen Sie sicher, dass die folgenden abhängigen Plugins installiert sind:
    • ServiceNow Flow Designer – Dynamische Eingaben (com.glide.hub.dynamic_inputs)
    • ServiceNow IntegrationHub Action Step - REST (com.glide.hub.action_step.rest)
    • Komplexes Objekt (com.glide.cobject)
    • ServiceNow IntegrationHub Runtime (com.glide.hub.integration.runtime)
    • ServiceNow IntegrationHub-Aktionsvorlage – Datenstrom (com.glide.hub.action_type.datastream)
    Hinweis:
    Einige dieser Plugins sind lizenzierbare Funktionen und erfordern entsprechende Lizenzen, wenn sie außerhalb der Spoke-Implementierung verwendet werden.

    Spoke-Aktionen

    Die SurveyMonkey-Spoke bietet Aktionen zum Automatisieren von SurveyMonkey- -Aufgaben, wenn Events in Ihrer ServiceNow -Instanz auftreten. Folgende Aktionen sind verfügbar:

    Kategorie Aktion Beschreibung
    Collector Management Erstellen Sie einen Sammler Erstellt einen Sammler für die angegebene Umfrage. Benutzer der öffentlichen App benötigen Zugriff auf den Bereich „Sammler erstellen/ändern“.
    Löschen Sie den Sammler Löscht den angegebenen Sammler. Benutzer der öffentlichen App benötigen Zugriff auf den Bereich „Sammler erstellen/ändern“.
    Ruft Sammlerdetails ab Ruft Details des angegebenen Sammlers ab. Benutzer der öffentlichen App benötigen Zugriff auf den Bereich „View Collectors“.
    Sucht nach Sammler-Stream Ruft Details zu Sammlern in der angegebenen Umfrage ab.
    Kontaktmanagement Fügen Sie Kontakte zur Kontaktliste hinzu Erstellt mehrere Kontakte in einer Kontaktliste. Benutzer der öffentlichen App benötigen Zugriff auf den Bereich Kontakte erstellen/ändern.
    Erstellen Sie eine Kontaktliste Erstellt eine Kontaktliste. Benutzer der öffentlichen App benötigen Zugriff auf den Bereich Kontakte erstellen/ändern.
    Löschen Sie die Kontaktliste Löscht die angegebene Kontaktliste. Benutzer der öffentlichen App benötigen Zugriff auf den Bereich Kontakte erstellen/ändern.
    Sucht Kontaktlisten Ruft alle Kontaktlisten ab. Benutzer der öffentlichen App benötigen Zugriff auf den Bereich „Kontakte anzeigen“.
    Sucht Kontakte in der Kontaktliste Ruft alle Kontakte in einer Kontaktliste ab. Benutzer der öffentlichen App benötigen Zugriff auf den Bereich „Kontakte anzeigen“.
    Aktualisieren Sie die Kontaktliste Ändert eine Kontaktliste. Benutzer der öffentlichen App benötigen Zugriff auf den Bereich Kontakte erstellen/ändern.
    Ordnerverwaltung Ordner erstellen Erstellt einen Ordner.
    Ordner suchen Ruft die verfügbaren Ordner ab.
    Antwortverwaltung Sucht nach Umfrageantworten Ruft eine Liste von Antworten ab. Benutzer der öffentlichen App benötigen Zugriff auf den Bereich „Antworten anzeigen“.
    Sucht Umfragetrends Ruft die Anzahl der Antworten innerhalb des angegebenen Zeitraums ab. Benutzer der öffentlichen App benötigen Zugriff auf den Bereich „Antwortdetails anzeigen“.
    Umfrage- und Fragenverwaltung Frage erstellen Erstellt eine Frage auf der Umfrageseite. Benutzer der öffentlichen App benötigen Zugriff auf den Bereich Umfragen erstellen/ändern.
    Umfrage erstellen Erstellt eine leere Umfrage. Benutzer der öffentlichen App benötigen Zugriff auf den Bereich Umfragen erstellen/ändern.
    Frage löschen Löscht die angegebene Frage. Benutzer der öffentlichen App benötigen Zugriff auf den Bereich Umfragen erstellen/ändern.
    Umfrage löschen Löscht die angegebene Umfrage. Benutzer der öffentlichen App benötigen Zugriff auf den Bereich Umfragen erstellen/ändern.
    Ruft Umfragedetails ab Ruft eine Liste der vollständigen Antworten ab, einschließlich der Antworten auf alle Fragen. Benutzer der öffentlichen App benötigen Zugriff auf den Bereich „Antwortdetails anzeigen“.
    Suchen Sie nach Fragen Ruft alle Fragen in der angegebenen Umfrage ab.
    Sucht Umfrageseiten Ruft Details der Seite ab. Benutzer der öffentlichen App benötigen Zugriff auf den Bereich „Umfragen anzeigen“.
    Suchen Sie nach Umfragen Ruft eine Liste von Umfragen ab, die dem authentifizierten Anwender gehören oder für ihn freigegeben sind. Benutzer der öffentlichen App benötigen Zugriff auf den Bereich „Umfragen anzeigen“.
    Frage aktualisieren Aktualisiert Details der angegebenen Frage. Benutzer der öffentlichen App benötigen Zugriff auf den Bereich Umfragen erstellen/ändern
    Umfrage aktualisieren Ändert Titel, Kurznamen oder Sprache der angegebenen Umfrage. Benutzer der öffentlichen App benötigen Zugriff auf den Bereich Umfragen erstellen/ändern.
    Team-Management Sucht nach Team-Aktivitätenstrom Ruft Aktivitätsdaten für das angegebene Team ab.
    Sucht nach Teammitgliedsdetails Ruft Details des angegebenen Teammitglieds ab.
    Nach Stream „Teammitglieder“ suchen Ruft Details aller Mitglieder im angegebenen Team ab.
    Teams-Stream suchen Ruft Details aller Teams ab, zu denen der authentifizierte Benutzeraccount gehört.
    Anwenderverwaltung Anwenderdetails abrufen Ruft die Account-Details des aktuellen Anwenders einschließlich seines Plans ab. Benutzer der öffentlichen App benötigen Zugriff auf den Bereich „Benutzer anzeigen“.
    Hinweis:
    Diese Spoke verfügt nur über eine Aktion „Anwender suchen“ und Software Asset Management zugehörige Aktionen.

    Alias-Anforderungen für Verbindungen und Anmeldeinformationen

    IntegrationHub verwendet Aliasse, um Verbindungs- und Anmeldeinformationen zu verwalten. Wenn Sie ein Alias verwenden, müssen Sie nicht mehrere Anmeldeinformations- und Verbindungsinformationsprofile konfigurieren, wenn Sie mehrere Umgebungen verwenden. Wenn sich die Verbindungs- oder Anmeldeinformationen ändern, müssen Sie die Aktionen, die die Verbindung verwenden, nicht aktualisieren. Weitere Informationen finden Sie unter Connections and Credentials.

    Informationen zum Einrichten der Spoke finden Sie unter Richten Sie die Spoke SurveyMonkey ein.

    Richten Sie die Spoke SurveyMonkey ein

    Integrieren Sie die Instanz SurveyMonkeyServiceNow und das Konto [], indem Sie im API Developer Portal eine benutzerdefinierte OAuth-Anwendung erstellen, um Anforderungen von ServiceNowSurveyMonkey zu authentifizieren.

    Vorbereitungen

    Erforderliche Rolle: admin

    Prozedur

    1. Melden Sie sich bei an SurveyMonkey API Developer Portal als Administrator und fügen Sie eine App hinzu.
      1. Geben Sie im Feld OAuth-Umleitungs-URLdie Instanz-URL ServiceNow in diesem Format ein: https://<instance-name> .service-now.com/oauth_redirect.do .
      2. Kopieren Sie die Werte von Client-ID und Geheimnis, und notieren Sie sie.
      3. Geben Sie diese Bereiche für die App an:
        • Umfragen erstellen/ändern
        • Erstellen/Ändern von Sammlern
        • Erstellen/Ändern von Antworten
        • Zeigen Sie Antwortdetails an
        • Kontakte anzeigen
        • Webhooks erstellen/ändern
        • Zeigen Sie Bibliotheks-Assets an
        • Umfragen anzeigen
        • Sammler anzeigen
        • Antworten anzeigen
        • Erstellen/Ändern von Kontakten
        • Benutzer anzeigen
        • Zeigen Sie Webhook an
        Hinweis:
        Wenn Sie zusätzliche Bereiche angeben, stellen Sie sicher, dass Sie diese Bereiche auf der Registerkarte OAuth-Entitätsbereiche der Standardanwendungsregistrierung hinzufügen, die in Ihrer ServiceNow -Instanz verfügbar ist.
    2. Konfigurieren Sie die standardmäßige Anwendungsregistrierung.
      1. Navigieren zu System-OAuth > Applikationsregistrierung.
      2. Öffnen Sie den Datensatz Survey Affe.
      3. Füllen Sie im Formular die folgenden Werte aus:
        Feld Beschreibung
        Client-ID Client-ID der in erstellten App SurveyMonkey API Developer Portal.
        Geheimer Clientschlüssel Geheimer Schlüssel der in erstellten App SurveyMonkey API Developer Portal.
        Umleitungs-URL ServiceNow Instanz-URL in diesem Format: https://<instance-name> .service-now.com/oauth_redirect.do . Ersetzen<instance-name> mit Ihrem Instanznamen.
        Hinweis:
        Wenn Sie zusätzliche Bereiche angegeben haben, erstellen Sie Datensätze für diese Bereiche auf der Registerkarte OAuth-Einheitenbereiche.
    3. Erstellen Sie einen Anmeldeinformationsdatensatz.
      1. Navigieren zu Verbindungen und Anmeldeinformationen > Berechtigungen.
      2. Klicken Sie auf Neu.
        Das System zeigt die Meldung Welche Art von Anmeldeinformationen möchten Sie erstellen? an..
      3. Wählen Sie OAuth 2.0-Anmeldeinformationen aus.
      4. Füllen Sie die Felder des Formulars aus.
        Feld Wert erforderlich
        Name Name zur eindeutigen Identifizierung des Datensatzes. Geben Sie die SurveyMonkey-Anmeldeinformationen ein.
        Aktiv Option zur aktiven Verwendung des Anmeldeinformationsdatensatzes.
        OAuth-Einheitenprofil OAuth-Profil, das Sie erstellt haben, als Sie die App SurveyMonkey als OAuth-Provider registriert haben. Wählen Sie Survey Affe default_profile aus.
        Betrifft MID Server, die diese Anmeldeinformationen verwenden können Wählen Sie Alle MID Server aus.
        Reihenfolge Reihenfolge zum Anwenden dieser Anmeldeinformationen. Geben Sie 100ein.
      5. Klicken Sie mit der rechten Maustaste in den Header des Formulars und wählen Sie Speichern aus.
    4. Erstellen Sie einen Verbindungsdatensatz.
      1. Navigieren zu Verbindungen und Anmeldeinformationen > Aliasse für Verbindungen und Anmeldeinformationen.
      2. Öffnen Sie für den Datensatz für SurveyMonkey.
      3. Klicken Sie auf der Registerkarte Verbindungen auf Neu.
        Das System zeigt ein leeres HTTP(s)-Verbindungsformular an.
      4. Füllen Sie diese Werte im Formular aus.
        Feld Wert erforderlich
        Name Name zur eindeutigen Identifizierung des Verbindungsdatensatzes. Geben SieSurveyMonkey-Verbindung ein.
        Anmeldeinformation Anmeldeinformationsdatensatz, den Sie für Zoom erstellt haben. Wählen Sie SurveyMonkey-Anmeldeinformationen aus.
        Verbindungsalias Alias-Datensatz, der dieser Verbindung zugeordnet ist.
        Verbindungs-URL Basis-URL für die Verbindung mit Ihrem SurveyMonkey -Konto. Geben Sie https://api.surveymonkey.net ein.
        Aktiv Option zur aktiven Verwendung dieser Verbindung.
        Domäne Domäne, in der die Aktion oder Aktivität ausgeführt wird.
      5. Wahlweise: Geben Sie auf der Registerkarte Attribute Ihre SurveyMonkey API-Version an, wenn sie sich vom Standardwert v3 unterscheidet.
      6. Klicken Sie auf Absenden.
      Die Instanz SurveyMonkeyServiceNow und das Konto [] sind integriert.