Dropbox개 모듈

Adobe Workfront Fusion 시나리오에서는 Dropbox 또는 Dropbox Business을(를) 사용하는 워크플로를 자동화하고 여러 타사 응용 프로그램 및 서비스에 연결할 수 있습니다. 이를 통해 Dropbox에서 파일 및 폴더를 모니터링, 검색, 검색, 나열, 만들기 및 편집과 같은 활동을 자동화할 수 있습니다.

시나리오를 만드는 방법에 대한 지침이 필요하면 시나리오 만들기 Adobe Workfront Fusion를 참조하십시오.

모듈에 대한 자세한 내용은 의 모듈 Adobe Workfront Fusion을 참조하세요.

액세스 요구 사항

이 문서의 기능을 사용하려면 다음 액세스 권한이 있어야 합니다.

Adobe Workfront 플랜*
Pro 이상
Adobe Workfront 라이센스*
Plan, Work
Adobe Workfront Fusion 라이센스**

현재 라이선스 요구 사항: Workfront Fusion 라이선스 요구 사항이 없습니다.

또는

레거시 라이선스 요구 사항: 작업 자동화 및 통합을 위한 Workfront Fusion

제품

현재 제품 요구 사항: Select 또는 Prime Adobe Workfront 플랜이 있는 경우 조직에서 이 문서에 설명된 기능을 사용하려면 Adobe Workfront Fusion과(와) Adobe Workfront을(를) 구매해야 합니다. Workfront Fusion이(가) Ultimate Workfront 계획에 포함되어 있습니다.

또는

레거시 제품 요구 사항: 이 문서에 설명된 기능을 사용하려면 조직에서 Adobe Workfront Fusion과(와) Adobe Workfront을(를) 구매해야 합니다.

보유 중인 플랜, 라이선스 유형 또는 액세스 권한을 확인하려면 Workfront 관리자에게 문의하세요.

Adobe Workfront Fusion 라이선스에 대한 자세한 내용은 Adobe Workfront Fusion 라이선스를 참조하세요.

전제 조건

  • Dropbox 모듈을 사용하려면 Dropbox 계정이 있어야 합니다.
IMPORTANT
Dropbox은 사용자가 50명을 초과하는 응용 프로그램을 승인해야 합니다.
자세한 내용을 보려면 Dropbox 개발자 안내서에서 "프로덕션 승인"을 검색하십시오.

Dropbox API 정보

Dropbox 커넥터는 다음을 사용합니다.

기본 URL
https://api.dropboxapi.com/2
API 버전
2
API 태그
  • Dropbox

    v5.3.9

  • Dropbox Business

    v1.0.12

Dropbox에 연결 만들기

Dropbox 모듈에 대한 연결을 만들려면:

  1. 연결 상자 옆에 있는 추가 ​를 클릭합니다.

  2. 다음 필드를 채웁니다.

    table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 layout-auto html-authored no-header
    연결 이름 이 연결의 이름을 입력하십시오.
    환경 이 연결이 프로덕션 환경용인지 아니면 비프로덕션 환경용인지 선택합니다.
    유형 서비스 계정에 연결할지 또는 개인 계정에 연결할지 선택합니다.
    클라이언트 ID Dropbox 클라이언트 ID를 입력합니다.
    클라이언트 암호 Dropbox 클라이언트 암호를 입력하십시오.
    계정 유형 개인 Dropbox 계정에 연결할지 아니면 비즈니스(Dropbox 비즈니스) 계정에 연결할지 선택합니다.
  3. 연결을 저장하고 모듈로 돌아가려면 계속 ​을 클릭하세요.## Dropbox 모듈 및 해당 필드

Dropbox개 모듈 및 해당 필드

Dropbox 모듈을 구성할 때 Workfront Fusion에 아래 나열된 필드가 표시됩니다. 앱 또는 서비스의 액세스 수준과 같은 요소에 따라 이러한 필드와 함께 Dropbox 필드가 추가로 표시될 수 있습니다. 모듈의 굵은 제목은 필수 필드를 나타냅니다.

필드나 함수 위에 맵 단추가 표시되면 이 단추를 사용하여 해당 필드에 대한 변수와 함수를 설정할 수 있습니다. 자세한 내용은 한 모듈에서 다른 모듈로 정보를 매핑 Adobe Workfront Fusion을 참조하십시오.

