ServiceNowイベント
ServiceNow イベントについて
ServiceNowイベントを使用すると、レコードがServiceNowで更新または挿入されたタイミングに基づいて、Qualtricsでワークフローを開始できます。たとえば、ServiceNow のレコードを更新する IT チケットが終了し、元のチケットを提出した社員にフィードバック調査を送信するための Qualtrics のワークフローが開始されます。
注意:新しい ServiceNow イベントを設定するには、十分な ServiceNow 権限が設定されている必要があります。そうしないと、イベントの保存時にエラーメッセージ (sys_rest_message、sys_rest_message_headers、sys_rest_message_fn、sys_script) が表示され、イベントは登録されません。ServiceNow テーブル内での読込と書込の両方に対する権限が必要になります。
これらの権限がないか、クアルトリクスのServiceNowイベントを設定するために追加の権限が必要か不明な場合は、ServiceNow管理者に連絡してください。
ServiceNow イベントの設定
- 左上隅のナビゲーションメニューを使用して、ワークフローを選択するか、プロジェクトのワークフロータブに移動します。
- ワークフローセクションが表示されていることを確認します。
- [ワークフローを作成] をクリックします。
- [イベントの受信時に開始] を選択します。
- [ServiceNow]を選択します。
- イベントタイプを選択します。
- ServiceNow:このオプションにより、ライセンス内のServiceNowユーザーは、アクセス可能な任意のテーブルでクアルトリクスワークフローを作成できます。
注意:ServiceNow オプションは、2024 年第 1 四半期に廃止される予定です。この変更に関する追加の通知は、非推奨日付に近づきます。
- ServiceNow – マネージドアクセス:このオプションでは、承認済みのServiceNowユーザーのみがクアルトリクスワークフローで許可されたテーブルを使用できます。このアクセスは、Qualtrics 接続マネージャで管理されます。
- ServiceNow:このオプションにより、ライセンス内のServiceNowユーザーは、アクセス可能な任意のテーブルでクアルトリクスワークフローを作成できます。
- [次へ]をクリックします。
- 使用する ServiceNow アカウントを選択します。Qualtricsに接続した任意のアカウント、および拡張でブランド管理者が設定したアカウントを使用できます。
注意: ワークフローを正常に実行するには、ワークフローの作成者が ServiceNow タスクで使用される ServiceNow 認証情報にアクセスできる必要があります。
- 新しい ServiceNow アカウントに接続するには、[ユーザーアカウントの追加] をクリックします。
ヒント:新しいアカウントを追加する場合は、今後識別できるように名前を付ける必要があります。次に、接続タイプを選択して、接続の設定を終了します。OAuth を使用して接続する場合は、このサポートページを参照してください。
- [次へ] をクリックします。
- ServiceNow インスタンスを入力します。
例: たとえば、abc123.service-now.com で ServiceNow にログインする場合は、このボックスに “abc123” と入力します。 - [照合] をクリックします。
- [テーブルの選択] をクリックし、ワークフローの基準とするレコードを含むテーブルを選択します。
ヒント:手順6で[ServiceNow – マネージドアクセス]を選択した場合、ServiceNowのクアルトリクス接続マネージャーを介してアクセス権が付与されているテーブルのみを選択できます(インストールされている場合)。 - 必要に応じて、[参照フィールド]を選択して、他の ServiceNow テーブルからワークフローにデータを取り込みます。参照内にフィールドを追加するには、右側の 3 つのドットのメニューをクリックします。新しい参照を追加するには、[新規参照の追加] をクリックします。
ヒント:イベントの参照フィールドセクションに追加されたすべてのフィールドを条件として使用し、ワークフロー内のタスクで使用することができます。これは、たとえば、このデータをメールタスクの差し込みテキストで参照する場合に役立ちます。参照フィールドをフィルタとして使用することはできません。 - レコードの更新、挿入、またはその両方の場合にワークフローをトリガするかどうかを選択します。
- 必要に応じて、選択した ServiceNow テーブルのフィールドに基づいてイベントに条件を追加します。
ヒント:これらの条件は、イベントのトリガーの前に評価されます。書式設定条件ロジックの一般情報については、条件の登録を参照してください。後でワークフローに条件を追加して、タスクが起動するタイミングを特定することもできます。
- [保存]をクリックします。
- ワークフローの条件およびタスクの設定を続行します。
例:ServiceNowのレコードが更新されたときにXM Directoryタスクを使用してフォローアップアンケートを送信できます。
ServiceNow イベントの条件
ServiceNow イベントを使用してワークフローを開始する場合、以下に基づいてワークフロー条件を作成することができます。
- イベントデータ:ServiceNow から含まれるフィールドの 1 つに基づいて条件を設定します。利用可能なフィールドは、イベントの設定時に選択したテーブルによって異なります。
- ユーザ定義項目: この項目は、条件では使用されません。
ServiceNow用のクアルトリクススポークのセットアップ
クアルトリクス内でServiceNow管理者を追加作成する必要がある場合があります。Qualtricsユーザーに追加権限を付与することで、組織でのServiceNowインスタンスの実行をサポートできます。
- アカウントの[管理者]セクションに移動します。
- [ユーザー]タブを選択します。
- クリック 新しいユーザーを作成.
- ServiceNow管理者のクアルトリクスアカウントを設定します。ユーザタイプがとして設定されていることを確認します。 ブランド管理者.
- [保存]をクリックします。
- Users タブで ServiceNow ユーザを検索します。
- プロキシ ログイン を ServiceNow ユーザーのアカウントに割り当て、アカウントの設定を完了する。
- アカウントにログインしたら、 アカウント設定.
- [クアルトリクスID]を選択します。
- 以下にナビゲートします。 OAuthクライアントマネージャー タブを選択します。
- [クライアントの作成] をクリックします。
- クライアントの名前を入力します。
- scopes to manage:all を設定します。
- Grant Type が Client Credentials に設定されていることを確認します。
- クライアント作成をクリックして、クライアントを生成します。
- クライアント ID とクライアントシークレットを書き留めます。
注意: 生成されたこれらのトークンを書き留め、安全な場所に保持する必要があります。このウィンドウを閉じると、クライアントシークレットを取得できなくなります。
Qualtrics 接続マネージャ
ServiceNow管理者は、クアルトリクスワークフローを構築するためにServiceNowデータへのユーザーアクセスを管理できるクアルトリクスアプリをダウンロードできます。ユーザがアクセスできるテーブル、各テーブルで使用可能なアクション、および ServiceNow テーブルを使用するワークフローの表示を制限することができます。
アプリのダウンロード
アプリをダウンロードするには、ServiceNowアプリストアでクアルトリクス接続マネージャを検索します。アプリが見つかったら、取得をクリックしてアプリをダウンロードします。
アプリへのアクセス
アプリのダウンロード後、左上隅の[すべて]メニューを使用してクアルトリクス接続マネージャを検索します。その後、アプリのさまざまなセクションにナビゲートすることができます。
- ユーザーテーブルアクセス:ServiceNowユーザーにテーブルへのアクセス権を付与し、クアルトリクスワークフローで使用します。
- マスタービジネスルール:Qualtrics ワークフローでテーブルを使用し、権限の変更時にユーザーアクセスを自動的に取り消せるようにビジネスルールを設定します。
- クアルトリクス接続:ServiceNowテーブルを使用するさまざまなワークフローを表示します。
- サポートへのお問い合わせ:このサポートページへのリンク。Qualtricsサポートに連絡する必要がある場合は、カスタマーサクセスハブにログインしてください。
ユーザテーブルアクセス
ユーザーテーブルへのアクセスセクションでは、クアルトリクスワークフローで参照できるように、ユーザーに特定のServiceNowテーブルへのアクセス権を付与できます。ユーザにテーブルへのアクセス権を付与するには、以下の手順に従います。
- [ユーザテーブルアクセス] セクションで、[新規] をクリックします。
- アクセス権を付与するユーザーを検索します。名前または電子メールアドレスで検索することができます。
- アクセス権を付与するテーブルを選択します。
- ユーザに付与する権限を選択します。
- 挿入時にトリガー:ユーザーは、クアルトリクスでServiceNowイベントを設定する際に、レコードの挿入をトリガータイプとして選択できます。
- 更新時にトリガー:ユーザーはクアルトリクスでServiceNowイベントを設定する際に、トリガータイプとしてレコード更新を選択できます。
- [提出] をクリックします。
以下の手順に従って、ユーザのアクセスを削除できます。
- アクセスを削除するユーザーの横にあるボックスにチェックを付けます。複数のボックスを選択して、複数のユーザを選択することができます。
- 選択したレコードでアクションをクリックします。
- 削除を選択します。
- 確認ウィンドウで [削除] をクリックします。
ユーザーのテーブルアクセスを削除すると、ユーザーがこのテーブルを使用するように設定したワークフローがトリガーされなくなります。また、ワークフローはアプリの[クアルトリクス接続]セクションから削除されます。
マスタビジネスルール
クアルトリクスワークフローで使用するテーブルごとに、マスタービジネスルールを設定する必要があります。このルールは、テーブルでクアルトリクスのイベントをトリガーすることを許可します。
- マスタビジネスルールセクションで、タスク [task] テーブルで動作するクアルトリクスイベントの実行ルールをクリックします。
- ページヘッダを右クリックし、Insert and Stay を選択します。
ヒント:このオプションが表示されない場合は、ServiceNowアプリケーションを再確認して、Qualtrics接続マネージャーを使用していることを確認してください。
- クアルトリクスワークフローで使用するテーブルを選択します。
- 更新 をクリックします。
クアルトリクス接続
クアルトリクス接続セクションでは、ServiceNowデータを使用する各クアルトリクスワークフローに関する情報を表示できます。このセクションには、各ワークフローに関する以下の情報を示すテーブルが含まれています。
- 条件:条件が設定されている場合、ServiceNow イベントの条件の説明。
ヒント:このフィールドは、ServiceNowイベント自体内で設定された条件用です。ワークフローの後の条件はここに表示されません。
- 参照フィールド: 参照フィールドが選択された場合、ServiceNow イベントの参照フィールドの説明。
- REST API エンドポイント: ServiceNow イベントに使用される API エンドポイント。
- テーブル: ServiceNow イベントで使用されるテーブルの名称。
- トリガタイプ挿入: レコードの挿入時にワークフローを実行するかどうかを示します。
- トリガタイプ更新: レコードの更新時にワークフローを実行するかどうかを示します。
- ユーザー: ワークフローを所有するServiceNowユーザー。