Recuperación de los valores de propiedades desde archivos externos

Puede especificar que una propiedad tome un valor de un archivo HTML o JSON a través de HTTP. A continuación, cuando ejecute el proceso, el servidor le mostrará una lista de valores de dicho archivo.

Antes de empezar

En un servidor al que se puede acceder desde IBM® UrbanCode Deploy, aloje un archivo XML o JSON que contenga los valores para la propiedad. Puede dar formato a este archivo de varios modos. También debe identificar la vía de acceso a los valores con los tres parámetros. En los archivos de ejemplo se incluyen ejemplos de estos parámetros de vía de acceso.
El modo más sencillo de dar formato al archivo es proporcionar una lista de valores sencilla para la propiedad, como en los ejemplos siguientes:
<company>
  <employee>Alice</employee>
  <employee>Bob</employee>
  <employee>Chris</employee>
<company>
En el caso de los archivos XML, utilice XPath para especificar la vía de acceso a los valores. En el archivo XML anterior, el parámetro Vía de acceso base es la expresión XPath //company/employee y los parámetros Vía de acceso de valor y Vía de acceso de etiqueta están en blanco.
El siguiente ejemplo muestra el archivo equivalente en JSON:
{
  company: {
    employee: [
      "Alice",
      "Bob",
      "Chris"
    ]
  }
}
En el archivo JSON anterior, el parámetro Vía de acceso base es company.employee y los parámetros Vía de acceso de valor y Vía de acceso de etiqueta están en blanco.
Puede incluir información de etiquetas y valores separada en el archivo. Por ejemplo, el siguiente archivo XML incluye los nombres y los números de 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>
En este caso, el parámetro Vía de acceso base es la expresión XPath //company/employee. El parámetro Vía de acceso de valor es una expresión XPath que muestra la vía de acceso al valor relativa a la vía de acceso base. En este caso, la expresión es ./id. Del mismo modo, el parámetro Label Path es una expresión XPath que muestra la vía de acceso a la etiqueta relativa a la vía de acceso base. En este caso, la expresión es ./name.
El siguiente archivo JSON es equivalente al archivo XML anterior:
{
  company: {
    employees: [
      { name: "Alice", employee.id: 1 },
      { name: "Bob", employee.id: 2 },
      { name: "Chris", employee.id: 3}
    ]
  }
} 
En este caso, el parámetro Vía de acceso base es company.employees. El parámetro Vía de acceso de valor es employee\.id y el parámetro Vía de acceso de etiqueta es name.
Nota: Cuando especifica la vía de acceso para un archivo JSON, utilice las barras invertidas como caracteres de escape para los puntos de los nombres de atributos, como en el parámetro Vía de acceso de valor del ejemplo anterior.
Cuando utiliza los atributos de un archivo XML, utilice el carácter @ para especificar un atributo en XPath. Por ejemplo, el siguiente archivo XML tiene valores en los atributos:
<company>
  <employee id="1">Alice</employee>
  <employee id="2">Bob</employee>
  <employee id="3">Chris</employee>
<company>
En este caso, el parámetro Vía de acceso base es la expresión XPath //company/employee. El parámetro Vía de acceso de valor es ./@id y el parámetro Vía de acceso de etiqueta es un punto (.).

Acerca de esta tarea

Puede utilizar estos valores de propiedades remotas en definiciones, por ejemplo, en las propiedades del entorno de los componentes pero no en las propiedades generales, tales como las propiedades del sistema, las propiedades de la aplicación o las propiedades de los componentes.

Procedimiento

  1. Cree una definición de propiedad. Por ejemplo, pulse un componente, vaya al separador Configuración, pulse Definiciones de propiedades del entorno y pulse Añadir propiedad.
  2. Especifique los campos Nombre, Descripción, Etiqueta, Patrón y Obligatorio de la forma habitual.
  3. En la lista Tipo, seleccione Selección de HTTP para un único valor de propiedad o seleccione Selección múltiple de HTTP para permitir múltiples valores de propiedades. Aparecen varios campos nuevos.
  4. Especifique los campos siguientes. Estos campos son específicos de los parámetros de archivos externos.
    URL
    Especifique el URL del archivo XML o JSON externo.
    Nombre de usuario
    Si el URL requiere un nombre de usuario, especifíquelo aquí.
    Contraseña
    Si el URL requiere una contraseña, especifíquela aquí.
    Formato de datos
    Especifique el tipo de archivo: JSON o XML.
    Vía de acceso de base
    En el caso de los archivos XML, especifique una expresión XPath para los datos. En el caso de los archivos JSON, especifique la vía de acceso desde los atributos JSON a los datos, separando las vías de acceso con puntos (.). Consulte los ejemplos en la parte superior de esta página.
    Vía de acceso de valor
    Especifique la vía de acceso a los valores de parámetros, relativa al parámetro Vía de acceso base.
    Vía de acceso de etiqueta
    Especifique la vía de acceso a las etiquetas de parámetros, relativa al parámetro Vía de acceso base.
    Valor predeterminado
    Especifique el valor predeterminado para el parámetro.
  5. Pulse Guardar.

Resultados

Ahora, cuando ejecute el proceso, la ventana Ejecutar proceso incluye un parámetro que recupera los valores del archivo externo.

Comentarios