트리거 모듈

파일 보기

이 트리거 유형 모듈은 지정된 폴더의 파일이 수정되면 파일 세부 정보를 반환합니다.

Connection
Dropbox 계정을 Workfront Fusion에 연결하는 방법에 대한 지침은 이 문서에서 Dropbox에 연결 만들기 를 참조하십시오.
폴더
변경 내용을 감시할 폴더를 선택합니다.
Watch 또한 하위 폴더
선택한 폴더의 하위 폴더에서 수정된 파일을 모니터링하려면 이 옵션을 활성화합니다.
제한
각 시나리오 실행 주기 동안 모듈이 반환할 최대 레코드 수를 입력하거나 매핑합니다.

Dropbox개의 파일 및 폴더를 가져오는 모듈

파일/폴더 검색

이 검색 모듈은 지정한 검색 쿼리와 일치하는 Dropbox의 개체에서 레코드를 찾습니다.

이 정보는 시나리오의 후속 모듈에 매핑할 수 있습니다.

Connection
Dropbox 계정을 Workfront Fusion에 연결하는 방법에 대한 지침은 이 문서에서 Dropbox에 연결 만들기 를 참조하십시오.
Search
검색어를 입력합니다.
폴더
검색할 폴더를 선택합니다. 폴더를 선택하지 않으면 이 모듈은 전체 Dropbox을(를) 검색합니다.
파일 상태
검색을 선택한 파일 상태로 제한하려면 파일 상태를 선택합니다.
파일 범주
선택한 범주로 검색을 제한하려면 파일 범주를 선택합니다.
파일 확장명
검색할 파일 확장자를 선택합니다.
제한
각 시나리오 실행 주기 동안 모듈이 반환할 최대 레코드 수를 입력하거나 매핑합니다.

파일 다운로드

이 작업 모듈은 폴더에서 파일을 다운로드합니다.

파일과 해당 위치를 지정합니다.

모듈은 파일의 ID와 연결된 필드, 그리고 연결이 액세스하는 모든 사용자 지정 필드 및 값을 반환합니다. 이 정보는 시나리오의 후속 모듈에 매핑할 수 있습니다.

NOTE
이 모듈은 파일을 후속 모듈에 제공하는 데 유용합니다.

이 모듈을 구성할 때 다음 필드가 표시됩니다.

Connection
Dropbox 계정을 Workfront Fusion에 연결하는 방법에 대한 지침은 이 문서에서 Dropbox에 연결 만들기 를 참조하십시오.
파일 선택 방법
파일 경로를 매핑할지 또는 수동으로 파일을 선택할지 선택합니다.
파일 경로 / 파일

파일 경로

대상 경로를 입력하거나 파일에 매핑합니다.

파일

메뉴에서 파일을 선택합니다.

폴더 메타데이터 가져오기

이 작업 모듈은 공유 폴더 세부 정보를 검색합니다.

폴더의 ID를 지정합니다.

모듈은 연결이 액세스하는 사용자 지정 필드 및 값과 함께 폴더 ID 및 연결된 필드를 반환합니다. 이 정보는 시나리오의 후속 모듈에 매핑할 수 있습니다.

이 모듈을 구성할 때 다음 필드가 표시됩니다.

Connection
Dropbox 계정을 Workfront Fusion에 연결하는 방법에 대한 지침은 이 문서에서 Dropbox에 연결 만들기 를 참조하십시오.
공유 폴더 ID
세부 정보를 검색할 폴더의 ID를 입력하거나 매핑합니다.

폴더에 있는 모든 파일/하위 폴더 나열

이 작업 모듈은 특정 폴더에 있는 파일 또는 폴더를 나열합니다.

폴더의 ID를 지정합니다.

이 모듈은 파일 또는 폴더의 ID와 연결된 필드를 연결이 액세스하는 사용자 지정 필드 및 값과 함께 반환합니다. 이 정보는 시나리오의 후속 모듈에 매핑할 수 있습니다.

이 모듈을 구성할 때 다음 필드가 표시됩니다.

