경고 릴레이(미리 보기)
경고 릴레이는 사용 중지된 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 Software |
| 웹 사이트 | 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
|
Share |
SharePoint 비교 토큰을 디코딩합니다. 버전 번호와 수정된 날짜도 제공되면 항목 또는 파일이 새 버전인지 여부를 결정합니다. 경고 릴레이 청구 가능 작업을 호출하기 전에 흐름 조건에서 이 청구 불가능한 작업을 사용합니다. |
| 경고 HTML로 항목 또는 파일 변경 내용 가져오기 |
SharePoint 항목 변경에 즉시 사용할 수 있는 경고 릴레이 HTML을 반환하며, 주로 경고 전자 메일용으로 설계되었지만 HTML이 지원되는 모든 곳에서도 사용할 수 있습니다. 결과에는 사용자의 중요한 경고 릴레이 평가판, 구독 또는 사용 알림이 포함될 수 있습니다. |
| 자세한 항목 또는 파일 변경 내용 가져오기 |
SharePoint list 항목 또는 파일에 대한 자세한 형식의 필드 수준 변경 내용을 검색하여 현재 버전을 이전 버전과 비교합니다. 기본 제공 SharePoint true/false 변경 표시기뿐만 아니라 풍부한 변경 데이터를 원할 때 사용합니다. 결과에는 사용자의 중요한 경고 릴레이 평가판, 구독 또는 사용 알림이 포함될 수 있습니다. |
| 항목 또는 파일 버전 기록 가져오기 |
SharePoint list 항목 또는 파일에 대해 요청된 버전 수까지 반환합니다( 가장 먼저). 각 버전에는 버전 세부 정보, 열 값, 서식이 지정된 텍스트 값 및 이전 사용 가능한 버전에서 변경된 열을 보여 주는 표시기가 포함됩니다. 이 작업을 구성하는 동안 사이트 및 목록 또는 라이브러리를 선택하여 열을 동적 콘텐츠로 사용할 수 있도록 합니다. 결과에는 사용자의 중요한 경고 릴레이 평가판, 구독 또는 사용 알림이 포함될 수 있습니다. |
SharePoint 버전 정보 구문 분석
SharePoint 비교 토큰을 디코딩합니다. 버전 번호와 수정된 날짜도 제공되면 항목 또는 파일이 새 버전인지 여부를 결정합니다. 경고 릴레이 청구 가능 작업을 호출하기 전에 흐름 조건에서 이 청구 불가능한 작업을 사용합니다.
매개 변수
| 속성 | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
다음에서 비교
|
compareFrom | True | string |
TriggerWindowStartToken 또는 원시 SharePoint 변경 토큰을 디코딩합니다. 버전 레이블 및 ISO 날짜/날짜-시간 값은 이 작업에서 지원되지 않습니다. |
|
버전 번호
|
versionNumber | string |
SharePoint 트리거 또는 작업의 버전 번호(예: 0.1, 1.0 또는 1.5)입니다. 부/초안 버전을 식별하는 데 사용됩니다. |
|
|
수정된 날짜
|
modifiedDate | date-time |
SharePoint 트리거 또는 작업에서 수정된 날짜입니다. 트리거 기간 동안 표시되는 SharePoint 버전이 변경되었는지 여부를 감지하는 데 사용됩니다. |
|
|
부 버전 포함
|
includeMinorVersions | boolean |
부 버전/초안 버전 번호가 새 버전으로 계산되어야 하는지 여부입니다. 기본값은 false입니다. |
|
|
Timezone
|
timezone | string |
'America/New_York', 'Europe/London' 또는 'Australia/Sydney'(IANA 표준 시간대 ID)와 같은 로컬 비교 값에 대한 선택적 표준 시간대입니다. 생략하면 UTC 값만 반환됩니다. |
반품
| 속성 | 경로 | 형식 | Description |
|---|---|---|---|
|
성공
|
success | boolean |
버전 정보가 성공적으로 구문 분석된 경우 True입니다. 유효성 검사 또는 처리에 실패한 경우 false입니다. |
|
Message
|
message | string |
작업 결과를 설명하는 사용자 연결 메시지입니다. 에이전트 및 부조종사는 평가판, 구독, 사용, 경고 또는 버전 처리 정보가 포함된 경우 사용자에게 이 메시지를 표시해야 합니다. |
|
토큰 날짜 시간 UTC
|
tokenDateTimeUTC | date-time |
UTC로 반환된 Compare From 토큰의 날짜 및 시간입니다. |
|
토큰 날짜 시간 로컬
|
tokenDateTimeLocal | date-time |
선택한 표준 시간대로 변환된 비교 토큰의 날짜 및 시간입니다. |
|
디코딩된 토큰
|
decodedToken | string |
원시 SharePoint 디코딩 후 토큰을 변경합니다. Compare From이 이미 원시 토큰인 경우 제공된 값과 일치합니다. |
|
Base64 토큰입니다.
|
isBase64Token | boolean |
들어오는 토큰이 base64로 인코딩된 경우 True입니다. |
|
Sequence
|
sequence | integer |
SharePoint는 토큰에 포함된 시퀀스 값을 변경합니다. |
|
목록 GUID
|
listGuid | uuid |
토큰에 포함된 목록 또는 라이브러리 GUID입니다. |
|
토큰 버전
|
tokenVersion | integer |
토큰 버전 번호입니다. |
|
토큰 형식
|
tokenType | integer |
SharePoint 토큰 유형 번호입니다. |
|
새 버전이 검색됨
|
isNewVersionDetected | boolean |
True이면 제공된 트리거/작업 메타데이터에 표시되는 새 SharePoint 버전이 처리되어야 합니다. 버전을 건너뛰어야 하는 경우 False입니다. 확인할 메타데이터가 충분하지 않은 경우 Null입니다. |
|
부 버전입니다.
|
isMinorVersion | boolean |
제공된 버전 번호가 부 버전/초안 버전인 경우 True입니다. 버전 번호가 제공되지 않은 경우 Null입니다. |
|
첫 번째 부 버전입니다.
|
isFirstMinorVersion | boolean |
제공된 버전 번호가 첫 번째 부/초안 버전(일반적으로 0.1)인 경우 True입니다. 버전 번호가 제공되지 않은 경우 Null입니다. |
|
첫 번째 주 버전입니다.
|
isFirstMajorVersion | boolean |
제공된 버전 번호가 첫 번째 주/게시된 버전(일반적으로 1.0)인 경우 True입니다. 버전 번호가 제공되지 않은 경우 Null입니다. |
|
수정된 날짜 UTC
|
modifiedDateUtc | date-time |
제공된 수정된 날짜가 UTC로 정규화되었습니다. 수정된 날짜가 제공되지 않은 경우 Null입니다. |
|
수정된 날짜 로컬
|
modifiedDateLocal | date-time |
제공된 수정된 날짜는 선택한 표준 시간대로 변환됩니다. 수정된 날짜 또는 표준 시간대가 제공되지 않은 경우 Null입니다. |
|
오류
|
error | string |
성공이 false이면 오류 세부 정보입니다. |
경고 HTML로 항목 또는 파일 변경 내용 가져오기
SharePoint 항목 변경에 즉시 사용할 수 있는 경고 릴레이 HTML을 반환하며, 주로 경고 전자 메일용으로 설계되었지만 HTML이 지원되는 모든 곳에서도 사용할 수 있습니다. 결과에는 사용자의 중요한 경고 릴레이 평가판, 구독 또는 사용 알림이 포함될 수 있습니다.
매개 변수
| 속성 | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
사이트 URL
|
siteUrl | True | string |
SharePoint 사이트를 선택하거나 사이트 URL을 입력합니다. |
|
목록 또는 라이브러리
|
listId | True | string |
목록 또는 라이브러리를 선택하거나 제목 또는 GUID를 입력합니다. |
|
아이템 ID
|
itemId | True | integer |
변경 내용을 분석할 SharePoint 항목 또는 파일의 ID입니다. |
|
다음에서 비교
|
triggerWindowStartToken | string |
비교를 위한 시작점입니다. 사용 가능한 경우 SharePoint 트리거의 TriggerWindowStartToken을 사용합니다. 버전 레이블, 원시 변경 토큰 또는 기준 날짜/시간을 입력할 수도 있습니다. 날짜 전용 값은 선택한 표준 시간대에서 자정을 사용하거나, 표준 시간대가 선택되지 않은 경우 UTC를 사용합니다. 이전 버전과 비교하려면 비워 둡니다. |
|
|
부 버전 포함
|
includeMinorVersions | boolean |
변경 내용을 비교할 때 부 버전 또는 초안 버전을 포함할지 여부입니다. 기본값은 false이므로 주 버전만 비교됩니다. |
|
|
변경되지 않은 필드 포함
|
includeUnchangedFields | boolean |
변경되지 않은 필드를 생성된 HTML에 포함할지 여부입니다. 기본값은 true입니다. |
|
|
날짜 형식
|
dateFormat | string |
DateTime 필드에 사용되는 형식입니다(예: 'yyyy-MM-dd', 'dd/MM/yyyy'). 기본값은 'yyyy-MM-dd'입니다. |
|
|
시간 형식
|
timeFormat | string |
DateTime 필드의 시간 부분에 사용되는 형식입니다(예: HH:mm:ss, HH:mm, hh:mm tt). 기본값은 HH:mm:ss입니다. |
|
|
Timezone
|
timezone | string |
날짜 및 시간(예: 미국/New_York, 유럽/런던, 오스트레일리아/시드니)을 서식 지정할 때 사용되는 표준 시간대입니다. 기본값은 UTC입니다. |
반품
| 속성 | 경로 | 형식 | Description |
|---|---|---|---|
|
성공
|
success | boolean |
작업이 성공적으로 완료되면 True입니다. 유효성 검사 또는 처리에 실패한 경우 false입니다. |
|
Message
|
message | string |
작업 결과를 설명하는 사용자 연결 메시지입니다. 에이전트 및 부조종사는 평가판, 구독, 사용, 경고 또는 버전 처리 정보가 포함된 경우 사용자에게 이 메시지를 표시해야 합니다. |
|
사용자 알림 표시
|
shouldDisplayUserNotice | boolean |
경고 릴레이가 사용자에게 중요한 평가판, 구독 또는 사용 알림을 반환했는지 여부를 나타냅니다. |
|
사용자 알림 코드
|
userNoticeCode | string |
사용자 알림에 대해 컴퓨터에서 읽을 수 있는 안정적인 이유입니다. |
|
사용자 알림 심각도
|
userNoticeSeverity | string |
사용자 알림에 대한 프레젠테이션 심각도: 정보, 경고 또는 위험 |
|
사용자 알림
|
userNotice | string |
경고 릴레이 평가판, 구독 또는 사용량에 대한 중요한 정보입니다. |
|
사용자 알림 작업 호출
|
userNoticeCallToAction | string |
경고 릴레이 웹 사이트 및 지원 전자 메일을 포함하여 사용자가 다음에 수행할 수 있는 작업 |
|
HTML 본문
|
htmlBody | string |
전자 메일 또는 HTML에서 사용할 준비가 된 경고 메시지의 HTML 본문이 지원됩니다. |
|
생성된 경고 주체
|
subject | string |
경고에 대해 제안된 제목 줄 |
|
항목 또는 파일 이름
|
itemTitle | string |
변경된 항목 또는 파일의 제목 또는 파일 이름입니다. |
|
항목 또는 파일 URL
|
itemUrl | string |
변경된 SharePoint 항목 또는 파일에 대한 직접 링크입니다. |
|
새 항목임
|
isNewItem | boolean |
생성된 경고가 추가 또는 변경된 항목 또는 파일을 설명하는지 여부를 결정합니다. |
|
오류
|
error | string |
성공이 false인 경우 오류 세부 정보 |
자세한 항목 또는 파일 변경 내용 가져오기
SharePoint list 항목 또는 파일에 대한 자세한 형식의 필드 수준 변경 내용을 검색하여 현재 버전을 이전 버전과 비교합니다. 기본 제공 SharePoint true/false 변경 표시기뿐만 아니라 풍부한 변경 데이터를 원할 때 사용합니다. 결과에는 사용자의 중요한 경고 릴레이 평가판, 구독 또는 사용 알림이 포함될 수 있습니다.
매개 변수
| 속성 | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
사이트 URL
|
siteUrl | True | string |
SharePoint 사이트를 선택하거나 사이트 URL을 입력합니다. |
|
목록 또는 라이브러리
|
listId | True | string |
목록 또는 라이브러리를 선택하거나 제목 또는 GUID를 입력합니다. |
|
아이템 ID
|
itemId | True | integer |
변경 내용을 분석할 SharePoint 항목 또는 파일의 ID입니다. |
|
다음에서 비교
|
triggerWindowStartToken | string |
비교를 위한 시작점입니다. 사용 가능한 경우 SharePoint 트리거의 TriggerWindowStartToken을 사용합니다. 버전 레이블, 원시 변경 토큰 또는 기준 날짜/시간을 입력할 수도 있습니다. 날짜 전용 값은 선택한 표준 시간대에서 자정을 사용하거나, 표준 시간대가 선택되지 않은 경우 UTC를 사용합니다. 이전 버전과 비교하려면 비워 둡니다. |
|
|
부 버전 포함
|
includeMinorVersions | boolean |
변경 내용을 비교할 때 부 버전 또는 초안 버전을 포함할지 여부입니다. 기본값은 false이므로 주 버전만 비교됩니다. |
|
|
변경되지 않은 필드 포함
|
includeUnchangedFields | boolean |
변경되지 않은 필드를 응답에 포함할지 여부입니다. 기본값은 true입니다. |
|
|
날짜 형식
|
dateFormat | string |
DateTime 필드에 사용되는 형식(예: 'yyyy-MM-dd', 'dd/MM/yyyy', 'MM/dd/yyyy') 기본값은 'yyyy-MM-dd'입니다. |
|
|
시간 형식
|
timeFormat | string |
DateTime 필드의 시간 부분에 사용되는 형식입니다(예: HH:mm:ss, HH:mm, hh:mm tt). 기본값은 HH:mm:ss입니다. |
|
|
Timezone
|
timezone | string |
날짜 및 시간(예: 미국/New_York, 유럽/런던, 오스트레일리아/시드니)을 서식 지정할 때 사용되는 표준 시간대입니다. 기본값은 UTC입니다. |
반품
| 속성 | 경로 | 형식 | Description |
|---|---|---|---|
|
성공
|
success | boolean |
작업이 성공적으로 완료되면 True입니다. 유효성 검사 또는 처리에 실패한 경우 false입니다. |
|
Message
|
message | string |
작업 결과를 설명하는 사용자 연결 메시지입니다. 에이전트 및 부조종사는 평가판, 구독, 사용, 경고 또는 버전 처리 정보가 포함된 경우 사용자에게 이 메시지를 표시해야 합니다. |
|
사용자 알림 표시
|
shouldDisplayUserNotice | boolean |
경고 릴레이가 사용자에게 중요한 평가판, 구독 또는 사용 알림을 반환했는지 여부를 나타냅니다. |
|
사용자 알림 코드
|
userNoticeCode | string |
사용자 알림에 대해 컴퓨터에서 읽을 수 있는 안정적인 이유입니다. |
|
사용자 알림 심각도
|
userNoticeSeverity | string |
사용자 알림에 대한 프레젠테이션 심각도: 정보, 경고 또는 위험 |
|
사용자 알림
|
userNotice | string |
경고 릴레이 평가판, 구독 또는 사용량에 대한 중요한 정보입니다. |
|
사용자 알림 작업 호출
|
userNoticeCallToAction | string |
경고 릴레이 웹 사이트 및 지원 전자 메일을 포함하여 사용자가 다음에 수행할 수 있는 작업 |
|
변경된 필드
|
changedFields | array of object |
각 필드의 이름, 이전 값, 현재 값 및 변경 여부를 포함하여 비교된 SharePoint 필드 목록입니다. |
|
열 값이 변경되었습니다.
|
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이면 확인된 기준 버전이 항목 또는 파일에 대해 기록된 첫 번째 버전입니다. |
|
새 항목임
|
isNewItem | 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인 경우 오류 세부 정보 |
항목 또는 파일 버전 기록 가져오기
SharePoint list 항목 또는 파일에 대해 요청된 버전 수까지 반환합니다( 가장 먼저). 각 버전에는 버전 세부 정보, 열 값, 서식이 지정된 텍스트 값 및 이전 사용 가능한 버전에서 변경된 열을 보여 주는 표시기가 포함됩니다. 이 작업을 구성하는 동안 사이트 및 목록 또는 라이브러리를 선택하여 열을 동적 콘텐츠로 사용할 수 있도록 합니다. 결과에는 사용자의 중요한 경고 릴레이 평가판, 구독 또는 사용 알림이 포함될 수 있습니다.
매개 변수
| 속성 | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
사이트 URL
|
siteUrl | True | string |
SharePoint 사이트를 선택하거나 사이트 URL을 입력합니다. |
|
목록 또는 라이브러리
|
listId | True | string |
흐름에서 버전 열을 동적 콘텐츠로 사용할 수 있어야 하는 목록 또는 라이브러리를 선택합니다. |
|
아이템 ID
|
itemId | True | integer |
항목 ID를 SharePoint list. 예를 들어 SharePoint 트리거 또는 이전 흐름 작업과 같이 런타임에 동적으로 제공할 수 있습니다. |
|
최대 사용량 단위
|
maximumUsageUnits | True | integer |
이 호출에서 사용할 수 있는 사용 단위에 대해 호출자가 선택한 필수 제한입니다. 기본값은 1입니다. 이는 버전 개수 제한이 아닌 청구 가드입니다. 하나의 사용 단위는 여러 전체 버전을 반환할 수 있습니다. 최대 버전을 사용하여 버전 행 수를 제한합니다. |
|
최대 버전
|
maximumVersions | integer |
모든 페이지에서 반환할 전체 버전 행의 최대 총 수입니다. 선택한 범위, 사용 가능한 기록 또는 사용량 단위 예산이 끝날 때까지 계속하려면 비워 둡니다. 각 응답에는 100개 이하의 버전이 포함되어 있습니다. |
|
|
반환할 필드
|
fieldsToReturn | array of string |
각 버전에 포함할 열을 SharePoint. 항목당 하나의 열을 추가합니다. 지원되는 모든 열을 반환하려면 필드를 Return에 비워 둡니다. 더 적은 열을 선택하면 응답 크기 및 사용량 단위 작업을 줄일 수 있습니다. |
|
|
다음에서 비교
|
fromVersion | string |
버전 기록 범위의 시작점입니다. 사용 가능한 경우 SharePoint 트리거의 TriggerWindowStartToken을 사용합니다. 버전 레이블, 원시 변경 토큰 또는 기준 날짜/시간을 입력할 수도 있습니다. 날짜 전용 값은 선택한 표준 시간대에서 자정을 사용하거나, 표준 시간대가 선택되지 않은 경우 UTC를 사용합니다. 이전 경계가 없도록 비워 둡니다. |
|
|
비교
|
toVersion | string |
버전 기록 범위의 끝점입니다. 사용 가능한 경우 SharePoint 트리거의 TriggerWindowEndToken을 사용합니다. 버전 레이블, 원시 변경 토큰 또는 날짜/시간을 입력할 수도 있습니다. 날짜 전용 값은 선택한 표준 시간대에서 자정을 사용하거나, 표준 시간대가 선택되지 않은 경우 UTC를 사용합니다. 새 경계가 없도록 비워 둡니다. |
|
|
페이징 토큰
|
continuationToken | string |
이전 호출에서 반환된 경우 버전 기록의 다음 페이지를 검색하는 데 사용되는 토큰입니다. |
|
|
부 버전 포함
|
includeMinorVersions | boolean |
버전 기록을 검색할 때 부 버전 또는 초안 버전을 포함할지 여부입니다. 기본값은 false이므로 주 버전만 반환됩니다. |
|
|
날짜 형식
|
dateFormat | string |
DateTime 필드에 사용되는 형식(예: 'yyyy-MM-dd', 'dd/MM/yyyy', 'MM/dd/yyyy') 기본값은 'yyyy-MM-dd'입니다. |
|
|
시간 형식
|
timeFormat | string |
DateTime 필드의 시간 부분에 사용되는 형식입니다(예: HH:mm:ss, HH:mm, hh:mm tt). 기본값은 HH:mm:ss입니다. |
|
|
Timezone
|
timezone | string |
날짜 및 시간(예: 미국/New_York, 유럽/런던, 오스트레일리아/시드니)을 서식 지정할 때 사용되는 표준 시간대입니다. 기본값은 UTC입니다. |