Definición de variables de plugin

Puede definir pares de nombre y valor en el archivo config.json para reutilizarlas como variables en distintas áreas del plugin.

Los pares de nombre y valor se definen dentro de un objeto parms.
  • Se puede hacer referencia a un elemento que se define en parms por nombre en config.json.
  • Las transformaciones de enlace y de componente pueden acceder a los valores y, a continuación, colocarlos en el documento de topología. Los valores del documento de topología pueden utilizarlos luego otras interfaces de plugin y scripts de ciclo de vida de rol.
  • Todos los nombres definidos en un objeto parms deben tener un valor.
  • Un parms definido en config.json no se expone en la consola de a menos que se haga referencia a él config_meta.json. Los desarrolladores de plugins tiene la opción de modificar el valor y volver a crear el plugin si desean personalizar los valores para los despliegues en su entorno.
  • Si se hace referencia a un parms en config_meta.json, el valor se puede modificar en la consola. Esta capacidad permite a los desarrolladores establecer un valor a "null" o establecer un valor predeterminado y, a continuación, proporcionar una manera para que el usuario pueda modificar el valor.

    Para cambiar un valor en la consola, pulse Catálogo > Plug-ins del sistema. Seleccione un plug-in y, a continuación, pulse Configurar en la barra de herramientas.

Para obtener información sobre cómo se utiliza config.json para definir la información de plugins global, como las asociaciones de tipo de patrón, componentes y componentes de nodo, consulte "Referencia de empaquetado de tipo de patrón".

Ejemplo

El plugin wasoracle proporciona un ejemplo de reutilización de parms. Un objeto parms en config.json define dos variables para el controlador JDBC.
"WASOracle" : [
   {
      "parts" : [
         {
            "part"  : "parts/wasxoracle.scripts.tgz",
            "parms" : {
                 "jdbcDriver"     : "$JDBC_DRIVER",
                 "jdbcInstallDir" : "$JDBC_INSTALL_DIR"
            }
         }
      ]
   }
Más adelante en el mismo archivo, el objeto parms siguiente define valores para JDBC_DRIVER y JDBC_INSTALL_DIR
   "parms" : {
      "JDBC_DRIVER"      : null,
      "JDBC_INSTALL_DIR" : "/opt/oraclejdbcjar"
Dado que el valor de JDBC_DRIVER es null, el usuario debe especificar un nombre de archivo JDBC antes de que pueda habilitarse el plugin, y aparecerá un icono de aviso junto al plugin en la página Plugins del sistema para indicar que la configuración del plugin está incompleta. El archivo config_meta.json para el plugin wasoracle incluye "id" : "parms.JDBC_DRIVER" para hacer referencia al par de nombre y valor de JDBC_DRIVER que está definido en config.json.
[
  {
   "id"          : "parms.JDBC_DRIVER",
   "path"        : "files",
   "label"       : "ORA_JDBC_DRIVER",
   "description" : "ORA_JDBC_DRIVER_DESC",
   "type"        : "file",
   "extensions"  : [ "jar" ]
   }
]