Azure DevOps 모듈
Adobe Workfront Fusion 시나리오에서는 Azure DevOps를 사용하는 워크플로를 자동화할 수 있으며 여러 제3자 애플리케이션 및 서비스에 연결할 수 있습니다.
시나리오 만드는 방법에 대한 지침은 시나리오 만들기: 문서 색인의 문서를 참조하십시오.
모듈에 대한 자세한 내용은 모듈: 문서 색인의 문서를 참조하십시오.
액세스 요구 사항
| table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header | |
|---|---|
| Adobe Workfront 패키지 |
모든 Adobe Workfront 워크플로 패키지 및 모든 Adobe Workfront 자동화 및 통합 패키지 Workfront Ultimate Workfront Prime 및 Select 패키지 및 Workfront Fusion 추가 구매. |
| Adobe Workfront 라이선스 |
표준 작업 이상 |
| Adobe Workfront Fusion 라이선스 |
운영 기반: 운영 기반 라이센스가 있는 조직에서 사용 가능 커넥터 기반(이전): 작업 자동화 및 통합을 위한 Workfront Fusion |
| 제품 | 조직에 Workfront 자동화 및 통합이 포함되지 않은 Select 또는 Prime Workfront 패키지가 있는 경우 Adobe Workfront Fusion을 구매해야 합니다. |
이 테이블의 정보에 대한 자세한 내용은 설명서의 액세스 요구 사항을 참조하십시오.
Adobe Workfront Fusion 라이선스에 대한 자세한 내용은 Adobe Workfront Fusion 라이선스를 참조하십시오.
전제 조건
Azure DevOps 모듈을 사용하려면 Azure DevOps 계정이 있어야 합니다.
Azure DevOps API 정보
Azure DevOps 커넥터는 다음을 사용합니다.
Azure DevOps를 Workfront Fusion에 연결 connect-azure-devops-to-workfront-fusion
EntraApp을 사용하여 Azure DevOps를 Workfront Fusion에 연결
-
시나리오에 Azure DevOps 모듈을 추가합니다.
-
연결 필드 옆에 있는 추가를 클릭합니다.
-
연결 유형 필드에서 사용할 연결 유형을 선택합니다.
note NOTE Azure DevOps(Entraapp)을(를) 사용하면 연결에 대한 모든 범위를 요청할 수 있습니다. -
다음 필드를 채웁니다.
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 layout-auto html-authored no-header 연결 이름 생성 중인 연결의 이름을 입력합니다. 조직 Azure DevOps 응용 프로그램을 만든 조직의 이름을 입력하십시오. 앱 ID 연결 중인 DevOps 애플리케이션의 ID를 입력합니다. 클라이언트 암호 연결 중인 DevOps 응용 프로그램의 클라이언트 암호를 입력합니다. 모든 범위 요청 Azure DevOps (EntraApp) 연결 유형을 사용하는 경우 이 옵션을 활성화하여 연결에 대한 모든 범위를 요청합니다. -
Azure DevOps 앱 ID 또는 클라이언트 암호를 입력하려면 고급 설정 표시를 클릭하고 열려 있는 필드에 해당 ID를 입력합니다.
-
연결 설정을 완료하고 시나리오 만들기를 계속하려면 계속을(를) 클릭합니다.
서비스 주체를 사용하여 Azure DevOps를 Workfront Fusion에 연결
개인 계정 대신 서비스 주체(애플리케이션 API 연결)를 사용하는 연결을 만들 수 있습니다. 이 기능은 연결을 특정 사용자가 아닌 응용 프로그램 또는 서비스 ID로 실행하려는 경우에 유용합니다. 이 기능은 예를 들어 해당 사용자가 회사를 퇴사하거나 암호를 변경하는 경우 통합이 중단되지 않도록 유용할 수 있습니다.
이 연결 유형은 모든 Azure DevOps 모듈에서 사용할 수 있습니다.
서비스 주체를 사용하여 Azure DevOps를 Workfront Fusion에 연결하기 위한 사전 요구 사항
이 연결을 만들려면 다음이 필요합니다.
- 전역 관리자 또는 응용 프로그램 관리자가 앱을 등록하기 위해 Microsoft Entra ID에 액세스합니다. 이 액세스 권한이 없는 경우 IT 또는 ID 팀의 사용자에게 해당 단계를 완료하도록 요청하십시오.
- 프로젝트 컬렉션 관리자 Azure DevOps 조직의 액세스 권한을 부여하여 서비스 주체를 구성원으로 추가합니다. 이 사용자는 Microsoft Entra ID를 관리하는 사용자와 다른 경우가 많습니다.
- Azure DevOps 조직의 이름입니다. Azure DevOps URL
dev.azure.com/<your organization name>에서 찾을 수 있습니다.
Microsoft Entra ID에서 앱 등록 만들기
- Microsoft Entra 관리 센터에 로그인합니다.
- 앱 등록 > 새 등록(으)로 이동합니다.
- 앱에 인식할 수 있는 명확한 이름을 지정합니다. 예:
Workfront Fusion Azure DevOps Integration. - 리디렉션 URI을 비워 둡니다. 이 연결은 브라우저를 통한 로그인을 포함하지 않습니다.
- 등록을 선택하세요.
- 클라이언트 암호를 만드세요.
클라이언트 암호 만들기
- 새 앱 등록에서 인증서 및 암호(으)로 이동합니다.
- 새 클라이언트 암호를 선택하고 설명을 추가한 다음 만료 기간을 선택하십시오.
- 추가를 선택합니다.
- 암호의 값을(를) 즉시 복사합니다. 한 번만 표시됩니다. 복사하기 전에 다른 곳으로 이동하면 새 파일을 만들어야 합니다.
- 연결 세부 정보 수집을 계속합니다.
연결 세부 정보 수집
-
앱 등록의 개요 페이지에서 다음 값을 참고하십시오. 모듈에서 연결을 만들 때 이를 입력합니다.
table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header 테넌트 ID 개요 페이지에서 디렉터리(테넌트) ID 레이블이 지정되었습니다. 클라이언트 ID 개요 페이지에서 응용 프로그램(클라이언트) ID 레이블이 지정되었습니다. 클라이언트 암호 클라이언트 암호 만들기에서 복사한 값입니다. 조직 Azure DevOps 조직 이름입니다. 예를 들어 URL이 dev.azure.com/yourorg인 경우yourorg을(를) 입력하십시오.note NOTE 앱 등록의 API 권한 영역을 건너뛸 수 있습니다. Azure DevOps를 추가하면 위임된 권한만 사용할 수 있습니다. 응용 프로그램 권한이 회색으로 표시됩니다. Azure DevOps에서는 이러한 방식으로 액세스 권한을 부여할 수 없기 때문에 예상된 결과입니다. 대신 다음 부분에서 액세스 권한이 Azure DevOps 내에서 직접 부여됩니다.
Azure DevOps 조직에 서비스 주체 추가
Microsoft Entra ID에서 앱을 등록하면 해당 ID만 생성됩니다. 아직 앱에 Azure DevOps 데이터에 대한 액세스 권한을 부여하지 않습니다. 이 절차에서는 해당 액세스 권한을 부여합니다.
-
dev.azure.com/<your organization name>에서 Azure DevOps 조직에 로그인합니다. -
왼쪽 아래에서 조직 설정을 선택한 다음 사용자를 선택합니다.
-
사용자 추가를 선택합니다.
-
검색 상자에서 앱 표시 이름으로 검색합니다. 이 이름은 앱을 등록할 때 지정한 이름입니다. 클라이언트 ID로 검색하지 마십시오.
-
액세스 수준 선택:
- 기본은(는) 일반적으로 작업 항목, 게시판 및 보고서를 읽고 쓰는 데 충분합니다.
- 워크플로우가 설정의 일부로 애자일, 스크럼 또는 사용자 지정 템플릿과 같은 사용 가능한 프로세스를 검색해야 하는 경우 대신 프로젝트 컬렉션 관리자 그룹에 서비스 사용자를 추가하십시오. 이는 더 광범위한 액세스 수준이므로 해당 기능이 필요한 경우에만 부여합니다.
-
조직의 일반적인 액세스 사례에 따라 필요한 특정 프로젝트 또는 프로젝트에 서비스 사용자를 할당합니다.
-
추가를 선택합니다.
-
연결 만들기를 계속합니다.
연결 만들기
-
모듈의 연결 설정 화면에서 서비스 사용자 연결 유형을 선택합니다.
-
다음을 입력하십시오.
- 테넌트 ID
- 클라이언트 ID
- 클라이언트 암호
- 조직
-
연결을 저장합니다.
모든 것이 올바르게 설정되면 연결이 성공적으로 검증됩니다.
Azure DevOps 모듈 및 해당 필드
Azure DevOps 모듈을 구성할 때 Workfront Fusion은 아래 나열된 필드를 표시합니다. 이와 함께 앱 또는 서비스의 액세스 레벨과 같은 요인에 따라 추가적인 Azure DevOps 필드가 표시될 수 있습니다. 모듈의 굵은 글씨 제목은 필수 필드를 나타냅니다.
필드 또는 함수 위에 있는 맵 버튼을 보면 해당 필드의 변수와 함수를 설정하는 데 사용할 수 있습니다. 자세한 내용은 한 모듈에서 다른 모듈로 정보 매핑을 참조하십시오.
트리거
작업 항목 보기
이 인스턴트 트리거 모듈은 Azure DevOps에서 레코드를 추가, 업데이트 또는 삭제할 때 시나리오를 실행합니다.
모듈은 연결에서 액세스하는 모든 사용자 정의 필드 및 값과 함께 레코드와 연결된 모든 표준 필드를 반환합니다. 시나리오의 후속 모듈에서 이 정보를 매핑할 수 있습니다.
이 모듈을 구성할 때 다음 필드가 표시됩니다.
액션
레코드 만들기
이 작업 모듈은 새 프로젝트 또는 작업 항목을 만듭니다.
모듈은 새로 생성된 작업 항목에 대한 개체 ID나 새로 생성된 프로젝트의 URL 및 상태 코드를 출력합니다.
사용자 정의 API 호출
이 액션 모듈을 사용하면 Azure DevOps API에 인증된 사용자 정의 호출을 수행할 수 있습니다. 이렇게 하면 다른 Azure DevOps 모듈로는 수행할 수 없는 데이터 흐름 자동화를 만들 수 있습니다.
이 모듈을 구성할 때 다음 필드가 표시됩니다.
이 API 호출에 연결할 상대 URL을 입력합니다.
예: {organization}/_apis[/{area}]/{resource}
표준 JSON 오브젝트 형태로 요청의 헤더를 추가합니다.
예: {"Content-type":"application/json"}
표준 JSON 오브젝트 형식으로 API 호출에 대한 쿼리를 추가합니다.
예: {"name":"something-urgent"}
표준 JSON 오브젝트 형식으로 API 호출에 대한 본문 콘텐츠를 추가합니다.
메모:
JSON에서 if와 같은 조건문을 사용할 때는 따옴표를 조건문 외부에 배치해야 합니다.
첨부 파일 다운로드
이 작업 모듈은 첨부 파일을 다운로드합니다.
모듈은 첨부 파일의 내용을 반환합니다.
작업 항목 연결
이 작업 모듈은 두 작업 항목을 연결하고 두 작업 항목 간의 관계를 정의합니다.
레코드 읽기
이 작업 모듈은 Azure DevOps의 단일 레코드에서 데이터를 읽습니다.
레코드의 ID를 지정합니다.
모듈은 연결에서 액세스하는 모든 사용자 정의 필드 및 값과 함께 레코드의 ID와 모든 연결된 필드를 반환합니다. 시나리오의 후속 모듈에서 이 정보를 매핑할 수 있습니다.
이 모듈을 구성할 때 다음 필드가 표시됩니다.
작업 항목 업데이트
이 작업 모듈은 해당 ID를 사용하여 기존 작업 항목을 업데이트합니다.
업데이트된 작업 항목의 ID가 반환됩니다.
첨부 파일 업로드
이 작업 모듈은 파일을 업로드하고 작업 항목에 첨부합니다.
모듈은 첨부 파일 ID 및 첨부 파일의 다운로드 URL을 반환합니다.
검색 결과
작업 항목 나열
이 작업 모듈은 Azure DevOps 프로젝트에서 특정 형식의 모든 작업 항목을 검색합니다.
모듈은 기본 작업 항목의 ID 및 연결된 필드와 연결이 액세스하는 모든 사용자 지정 필드 및 값을 반환합니다. 시나리오의 후속 모듈에서 이 정보를 매핑할 수 있습니다.
이 모듈을 구성할 때 다음 필드가 표시됩니다.