툴링 사용자 가이드

REST 탭을 클릭하여 가장 높은 DSL 구성 요소를 확인합니다.

REST 구성 섹션에는 다음 구성 옵션이 표시됩니다.

REST 요소 또는 REST 작업을 클릭하여 속성 보기에서 해당 속성을 확인합니다.

경로 편집기의 소스 탭을 클릭한 다음 코드를 편집합니다.

필요한 경우 Window → Perspective → Open Perspective → Fuse Integration 을 선택하여 Fuse 통합 관점으로 전환합니다.

서버 보기에서 서버를 사용할 수 없는 서버 없음 링크를 클릭합니다. 이 링크를 클릭하여 새 server…​ 를 생성하여 새 서버 정의 마법사를 엽니다. 이 링크는 서버 보기에 서버 항목이 없는 경우에만 표시됩니다.

그렇지 않으면 서버 보기를 마우스 오른쪽 버튼으로 클릭하여 컨텍스트 메뉴를 연 다음 새 → 서버 를 선택하여 새 서버 정의 마법사를 엽니다.

Red Hat JBoss Middleware → Red Hat Container Development Kit 3.2+ 를 선택합니다.

기본값을 적용합니다.

다음과 같이 인증 정보를 설정합니다.

OK (확인)를 클릭하여 이제 채워진 Red Hat Container Development Environment 페이지로 돌아갑니다. 예를 들면 다음과 같습니다.

서버 보기에서 컨테이너 개발 환경 3 [중지, 동기화] 를 선택한 다음 서버 메뉴 모음에서 을 클릭합니다.

콘솔 보기가 열리고 시작 프로세스의 상태가 표시됩니다.

시작 프로세스가 완료되면 Servers (서버) 보기가 표시됩니다.

OpenShift Explorer 보기로 전환합니다.

가상 OpenShift 서버 인스턴스 developer 도 실행 중입니다.

https://192.168.99.100:8443 은 OpenShift 개발자 웹 콘솔의 URL 예입니다. 설치에 인스턴스의 URL이 표시됩니다. 자세한 내용은 6.6절. “OpenShift 웹 콘솔에 액세스” 에서 참조하십시오.

새 프로젝트의 속성을 다음과 같이 설정합니다.

완료를 클릭합니다.