Connection
Dropbox 계정을 Workfront Fusion에 연결하는 방법에 대한 지침은 이 문서에서 Dropbox에 연결 만들기 를 참조하십시오.
목록
파일 또는 폴더를 검색할지 선택합니다.
다운로드 가능한 파일만 표시
다운로드 가능한 파일만 반환하려면 이 옵션을 활성화합니다. Google Docs와 같은 일부 유형의 파일은 다운로드할 수 없습니다.
폴더
파일 또는 폴더를 검색할 폴더를 입력하거나 매핑합니다.
제한
각 시나리오 실행 주기 동안 모듈이 나열할 최대 레코드 수를 입력하거나 매핑합니다.

파일 수정 버전 나열

이 작업 모듈은 특정 파일의 모든 파일 개정 버전(버전 내역)을 검색합니다.
파일의 ID를 지정합니다.

모듈은 연결에서 액세스하는 모든 사용자 지정 필드 및 값과 함께 레코드와 연결된 모든 표준 필드를 반환합니다. 이 정보는 시나리오의 후속 모듈에 매핑할 수 있습니다.

이 모듈을 구성할 때 다음 필드가 표시됩니다.

Connection
Dropbox 계정을 Workfront Fusion에 연결하는 방법에 대한 지침은 이 문서에서 Dropbox에 연결 만들기 를 참조하십시오.
파일 선택 방법
파일 경로를 매핑할지 또는 수동으로 파일을 선택할지 선택합니다.
파일 경로 / 파일

파일 경로

대상 경로를 입력하거나 파일에 매핑합니다.

파일

메뉴에서 파일을 선택합니다.

제한
각 시나리오 실행 주기 동안 모듈이 나열할 최대 레코드 수를 입력하거나 매핑합니다.

Dropbox개의 파일 및 폴더를 만들고 편집하는 모듈입니다.

파일 업로드

이 작업 모듈은 파일을 폴더로 업로드합니다.

파일 위치, 업로드할 파일 및 파일의 새 이름(선택 사항)과 같은 정보를 지정합니다.

모듈은 파일의 ID와 연결된 필드, 그리고 연결이 액세스하는 모든 사용자 지정 필드 및 값을 반환합니다. 이 정보는 시나리오의 후속 모듈에 매핑할 수 있습니다.

이 모듈을 구성할 때 다음 필드가 표시됩니다.

Connection
Dropbox 계정을 Workfront Fusion에 연결하는 방법에 대한 지침은 이 문서에서 Dropbox에 연결 만들기 를 참조하십시오.
폴더
파일을 업로드할 Dropbox의 폴더를 선택하십시오.
Source 파일

위에서 선택한 Dropbox 폴더에 추가할 파일을 입력하거나 매핑합니다.

파일 이름

파일 확장자를 포함하여 파일 이름을 입력하거나 매핑합니다.

파일 데이터

파일 데이터(Google Drive >파일 가져오기)와 같은 이전 모듈의)를 입력하거나 매핑합니다.

참고: 업로드된 파일의 최대 크기는 150MB입니다.

기존 파일 덮어쓰기
기존 파일을 새 파일로 바꾸려면 이 옵션을 활성화합니다. 이 옵션을 비활성화하면 업로드된 파일의 이름이 바뀝니다.

폴더 만들기

이 작업 모듈은 새 폴더를 만듭니다.

폴더의 경로 및 이름을 지정합니다.

모듈은 연결이 액세스하는 사용자 지정 필드 및 값과 함께 폴더 ID 및 연결된 필드를 반환합니다. 이 정보는 시나리오의 후속 모듈에 매핑할 수 있습니다.

이 모듈을 구성할 때 다음 필드가 표시됩니다.

Connection
Dropbox 계정을 Workfront Fusion에 연결하는 방법에 대한 지침은 이 문서에서 Dropbox에 연결 만들기 를 참조하십시오.
폴더 이름
새 폴더의 이름을 입력합니다.
폴더

새 폴더를 만들 경로를 입력하거나 매핑합니다.

참고:

Dropbox Business 계정(팀 공간 포함)을 사용하는 경우 슬래시 /을(를) 제거하거나 여기를 클릭하여 폴더를 선택 하여 루트에 팀 폴더를 만들어야 합니다.

