사용자 정의 기능 패키지 사용

패키지를 사용하면 Fusion 인터페이스를 종료하지 않고 Adobe Workfront Fusion 내에서 고유한 사용자 지정 논리를 빌드하고 실행할 수 있습니다. 표준 모듈에서 필요한 작업을 정확하게 수행하지 못하는 경우 함수를 사용하여 데이터를 변형하거나, 계산을 수행하거나, 외부 서비스를 호출하거나, 재사용할 루틴을 래핑할 수 있습니다. 그런 다음 테스트하고 라이브로 만들어 시나리오에서 사용할 수 있습니다.

복잡한 함수에는 변수와 같은 리소스와 라이브러리 등의 종속성이 필요할 수 있습니다. 이러한 함수의 경우 함수와 해당 리소스를 포함하는 패키지를 만들 수 있습니다.

패키지는 다음을 포함할 수 있습니다.

  • 함수: 시나리오 실행 중에 실행되는 논리입니다.
  • 변수: 패키지의 함수가 사용하는 기본 URL 또는 API 키와 같이 재사용 가능한 값.
  • 종속성: 함수를 사용할 수 있는 외부 라이브러리입니다.
  • 내역: 참조할 수 있는 각 함수의 이전 버전이 자동으로 저장되었습니다.

액세스 요구 사항

이 문서의 기능에 대한 액세스 요구 사항을 보려면 확장하십시오.
table 0-row-2 1-row-2 2-row-2 layout-auto html-authored no-header
Adobe Workfront 패키지

모든 Adobe Workfront 워크플로 패키지 및 모든 Adobe Workfront 자동화 및 통합 패키지

Workfront Ultimate

Workfront Prime 및 Select 패키지 및 Workfront Fusion 추가 구매.

Adobe Workfront 라이선스

표준

작업 이상

제품
  • 조직에 Workfront 자동화 및 통합이 포함되지 않은 Select 또는 Prime Workfront 패키지가 있는 경우 Adobe Workfront Fusion을 구매해야 합니다.
  • 사용자 지정 기능을 사용하려면 Adobe App Builder 라이선스가 있어야 합니다.

이 테이블의 정보에 대한 자세한 내용은 설명서의 액세스 요구 사항을 참조하십시오.

런타임 환경 연결 설정

NOTE
1회 설정입니다.

팀에서 이 기능을 처음 사용할 때는 함수를 실행하는 환경을 설정해야 합니다. 팀당 한 번만 이 작업을 수행합니다.

  1. 왼쪽 탐색 패널에서 패키지 패키지 아이콘 탭을 클릭합니다.

    환경이 설정되지 않은 경우 런타임 환경이 구성되지 않음 화면이 나타납니다.

  2. 런타임 초기화​를 클릭합니다.

  3. 기본 이름이 아닌 이름을 입력하려면 연결 이름 필드에 이름을 입력하십시오.

  4. 이 패키지가 속할 Adobe App Builder 프로젝트 선택:

    • 기존 프로젝트를 선택하려면 프로젝트 이름을 입력한 다음 표시될 때 선택합니다.
    • 새 프로젝트를 만들려면 존재하지 않는 이름을 입력하고 새로 만들기​를 클릭합니다.
    • 이 항목을 비워 두면 Fusion은 기본 프로젝트를 사용합니다.
  5. 계속​을 선택합니다.

    Fusion이 설정을 완료하면 패키지를 만들 준비가 된 것입니다.

    환경은 페이지 상단에 연결 탭으로 표시됩니다.

    연결 탭으로서의 환경

  6. (조건부) 환경을 더 추가하려면 더하기 아이콘을 클릭하고 이 섹션의 지침을 따릅니다.

  7. (조건부) 기존 환경을 제거하려면 환경 연결 탭을 마우스로 가리킨 다음 표시되는 동안 X​을(를) 클릭합니다.

    note warning
    WARNING
    연결을 제거하면 해당 환경에서 Fusion의 연결이 끊어집니다. 해당 연결을 통해 Fusion에서 해당 패키지의 패키지를 더 이상 사용할 수 없습니다.

