특성이 HTTP를 통해 XML 또는 JSON 파일에서 값을 가져오도록
지정할 수 있습니다. 그러면 사용자가 프로세스를 실행할 때 서버는
해당 파일의 값 목록 프롬프트를 표시합니다.
시작하기 전에
IBM® UrbanCode Deploy에서 액세스할 수 있는 서버에서
특성의 값이 포함된 XML 또는 JSON 파일을 호스팅하십시오.
여러 가지 다양한 방식으로 이 파일을 형식화할 수 있습니다. 3개의
매개변수를 가진 값의 경로도 식별해야 합니다. 이 경로 매개변수의 예는
예제 파일에 포함되어 있습니다.
이 파일을 형식화하는 가장 단순한
방법은 다음 예와 같이 특성 값의 단순한 목록을 제공하는 것입니다:
<company>
<employee>Alice</employee>
<employee>Bob</employee>
<employee>Chris</employee>
<company>
XML 파일의 경우에는 XPath를 사용하여 값의 경로를 지정합니다.
이전 XML 파일에서
Base Path 매개변수는 XPath
표현식
//company/employee이며
Value
Path 및
Label Path 매개변수는 공백입니다.
다음 예에서는 JSON으로 된 동등 파일을 보여줍니다:
{
company: {
employee: [
"Alice",
"Bob",
"Chris"
]
}
}
이전 JSON 파일에서
Base Path 매개변수는
company.employee이며
Value Path 및
Label Path 매개변수는 공백입니다.
별도의
레이블 및 값 정보를 파일에 포함할 수 있습니다. 예를 들어, 다음 XML
파일에는 이름 및 ID 번호가 포함됩니다.
<company>
<employee>
<name>Alice</name>
<id>1</id>
</employee>
<employee>
<name>Bob</name>
<id>2</id>
</employee>
<employee>
<name>Chris</name>
<id>3</id>
</employee>
</company>
이 경우
Base Path 매개변수는
XPath 표현식
//company/employee입니다.
Value
Path 매개변수는 기본 경로에 대해 상대적인 값의 경로를 표시하는
XPath 표현식입니다. 이 경우 해당 표현식은
./id입니다.
마찬가지로
Label Path 매개변수는 기본 경로에 대해
상대적인 레이블의 경로를 표시하는 XPath 표현식입니다. 이 경우 해당
표현식은
./name입니다.
다음 JSON 파일은
이전 XML 파일에 대한 동등 파일입니다:
{
company: {
employees: [
{ name: "Alice", employee.id: 1 },
{ name: "Bob", employee.id: 2 },
{ name: "Chris", employee.id: 3}
]
}
}
이 경우
Base Path 매개변수는
company.employees입니다.
Value Path 매개변수는
employee\.id이고
Label Path 매개변수는
name입니다.
참고: JSON 파일의 경로를 지정하는 경우에는 이전 예의 Value
Path 매개변수에서와 같이 속성 이름의 마침표를 백슬래시로
이스케이프하십시오.
XML 파일에서 속성을 사용하는 경우에는
@ 문자를 사용하여 XPath에서 속성을 지정하십시오.
예를 들어, 다음 XML 파일은 속성에 값을 가지고 있습니다:
<company>
<employee id="1">Alice</employee>
<employee id="2">Bob</employee>
<employee id="3">Chris</employee>
<company>
이 경우
Base Path 매개변수는
XPath 표현식
//company/employee입니다.
Value
Path 매개변수는
./@id이고
Label
Path 매개변수는 마침표(
.)입니다.
이 태스크 정보
일반 특성(예: 시스템 특성, 애플리케이션 특성 또는 컴포넌트
특성)이 아니라 특성 정의(예: 컴포넌트 환경 특성)에서 이 원격 특성 값을
사용할 수 있습니다.
프로시저
- 특성 정의를 작성하십시오. 예를 들어, 컴포넌트를 클릭한 후 구성 탭으로
이동하여 환경 특성 정의를 클릭한 후
특성 추가를 클릭하십시오.
- 이름, 설명, 레이블, 패턴 및
필수 필드를 평소대로 지정하십시오.
- 유형 목록에서 단일 특성 값에 대해 HTTP
선택을 선택하거나 HTTP 다중 선택을
선택하여 다중 특성 값을 허용하십시오. 몇몇 새 필드가 표시됩니다.
- 다음과 같은 필드를 지정하십시오. 이 필드는 외부 파일의 매개변수에 고유합니다.
- URL
- 외부 XML 또는 JSON 파일의 URL을 지정하십시오.
- 사용자 이름
- URL에 사용자 이름이 필요한 경우 여기서 지정하십시오.
- 비밀번호
- URL에 비밀번호가 필요한 경우 여기서 지정하십시오.
- 데이터 형식
- 파일의 유형을 지정하십시오(JSON 또는 XML).
- 기본 경로
- XML 파일의 경우 데이터에 XPath 표현식을 지정하십시오. JSON 파일의 경우
JSON 속성을 통과하는 데이터의 경로를 지정하고 경로는 마침표(.)로
분리하십시오. 이 페이지의 맨 위에 있는 예를 참조하십시오.
- 값 경로
- 기본 경로 매개변수에 대해 상대적인 매개변수 값의
경로를 지정하십시오.
- 레이블 경로
- 기본 경로 매개변수에 대해 상대적인 매개변수
레이블의 경로를 지정하십시오.
- 기본값
- 매개변수의 기본값을 지정하십시오.
- 저장을 클릭하십시오.
결과
이제 프로세스를 실행하면 외부 파일에서 값을 검색하는
매개변수가
프로세스 실행 창에 포함되어 있습니다.