언어 생성 라이브러리에서 삽입된 함수

  • 아티클

적용 대상: 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평가됩니다.

추가 정보