패키지 만들기 및 열기

  1. 왼쪽 탐색 패널에서 패키지 패키지 아이콘 탭을 클릭합니다.

  2. 작업할 연결에 대한 탭을 선택합니다.

  3. 패키지 만들기​를 클릭합니다.

  4. 이름을 입력하고 만들기​를 선택하세요.

    패키지가 자동으로 열립니다.

  5. 나중에 패키지를 다시 열려면 패키지 목록에서 패키지를 선택하고 보기​를 선택합니다.

  6. 패키지를 삭제하려면 패키지 목록에서 패키지를 선택하고 삭제​를 선택합니다.

    note warning
    WARNING
    패키지를 삭제하면 패키지와 패키지 내의 모든 항목이 영구적으로 제거됩니다.

패키지 관리

오픈 패키지는 다음 네 가지 영역으로 구성됩니다.

  • 함수: 함수를 만들고, 테스트하고, 게시합니다.
  • 변수: 함수에 대한 변수를 구성합니다.
  • 종속성: 이 함수에 대한 외부 라이브러리 등의 종속성을 설치합니다.
  • 내역: 각 함수의 이전 버전을 봅니다.

이 네 가지 영역 외에도 맨 위에 있는 Storage meter 는 사용 공간의 양을 보여줍니다. 각 패키지의 총 크기 제한은 21MB​입니다. 여기에는 저장된 버전을 포함하여 함수, 변수 및 종속성이 포함됩니다.

공간이 부족하면 사용하지 않는 종속성, 변수 또는 이전 버전을 제거하여 공간을 확보하는 것이 좋습니다.

패키지 목록으로 돌아가려면 패키지 이름 옆에 있는 뒤로 화살표를 선택합니다.

함수

함수 영역에는 함수 이름, 상태, 크기 및 필요한 입력 수를 포함하여 패키지에 있는 함수 목록이 표시됩니다.

함수 목록 보기 및 관리

함수 목록을 필터링하려면 다음을 수행합니다.

  1. 모두, 초안 또는 게시됨​을 클릭하여 상태별로 필터링하십시오.
  2. 검색 창을 사용하여 특정 기능을 검색합니다.

함수는 초안 또는 게시됨 상태를 가질 수 있습니다.

  • 초안: 초안 상태의 함수가 진행 중입니다. 라이브 데이터에 영향을 주지 않고 자유롭게 편집하고 테스트할 수 있습니다.
  • 게시됨: 게시된 버전이 라이브입니다. 시나리오에서는 게시된 버전의 함수를 실행합니다.

초안을 사용하면 안전하게 변경할 수 있습니다. 초안을 세분화하고 테스트한 다음 만족스러우면 게시할 수 있습니다.

상태
의미
Published
라이브 버전이 있습니다.
초안
함수가 아직 진행 중이거나 라이브 함수에 아직 게시하지 않은 변경 사항이 있습니다.

패키지 영역에서 함수 만들기 또는 편집

  1. 왼쪽 탐색 패널에서 패키지 패키지 아이콘 탭을 클릭합니다.

  2. 함수 영역에서 함수 만들기​를 선택합니다.

    또는

    기존 함수 옆에 있는 확인란을 클릭하고 페이지 하단의 작업 표시줄에서 편집​을 선택합니다.

  3. (조건부) 새 함수를 만드는 경우 새 함수 필드에 함수 이름을 입력하십시오.

  4. (선택 사항 및 조건부) 기존 함수의 이름을 바꾸려면 함수 이름 옆에 있는 편집 아이콘을 클릭하고 새 이름을 입력합니다.

  5. 코드 탭에서 함수 논리를 입력합니다.

    함수를 만들 때 다음 사항을 고려하십시오.

    • 함수는 JavaScript으로 작성되어야 합니다.
    • 정의한 입력을 읽고, 변수를 재사용하고, 다른 함수를 호출할 수 있습니다.
    • 입력할 때 제안이 나타납니다.
  6. 함수 서식을 지우려면 수정​을 클릭하세요.

  7. (선택 사항) 매개 변수 탭에서 함수에 필요한 입력을 정의합니다.

    입력에 대한 자세한 내용은 이 문서에서 입력 정의를 참조하십시오.

  8. 테스트 탭에서 함수를 테스트하십시오.

    자세한 내용은 이 문서에서 함수 테스트를 참조하십시오.

  9. 이 함수를 초안으로 저장하려면 초안으로 저장​을 클릭하세요.

    또는

    함수를 게시하려면 게시​를 클릭하십시오.

    note
    NOTE
    함수를 게시하면 버전 내역이 지워집니다. 게시된 버전이 현재 시작점이 되고 이전 초안 버전은 더 이상 유지되지 않습니다.
