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

  • リリースバージョン: Australia
  • 更新日 2026年03月12日
  • 所要時間：8分

    • サブフローを作成して、ユーザーのリストをソフトウェアサブスクリプションテーブルに追加します。

    始める前に

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

    必要なロール：flow_designer

    このタスクについて

    注:
    ユーザーを取得するサブフローの例については、「 Jira Download Subscriptions および Webex Download Subscriptions サブフロー」を参照してください。

    手順

    1. 移動先 すべて > フローデザイナー > デザイナー.
    2. [ New (新規)] を選択し、[ Subflow (サブフロー)] を選択します。
    3. フォームで、フィールドに入力します。
      表 : 1. サブフローのプロパティフォーム
      フィールド 値
      名前 任意の名前。

      たとえば、「 アプリケーション ダウンロードサブスクリプション」などです。ここで、「 アプリケーション 」は統合する SaaS アプリケーションの名前です。
      アプリケーション ソフトウェア資産管理 - SaaS ライセンス管理
      アクセス可能 [すべてのアプリケーションスコープ] を選択します。
      カテゴリ このフィールドは空のままにします。
      保護 [ なし] を選択します。
      インフロー注釈 このフィールドは空のままにします。
      説明 選択した内容の説明。
      実行方法 セッションを開始するユーザー。
    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 アクションを [ユーザーデータストリームを取得 (Get users data stream)] アクションの子として追加します。このアクションにより、 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 で作成したカスタム製品。
        バージョン条件 [バージョン] フィールドの条件修飾子:
        • 次の値で始まる
        • 次の値に等しい
        • は何でも

        デフォルトは [は何でも] になります。
        バージョン ソフトウェア製品のバージョン。

        バージョン条件値が [次で始まる] か [次の値に等しい (=)] の場合は必須となります。
        エディション条件 [エディション] フィールドの条件修飾子:
        • 次の値で始まる
        • 次の値に等しい
        • は何でも

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

        このシナリオでは、[ カスタム統合] を選択します。
        エンタイトルメント定義 ステップ 2 で作成したカスタムディスカバリーマップ。
        有効 識別子が使用されるかどうかを示すチェックボックス。
      3. [送信] を選択します。