이 도움말 페이지의 정보는 CXone Studio 및 Desktop Studio에 모두 적용됩니다.
선언문을 사용하면 스크립트에 새로운 변수, 개체, 또는 함수를 도입할 수 있습니다. 이러한 문에 대한 키워드는 다음과 같습니다.
- ASSIGN: 변수 또는 문자열 배열을 만들어야 할 때 이 문을 사용합니다.
- DYNAMIC: 동적 데이터 개체를 만들어야 할 때 이 문을 사용합니다.
- FUNCTION: 스크립트에 새 함수를 만들어야 할 때 이 문을 사용합니다.
문의 각 유형에 대한 논의에는 구문 요약이 포함됩니다. 이러한 요약은 특정한 규칙을 사용하여 문의 일부를 나타내고 각 부분이 필수인지 선택 사항인지를 나타냅니다.
ASSIGN 문
설명: ASSIGN 문은 지정하는 이름과 값이 포함된 변수를 생성합니다.
구문: ASSIGN <variable> = "<value>" | <value>
Studio 작업: Assign
세부 사항: ASSIGN 문은 <variable>을(를) 생성하고 <value>을(를) 할당합니다. 변수를 생성할 때는 날짜/시간 유형인 경우가 아니라면 데이터 유형을 선언할 필요가 없습니다. Studio의 변수는 명시적으로 입력합니다. 즉, 한 번에 값을 생성 및 할당할 수 있다는 의미입니다. 예:
ASSIGN oneName = "Odin"
ASSIGN 문을 사용하여 문자 배열을 생성할 수 있습니다.
ASSIGN manyNames = "Odin|Freya|Thor"
하나의 변수를 다른 변수의 값으로 할당할 수 있습니다.
ASSIGN x = 1
ASSIGN y = x
ASSIGN var1 = z등호 기호의 오른쪽에 있는 변수는 변수가 이미 선언되었다면 중괄호 및 큰따옴표로 묶을 필요가 없습니다. 스크립트는 등호 기호의 오른쪽 용어를 평가합니다. 중괄호 또는 큰따옴표로 묶여 있지 않는데 숫자가 아니라면, 스크립트는 이를 변수로 인식합니다. 이미 존재하는 경우, 스크립트는 그 값을 두 번째 변수로 할당합니다. 선언되지 않은 경우, 스크립트는 null 값으로 이를 생성합니다.
명명 가이드라인: 변수의 이름을 지정할 때는 다음 가이드라인을 따르십시오.
-
영숫자 문자(
- 이름의 첫 문자는 글자여야 합니다.
- 밑줄 문자(
- 변수 이름의 마지막 문자가 달러 기호라면 값은 텍스트로 취급됩니다.
- 사전 정의된 변수의 이름 또는 예약된 단어는 사용하지 마십시오.
자세히 알아보기: 변수에 관한 자세한 정보는 변수 도움말 페이지에서 확인할 수 있습니다.
DYNAMIC 문
설명: DYNAMIC 문은 특정한 이름의 동적 데이터 개체 변수를 생성합니다.
구문: DYNAMIC <name>
세부 사항: 동적 데이터는 여러 값을 보유할 수 있는 변수입니다. 배열과 유사하지만 몇 가지 핵심적인 차이가 있습니다.
동적 데이터 개체가 보유하는 값은 매개 변수라 합니다. 키-값 쌍으로 정의되며, 모든 매개 변수에는 키(이름)와 값이 있습니다. DYNAMIC 키워드로 개체를 선언한 이후에는 개체 멤버를 정의할 수 있습니다.
예:
DYNAMIC beowulfCharacteristics
beowulfCharacteristics.name = "Beowulf"
beowulfCharacteristics.occupation= "Hero"
beowulfCharacteristics.foe = "Grendel" 동적 데이터 개체와 매개 변수를 참조할 때 대소문자는 중요합니다. BeowulfCharacteristics은(는) beowulfCharacteristics과(와) 다릅니다.
명명 가이드라인: 동적 데이터 개체의 이름을 지정할 때는 다음 가이드라인을 따르십시오.
-
영숫자 문자(
- 이름의 첫 문자는 글자여야 합니다.
- 밑줄 문자(
- 사전 정의된 변수의 이름 또는 예약된 단어는 사용하지 마십시오.
자세히 알아보기: 동적 데이터 개체에 관한 자세한 정보는 개체 및 데이터 구조 도움말 페이지에서 확인할 수 있습니다.
FUNCTION 문
설명: 사용자 정의 함수를 만듭니다.
선언할 구문: FUNCTION <name><([parameter], [...])> <{ ... [RETURN [data]]}>
호출할 구문: <functionName><([parameter], [parameter], [...])><{<varName>.<functionName><([parameter], [parameter], [...])>}>
세부 사항: 마지막에 열림 괄호 및 닫힘 괄호 세트를 포함한 <name>을(를) 함수에 부여함으로써 함수를 선언합니다. 예: FUNCTION functionName(). 괄호 사이에 선택적으로 [parameters]을(를) 추가합니다. 매개 변수를 사용하면 인수라고 하는 데이터를 함수 내외로 전달할 수 있습니다.
선언 헤더 다음의 중괄호 { RETURN <data>} 사이에 함수가 호출되었을 때 스크립트가 실행하기를 원하는 코드를 포함합니다 코드 마지막에 RETURN 키워드를 기재한 다음 그다음에는 함수의 출력을 보유하기를 원하는 <data> 변수를 기재합니다. 호출하는 스크립트로 다시 데이터를 전달해야 할 때만 RETURN 다음에 변수를 포함하면 됩니다.
함수에 매개 변수가 없어도 함수 이름에는 항상 괄호가 포함되어야 합니다. 예:
FUNCTION noParams()
FUNCTION twoParams(name, accountNum)
포함한 코드를 사용해야 하는 스크립트에 함수를 호출할 수 있습니다. 함수 호출을 수행하는 데 사용할 구문은 함수가 값을 반환할지 여부에 따라 달라집니다.
함수 정의에 <parameters>이(가) 있는 경우 스크립트는 적절한 정보를 함수로 전달해야 합니다. 함수 호출에 매개 변수를 포함해야 합니다. 함수 정의에서 표시되는 것과 동일한 순서로 모든 매개 변수를 포함합니다. 예를 들면 callVar.twoParams('Beowulf', 349839)입니다.
함수의 결과를 변수에 할당되게 하려면 함수를
함수 정의의 함수 이름 뒤에 메모를 추가하여 함수에 대한 인라인 도움말을 제공합니다. 인라인 도움말은
명명 가이드라인: 함수의 이름을 지정할 때는 다음 가이드라인을 따르십시오.
-
영숫자 문자(
- 이름의 첫 문자는 글자여야 합니다.
- 밑줄 문자(
- 예약된 단어나 내장된 함수 이름은 사용하지 마십시오.
자세히 알아보기: 함수에 관한 자세한 정보는 함수 도움말 페이지에서 확인할 수 있습니다.
예시
FUNCTION TimerRound(Timer)
{
IF Timer = "-1"
{
ASSIGN Timer = Timer
}
ELSE
{
ASSIGN PeriodLocation = Timer.indexof('.')
IF PeriodLocation = 0
{
ASSIGN Timer = Timer
}
ELSE
{
ASSIGN DataLength = Timer.length
IF DataLength - PeriodLocation <= 2
{
ASSIGN Timer = Timer
}
ELSE
{
ASSIGN DigitCheck = Timer.substr(PeriodLocation + 3, PeriodLocation + 3)
IF DigitCheck >=5 && DigitCheck <= 9
{
ASSIGN Timer = Timer + .01
}
ELSE
{
ASSIGN Timer = Timer
}
ASSIGN Timer = Timer.substr(1, PeriodLocation + 2)
}
}
}
TRACE "{Timer}"
RETURN Timer
}
IF TEST = 1
{
ASSIGN DC1 = "1.931876668494874"
}
ASSIGN DC1 = TimerRound(DC1)