您可以指定內容透過 HTTP 採用 XML 或 JSON 檔中的值。然後,當您執行程序時,伺服器將向您提示該檔案中的值清單。
開始之前
在可從
IBM® UrbanCode Deploy 進行存取的伺服器上,管理含有內容值的 XML 或 JSON 檔。
您可以採用多種不同的方式來格式化此檔案。您還必須使用 3 個參數來識別值的路徑。這些路徑參數的範例包括在範例檔案中。
格式化檔案的最簡單方式,是為內容提供值的簡式清單,如下列範例中所示:
<company>
<employee>Alice</employee>
<employee>Bob</employee>
<employee>Chris</employee>
<company>
針對 XML 檔,您可以使用 XPath 來指定值的路徑。在前一個 XML 檔中,
基本路徑參數是 XPATH 表示式
//company/employee,並且參數
值路徑和
標籤路徑為空。
下列範例顯示採用 JSON 撰寫的對等檔案:
{
company: {
employee: [
"Alice",
"Bob",
"Chris"
]
}
}
在前一個 JSON 檔中,
基本路徑參數是
company.employee,並且參數
值路徑和
標籤路徑為空。
您可以在檔案中包括單獨的標籤資訊和值資訊。例如,下列 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>
在此情況下,
基本路徑參數是 XPATH 表示式
//company/employee。
值路徑參數是用於顯示值路徑(相對於基本路徑而言)的 XPATH 表示式;在此情況下,表示式為
./id。類似地,
標籤路徑參數是用於顯示標籤路徑(相對於基本路徑而言)的 XPATH 表示式;在此情況下,表示式為
./name。
下列 JSON 檔相當於前一個 XML 檔:
{
company: {
employees: [
{ name: "Alice", employee.id: 1 },
{ name: "Bob", employee.id: 2 },
{ name: "Chris", employee.id: 3}
]
}
}
在此情況下,
基本路徑參數是
company.employees。
值路徑參數是
employee\.id,並且
標籤路徑參數是
name。
註: 指定 JSON 檔的路徑時,請使用反斜線來跳出屬性名稱中的句點,如前一個範例內值路徑參數中所示。
在 XML 檔中使用屬性時,請使用
@ 字元以在 XPath 中指定屬性。例如,下列 XML 檔的屬性中具有值:
<company>
<employee id="1">Alice</employee>
<employee id="2">Bob</employee>
<employee id="3">Chris</employee>
<company>
在此情況下,
基本路徑參數是 XPATH 表示式
//company/employee。
值路徑參數是
./@id,並且
標籤路徑參數是句點 (
.)。
關於這項作業
您可以在內容定義(例如,元件環境內容)中使用這些遠端內容值,但不能在一般內容(例如,系統內容、應用程式內容或元件內容)中使用這些遠端內容值。
程序
- 建立內容定義。 例如,按一下元件,跳至配置標籤,按一下環境內容定義,然後按一下新增內容。
- 與平時一樣,指定名稱、說明、標籤、型樣和必要欄位。
- 在類型清單中,選取 HTTP 選取(針對單一內容值),或者選取 HTTP 多重選取以容許多個內容值。 即會出現數個新欄位。
- 指定下列欄位。 這些欄位是外部檔案中參數的特定欄位。
- URL
- 指定外部 XML 或 JSON 檔的 URL。
- 使用者名稱
- 如果 URL 需要使用者名稱,請在這裡指定。
- 密碼
- 如果 URL 需要密碼,請在這裡指定。
- 資料格式
- 指定檔案的類型:JSON 或 XML。
- 基本路徑
- 針對 XML 檔,請指定資料的 XPATH 表示式。針對 JSON 檔,請透過資料的 JSON 屬性來指定路徑,並使用句點 (.) 進行區隔。請參閱此頁面頂端的範例。
- 值路徑
- 指定參數值的路徑,相對於基本路徑參數而言。
- 標籤路徑
- 指定參數標籤的路徑,相對於基本路徑參數而言。
- 預設值
- 指定參數的預設值。
- 按一下儲存。
結果
現在,當您執行程序時,「
執行程序」視窗將包括用於從外部檔案擷取值的參數。