Importando extensões customizadas em um ambiente do kit de ferramentas do desenvolvedor;

É possível importar extensões customizadas em um ambiente do kit de ferramentas do desenvolvedor novo ou existente para incluir extensões customizadas de outro ambiente do kit de ferramentas do desenvolvedor ou repositório de controle de origem para ajudar a configurar ou atualizar rapidamente o ambiente.

O processo que você precisa concluir para importar extensões depende se você deseja importar extensões em um novo ambiente do kit de ferramentas do desenvolvedor que você está planejando configurar ou em um ambiente que já está configurado:

Se estiver configurando um ambiente de kit de ferramentas de desenvolvedor, você poderá obter as extensões a serem importadas do IBM Sterling Order Management System, onde foi feito o download do kit de ferramentas de desenvolvimento que está sendo usado para configurar o ambiente, ou de um pacote de personalização externo.
- Para incluir extensões do ambiente do IBM Sterling Sterling Order Management System, selecione a opção Include customizations quando você executar o processo de download do IBM® Sterling™ Order Management System Developer Toolkit do ambiente.
- Para incluir extensões de um pacote de customização externo, inclua o caminho completo para o pacote extensions.jar quando estiver configurando o arquivo devtoolkit_setup.properties como parte da configuração do ambiente do kit de ferramentas do desenvolvedor. Para obter mais informações, consulte Configurando um ambiente de kit de ferramentas do desenvolvedor.
Para importar em um ambiente do kit de ferramentas do desenvolvedor configurado, conclua um ou ambos os processos no procedimento a seguir.

Procedimento

Opcional: importe extensões que são empacotadas em um Java archive (JAR) de extensões, como um extensions.jar que é exportado de outro ambiente do kit de ferramentas do desenvolvedor ou fornecido pelo SaaS Extensions Support Provider.

O archive pode ser proveniente de qualquer origem, mas deve estar em conformidade com a estrutura de pacote necessária Para garantir que o arquivo esteja em conformidade com essa estrutura, certifique-se de que o pacote seja criado com o recurso de exportação de um ambiente de kit de ferramentas de desenvolvedor para o IBM Sterling Order Management System. Para obter mais informações sobre como exportar extensões, consulte Exportando extensões customizadas de um ambiente do kit de ferramentas do desenvolvedor.
1. Em um utilitário de linha de comandos, acesse o diretório runtime/bin do ambiente do kit de ferramentas do desenvolvedor.
  
  Lembre-se: No caso do kit de ferramentas do desenvolvedor conteinerizado, o diretório runtime é o diretório de tempo de execução extraído.
2. Execute o seguinte comando:
  - ./sci_ant.sh -f ../devtoolkit/devtoolkit_extensions.xml import -Dpackage=extension_archive_path
  Em que extension_archive_path é o caminho completo para o archive extensions.jar que você deseja importar.
Opcional: Importar extensões customizadas de um projeto que está configurado para arquivos de extensão e que foi retirado de seu repositório de controle de origem:
Se desejar importar de um projeto, você deve estruturar manualmente seu projeto de repositório de código-fonte para corresponder à estrutura do projeto esperada. O projeto deve estar em conformidade com a seguinte estrutura para que o projeto seja importado com sucesso:
```
<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>
```
- Inclua quaisquer arquivos de extensão customizada no diretório files/extensions/global.
- Inclua quaisquer arquivos de origem Java customizados no pacote correto no diretório src.
- Inclua os arquivos JAR customizados que são e necessários para compilação de arquivos de origem customizados diretamente no diretório lib e não em nenhum subdiretório.
1. Em um utilitário de linha de comandos, acesse o diretório bin do ambiente do kit de ferramentas do desenvolvedor de destino.
2. Execute o seguinte comando para implantar as extensões diretamente do projeto no ambiente do kit de ferramentas do desenvolvedor. Aqui, project_path é o caminho completo para o diretório raiz do projeto.
```
./sci_ant.sh -f ../devtoolkit/devtoolkit_extensions.xml importfromproject -Dprojectdir=project_path
```
  Quando o comando é executado, os arquivos de origem customizados são compilados em um archive custom_impl.jar e copiados para o diretório <runtime>/jar/custom_jars/1_0 junto com outros archives Java dependentes que estão no diretório lib. Esses arquivos copiados são incluídos em todos os caminhos de classe no componente de tempo de execução.
  
  O destino importfromproject também executa um conjunto de validações que são executadas durante o processo de exportação. Essas validações garantem a integridade e a correção dos arquivos de personalização antes de serem compilados e implantados. Para obter mais informações, consulte Verificações de validação.
  
  Se este comando falhar, por erros de compilação, o diretório de projeto não estiver em conformidade com a estrutura especificada, ou outro erro, implemente as extensões manualmente no componente de tempo de execução.