템플릿 매개변수

알림 템플릿마다 사용할 수 있는 매개변수를 정하는 유형이 있습니다. 유형은 함께 쓸 트리거와 맞아야 합니다. 예를 들어 알람 템플릿은 알람 알림 규칙에서만 쓸 수 있습니다. 템플릿과 규칙의 개요는 알림 센터를 참고하세요.

일반

사용하는 경우: 특정 시스템 이벤트에 묶이지 않은 알림 — 점검 공지, 사용자 지정 공지, 직접 또는 REST API로 보내는 일회성 메시지.

예시:

Subject: Scheduled maintenance tonight, ${recipientFirstName:capitalize}
Message: Hi ${recipientFirstName:capitalize}, the platform will be offline for maintenance on March 5 from 2:00–4:00 AM UTC.

매개변수	설명
`recipientTitle`	수신자의 전체 이름. 이름이 없으면 이메일 주소.
`recipientEmail`	수신자의 이메일 주소.
`recipientFirstName`	수신자의 이름.
`recipientLastName`	수신자의 성.

알람

사용하는 경우: HMI 장치나 자산의 알람이 생성되거나, 심각도가 바뀌거나, 확인·해제·삭제될 때 엔지니어나 운영자에게 알립니다. 당번 연락을 위해 알람 알림 규칙과 에스컬레이션 체인을 함께 씁니다.

예시:

Subject: New ${alarmSeverity:upperCase} alarm: ${alarmType}
Message: ${alarmOriginatorEntityType} "${alarmOriginatorName}" triggered a ${alarmSeverity} alarm. Status: ${alarmStatus}.

표시 예: New CRITICAL alarm: High Temperature / Device “Compressor BJ-66” triggered a critical alarm. Status: ACTIVE.

일반 매개변수를 모두 포함하고, 다음이 더 있습니다.

매개변수	설명
`alarmType`	알람 유형.
`action`	다음 중 하나: `created`, `severity changed`, `acknowledged`, `cleared`, `deleted`.
`alarmId`	알람 ID(UUID).
`alarmSeverity`	알람 심각도(소문자).
`alarmStatus`	알람 상태.
`alarmOriginatorEntityType`	알람 발생 엔티티의 엔티티 유형(예: `Device`).
`alarmOriginatorName`	알람 발생 엔티티의 이름(예: `Sensor T1`).
`alarmOriginatorId`	알람 발생 엔티티 ID(UUID).
`alarmOriginatorLabel`	알람 발생 엔티티의 라벨 필드.

장치 활동

사용하는 경우: HMI 장치가 예기치 않게 오프라인이 되거나 다시 온라인이 될 때 운영자에게 알립니다. 연결이 자주 끊기는 현장 장치를 모니터링할 때 유용합니다.

예시:

Subject: Device "${deviceName}" is now ${eventType}
Message: Device "${deviceName}" (type: ${deviceType}) changed status to ${eventType}.

표시 예: Device “Compressor BJ-66” is now inactive / Device “Compressor BJ-66” (type: HVAC) changed status to inactive.

일반 매개변수를 모두 포함하고, 다음이 더 있습니다.

매개변수	설명
`deviceId`	장치 ID(UUID).
`deviceName`	장치 이름.
`deviceLabel`	장치 라벨.
`deviceType`	장치 유형.
`eventType`	다음 중 하나: `inactive`, `active`.

엔터티 작업

사용하는 경우: 엔티티(장치, 자산, 고객, 사용자)가 생성·수정·삭제될 때 감사 기록용 알림을 보냅니다. 큰 팀에서 변경 관리에 유용합니다.

예시:

Subject: ${entityType:capitalize} ${actionType} by ${userEmail}
Message: ${entityType} "${entityName}" was ${actionType} by ${userFirstName:capitalize} ${userLastName:capitalize} (${userEmail}).

표시 예: Device added by admin@company.io / Device “Sensor NM-12” was added by John Doe (admin@company.io).

일반 매개변수를 모두 포함하고, 다음이 더 있습니다.