입력 정의

매개 변수 탭을 사용하여 함수가 실행될 때마다 필요한 정보를 설명할 수 있습니다.

  1. 왼쪽 탐색 패널에서 패키지 패키지 아이콘 탭을 클릭합니다.

  2. 함수 영역에서 함수 만들기​를 선택합니다.

    또는

    기존 함수 옆에 있는 확인란을 클릭하고 페이지 하단의 작업 표시줄에서 편집​을 선택합니다.

  3. 매개 변수 탭을 클릭합니다.

  4. 추가할 각 매개 변수에 대해 매개 변수 추가​를 클릭하고 다음을 구성하십시오.

  • 이름: 입력 이름
  • Label: 함수를 테스트할 때 사용자에게 친숙한 이름이 표시됩니다
  • Type: 텍스트, 숫자, true/false 또는 구조화된 개체와 같은 데이터 형식입니다.
  • 필수: 값을 제공해야 하는지 여부입니다.

이러한 입력은 테스트할 때 채우는 필드가 되며 함수를 실행할 때 시나리오가 전달하는 값이 됩니다.

함수 테스트

함수를 게시하기 전에 테스트하는 것이 좋습니다.

  1. 왼쪽 탐색 패널에서 패키지 패키지 아이콘 탭을 클릭합니다.

  2. 함수 영역에서 함수 만들기​를 선택합니다.

    또는

    기존 함수 옆에 있는 확인란을 클릭하고 페이지 하단의 작업 표시줄에서 편집​을 선택합니다.

  3. 테스트 탭을 클릭합니다.

  4. 각 입력에 대한 값을 입력합니다.

  5. 함수 실행:

    • 테스트 초안​을(를) 선택하여 진행 중인 작업 버전을 테스트하세요.
    • 게시됨 실행​을 선택하여 라이브 버전을 실행합니다.
  6. 성공 여부, 소요 시간, 반환된 출력 등 결과를 검토합니다.

NOTE
게시된 실행​은(는) 함수가 게시된 후에만 사용할 수 있습니다.

라이브 함수 변경

함수가 게시되면 게시 단추가 메뉴가 됩니다.

  • 다시 게시 — 최신 초안 변경 내용을 라이브 버전에 푸시합니다.
  • 게시 취소 — 함수를 사용하지 않습니다. 귀하의 작업은 초안으로 보관되므로 다시 가져올 수 있습니다.

함수 삭제

  1. 왼쪽 탐색 패널에서 패키지 패키지 아이콘 탭을 클릭합니다.
  2. 기존 함수 옆에 있는 확인란을 클릭하고 페이지 하단의 작업 표시줄에서 삭제​를 선택합니다.
WARNING
함수를 삭제하면 해당 기록과 함께 완전히 제거됩니다. 이를 사용하는 모든 시나리오 또는 함수가 작동을 중지합니다.

변수

변수는 기본 URL, 계정 ID 또는 API 키와 같이, 함수에서 사용할 수 있는 재사용 가능한 값입니다. 이러한 매개 변수를 변수로 저장하면 여러 함수에서 값을 업데이트하는 대신 값을 한 번 설정하고 한 곳에서 값을 업데이트할 수 있습니다.

