Microsoft OneDrive 스포크

스토어에서 앱 요청

사용 가능한 모든 앱을 보고 스토어에 요청을 제출하는 방법에 대한 자세한 내용을 보려면 다음을 ServiceNow Store 방문하십시오. 출시된 모든 앱의 누적 릴리스 정보는 ServiceNow Store 버전 기록 릴리스 정보를 참조하십시오.

통합 허브 구독

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

스포크 버전

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

스포크 종속성

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

ServiceNow 통합 허브 작업 단계 - 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 가져오기	문서의 Sys ID를 입력으로 사용하여 OneDrive에서 파일의 최신 경로를 가져옵니다. 이 하위 플로우를 사용하려면 해당 OneDrive 연결 및 자격 증명을 작성하고 OneDrive 인증 토큰을 사용할 수 있어야 합니다.
Microsoft OneDrive에서 문서 다시 연결	문서 시스템 ID, 제공자 상세 시스템 ID, 대상 테이블 이름, 대상 테이블 시스템 ID 및 문서 이름을 사용하여 Microsoft OneDrive에서 문서의 최신 웹 URL 및 웹 사이트 URL을 가져옵니다. 이 하위 플로우를 사용하려면 해당 OneDrive 연결 및 자격 증명을 작성하고 OneDrive 인증 토큰을 사용할 수 있어야 합니다.

스포크 작업

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


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

사용 가능한 AI 에이전트

사용 가능한 AI 에이전트를 통합 허브 설치 Now Assist 하고 사용합니다. 자세한 내용은 통합 허브에 대한 Now Assist 문서를 참조하십시오.

이 스포크는 인간과 유사한 인텔리전스를 모방하여 인스턴스에서 작업을 ServiceNow 수행하는 독립 실행형 AI 에이전트를 제공합니다.

ServiceNow 에이전트 시스템에서는 목표를 실행하기 위한 하나 이상의 독립 실행형 AI 에이전트와 함께 대규모 언어 모델(LLM) 지침 세트로 구성된 에이전트 워크플로우를 생성할 수 있습니다. 요구 사항에 따라 에이전트 워크플로우를 생성하고 필요한 트리거를 제공하기 위해 AI 에이전트를 추가하는 방법에 대한 자세한 내용은 을 참조하십시오 .
사용 가능한 다른 AI 에이전트를 검색하고 에이전트 워크플로우에 추가할 수도 있습니다. 자세한 내용은 Find AI agents 문서를 참조하십시오.
필요한 스포크 AI 에이전트의 클론을 생성하고 요구 사항에 따라 사용자 지정할 수 있습니다. 클론 생성에 대한 자세한 내용은 을 참조하십시오 .
AI 에이전트에 대한 자세한 내용은 을 참조하십시오 .

사용 가능한 AI 에이전트는 다음과 같습니다.


AI 에이전트	설명
Microsoft OneDrive 공유 관리 AI 에이전트	에서 공동 작업자를 추가 또는 제거하고 파일 또는 폴더에 Microsoft OneDrive대한 권한을 관리합니다. 또한 파일 또는 폴더와 연결된 모든 공동 작업자 상세 정보를 나열합니다.
Microsoft OneDrive 드라이브 관리 AI 에이전트	에서 Microsoft OneDrive특정 드라이브의 메타데이터를 검색합니다.
Microsoft OneDrive 파일 관리 AI 에이전트	에서 Microsoft OneDrive파일, 파일 버전 및 첨부 파일을 관리합니다. 또한 필요한 파일의 상세 정보를 검색합니다.
Microsoft OneDrive 폴더 관리 AI 에이전트	의 Microsoft OneDrive폴더를 관리합니다.
Microsoft OneDrive 권한 관리 AI 에이전트	드라이브 항목에 대한 공유 링크를 작성하고 권한을 관리합니다.

애플리케이션과 함께 Now Assist 설치된 AI 에이전트 중에 에이전틱 워크플로우에 사용되지 않을 수 있습니다. 사용할 수 있는 모든 에이전트를 보는 방법을 알아보려면 AI 에이전트 찾기를 참조하세요.

주:

AI 에이전트를 실행하는 사용자에게 AI 에이전트와 연결된 테이블의 데이터에 액세스하거나 데이터에 대한 작업을 수행하는 데 필요한 역할과 권한이 있는지 확인합니다.

스포크 모듈

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

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


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

OneDrive Online 계정 요구 사항

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

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

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

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

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

MID 서버 요구 사항

이러한 작업은 인스턴스에서 실행하거나 선택적으로 MID 서버. Microsoft OneDrive 별칭과 연결된 연결 기록을 사용하여 작업이 실행되는 위치를 구성하고 필요한 경우 선택 속성을 지정합니다 MID 서버 . 자세한 내용은 MID 서버를 참조하십시오.

이 스포크에 대해 설정 MID 서버 하려면 다음 문서를 참조하십시오 MID 서버 스포크 설정.