SharePoint 웹 트리거

SharePoint 웹 트리거를 사용하면 이벤트에 대해 SharePoint 사이트를 모니터링할 수 있습니다. 모니터링된 이벤트가 SharePoint 사이트에서 발생할 때 활성화되는 작업을 구성할 수 있습니다.

개요

SharePoint 웹 트리거를 사용하면 구독된 이벤트를 기반으로 자동화 워크플로를 시작할 수 있습니다. SharePoint 웹 트리거를 구성하여 구독된 이벤트를 수신하도록 설정하십시오. SharePoint 사이트에서 이벤트가 발생하면 트리거가 후속 자동화 워크플로를 활성화합니다. SharePoint 웹 트리거를 사용하면 실시간 데이터 교환을 통해 수동 개입 없이 자동화를 구현할 수 있습니다.

SharePoint 웹 트리거는 수신 데이터의 인증을 위해 OAuth 연결을 사용합니다. SharePoint용 OAuth 연결에 대한 자세한 내용은 OAuth 연결 생성 항목을 참조하십시오.
주: SharePoint 사이트에서 이벤트가 발생한 후 Control Room이 SharePoint 사이트로부터 알림을 받기까지 상당한 지연이 발생합니다. 자세한 내용은 Microsoft Graph REST API Subscription latency의 지연 시간 테이블을 참조하십시오.

지원되는 이벤트

SharePoint 웹 트리거를 구성하여 파일, 폴더 및 목록에서 발생하는 이벤트를 감지할 수 있습니다. SharePoint 웹 트리거는 다음 이벤트를 지원합니다.

이벤트 설명
파일 생성 모니터링 중인 SharePoint 사이트에서 파일이 생성되는 경우.
파일 업데이트 모니터링 중인 SharePoint 사이트에서 파일이 업데이트되는 경우.
폴더 생성 모니터링 중인 SharePoint 사이트에서 폴더가 생성되는 경우.
폴더 업데이트 모니터링 중인 SharePoint 사이트에서 폴더가 생성되는 경우.
목록 항목 생성 모니터링 중인 SharePoint 사이트의 목록에 항목이 추가되는 경우.
목록 항목 업데이트 모니터링 중인 SharePoint 사이트에서 기존 목록 항목이 업데이트되는 경우.

선행조건

다음 선행조건이 충족되었는지 확인하십시오.

  • 봇 제작자 또는 시민 개발자 라이선스.
  • 이벤트 트리거 및 내 Bot 보기 권한.
  • 자동화가 위치한 폴더의 체크인 및 체크아웃 권한.
  • SharePoint 사이트에 대한 활성 OAuth 연결.

설정

SharePoint 웹 트리거에 대해 다음 설정을 사용할 수 있습니다.
SharePoint OAuth
SharePoint OAuth 옵션을 사용하면 구성된 OAuth 연결을 선택할 수 있습니다. Microsoft Graph 권한을 OAuth 연결 범위에 추가했는지 확인하십시오. Microsoft Graph 범위는 트리거가 파일 및 폴더 관련 이벤트에 대해 SharePoint 문서 라이브러리를 읽고, 목록 관련 이벤트에 대해 SharePoint 목록을 읽을 수 있도록 허용합니다.
사이트
사이트 옵션을 사용하면 이벤트를 모니터링하는 SharePoint 사이트를 구성할 수 있습니다. 링크를 직접 입력하거나 사이트 선택 옵션을 사용하여 사이트 드롭다운 목록에서 사이트를 선택할 수 있습니다. 사이트 드롭다운 목록은 SharePoint 사이트에 연결되며 하위 도메인 내의 모든 사이트를 나열합니다.
이벤트 유형
이벤트 유형 옵션을 사용하면 트리거가 이후 자동화 작업을 활성화하는 이벤트를 구성할 수 있습니다. 트리거는 파일 및 폴더 또는 목록을 기준으로 구성할 수 있습니다.
파일 및 폴더 옵션의 이벤트 수신 드롭다운에서 이벤트를 선택하고, 파일 이벤트에서 파일 경로를, 폴더 이벤트에서 폴더 경로를 입력합니다. 상위 폴더 이벤트에서 상위 폴더를 입력했는지 확인하십시오. 예를 들어, SharePoint 문서 폴더 내의 또 다른 폴더인 ABC에 위치한 XYZ 폴더의 폴더 이벤트를 모니터링하려면, Documents/ABC를 입력합니다.
응답
응답 옵션을 사용하면 트리거 응답 데이터를 기록 변수에 저장할 수 있습니다. 응답 데이터를 캡처하려면 기록 변수 생성을 선택하거나 기존 기록 변수를 선택할 수 있습니다. 기록 변수는 API 응답 본문 정보를 키-값 쌍 형식으로 캡처합니다.

감사 로그에서 트리거 응답 데이터 읽기

트리거 응답 데이터에는 변경이 발생한 이벤트들의 모든 정보가 포함되어 있습니다. 이벤트 페이로드 데이터는 Microsoft Graph의 SharePoint API 리소스 속성을 사용하여 생성됩니다. 데이터. 키-값 쌍으로 저장된 데이터를 감사 로그 페이지에서 볼 수 있습니다. SharePoint 이벤트 페이로드 데이터에 대한 자세한 내용은 Working with SharePoint sites in Microsoft Graph 항목을 참조하십시오.

세션 내에서 이후 작업의 입력값으로 감사 로그에 캡처된 이벤트 페이로드 데이터 속성을 사용할 수 있습니다. SharePoint API의 Microsoft Graph에서 API 리소스 유형 속성으로부터 속성에 대한 인수를 빌드할 수도 있습니다. 예를 들어, 파일이 생성된 폴더 경로를 보려면 parentReference.path를 사용할 수 있습니다. 여기서 parentReference는 BaseItem 리소스 속성에서, path는 itemReference 리소스 속성에서 가져온 것입니다.