Liquid 필터는 사용자가 서버에서 안전하지 않은 코드를 실행하지 않고도 애플리케이션의 외관을 편집할 수 있도록 하는 유연한 웹 애플리케이션을 위한 안전한 고객용 템플릿 언어입니다. Liquid는 Liquid 템플릿 파일 내에서 태그, 객체 및 필터의 조합을 사용하여 동적 콘텐츠를 로드합니다.
Freshservice의 Liquid 필터
Freshservice의 Liquid 필터를 사용하면 노트, 웹훅, 앱 액션, 이메일 등과 같은 워크플로우 자동화기의 플레이스홀더 값을 사용 중인 타사 웹 애플리케이션의 요구 사항에 맞게 사용자 정의할 수 있습니다.
이를 통해 플레이스홀더 값에 대해 다양한 문자열, 숫자 및 날짜 작업을 수행할 수 있습니다.
포괄적인 Liquid 필터 목록은 여기에서 찾을 수 있습니다.
다음은 몇 가지 인기 있는 Liquid 필터의 작동 예입니다:
예제 1: 서브스트링
1.1 Azure AD에서 'Vishal Abraham' 사용자를 'vabraham@domainname.com'으로 생성 - Liquid 필터를 사용할 수 있습니다
{{ticket.ri_49_cf_employee_first_name | first}} {{ticket.ri_49_cf_employee_last_name }}@domainname.com
1.2 truncate 필터를 사용하여 문자열에서 처음 3글자를 추출
{{ticket.ri_49_cf_employee_first_name | truncate:3 ,''}}
예제 2:
예를 들어 inc-123과 같은 티켓 ID로 Slack 채널 생성.
여기서의 과제는 Slack이 채널 이름에 대해 소문자 형식만 허용하므로 downcase Liquid 필터를 사용하여 티켓 ID를 변환해야 합니다
{{ticket.id | downcase}}
예제 3:
필터를 사용하여 비용과 수량을 간단히 곱합니다 times 필터를 사용합니다.
{{ticket.quantity | times: ticket.cost}}
예제 4:
필터를 사용하여 텍스트 블록에서 n번째 항목을 추출합니다 split 필터를 사용합니다.
{% assign value = {{A2.meta.system_message}} | split: ' ' %}{{value[n-1]}}
예제 5:
필터를 사용하여 쉼표로 구분된 값 목록에서 n번째 항목을 추출합니다 split 필터를 사용합니다
{% assign value = {{ticket.associated_asset_names}} | split: ',' %}{{value[n-1]}}
예제 6:
Google 캘린더에 이벤트 생성
이 이벤트 생성의 경우, 날짜-시간 형식을 RFC 3339 준수 형식으로 변경해야 합니다. 즉, 2021-02-01T09:00:00.
이는 date Liquid 필터를 사용하여 수행할 수 있습니다
{{change.planned_start_date | date: '%Y-%m-%dT%H:%M:%S'}}
예제 7
sanitize_html Liquid Placeholder를 사용하여 HTML 콘텐츠 정리
liquid 필터를 사용하여 HTML 플레이스홀더를 처리하여 API 요청 본문 내에서 유효하지 않은 JSON 오류 없이 사용할 수 있도록 합니다 sanitize_html liquid 필터를 사용하여 HTML 플레이스홀더를 처리하여 API 요청 본문 내에서 유효하지 않은 JSON 오류 없이 사용할 수 있도록 합니다.
예를 들어:
{{ticket.description}} 반환
"<div style='font-size: 14px; font-family: -apple-system, BlinkMacSystemFont, \"Segoe UI\", Roboto, \"Helvetica Neue\", Arial, sans-serif;'>\n<div>This is test.</div>\n</div>"
{{ticket.description | sanitize_html}} 반환
"<div style='font-size: 14px; font-family: -apple-system, BlinkMacSystemFont, \\\"Segoe UI\\\", Roboto, \\\"Helvetica Neue\\\", Arial, sans-serif;'>\\n<div>This is test.</div>\\n</div>"
따라서 API 요청 본문 내에서 사용할 수 있습니다.