슬래시가 제거되지 않으면 오류 [409] path/malformed_path/..이(가) 반환됩니다.

자동 이름 변경
대상 위치에 이름이 같은 폴더가 이미 있는 경우 새 폴더의 이름을 변경하려면 이 옵션을 활성화합니다.

텍스트 파일 만들기/덮어쓰기

이 작업 모듈은 DOC 파일을 만들거나 기존 파일의 콘텐츠를 덮어씁니다.

소스 파일과 폴더를 지정합니다.

모듈은 연결이 액세스하는 사용자 지정 필드 및 값과 함께 폴더 ID 및 연결된 필드를 반환합니다. 이 정보는 시나리오의 후속 모듈에 매핑할 수 있습니다.

이 모듈을 구성할 때 다음 필드가 표시됩니다.

Connection
Dropbox 계정을 Workfront Fusion에 연결하는 방법에 대한 지침은 이 문서에서 Dropbox에 연결 만들기 를 참조하십시오.
Select to
DOC 파일을 작성할지 또는 덮어쓸지 여부를 선택합니다.
폴더
파일을 만들 대상 위치를 선택합니다.
Source 파일

추가할 파일을 Dropbox 폴더에 입력하거나 매핑합니다.

파일 이름

확장명 없이 새 DOC 파일의 파일 이름을 입력합니다.

파일 컨텐츠

DOC 파일의 텍스트 내용을 입력합니다.

공유 링크 만들기/업데이트

이 작업 모듈은 파일에 대한 공개 링크를 만듭니다.

파일 및 링크에 대한 정보를 지정합니다.

모듈은 연결이 액세스하는 사용자 지정 필드 및 값과 함께 링크의 ID 및 연결된 필드를 반환합니다. 이 정보는 시나리오의 후속 모듈에 매핑할 수 있습니다.

이 모듈을 구성할 때 다음 필드가 표시됩니다.

Connection
Dropbox 계정을 Workfront Fusion에 연결하는 방법에 대한 지침은 이 문서에서 Dropbox에 연결 만들기 를 참조하십시오.
파일 선택 방법
파일 경로를 매핑할지 또는 입력할지를 선택하거나 파일을 수동으로 선택합니다.
파일 경로 / 파일

파일 경로

대상 경로를 입력하거나 파일에 매핑합니다.

파일

메뉴에서 파일을 선택합니다.

요청된 가시성

링크가 공개 링크인지 팀 링크인지 암호 제한인지 선택합니다.

참고: Team only 및 Access with password 옵션은 Dropbox Pro 이상 버전을 가진 사용자만 사용할 수 있습니다.

링크의 만료 날짜

링크가 만료되어 더 이상 액세스할 수 없게 되는 날짜 및 시간을 입력합니다. 이 필드를 비워 두면 링크가 만료되지 않습니다. 지원되는 날짜 및 시간 형식 목록을 보려면 Adobe Workfront Fusion의 형식 변환을 참조하십시오.

참고: Team only 및 Access with password 옵션은 Dropbox Pro 이상 버전을 보유한 사용자만 사용할 수 있습니다.

링크의 액세스 수준

링크 수신자에 대한 권한을 설정합니다.

링크를 사용하는 뷰어 사용자는 콘텐츠를 보고 댓글을 달 수 있습니다.

링크를 사용하는 Editor 사용자는 콘텐츠를 편집하고 보고 댓글을 달 수 있습니다.

링크를 사용하는 Max 사용자는 링크를 설정할 수 있는 최대 액세스 수준을 받습니다.

파일 복원

이 작업 모듈은 파일의 이전 버전을 복원합니다.

원하는 파일 및 개정 번호를 지정합니다.

이 모듈은 버전 ID 및 연결된 모든 필드를, 연결이 액세스하는 모든 사용자 지정 필드 및 값과 함께 반환합니다. 이 정보는 시나리오의 후속 모듈에 매핑할 수 있습니다.

이 모듈을 구성할 때 다음 필드가 표시됩니다.

Connection
Dropbox 계정을 Workfront Fusion에 연결하는 방법에 대한 지침은 이 문서에서 Dropbox에 연결 만들기 를 참조하십시오.
파일 선택 방법
파일 경로를 매핑할지 또는 입력할지를 선택하거나 파일을 수동으로 선택합니다.
파일 경로 / 파일

