언어 생성 라이브러리에서 삽입된 함수
적용 대상: SDK v4
다음 문서에서는 LG(언어 생성) 라이브러리에서 함수를 삽입하는 방법을 자세히 설명합니다.
ActivityAttachment
개체 및 형식에서 생성된 activityAttachment
를 반환합니다.
ActivityAttachment(<collection-of-objects>)
매개 변수 | 필수 | 종류 | 설명 |
---|---|---|---|
<content> | 예 | 개체 | 첨부 파일의 정보를 포함하는 개체 |
<type> | 예 | string | 첨부 파일의 형식을 나타내는 문자열입니다. |
반환 값 | Type | 설명 |
---|---|---|
<activityAttachment> | 개체 | 입력에서 형성된 activityAttachment |
예제:
이 예제에서는 개체의 컬렉션을 activityAttachment
로 변환합니다.
다음 템플릿이 있다고 가정합니다.
# externalHeroCardActivity(type, title, value)
[Activity
attachments = ${ActivityAttachment(json(fromFile('.\\herocard.json')), 'herocard')}
]
및 다음을 수행합니다.herocard.json
{
"title": "titleContent",
"text": "textContent",
"Buttons": [
{
"type": "imBack",
"Title": "titleContent",
"Value": "textContent",
"Text": "textContent"
}
],
"tap": {
"type": "${type}",
"title": "${title}",
"text": "${title}",
"value": "${value}"
}
}
함수로 호출 externalHeroCardActivity()
하여 다음을 수행합니다.
externalHeroCardActivity('signin', 'Signin Button', 'http://login.microsoft.com')
다음을 반환합니다.herocard
{
"lgType" = "attachment",
"contenttype" = "herocard",
"content" = {
"title": "titleContent",
"text": "textContent",
"Buttons": [
{
"type": "imBack",
"Title": "titleContent",
"Value": "textContent",
"Text": "textContent"
}
],
"tap": {
"type": "signin",
"title": "Signin Button",
"text": "Signin Button",
"value": "http://login.microsoft.com"
}
}
}
expandText
개체의 일반 텍스트를 평가하고 확장된 텍스트 데이터를 반환합니다.
expandText(<object>)
매개 변수 | 필수 | 종류 | 설명 |
---|---|---|---|
<object> | 예 | 개체 | 확장할 텍스트가 있는 개체입니다. |
반환 값 | Type | 설명 |
---|---|---|
<evaluated-result> | 개체 | 확장된 텍스트 데이터입니다. |
예제
다음은 JSON 개체의 일반 텍스트를 평가하고 확장된 텍스트 결과를 반환하는 예제입니다.
다음 개체가 있다고 가정해 보겠습니다.
{
"@answer": "hello ${user.name}",
"user": {
"name": "vivian"
}
}
호출 expandText(@answer)
하면 개체 hello vivian이 발생합니다.
template
지정된 템플릿 이름 및 범위의 계산된 결과를 반환합니다.
template(<templateName>, '<param1>', '<param2>', ...)
매개 변수 | 필수 | 종류 | 설명 |
---|---|---|---|
<templateName> | 예 | string | 템플릿 이름을 나타내는 문자열 |
<param1,param2><>, ... | 예 | Object | 템플릿에 전달된 매개 변수 |
반환 값 | Type | 설명 |
---|---|---|
<evaluated-result> | 개체 | 템플릿에서 함수로 평가된 결과 |
예제
이 예제에서는 템플릿을 함수로 호출한 결과를 평가합니다.
다음 템플릿이 있다고 가정합니다.
# welcome(userName)
- Hi ${userName}
- Hello ${userName}
- Hey ${userName}
호출 template("welcome", "DL")
하면 다음 중 하나가 발생합니다.
- Hi DL
- Hello DL
- Hey DL
fromFile
지정된 파일에서 식의 평가된 결과를 반환합니다.
fromFile(<filePath>)
매개 변수 | 필수 | 종류 | 설명 |
---|---|---|---|
<filePath> | 예 | string | 파일의 상대 또는 절대 경로에 식이 포함되어 있습니다. |
반환 값 | Type | Description |
---|---|---|
<result> | string | 평가된 결과의 문자열 표현 |
예제
이 예제에서는 지정된 파일의 결과를 평가합니다.
라는 /home/user/test.txt
파일이 있다고 가정해 보겠습니다. 파일 내에는 다음이 있습니다.
`you have ${add(1,2)} alarms`
fromFile('/home/user/test.txt')
fromFile()
함수는 식을 계산하고 결과는 원래 식을 바꿉니다.
호출 fromFile('/home/user/test.txt')
하면 3개의 알람이 있는 문자열 이 생성됩니다.
isTemplate
지정된 템플릿 이름이 평가자에 포함되는지 여부를 반환합니다.
isTemplate(<templateName>)
매개 변수 | 필수 | 종류 | 설명 |
---|---|---|---|
<templateName> | 예 | 문자열 | 검사 템플릿 이름 |
반환 값 | Type | Description |
---|---|---|
<result> | 부울 | 지정된 템플릿 이름이 평가자에 포함되는지 여부 |
예제
이 예제에서는 함수를 isTemplate()
사용하여 지정된 템플릿 이름이 평가자에 있는지 여부를 검사. 예를 들어 세 가지 템플릿은 다음과 같습니다.
# welcome
- hi
# show-alarms
- 7:am and 8:pm
# add-to-do
- you add a task at 7:pm
호출 isTemplate("welcome")
은 .로 true
평가됩니다. 호출 isTemplate("delete-to-do")
은 .로 false
평가됩니다.