Microsoft OneDrive 스포크

스토어에서 앱 요청

ServiceNow Store 웹 사이트를 방문하면 사용 가능한 모든 앱을 확인하고 스토어에 요청을 제출하는 방법에 대한 정보를 참조할 수 있습니다. 출시된 모든 앱의 누적 릴리스 정보는 ServiceNow Store 버전 기록 릴리스 정보를 참조하십시오.

Integration Hub 구독

이 스포크는 Integration Hub 구독이 필요합니다. 자세한 내용은 법무 일정 - 통합 허브 개요를 참조하십시오.

스포크 버전

Microsoft OneDrive 스포크 v2.3.2 가 최신 버전입니다.

스포크 종속성

앱을 설치하는 데 문제가 있는 경우 다음 종속 플러그인이 설치되어 있는지 확인합니다.

ServiceNow IntegrationHub Action Step - REST (com.glide.hub.action_step.rest)
ServiceNow 통합 허브 런타임(com.glide.hub.integration.runtime)

주:

이러한 플러그인 중 일부는 라이센스 가능 기능이며, 스포크 구현 외부에서 사용되는 경우 적절한 라이센스가 필요합니다. 라이센스에 대한 자세한 내용은 계정 관리자에게 문의하십시오.

지원되는 버전

API 버전 v1.

스포크 플로우

Microsoft OneDrive 스포크 작업 자동화를 시연하기 위해 초안 상태의 샘플 플로우를 Microsoft OneDrive 제공합니다. 샘플 플로우를 사용자 지정하려면 새 애플리케이션 범위에 복사합니다. 사용 가능한 샘플 플로우는 다음과 같습니다.


플로우	설명
구독 갱신	구독 만료 날짜를 업데이트하여 만료된 구독을 갱신합니다.

스포크 하위 플로우

Microsoft OneDrive 스포크 작업 자동화를 시연하기 위해 초안 상태의 샘플 하위 플로우를 Microsoft OneDrive 제공합니다. 샘플 하위 플로우를 사용자 지정하려면 새 애플리케이션 범위에 복사합니다. 사용 가능한 샘플 하위 플로우는 다음과 같습니다.


하위 플로우	설명
ServiceNow에 새 OneDrive 파일 다운로드	자원에 업로드된 새 파일을 ServiceNow 기록에 다운로드합니다.
웹후크 구독	데이터가 변경되는 경우 수신기 애플리케이션을 구독하여 알림을 수신합니다.
변경 내용 동기화	드라이브 및 드라이브의 시간 경과에 따른 변경 사항을 추적합니다.
문서 최신 URL 가져오기	문서의 시스템 ID를 입력으로 사용하여 OneDrive에서 파일의 최신 경로를 가져옵니다. 이 하위 플로우를 사용하려면 해당 OneDrive 연결 및 자격 증명을 작성하고 OneDrive 인증 토큰을 사용할 수 있어야 합니다.
Microsoft OneDrive에서 문서 다시 연결	문서 시스템 ID, 제공자 상세 시스템 ID, 대상 테이블 이름, 대상 테이블 시스템 ID 및 문서 이름을 사용하여 Microsoft OneDrive에서 문서의 최신 웹 URL 및 webdav URL을 가져옵니다. 이 하위 플로우를 사용하려면 해당 OneDrive 연결 및 자격 증명을 작성하고 OneDrive 인증 토큰을 사용할 수 있어야 합니다.

스포크 작업

Microsoft OneDrive 스포크 에서 이벤트가 발생할 ServiceNow때 작업을 자동화 Microsoft OneDrive 하는 작업을 제공합니다. 사용 가능한 작업은 다음과 같습니다.


범주	작업	설명
드라이브 관리	드라이브 정보 조회	특정 Microsoft OneDrive 드라이브의 메타데이터를 가져옵니다.
폴더 관리	파일 또는 폴더 항목 이동	파일 또는 폴더를 Microsoft OneDrive 대상 위치로 이동합니다.
	폴더 작성	에 Microsoft OneDrive폴더를 만듭니다.
	파일 또는 폴더 이름 업데이트	ID로 파일 또는 폴더 항목의 이름을 업데이트합니다.
	파일 또는 폴더 항목 삭제	에서 Microsoft OneDrive파일 또는 폴더를 삭제합니다.
파일 관리	파일에서 확인	드라이브 항목을 체크인하고 공유 초대를 보냅니다. 파일을 체크 인하면 다른 사용자가 체크 인된 파일에 액세스할 수 있습니다.
	파일 체크 아웃	OneDrive에서 드라이브 항목을 체크 아웃합니다. 드라이브 항목을 체크 아웃하면 다른 사용자가 문서를 편집할 수 없습니다. 또한 문서를 체크 인할 때까지 다른 사용자는 문서의 변경 내용을 볼 수 없습니다.
	OneDrive 파일을 첨부 파일에 복사	기록의 첨부 파일 기록에 ServiceNow 있는 파일을 Microsoft OneDrive 복사합니다.
	첨부 파일을 OneDrive에 복사	첨부 파일 기록을 ServiceNow 다음으로 복사합니다. Microsoft OneDrive
	파일 또는 폴더 항목 복사	새로운 상위 항목 아래에 또는 새 이름을 사용하여 항목의 Microsoft OneDrive 사본(하위 항목 포함)을 비동기식으로 작성합니다.
	항목 조회	경로에서 드라이브 항목 목록 또는 드라이브 항목의 소스 및 소스 ID를 조회합니다.
	ID로 파일 또는 폴더 항목 조회	의 Microsoft OneDrive파일 또는 폴더 ID에서 파일 메타데이터 정보를 가져옵니다.
	경로로 파일 또는 폴더 항목 정보 검색	의 Microsoft OneDrive파일 경로에서 파일 메타데이터 정보를 가져옵니다.
	경로를 사용해 첨부 파일을 OneDrive에 복사	ServiceNow의 첨부 파일 기록을 OneDrive에 복사합니다.
	파일 경로를 사용해서 OneDrive 파일을 첨부 파일에 복사	경로를 사용하여 OneDrive의 파일을 ServiceNow의 첨부 파일 기록에 복사합니다.
	OneDrive 파일 버전을 첨부 파일에 복사	OneDrive의 파일을 ServiceNow의 첨부 파일 기록에 복사합니다.
	파일의 버전 삭제	OneDrive에서 지정된 버전의 파일을 삭제합니다.
	파일의 모든 버전 조회	OneDrive에 있는 모든 버전의 파일을 조회합니다.
	파일 버전 재개	지정된 파일 버전을 복원하고 이 버전을 최신 버전으로 만듭니다.
	파일 업로드 및 교체	기존 파일의 업데이트된 버전을 업로드하거나 기존 파일을 새 파일로 대체합니다. 주: 파일의 최대 크기는 4MB를 초과할 수 없습니다.
