Importación de extensiones personalizadas en un entorno de kit de herramientas de desarrollador

Puede importar extensiones personalizadas en un entorno de kit de herramientas de desarrollador nuevo o existente para añadir extensiones personalizadas desde otro entorno de kit de herramientas de desarrollador o repositorio de control de origen para ayudarle a configurar o actualizar rápidamente el entorno.

El proceso que necesita completar para importar extensiones depende de si desea importar extensiones a un nuevo entorno de kit de herramientas de desarrollador que tiene previsto configurar o a un entorno que ya está configurado:

Si está configurando un entorno de kit de herramientas de desarrollo, puede obtener las extensiones para importar desde IBM Sterling Order Management System, donde descargó el kit de herramientas de desarrollo que está utilizando para configurar el entorno, o desde un paquete de personalización externo.
- Para incluir extensiones del entorno IBM Sterling Order Management Sistema, seleccione la opción Incluir personalizaciones cuando ejecute el proceso de descarga del entorno IBM® Sterling™ Order Management Kit de herramientas para desarrolladores de sistemas.
- Para incluir extensiones de un paquete de personalización externo, añada la vía de acceso completa al paquete extensions.jar cuando esté configurando el archivo devtoolkit_setup.properties como parte de la configuración del entorno del kit de herramientas del desarrollador. Para obtener más información, consulte Configuración de un entorno de kit de herramientas de desarrollador.
Para importar en un entorno de kit de herramientas de desarrollador que esté configurado, complete uno o los dos procesos en el procedimiento siguiente.

Procedimiento

Opcional: Importar extensiones empaquetadas dentro de un archivador Java (JAR) de extensiones, como por ejemplo un extensions.jar que se exporta desde otro entorno de kit de herramientas de desarrollador o que proporciona el proveedor de soporte de SaaS Extensions.

El archivo puede proceder de cualquier origen, pero debe ajustarse a la estructura de paquete necesaria. Para garantizar que el archivo se ajusta a esta estructura, asegúrese de que el paquete se crea con la capacidad de exportación de un entorno de herramientas de desarrollador para IBM Sterling Order Management System. Para obtener más información sobre la exportación de extensiones, consulte Exportación de extensiones personalizadas desde un entorno de kit de herramientas de desarrollador.
1. En un programa de utilidad de línea de mandatos, vaya al directorio runtime/bin del entorno del kit de herramientas del desarrollador.
  
  Recuerde: En el caso del kit de herramientas de desarrollador contenerizado, el directorio runtime es el directorio de tiempo de ejecución extraído.
2. Ejecute el mandato siguiente:
  - ./sci_ant.sh -f ../devtoolkit/devtoolkit_extensions.xml import -Dpackage=extension_archive_path
  Donde extension_archive_path es la vía de acceso completa al archivo extensions.jar que desea importar.
Opcional: Importar extensiones personalizadas de un proyecto que se ha configurado para archivos de extensión y que se ha extraído del repositorio de control de origen:
Si desea importar de un proyecto, debe estructurar manualmente el proyecto del repositorio de código fuente de modo que coincida con la estructura de proyecto esperada. El proyecto debe ajustarse con la siguiente estructura para que importe satisfactoriamente el proyecto:
```
<project root directory>
|-- files
| |-- extensions
| | |-- global
| |   |-- <custom extension files>
| |   |-- resources
| |     |-- <custom resource files, such as any custom log4jconfig xml>
| |-- properties
| | |-- customer_overrides.properties
| | |-- <any other allowed overridable property file(s)>
| |-- repository
|   |-- eardata
|      |-- <relative path to any extension directory>
|--src
| |-- <custom source java files in proper package structure>
|--lib
  |--<additional jar files for compiling custom source files>
```
- Incluya todos los archivos de extensión personalizados dentro del directorio files/extensions/global.
- Incluya todos los archivos de origen Java personalizados en el paquete correcto en el directorio src.
- Incluya los archivos JAR personalizados que son y son necesarios para la compilación de archivos de origen personalizados directamente dentro del directorio lib y no dentro de ningún subdirectorio.
1. En un programa de utilidad de línea de mandatos, vaya al directorio bin del entorno del kit de herramientas del desarrollador de destino.
2. Ejecute el siguiente comando para desplegar las extensiones directamente desde el proyecto en su entorno del kit de herramientas para desarrolladores. Aquí, project_path es la ruta completa al directorio raíz del proyecto.
```
./sci_ant.sh -f ../devtoolkit/devtoolkit_extensions.xml importfromproject -Dprojectdir=project_path
```
  Cuando se ejecuta el mandato, los archivos de origen personalizados se compilan en un archivo custom_impl.jar y se copian en el directorio <runtime>/jar/custom_jars/1_0 junto con otros archivos Java dependientes que están en el directorio lib . Estos archivadores se copian en todas las vías de acceso de clases en el componente de tiempo de ejecución.
  
  El destino importfromproject también realiza un conjunto de validaciones que se ejecutan durante el proceso de exportación. Estas validaciones garantizan la integridad y corrección de los archivos de personalización antes de que se compilen y desplieguen. Para más información, véase Comprobaciones de validación.
  
  Si este mandato falla, como por ejemplo debido a errores de compilación, el directorio de proyecto que no se ajuste con la estructura especificada, u otro error, despliega las extensiones manualmente en el componente de tiempo de ejecución.