API 릴리스 정보

  • 릴리스 버전: Yokohama
  • 업데이트 날짜 2025년 01월 30일
  • 소요 시간: 13분
  • ServiceNow® API를 사용하면 사용자 지정 애플리케이션 및 환경을 빌드할 수 있습니다. API는 Yokohama 릴리스에서 강화 및 업데이트되었습니다.

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

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

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

    릴리스의 새로운 기능 Yokohama

    표 1. 의 새로운 범위가 지정된 클래스 및 기존 범위가 지정된 클래스에 대한 추가 메서드 Yokohama
    클래스 방법
    Console - Scoped, Global
    • 오류()
    • 그룹()
    • groupCollapsedString()
    • 그룹 끝()
    • 정보()
    • 로그()
    • 테이블()
    • 시각()
    • timeEnd()
    • timeLog()
    • 추적()
    • 경고()
    Fetch - Scoped, Global 가져 오기 ()
    Fetch Headers - Scoped, Global
    • 헤더()
    • append()
    • 삭제()
    • 항목()
    • forEach()
    • 얻다()
    • getSetCookie()
    • has()
    • 키()
    • 세트()
    • 값()
    Fetch Request - Scoped, Global
    • 요청()
    • arrayBuffer()
    • 블롭()
    • 바이트()
    • 클론()
    • formData()
    • json()
    • 텍스트()
    Fetch RequestInit - Scoped, Global 요청초기화()
    Fetch Response - Scoped,Global
    • arrayBuffer()
    • 블롭()
    • 바이트()
    • formData()
    • json()
    • 텍스트()
    GlideUser - Scoped
    • getTimeZoneLabel()
    • getTimeZoneLabelLang()
    OrderUtil - Scoped
    • getStateFromOrder()
    • isOrderInDraftState()
    PDFGenerationAPI - Scoped, Global
    • convertToPDFAsync()
    • convertToPDFWithHeaderFooterAsync()
    ProcessMiningIntegrationAPI - Scoped
    • createProject()
    • deleteProject()
    • getBreakDownStats()
    • getFindings()
    • getMiningStatus()
    • getProject()
    • 스케쥴마이닝()
    RESTMessageV2 - Scoped, Global setAllowedRedirectURIs()
    SOAPMessageV2 - Scoped, Global
    • setAllowedRedirectURIs()
    • setFollowRedirect()
    UriMatcher - Scoped
    • UriMatcher()
    • 일치()
    UriMatcherResponse - Scoped
    • getErrorMessages()
    • isError()
    • isFragmentMatches()
    • isHostMatches()
    • isMatch()
    • isPathMatches()
    • isSchemeMatches()
    v_record - Scoped, Global setLastErrorMessage()
    표 2. 의 새로운 전역 클래스 및 기존 전역 클래스에 대한 추가 메서드 Yokohama
    클래스 방법
    Console - Scoped, Global
    • 오류()
    • 그룹()
    • groupCollapsedString()
    • 그룹 끝()
    • 정보()
    • 로그()
    • 테이블()
    • 시각()
    • timeEnd()
    • timeLog()
    • 추적()
    • 경고()
    Fetch - Scoped, Global 가져 오기 ()
    Fetch Headers - Scoped, Global
    • 헤더()
    • append()
    • 삭제()
    • 항목()
    • forEach()
    • 얻다()
    • getSetCookie()
    • has()
    • 키()
    • 세트()
    • 값()
    Fetch Request - Scoped, Global
    • 요청()
    • arrayBuffer()
    • 블롭()
    • 바이트()
    • 클론()
    • formData()
    • json()
    • 텍스트()
    Fetch RequestInit - Scoped, Global 요청초기화()
    Fetch Response - Scoped,Global
    • arrayBuffer()
    • 블롭()
    • 바이트()
    • formData()
    • json()
    • 텍스트()
    GlideDynamicAttribute - Global
    • getSysId()
    • getName()
    • getType()
    • getGroupName()
    • getPath()
    • isTransient()
    GlideDynamicAttributeStore - Global getDynamicAttributes()
    GlideElementDynamicAttributeStore - Global
    • getDynamicAttributesInSchema()
    • getDynamicAttributesInStore()
    GlideTransientDynamicAttribute - Global
    • getSysId()
    • getName()
    • getType()
    • getGroupName()
    • getPath()
    • isTransient()
    GlideUser - Global
    • getTimeZoneLabel()
    • getTimeZoneLabelLang()
    PDFGenerationAPI - Scoped, Global
    • convertToPDFAsync()
    • convertToPDFWithHeaderFooterAsync()
    • getCurrencyCode()
    • getNumericCurrencyCode()
    RESTMessageV2 - Scoped, Global setAllowedRedirectURIs()
    SOAPMessageV2 - Scoped, Global
    • setAllowedRedirectURIs()
    • setFollowRedirect()
    표 3. 의 새 REST API 및 기존 REST API에 대한 추가 엔드포인트 Yokohama
    API 엔드포인트
    AWA Offer Work API POST /now/awa/documents/{document_table}/{document_sys_id}/offer
    Continuous Integration and Continuous Delivery (CICD) Update Set API
    • 게시/sn_cicd/update_set/검색
    • POST /sn_cicd/update_set/commitMultiple
    • POST /sn_cicd/update_set/preview/{remote_update_set_id}
    • POST /sn_cicd/update_set/back_out
    • POST /sn_cicd/update_set/commit/{remote_update_set_id}
    • 게시/sn_cicd/update_set/작성
    표 4. 새로운 범위가 지정된 클래스 및 기존 범위가 지정된 클래스에 대한 추가 메서드 ServiceNow Store
    애플리케이션 앱 버전 클래스 방법
    리드 관리 v3.0 LeadAPIHelperOOB - Scoped
    • getJSONFromGR()
    • getLeadsJSON()
    • getTransformedLead()
    리드 관리 v3.0 LeadAPIProcessUtilOOB - Scoped
    • processCreateLead()를 호출합니다.
    • processGetAllLeads()
    • processGrtLeadById()
    • processUpdateLead()를 호출합니다.
    리드 관리 v3.0 LeadAPIValidationUtilOOB - Scoped
    • validateLeadObjectForPatchCall()
    • validateLeadObjectForPostCall()
    주문 관리 v6.0 OrderGuide - Scoped isOrderInDraftState()
    표 5. 새 클라이언트 클래스 및 기존 클라이언트 클래스에 대한 추가 메서드 ServiceNow Store
    애플리케이션 앱 버전 클래스 방법
    고객 서비스 관리 v1.2 openFrameAPI - Client setICContext()
    표 6. 의 새 REST API 및 기존 REST API에 대한 추가 엔드포인트 ServiceNow Store
    애플리케이션 앱 버전 API 엔드포인트
    외상 매입금 운영 v8.0 AP Invoice API
    • POST /sn_spend_intg/ap_invoice/xml
    확장된 제품 모델 및 자산 클래스 v1.0 AI Assets API
    • GET /sn_ent/asset/ai_dataset/{sys_id}
    • GET /sn_ent/asset/ai_model/{sys_id}
    • GET /sn_ent/asset/ai_prompt/{sys_id}
    • GET /sn_ent/asset/ai_system/{sys_id}
    • POST /sn_ent/asset/ai_dataset
    • POST sn_ent/자산/ai_model
    • POST /sn_ent/asset/ai_prompt
    • POST /sn_ent/asset/ai_system
    • PUT /sn_ent/asset/ai_dataset/{sys_id}
    • PUT /sn_ent/asset/ai_model/{sys_id}
    • PUT /sn_ent/asset/ai_prompt/{sys_id}
    • PUT /sn_ent/asset/ai_system/{sys_id}
    고객 계약 및 권리 v6.0 Service Contract API
    • POST /sn_pss_core/servicecontract
    • GET /sn_pss_core/servicecontract/{id}
    • POST /sn_pss_core/servicecontract/contractline
    • GET /sn_pss_core/servicecontract/contractline/{id}
    고객 계약 및 권리 v6.0 Verify Entitlements API GET /sn_ent_verify/verifyentitlements
    리드 관리 v3.0 lead API
    • GET /sn_lead_mgmt_core/리드
    • GET /sn_lead_mgmt_core/lead/{sys_id}
    • 패치 /sn_lead_mgmt_core/lead/{sys_id}
    • POST /sn_lead_mgmt_core/리드
    판매 및 주문 관리 v4.0 Sales Agreement API
    • GET /sn_sales_agmt_core/salesagreement /{id}
    • POST /sn_sales_agmt_core/salesagreement

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

    표 7. 에서 범위가 지정된 클래스 변경됨 Yokohama
    클래스 방법
    PDFGenerationAPI - Scoped, Global
    • 변환 PDF ()
    • convertToPDFWithHeaderFooter()

    제공된 외부 URL을 PDF 출력에서 렌더링해야 하는지 여부를 확인하기 위해 새 속성인 glide.pdf.url.whitelisting.enabled 및 com.snc.pdf.whitelisted_urls가 추가되었습니다.

    PDF 접근성 지원을 위해 새 속성인 accessibilityEnabled가 추가되었습니다.

    표 8. 에서 변경된 전역 클래스 Yokohama
    클래스 방법
    PDFGenerationAPI - Scoped, Global
    • 변환 PDF ()
    • convertToPDFWithHeaderFooter()

    제공된 외부 URL을 PDF 출력에서 렌더링해야 하는지 여부를 확인하기 위해 새 속성인 glide.pdf.url.whitelisting.enabled 및 com.snc.pdf.whitelisted_urls가 추가되었습니다.

    PDF 접근성 지원을 위해 새 속성인 accessibilityEnabled가 추가되었습니다.

    표 9. 의 변경된 REST API Yokohama
    API 엔드포인트
    Attachment API POST /now/attachment/file: 새 매개변수 creation_time는 가 Now Mobile 앱 오프라인 상태이고 첨부 파일이 나중에 기록에 업로드될 때 첨부 파일 생성 시간을 캡처하는 데 사용할 수 있습니다.
    표 10. 에서 범위가 지정된 클래스 변경됨 ServiceNow Store
    애플리케이션 앱 버전 클래스 방법
    현금으로 연결 코어 V1.4 LeadtoCashCore - Scoped 숫자 필드에 대한 번호 생성을 개선하기 위해 커밋 인스턴스 API의 성능을 개선했습니다.
    • effect(): _records_count 반환 객체는 테이블 이름 및 삽입된 레코드 수와 같은 특정 테이블에 대해 새로 삽입된 레코드에 대한 세부 정보를 제공하기 위해 추가됩니다.
    • commitInstance(): 새로운 추가 매개변수인 useNumberGenerator가 추가되어 선택적으로 sys_ids 생성하고 새 테이블 기록에 대량으로 적용합니다.
    표 11. 에서 변경된 클라이언트 클래스 ServiceNow Store
    애플리케이션 앱 버전 클래스 방법
    고객 서비스 관리 v1.2 openFrameAPI - Client subscribe(): 새 이벤트가 추가되었습니다
    • openframe_wrap_up_submitted
    • openframe_heart_beat
    표 12. 에서 REST API 변경됨 ServiceNow Store
    애플리케이션 앱 버전 API 엔드포인트
    외상 매입금 운영 v8.0 AP Invoice API 청구지 주소 정보를 지원하는 속성을 추가합니다.
    • POST /sn_spend_intg/ap_invoice/cxml
    • POST /sn_spend_intg/ap_invoice/json

    활성화 정보

    기본적으로 다음 API를 사용할 수 있습니다.
    • 첨부 파일
    • 콘솔
    • 임포트
    • Fetch.Headers
    • 가져오기.요청
    • Fetch.Response
    • Fetch.RequestInit
    • GlideDynamicAttribute
    • GlideDynamicAttributeStore
    • GlideElementDynamicAttributeStore
    • GlideTransientDynamicAttribute
    • GlideUser
    • openFrameAPI
    • PDFGenerationAPI
    • RESTMessageV2
    • ScriptableCurrencyCode
    • ScriptableUriMatcher
    • SOAPMessageV2
    • UriMatcher
    • UriMatcherResponse
    다음 API는 플러그인 활성화가 필요합니다.
    • AI 자산 API를 사용하려면 sn_ent(자산 클래스) 플러그인을 활성화해야 합니다.
    • AP 송장 API를 사용하려면 외상 매입금 송장 처리 (com.sn_ap_apm) 플러그인을 활성화해야합니다.
    • AWA 오퍼 작업 API를 사용하려면 고급 작업 할당(com.glide.awa) 플러그인을 활성화해야 합니다.
    • 잠재 고객 API를 사용하려면 sn_lead_mgmt_core(잠재 고객 관리 데이터 모델) 플러그인을 활성화해야 합니다.
    • OpenFrame API를 사용하려면 com.sn_openframe_store 플러그인을 활성화해야 합니다.
    • OrderUtil API(스크립트 포함)를 사용하려면 주문 관리(com.sn_ind_tmt_orm) 플러그인을 활성화해야 합니다.
    • ProcessMiningIntegrationAPI를 사용하려면 프로세스 마이닝 코어(com.sn_process_optimization) 플러그인을 활성화해야 합니다.
    • 판매 계약 API를 사용하려면 다음 플러그인을 활성화해야 합니다.
      • 판매 계약 데이터 모델(com.sn_sales_agmt_core)
      • 제품 카탈로그 관리 코어(com.sn_prd_pm)
      • 가격(com.sn_csm_pricing)
    • 서비스 계약 API를 사용하려면 다음 플러그인을 활성화해야 합니다.
      • 고객 계약 및 권리(com.sn_pss_core)
      • 고객 서비스 설치 기반 관리(com.snc.install)
      • 제품 카탈로그 관리 코어(com.sn_prd)
    • v_record API를 사용하려면 Remote Tables(com.glide.script.vtable) 플러그인을 활성화해야 합니다.
    • Verify Entitlements API를 사용하려면 com.sn_ent_verify(Entitlement Verification) 플러그인을 활성화해야 합니다.