변수 만들기 또는 편집

  1. 왼쪽 탐색 패널에서 패키지 패키지 아이콘 탭을 클릭합니다.

  2. 변수 탭에서 새 변수​을(를) 선택합니다.

    또는

    편집할 변수 옆에 있는 편집 아이콘을 클릭합니다.

  3. 세부 정보를 입력합니다.

    • : 함수를 사용하여 값을 참조하는 데 사용하는 이름을 입력하십시오.

    이 변수의 이름을 변경하려면 키 값을 변경합니다.

    • : 저장할 값을 입력하십시오.
    • Type: 값 형식이 텍스트, 숫자, 부울(true/false) 또는 구조화된 개체인지 여부를 선택합니다.
    • 설명: 용도를 알려주는 선택적 메모를 입력하세요.
    • 공개: 시나리오 디자이너에서 변수를 사용하려면 이 옵션을 켜십시오. 해제 시에는 패키지의 함수 내에서만 변수를 사용할 수 있습니다.
    • 암호: 키와 같은 중요한 값을 숨기려면 이 옵션을 켜십시오. 이 값은 변수 목록에 숨겨져 있으며 시나리오 디자이너에서 노출되지 않도록 정리됩니다. 함수가 실행되어도 여전히 실제 값을 받습니다.
  4. 변수 만들기 또는 변경 내용 저장​을 선택합니다.

변수 삭제

  1. 왼쪽 탐색 패널에서 패키지 패키지 아이콘 탭을 클릭합니다.
  2. 변수 탭에서 삭제할 변수 옆에 있는 삭제 아이콘을 클릭합니다.
WARNING
삭제된 변수를 사용하는 함수의 작동이 중지됩니다.

종속성

일부 기능을 수행하려면 추가 라이브러리가 필요합니다. 종속성 탭에서는 이러한 라이브러리를 추가하고 관리할 수 있습니다.

라이브러리 추가

  1. 왼쪽 탐색 패널에서 패키지 패키지 아이콘 탭을 클릭합니다.

  2. 종속성 탭에서 쉼표로 구분하여 하나 이상의 라이브러리 이름을 입력하십시오. 특정 버전을 이름 뒤에 추가하여 요청할 수 있습니다(예: axios, lodash@4.17.21).

  3. 설치​를 클릭합니다.

라이브러리 제거

  1. 왼쪽 탐색 패널에서 패키지 패키지 아이콘 탭을 클릭합니다.
  2. 종속성 탭에서 제거할 라이브러리 옆에 있는 삭제 아이콘을 클릭합니다.
WARNING
제거된 라이브러리를 사용하는 함수가 작동을 중지할 수 있습니다.

기록

함수의 초안을 저장할 때마다 Fusion은 복사본을 유지합니다. 기록 탭에서는 이전 버전을 보고 복원할 수 있습니다.

  1. 왼쪽 탐색 패널에서 패키지 패키지 아이콘 탭을 클릭합니다.

  2. 내역 탭에서 왼쪽의 함수를 선택하여 저장된 최신 버전을 먼저 확인합니다.

  3. 해당 시간에 포함된 내용을 정확히 볼 버전을 선택합니다.

  4. 버전을 복원하려면 초안으로 복원​을 클릭하세요.

    버전이 새 초안으로 복원되므로 게시 전에 검토하고 테스트할 수 있습니다. 라이브 버전은 게시하기 전까지 그대로 유지됩니다.

  5. 버전을 삭제하려면 버전을 선택하고 버전 삭제​를 클릭한 다음 확인하십시오.

NOTE
  • 함수를 게시하면 기록이 지워집니다. 기록은 초안을 작성하는 동안 변경 사항을 게시하기 전까지 추적합니다.
  • 버전 삭제는 실행 취소할 수 없습니다.

시나리오에서 패키지 사용

함수 및 변수를 빌드하는 목적은 시나리오에 작동하도록 하는 것입니다. 함수와 변수를 사용하려면 Adobe App Builder 커넥터를 사용하십시오.

  • 패키지에서 함수 사용: 이 모듈은 시나리오에서 함수 중 하나를 실행합니다. 패키지와 함수를 선택하고 정의한 입력을 채우면 함수의 결과가 다음에 오는 모듈로 전달됩니다.
  • 패키지에서 변수 사용: 이 모듈은 패키지 변수 중 하나를 시나리오에 가져와 해당 값을 다른 모듈에 매핑할 수 있습니다.

자세한 내용 및 지침은 Adobe App Builder 모듈을 참조하세요.

recommendation-more-help
workfront-fusion-help-workfront-fusion