사용자를 가져오기 위한 하위 플로우 생성

  • 릴리스 버전: Xanadu
  • 업데이트 날짜 2024년 08월 01일
  • 소요 시간: 7분

    • 하위 플로우를 작성하여 소프트웨어 구독 테이블에 사용자 목록을 추가합니다.

    시작하기 전에

    이 하위 플로우에는 사용자를 가져오기 위한 데이터 스트림 작업이 필요합니다. 자세한 내용은 사용자를 가져오기 위한 데이터 스트림 작업 만들기 문서를 참조하십시오.

    필요한 역할: flow_designer 또는 admin

    이 태스크 정보

    주:
    사용자를 가져오는 하위 플로우의 예는 구독 다운로드 및 Webex 구독 다운로드 하위 플로우를 참조하십시오Jira.

    프로시저

    1. 다음으로 이동 모두 > 플로우 디자이너 > 디자이너.
    2. 새로 만들기를 클릭한 다음 하위 플로우를 선택합니다.
    3. 양식의 필드에 내용을 입력합니다.
      표 1. 하위 플로우 속성 양식
      필드 값
      이름 선택한 이름입니다. 예를 들어, 애플리케이션 다운로드 구독이 있습니다. 여기서 애플리케이션 은 통합하려는 애플리케이션의 SaaS 이름입니다.
      애플리케이션 소프트웨어 자산 관리 - SaaS 라이선스 관리
      주:
      - 애플리케이션에 하위 플로우 소프트웨어 자산 관리SaaS 라이선스 관리 를 저장하면 구독에 포함됩니다 소프트웨어 자산 관리 . 다른 애플리케이션에 하위 플로우를 저장하면 트랜잭션 비용이 ServiceNow® Integration Hub 청구될 수 있습니다. 에 사용자 지정 스포크 애플리케이션을 ServiceNow Store게시하는 경우 대신 사용자 지정 앱을 선택합니다.
      다음에서 접근 가능 모든 애플리케이션 범위입니다.
      범주 이 필드를 비워 둡니다.
      보호 없음.
      플로우 내 주석 이 필드를 비워 둡니다.
      설명 선택에 대한 설명입니다.
      다른 사용자 이름으로 실행 세션을 시작하는 사용자입니다.
    4. 제출을 클릭합니다.
    5. 통합 프로파일 입력을 추가합니다.
      표 2. 입력
      레이블 이름 유형 필수
      통합 프로파일 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. 통합에 적용할 수 있는 입력을 입력합니다.

      데이터 패널의 값을 사용하여 작업 입력을 채웁니다. 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단계에서 생성한 사용자 지정 제품입니다.
        버전 조건 버전 필드의 조건 한정자:
        • starts with
        • =
        • is anything

        기본값은 is anything입니다.
        버전 소프트웨어 제품의 버전입니다.

        버전 조건 값이 starts with 또는 is인 경우 필수입니다.
        에디션 조건 에디션 필드의 조건 한정자:
        • starts with
        • =
        • is anything

        기본값은 is anything입니다.
        에디션 정규화된 검색 모델을 검색할 때 사용되는 소프트웨어 제품 플랫폼입니다.
        플랫폼 정규화된 검색 모델을 검색할 때 사용되는 소프트웨어 제품 플랫폼입니다.
        언어 정규화된 검색 모델을 검색할 때 사용되는 소프트웨어 제품 언어이며, 수동으로 정규화 또는 추가된 후에 채워집니다.
      3. 제출을 선택합니다.
    3. 사용자 지정 구독 제품 정의 [samp_sw_custom_subscription_product_definition] 테이블에서 사용자 지정 권리 정의를 생성하여 사용자 지정 구독 제품 정의를 생성합니다.
      1. 새로 만들기를 선택합니다.
      2. 양식의 필드에 내용을 입력합니다.
        필드 설명
        식별자 사용자 지정 제품과 관련된 구독 식별자입니다.
        구독 통합 구독 제품 정의 [samp_sw_subscription_product_definition] 테이블의 구독 제품에 매핑된 SaaS 및 SSO 제공자 목록입니다.

        이 시나리오에서는 사용자 지정 통합을 선택합니다.
        권리 정의 2단계에서 생성한 사용자 지정 검색 맵입니다.
        활성 식별자가 사용되는지 여부를 나타내는 확인란입니다.
      3. 제출을 선택합니다.