A interface padrão do Oracle BAM permite criar e salvar objetos diretamente no servidor do Oracle BAM. Desta forma, não é necessário salvar os objetos em arquivo na máquina local.
Porém, em determinados momentos é necessário exportar os objetos criados no servidor atual para outro servidor (ex: para testar os dashboards criados no servidor de desenvolvimento no servidor de testes).
Neste post, aprenderemos como exportar e importar objetos criados no Oracle BAM. Todos os componentes do Oracle BAM, podem ser exportados para um arquivo XML através do comando ICOMMAND.
iCommand
O iCommand é um utilitário que permite importar e exportar os diversos componentes do Oracle BAM através do prompt do DOS.
Exemplo de comando para exportar:
icommand type=export name=myComponent type=dataobject file=myFile.xml
Exemplo de comando para importar:
icommand type=import file=myFile.xml
Procedimentos antes de executar os comandos de importação e exportação:
-
Se necessário, setar o Java Home: export JAVA_HOME=/home/oracle/Middleware/home_soa11g/jdk160_11
-
No servidor do BAM, entrar no diretorio /home/oracle/Middleware/home_soa11g/Oracle_SOA1/bam/bin e executar o comando de exportação ou importação
-
Caso os reports a serem exportados tenham drill, os reports referenciados devem ser exportados separadamente, e importados sempre ANTES dos reports que os referenciam. Do contrário, irá ocorrer a mensagem “DrillAcross Destination Report not found.”
Mensagens de erro comuns:
-
Se o iCommand retornar o erro “BAM-01261: Cannot connect to the Oracle BAM Server”, verificar no arquivo /home/oracle/Middleware/home_soa11g/Oracle_SOA1/bam/config/BAMICommandConfig.xml se o parâmetro “ADCServerPort” está setado com a porta no qual o BAM foi efetivamente instalado (o valor padrão é 9001). Caso seja diferente, ajustar para a porta correta e tentar novamente.
Exemplos diversos:
Exportação de reports:
Exportando a pasta “Meus Relatórios” (e todos os relatórios dentro dela):
./icommand -cmd export -name ”/private:weblogic/Report/Meus Relatórios/Coleções” -type folder -file teste.xml
Exportando a pasta “Relatórios compartilhados” (e todos os relatórios dentro dela):
./icommand -cmd export -name ”/public/Report/MainFolderInShared” -type folder -file C:\FolderExportTest2.xml
Exportando um relatório privado:
./icommand -cmd export -name ”/private:bamadmin/Report/MyReport” -type report -file C:\MyReport.xml
Exportando um relatório da pasta “Relatórios Compartilhados”:
./icommand -cmd export -name ”/public/Report/SharedReport” -type report -file C:\SharedReport.xml
Exportação de Data Objects:
Exportando um Data Object da pasta raiz:
./icommand -cmd export -name TestDataObject -file “C:\TestDataObject.xml”
Exportando um Data Object de dentro de uma pasta específica:
./icommand -cmd export -name ”/Samples/Call Center” -file “C:\CallCenter.xml”
Exportando uma pasta de Data Objects inteira:
./icommand -cmd export -name ”/public/DataObject/Colecoes/Desempenho por Marcas” -type folder -file objects.xml
Importação de objetos (reports, data objects, etc):
./icommand -cmd import -file /home/oracle/Middleware/home_soa11g/Oracle_SOA1/bam/bin/teste.xml
Para maiores informações, consulte:
https://download.oracle.com/docs/cd/E12839_01/integration.1111/e10224/bam_app_icommand.htm