SurveyMonkey スポーク

  • リリースバージョン: Washingtondc
  • 更新日 2024年02月01日
  • 読む9読むのに数分

    • ServiceNowインスタンスからSurveyMonkeyアカウントでサーベイ、応答、コレクターなどを管理します。

    ストアでアプリを要求する

    ServiceNow Store Web サイトにアクセスして利用可能なすべてのアプリを表示し、ストアにリクエストを送信する方法について確認してください。リリースされたすべてのアプリのリリースノート情報については、「ServiceNow Storeバージョン履歴のリリースノート」を参照してください。

    統合ハブサブスクリプション

    このスポークには Integration Hub のサブスクリプションが必要です。詳細については、「法務スケジュール - IntegrationHub の概要」を参照してください。

    スポークバージョン

    SurveyMonkey スポーク v2.0.5 が最新バージョンです。

    サポートされているバージョン

    このスポークは SurveyMonkeyAPI バージョン v3 用に構築されていますが、それ以降のバージョンと互換性がある可能性があります。

    スポークの要件

    への管理者アクセス SurveyMonkey API 開発者ポータル.

    スポークの依存関係

    アプリのインストールで問題が発生した場合は、次の依存プラグインがインストールされていることを確認してください。
    • ServiceNow Flow Designer - 動的入力 (com.glide.hub.dynamic_inputs)
    • ServiceNow IntegrationHub アクションステップ - REST (com.glide.hub.action_step.rest)
    • 複合オブジェクト (com.glide.cobject)
    • ServiceNow IntegrationHub Runtime (com.glide.hub.integration.runtime)
    • ServiceNow IntegrationHub アクションテンプレート - データストリーム (com.glide.hub.action_type.datastream)
    注:
    これらのプラグインの一部はライセンス可能な機能であり、スポーク実装の外部で使用する場合は適切なライセンスが必要です。

    スポークのアクション

    SurveyMonkey Spoke では、ServiceNowインスタンスでイベントが発生したときにSurveyMonkeyタスクを自動化するアクションが提供されます。使用可能なアクションは次のとおりです。

    カテゴリ アクション 説明
    コレクター管理 コレクターを作成 指定されたサーベイのコレクターを作成します。公開アプリユーザーには、コレクターの作成/変更スコープへのアクセスが必要です。
    コレクターを削除 指定されたコレクターを削除します。公開アプリユーザーには、コレクターの作成/変更スコープへのアクセスが必要です。
    コレクターの詳細を取得 指定されたコレクターの詳細を取得します。公開アプリユーザーには、コレクターの表示スコープへのアクセスが必要です。
    コレクターストリームを検索 指定されたサーベイのコレクターの詳細を取得します。
    連絡先管理 連絡先を連絡先リストに追加 連絡先リストに複数の連絡先を作成します。公開アプリユーザーには、連絡先の作成/変更スコープへのアクセスが必要です。
    連絡先リストを作成 連絡先リストを作成します。公開アプリユーザーには、連絡先の作成/変更スコープへのアクセスが必要です。
    連絡先リストを削除 指定された連絡先リストを削除します。公開アプリユーザーには、連絡先の作成/変更スコープへのアクセスが必要です。
    連絡先リストを検索 すべての連絡先リストを取得します。公開アプリユーザーには、連絡先の表示スコープへのアクセスが必要です。
    連絡先リスト内の連絡先を検索 連絡先リスト内のすべての連絡先を取得します。公開アプリユーザーには、連絡先の表示スコープへのアクセスが必要です。
    連絡先リストを更新 連絡先リストを変更します。公開アプリユーザーには、連絡先の作成/変更スコープへのアクセスが必要です。
    フォルダー管理 フォルダーを作成 フォルダーを作成します。
    フォルダーを検索 利用可能なフォルダーを取得します。
    応答管理 サーベイ応答を検索 応答のリストを取得します。公開アプリユーザーには、応答の表示スコープへのアクセスが必要です。
    サーベイの傾向を検索 指定された期間内の回答数を取得します。公開アプリユーザーには、応答の詳細の表示スコープへのアクセスが必要です。
    サーベイおよび質問管理 質問を作成 サーベイページに質問を作成します。公開アプリユーザーには、サーベイの作成/変更スコープへのアクセスが必要です。
    サーベイを作成 空のサーベイを作成します。公開アプリユーザーには、サーベイの作成/変更スコープへのアクセスが必要です。
    質問を削除 指定された質問を削除します。公開アプリユーザーには、サーベイの作成/変更スコープへのアクセスが必要です。
    サーベイを削除 指定されたサーベイを削除します。公開アプリユーザーには、サーベイの作成/変更スコープへのアクセスが必要です。
    サーベイの詳細を取得 すべての質問に対する回答を含む、完全な応答のリストを取得します。公開アプリユーザーには、応答の詳細の表示スコープへのアクセスが必要です。
    質問を検索 指定されたサーベイのすべての質問を取得します。
    サーベイページを検索 ページの詳細を取得します。公開アプリユーザーには、サーベイの表示スコープへのアクセスが必要です。
    サーベイを検索 認証されたユーザーが所有または共有しているサーベイのリストを取得します。公開アプリユーザーには、サーベイの表示スコープへのアクセスが必要です。
    質問を更新 指定された質問の詳細を更新します。公開アプリユーザーには、サーベイの作成/変更スコープへのアクセスが必要です。
    サーベイを更新 指定されたサーベイのタイトル、ニックネーム、または言語を変更します。公開アプリユーザーには、サーベイの作成/変更スコープへのアクセスが必要です。
    チーム管理 チームアクティビティストリームを検索 指定されたチームのアクティビティデータを取得します。
    チームメンバーの詳細を検索 指定されたチームメンバーの詳細を取得します。
    チームメンバーのストリームを検索 指定されたチームのすべてのメンバーの詳細を取得します。
    チームストリームを検索 認証されたユーザーアカウントが属するすべてのチームの詳細を取得します。
    ユーザー管理 ユーザーの詳細を取得 計画を含む現在のユーザーのアカウントの詳細を取得します。公開アプリユーザーには、ユーザーの表示スコープへのアクセスが必要です。
    注:
    このスポークにあるのは、[ユーザーを検索] アクションと ソフトウェア資産管理 関連アクションのみです。

    接続および資格情報エイリアスの要件

    統合ハブ は、エイリアスを使用して、接続および資格情報を管理します。エイリアスを使用することで、複数の環境を使用する場合に、複数の資格情報と接続情報プロファイルを構成する必要がなくなります。接続または資格情報が変更された場合、接続を使用するどのアクションも更新する必要はありません。詳細については、「Connections and Credentials」を参照してください。

    スポークの設定については、「 SurveyMonkeyスポークを設定。

    SurveyMonkeyスポークを設定

    SurveyMonkey API Developer Portal でカスタム OAuth アプリケーションを作成して ServiceNow インスタンスと SurveyMonkey アカウントをデータ連携し、ServiceNow 要求を認証します。

    始める前に

    必要なロール：管理者

    手順

    1. へのログイン SurveyMonkey API 開発者ポータル 管理者としてアプリを追加します。
      1. [OAuth リダイレクト URL] に、ServiceNowインスタンス URL を次のフォーマットで指定します：https://<instance-name>.service-now.com/oauth_redirect.do
      2. [クライアント ID] と [シークレット] の値をコピーして記録します。
      3. アプリに次のスコープを指定します。
        • サーベイを作成/変更
        • コレクターを作成/変更
        • 応答を作成/変更
        • レスポンスの詳細を表示
        • 連絡先を表示
        • Webhook を作成/変更
        • ライブラリー資産を表示
        • サーベイを表示
        • コレクターを表示
        • レスポンスを表示
        • 連絡先を作成/変更
        • ユーザーを表示
        • Webhook を表示
        注:
        追加のスコープを指定する場合は、ServiceNowインスタンスで使用可能なデフォルトのアプリケーションレジストリの [OAuth エンティティスコープ] タブにこれらのスコープを追加してください。
    2. デフォルトのアプリケーションレジストリを設定します。
      1. 移動先 システム OAuth > アプリケーションレジストリー.
      2. レコード [サーベイモンキー] を開きます。
      3. フォームに、これらの値を入力します。
        フィールド 説明
        クライアント ID で作成されたアプリのクライアント ID SurveyMonkey API 開発者ポータル.
        クライアントシークレット で作成されたアプリのシークレット SurveyMonkey API 開発者ポータル.
        リダイレクト URL 次の形式でServiceNowインスタンスの URL を入力します：https://<instance-name>.service-now.com/oauth_redirect.do 「<instance-name>」をインスタンス名に置き換えます。
        注:
        追加のスコープを指定した場合は、[OAuth エンティティスコープ ] タブでスコープのレコードを作成します。
    3. 資格情報レコードを作成します。
      1. 移動先 接続 & 認証情報 > 資格情報.
      2. [新規] をクリックします。
        「作成する資格情報のタイプは？」というメッセージが表示されます。
      3. [OAuth 2.0 資格情報] を選択します。
      4. フォームのフィールドに入力します。
        フィールド 必要な値
        名前 レコードを一意に識別する名前を入力します。「SurveyMonkey 資格情報」と入力します。
        有効 資格情報レコードを積極的に使用するオプションです。
        OAuth エンティティ プロファイル SurveyMonkeyアプリを OAuth プロバイダーとして登録したときに作成した OAuth プロファイルです。[サーベイモンキー default_profile] を選択します。
        適用先 この資格情報を使用できる MID Server です。[すべての MID Server] を選択します。
        順番 この資格情報を適用する順番です。「100」と入力します。
      5. フォームヘッダーを右クリックし、 [保存] をクリックします。
    4. 接続レコードを作成します。
      1. 移動先 接続 & 認証情報 > 接続 & 資格情報エイリアス.
      2. レコード [サーベイモンキー] を開きます。
      3. [接続] タブで、[新規] をクリックします。
        空の HTTP(s) 接続フォームが表示されます。
      4. フォームに、これらの値を入力します。
        フィールド 必要な値
        名前 接続レコードを一意に識別する名前です。「SurveyMonkey 接続」と入力します。
        資格情報 Zoom 用に作成した資格情報レコードです。[SurveyMonkey 資格情報] を選択します。
        接続エイリアス 接続に関連付けられているエイリアスレコードです。
        接続 URL SurveyMonkeyアカウントに接続するためのベース URL です。「https://api.surveymonkey.net」と入力します。
        有効 接続を積極的に使用にするオプションです。
        ドメイン アクションまたはアクティビティを実行するドメインです。
      5. オプション: [属性] タブで、API バージョンがデフォルト値の v3 と異なる場合は入力しますSurveyMonkey。
      6. [送信] をクリックします。
      ServiceNowインスタンスとSurveyMonkeyアカウントがデータ連携されます。