API 릴리스 정보

  • 릴리스 버전: Zurich
  • 업데이트 날짜 2025년 07월 31일
  • 소요 시간: 13분

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

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

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

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

    릴리스의 새로운 기능 Zurich

    표 1. 의 새로운 범위가 지정된 클래스 및 기존 범위가 지정된 클래스에 대한 추가 메서드 Zurich
    클래스 방법
    GlideCurrencyCode - Scoped, Global
    • getCurrencyCode()
    • getNumericCurrencyCode()
    GlideCurrencySymbol - Scoped, Global
    • getCurrencySymbol()
    • getSortedActiveCurrencySymbols()
    GlideRecord - Scoped addUserQuery()
    GlideSysAttachment - Scoped
    • addAttribute()
    • addMultipleAttributes()
    • deleteAllAttributes()
    • delete속성()
    • fetchAllAttributes()
    • fetchAttribute()
    • updateAllAttributes()
    • updateAttribute()
    GlideSystem - Scoped 양식 상단에 표시할 추가 메시지 유형에 대한 지원이 추가되었습니다.
    • addHighMessage()
    • addLowMessage()
    • addSuccessMessage()
    • addModerateMessage()
    표 2. 의 새로운 전역 클래스 및 기존 전역 클래스에 대한 추가 메서드 Zurich
    클래스 방법
    GlideRecord - Global addUserQuery()
    GlideSysAttachment - Global
    • addAttribute()
    • addMultipleAttributes()
    • deleteAllAttributes()
    • delete속성()
    • fetchAllAttributes()
    • fetchAttribute()
    • updateAllAttributes()
    • updateAttribute()
    GlideSystem - Global 양식 상단에 표시할 추가 메시지 유형에 대한 지원이 추가되었습니다.
    • addHighMessage()
    • addLowMessage()
    • addModerateMessage()
    • addSuccessMessage()
    Message - Global 메시지 [sys_ui_message] 테이블에서 현지화된 메시지를 검색합니다. 사용자의 세션 언어 또는 지정된 언어 매개변수를 기반으로 메시지를 동적으로 가져오는 국제화(i18n)를 지원합니다.
    • getMessage()
    • getMessageLang()
    표 3. 의 새 클라이언트 클래스 및 기존 클라이언트 클래스에 대한 추가 메서드 Zurich
    클래스 방법
    GlideForm (g_form) - Client
    • addChoice()
    • addHighMessage()
    • addLowMessage()
    • addModerateMessage()
    • addSuccessMessage()
    • clearChoices()
    • 비활성화선택()
    • enable선택()
    • getAnnotationByName()
    • getAnnotations()
    • getChoice()
    • getOptions()
    • hideAnnotation()
    • hideRelatedLinks()
    • hideTemplateBar()
    • remove선택()
    • setChoiceLabel()
    • setRelatedLinksDisplay()
    • showAnnotation()
    • showRelatedLinks()
    • showTemplateBar()
    • toggleAnnotations()
    GlideModal (Next Experience) - Client
    • 파괴()
    • 얻다()
    • getID()
    • getPreference()
    • getPreferences()
    • renderWithContent(객체)
    • renderWithContent(문자열)
    • 설정 대화 상자()
    • setPreference()
    • setTitle()
    • 유형()
    GlideNavigation (Next Experience) - Client 새로 고침 탐색기()
    StopWatch (Next Experience) - Client
    • 스톱워치()
    • getTime()
    • 다시 시작()
    • toString()
    GlideForm (Next Experience) - Client
    • addChoice()
    • addHighMessage()
    • addLowMessage()
    • addModerateMessage()
    • addSuccessMessage()
    • clearChoices()
    • 비활성화선택()
    • enable선택()
    • getAnnotationByName()
    • getAnnotations()
    • getChoice()
    • getOptions()
    • hideAnnotation()
    • remove선택()
    • setChoiceLabel()
    • showAnnotation()
    • toggleAnnotations()
    GlideUser (Next Experience) - Client getRoles()
    표 4. 의 새 REST API 및 기존 REST API에 대한 추가 엔드포인트 Zurich
    API 엔드포인트
    Conversation Member API
    • PUT now/conversation/member/{user_id}/drop
    • PUT now/conversation/member/{user_id}/update
    Omnichannel Callback API
    • POST /api/sn_omni_callback/callback/attempt
    • POST /api/sn_omni_callback/callback/create
    • 패치/api/sn_omni_callback/callback/update
    표 5. 의 새 REST API 및 기존 REST API에 대한 추가 엔드포인트 ServiceNow Store
    애플리케이션 앱 버전 API 엔드포인트
    네트워크 인벤토리 고급 10.0 DCIM Metric Data Feed API POST /api/sn_ni_adv/dcim/feed/{vendorname}
    견적 관리 6.0.1 Quote Management API
    • /sn_tmf_api/quote_management_api/quote/{id} 삭제
    • /sn_tmf_api/quote_management_api/견적 받기
    • GET /sn_tmf_api/quote_management_api/quote/{id}
    • 패치 /sn_tmf_api/quote_management_api/quote/{id}
    • 게시 /sn_tmf_api/quote_management_api/견적
    통신 개방형 API 4.1.1 Work Order Management API
    • 취소/sn_tmf_api/work_order_management_api/cancelWorkOrder
    • /sn_tmf_api/work_order_management_api/workordermanagement 가져오기
    • GET /sn_tmf_api/work_order_management_api/workorder/{id}
    • 패치/sn_tmf_api/work_order_management_api/workOrder/{id}
    • POST /sn_tmf_api/work_order_management_api/workOrder

    이번 릴리스에서 변경된 기능

    표 6. 에서 범위가 지정된 클래스 변경됨 Zurich
    클래스 방법
    GlideSysAttachment - Scoped 소스 첨부 파일 기록에서 속성 복사 및 첨부 파일이 있는 속성 삭제를 지원합니다.
    • 복사()
    • 복사(targetFieldName)
    • copyAttachmentsByFieldNames()
    • deleteAllAttachment()
    • delete첨부 파일()
    IdentificationEngine - Scoped referenceItems 클래스에 정의된 IRE 규칙을 사용하여 CI를 식별하기 전에 수신 페이로드의 속성을 채울 수 있도록 합니다.
    • createOrUpdateCI()
    • createOrUpdateCIEnhanced()
    • 식별CIEnhanced()
    ProducerV2 - Scoped send() - 반환 값 및 오류 처리가 추가되었습니다.
    RESTMessageV2 - Scoped, Global setHttpMethod() - 매개변수를 통한 HEAD 메서드 호출에 method 대한 지원이 추가되었습니다.
    표 7. 에서 변경된 전역 클래스 Zurich
    클래스 방법
    GlideSysAttachment - Global 소스 첨부 파일 기록에서 속성 복사 및 첨부 파일이 있는 속성 삭제를 지원합니다.
    • 복사()
    • 복사(targetFieldName)
    • copyAttachmentsByFieldNames()
    • deleteAllAttachment()
    • delete첨부 파일()
    IdentificationEngineScriptableApi - Global referenceItems 클래스에 정의된 IRE 규칙을 사용하여 CI를 식별하기 전에 수신 페이로드의 속성을 채울 수 있도록 합니다.
    • createOrUpdateCI()
    • createOrUpdateCIEnhanced()
    • 식별CIEnhanced()
    RESTMessageV2 - Scoped, Global setHttpMethod() - 매개변수를 통한 HEAD 메서드 호출에 method 대한 지원이 추가되었습니다.
    표 8. 에서 REST API 변경됨 ServiceNow Store
    애플리케이션 앱 버전 API 엔드포인트
    외상 매입금 송장 처리 v9.5.17 AP Invoice API 이제 다음 엔드포인트가 첨부 파일을 지원합니다.
    • POST sn_spend_intg/ap_invoice/json
    • sn_spend_intg/ap_invoice/xml 게시
    통신 개방형 API v4.1.1 Service Order Open API 다음 엔드포인트는 이제 매개변수를 통해 복잡한 서비스 특성 값 유형을 지원합니다.serviceOrderItem.service.serviceCharacteristic.valueType
    • GET /sn_tmf_api/order/serviceOrder
    • GET /sn_tmf_api/order/serviceOrder/{id}
    • 패치 /sn_tmf_api/order/serviceOrder/{id}
    • POST /sn_tmf_api/order/serviceOrder
    통신 개방형 API v4.1.1 Product Catalog Open API 다음 productSpecification 엔드포인트는 매개변수를 통해 productSpecCharacteristic.valueType 복잡한 제품 사양 특성 값 유형을 지원하도록 업데이트됩니다.
    • POST /sn_tmf_api/catalogmanagement/productSpecification
    • PATCH /sn_tmf_api/catalogmanagement/productSpecification/{id}
    • GET /sn_tmf_api/catalogmanagement/productSpecification/{id}
    • GET /sn_tmf_api/catalogmanagement/productSpecification
    통신 개방형 API v4.1.1 Product Inventory Open API 다음 엔드포인트는 이제 매개변수를 통해 복잡한 제품 특성 값 유형을 지원합니다.productCharacteristic.valueType
    • GET /sn_prd_invt/제품
    • GET /sn_prd_invt/product/{id}
    • /sn_prd_invt/productinventory 가져오기
    • GET /sn_prd_invt/productinventory/{inventoryId}
    • 게시/sn_prd_invt/제품
    • POST /sn_prd_invt/productinventory
    통신 개방형 API v4.1.1 Product Order Open API 다음 엔드포인트는 이제 매개변수를 통해 복잡한 제품 특성 값 유형을 지원합니다.productOrderItem.product.productCharacteristic.valueType
    • GET /sn_ind_tmt_orm/order/productOrder
    • GET /sn_ind_tmt_orm/order/productOrder/{id}
    • GET /sn_ind_tmt_orm/productorder
    • GET /sn_ind_tmt_orm/productorder/{id}
    • 패치/sn_ind_tmt_orm/order/productOrder/{id}
    • 패치 /sn_ind_tmt_orm/productOrder/{id}
    • POST /sn_ind_tmt_orm/order/productOrder
    • POST /sn_ind_tmt_orm/productOrder
    가상 에이전트 API v4.0.0 Virtual Agent Bot Integration API 요청 본문 매개변수에 대한 새 옵션과 해당 예제.action

    POST /sn_va_as_service/bot/integration

    사용 중단

    • 업데이트된 NIST 800-131A Rev 2 지침으로 인해 GlideEncrypter API는 더 이상 3DES(Triple Data Encryption Standard)를 지원하지 않습니다.
      • 릴리스로 Zurich 업그레이드되는 기존 인스턴스의 경우 GlideEncrypter API를 사용할 수 있지만 알고리즘을 자동으로 사용하도록 핵심 관리 프레임워크 업데이트되었습니다. 이 API를 계속 호출하는 방법에 대한 자세한 내용은 을 참조하세요 GlideEncrypter - Global (deprecated) .
      • 릴리스로 Zurich 시작하여 생성된 모든 새 인스턴스의 경우 GlideEncrypter API가 더 이상 지원되지 않습니다. 모든 암호화 작업에 대신 를 Key Management Framework 직접 사용합니다.
    • 동적 그룹이 핵심 플랫폼의 동적 스키마에서 제거되었습니다. 릴리스 전에 Zurich 연결된 동적 특성 그룹으로 정의된 동적 특성의 경우 원래 동적 특성 그룹을 위해 설계된 두 가지 방법이 이전 버전과의 호환성을 위해 계속 작동합니다.

      이러한 메서드는 마이그레이션된 속성 및 새로 만든 속성에 대해 null을 반환합니다.

      고객은 현재 동적 속성 정의로 마이그레이션하여 향후 향상된 기능을 활용해야 합니다. 마이그레이션에 대한 자세한 내용은 Now Support 지식베이스의 동적 스키마 Zurich 마이그레이션 가이드[KB2146133] 문서를 참조하십시오.

    활성화 정보

    기본적으로 다음 API를 사용할 수 있습니다.
    • 식별 및 조정
    • 식별 엔진
    • 식별 엔진ScriptableApi
    • GlideCurrencyCode
    • GlideCurrencySymbol
    • GlideForm(넥스트 경험)
    • GlideModal(넥스트 경험)
    • GlideNavigation(넥스트 경험)
    • GlideRecord
    • GlideSys첨부 파일
    • GlideUser(넥스트 경험)
    • 스톱워치(넥스트 경험)
    다음 API는 플러그인 활성화가 필요합니다.
    • ProducerV2 에는 ServiceNow 스트림 커넥트 설치 관리자 플러그인(com.glide.hub.stream_connect.installer)이 필요합니다.
    • 제품 주문 오픈 API를 사용하려면 sn_ind_tmt_orm(Order Management for Telecommunications) 플러그인이 필요합니다.
    • 서비스 주문 오픈 API를 사용하려면 sn_ind_tmt_orm(Order Management for Telecommunications) 플러그인이 필요합니다.