API 릴리스 정보

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

    • ServiceNow® API를 사용하면 사용자 지정 애플리케이션 및 환경을 빌드할 수 있습니다. 릴리스에서 Xanadu API가 향상되고 업데이트되었습니다.

    릴리스에 Xanadu 대한 API 하이라이트

    • 스크립트에서 서버측 JavaScript API를 사용하여 애플리케이션 기능을 변경합니다.
    • 클라이언트 기반 이벤트가 발생할 때마다(예: 양식이 로드되거나 양식이 제출되거나 필드 값이 변경될 때) 클라이언트 API를 실행합니다.
    • 인바운드 REST API를 사용하여 애플리케이션 내의 다양한 ServiceNow 기능과 상호작용합니다.

    자세한 내용은 API implementation and reference 문서를 참조하십시오.

    릴리스의 새로운 기능 Xanadu

    표 1. 의 새로운 범위 지정 클래스 및 기존 범위 지정 클래스에 대한 추가 메서드 Xanadu
    클래스 방법
    CMDBQBScopedScriptableAPI - Scoped
    • createReport()를 호출합니다.
    • deleteQuery()를 호출합니다.
    • getSavedQueryExecutionDetails()
    • saveQuery()를 호출합니다.
    • updateQuery()를 호출합니다.
    HistoryWalker - Scoped, Global walkTo(체크포인트)
    NumberFormatter - Scoped, Global
    • 로케일과 함께 파스()
    • parseWithSeparators()
    PDAutomationProvider - Scoped, Global
    • activateProcess()를 호출합니다.
    • deactivateProcess()를 호출합니다.
    • duplicateProcess()를 호출합니다.
    PDFGenerationAPI - Scoped, Global 편집()
    PersonalAuthAPI - Scoped
    • PersonalAuthAPI()
    • getInitiatorURL()을 호출합니다.
    • isTokenValid()를 호출합니다.
    • revokeToken()을 호출합니다.
    PlaybookExperience - Scoped 다시 시작플레이북()
    표 2. 의 기존 전역 클래스에 대한 새 전역 클래스 및 추가 메서드 Xanadu
    클래스 방법
    CMDBQueryBuilderAPI - Global
    • createReport()를 호출합니다.
    • deleteQuery()를 호출합니다.
    • saveQuery()를 호출합니다.
    • updateQuery()를 호출합니다.
    DynamicSchemaAPI - Global
    • clearDynamicCategoryCache()를 호출합니다.
    • clearDynamicChoiceSetCache()를 호출합니다.
    • clearDynamicAttributeGroupCache()를 호출합니다.
    • clearDynamicAttributeGroupCacheItem()을 호출합니다.
    • clearDynamicCategoryCacheItem()을 호출합니다.
    • clearDynamicChoiceSetItem()을 호출합니다.
    • 겟()
    GlideAggregate - Global
    • getDynamicAttributeValue() - 두 개의 서명
    • getDynamicAttributeDisplayValue() - 두 개의 서명
    GlideDate - Global parseDate()를 호출합니다.
    GlideDynamicAttributeStore - Global
    • 지우기()
    • getDisplayValue()를 호출합니다.
    • getValue()를 호출합니다.
    • setDisplayValue()를 호출합니다.
    • setDynamicAttributeDisplayValue()
    • setDynamicAttributeValue()를 호출합니다.
    • setDynamicAttributeValues()를 호출합니다.
    • set값()
    • toString()을 호출합니다.
    GlideElementDynamicAttributeStore - Global
    • getDynamicAttribute()
    • getDynamicAttributeDisplayValue()
    • getDynamicAttributeValue()
    • setDynamicAttributeValue()를 호출합니다.
    • setDynamicAttributeValues()를 호출합니다.
    • setDynamicAttributeDisplayValue()
    • setDynamicAttributeDisplayValues()를 호출합니다.
    GlideRecord - Global
    • getDynamicAttribute() - 두 개의 서명
    • getDynamicAttributeValue() - 두 개의 서명
    • getDynamicAttributeDisplayValue() - 두 개의 서명
    • setDynamicAttributeValue() - 두 개의 서명
    • setDynamicAttributeDisplayValue() - 두 개의 서명
    • setDynamicAttributeValues()를 호출합니다.
    HistoryWalker - Scoped, Global walkTo(체크포인트)
    NumberFormatter - Scoped, Global
    • 로케일과 함께 파스()
    • parseWithSeparators()
    PDFGenerationAPI - Scoped, Global 편집()
    표 3. 새 클라이언트 모바일 API 및 의 기존 클라이언트 모바일 API에 대한 추가 메서드 Xanadu
    클래스 방법
    m_form - Client
    • addErrorMessage()를 호출합니다.
    • addInfoMessage()를 호출합니다.
    • getValue()를 호출합니다.
    • setAffectedInputs()를 호출합니다.
    • set값()
    MobileScriptIncludeCaller - Client
    • MobileScriptIncludeCaller()
    • addParam()을 호출합니다.
    • call()을 호출합니다.
    표 4. 의 새로운 REST API Xanadu
    클래스 방법
    Cloud Services Catalog API
    • GET /now/cmp_catalog_api/itemsbyciclass
    • GET /now/cmp_catalog_api/itemsbyrb
    • GET /now/cmp_catalog_api/services
    • GET /now/cmp_catalog_api/stacks
    • GET /now/cmp_catalog_api/status
    • POST /now/cmp_catalog_api/submitoprequest
    • POST /now/cmp_catalog_api/submitrequest
    Proactive Engagement API CREATE /api/sn_pren/self_remediation/experience_issue/create
    표 5. 저장소의 기존 클라이언트 클래스에 대한 새 클라이언트 클래스 및 추가 메서드New client classes and additional methods to existing client classes in the ServiceNow store
    클래스 방법
    openFrameAPI - Client getAWAAgentPresence()를 호출합니다.
    표 6. 저장소의 기존 범위 지정 클래스에 ServiceNow 대한 새로운 범위 지정 클래스 및 추가 메서드
    클래스 방법
    sb - Scoped, Global
    • 아카이브()
    • 체크 아웃()
    • 게시()
    • 폐기()
    표 7. 저장소의 기존 전역 클래스에 대한 새 전역 클래스 및 추가 메서드New global classes and additional methods to existing global classes in the ServiceNow store
    클래스 방법
    sb - Scoped, Global
    • 아카이브()
    • 체크 아웃()
    • 게시()
    • 폐기()
    표 8. 스토어의 ServiceNow 새로운 REST API
    클래스 방법
    Proactive Engagement API 생성/sn_pren/self_remediation/experience_issue/생성
    Product Catalog Open API
    • DELETE /sn_tmf_api/catalogmanagement/productOffering/{id}
    • DELETE /sn_tmf_api/catalogmanagement/productSpecification/{id}
    • PATCH /sn_tmf_api/catalogmanagement/productOffering/{id}
    • 패치 /sn_tmf_api/catalogmanagement/productSpecification/{id}
    Resource Inventory Open API 케이블, 스트랜드 및 토폴로지 테이블에 대한 지원이 추가되었습니다. 이 변경 내용은 @type, id 및 resourceRelationship.resource 속성 설명에 반영됩니다.
    • DELETE /sn_ni_core/resource/{id}
    • GET /sn_ni_core/resource
    • GET /sn_ni_core/resource/{id}
    • 패치 /sn_ni_core/resource/{id}
    • POST /sn_ni_core/resource
    • POST /sn_ni_core/resourceinventoryviatemplate
    Service Test Management Open API
    • GET /sn_sprb_mgmt/servicetestmanagement/serviceTest
    • GET /sn_sprb_mgmt/servicetestmanagement/serviceTest/{id}
    • GET /sn_sprb_mgmt/servicetestmanagement/serviceTestSpecification
    • GET /sn_sprb_mgmt/servicetestmanagement/serviceTestSpecification/{id}
    • 패치 /sn_sprb_mgmt/servicetestmanagement/serviceTest/{id}
    • PATCH /sn_sprb_mgmt/servicetestmanagement/serviceTestSpecification/{id}
    • POST /sn_sprb_mgmt/servicetestmanagement/serviceTest
    • POST /sn_sprb_mgmt/servicetestmanagement/serviceTestSpecification
    TISC API 게시 /sn_sec_tisc/threat_intel_data/add_observables

    이 릴리스에서 변경됨

    표 9. 에서 범위가 지정된 클래스가 변경됨 Xanadu
    클래스 방법
    HistoryWalker - Scoped, Global 사용할 히스토리 워커 구현 유형을 지정하기 위한 매개변수가 추가되었습니다.

    히스토리워커()
    표 10. 에서 변경된 전역 클래스 Xanadu
    클래스 방법
    GlideAggregate - Global 동적 스키마에 대한 지원이 추가되었습니다.
    • addAggregate()를 호출합니다.
    • addHaving()을 호출합니다.
    • getValue()를 호출합니다.
    • groupBy()를 호출합니다.
    • orderBy()를 호출합니다.
    • orderByAggregate()를 호출합니다.
    GlideRecord - Global 동적 스키마에 대한 지원이 추가되었습니다.
    • addQuery()를 호출합니다.
    • getDisplayValue()를 호출합니다.
    • getValue()를 호출합니다.
    • orderBy()를 호출합니다.
    • orderByDesc()를 호출합니다.
    • setDisplayValue()를 호출합니다.
    • set값()
    HistoryWalker - Scoped, Global 사용할 히스토리 워커 구현 유형을 지정하기 위한 매개변수가 추가되었습니다.

    히스토리워커()
    표 11. 에서 REST API 변경됨 Xanadu
    클래스 방법
    AWA Manual Assignment API 새 요청 본문 매개변수가 추가되었습니다.

    POST /awa/workitems/{work_item_sys_id}/assignments
    Continuous Integration/Continuous Delivery (CICD) API 테스트 도구 모음을 성능 테스트로 실행할지 또는 Cloud Runner에서 실행할지 여부를 지정하기 위한 새로운 선택적 쿼리 매개변수가 추가되었습니다.

    /sn_cicd/testsuite/run 게시
    표 12. 스토어에서 ServiceNow 변경된 범위 지정 클래스
    클래스 방법
    LeadtoCashCore - Scoped LeadtoCashCore 스크립트 포함은 재구성 사용 사례를 지원하도록 개선되었습니다.
    • createInstance() - _state 엔터티 기록이 활성 또는 비활성 상태인지 여부를 식별합니다.
    • delta() - additionalParams 이제 소스 및 dirtyJSON에서 비교할 속성을 무시하는 기능을 지원합니다.
    • effect() - additionalParams 이제 딕셔너리 필드 이름 대신 컨텍스트 변수 키를 제공하는 기능을 지원합니다. 또한 effect()는 엔터티 기록이 _state 활성 또는 비활성 상태인지 식별하는 매개 변수를 반환합니다.
    표 13. 스토어에서 변경된 ServiceNow 클라이언트 API
    클래스 방법
    openFrameAPI - Client 추가 workitem_rejected 및 workitem_accepted 응답 페이로드.

    구독()
    표 14. 스토어에서 변경된 ServiceNow REST API
    클래스 방법
    Service Order Open API
    • 모든 엔드포인트에서 네임스페이스 및 엔드포인트 경로가 sn_ind_tmt_ord에서 sn_tmf_api로 변경되었습니다.
    • 다음 메서드는 두 개의 새 매개 변수와 hreforderDate.
      • GET /sn_tmf_api/order/serviceOrder
      • POST /sn_tmf_api/order/serviceOrder/cancelserviceorder
      • 서비스 주문 오픈 API – POST /sn_tmf_api/order/serviceOrder
      • POST /sn_tmf_api/order/serviceOrder/outboundresponse
    Product Catalog Open API
    • 모든 엔드포인트에서 네임스페이스 및 엔드포인트 경로가 sn_ind_tmt_ord에서 sn_tmf_api로 변경되었습니다.
    • productOffering 메서드는 두 개의 새로운 선택적 매개 변수 href 와 다음을 lifecycleStatus반환합니다.
      • GET /sn_tmf_api/catalogmanagement/productOffering
      • GET /sn_tmf_api/catalogmanagement/productOffering/{id}
      • PATCH /sn_tmf_api/catalogmanagement/productOffering/{id}
      • POST /sn_tmf_api/catalogmanagement/productOffering
    • productSpecification 메서드는 세 개의 새로운 선택적 매개 변수 isBundle, , href및 lifecycleStatus를 반환합니다.
      • GET /sn_tmf_api/catalogmanagement/productSpecification
      • GET /sn_tmf_api/catalogmanagement/productSpecification/{id}
      • 패치 /sn_tmf_api/catalogmanagement/productSpecification/{id}
      • POST /sn_tmf_api/catalogmanagement/productSpecification
    WSD Extra Service Request API 새 요청 본문 매개 변수 reservationDateTimeChanged가 추가되었습니다.

    GET /sn_wsd_rsv/예약 가능/list_reservables/{sys_ids}
    WSD Reservable API 새 쿼리 매개 변수 reservation_start_time가 추가되었습니다.

    GET /sn_wsd_rsv/예약 가능/list_reservables/{sys_ids}
    WSD Reservable V2 API 새 쿼리 매개 변수 reservation_start_time가 추가되었습니다.

    POST /sn_wsd_rsv/v2/예약 가능/list_reservables

    활성화 정보

    기본적으로 다음과 같은 API를 사용할 수 있습니다.
    • 클라우드 서비스 카탈로그 API
    • 다이나믹스키마API
    • GlideAggregate
    • GlideDate
    • GlideDynamicAttributeStore
    • GlideElement속성 스토어
    • GlideRecord
    • 히스토리워커
    • NumberFormatter
    • openFrameAPI
    • PDAutomationProvider (영문)
    • PDFGenerationAPI
    • PlaybookExperience
    • 제품 카탈로그 오픈 API
    • 서비스 주문 오픈 API
    다음 API는 플러그인 활성화가 필요합니다.
    • AWA 수동 할당 API를 사용하려면 (com.glide.awa) 플러그인을 고급 작업 할당 활성화해야 합니다.
    • PersonalAuthAPI를 사용하려면 com.snc.sn_ihub_personal_auth(개인 인증) 플러그인을 활성화해야 합니다.
    • 사전 예방적 인게이지먼트 API를 사용하려면 사전 예방적 인게이지먼트(사전 예방적 인게이지먼트) 플러그인을 활성화해야 합니다.
    • PSBPublicAPIUtil을 사용하려면 서비스 브리지 for Providers 애플리케이션(sn_sb_pro) 및 서비스 브리지 Base(sn_sb) 플러그 인을 활성화해야 합니다.
    • 자원 인벤토리 Open API를 사용하려면 고객 네트워크 인벤토리 코어 애플리케이션(com.app-ni-core) 플러그인을 활성화해야 합니다.
    • 서비스 테스트 관리 Open API를 사용하려면 com.sn_sprb_mgmt(고객 서비스 문제 관리) 플러그인을 활성화해야 합니다.
    • WSD 추가 서비스 요청 API를 사용하려면 워크플레이스 예약 관리(com.sn_wsd_rsv) 플러그인을 활성화해야 합니다.
    • WSD 예약 가능한 API를 사용하려면 워크플레이스 예약 관리(com.sn_wsd_rsv) 플러그인을 활성화해야 합니다.
    • WSD 예약 가능 V2 API를 사용하려면 워크플레이스 예약 관리(com.sn_wsd_rsv) 플러그인을 활성화해야 합니다.