파일 경로

대상 경로를 입력하거나 파일에 매핑합니다.

파일

메뉴에서 파일을 선택합니다.

Revision
복원할 개정의 개정 번호를 입력하거나 매핑합니다.

파일/폴더 이동

이 작업 모듈은 파일 또는 폴더를 다른 위치로 이동합니다.

파일 또는 폴더와 그 이동 방법 및 위치를 지정합니다.

모듈은 파일 또는 폴더의 ID와 연결된 필드를 연결이 액세스하는 사용자 지정 필드 및 값과 함께 반환합니다. 이 정보는 시나리오의 후속 모듈에 매핑할 수 있습니다.

이 모듈을 구성할 때 다음 필드가 표시됩니다.

Connection
Dropbox 계정을 Workfront Fusion에 연결하는 방법에 대한 지침은 이 문서에서 Dropbox에 연결 만들기 를 참조하십시오.
파일 선택 방법
파일 경로를 매핑할지 또는 입력할지를 선택하거나 파일을 수동으로 선택합니다.
파일/폴더 경로 / 파일/폴더

파일/폴더 경로

파일 또는 폴더에 대상 경로를 입력하거나 매핑합니다.

파일/폴더

메뉴에서 파일 또는 폴더를 선택합니다.

To Folder
파일 또는 폴더의 대상 위치를 입력하거나 매핑합니다.
새 이름
새 위치에 파일 또는 폴더의 새 이름을 입력합니다.
자동 이름 바꾸기
이 옵션을 활성화하면 동일한 이름의 파일 또는 폴더가 있는 경우 모듈에서 파일 또는 폴더 이름 뒤에 (NUMBER)를 추가하여 새 파일 또는 폴더의 이름을 바꿉니다. 그렇지 않으면 대상 위치의 파일 또는 폴더를 덮어씁니다.
소유권 이전 허용
이 옵션을 활성화하면 이동하는 컨텐츠에 대한 소유권 이전이 발생하는 경우에도 소유자가 이동할 수 있습니다.

파일/폴더 이름 바꾸기

이 작업 모듈은 파일 또는 폴더의 이름을 변경합니다.

파일 또는 폴더와 새 이름을 지정합니다.

모듈은 파일 또는 폴더의 ID와 연결된 필드를 연결이 액세스하는 사용자 지정 필드 및 값과 함께 반환합니다. 이 정보는 시나리오의 후속 모듈에 매핑할 수 있습니다.

이 모듈을 구성할 때 다음 필드가 표시됩니다.

Connection
Dropbox 계정을 Workfront Fusion에 연결하는 방법에 대한 지침은 이 문서에서 Dropbox에 연결 만들기 를 참조하십시오.
파일 선택 방법
파일 경로를 매핑할지 또는 입력할지를 선택하거나 파일을 수동으로 선택합니다.
파일/폴더 경로/파일/폴더

파일/폴더 경로

파일 또는 폴더에 대상 경로를 입력하거나 매핑합니다.

파일/폴더

메뉴에서 파일 또는 폴더를 선택합니다.

이름 바꾸기
파일 확장명을 포함하여 파일에 대한 대상 이름을 입력합니다.

파일/폴더 삭제

이 작업 모듈은 파일 또는 폴더를 삭제합니다.

파일 또는 폴더를 지정합니다.

모듈은 연결에서 액세스하는 사용자 지정 필드 및 값과 함께 레코드 및 관련 필드의 ID를 반환합니다. 이 정보는 시나리오의 후속 모듈에 매핑할 수 있습니다.

이 모듈을 구성할 때 다음 필드가 표시됩니다.

Connection
Dropbox 계정을 Workfront Fusion에 연결하는 방법에 대한 지침은 이 문서에서 Dropbox에 연결 만들기 를 참조하십시오.
파일 선택 방법
파일 경로를 매핑할지 또는 입력할지를 선택하거나 파일을 수동으로 선택합니다.
파일 경로 / 파일

파일 경로

대상 경로를 입력하거나 파일에 매핑합니다.

파일

메뉴에서 파일을 선택합니다.

기타 모듈

API 호출 만들기