새로운 OpenShift 프로젝트(이 예제에서는 New FIS Test newtest)가 OpenShift Explorer 탭에 나타납니다. (이 예제에서는 developer https://192.168.99.100:8443 )

OpenShift Explorer 보기에서 New FIS Test newtest 를 선택하면 속성 보기에 프로젝트의 세부 정보가 표시됩니다. 예를 들면 다음과 같습니다.

Project Explorer 보기에서 상황에 맞는 메뉴를 마우스 오른쪽 버튼으로 클릭한 다음 새 → Fuse Integration Project 를 선택하여 프로젝트 이름 선택 페이지를 엽니다.

프로젝트 이름 필드에 사용 중인 작업 영역에 고유한 이름을 입력합니다(예: myFISproject ).

다른 옵션의 기본값을 적용합니다.

다음 을 클릭하여 대상 런타임 선택 페이지를 엽니다.

Target Runtime (런타임없음)(런타임이 선택됨) 및 Camel 버전에 대한 기본값을 그대로 둡니다.

다음 을 클릭하여 고급 프로젝트 설정 페이지를 엽니다.

Spring Boot - Spring DSL 템플릿을 사용하여 단순 로그를 선택합니다.

완료를 클릭합니다.

사이드바 메뉴에서 OpenShift에서 Maven Build → Deploy <projectname>을 선택하여(이 예에서는 OpenShift 에서 myFISproject 배포)를 선택하여 프로젝트의 기본 실행 구성을 엽니다.

기본 설정은 Main 탭에 있는 대로 그대로 둡니다.

JRE 탭을 열어 VM 인수에 액세스합니다.

VM 인수 창에서 -Dkubernetes.namespace=test 인수의 값을 생성한 경우 OpenShift 프로젝트에 사용한 프로젝트 이름과 일치하도록 변경합니다( 6.3절. “새 OpenShift 프로젝트 생성” OpenShift 프로젝트 이름 ).

이 예제에서는 기본 값 test 를 newtest 로 변경합니다.

OpenShift 구성에 따라 다른'VM 인수를 수정하여 이를 지원해야 할 수 있습니다.

적용 을 클릭한 다음 실행 을 클릭합니다.

다운로드할 종속성 수로 인해 최초 배포에는 다소 시간이 걸릴 수 있습니다. 컴퓨터 및 인터넷 연결의 속도가 요인에 기여하고 있습니다. 일반적으로 첫 번째 배포를 완료하는 데 25~35분이 걸립니다.

콘솔 보기에서 배포 프로세스의 진행 상황을 추적할 수 있습니다. 다음 출력에서 *Pushing 이미지 172.30.1 …​ 항목. * 프로젝트가 성공적으로 빌드되고 애플리케이션 이미지가 Docker 컨테이너를 빌드하는 데 사용될 OpenShift로 푸시되고 있음을 나타냅니다.

배포가 완료되면 콘솔 보기에 BUILD SUCCESS 가 표시됩니다.

OpenShift Explorer 보기로 전환하고 새 FIS Test newtest 를 선택합니다.

속성 보기의 세부 정보 페이지에 프로젝트의 모든 속성 값이 표시됩니다.

다른 탭(빌드,Build Configs,Deployments.…​)을 열어 프로젝트의 다른 속성을 확인합니다. 속성 보기는 OpenShift 웹 콘솔과 동일한 정보를 제공합니다.

OpenShift Explorer 보기에서 camel-ose-springboot-xml 을 선택하여 속성 보기에서 세부 정보를 확인합니다.

다른 탭을 스크롤하여 배포 구성의 다른 속성을 봅니다.

OpenShift Explorer 보기에서 camel-ose-springboot-xml-1-mdmtd Pod Running 을 선택한 다음 Properties 보기에서 실행 중인 인스턴스의 세부 정보를 확인합니다.

OpenShift Explorer 보기에서 camel-ose-springboot-xml-1-mdmtd 포드를 마우스 오른쪽 버튼으로 클릭한 다음 Pod Logs…​ 을 선택합니다.

콘솔 보기가 자동으로 열리고 실행 중인 Pod의 로그가 표시됩니다.

콘솔 뷰 메뉴 모음에서 를 클릭하여 세션을 종료하고 콘솔 출력을 지웁니다.

새 Fuse 통합 프로젝트 생성 ( 파일 → 새 → Fuse Integration Project선택).

마법사의 다음 정보를 제공합니다.Provide the following information in the wizard:

& lt;route id="_route1"/> 를 다음 코드로 바꿉니다.

<route id="_route1">
  <from id="_from1" uri="file:src/data?fileName=abc-order.xml&amp;noop=true"/>
  <setHeader headerName="approvalID" id="_setHeader1">
    <simple>AUTO_OK</simple>
  </setHeader>
  <to id="_to1" uri="file:target/messages?fileName=xyz-order.json"/>
</route>

Design 탭을 클릭하여 경로의 그래픽 표시로 돌아갑니다.

데이터 변환 패턴을 클릭한 다음 캔버스에서 SetHeader1 및 To_to1 노드 간의 화살표를 클릭합니다.

새로운 변환 마법사 가 Dozer 파일 경로 필드를 자동으로 입력하여 열립니다.

나머지 필드를 입력합니다.

다음을 클릭합니다.

소스 데이터의 형식 정의를 제공하기 위해 XML 스키마(default) 또는 예제 XML 인스턴스 문서 중 하나를 지정하는 XML (소스 유형) 정의 페이지가 열립니다.

소스 파일의 경우 소스 데이터의 유형 정의에 사용할 XML 스키마 파일 또는 XML 인스턴스 파일의 위치를 찾아 선택합니다(이 경우 abc-order.xsd).

XML 구조 프리뷰 창에는 XML 구조의 미리 보기가 표시됩니다.

Element root 필드에 ABCOrder 를 입력합니다.

툴링은 이 텍스트를 사용하여 매핑할 소스 데이터 항목을 표시하는 창에 레이블을 지정합니다.

이제 소스 유형(XML) 정의 페이지는 다음과 같아야 합니다.

Next 를 클릭하여 대상 유형(JSON) 정의 페이지를 엽니다. 대상 데이터의 유형 정의를 지정하는 위치입니다.

JSON 인스턴스 문서를 클릭합니다.

대상 파일 필드에 xyz-order.json 인스턴스 문서의 경로를 입력하거나 찾습니다. JSON 구조 프리뷰 창에 JSON 데이터 구조의 미리 보기가 표시됩니다.

매핑 패널의 왼쪽 및 오른쪽에 있는 소스 및 대상 패널의 모든 항목을 확장 합니다.

소스 패널에서 데이터 항목을 끌어서 대상 패널의 해당 데이터 항목에 놓습니다.

예를 들어 Source 패널에서 customerNum 데이터 항목을 끌어서 Target 패널의 custId 데이터 항목에 놓습니다.

매핑이 Mappings 패널에 표시되고 원본 및 대상 데이터 항목의 세부 정보가 세부 정보 창의 아래에 표시됩니다.

모든 기본 매핑을 완료할 때까지 소스 데이터 항목을 해당 대상 데이터 항목에 계속 끌어 놓습니다.

시작 예에서 매핑 할 나머지 데이터 항목은 다음과 같습니다.

소스 및 대상 패널에서 모두 를 클릭하여 모든 데이터 항목이 매핑되었는지 여부를 신속하게 확인합니다.

매핑되지 않은 데이터 항목만 소스 및 대상 패널에 나열됩니다.

시작 예에서 나머지 unmapped Target 속성은 approvalCode 및 origin 입니다.

청사진.xml 탭을 클릭하여 경로의 그래픽 디스플레이로 돌아갑니다.

새 변환 테스트 마법사에서 다음 값을 설정합니다.In the New Transformation Test wizard, set the following values:

변환 메서드에 다음 코드를 추가합니다.Add the following code to the transform method:

startEndpoint.sendBodyAndHeader(readFile("src/data/abc-order.xml"), "approvalID", "AUTO_OK");

파일 → 저장 을 클릭합니다.

이 튜토리얼의 어느 시점에서든 변환 파일에서 JUnit 테스트를 실행할 수 있습니다.

이를 마우스 오른쪽 버튼으로 클릭하여 컨텍스트 메뉴를 열고 Run as JUnit Test 를 선택합니다.

JUnit Test 창이 열리고 테스트 상태를 표시합니다. 작업 영역을 충돌하지 않도록 하려면 콘솔 보기 근처의 아래쪽 패널에서 창을 드래그 앤 드롭합니다.

소스 패널에서 변수 보기를 클릭합니다.

변수 보기에서 를 클릭하여 새 변수 이름 입력 대화 상자를 엽니다.

생성할 변수의 이름을 입력합니다.

시작 예에서는 ORIGIN 을 입력합니다.

OK를 클릭합니다.

새로 생성된 변수 ORIGIN 은 Name 열의 변수 보기에 표시되고 Value 열의 기본값 ORIGIN 이 표시됩니다.

새 변수 ORIGIN 을 대상 패널의 원본 데이터 항목으로 끌어다 놓습니다.

변수 $(ORIGIN) 의 새 매핑이 Mappings 패널 과 세부 정보 창에 표시됩니다.

TransformationTest.java 파일에서 JUnit 테스트를 실행합니다. 자세한 내용은 8.4절. “변환 테스트 파일 생성 및 JUnit 테스트 실행”의 내용을 참조하십시오.

콘솔 보기에 JSON 형식의 출력 데이터가 표시됩니다.

{"custId":"ACME-123","priority":"GOLD","orderId":"ORDER1","origin":"Web",
"approvalCode":"AUTO_OK","lineItems":[{"itemId":"PICKLE","amount":1000,"cost":2.25},
{"itemId":"BANANA","amount":400,"cost":1.25}]}

을 클릭하여 매핑 패널에 빈 변환 맵을 추가합니다.

Target 패널에서 approvalCode 데이터 항목을 Mappings 패널에서 새로 생성된 매핑의 대상 필드로 끌어서 놓습니다.

또한 approvalCode 데이터 항목이 세부 정보 창의 대상 상자에 표시됩니다.

세부 정보 창에서 Cryostat Order 소스 상자에서 를 클릭하여 드롭다운 메뉴를 엽니다.

메뉴 옵션은 선택한 데이터 항목의 데이터 유형에 따라 다릅니다. 사용 가능한 옵션은 굵게 표시됩니다.

식을 선택하여 식을 엽니다.Select Set expression to open the expression dialog.

언어 언어의 사용 가능한 언어 목록에서 사용할 식 언어를 선택합니다.In Language, select the expression language to use from the list of those available. 사용 가능한 옵션은 데이터 항목의 데이터 유형에 따라 다릅니다.

시작 예제에서는 헤더 를 선택합니다.

세부 정보 창에서 사용할 식의 소스를 선택합니다.In the details pane, select the source of the expression to use.

옵션은 Value 및 Script 입니다.

시작 예제의 경우 값 을 클릭한 다음 ApprovalID 를 입력합니다.

OK를 클릭합니다.

Mappings 패널 과 세부 정보 창에 모두 대상 데이터 항목 approvalCode 의 새 매핑이 표시됩니다.

TransformationTest.java 파일에서 JUnit 테스트를 실행합니다. 자세한 내용은 8.4절. “변환 테스트 파일 생성 및 JUnit 테스트 실행”의 내용을 참조하십시오.

콘솔 보기에 JSON 형식의 출력 데이터가 표시됩니다.

{"custId":"ACME-123","priority":"GOLD","orderId":"ORDER1","origin":"Web",
"approvalCode":"AUTO_OK","lineItems":[{"itemId":"PICKLE","amount":1000,"cost":2.25},
{"itemId":"BANANA","amount":400,"cost":1.25}]}

매핑 패널에서 customer Num 매핑을 선택하여 세부 정보 창을 채웁니다.

세부 정보 창에서 Cryostat Order 소스 상자에서 를 클릭하여 드롭다운 메뉴를 엽니다.

사용자 지정 변환 추가 를 선택하여 사용자 지정 변환 추가 페이지를 엽니다.

클래스 필드 옆에 있는 를 클릭하여 새 Java 클래스 생성 마법사를 엽니다.

다음 필드를 수정합니다.

완료를 클릭합니다.

사용자 지정 변환 추가 페이지 가 자동으로 채워지는 Class 및 Method 필드로 열립니다.

확인 을 클릭하여 Java 편집기에서 MyCustomMapper.java 파일을 엽니다.

대괄호 메서드를 편집하여 마지막 줄 반환 null 을 다음과 같이 변경합니다.

return "[" + input + "]";

transformation.xml 탭을 클릭하여 변환 편집기로 다시 전환합니다.

세부 정보 창에 대괄호 메서드가 customerN um 데이터 항목과 연결되었음을 확인할 수 있습니다.

대괄호 메서드 는 대상 시스템으로 전송되기 전에 소스 입력에서 실행됩니다.

TransformationTest.java 파일에서 JUnit 테스트를 실행합니다. 자세한 내용은 8.4절. “변환 테스트 파일 생성 및 JUnit 테스트 실행”의 내용을 참조하십시오.

콘솔 보기에 JSON 형식의 출력 데이터가 표시됩니다.

{"custId":"[ACME-123]","priority":"GOLD","orderId":"ORDER1","origin":"Web",
"approvalCode":"AUTO_OK","lineItems":[{"itemId":"PICKLE","amount":1000,"cost":2.25},
{"itemId":"BANANA","amount":400,"cost":1.25}]}

Mappings 패널에서 매핑 id ECDHE-databind> itemId 를 선택하여 세부 정보 창에 매핑을 표시합니다.

소스 상자에서 를 클릭하여 드롭다운 메뉴를 열고 속성 설정을 선택합니다.

속성 선택 페이지에서 헤더 노드를 확장하고 customerNum 을 선택합니다. 확인 을 클릭하여 변경 내용을 저장합니다.Click OK to save the changes.

세부 정보 창에 XyzOrder 에 lineItems 필드가 있음을 확인할 수 있습니다. lineItems 옆에 있는 토글 버튼을 클릭하여 값을 1 로 늘립니다.

세부 정보 창에는 lineItems 컬렉션에 있는 두 번째 항목의 itemId 에 매핑된 customerNum 이 표시됩니다.

TransformationTest.java 파일에서 JUnit 테스트를 실행합니다. 자세한 내용은 8.4절. “변환 테스트 파일 생성 및 JUnit 테스트 실행”의 내용을 참조하십시오.

콘솔 보기에 JSON 형식의 출력 데이터가 표시됩니다.

{"custId":"[ACME-123]","priority":"GOLD","orderId":"ORDER1","origin":"Web",
"approvalCode":"AUTO_OK","lineItems":[{"amount":1000,"cost":2.25},
{"itemId":"ACME-123","amount":400,"cost":1.25}]}

변환 패널에서 세부 정보 창을 채우려면 우선 순위 매핑 상태를 선택합니다.

소스 상자에서 를 클릭하여 드롭다운 메뉴를 열고 변환 추가 를 선택합니다.

변환 창에서 append 를 선택하고 Arguments 창에서 접미사 값으로 -level 을 입력합니다.

이 append 함수는 대상 우선 순위 데이터 항목에 매핑하기 전에 상태 문자열의 끝에 지정된 접미사를 추가합니다.

OK를 클릭합니다.

기본적으로 세부 정보 창에는 사용자 친화적인 형식으로 상태 데이터 항목에 append 함수를 추가하는 결과가 표시됩니다. 소스 상자에서 대부분의 를 클릭하고 표준 형식 표시를 선택하여 이 형식을 변경할 수 있습니다.

TransformationTest.java 파일에서 JUnit 테스트를 실행합니다. 자세한 내용은 8.4절. “변환 테스트 파일 생성 및 JUnit 테스트 실행”의 내용을 참조하십시오.

콘솔 보기에 JSON 형식의 출력 데이터가 표시됩니다.

{"custId":"[ACME-123]","priority":"GOLD-level","orderId":"ORDER1","origin":"Web",
"approvalCode":"AUTO_OK","lineItems":[{"amount":1000,"cost":2.25},{"itemId":"ACME-123",
"amount":400,"cost":1.25}]}

각 필수 camel- 기능에 대해 JBossFuse:admin@root> 프롬프트 유형:

features:install camel-<featureName>

여기서 featureName 은 dozer,jackson 또는 jaxb 중 하나입니다.

각 기능이 성공적으로 설치되었는지 확인하려면 JBossFuse:admin@root> 프롬프트 유형:

features:list --ordered --installed

출력 목록에 방금 설치한 camel 기능이 표시됩니다.

확장 형식에 따라 확장에 대한 코드를 작성합니다.Depending on the extension type, write the code for the extension:

프로젝트 탐색기 보기에서 대상 폴더를 열어 생성된 .jar 파일을 확인합니다.

.jar 파일의 이름은 Maven 기본값을 따릅니다. ${artifactId}-${version}.jar

예: custom:step-camel-1.0.0.jar

이 .jar 파일은 확장 기능, 필수 종속성 및 해당 메타데이터(Extension Id, 이름, 버전, 태그 및 설명)를 정의합니다. 예를 들면 다음과 같습니다.

{
    "schemaVersion" : "v1",
    "name" : "Example Fuse Online Extension",
    "description" : "Logs a message body with a prefix",
    "extensionId" : "fuse.online.extension.example",
    "version" : "1.0.0",
    "actions" : [ {
        "id" : "Log-body",
        "name" : "Log Body",
        "description" : "A simple xml Body Log with a prefix",
        "descriptor" : {
            "kind" : "ENDPOINT",
            "entrypoint" : "direct:log-xml",
            "resource" : "classpath:META-INF/syndesis/extensions/log-body-action.xml",
            "inputDataShape" : {
                "kind" : "any"
            },
            "outputDataShape" : {
                "kind" : "any"
            },
            "propertyDefinitionSteps" : [ {
                "description" : "Define your Log message",
                "name" : "Log Body",
                "properties" : {
                    "prefix" : {
                        "componentProperty" : false,
                        "deprecated" : false,
                        "description" : "The Log body prefix message",
                        "displayName" : "Log Prefix",
                        "javaType" : "String",
                        "kind" : "parameter",
                        "required" : false,
                        "secret" : false,
                        "type" : "string"
                    }
                }
            } ]
        },
        "tags" : [ "xml" ],
        "actionType" : "step"
    } ],
    "dependencies" : [ {
        "type" : "MAVEN",
        "id" : "io.syndesis.extension:extension-api:jar:1.3.0.fuse-000014"
    } ],
    "extensionType" : "Steps"
}