비즈니스 규칙 API - ServiceNow Fluent
비즈니스 규칙 API는 기록이 표시, 삽입, 업데이트 또는 삭제되거나 테이블이 쿼리될 때 실행되는 서버 측 스크립트[sys_script]를 정의합니다.
주:
최신 ServiceNow Fluent API 설명서 및 예제는 ServiceNow Fluent API 참조 및 ServiceNow SDK 예제 리포지토리 는 의 위치에 있습니다 GitHub.
비즈니스 규칙에 대한 일반적인 정보는 다음 문서를 참조하십시오 Classic Business rules.
BusinessRule 객체
특정 서버 측 조건이 충족될 때 양식 필드의 값을 자동으로 변경하는 비즈니스 규칙 [sys_script]을 만듭니다.
| 이름 | 유형 | 설명 |
|---|---|---|
| $id | 문자열 또는 숫자 | 필수 메타데이터 객체의 고유 ID입니다. 애플리케이션을 빌드할 때 이 ID는 고유한 sys_id으로 해시됩니다. 자세한 내용은 ServiceNow Fluent 언어 구성 문서를 참조하십시오. 형식: |
| 이름 | 문자열 | 필수 비즈니스 규칙의 이름입니다. |
| 테이블 | 문자열 | 필수 비즈니스 규칙이 실행되는 테이블의 이름입니다. |
| 스크립트 | 스크립트 | 정의된 조건이 true이면 사용자 지정 스크립트가 실행됩니다. 이 속성은 JavaScript 모듈의 함수, 스크립트가 포함된 애플리케이션의 다른 파일에 대한 참조 또는 인라인 JavaScript를 지원합니다. 체재:
|
| 순서 | 번호 | 비즈니스 규칙이 실행되어야 하는 순서를 나타내는 숫자입니다. 특정 활동에 대한 규칙이 여러 개 있는 경우 규칙은 가장 낮은 것부터 가장 높은 것 순으로 지정된 순서대로 실행됩니다. 기본값: 100 |
| 활성 | 부울 | 비즈니스 규칙을 사용할 수 있는지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다.
기본값: true |
| 시기 | 문자열 | 비즈니스 규칙을 실행해야 하는 시간입니다. 비즈니스 규칙이 실행되는 시기에 대한 자세한 내용은 다음 문서를 참조하십시오 How business rules work. 유효한 값은 다음과 같습니다.
기본값: 이전 |
| 작업 | 배열 | 비즈니스 규칙이 적용되는 기록 옵션입니다. 비즈니스 규칙 작업에 대한 자세한 내용은 다음 문서를 참조하십시오 How business rules work. 유효한 값은 다음과 같습니다.
|
| 추가 메시지 | 부울 | 비즈니스 규칙이 실행될 때 나타나는 메시지를 추가할지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다.
기본값: false |
| abort작업 | 부울 | 현재 데이터베이스 트랜잭션을 중단할지 여부를 나타내는 플래그입니다. 예를 들어 삽입 전 비즈니스 규칙에서 조건이 충족되면 데이터베이스에 기록을 삽입하지 마십시오. 유효한 값은 다음과 같습니다.
기본값: false |
| 메시지 | 문자열 | 비즈니스 규칙이 실행될 때 나타나는 메시지입니다. |
| 역할 조건 | 배열 | 비즈니스 규칙을 실행하려면 테이블의 기록을 수정하는 사용자가 가지고 있어야 하는 역할 객체의 변수 식별자 목록입니다. 자세한 내용은 역할 API - ServiceNow Fluent 문서를 참조하십시오. |
| 조건 | 문자열 | 스크립트가 실행되기 위해 예여야 하는 필드와 값을 지정하는 JavaScript 조건문입니다. 이 속성은 인라인 JavaScript 또는 스크립트가 포함된 애플리케이션의 다른 파일에 대한 참조를 지원합니다. 주: filterCondition 또는 script 속성과 함께 조건문을 포함하는 경우에는 이 속성을 사용하지 마십시오. 이 속성으로 조건문을 지정하면 조건이 별도로 평가되고 조건이 true인 경우에만 비즈니스 규칙이 실행됩니다. 비동기 비즈니스 규칙을 실행하기 전에 조건문을 두 번째로 다시 평가하려면 시스템 속성을 true로 설정합니다 glide.businessrule.async_condition_check . 체재:
|
| filterCondition | 문자열 | 비즈니스 규칙을 실행하기 위해 True여야 하는 필드와 값을 지정하는 필터 쿼리입니다. 자세한 내용은 Operators available for filters and queries 문서를 참조하십시오. |
| setFieldValue | 문자열 | 테이블의 필드에 대해 설정할 값입니다. 이는 setFieldValue: 'sec_created=false^EQ'와 같이 인코딩된 쿼리로 제공할 수 있습니다. |
| 설명 | 문자열 | 비즈니스 규칙이 수행하는 작업에 대한 설명입니다. |
| 보호 정책 | 문자열 | 애플리케이션이 인스턴스에 설치된 후 다른 사용자가 스크립트 포함을 보거나 편집할 수 있는지 여부를 결정하는 정책입니다. 정의되지 않은 경우 다른 애플리케이션 개발자가 스크립트 포함을 사용자 지정할 수 있습니다. 유효한 값은 다음과 같습니다.
|
| $meta | 객체 | 애플리케이션 메타데이터의 메타데이터입니다. installMethod 속성을 사용하면 애플리케이션 메타데이터를 특정 상황에서만 로드되는 출력 디렉터리에 매핑할 수 있습니다. installMethod에 유효한 값:
|
import { BusinessRule } from '@servicenow/sdk/core'
import { FunctionExport, FunctionExpression } from '../server/scripts.js'
import DefaultExportFunction from '../server/scripts.js'
const BR1 = BusinessRule({
name: 'exportedFunction',
table: 'x_snc_table',
when: 'after',
action: ['update', 'delete', 'insert'],
script: FunctionExport,
order: 100,
active: true,
addMessage: false,
message: '<p>message</p>',
abortAction: false,
$id: Now.ID[0],
})
const BR2 = BusinessRule({
name: 'businessrule2',
table: 'x_snc_table',
script: FunctionExpression,
when: 'after',
action: ['update'],
$id: Now.ID[1],
})
const BR3 = BusinessRule({
name: 'businessrule3',
table: 'x_snc_table',
script: DefaultExportFunction,
when: 'after',
action: ['update'],
filterCondition: `sys_updated_onSTARTSWITHb^sys_updated_bySTARTSWITHm^EQ
<item goto="false" or="false" field="sys_updated_on" endquery="false" value="b" operator="STARTSWITH" newquery="false"/>
<item goto="false" or="false" field="sys_updated_by" endquery="false" value="m" operator="STARTSWITH" newquery="false"/>
<item goto="false" or="false" field="" endquery="true" value="" operator="=" newquery="false"/>`,
$id: Now.ID[2],
})
const BR4 = BusinessRule({
name: 'templateBR',
action: ['insert'],
when: 'after',
table: 'x_snc_table',
roleConditions: [admin],
order: 100,
active: true,
addMessage: true,
message: '<p>message</p>',
script: `gs.info('info')`,
abortAction: false,
$id: Now.ID[3],
})