Box 스포크
첨부 파일을 공유 문서로 관리할 수 있는 상자로 이동합니다.
스토어에서 앱 요청
ServiceNow Store 웹 사이트를 방문하면 사용 가능한 모든 앱을 확인하고 스토어에 요청을 제출하는 방법에 대한 정보를 참조할 수 있습니다. 출시된 모든 앱의 누적 릴리스 정보는 ServiceNow Store 버전 기록 릴리스 정보를 참조하십시오.
통합 허브 구독
이 스포크는 Integration Hub 구독이 필요합니다. 자세한 내용은 법무 일정 - 통합 허브 개요를 참조하십시오.
스포크 버전
Box 스포크 v3.4.0 가 최신 버전입니다.
지원되는 버전
API 버전 v2.
스포크 요구 사항
인스턴스와 Box 계정에서 동일한 언어가 선택되어 ServiceNow 있는지 확인합니다.
- ServiceNow 인스턴스에서 다음으로 이동하여 필요한 언어를 선택합니다. .
- Box 계정에서 다음으로 이동하여 필요한 언어를 선택합니다. .
스포크 플로우
Box Box 스포크 작업 자동화를 보여주는 초안 상태의 샘플 플로우를 제공합니다. 샘플 플로우를 사용자 지정하려면 새 애플리케이션 범위에 복사합니다. 사용 가능한 샘플 플로우는 다음과 같습니다.
| 플로우 | 설명 |
|---|---|
| Box로 작성 시 첨부 파일 이동 | 새 첨부 파일 기록이 추가되면 첨부 파일을 ServiceNow Box에서 Box로 이동합니다. Box에서 이동된 첨부 파일에 대한 공유 링크로 트리거 기록을 업데이트합니다. |
| 사용자 온보딩 | Box 사용자 그룹에서 사용자를 작성할 ServiceNow 때 Box에서 사용자를 작성합니다. |
스포크 작업
Box 스포크 에서 이벤트가 발생할 ServiceNow때 Box 작업을 자동화하는 작업을 제공합니다. 사용 가능한 작업은 다음과 같습니다.
| 범주 | 작업 | 설명 |
|---|---|---|
| 문서 관리 | 파일에 메타데이터 추가 | 제공된 속성 정보를 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로 웹후크를 조회합니다. | |
| 웹후크 스트림 조회 | 지정된 애플리케이션에 대해 정의된 모든 웹후크를 조회합니다. | |
| 웹후크 제거 | 웹후크를 제거합니다. | |
| 웹후크 업데이트 | 웹후크를 업데이트합니다. |
사용 가능한 AI 에이전트
스포크를 설치하고 Now Assist 사용 가능한 AI 에이전트 사용을 시작합니다. 자세한 내용은 Now Assist 스포크용 문서를 참조하십시오.
- ServiceNow 에이전트 시스템에서는 목표를 실행하기 위한 하나 이상의 독립 실행형 AI 에이전트와 함께 대규모 언어 모델(LLM) 지침 세트로 구성된 에이전트 워크플로우를 생성할 수 있습니다. 요구 사항에 따라 에이전트 워크플로우를 생성하고 필요한 트리거를 제공하기 위해 AI 에이전트를 추가하는 방법에 대한 자세한 내용은 을 참조하십시오 Create an agentic workflow .
사용 가능한 다른 AI 에이전트를 검색하고 에이전트 워크플로우에 추가할 수도 있습니다. 자세한 내용은 Find AI agents 문서를 참조하십시오.
- 필요한 스포크 AI 에이전트의 클론을 생성하고 요구 사항에 따라 사용자 지정할 수 있습니다. 클론 생성에 대한 자세한 내용은 을 참조하십시오 Duplicate an AI agent .
- AI 에이전트에 대한 자세한 내용은 을 참조하십시오 Now Assist AI agents .
| AI 에이전트 | 설명 |
|---|---|
| Box 사용자 관리 AI 에이전트 | Box에서 사용자 관리 작업(즉, 그룹에 사용자 추가, 사용자 활성화, 사용자 생성, 사용자 삭제, 사용자 업데이트, 사용자 ID 조회, 사용자 비활성화)을 관리합니다. |
| Box 폴더 관리 AI 에이전트 | Box에서 폴더 관리 작업(즉, 폴더 생성, 폴더 ID 조회, 폴더 삭제)을 관리합니다. |
| Box 문서 공유 AI 에이전트 |
Box에서 문서 공유 작업(즉, 공동 작업자 제거, 공동 작업자 추가, 공유 링크 생성, ID로 폴더 공동 작업자 조회)을 관리합니다. |
| Box 그룹 관리 AI 에이전트 | Box에서 그룹 관리 작업(즉, 그룹 업데이트, 그룹 생성, 그룹 삭제)을 관리합니다. |
| Box 메타데이터 관리 AI 에이전트 | Box에서 메타데이터 검색 작업(즉, 범위 및 템플릿 키로 파일에서 메타데이터 인스턴스 조회, 폴더 ID로 폴더에서 메타데이터 인스턴스 조회, 범위 및 템플릿 키로 폴더에서 메타데이터 인스턴스 조회, 파일 ID로 파일에서 메타데이터 인스턴스 조회)을 관리합니다. |
| Box 보존 정책 관리 AI 에이전트 | Box에서 보존 정책 관리 작업(즉, 보존 정책 업데이트, 보존 정책 스트림 조회, ID로 보존 정책 할당 조회, ID로 보존 정책 조회, 보존 정책 할당 스트림 조회)을 관리합니다. |
| Box 문서 관리 AI 에이전트 | Box에서 문서 관리 작업(파일 제거, 기록에 box 파일 첨부, 파일 업로드, 소유한 항목 이동, 콘텐츠 스트림 검색, 파일 ID 조회, 파일에 메타데이터 추가)을 관리합니다. |
| Box 법무 자료보전 관리 AI 에이전트 | Box에서 법무 보류 관리 작업(즉, 법무 보전 보험 생성, ID로 법무 보류 보험 할당 조회, 법무 보전 보험 업데이트, 모든 법무 보류 보험 스트림 조회, ID로 법무 보전 보험 조회, 법무 보전 보험 할당 해제, 법무 보전 보험 제거, 법무 보류 보험 할당 스트림 조회)을 Box에서 관리합니다. |
- 애플리케이션과 함께 Now Assist 설치된 AI 에이전트 중에 에이전틱 워크플로우에 사용되지 않을 수 있습니다. 인스턴스에서 사용할 수 있는 모든 에이전트를 보는 방법에 대한 자세한 내용은 AI 에이전트 찾기를 참조하십시오.
- 인스턴스에 설치되어 있지 않을 수 있는 에이전트를 찾으려면 에서 ServiceNow StoreAI 에이전트 마켓플레이스를 방문하십시오.
Box 스포크 모듈
양방향 웹후크는 필요한 이벤트에 대한 알림을 받도록 설정할 수 있습니다. 웹후크 레지스트리는 ServiceNow 앱에 알리기 위해 충족해야 하는 조건을 정의합니다. 이러한 조건은 알림을 받고자 하는 Box의 이벤트를 기반으로 합니다. 조건이 충족되면 지정된 트리거 이름이 연결된 하위 플로우를 트리거하여 Box 작업을 자동화합니다.
| 모듈 | 설명 |
|---|---|
| Box 웹후크 레지스트리 | ServiceNow에서 Plivo 웹후크를 작성하고 봅니다. |
| 법무 자료보전 정책 | 사용 가능한 Box 법무 정책 목록을 봅니다. |
| 유지 정책 | 사용 가능한 Box 유지 정책 목록을 봅니다. |
Box 계정 요구 사항
OAuth Box 스포크 2.0 토큰을 생성하려면 Box 계정에서 사용자 지정 앱을 생성해야 합니다. OAuth 애플리케이션 생성를 참조하십시오.
연결 및 자격 증명 별칭 요구 사항
통합 허브는 별칭을 사용하여 연결 및 자격 증명 정보와 OAuth 자격 증명을 관리합니다. 별칭을 사용하면 여러 환경을 사용할 때 여러 자격 증명과 연결 정보 프로파일을 구성하지 않아도 됩니다. 연결 또는 자격 증명 정보가 변경되면 연결을 사용하는 작업을 업데이트할 필요가 없습니다.
이 스포크는 다음 별칭 기록을 사용하여 작업을 승인합니다.
| 연결 및 자격 증명 별칭 | 설명 | 연결 별칭 요구 사항 |
|---|---|---|
| 상자 | Box 공동 작업 및 파일 관리 API에 연결합니다. |
|
| Box 업로드 | Box 업로드 서비스에 연결합니다. |
|
스포크 연결 별칭을 사용하려면 각 별칭에 대해 연결된 연결 기록 및 연결된 자격 증명 기록을 생성합니다. 스포크 설정에 대한 자세한 내용은 다음을 참조하십시오. Box 스포크 설정입니다.