이 작업 모듈을 사용하면 Dropbox API에 대해 사용자 지정 인증된 호출을 수행할 수 있습니다. 이렇게 하면 다른 Dropbox 모듈에서 수행할 수 없는 데이터 흐름 자동화를 만들 수 있습니다.

이 모듈을 구성할 때 다음 필드가 표시됩니다.

Connection
Dropbox 계정을 Workfront Fusion에 연결하는 방법에 대한 지침은 이 문서에서 Dropbox에 연결 만들기 를 참조하십시오.
URL

상대 경로를 입력하십시오. https://api.dropboxapi.com을(를) 기준으로 한 경로를 입력하십시오. For example, /2/files/list_folder

참고: 사용 가능한 끝점 목록은 Dropbox API v2 설명서를 참조하세요.

메서드

API 호출을 구성하는 데 필요한 HTTP 요청 메서드를 선택합니다. 자세한 내용은 Adobe Workfront Fusion에서 HTTP 요청 메서드를 참조하십시오.

Headers
원하는 요청 헤더를 입력합니다. Workfront Fusion이(가) 인증 헤더를 자동으로 추가합니다.
쿼리 문자열
요청 쿼리 문자열을 입력합니다.
Body

표준 JSON 개체의 형태로 API 호출에 대한 본문 콘텐츠를 추가합니다.

참고:

JSON에서 if과(와) 같은 조건문을 사용할 때 따옴표를 조건문 외부에 넣으십시오.

INFO
예: 다음 API 호출은 Dropbox 계정의 /Text files 폴더에서 처음 10개의 파일을 반환합니다.
URL: /2/files/list_folder
본문:
{
"path": "/Text files",
"limit": 10,
"recursive": false,
"include_deleted": false
}
검색 일치 항목은 번들 > 본문 > 항목 아래의 모듈 출력에서 찾을 수 있습니다.
이 예에서는 10개의 티켓이 반환되었습니다.

일반적인 문제

파일을 업로드하거나 업데이트할 수 없음

파일 업로드 또는 업데이트가 실패할 경우 다음과 같은 몇 가지 상황이 발생합니다.

  • 업로드한 파일이 너무 커서 Dropbox 계획에 허용된 최대 파일 크기를 초과하거나 Dropbox 계정의 저장소 할당량을 모두 사용했습니다. Dropbox 계정에서 기존 파일을 삭제하거나 플랜을 업그레이드해야 합니다.
  • 이전에 선택한 파일 업로드 대상 폴더는 더 이상 존재하지 않습니다. 시나리오가 중지되며 대상 폴더를 다시 선택해야 합니다.

공유 링크를 통해 참조된 이미지가 렌더링되지 않음

Dropbox >공유 링크 만들기에서 반환된 URL은 이미지에 직접 연결되지 않고 Dropbox 페이지로 연결됩니다. 이미지를 강제로 다운로드하려면 후행 ?dl=0을(를) ?dl=1(으)로 바꾸십시오. 이미지를 렌더링하려면(예: 웹 브라우저나 Facebook Messenger에서) URL에 &raw=1을(를) 추가하십시오.

웹 사이트 또는 다른 Workfront Fusion 모듈에 대한 이미지의 직접 또는 원시 링크를 가져와야 하는 경우 다음과 같은 방법으로 초기 공유 URL을 수정해야 합니다.

원래 URL:

https://www.dropbox.com/s/ia8qtvs20f3a5ux/Screen%20Shot%202018-10-15%20at%204.21.11%20PM.png?dl=0

  1. www에서 dl(으)로 바꾸기
  2. ?dl=0 제거.

최종 URL:

https://dl.dropbox.com/s/ia8qtvs20f3a5ux/Screen%20Shot%202018-10-15%20at%204.21.11%20PM.png

URL을 자동으로 수정하려면 replace() 함수를 두 번 사용합니다.

  • www를 dl로 바꾸기

  • ?dl=0 제거

한 단계로 진행하려면 다음 함수를 결합합니다.

복사하여 필드에 붙여넣을 수도 있습니다. 1.url을(를) URL로 바꾸십시오.

{{replace(replace(1.url; "?dl=0"; ""); "www"; "dl")}}
recommendation-more-help
5f00cc6b-2202-40d6-bcd0-3ee0c2316b43