문서 검색	파일 또는 폴더 항목 검색	항목 이름과 같은 메타데이터 속성을 기반으로 드라이브 항목(파일 또는 폴더)을 조회합니다.
문서 공유	공동 작업자 추가	공동 작업자와 해당 권한을 파일 또는 폴더에 추가합니다. Azure AD 별칭 또는 개체 ID로 공동 작업자를 식별할 수 있습니다.
	공동 작업자 조회	에서 파일 또는 폴더와 관련된 모든 공동 작업자 상세 정보를 나열합니다 Microsoft OneDrive.
	공동 작업자 제거	의 Microsoft OneDrive파일이나 폴더에서 공동 작업자를 제거합니다.
권한 관리	권한 추가	드라이브 항목에 대한 공유 초대를 보냅니다. 공유 초대를 사용하면 수신자가 드라이브 항목에 액세스할 수 있으며 선택적으로 공유 링크가 있는 이메일을 보낼 수 있습니다.
	공유 중인 링크 작성	다른 사용자와 드라이브 항목을 공유할 수 있는 공유 링크를 만듭니다.
	권한 삭제	드라이브 항목에 대한 액세스를 제거합니다.
	권한 조회	드라이브 항목의 공유 권한을 조회합니다.
	권한 업데이트	구독 만료 날짜를 업데이트합니다.
웹후크 관리	웹후크 구독	데이터가 변경될 때 알림을 보내는 구독을 작성합니다.
	웹후크 구독 취소	지정된 구독 ID를 삭제합니다.
	구독에 대한 SyncToken 가져오기	지정된 구독 ID에 대한 최신 동기화 토큰을 조회합니다.
	구독 조회	활성 구독의 목록을 조회합니다.
	구독 갱신	구독 만료 날짜를 업데이트합니다.
	변경 내용 동기화	드라이브 및 드라이브의 시간 경과에 따른 변경 사항을 추적합니다.

스포크 모듈

필요한 이벤트에 대한 알림을 받도록 양방향 웹후크를 설정할 수 있습니다. 라우팅 정책은 ServiceNow 앱에 알리기 위해 충족되어야 하는 조건을 정의합니다. 이러한 조건은 알림을 받으려는 OneDrive의 이벤트를 기반으로 합니다. 조건이 충족되면 라우팅 정책이 연결된 하위 플로우를 트리거하여 OneDrive 작업을 자동화합니다.

양방향 웹후크는 별도의 설정이 필요하며 스포크 작업을 사용하지 않고 독립적으로 사용할 수 있습니다. 기본적으로 OneDrive 웹후크 애플리케이션은 OneDrive 스포크에서 사용할 수 있으며 다음 모듈이 있습니다.


모듈	설명
OneDrive SyncToken	OneDrive의 SyncToken을 볼 수 있습니다.
OneDrive Webhook 레지스트리	ServiceNow에서 OneDrive 웹후크를 생성하고 볼 수 있습니다.
OneDrive Webhook 라우팅 정책	ServiceNow에서 OneDrive 웹후크에 대한 라우팅 정책을 만들고 볼 수 있습니다. 요구 사항에 따라 라우팅 정책의 조건을 사용자 지정할 수도 있습니다.

OneDrive Online 계정 요구 사항

Microsoft OneDrive 스포크 Microsoft Azure에서 만든 사용자 지정 앱이 필요합니다.

연결 및 자격 증명 별칭 요구 사항

Integration Hub는 별칭을 사용하여 연결 및 자격 증명 정보와 OAuth 자격 증명을 관리합니다. 별칭을 사용하면 여러 환경을 사용할 때 여러 자격 증명과 연결 정보 프로파일을 구성하지 않아도 됩니다. 연결 또는 자격 증명 정보가 변경되면 연결을 사용하는 작업을 업데이트할 필요가 없습니다.

단일 테넌트: OneDrive 스포크에는 Microsoft OneDrive에서 작업을 승인하기 위한 OneDrive 별칭 기록이 포함되어 있습니다. 테넌트 기록에서 이 별칭을 선택하여 단일 테넌트에 대한 변경 Microsoft OneDrive 을 승인합니다.

스포크 설정에 대한 자세한 내용은 다음을 참조하십시오. Microsoft OneDrive 스포크 설정.

MID 서버 요구 사항

이러한 작업은 인스턴스에서 실행할 수 있는 REST 호출 또는 MID 서버. Microsoft OneDrive 별칭과 관련된 연결 기록을 사용하여 작업이 실행되는 위치를 구성하고 선택 속성을 설정합니다 MID 서버 . 자세한 내용은 MID 서버를 참조하십시오.