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

  • リリースバージョン: Washingtondc
  • 更新日 2024年02月01日
  • 読む8読むのに数分
  • ソフトウェアサブスクリプションテーブルにユーザーのリストを追加するサブフローを作成します。

    始める前に

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

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

    このタスクについて

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

    手順

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

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

      表 : 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. [送信] を選択します。