매개변수	설명
`entityType`	엔티티 유형(예: `Device`).
`entityId`	엔티티 ID(UUID).
`entityName`	엔티티 이름.
`actionType`	다음 중 하나: `added`, `updated`, `deleted`.
`userId`	작업을 수행한 사용자의 ID.
`userEmail`	작업을 수행한 사용자의 이메일.
`userFirstName`	사용자의 이름.
`userLastName`	사용자의 성.

알람 댓글

사용하는 경우: 동료가 활성 알람에 댓글을 달면 알람 담당자나 팀에 알립니다. 알람 타임라인을 직접 확인하지 않아도 됩니다.

예시:

Subject: New comment on "${alarmType}" alarm
Message: ${userFirstName:capitalize} ${userLastName:capitalize} ${action} a comment on the ${alarmSeverity} alarm for "${alarmOriginatorName}": "${comment}"

표시 예: New comment on “High Temperature” alarm / Jane Smith added a comment on the critical alarm for “Compressor RK-25”: “Checked on-site — coolant level is low.”

알람 매개변수를 모두 포함하고, 다음이 더 있습니다.

매개변수	설명
`comment`	댓글 내용.
`action`	다음 중 하나: `added`, `updated`.
`userEmail`	댓글을 남긴 사용자의 이메일.
`userFirstName`	사용자의 이름.
`userLastName`	사용자의 성.
`userTitle`	미리 형식화된 표시 이름: `userFirstName + " " + userLastName`. 두 이름 필드가 모두 비어 있으면 이메일을 씁니다.

알람 할당

사용하는 경우: 알람이 엔지니어에게 할당되면 그 엔지니어에게 알리고, 할당이 해제되면 팀에 알립니다.

예시:

Subject: Alarm "${alarmType}" assigned to you
Message: ${userEmail} assigned a ${alarmSeverity} alarm on "${alarmOriginatorName}" to ${assigneeEmail}.

표시 예: Alarm “High Temperature” assigned to you / supervisor@company.io assigned a critical alarm on “Compressor BJ-66” to engineer@company.io.

알람 매개변수를 모두 포함하고, 다음이 더 있습니다.

매개변수	설명
`assigneeEmail`	담당자의 이메일 주소.
`assigneeFirstName`	담당자의 이름.
`assigneeLastName`	담당자의 성.
`assigneeTitle`	미리 형식화된 표시 이름: `assigneeFirstName + " " + assigneeLastName`. 두 이름 필드가 모두 비어 있으면 이메일을 씁니다.
`assigneeId`	담당자 ID(UUID).
`userEmail`	작업을 수행한 사용자의 이메일.
`userFirstName`	사용자의 이름.
`userLastName`	사용자의 성.
`userTitle`	미리 형식화된 표시 이름: `userFirstName + " " + userLastName`. 두 이름 필드가 모두 비어 있으면 이메일을 씁니다.
`action`	다음 중 하나: `assigned`, `unassigned`.

매개변수 사용

매개변수 이름을 ${...}로 감쌉니다(예: ${recipientFirstName}). 콜론 뒤에 접미사를 붙이면 값을 변환합니다.

접미사	예시	결과	사용하는 경우
`upperCase`	`${recipientFirstName:upperCase}`	`JOHN`	이메일 제목, 머리글, 강조
`lowerCase`	`${recipientFirstName:lowerCase}`	`john`	URL, 기술 식별자
`capitalize`	`${recipientFirstName:capitalize}`	`John`	메시지 본문의 올바른 문장 표기

팁: 매개변수와 일반 글을 섞어 자연스러운 문장을 만듭니다. 예:

Subject: New ${alarmSeverity:upperCase} alarm on ${alarmOriginatorName}
Message: Hi ${recipientFirstName:capitalize}, a ${alarmSeverity} alarm of type "${alarmType}" was ${action} on device "${alarmOriginatorName}".

표시 예: New CRITICAL alarm on Compressor BJ-66 / Hi Jane, a critical alarm of type “High Temperature” was created on HMI Device “Compressor BJ-66”.