Box 스포크

스토어에서 앱 요청

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

Integration Hub 구독

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

스포크 버전

Box 스포크 v3.2.2 가 최신 버전입니다.

지원되는 버전

API 버전 v2.

스포크 요구 사항

인스턴스와 Box 계정에서 동일한 언어가 선택 ServiceNow 되어 있는지 확인합니다.

인스턴스 ServiceNow 에서 다음으로 이동하여 필요한 언어를 선택합니다. 사용자 프로파일 > 기본 설정 > 표시.
Box 계정에서 다음으로 이동하여 필요한 언어를 선택합니다. 계정 설정 > 계정 > 일반 옵션.

스포크 플로우

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


플로우	설명
작성 시 첨부 파일을 Box로 이동	새 첨부 파일 기록이 추가될 때 첨부 파일을 Box에서 ServiceNow Box로 이동합니다. Box에서 이동된 첨부 파일에 대한 공유 링크로 트리거 기록을 업데이트합니다.
사용자 온보딩	Box 사용자 그룹에서 사용자를 작성 ServiceNow 하면 Box에서 사용자를 작성합니다.

스포크 작업

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


범주	작업	설명
문서 관리	파일에 메타데이터 추가	특정 파일 또는 폴더에 대한 사용자 지정 데이터를 지정합니다.
	기록에 상자 파일 첨부	Box에서 파일을 복사하여 지정된 ServiceNow 기록에 첨부합니다.
	조회 파일 ID	Box에서 지정된 파일의 ID를 검색합니다.
	소유 항목 이동	Box에서 지정된 사용자가 소유한 모든 항목을 지정된 폴더로 이동합니다.
	파일 제거	Box에서 지정된 파일을 제거합니다.
	콘텐츠 스트림 검색	사용자의 콘텐츠 또는 전체 엔터프라이즈에서 파일, 폴더, 웹 링크, 공유 파일을 조회합니다.
	파일 업로드	지정된 파일을 Box에 업로드합니다.
문서 공유	공동 작업자 추가	사용자 또는 그룹에 특정 파일이나 폴더에 대한 지정된 수준의 액세스 권한을 부여합니다. 공동 작업자는 다음 액세스 수준 중 하나를 갖습니다. 공동 소유자 편집기 미리 보기 업로더 미리 보기 업로더 뷰어 뷰어 업로더
	공유된 링크 작성	Box에서 파일 또는 폴더에 대한 직접 읽기 전용 링크를 만듭니다.
	ID로 폴더 공동 작업자 조회	지정된 폴더 ID에 연결된 모든 공동 작업자를 검색합니다.
	공동 작업자 제거	Box의 파일 또는 폴더에서 지정된 공동 작업을 제거합니다.
폴더 관리	폴더 작성	지정된 Box 사용자 계정을 대신하여 Box에 폴더를 만듭니다.
	폴더 삭제	Box에서 지정된 폴더를 삭제합니다.
	폴더 ID 조회	Box에서 지정된 폴더의 ID를 검색합니다. 주: Box에 추가된 항목에 액세스할 수 되려면 10분이 필요합니다. 예를 들어 한 작업에서 폴더를 만드는 경우 폴더 ID 조회 작업은 10분이 지날 때까지 결과를 반환하지 않습니다.
그룹 관리	그룹 생성	지정된 초대 기본 설정을 사용하여 Box에서 그룹을 작성합니다.
	그룹 삭제	Box에서 지정된 그룹을 삭제합니다.
	그룹 업데이트	Box에서 지정된 그룹을 지정된 기본 설정으로 업데이트합니다.
법무 보류 관리	법무 자료보전 보험 할당	파일, 파일 버전, 폴더 또는 사용자에게 법무 보전 보험을 할당합니다.
	소송대비 자료보전(Legal Holds) 보험 작성	법무 관련 자료보전 보험을 작성합니다.
	모든 법무 보류 보험 스트림 조회	기업의 법무 보류 보험 목록을 조회합니다.
	ID로 법무 보류 보험 할당 조회	지정된 ID에 대한 법무 보류 보험 할당을 조회합니다.
	법무 보류 보험 할당 스트림 조회	법무 보류 보험에 할당된 항목 목록을 조회합니다.
	ID로 법무 보류 보험 조회	지정된 ID에 대한 법무 보류 보험을 조회합니다.
	소송대비 자료보전(Legal Holds) 보험 제거	기존의 법무 보전 보험을 삭제합니다.
	법무 자료보전 보험 비할당	법무 보류에 대한 항목 할당을 제거합니다.
	소송대비 자료보전(Legal Holds) 보험 업데이트	법무 관련 자료 보전 보험을 업데이트합니다.
