경고 릴레이(미리 보기)
경고 릴레이는 사용 중지된 SharePoint 경고를 보다 풍부하고 최신 알림으로 바꾸는 데 도움이 됩니다. 일반 수정 알림 대신 변경된 내용을 정확하게 표시할 수 있도록 자세한 필드 수준 변경 내용과 즉시 사용할 수 있는 경고 HTML을 반환합니다.
이 커넥터는 다음 제품 및 지역에서 사용할 수 있습니다.
| Service | 클래스 | Regions |
|---|---|---|
| Copilot Studio | Premium | 다음을 제외한 모든 Power Automate 지역: - 미국 정부(GCC) - 미국 정부(GCC High) - 21Vianet에서 운영하는 중국 클라우드 - 미국 국방부(DoD) |
| 논리 앱 | 표준 | 다음을 제외한 모든 Logic Apps 지역 : - Azure Government 지역 - Azure 중국 지역 - 미국 국방부(DoD) |
| Power Apps | Premium | 다음을 제외한 모든 Power Apps 지역: - 미국 정부(GCC) - 미국 정부(GCC High) - 21Vianet에서 운영하는 중국 클라우드 - 미국 국방부(DoD) |
| 파워 오토메이트 | Premium | 다음을 제외한 모든 Power Automate 지역: - 미국 정부(GCC) - 미국 정부(GCC High) - 21Vianet에서 운영하는 중국 클라우드 - 미국 국방부(DoD) |
| 연락처 | |
|---|---|
| Name | independNET 지원 |
| URL | https://independnet.com.au/alert-relay/support |
| support@alertbridge.com.au |
| 커넥터 메타데이터 | |
|---|---|
| Publisher | independNET 제품 |
| 웹 사이트 | https://independnet.com.au/alert-relay/ |
| 개인 정보 보호 정책 | https://independnet.com.au/alert-relay/privacy |
| 카테고리 | 합작; 생산력 |
경고 릴레이
경고 릴레이는 사용 중지된 SharePoint 경고를 Microsoft 365 환경에 대한 보다 풍부하고 최신 알림으로 바꾸는 데 도움이 됩니다. 서식이 지정된 필드 수준 비교 및 즉시 사용할 수 있는 HTML 경고 출력을 포함하여 자세한 SharePoint 항목 및 문서 변경 정보를 제공합니다.
개요
경고 릴레이는 기본 "항목 수정됨" 환경보다 더 유용한 SharePoint 알림을 원하는 제조업체를 위해 설계되었습니다.
다음을 지원합니다.
- 자세한 필드 수준 변경 검사
- 경고 전자 메일에 사용할 준비가 된 HTML 출력
- 기준 및 첫 실행 의사 결정에 대한 트리거 토큰 구문 분석
- SharePoint 목록
- 문서 라이브러리
- 사이트 페이지/페이지 라이브러리
주요 기능
1. 자세한 변경 내용 추적
커넥터는 SharePoint 항목 또는 문서의 현재 버전을 이전 버전과 비교하고 구조화된 변경 세부 정보를 반환할 수 있습니다.
2. 즉시 사용할 수 있는 HTML 경고 출력
커넥터는 서식이 지정된 HTML을 생성할 수 있으므로 흐름은 복잡한 HTML 식을 수동으로 작성하지 않고도 유용한 경고 이메일을 보낼 수 있습니다.
3. 토큰 구문 분석 트리거
이 Parse Compare From 작업은 SharePoint 변경 토큰 TriggerWindowStartToken 을 디코딩하고 흐름에서 의사 결정을 위한 포함된 타임스탬프 및 토큰 세부 정보를 반환합니다.
4. 동적 드롭다운
커넥터에는 다음에 대한 동적 드롭다운 지원이 포함됩니다.
- 사이트
- 목록 및 라이브러리
- 날짜 형식
- 시간 형식
- 표준 시간대
5. 유연한 비교 기준
커넥터는 다음의 비교를 지원합니다.
- SharePoint 트리거 토큰
- 원시 SharePoint 변경 토큰
- 버전 레이블
- ISO 8601 날짜/날짜-시간 기준
지원되는 작업
자세한 변경 내용 가져오기
이전 및 현재 서식이 지정된 값을 포함하여 변경된 필드를 설명하는 구조화된 JSON을 반환합니다.
경고 HTML로 자세한 변경 내용 가져오기
전자 메일 또는 기타 HTML 지원 대상에 대해 즉시 사용할 수 있는 HTML 출력 및 관련 경고 메타데이터를 반환합니다.
비교 구문 분석
SharePoint 트리거/변경 토큰을 디코딩하고 포함된 타임스탬프 및 토큰 세부 정보를 반환합니다.
일반적인 사용 사례
- 목록 항목이 변경되면 더 나은 SharePoint 경고 전자 메일 보내기
- 중요한 비즈니스 필드에 대한 이전 및 현재 값 표시
- 문서 라이브러리 메타데이터 변경 내용 추적
- 빌드 승인, 규정 준수 또는 감사 알림 흐름
- 선택한 기준에 대해 트리거 토큰 날짜를 평가하여 시끄러운 첫 실행 경고 표시 안 함
Authentication
경고 릴레이는 API 구독 키와 함께 Microsoft Entra ID 인증을 사용합니다.
커넥터를 사용하려면 사용자에게 다음이 필요합니다.
- 관련 SharePoint 사이트, 목록 또는 라이브러리에 대한 액세스
- 유효한 경고 릴레이 연결
- 유효한 Alert Relay API 구독 키
테넌트가 경고 릴레이를 처음 사용하는 경우 자동으로 평가판 모드로 전환됩니다. 평가판 모드에서 벗어나려면 .에게 문의하세요 support@alertbridge.com.au.
시작하기
일반적인 유효성 검사 흐름은 다음을 사용합니다.
- SharePoint 트리거(예: )
When an item is created or modified - 경고 릴레이 작업(예: )
Get Detailed Changes as Alert HTML - 반환된 제목 및 HTML 출력을 사용하는 전자 메일 또는 작성 단계
구조화된 다운스트림 처리의 경우 반환 changedFields 된 배열을 사용하고 Get Detailed Changes 반복합니다.
알려진 문제 및 제한 사항
- SharePoint Online이 지원됩니다. SharePoint Server 온-프레미스는 지원되지 않습니다.
- 트리거 토큰은 항목별 경고 기록이 아닌 SharePoint 트리거 창을 반영하기 때문에 SharePoint 트리거 타이밍은 첫 실행 비교에 영향을 줄 수 있습니다.
Support
웹 사이트:
개인 정보 취급 방침:
지원:
지원 전자 메일:
- support@alertbridge.com.au
추가 참고 사항
경고 릴레이는 특히 HTML 전자 메일 서식 지정 및 필드 수준 변경 검사에 필요한 사용자 지정 식 작업의 양을 줄여 SharePoint 기반 알림 시나리오의 유용성을 개선하기 위한 것입니다.
연결을 만드는 중
커넥터는 다음 인증 유형을 지원합니다.
| 기본값 | 연결을 만들기 위한 매개 변수입니다. | 모든 지역 | 공유할 수 없음 |
기본값
적용 가능: 모든 지역
연결을 만들기 위한 매개 변수입니다.
공유 가능한 연결이 아닙니다. 전원 앱이 다른 사용자와 공유되면 다른 사용자에게 새 연결을 명시적으로 만들라는 메시지가 표시됩니다.
제한 한도
| Name | 호출 | 갱신 기간 |
|---|---|---|
| 연결당 API 호출 | 100 | 60초 |
actions
| 비교 구문 분석 |
TriggerWindowStartToken 또는 원시 SharePoint 변경 토큰을 디코딩하고 흐름 조건 및 기준 결정에 대한 포함된 타임스탬프를 반환합니다. 이 작업은 SharePoint를 호출하지 않습니다. |
| 자세한 항목 경고 HTML 가져오기 |
SharePoint 스타일 경고 전자 메일용으로 설계되었지만 문서 또는 기타 HTML 지원 대상에서도 사용할 수 있도록 설계된 SharePoint 항목 변경에 사용할 준비가 된 경고 릴레이 HTML을 반환합니다. |
| 자세한 항목 변경 내용 가져오기 |
SharePoint 목록 항목 또는 문서에 대한 자세한 형식의 필드 수준 변경 내용을 검색하여 현재 버전을 이전 버전과 비교합니다. 기본 제공 SharePoint 스타일의 true/false 필드 플래그가 아닌 다양한 변경 데이터를 원하는 경우 사용합니다. |
비교 구문 분석
TriggerWindowStartToken 또는 원시 SharePoint 변경 토큰을 디코딩하고 흐름 조건 및 기준 결정에 대한 포함된 타임스탬프를 반환합니다. 이 작업은 SharePoint를 호출하지 않습니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
다음에서 비교
|
compareFrom | True | string |
TriggerWindowStartToken 또는 원시 SharePoint 변경 토큰을 디코딩합니다. 버전 레이블 및 ISO 날짜/날짜-시간 값은 이 작업에서 지원되지 않습니다. |
|
Timezone
|
timezone | string |
로컬 비교 값(예: 'America/New_York', 'Europe/London', 'Australia/Sydney')에 대한 선택적 IANA 표준 시간대 ID입니다. 생략하면 UTC 값만 반환됩니다. |
반품
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
성공
|
success | boolean | |
|
Message
|
message | string | |
|
토큰 날짜 시간 UTC
|
tokenDateTimeUTC | date-time |
UTC의 토큰 타임스탬프입니다. |
|
토큰 날짜 시간 로컬
|
tokenDateTimeLocal | date-time |
요청된 표준 시간대로 변환된 토큰 타임스탬프입니다. |
|
디코딩된 토큰
|
decodedToken | string |
원시 토큰 텍스트를 디코딩했습니다. 원시 토큰 입력의 경우 원래 값과 일치합니다. |
|
Base64 토큰입니다.
|
isBase64Token | boolean |
들어오는 토큰이 base64로 인코딩된 경우 True입니다. |
|
Sequence
|
sequence | integer |
SharePoint는 토큰에 포함된 시퀀스 값을 변경합니다. |
|
목록 GUID
|
listGuid | uuid |
토큰에 포함된 목록 또는 라이브러리 GUID입니다. |
|
토큰 버전
|
tokenVersion | integer |
토큰 버전 번호입니다. |
|
토큰 형식
|
tokenType | integer |
SharePoint 토큰 유형 번호입니다. |
|
오류
|
error | string |
구문 분석이 실패할 때 오류 세부 정보입니다. |
자세한 항목 경고 HTML 가져오기
SharePoint 스타일 경고 전자 메일용으로 설계되었지만 문서 또는 기타 HTML 지원 대상에서도 사용할 수 있도록 설계된 SharePoint 항목 변경에 사용할 준비가 된 경고 릴레이 HTML을 반환합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
사이트 URL
|
siteUrl | True | string |
목록 또는 라이브러리가 포함된 SharePoint 사이트의 전체 URL입니다. |
|
목록 또는 라이브러리
|
listId | True | string |
SHAREPoint 목록 또는 라이브러리의 GUID 또는 정확한 제목입니다. 드롭다운은 GUID 값을 반환하지만 수동 항목은 GUID 또는 정확한 목록 제목을 사용할 수 있습니다. |
|
아이템 ID
|
itemId | True | integer |
변경 내용을 분석할 SharePoint 항목 또는 파일의 ID입니다. |
|
다음에서 비교
|
triggerWindowStartToken | string |
변경 비교의 시작점을 정의합니다. SharePoint 트리거의 {TriggerWindowStartToken}(권장), '5.0'과 같은 버전 레이블, 원시 SharePoint 변경 토큰 또는 ISO 8601 기준 날짜/날짜/시간(예: '2026-03-30' 또는 '2026-03-30T14:15:00Z')을 수락합니다. 날짜 전용 값은 선택한 표준 시간대에서 자정으로 해석되고, 표준 시간대가 비어 있으면 UTC로 해석됩니다. 바로 이전 버전과 비교하려면 생략합니다. |
|
|
부 버전 포함
|
includeMinorVersions | boolean |
부 버전 또는 초안 버전이 비교에 참여해야 하는지 여부입니다. 기본값은 false입니다. 즉, 주 버전만 사용됩니다. |
|
|
변경되지 않은 필드 포함
|
includeUnchangedFields | boolean |
변경되지 않은 필드를 생성된 HTML에 포함할지 여부입니다. 기본값은 true입니다. |
|
|
날짜 형식
|
dateFormat | string |
DateTime 필드의 사용자 지정 날짜 형식(예: 'yyyy-MM-dd', 'dd/MM/yyyy'). 지정하지 않으면 기본값은 'yyyy-MM-dd'입니다. |
|
|
시간 형식
|
timeFormat | string |
날짜/시간 필드의 날짜에 시간 형식이 추가되었습니다(예: 'HH:mm:ss', 'HH:mm', 'hh:mm tt'). |
|
|
Timezone
|
timezone | string |
날짜/시간 변환에 대한 IANA 표준 시간대 ID(예: 'America/New_York', 'Europe/London', 'Australia/Sydney') |
반품
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
성공
|
success | boolean |
작업이 성공적으로 완료되었는지 여부를 나타냅니다. |
|
Message
|
message | string |
결과를 설명하는 사람이 읽을 수 있는 메시지 |
|
HTML 본문
|
htmlBody | string |
경고 전자 메일 또는 기타 HTML 지원 대상에서 사용할 준비가 된 전체 HTML 본문 |
|
추천 주제
|
subject | string |
경고에 대해 제안된 제목 줄 |
|
항목 제목
|
itemTitle | string |
변경된 항목의 제목 |
|
항목 URL
|
itemUrl | string |
변경된 SharePoint 항목에 대한 직접 링크 |
|
새 항목임
|
isNewItem | boolean |
True이면 기존 항목에 대한 업데이트가 아닌 새 SharePoint 항목 또는 파일에 대한 경고입니다. |
|
오류
|
error | string |
성공이 false인 경우 오류 세부 정보 |
자세한 항목 변경 내용 가져오기
SharePoint 목록 항목 또는 문서에 대한 자세한 형식의 필드 수준 변경 내용을 검색하여 현재 버전을 이전 버전과 비교합니다. 기본 제공 SharePoint 스타일의 true/false 필드 플래그가 아닌 다양한 변경 데이터를 원하는 경우 사용합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
사이트 URL
|
siteUrl | True | string |
목록 또는 라이브러리를 포함하는 SharePoint 사이트의 전체 URL입니다(예: |
|
목록 또는 라이브러리
|
listId | True | string |
SHAREPoint 목록 또는 라이브러리의 GUID 또는 정확한 제목입니다. 드롭다운은 GUID 값을 반환하지만 수동 항목은 GUID 또는 정확한 목록 제목을 사용할 수 있습니다. |
|
아이템 ID
|
itemId | True | integer |
변경 내용을 분석할 SharePoint 항목 또는 파일의 ID입니다(트리거 출력에서 ID로 사용 가능). |
|
다음에서 비교
|
triggerWindowStartToken | string |
변경 비교의 시작점을 정의합니다. SharePoint 트리거의 {TriggerWindowStartToken}(권장), '5.0'과 같은 버전 레이블, 원시 SharePoint 변경 토큰 또는 ISO 8601 기준 날짜/날짜/시간(예: '2026-03-30' 또는 '2026-03-30T14:15:00Z')을 수락합니다. 날짜 전용 값은 선택한 표준 시간대에서 자정으로 해석되고, 표준 시간대가 비어 있으면 UTC로 해석됩니다. 바로 이전 버전과 비교하려면 생략합니다. |
|
|
부 버전 포함
|
includeMinorVersions | boolean |
부 버전 또는 초안 버전이 비교에 참여해야 하는지 여부입니다. 기본값은 false입니다. 즉, 주 버전만 사용됩니다. |
|
|
변경되지 않은 필드 포함
|
includeUnchangedFields | boolean |
변경되지 않은 필드를 응답에 포함할지 여부입니다. 기본값은 true입니다. |
|
|
날짜 형식
|
dateFormat | string |
DateTime 필드의 사용자 지정 날짜 형식(예: 'yyyy-MM-dd', 'dd/MM/yyyy', 'MM/dd/yyyy') 지정하지 않으면 기본값은 'yyyy-MM-dd'입니다. |
|
|
시간 형식
|
timeFormat | string |
날짜/시간 필드의 날짜에 시간 형식이 추가되었습니다(예: 'HH:mm:ss', 'HH:mm', 'hh:mm tt'). 지정하지 않으면 기본값은 'HH:mm:ss'입니다. |
|
|
Timezone
|
timezone | string |
날짜/시간 변환에 대한 IANA 표준 시간대 ID(예: 'America/New_York', 'Europe/London', 'Australia/Sydney') 지정하지 않으면 기본적으로 UTC로 설정됩니다. |
반품
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
성공
|
success | boolean |
작업이 성공적으로 완료되었는지 여부를 나타냅니다. |
|
Message
|
message | string |
결과를 설명하는 사람이 읽을 수 있는 메시지 |
|
변경된 필드
|
changedFields | array of object |
필드를 배열로 추적합니다. |
|
열 값이 변경되었습니다.
|
changedFields.hasChanged | boolean |
이 필드의 값이 이전 버전과 현재 버전 간에 변경된 경우 True입니다. |
|
이전 열 값(텍스트)
|
changedFields.previousAsString | string |
사람이 읽을 수 있는 문자열로 이전 값 서식 지정 |
|
필드 내부 이름
|
changedFields.internalName | string |
내부 SharePoint 필드 이름 |
|
필드 이름
|
changedFields.displayName | string |
필드의 표시 이름 |
|
이전 열 값(상세)
|
changedFields.previous |
원시 이전 값입니다. 이 속성은 동적이며 SharePoint 필드 형식에 따라 문자열, 숫자, 부울, 개체, 배열 또는 null일 수 있습니다. |
|
|
현재 열 값(텍스트)
|
changedFields.currentAsString | string |
사람이 읽을 수 있는 문자열로 서식이 지정된 현재 값 |
|
현재 열 값(상세)
|
changedFields.current |
원시 현재 값입니다. 이 속성은 동적이며 SharePoint 필드 형식에 따라 문자열, 숫자, 부울, 개체, 배열 또는 null일 수 있습니다. |
|
|
비교 기준이 있습니다.
|
hasComparisonBaseline | boolean |
True이면 현재 버전과 비교하기 위해 고유한 기준 버전이 확인되었습니다. |
|
초기 계획 첫 번째 버전인 경우
|
isBaselineFirstVersion | boolean |
True이면 확인된 기준 버전이 항목 또는 파일에 대해 기록된 첫 번째 버전입니다. |
|
현재 버전 레이블
|
currentVersionLabel | string |
현재 버전의 버전 레이블(예: '2.0', '5.0') |
|
이전 버전 레이블
|
previousVersionLabel | string |
비교에 사용되는 버전 레이블(예: '1.0', '4.0') |
|
항목 제목
|
itemTitle | string |
변경된 항목의 제목 |
|
항목 URL
|
itemUrl | string |
변경된 SharePoint 항목에 대한 직접 링크 |
|
수정된 날짜
|
modifiedDate | date-time |
최신 수정의 타임스탬프 |
|
수정한 사람
|
modifiedBy | string |
항목을 마지막으로 수정한 사용자의 표시 이름 |
|
오류
|
error | string |
성공이 false인 경우 오류 세부 정보 |