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

  • リリースバージョン: Yokohama
  • 更新日 2025年01月30日
  • 所要時間：8分

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

    始める前に

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

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

    このタスクについて

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

    手順

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

      たとえば、 アプリケーション ダウンロードサブスクリプションの場合、 アプリケーションは 統合する SaaS アプリケーションの名前です。
      アプリケーション ソフトウェア資産管理 - SaaS ライセンス管理
      アクセス可能 [すべてのアプリケーションスコープ] を選択します。
      カテゴリ このフィールドは空のままにします。
      保護 なしを選択します。
      インフロー注釈 このフィールドは空のままにします。
      説明 任意の説明。
      実行方法 セッションを開始するユーザー。
    4. [Submit (送信)] を選択します。
    5. 統合プロファイル入力を追加します。
      表 : 2. 入力
      ラベル 名前 タイプ 必須
      統合プロファイル integration_profile Reference.Integration プロファイル 要
    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. ユーザーサブスクリプションアクションをアップサート
      フィールド Value (値)
      外部ユーザー ID ユーザー targetObject のユーザー ID またはアカウント ID。

      これは通常、人間が判読できない数値の値です。この値は一意である必要があります。
      ユーザープリンシパル名 ユーザー targetObject からのメールアドレス。

      メールアドレスが利用できない場合は、ユーザー名とユーザー ID などの別の値を使用します。この値は人間が判読できる必要があります。
      統合プロファイル サブフロー用に作成した統合プロファイル入力。
      前回のアクティビティ ユーザー targetObject からの最新のアクティビティの日付。たとえば、前回のログイン時刻などです。
      外部作成済み

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

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

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

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

    識別子の設定

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

    始める前に

    必要なロール：sam_admin

    手順

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

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

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

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

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

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

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