메타데이터 관리	파일 ID로 파일에서 메타데이터 인스턴스 조회	지정된 파일 ID를 사용하여 파일의 메타데이터 인스턴스를 검색합니다.
	범위 및 템플릿 키로 파일에서 메타데이터 인스턴스 조회	지정된 범위와 템플릿 키가 있는 폴더의 메타데이터 인스턴스를 조회합니다.
	폴더 ID로 폴더에서 메타데이터 인스턴스 조회	지정된 폴더 ID가 있는 폴더의 모든 메타데이터를 검색합니다. 주: 폴더 ID 값이 0인 루트 폴더에서는 이 작업을 사용하지 마세요.
	범위 및 템플릿 키로 폴더에서 메타데이터 인스턴스 조회	지정된 범위와 템플릿 키가 있는 폴더의 모든 메타데이터를 조회합니다.
	메타데이터 스트림으로 파일 또는 폴더 쿼리	SQL과 유사한 구문을 사용하여 파일 또는 폴더를 검색하고 일치하는 결과를 반환합니다.
보존 보험 관리	유지 보험 할당	항목에 보존 보험을 할당합니다.
	유지 보험 작성	유지 보험을 작성합니다.
	보존 보험 조회	기업의 모든 보존 보험을 조회합니다.
	ID로 보존 보험 할당 조회	지정된 ID로 보존 보험을 조회합니다.
	보존 보험 할당 스트림 조회	지정된 보존 보험과 연결된 모든 보존 보험 할당의 목록을 반환합니다.
	ID로 보존 보험 조회	지정된 ID로 보존 보험을 조회합니다.
	유지 보험 업데이트	보존 보험을 업데이트합니다.
사용자 관리	그룹에 사용자 추가	Box의 지정된 그룹에 지정된 사용자를 추가합니다.
	사용자 작성	Box에서 사용자 계정을 작성합니다.
	사용자 제거	Box에서 지정된 사용자를 삭제합니다.
	사용자 비사용	Box에서 지정된 사용자의 상태를 비활성으로 설정합니다.
	사용자 사용	Box에서 지정된 사용자의 상태를 활성으로 설정합니다.
	사용자 ID 조회	Box에서 지정된 사용자의 ID를 조회합니다.
	사용자를 업데이트합니다	지정된 역할 변경 내용으로 Box에서 지정된 사용자를 업데이트합니다.
웹후크 관리	웹후크 생성	웹후크를 작성합니다.
	ID로 웹후크 조회	지정된 ID의 웹후크를 검색합니다.
	웹후크 스트림 조회	지정된 애플리케이션에 대해 정의된 모든 웹후크를 조회합니다.
	웹후크 제거	웹후크를 제거합니다.
	웹후크 업데이트	웹후크를 업데이트합니다.

Box 스포크 모듈

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

웹후크는 별도의 설정이 필요하며 스포크 작업을 사용하지 않고 독립적으로 사용할 수 있습니다. Box 스포크는 Box 스포크 애플리케이션을 인스턴스에 추가하고 다음 모듈을 포함합니다.

표 1. 박스 모듈
모듈	설명
Box 웹후크 레지스트리	ServiceNow에서 Plivo 웹후크를 생성하고 봅니다.
법무 자료보전 정책	사용 가능한 Box 법무 정책 목록을 봅니다.
유지 정책	사용 가능한 Box 보존 정책 목록을 봅니다.

Box 계정 요구 사항

Box 스포크 이를 위해서는 OAuth 2.0 토큰을 생성하기 위해 Box 계정에 사용자 지정 앱을 생성해야 합니다. OAuth 애플리케이션 생성를 참조하십시오.

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

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

이 스포크는 다음 별칭 기록을 사용하여 작업을 승인합니다.


연결 및 자격 증명 별칭	설명	연결 별칭 요구 사항
상자	Box 공동 작업 및 파일 관리 API에 대한 연결입니다.	연결 유형: HTTP 연결 URL: https://api.box.com
Box 업로드	Box 업로드 서비스에 대한 연결입니다.	연결 유형: HTTP 연결 URL: https://upload.box.com

스포크 연결 별칭을 사용하려면 각 별칭에 대한 연결된 연결 기록 및 연결된 자격 증명 기록을 생성합니다. 스포크 설정에 대한 자세한 내용은 다음을 참조하십시오. Box 스포크 설정을 클릭합니다.