SharePoint 패키지
- 최종 업데이트2025/01/13
SharePoint 패키지
SharePoint 패키지에는 문서, 사이트 및 데이터 관리를 위한 SharePoint 작업을 자동화할 수 있도록 하는 작업과 웹 트리거가 포함되어 있습니다.
개요
SharePoint 트리거에 대한 자세한 내용은 SharePoint 웹 트리거 항목을 참조하십시오.
SharePoint 패키지는 인증을 위해 OAuth 연결을 사용합니다. 자동화에서 CRUD 작업을 진행하기 전에 인증 작업을 사용하여 인증을 완료해야 합니다. OAuth 연결 설정에 대한 자세한 내용은 OAuth 연결 생성 항목을 참조하십시오.
SharePoint 워크플로
SharePoint 마크 및 로고는 Microsoft의 상표 또는 등록 상표이며 식별 목적으로만 사용됩니다.
SharePoint 앱 권한
SharePoint 패키지는 앱 기반 권한을 사용하여 특정 SharePoint 도메인에 연결합니다. SharePoint 도메인을 구성하고 관련 앱 권한을 추가해야 합니다. SharePoint 앱 권한에 대한 자세한 내용은 SharePoint 도메인 및 사이트 구성을 참조하십시오.
SharePoint 패키지에서의 작업
다음은 SharePoint 패키지에서 사용할 수 있는 작업입니다.
| 작업 | 설명 |
|---|---|
| SharePoint 인증 작업 | 인증 작업을 사용하여 SharePoint 도메인에 연결합니다. 인증이 완료되면 다른 명령 작업을 사용하여 SharePoint에서 다양한 작업을 수행할 수 있습니다. |
| SharePoint 폴더 및 파일 |
폴더 및 파일 작업을 사용하여 SharePoint 사이트에서 다양한 파일 및 폴더 관련 작업을 수행합니다. 특정 SharePoint 사이트에서 폴더 생성, 세부 정보 가져오기, 삭제 또는 이름 변경을 수행할 수 있습니다. 또한 지정된 폴더에서 파일 업로드, 삭제, 다운로드 및 가져오기를 수행할 수 있습니다. SharePoint 패키지는 파일 스트리밍을 지원합니다. 파일 할당 작업을 사용하여 SharePoint 파일의 파일 스트림을 저장하는 파일 변수를 생성할 수 있습니다. 그런 다음 이 파일 변수를 파일 스트림을 지원하는 모든 작업에서 사용할 수 있습니다. 파일 업로드, 목록 이미지 업로드, 그리고 목록 첨부파일 업로드 작업은 이제 입력값으로 파일 스트림을 포함하는 파일 변수를 허용합니다. 파일 스트림 지원에 대한 자세한 내용은 파일 변수를 활용한 파일 스트리밍 항목을 참조하십시오. |
| SharePoint 목록 및 목록 아이템 | 목록 및 목록 아이템 작업을 사용하여 SharePoint 사이트에서 다양한 목록 관련 작업을 수행합니다. 특정 SharePoint 사이트에서 목록 및 목록 아이템을 생성, 가져오기, 삭제 또는 업데이트할 수 있습니다. |
지원되는 API
SharePoint 패키지는 SharePoint REST v1 API와 SharePoint REST API v2(Microsoft Graph API 기반)를 모두 지원합니다.
사용하려는 API 버전에 따라 OAuth 연결 범위를 구성해야 합니다. SharePoint REST v1 API의 경우, 기타 필요한 권한과 함께 https://<tenant-id>/.default를 사용합니다. SharePoint REST v2 API의 경우, 기타 필요한 권한과 함께 https://graph.microsoft.com/.default를 사용합니다.
다음 작업은 Microsoft Graph API 기반 작업을 지원하지 않습니다.
- 목록 이미지 업로드
- 목록 첨부 파일 삭제
- 목록 첨부 파일 다운로드
- 목록 첨부 파일 업로드
다음 작업은 Microsoft Graph API 기반 작업에 대한 제한이 있습니다.
- 목록 아이템 삭제 - 이 작업은 이미지 삭제 옵션을 지원하지 않습니다.
- 목록 아이템 가져오기 - 이 작업은 이미지 열 다운로드 옵션을 지원하지 않습니다.
- 목록 아이템 생성 및 목록 아이템 업데이트 작업 - 이 작업들은 그림이 포함된 서식 있는 텍스트 옵션이 설정된 여러 줄 텍스트, 조회, 하이퍼링크, 이미지, 위치, 계산 값이 포함된 통화, 사람 또는 그룹, 그리고 관리되는 메타데이터와 같은 열 유형을 지원하지 않습니다.
문제해결
SharePoint 작업과 관련하여 문제가 발생할 경우 적절한 문제 해결 단계를 수행합니다.
- 권한 확인
- 사용자 권한을 다시 한 번 확인하여 Control Room에서 SharePoint 작업에 필요한 액세스 권한이 있는지 확인하십시오. 권한에 대한 자세한 정보는 SharePoint 도메인 및 사이트 구성을 참조하십시오.
- API 클라이언트 테스트
- Postman과 같은 API 클라이언트를 사용하여 작업을 테스트해 보십시오. 그러면 문제의 원인을 Control Room 환경이나 특정 구성으로 좁힐 수 있습니다. Postman에서 문제가 없다면 Control Room에 문제가 있을 가능성이 있습니다.
- 오류 세부 정보
- 그래도 문제가 계속 발생할 경우 전체 오류 메시지를 공유해 주시면 문제를 진단하는 데 큰 도움이 됩니다. SharePoint 패키지 버전, 배포 유형, 앱 생성 프로세스와 같은 추가 세부 정보도 중요한 정보가 될 수 있습니다.