일괄처리 업데이트 태스크는 데이터를
마이그레이션하고 IBM® Rational®
Asset Manager 서버로 자산을 이동하는 데 유용합니다. 파일 시스템
옵션을 사용하여 일괄처리 업데이트 태스크를 확장할 수 있으며 모든 유형의
소스 데이터를 읽고 자산에 맵핑하도록 태스크를 확장할 수 있습니다.
이 태스크 정보
일괄처리 업데이트 태스크 확장
모든
유형의 소스 데이터를 읽고 Rational Asset
Manager의 자산에 맵핑하도록 일괄처리 업데이트 태스크를 확장할 수
있습니다.
Rational Asset
Manager 일괄처리 업데이트 태스크는 매번 자산을 작성하는 대신,
자산을 찾고 병합을 수행하여 지능형 맵핑을 수행합니다.
com.ibm.ram.rich.ui.extension
플러그인에는 파일 시스템 확장기능의 소스가 있으며 설치된
Rational Asset Manager Eclipse 클라이언트의
일부분으로 /plugins 폴더에 있습니다.
/eclipse/plugins/com.ibm.ram.rich.ui.extension_7.5.2.3.v.jar의 Eclipse 클라이언트 설치에서 JAR 파일을 찾을 수 있습니다.
압축을 풀 때 /src 디렉토리에서 Java™ 파일을
찾을 수 있습니다.
filesys 확장기능
코드는 두 개의 디렉토리 src\com\ibm\ram\internal\batch\filesystem\, src\com\ibm\ram\internal\batch\filesystem\ui\에 있습니다.
확장기능과
데이터 소스 준비
모든 데이터 소스를 위해
확장기능과 데이터를 준비하려면 다음을 수행하십시오.
- Rational Asset Manager로 이동되는 데이터를 판별하십시오.
- 업로드할 데이터를 준비하십시오.
- Rational Asset Manager 일괄처리 업데이트 태스크 클래스를 확장하는 Eclipse 플러그인을
작성하십시오.
- Eclipse 플러그인을 빌드하고 배치하십시오.
예 섹션에서 Microsoft Excel이
데이터 소스입니다. Excel 스프레드시트에 대해 작업하여 1단계와 2단계를
처리하십시오.
파일 시스템 옵션을 사용하여 일괄처리 업데이트
태스크로 확장하려면 새 플러그인 프로젝트를 작성하고 확장점의
확장기능을 구현해야 합니다.
일괄처리
업데이트 태스크는 구현할 두 개의 확장점인 batchDataSource와
batchDataSourceUI를 제공합니다.
두 개의 확장점을 통해 일괄처리 업데이트
태스크를 구현할 수 있습니다.
- batchDataSource: com.ibm.ram.rich.core 플러그인은
batchDataSource 확장점을 제공합니다. 이러한 확장점을 사용하여
Rational Asset Manager 일괄처리 클라이언트에 대한 데이터 소스 확장자를 정의할 수 있습니다.
일괄처리 업데이트에서 batchDataSource 확장점은 저장소의 데이터를 가져와서
Rational Asset Manager 서버로 마이그레이션합니다.
- batchDataSourceUI: com.ibm.ram.rich.ui.extension 플러그인은
batchDataSourceUI 확장점을 제공합니다. 이러한 확장점을 사용하여
Rational Asset Manager 일괄처리 업데이트
편집기에 사용자 인터페이스 요소를 제공할 수 있습니다.
간단해진 파일 시스템 확장기능
다음은
배치 가능한 플러그인으로 내보낼 수 있는 간단한 버전의 파일 시스템
확장기능입니다. 이 파일 시스템 확장기능은 폴더와
지정된 루트 폴더의 .zip 파일에서 자산을 작성합니다. 예에서는
루트 폴더를 사용하며 서브폴더 또는 .zip 파일이 자산이 됩니다.
서브폴더 또는 아카이브 파일의 이름이 자산의 이름이
됩니다. 필수 .asset_info 파일을 제외하고
서브폴더/파일의 컨텐츠가 아티팩트가 됩니다.
Rational
Asset Manager 일괄처리 API 클래스를 확장하는
두 개의 Java 클래스가
있습니다.
- FileSystemBatchDataSource.java - BatchDataSource를
확장합니다.
- FileSystemBatchUIContributor.java - AbstractBatchUIContributor를
확장합니다.
FileSystemBatchDataSource 클래스는 루트 경로에 기반하여
자산을 작성하고 리턴합니다. 일괄처리 클라이언트 확장기능이
폴더와 지정된 루트 폴더의 .zip 파일에서 자산을 작성하도록
데이터 소스를 지정하십시오. 이러한 폴더와 .zip 파일에는
.asset_info 파일이 있어야 합니다.
.asset_info 파일
컨텐츠는 .properties 파일의 형식(주로 행 당 하나의 키=값 쌍)이어야 하며
자산의 특정 특성이 있어야 합니다.
FileSystemBatchDataSource.java 파일을 참조하십시오.
- name(선택사항. 생략한 경우 파일/폴더 이름을 사용함)
- version(선택사항. 생략한 경우 1.0을 사용함)
- community(필수)
- asset_type(필수)
- short_description(선택사항. 생략한 경우 파일/폴더 이름을
사용함)
- description(선택사항)
FileSystemBatchUIContributor 클래스는 사용자가 루트 디렉토리를
선택할 수 있는 디렉토리 선택 대화 상자를 열고 자산을 작성하는
선택사항을 사용하여 새 데이터 소스를 작성합니다.
루트 디렉토리의 필수 구조는
FileSystemBatchDataSource java 파일을 참조하십시오.
간단한
파일 시스템 예를 일괄처리 클라이언트에 연결하는 데 사용하는 확장점은
plugin.xml 파일에 정의되어 있습니다.
<?xml version="1.0" encoding="UTF-8"?>
<?eclipse version="3.4"?>
<plugin>
<extension point="com.ibm.ram.rich.core.batchDataSource">
<dataSourceType
class="com.ibm.ram.batch.example.FileSystemBatchDataSource"
id="com.ibm.ram.batch.example.filesystem">
</dataSourceType>
</extension>
<extension point="com.ibm.ram.rich.ui.extension.batchDataSourceUI">
<batchDataSourceUI
class="com.ibm.ram.batch.example.FileSystemBatchUIContributor"
dataSourceID="com.ibm.ram.batch.example.filesystem"
icon="icon.gif"
name="File System Example">
</batchDataSourceUI>
</extension>
</plugin>
이러한 확장기능의 코드 예는
일괄처리 업로드 파일 시스템 확장기능 사용에 있습니다.
Rational Asset
Manager Java API를 사용하여
일괄처리 업로드 조작을 실행하고 여러 자산을 업로드할 수도
있습니다. 일괄처리 업로드 수행의 내용을 참조하십시오.
예제
이 예에서는
Microsoft Excel 파일의 확장기능을 작성하는 방법을
설명합니다. 이 예에서 Microsoft Excel
파일이 데이터 소스이고 일괄처리 업데이트 태스크 확장기능이
Eclipse 플러그인으로 빌드됩니다. 일괄처리 업데이트 태스크는 형식화된
Excel 파일을 읽고 Excel 행을 Rational Asset Manager의 자산에 맵핑합니다. 그런 다음, 사용자는
Rational Asset Manager에 데이터를 제출하기 전에 데이터를
수정할 수 있습니다. 일괄처리 업로드 예도 참조하십시오.
데이터 소스
준비
Excel 스프레드시트를 업로드하기 전에
스프레드시트를 형식화해야 합니다. 이 예에서 스프레드시트는
다음과 같이 형식화됩니다.
표 1. | |
A |
B |
C |
D |
E |
F |
| 1 |
자산 유형: 컴파일러 |
커뮤니티: 기술 인프라스트럭처 |
|
|
|
|
| 2 |
자산: GUID |
자산: 버전 |
자산: 이름 |
자산 속성: 작성자 |
카테고리 스키마: 라이센스 |
무시: IDE |
- 스프레드시트의 처음 두 행은 Rational
Asset Manager에 맵핑할 정보 모델에 대해
설명합니다.
- 첫 번째 행에는 자산 유형과 커뮤니티가 표시됩니다. 샘플의 셀
형식(예: "자산 유형: 컴파일러")을 사용하십시오.
- 두 번째 행에는 자산 레벨 맵핑이 표시됩니다. 예를 들어, 다음과 같습니다.
- 자산: GUID
- 자산: 버전
- 자산: 이름
- 자산 속성: <attribute name>
- 카테고리 스키마: <category schema name>
행에는 "a/b/c" 형식을 사용하는 스키마의 값이 있습니다.
- 무시: <name> 이 열은 업로드 시
무시됩니다.
자산의 행에 값이 없는 경우
Rational Asset Manager에서 자산이 작성됩니다.
그렇지 않으면 병합을 수행합니다.
- 1행과 2행 다음의 행이 자산으로 맵핑됩니다.
열 표제는 이 자산의 구문 분석기가 사용하는 특수
형식을 사용합니다. 1행과 2행은 예약되어 있습니다. 1행에는
자산 유형과 커뮤니티 선언이 있습니다. 2행에는 GUID, 버전,
이름, 자산 속성과 같은 자산 열에 대한 설명이 있습니다.
예상 형식을 보려면 샘플 스프레드시트를 참조하십시오.
Eclipse 플러그인
작성
코드는 일반 Eclipse 플러그인으로 구조화되어
있습니다. 확장점을 정의하십시오.
Rational Asset
Manager 일괄처리 업데이트 태스크 클래스를 확장하는 Eclipse 플러그인을
작성할 때 다음 가이드라인을 따르십시오.
- Eclipse 플러그인 마법사를 사용하여 활성자 클래스를 작성하십시오.
- 이 경우 최소한 ExcelBatchDataSource, ExcelBatchUIContributor와 같은
두 개의 클래스를 작성하십시오. 데이터 소스 클래스에
구문 분석 논리를 삽입하십시오.
- Eclipse에서 일괄처리 업데이트 태스크를 실행할 때 데이터 소스를
선택하고 Rational Asset Manager의 연결을
선택하십시오.
- 클라이언트에서 Rational Asset Manager의 연결을 선택하면
데이터 소스 클래스에서 fetchAssets 메소드를 호출합니다. ExcelBatchDataSource.fetchAssets()
메소드를 사용하십시오. 여기에서 대부분의 구문 분석 코드가 발생합니다. 참고: 코드에서
Rational Asset
Manager 세션 오브젝트가 필요하지 않습니다.
- 워크시트를 얻으려면 createSpreadsheetAssets를 호출하고
Excel 워크북 오브젝트를 여십시오.
- GUID를 처리하려면 새로 작성하십시오. 그러나 자산: GUID 열을
찾은 경우 자산을 이와 같이 설정하십시오. 일괄처리 업데이트 태스크가
자산을 작성하는 대신 업데이트를 수행합니다.
- 각 행에서 업로드할 열을 선택하여 자산에
맵핑하십시오.
새 플러그인 프로젝트를 작성하려면 다음을 수행하십시오.
- Eclipse 메뉴에서 를 클릭하십시오.
- 를 펼치십시오.
- 프로젝트 이름을 입력하십시오.
- 다음을 클릭하십시오.
- 완료를 클릭하십시오. MANIFEST.MF 파일이
열립니다.
- 종속성 편집기 탭을 여십시오.
- 필수 플러그인 섹션에서 추가를 클릭하십시오.
- com.ibm.ram.rich.ui.extension 플러그인을 선택하고 확인을 클릭하십시오.
- 완료를 클릭하십시오.
- 필수 플러그인 섹션에서 추가를 클릭하십시오.
- com.ibm.ram.rich.ui.extension.batchDataSourceUI 확장점을
선택하십시오.
- 완료를 클릭하십시오.
- MANIFEST 파일을 저장하십시오.
일괄처리 업데이트 태스크는 Rational Asset Manager에 대한 자산 제출을 수행합니다.
일괄처리
업데이트 태스크 사용
이 예에서 Eclipse
플러그인이 시스템에 배치됩니다.
Excel 파일을 사용하여 새 자산을 작성하고 일괄처리 업로드 조작으로 제출하기 위해
Rational Asset Manager Excel 일괄처리 업데이트
확장기능을 실행하려면 다음 단계를 수행하십시오.
- 를 클릭하십시오.
- Excel 데이터 소스를 선택하고 Excel 파일을 선택하십시오. Rational Asset Manager 일괄처리
업데이트 편집기가 표시됩니다.
- Rational Asset Manager에 맵핑할 데이터 소스의 아이콘을 클릭하십시오. 이 아이콘에
Excel 아이콘이 있습니다. 준비된 Excel 파일로 이동하는 데 사용된
파일 탐색기가 표시됩니다.
- Eclipse 작업공간에 정의된 Rational
Asset Manager 저장소 연결을 선택하십시오.
- 자산이 업로드되는 대상 Rational Asset
Manager 저장소를 선택하십시오. 이 예에서
자산은 로컬 시스템의 Rational Asset
Manager 인스턴스에 업로드됩니다.
- Rational Asset Manager에 대한
맵핑을 완료하려면 커뮤니티와 같은 구성 항목을 추가하고 카테고리를
맵핑하십시오.
대상 Rational Asset Manager 저장소를 선택한 후 일괄처리 편집기는
Excel 파일을 읽고 대상 Rational Asset Manager 인스턴스에 맵핑합니다. 이 경우
자산이 업로드되지 않습니다. Rational Asset
Manager 일괄처리 편집기가 초기 맵핑에 대한 요약을 제공합니다. 이 예에서
Excel 파일의 자산은 일괄처리 편집기가 Rational Asset Manager에서 찾을 수 없는 특정
Rational Asset Manager 커뮤니티를 대상으로 지정했습니다. 액세스 권한이 있는
사용자는 커뮤니티를 즉시 작성할 수 있습니다. 이 예를 참조하십시오.
맵핑 활동은 자산 유형, 자산 버전 정보, 관계 유형 등을
계속 확인합니다. 각 경우에
사용자는 Rational Asset Manager의 기존 구성 정보에
맵핑할 수 있거나 액세스 권한이 있는 경우 해당 정보를 추가할 수 있습니다.
- 맵핑이 완료되면 모든 자산 업데이트 단추를
클릭하십시오. 자산이 Rational Asset Manager에 업로드됩니다. 일괄처리 편집기에
업로드의 결과가 표시됩니다.
클래스 구조와 오브젝트
Rational Asset Manager API에는
자산에 대한 두 가지 주요 클래스 구조가 있습니다.
- 이름이 "RAM"으로 시작하는 클래스(예: RAMAsset
클래스).
- 이름이 "RAM"으로 시작하지 않는 클래스(예: Asset
클래스).
RAM 클래스의 오브젝트는 Rational Asset Manager 세션 오브젝트가
필요한 Rational Asset Manager 서버에서 검색되지만
이 예에서는 세션 오브젝트를 사용하지 않습니다. 클래스의 오브젝트(예: Asset)는
알려진 Rational Asset Manager 세션없이 작성되고
일괄처리 업데이트 태스크에 제공된 후
Rational Asset Manager로 제출되거나 업데이트됩니다.