경고 릴레이(미리 보기)
경고 릴레이는 사용 중지된 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 |
| 카테고리 | 합작; 생산력 |
경고 릴레이
Power Platform 및 Microsoft 365 Copilot 대한 경고 릴레이
경고 릴레이를 사용하면 조직이 클래식 SharePoint 경고를 최신 Power Automate 및 Copilot Studio 솔루션으로 대체할 수 있습니다. SharePoint 항목, 파일 및 페이지를 이전 버전과 비교하고, 제조업체가 복잡한 SharePoint 버전 비교 논리를 빌드할 필요 없이 구조화된 변경 정보, 버전 기록 및 즉시 사용할 수 있는 알림 콘텐츠를 반환합니다.
개요
SharePoint 트리거는 항목, 파일 또는 페이지가 변경되었음을 식별할 수 있지만 이전 값과 현재 값을 완전히 비교하지는 않습니다.
이러한 비교를 구축하려면 제조업체가 버전을 검색하고, 변경 토큰을 해석하고, 필드를 비교하고, 알림 또는 다운스트림 처리에 대한 결과의 형식을 지정해야 하는 경우가 많습니다.
경고 릴레이는 Power Automate 및 Copilot Studio 재사용 가능한 작업을 통해 작동하는 중앙 집중식입니다.
주요 기능
경고 릴레이는 다음을 수행할 수 있는 재사용 가능한 작업을 통해 작동하는 중앙 집중식입니다.
- 자세한 필드 수준 변경 식별
- 이전 및 현재 필드 값 반환
- SharePoint 경고 전자 메일에 사용할 준비가 된 HTML 생성
- 항목, 파일 및 페이지 버전 기록 검색
- 트리거 토큰, 변경 토큰, 버전 레이블 또는 날짜와 비교
- 지원되는 복합 SharePoint 필드 형식 서식
- Power Automate 및 Microsoft 365 Copilot 대한 구조적 정보를 반환합니다.
Alert Relay는 SharePoint 목록, 문서 라이브러리 및 사이트 페이지 라이브러리를 지원합니다.
시작하기
일반적인 SharePoint 경고 흐름에는 다음이 포함됩니다.
- 항목이 만들어지거나 수정되는 경우와 같은 SharePoint 트리거입니다.
- 경고 릴레이 작업(예: 항목 가져오기 또는 파일 변경 내용을 경고 HTML로).
- 반환된 제목 및 HTML 본문을 사용하는 전자 메일 또는 다른 알림 작업입니다.
조건, 사용자 지정 서식 지정 또는 Microsoft Copilot Studio 에이전트 시나리오의 경우 자세한 항목 또는 파일 변경 내용 가져오기를 사용하고 반환하는 구조화된 변경 정보를 사용합니다.
기록 SharePoint 버전의 경우 항목 가져오기 또는 파일 버전 기록을 사용합니다.
Documentation
설명서, 작업 참조 정보, 예제 및 시작 지침은 다음에서 사용할 수 있습니다.
비디오 자습서
단계별 연습, 예제 및 방법 비디오는 경고 릴레이 YouTube 채널에서 사용할 수 있습니다.
라이선스 및 평가판
경고 릴레이 라이선스는 테넌트 전체입니다. 단일 평가판 또는 구독은 Microsoft Entra 테넌트에 적용되며 해당 사용량 단위는 경고 릴레이 흐름 및 해당 테넌트에서 사용자가 공유합니다.
90일 평가판은 모든 경고 릴레이 작업이 테넌트에서 처음 실행되고 평가판에서 공유되는 300개의 사용 단위를 포함할 때 자동으로 시작됩니다. 현재 계획 및 자세한 내용은 Alert Relay 가격 책정 및 라이선스를 참조하세요.
활동
자세한 항목 또는 파일 변경 내용 가져오기
SharePoint 항목, 파일 또는 페이지의 현재 버전과 이전 버전 간의 자세한 필드 수준 변경 내용을 반환합니다.
이 작업은 이전 값과 현재 값, 형식이 지정된 값 및 비교 메타데이터를 포함한 구조화된 정보를 반환합니다. 흐름 또는 Microsoft Copilot Studio 에이전트가 개별 변경 내용을 검사, 요약 또는 조치를 취해야 하는 경우 사용합니다.
경고 HTML로 항목 또는 파일 변경 내용 가져오기
SharePoint 항목, 파일 또는 페이지에서 변경된 내용을 보여 주는 즉시 사용할 수 있는 HTML을 생성합니다.
또한 이 작업은 제안된 전자 메일 제목, 항목 제목 및 항목 링크도 반환합니다. 모든 흐름에서 복잡한 HTML 및 버전 비교 식을 작성하지 않고도 더 풍부한 SharePoint 경고 이메일을 만드는 데 사용합니다.
항목 또는 파일 버전 기록 가져오기
SharePoint 항목, 파일 또는 페이지에 대한 바인딩된 페이지 가능 버전 기록을 반환합니다.
이 작업은 선택한 SharePoint 필드를 반환할 수 있으며 버전, 날짜 및 SharePoint 트리거 토큰 경계를 지원합니다. 기록 검토, 감사, 보고, 승인 및 버전 인식 워크플로 시나리오에 사용합니다.
SharePoint 버전 정보 구문 분석
트리거 창 및 변경 토큰 정보를 SharePoint 디코딩합니다.
이 작업을 사용하여 토큰 타임스탬프를 검색하고, 날짜 또는 버전 기반 결정을 적용하고, 자세한 변경 작업을 호출하기 전에 원치 않는 부 버전 또는 초안 버전 트리거를 필터링합니다.
일반적인 사용
경고 릴레이를 사용하면 다음을 수행할 수 있습니다.
- 클래식 SharePoint 경고를 Power Automate 흐름으로 바꾸기
- 변경된 내용을 정확하게 보여 주는 형식이 지정된 알림 보내기
- 중요 비즈니스 필드의 이전 값과 현재 값 비교
- 문서 메타데이터 및 SharePoint 페이지의 변경 내용 추적
- SharePoint 항목 및 파일 버전 기록 검색
- 승인 빌드, 검토, 거버넌스 및 감사 워크플로
- Microsoft 365 Copilot 구조화된 SharePoint 변경 정보 제공
인증 및 액세스
경고 릴레이는 Microsoft Entra ID 위임된 인증을 사용합니다.
SharePoint 액세스는 로그인한 사용자의 컨텍스트에서 수행됩니다. 경고 릴레이는 사용자에게 추가 SharePoint 권한을 부여하지 않으므로 사용자는 이미 관련 SharePoint 사이트, 목록, 라이브러리, 항목 또는 파일에 액세스할 수 있어야 합니다.
요구 사항 및 지원되는 범위
- Alert Relay는 SharePoint Online을 지원합니다. SharePoint Server 온-프레미스는 지원되지 않습니다.
- 작업은 Power Automate 또는 다른 지원되는 클라이언트에서 호출할 때 실행됩니다. 변경 알림의 경우 적절한 SharePoint 트리거를 사용하여 흐름을 시작합니다.
- SharePoint 트리거 토큰을 사용한 비교는 SharePoint 트리거 창을 기반으로 합니다. 결과 기준은 항목별 버전 경계와 다를 수 있습니다.
- 자세한 서식은 지원되는 SharePoint 필드 형식에 사용할 수 있습니다. 현재 필드 형식 참조에 대한 경고 릴레이 설명서를 참조하세요.
Support
웹 사이트: https://independnet.com.au/alert-relay/
고객 지원: https://independnet.com.au/alert-relay/support
이메일: support@alertrelay.com.au
개인 정보 취급 방침: https://independnet.com.au/alert-relay/privacy
연결을 만드는 중
커넥터는 다음 인증 유형을 지원합니다.
| 기본값 | 연결을 만들기 위한 매개 변수입니다. | 모든 지역 | 공유할 수 없음 |
기본값
적용 가능: 모든 지역
연결을 만들기 위한 매개 변수입니다.
공유 가능한 연결이 아닙니다. 전원 앱이 다른 사용자와 공유되면 다른 사용자에게 새 연결을 명시적으로 만들라는 메시지가 표시됩니다.
제한 한도
| 속성 | 호출 | 갱신 기간 |
|---|---|---|
| 연결당 API 호출 | 100 | 60초 |
actions
| 비교 구문 분석 |
TriggerWindowStartToken 또는 원시 SharePoint 변경 토큰을 디코딩하고 흐름 조건 및 기준 결정에 대한 포함된 타임스탬프를 반환합니다. 이 작업은 SharePoint를 호출하지 않습니다. |
| 자세한 항목 경고 HTML 가져오기 |
SharePoint 스타일 경고 전자 메일용으로 설계되었지만 문서 또는 기타 HTML 지원 대상에서도 사용할 수 있도록 설계된 SharePoint 항목 변경에 사용할 준비가 된 경고 릴레이 HTML을 반환합니다. |
| 자세한 항목 변경 내용 가져오기 |
SharePoint 목록 항목 또는 문서에 대한 자세한 형식의 필드 수준 변경 내용을 검색하여 현재 버전을 이전 버전과 비교합니다. 기본 제공 SharePoint 스타일의 true/false 필드 플래그가 아닌 다양한 변경 데이터를 원하는 경우 사용합니다. |
비교 구문 분석
TriggerWindowStartToken 또는 원시 SharePoint 변경 토큰을 디코딩하고 흐름 조건 및 기준 결정에 대한 포함된 타임스탬프를 반환합니다. 이 작업은 SharePoint를 호출하지 않습니다.
매개 변수
| 속성 | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
다음에서 비교
|
compareFrom | True | string |
TriggerWindowStartToken 또는 원시 SharePoint 변경 토큰을 디코딩합니다. 버전 레이블 및 ISO 날짜/날짜-시간 값은 이 작업에서 지원되지 않습니다. |
|
Timezone
|
timezone | string |
로컬 비교 값(예: 'America/New_York', 'Europe/London', 'Australia/Sydney')에 대한 선택적 IANA 표준 시간대 ID입니다. 생략하면 UTC 값만 반환됩니다. |
반품
| 속성 | 경로 | 형식 | 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을 반환합니다.
매개 변수
| 속성 | 키 | 필수 | 형식 | 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') |
반품
| 속성 | 경로 | 형식 | 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 필드 플래그가 아닌 다양한 변경 데이터를 원하는 경우 사용합니다.
매개 변수
| 속성 | 키 | 필수 | 형식 | 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로 설정됩니다. |
반품
| 속성 | 경로 | 형식 | 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인 경우 오류 세부 정보 |