ユーザーを削除するアクションの作成
SaaS アプリケーションでユーザーアカウントを非アクティブ化または削除するアクションを作成します。
始める前に
既存の ServiceNow® 統合ハブ スポークを使用している場合は、ユーザーを作成する代わりに使用できるユーザーを削除するアクションがあるかどうかを確認します。
必要なロール:flow_designer または admin
このタスクについて
このアクションは、未使用のサブスクリプションを再利用して会社のソフトウェア経費を削減するために使用されます。
手順
- 移動先 すべて > Flow Designer > デザイナー.
- [ 新規] をクリックし、[ アクション] を選択します。
-
フォームのフィールドに入力します。
表 : 1. アクションプロパティフォーム フィールド 値 名前 任意の名前。たとえば、[ ユーザーを削除] などです。 アクセス可能 すべてのアプリケーションスコープ。 カテゴリ このフィールドは空のままにします。 保護 なし。 アプリケーション SaaS アプリケーションと統合するためのスポークアプリ。これは、既存の 統合ハブ スポークでも、作成した新しいスポークでもかまいません。 インフロー注釈 このフィールドは空のままにします。 説明 選択内容の説明。 - [送信] をクリックします。
- [Action Outline] の [Inputs] セクションで、[ Create Input] をクリックします。
-
ユーザー ID 入力を追加します。
これは、削除するユーザーのユーザー ID をアクションが取得する方法です。
表 : 2. 入力 ラベル 名前 タイプ 必須 ユーザー ID userID 文字列 はい -
使用している API が要求に対してユーザー認証を必要とする場合は、認証用の入力を追加します。
一般的なユーザー認証入力の例としては、admin ユーザー ID とサイト名があります。特定のケースでのユーザー認証の要件については、選択した API のドキュメントを参照してください。API でアクセストークンが必要な場合は、 認証情報値 変数が後で自動的に作成されるため、入力として追加する必要はありません。
サブフローで完了したアクションを使用する場合は、これらの入力として渡す値を定義します。
-
アクションアウトラインに SOAP ステップ または REST ステップ を追加します。
どちらを選択するかは、統合する SaaS アプリケーションの API によって異なります。
-
[SOAP] を選択した場合は、次のようにフォームに入力します。
表 : 3. SOAP ステップフォーム フィールド 値 接続の詳細 接続 接続エイリアスを使用。 接続エイリアス 統合プロファイルを作成したときに作成した接続エイリアス。統合プロファイルをまだ作成していない場合は、 手順に従って接続エイリアスを使用してカスタム統合プロファイルを作成します。 エンドポイント この値は、接続エイリアスを選択すると自動的に入力されます。エイリアスにリンクされた HTTP(s) 接続レコードの接続 URL に設定されます。 要求の詳細 エンベロープの作成 手動。 SOAP アクション ユーザーを削除または非アクティブ化するための API 要求。適切な要求を選択するには、選択した API のドキュメントを参照してください。 SOAP エンベロープ ユーザーを削除するための XML 要求メッセージ。XML 要求メッセージの記述方法については、選択した API のドキュメントを参照してください。一般に、ヘッダーには、ユーザー認証用の入力変数と、アクセストークンとしての 認証情報値 変数を含める必要があります。本文には、ユーザーの削除要求とユーザー ID の入力を含める必要があります。 注:SOAP エンベロープの例については、「 Webex Reclaim Subscription」サブフローで使用される「Remove User」アクションを参照してください。 -
[REST] を選択した場合は、次のようにフォームに入力します。
表 : 4. REST ステップフォーム フィールド 値 接続の詳細 接続 接続エイリアスを使用。 接続エイリアス 統合プロファイルを作成したときに作成した接続エイリアス。統合プロファイルをまだ作成していない場合は、 手順に従って接続エイリアスを使用してカスタム統合プロファイルを作成します。 ベース URL この値は、接続エイリアスを選択すると自動的に入力されます。エイリアスにリンクされた HTTP(s) 接続レコードの接続 URL に設定されます。 要求の詳細 ビルド要求 手動。 リソース パス リソースへのパス。この値はベース URL に追加されます。リソースパスの構築方法については、使用している API のドキュメントを参照してください。 HTTP メソッド 削除します。 クエリ パラメーター ユーザー ID のパラメーターを追加します。ユーザー ID 入力として値を設定します。 -
エラー処理のためにスクリプト ステップ をアクションアウトラインに追加します。
- [必須ランタイム] フィールドで [インスタンス] を選択します。
-
入力変数を作成します。
表 : 5. 入力変数 名前 値 response SOAP または REST ステップからの応答本文出力 status_code SOAP または REST ステップからのステータスコード出力 -
出力変数を作成します。
表 : 6. 出力変数 ラベル 名前 タイプ 必須 status status 選択肢 はい error_message error_message 文字列 はい -
[ スクリプト] フィールドで、ステータスおよびエラーメッセージの出力に値を割り当てるスクリプトを記述します。
- status_code入力を使用して、エラーがあるかどうかを確認します。ステータス出力 を、エラー がある場合はエラー、エラーがなければ 成功 に設定します。
- エラーが発生した場合は、 応答 入力を使用してエラーの種類に関する情報を取得します。エラーメッセージ出力をエラーの説明に設定して、ユーザーが何が問題なのかを理解できるようにします。
- [アクションアウトライン] で、[出力] をクリックします。
-
出力変数を作成します。
表 : 7. 出力変数 ラベル 名前 タイプ 必須 ステータス status 選択肢 いいえ エラーメッセージ error_message 文字列 いいえ -
出力変数に値を割り当てます。
表 : 8. 出力変数 ラベル 値 ステータス スクリプトステップからの status 出力変数 エラーメッセージ スクリプトステップからの出力変数error_message -
アクションをテストするには、「 テスト」をクリックします。
-
エラーの詳細については、テスト結果とシステムログを表示します。
システムログを表示するには、次の場所に移動します システムログ > システムログ > すべて.
- アクションにエラーが発生した場合は、正しいエンドポイントを使用していること、および API 要求が想定どおりに構成されていることを確認してください。
注:テストするときは、このアクションによってユーザーが非アクティブ化されることに注意してください。このアクションを準本番環境でテストします。本番環境のみが利用可能な場合は、テスト用に偽のユーザーを作成できます。 -
エラーの詳細については、テスト結果とシステムログを表示します。
- アクションが期待どおりに動作していることを確認したら、[ 公開] をクリックします。