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 |
|
| UriMatcherResponse - Scoped |
- getErrorMessages()
- isError()
- isFragmentMatches()
- isHostMatches()
- isMatch()
- isPathMatches()
- isSchemeMatches()
|
| v_record - Scoped, Global |
setLastErrorMessage() |
표 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/작성
|
표 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) 플러그인을 활성화해야 합니다.