외부 파일에서 특성 값 검색

특성이 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 PathLabel Path 매개변수는 공백입니다.
다음 예에서는 JSON으로 된 동등 파일을 보여줍니다:
{
  company: {
    employee: [
      "Alice",
      "Bob",
      "Chris"
    ]
  }
}
이전 JSON 파일에서 Base Path 매개변수는 company.employee이며 Value PathLabel 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 매개변수는 마침표(.)입니다.

이 태스크 정보

일반 특성(예: 시스템 특성, 애플리케이션 특성 또는 컴포넌트 특성)이 아니라 특성 정의(예: 컴포넌트 환경 특성)에서 이 원격 특성 값을 사용할 수 있습니다.

프로시저

  1. 특성 정의를 작성하십시오. 예를 들어, 컴포넌트를 클릭한 후 구성 탭으로 이동하여 환경 특성 정의를 클릭한 후 특성 추가를 클릭하십시오.
  2. 이름, 설명, 레이블, 패턴필수 필드를 평소대로 지정하십시오.
  3. 유형 목록에서 단일 특성 값에 대해 HTTP 선택을 선택하거나 HTTP 다중 선택을 선택하여 다중 특성 값을 허용하십시오. 몇몇 새 필드가 표시됩니다.
  4. 다음과 같은 필드를 지정하십시오. 이 필드는 외부 파일의 매개변수에 고유합니다.
    URL
    외부 XML 또는 JSON 파일의 URL을 지정하십시오.
    사용자 이름
    URL에 사용자 이름이 필요한 경우 여기서 지정하십시오.
    비밀번호
    URL에 비밀번호가 필요한 경우 여기서 지정하십시오.
    데이터 형식
    파일의 유형을 지정하십시오(JSON 또는 XML).
    기본 경로
    XML 파일의 경우 데이터에 XPath 표현식을 지정하십시오. JSON 파일의 경우 JSON 속성을 통과하는 데이터의 경로를 지정하고 경로는 마침표(.)로 분리하십시오. 이 페이지의 맨 위에 있는 예를 참조하십시오.
    값 경로
    기본 경로 매개변수에 대해 상대적인 매개변수 값의 경로를 지정하십시오.
    레이블 경로
    기본 경로 매개변수에 대해 상대적인 매개변수 레이블의 경로를 지정하십시오.
    기본값
    매개변수의 기본값을 지정하십시오.
  5. 저장을 클릭하십시오.

결과

이제 프로세스를 실행하면 외부 파일에서 값을 검색하는 매개변수가 프로세스 실행 창에 포함되어 있습니다.

피드백