ユーザーを取得するためのサブフローの作成

  • リリースバージョン: Xanadu
  • 更新日 2024年08月01日
  • 所要時間:9分
  • ソフトウェアサブスクリプションテーブルにユーザーのリストを追加するサブフローを作成します。

    始める前に

    このサブフローには、ユーザーを取得するためのデータストリームアクションが必要です。詳細については、「ユーザーを取得するためのデータストリームアクションの作成」を参照してください。

    必要なロール:flow_designer または admin

    このタスクについて

    注:
    ユーザーを取得するサブフローの例については、「 Jira ダウンロードサブスクリプション」および「 Webex ダウンロードサブスクリプション」サブフローを参照してください。

    手順

    1. 移動先 すべて > Flow Designer > デザイナー.
    2. [ 新規] をクリックし、[ サブフロー] を選択します。
    3. フォームのフィールドに入力します。
      表 : 1. サブフローのプロパティフォーム
      フィールド
      名前 任意の名前。たとえば、 Application Download Subscriptionsの場合、 Application は統合する SaaS アプリケーションの名前です。
      アプリケーション Software Asset Management - SaaS License Management
      注:
      サブフローを ソフトウェア資産管理 - SaaS ライセンス管理 アプリケーションに保存すると、 ソフトウェア資産管理 サブスクリプションに含まれます。サブフローを他のアプリケーションに保存すると、 ServiceNow® 統合ハブ トランザクションに対して課金される場合があります。カスタムスポークアプリケーションを ServiceNow Storeで公開する場合は、代わりにカスタムアプリを選択します。
      アクセス可能 すべてのアプリケーションスコープ。
      カテゴリ このフィールドは空のままにします。
      保護 なし
      インフロー注釈 このフィールドは空のままにします。
      説明 選択内容の説明。
      実行方法 セッションを開始するユーザー。
    4. [送信] をクリックします。
    5. 統合プロファイル入力を追加します。
      表 : 2. 入力
      ラベル 名前 タイプ 必須
      統合プロファイル integration_profile Reference.Integration Profile はい
    6. [アクション] セクションで、プラスアイコンをクリックし、[ アクション ] をクリックして新しいアクションを追加します。
    7. インストールされているスポークのリストから、統合する SaaS アプリケーションのスポークを選択します。
      注:
      インストール済みスポークのリストにスポークを追加するには、 ServiceNow Store で要求します。利用可能なスポークの完全なリストについては、「 統合ハブで利用可能なスポーク」を参照してください。統合する SaaS アプリケーションの既存のスポークがない場合は、 新しいスポークを作成できます
    8. ユーザーを取得するデータストリームアクションを選択します。
    9. データストリームアクションのユーザー認証入力に渡す値を定義します。

      データストリームアクションは、ユーザーサブスクリプションのリストに含めたくないユーザーを返す場合があります。フィルタリングを実行して一部のユーザーを除外する場合は、[ユーザーを取得] データストリームアクションの子として If フローロジックを追加します。

      必要なフィルタリングの量は、統合するアプリケーションによって異なります。たとえば、ユーザーの targetObject に active プロパティがある場合、その値が true であることを確認する条件を追加して、サブフローが非アクティブ化されたユーザーをダウンロードしないようにすることができます。Jira サブスクリプションのダウンロードサブフローで使用されるフィルタリングの例は、サブフローが実際のユーザーではないアカウントを返さないようにするために、アカウントタイプをアプリにできないことです。

      必要なフィルタリングの条件を If フローロジックに追加します。If フローロジックを使用してユーザーをフィルタリングする場合は、ソフトウェア資産管理 スポークから Upsert user subscription using subscription identifier アクションをフローロジックの子として追加します。ユーザーをフィルタリングしていない場合は、[ユーザーを取得] データストリームアクションの子として Upsert user subscription using subscription identifier アクションを追加します。

      このアクションにより、 SaaS アプリケーションユーザーサブスクリプションがソフトウェアサブスクリプションテーブル [samp_sw_subscription] に追加されます。サブスクリプションが既にテーブルにある場合は、サブスクリプションレコードが更新されます。

    10. 統合に適用可能な入力を入力します。

      データパネルの値を使用して、アクション入力を入力します。SaaS API への要求では、すべての入力のデータが返されない場合があります。

      表 : 3. [ユーザーサブスクリプションをアップサート] アクション
      フィールド
      外部ユーザー ID ユーザー targetObject からのユーザー ID またはアカウント ID。これは通常、人間が判読できない数値です。この値は一意である必要があります。
      ユーザープリンシパル名 ユーザー targetObject からのメールアドレス。メールアドレスが利用できない場合は、ユーザー名とユーザー ID などの別の値を使用します。この値は人間が判読できるようにする必要があります。
      統合プロファイル サブフロー用に作成した統合プロファイル入力。
      前回のアクティビティ ユーザー targetObject からの最新のアクティビティの日付。たとえば、前回のログイン時間などです。
      外部作成

      ユーザー targetObject からのアカウント作成日。

      この値は、より適切な再利用候補を作成するのに役立ちます。新しいユーザーにはまだアクティビティがない可能性があります。レコードにユーザーアカウントが作成されたことが示されている場合、そのユーザーは未使用のアカウントではなく新しいアカウントであるため、再利用候補は作成されません。

      識別子 統合を識別する一意の識別子。サブスクリプションのソフトウェアモデルは、サブスクリプション製品定義 [samp_sw_subscription_product_definition] テーブルの識別子と一致する識別子で自動的に作成されます。

      識別子が存在しない場合は、識別子を構成します。詳細については、「識別子の設定」を参照してください。

      追加属性 これは、上記以外のsamp_sw_subscriptionテーブルの他のフィールドを更新するために使用されます。
    11. サブフローをテストするには、[ テスト] をクリックします。
      1. エラーの詳細については、テスト結果とシステムログを表示します。
        システムログを表示するには、次の場所に移動します システムログ > システムログ > すべて.
      注:
      ユーザーを取得するデータストリームアクションは、ユーザーの複数のページを正常に取得する必要があります。データストリームアクションがすべてのユーザーを取得することを確認するまで、ソフトウェアサブスクリプションテーブル [samp_sw_subscription] に書き込まないでください。検証のために、データストリームを消費するサブフローを作成し、結果をログに記録します。
    12. サブフローが期待どおりに機能していることを確認したら、[ 公開] をクリックします。
      ヒント:
      サブフローは、公開後も編集できます。

    識別子の設定

    統合を識別するための識別子が存在しない場合は、構成します。

    始める前に

    必要なロール:sam_admin

    手順

    1. 製品がソフトウェア製品 [samp_sw_product] テーブルに存在しない場合は、カスタム製品を作成します。
      1. [新規] を選択します。
      2. フォームのフィールドに入力します。
        フィールド 説明
        パブリッシャー カスタム製品の公開者。
        製品 カスタム製品の名前。
        製品タイプ カスタム ソフトウェア製品の製品タイプ。
        製品分類 正式な UNSPSC 分類
        サブスクリプションソフトウェア 製品がサブスクリプションベースの製品であることを示すオプション。
        インストールを無視 製品タイプがライセンス可能であることを示すオプション。

        このチェックボックスは、[製品タイプ] を [ライセンス可能] として選択し、[サブスクリプションソフトウェア] が true に設定されている場合にのみ表示されます。

        コンテンツサービスから除外 製品がコンテンツサービスから除外されることを示すオプション。

        このチェック ボックスをオンにしないでください。

        アクティブ この製品が使用されているかどうかを示すオプション。
      3. [送信] を選択します。
    2. ディスカバリーマップ [samp_custom_sw_entitlement_definition] テーブルからカスタムエンタイトルメント定義を作成して、カスタムディスカバリーマップを作成します。
      1. [新規] を選択します。
      2. フォームのフィールドに入力します。
        フィールド 説明
        製品 現在のソフトウェア製品名。ステップ 1 で作成したカスタム製品。
        バージョン条件 バージョンフィールドの条件修飾子:
        • 次で始まる
        • 次の値に等しい (=)
        • は何でも

        デフォルトは [は何でも] になります。

        バージョン ソフトウェア製品のバージョン。

        バージョン条件値が [次で始まる] か [次の値に等しい (=)] の場合は必須となります。

        エディション条件 エディションフィールドの条件修飾子:
        • 次で始まる
        • 次の値に等しい (=)
        • は何でも

        デフォルトは [は何でも] になります。

        エディション 標準化された Discovery モデルを検索するときに使用するソフトウェア製品のプラットフォーム。
        プラットフォーム 標準化された Discovery モデルを検索するときに使用するソフトウェア製品のプラットフォーム。
        言語 標準化された Discovery モデルを検索するときに使用するソフトウェア製品の言語。標準化または手動で追加された後に入力されます。
      3. [送信] を選択します。
    3. カスタムサブスクリプション製品定義 [samp_sw_custom_subscription_product_definition] テーブルからカスタムエンタイトルメント定義を作成して、カスタムサブスクリプション製品定義を作成します。
      1. [新規] を選択します。
      2. フォームのフィールドに入力します。
        フィールド 説明
        識別子 カスタム製品に関連付けられているサブスクリプション識別子。
        サブスクリプション統合 サブスクリプション製品定義 [samp_sw_subscription_product_definition] テーブルのサブスクリプション製品にマッピングされている SaaS および SSO プロバイダーのリスト。

        このシナリオでは、 [カスタム統合] を選択します。

        エンタイトルメント定義 ステップ 2 で作成したカスタムディスカバリーマップ。
        アクティブ 識別子が使用されているかどうかを示すチェックボックス。
      3. [送信] を選択します。