Guia de Migração - ibm.com · v Perguntas específicas sobre o produto: Se você recebeu...

IBM InfoSphere Master Data Management CollaborationServerVersão 11 Release 4

Guia de Migração

SC19-4014-02

��

NotaAntes de usar estas informações e o produto que ela suporta, leia as informações em “Avisos” na página 53.

Aviso da Edição

Esta edição se aplica à versão 11.4 do IBM InfoSphere Master Data Management e a todas as liberações emodificações subsequentes até que seja indicado de outra forma em novas edições.

© Copyright IBM Corporation 2000, 2014.

Índice

Tabelas . . . . . . . . . . . . . . . v

Figuras . . . . . . . . . . . . . . vii

Prefácio . . . . . . . . . . . . . . ixO que há de novo na versão 11.4? . . . . . . . ixEntrando em Contato com o IBM Software Support . x

Capítulo 1. Migrando . . . . . . . . . 1

Capítulo 2. Introdução. . . . . . . . . 3

Capítulo 3. Migrando de VersõesAnteriores . . . . . . . . . . . . . . 5Migrando Dados Principais do Formato Interno parao Formato XML . . . . . . . . . . . . . 7Migrando da V9.1 para a V11.4 . . . . . . . . 9Migrando da V10.0 para a V11.4 . . . . . . . 13Migrando da V10.1 para a V11.4 . . . . . . . 16Migrando da V11.0 para a V11.4 . . . . . . . 19Migrando da V11.3 para a V11.4 . . . . . . . 22

Capítulo 4. Migrando Scripts doInfoSphere MDM Collaboration Server . 27Diferenças de Script em Várias Versões . . . . . 27

Métodos com diferentes assinaturas na V6.0 e naV11.4 . . . . . . . . . . . . . . . 28

Métodos apenas na V9.0 transportados para aV11.4 . . . . . . . . . . . . . . . 28Mudanças no comportamento de operações descript que existem a partir de V5.3.2 e V11.4 . . 37Mudanças no comportamento das operações descript da V6.0 e V11.4 . . . . . . . . . . 41

Diferenças da API Java Entre Várias Versões . . . 42Enums e Métodos API Java . . . . . . . . 42Novas Interfaces API Java . . . . . . . . 45Mudanças nos pontos de extensão do Java . . . 46

Ajustando Seu Banco de Dados. . . . . . . . 46

Capítulo 5. Resolução de Problemas 47Resolvendo Problemas de Scripts de Migração. . . 47

Executando scripts de migração compilados . . 47Erros Comuns de Compilação de Script . . . . 47Erros e Problemas Comuns de Tempo deExecução . . . . . . . . . . . . . . 48Resolva problemas e erros de tempo de execução 49

Resolvendo Problemas de Migração . . . . . . 50

Avisos . . . . . . . . . . . . . . . 53

Índice Remissivo . . . . . . . . . . 59

Entrando em Contato com a IBM . . . 61

© Copyright IBM Corp. 2000, 2014 iii

iv InfoSphere MDM Collaboration Server: Guia de Migração

Tabelas

1. Motivos Possíveis para Erros e as AçõesRecomendadas . . . . . . . . . . . . 9

2. Arquivos SQL para modificar ao usar nomesde espaço de tabela customizados . . . . . 10





7. Uma comparação dos métodos com diferentesassinaturas no V6.0 e V11.4 . . . . . . . 28

8. Recursos da IBM . . . . . . . . . . . 619. Fornecendo Feedback para a IBM . . . . . 62

© Copyright IBM Corp. 2000, 2014 v

vi InfoSphere MDM Collaboration Server: Guia de Migração

Figuras

© Copyright IBM Corp. 2000, 2014 vii

viii InfoSphere MDM Collaboration Server: Guia de Migração

Prefácio

Estas informações ajudam a migrar do IBM® InfoSphere Master Data ManagementServer for Product Information Management Versão 9.1.0 e IBM InfoSphere MasterData Management Collaboration Server Versões 10.0, 10.1, 11.0 e 11.3 para o IBMInfoSphere Master Data Management Collaboration Server Versão 11.4 através deum número de subetapas e migrações.

Sobre esta Publicação

As informações a seguir abrangem instruções passo-a-passo, melhores práticas,ajuste de desempenho e resolução de problemas comuns.

Público-alvo

Este guia de migração é destinado a instaladores, administradores de sistema e àequipe de Serviços Profissionais IBM para implementar com sucesso o produto emseu ambiente.

Informações de Pré-requisito e Relacionadas

Antes de usar este guia de migração, familiarize-se com as seguintes informações:v Centro de conhecimento do InfoSphere MDM Collaboration Serverv Sua documentação do servidor de aplicativosv Sua documentação do software de banco de dados

Como Enviar Comentários

Seu feedback é importante para ajudar a fornecer as informações mais precisas ede alta qualidade. Se você tiver quaisquer comentários sobre este manual ouqualquer outra documentação do InfoSphere MDM Collaboration Server, use oformulário a seguir para nos enviá-los:

http://www.ibm.com/software/data/rcf/

O que há de novo na versão 11.4?Há muitos novos recursos e funções no IBM InfoSphere Master Data ManagementCollaboration Server Versão 11.4.

O InfoSphere MDM Collaboration Server foi incluído no InfoSphere MDMEnterprise Edition e no InfoSphere MDM Collaborative Edition.

O InfoSphere MDM Collaboration Server permite que as empresas criem um únicorepositório atualizado de informações do produto que pode ser usado em toda aorganização para iniciativas de negócios estratégicas.

As principais alterações no produto incluem:

© Copyright IBM Corp. 2000, 2014 ix


Suporte de migração para usuários do InfoSphere MDM Collaboration ServerOs tópicos a seguir documentam os novos caminhos de migração deversões anteriores doInfoSphere MDM Collaboration Server para a versão11.4:v Migrando da V9.1 para a V11.4v Migrando da V10.0 para a V11.4v Migrando da V10.1 para a V11.4v Migrando da V11.0 para a V11.4v Migrando da V11.3 para a V11.4

Suporte de migração para o Advanced Catalog Management (ACM)O Advanced Catalog Management (ACM) versão 11.0 FP5 introduz váriosnovos recursos. A fim de usar estes novos recursos, deve-se atualizar omodelo de dados. Para obter mais informações, consulte Migrando oAdvanced Catalog Management.

Amostra de Solução FinanceiraA Amostra de Solução Financeira é um modelo de dados de amostraimplementado no MDM colaborativo para gerenciamento de dados deoferta de produto financeiro. Para obter mais informações, consulte Soluçãode Amostra Financeira.

Kit de Ferramentas de Solução FinanceiraO Kit de Ferramentas de Solução Financeira é usado para publicarmetadados de solução (por exemplo, Especificações) e dados de produto(por exemplo, Categoria e Produto) no MDM colaborativo e no MDMfísico. Para obter mais informações, consulte MDM físico do IBMInfoSphere.

Aprimoramentos da API JavaAPIs InfoSphere MDM Collaboration Server Java aprimoradas para osuporte xml de especificações unificadas. Para obter mais informações,consulte Documentação do IBM Javadoc e Esquema de objeto.

Upgrade de aplicativo e pilhaOs novos upgrades de pilha a seguir são suportados pelo InfoSphere MDMCollaboration Server:v Atualize o Rational Architect Developer para a versão 9.1v Atualize o WebSphere Portal Server para a versão 8.5

Atualizações da documentaçãoOs itens a seguir são novos ou são atualizações para a documentação:v Novos tópicos e conteúdo atualizado na seção IBM WebSphere

Commerce.v Novos tópicos e conteúdo atualizado na seção Resolução de problemas e

suporte.v Novos tópicos e conteúdo atualizado na seção Assegurando bom

desempenho.

Entrando em Contato com o IBM Software SupportO Suporte de Software IBM fornece assistência para defeitos de produto, respondea FAQs e executa a redescoberta.

x InfoSphere MDM Collaboration Server: Guia de Migração

Antes de Iniciar

Após tentar localizar sua resposta ou solução utilizando outras opções deauto-ajuda como notas técnicas, é possível entrar em contato com o Suporte IBM.Antes de entrar em contato com o Suporte IBM, sua empresa deve ter um contratode manutenção IBM ativo e deve estar autorizada a enviar problemas à IBM. Paraobter informações sobre os tipos de suporte disponíveis, consulte o tópico Supportportfolio no Software Support Handbook.

Ao entrar em contato com o IBM Software Support, é importante saber qualsuporte está disponível na IBM:v Perguntas específicas sobre o produto: Se você recebeu treinamento para o

produto, poderá enviar perguntas ou dúvidas específicas.v Suporte a defeitos: A análise e o trabalho necessários para resolver um defeito

do produto ou oferecer uma solução alternativa.v Operações de script: Para questões referentes a uma operação de script ou para

relatar um possível defeito em uma operação de script, é necessário simplificarsua questão ou problema para aproximadamente 5 linhas de código ou menos.– A IBM não oferece suporte para depuração e análise de scripts customizados.

v Pedidos de aprimoramento: Pedidos de nova funcionalidade incluídos noproduto.

Pedidos que não estão dentro do escopo do IBM Software Support e requerem quevocê entre em contato com seu representante de Vendas ou de ServiçosProfissionais:v Trabalho diverso: Trabalho ou assistência que requer envolvimento extensivo da

IBM durante o processo de instalação ou de implementação, que incluiinstalações complexas ou instalação em várias plataformas.

v Suporte para clientes sem treinamento: Pedidos para ajuda passo-a-passo daIBM, mas que não receberam treinamento necessário para o produto IBM. O IBMEducation oferece treinamento ao cliente, se for necessário treinamento adicionalpela equipe. Verifique o website da IBM para obter informações específicas sobrecursos disponíveis.

v Script ou scripts customizados: Nenhum suporte é fornecido para os scriptscriados ou que requerem depuração. Todos os scripts customizados criados pelosServiços Profissionais pertencerão e serão mantidos por você, o cliente, quando oatendimento do Serviço for concluído. O Suporte Técnico não está disponívelpara criação e depuração de scripts customizados.

v Recuperação de dados: é altamente recomendável fazer backup regularmente deseus dados.

v Assistência ou recomendações de desempenho ou ajuste que requerem dados docliente.

Procedimento1. Verifique se já existe uma nota técnica referente ao seu problema. Para obter

informações adicionais sobre a visualização de notas técnicas.2. Determine se um contato ou sua equipe de suporte interno pode fornecer

assistência.3. Defina o problema, reúna informações complementares e determine a

gravidade do problema. Para obter ajuda, consulte o “Before contacting IBMSoftware Support” no Software Support Handbook.

Informações Complementares Necessárias

Prefácio xi

http://www14.software.ibm.com/webapp/set2/sas/f/handbook/offerings.html

http://www14.software.ibm.com/webapp/set2/sas/f/handbook/offerings.html

http://www14.software.ibm.com/webapp/set2/sas/f/handbook/getsupport.html#1

http://www14.software.ibm.com/webapp/set2/sas/f/handbook/getsupport.html#1

v Todas as definições e informações de configuração.v O comportamento esperado versus o comportamento atual.v Todas as mudanças ou modificações implementadas recentemente.v Determine se o problema pode ser recriado.v Defina as etapas que levaram aos problemas que você está

enfrentando.4. Reúna informações de diagnóstico:

v Também é possível utilizar o recurso de coleta de dados básicos do IBMSupport Assistant para coletar seus arquivos críticos de log e configuração;consulte www.ibm.com/software/support/isa/ para obter informaçõesadicionais.

v Crie sua própria ferramenta coletora do IBM Support Assistant Lite atravésdo ambiente de trabalho.a. Faça o download do complemento de produto no ambiente de trabalho

do IBM Support Assistant.b. Clique em Coletar e Enviar Dados. Três opções exibidas à esquerda.c. Escolha ...Utilizando o IBM Support Assistant Lite.d. Crie o coletor gerado pela conclusão de cada uma das opções do coletor:

– Selecione um coletor (Se o complemento de produto instalado não forexibido, ele não tem um documento Deve Reunir e não poderá criarum coletor do IBM Support Assistant Lite)

– Especifique o diretório de destino– Especifique o nome do arquivo– Clique no botão Exportar

e. Transfira o coletor do IBM Support Assistant Lite para um sistema remotoutilizando ftp ou qualquer outro protocolo de transferência de arquivosdisponível.

f. Descompacte o arquivo ZIP do coletor do IBM Support Assistant Liteexportado para seu local de destino.

g. Configure o JAVA_HOME ou assegure que Java™ esteja em sua instruçãode caminho.

h. Execute o comando runISALite.bat para o Windows ou o scriptrunISALite.sh para UNIX e LINUX a partir das ferramentas do diretóriodo IBM Support Assistant Lite no sistema remoto.

i. Forneça as respostas adequadas para todos os prompts de coleta.j. Reveja os arquivos coletados ou os envie ao suporte IBM.

5. Envie seu problema para o IBM Software Support de uma das seguintesmaneiras:v On-line: (Recomendado)

a. Clique em Abrir solicitação de serviço sob a seção Escolher sua tarefa nabarra de navegação à esquerda do IBM InfoSphere Master DataManagement Collaboration Server Site de suporte.

b. Clique em ESR / SR e siga as instruções fornecidas no website do ESR.Use as seguintes diretrizes e dicas para utilização do ESR e o envio dePMRs:– Anexe documentos diretamente ao PMR para disponibilizá-los para o

IBM Support Services.– O ESR gerencia uma lista de todos os PMRs que você visualizou para

que tenha acesso imediato a eles para verificar o status.

xii InfoSphere MDM Collaboration Server: Guia de Migração

http://www.ibm.com/software/support/isa/

http://www.ibm.com/support/entry/portal/overview/software/information_management/infosphere_master_data_management

– Use o ESR para configurar as notificações automáticas do PMR.– Envie as atualizações dos PMRs que forem abertos para o IBM Support

Services diretamente do ESR.– Ao enviar um PMR, indique um nível de gravidade para nos ajudar a

priorizar nossos recursos em relação a outros PMRs abertos:

Gravidade 1Impacto de negócios crítico: Isso indica que você não podeusar o programa, o que resultará em um impacto de negóciossobre as operações. Essa condição requer uma soluçãoimediata.

Nota: Geralmente, impacto de negócios crítico significa queseu sistema de produção está desativado e, para que o IBMSoftware Support trabalhe fora de seu horário comercial, vocêdeve garantir que haja um contato disponível por telefone, 24horas por dia, 7 dias por semana, para facilitar as consultas doengenheiro verificador, a execução de testes em sua instânciade produção, etc.

Gravidade 2Impacto de negócios significativo: Isso indica que o programaé útil, mas severamente limitado.

Gravidade 3Algum impacto de negócios: Isso indica que o programa é útil,mas com menos recursos significativos (não crítico paraoperações) indisponíveis.

Gravidade 4Impacto de negócios mínimo: Isso indica que o problema causapouco impacto sobre as operações ou que uma alternativarazoável para o problema foi implementada.

– Para abrir um Pedido de Aprimoramento (um pedido para novafuncionalidade geral do produto e não está relacionado a umacustomização específica):- Abra um PMR com gravidade 2, 3 ou 4, (dependendo do possível

ganho de negócios do pedido) e o pedido será enviado para o IBMProduct Management, para revisão. Você receberá um número dePedido de Aprimoramento para fins de rastreamento, que substitui onúmero do PMR. Geralmente, sua aprovação é necessária parafechar o PMR.

v Por telefone: Para obter o número do telefone para o qual ligar em seu país,acesse a Página Contacts do Software Support Handbook.

O que Fazer Depois

Se o problema enviado for relacionado a um defeito de software ou a umadocumentação ausente ou inadequada, o IBM Software Support criará um APAR(Authorized Program Analysis Report). O APAR descreverá o problema emdetalhes. Quando possível, o IBM Software Support oferecerá uma soluçãoalternativa que você pode implementar até que o APAR seja resolvido e umacorreção seja apresentada. A IBM publica APARs resolvidos no website de SuporteIBM diariamente para que outros usuários que tiveram o mesmo problema possamse beneficiar da mesma resolução.

Prefácio xiii

http://www.ibm.com/planetwide/

xiv InfoSphere MDM Collaboration Server: Guia de Migração

Capítulo 1. Migrando

Se estiver usando uma versão anterior do IBM InfoSphere Master DataManagement Collaboration Server, você poderá migrar de sua versão para a versãomais atual.

Estas informações de instalação também estão disponíveis no InfoSphere MDMCollaboration Server Migration Guide, que está disponível no formato de manualem um arquivo PDF. Clique com o botão direito do mouse no link e selecioneSalvar Destino Como para efetuar download do arquivo PDF em seu computador.

© Copyright IBM Corp. 2000, 2014 1

2 InfoSphere MDM Collaboration Server: Guia de Migração

Capítulo 2. Introdução

Deve-se modificar o esquema de banco de dados de sua instalação atual usando osscripts de migração para migrar de versões anteriores para o IBM InfoSphereMaster Data Management Collaboration Server Versão 11.4.

Deve-se ter permissões adequadas para criar e modificar tabelas e índices no bancode dados. Deve-se também ter permissões adequadas para criar e excluir arquivosnos subdiretórios do diretório $TOP.

A migração envolve as seguintes etapas básicas:v Verifique se há espaço suficiente disponível na tabela de banco de dados.v Pare a instância que está usando o esquema do banco de dados.v Faça backup do esquema de banco de dados existente.v Instale o InfoSphere MDM Collaboration Server V11.4 e aponte para o mesmo

esquema do banco de dados que a instância anterior estava usando.v Execute o script de migração apropriado para modificar o esquema do banco de

dados e leve-o para o nível do InfoSphere MDM Collaboration Server V11.4.


Capítulo 3. Migrando de Versões Anteriores

É possível migrar para o IBM InfoSphere Master Data Management CollaborationServer Versão 11.4 de versões anteriores específicas.

Os caminhos de migração a seguir são suportados para a Versão 11.4:v Migrando da V9.1, Fix Pack 2 ou posterior para a V11.4v Migrando da V10.0, Fix Pack 1 ou posterior para a V11.4v Migrando da V10.1, GA e todos os níveis de Fix Pack para a V11.4v Migrando da V11.0, GA e todos os níveis de Fix Pack para a V11.4v Migrando da V11.3, GA para a V11.4

Se estiver migrando para uma liberação superior, não um fix pack da mesmaliberação, você deverá usar um novo diretório de instalação para evitarincompatibilidades de versão do arquivo JAR.

Se estiver migrando de uma versão de fix pack mais antiga, certifique-se de nãoestar usando nenhuma API excluída em seus scripts do Excel. As seguintes APIsnão estão disponíveis no arquivo JAR POI mais recente:v public String getExcelCellEncoding();

v public void setEncoding(String encoding);

v public String getExcelCellEncoding(Object cellObj) throwsAustinException;

Nota:

1. O InfoSphere MDM Collaboration Server Excel Parser é suportado por umarquivo .jar de terceiro denominado poi-3.7-20101029.jar. Essa bibliotecasuporta o formato Microsoft Excel 2007, que permite mais de 255 colunas porplanilha de dados. Deve-se executar o script de Relatório de Resultado deProcura Detalhada. Ao executar esse script, a opção Script de Relatório deResultado de Procura Detalhada (Excel 2007 – formato xlsx) deve ser usadapara exportar itens com mais de 255 atributos.

2. É possível exportar Resultados de Procura Detalhada para arquivos no formatoExcel 2003 usando a opção Script de Relatório de Resultados de ProcuraDetalhada Padrão. No entanto, com este formato, o relatório falhará se os itenstiverem mais de 255 atributos.

3. O .xlsx do Excel 2010 não é suportado por este JAR.

Importante: Antes de executar os scripts de migração, deve-se assegurar que aversão correta do banco de dados esteja sendo usada. Consulte os requisitos dosistema para obter detalhes: http://www-01.ibm.com/support/docview.wss?uid=swg27035486. Você também deve assegurar que o usuário dobanco de dados do InfoSphere MDM Collaboration Server tenha os privilégiosapropriados conforme mencionado no guia de instalação. Consulte sua equipeDBA para quaisquer mudanças nos privilégios do usuário do banco de dadosdevido a qualquer política de segurança.

Deve-se usar a versão do banco de dados DB2 ou Oracle conforme mencionadonos requisitos do sistema. Consulte os requisitos do sistema para obter detalhes:http://www-01.ibm.com/support/docview.wss?uid=swg27035486. É possível


http://www-01.ibm.com/support/docview.wss?uid=swg27035486



consultar a documentação do DB2 ou Oracle para fazer upgrade do banco dedados DB2 e Oracle para a versão suportada.

Etapas para migrar o MDM Colaborativo com espaços de tabela customizadossão usados em DB2 e Oracle

Se estiver usando nomes de espaços de tabelas customizados em vez de USERS ouINDX padrão, deve-se modificar manualmente os nomes dos espaços de tabela nosarquivos SQL a seguir antes de iniciar a migração para o InfoSphere MDMCollaboration Server.

Deve-se verificar se há pelo menos 30% de espaço livre no banco de dados antesde iniciar a migração.

Logs de auditoria não são migrados para a V11.4. Por causa de um novo formatode descrições de log de auditoria introduzido na V9.1.0, as descrições de log deauditoria presentes nas liberações anteriores à V9.1.0 não são visualizáveis naV11.4. Assim, elas são excluídas do banco de dados durante a migração. Os logs deauditoria antigos podem ser visualizados usando a liberação da qual você estámigrando.

Deve-se executar manualmente as etapas a seguir para assegurar uma migraçãobem-sucedida:1. Migre manualmente os arquivos de propriedades a seguir. Como os arquivos

de propriedade fazem parte dos sistemas de arquivos locais, o método demigração não suporta a exportação de arquivos de propriedades. Modifiquecada propriedade customizada de liberações anteriores para o arquivocorrespondente na nova versão. Não sobrescreva os arquivos de propriedade deuma versão mais antiga para uma nova versão porque novos parâmetros foramintroduzidos na V11.4. Consulte a documentação do InfoSphere MDMCollaboration Server para obter detalhes sobre cada arquivo de propriedade.v $TOP/etc/default/common.properties

v $TOP/etc/default/logs.xml

v $TOP/etc/default/docstore_mount.xml

v $TOP/etc/default/user_jars.list

2. Copie manualmente o conteúdo do diretório $TOP/public_html/suppliers/<cmpcode>/ctg_files para a nova instância para cada empresa. Como essesarquivos fazem parte do sistema de arquivos local, o método de migração nãosuporta a exportação do diretório ctg_files.

3. Inclua manualmente os arquivos JAR do usuário requeridos para a novainstância. Como esses arquivos fazem parte do sistema de arquivos local, ométodo de migração não suporta a exportação dos arquivos JAR do usuário.Para obter mais informações sobre como incluir arquivos JAR em suaimplementação, consulte Implementando um arquivo .jar do usuáriocustomizado.

4. Refaça manualmente todas as mudanças que você fez no Script de Relatório deResultados da Procura Detalhada Padrão para customizá-lo. Migrar para oInfoSphere MDM Collaboration Server V11.4 sobrescreve o script existentedisponível no diretório de armazenamento de documentos do InfoSphere MDMCollaboration Server, /scripts/report. Esse script é usado para exportarresultados da procura do objeto do InfoSphere MDM Collaboration Server parauma planilha do Excel. Para obter mais informações sobre esse script, consulteExportando resultados da procura para o Excel.


5. Assegure que não haja opção de compilação detalhada configurada para acompilação de scripts. Verifique se no arquivo common.properties você não usaverbose como o valor para o parâmetro script_compiler_options. Para obtermais informações sobre esse parâmetro, consulte script_compiler_optionsparameters.

6. Execute o script setup.sh para verificar se a versão de PERL instalada nocomputador é compatível com a versão do InfoSphere MDM CollaborationServer que você instalou. Esse script está no diretório $TOP. Se a versão atual dePERL não for compatível, você deverá instalar uma nova versão.

7. Se você instalar a nova versão do InfoSphere MDM Collaboration Server emum novo diretório, deverá atualizar o valor das variáveis TOP e PERL5LIB noarquivo .bash_profile. Deve-se configurar a variável PERL5LIB para o diretório$TOP/bin/perllib.

Migrando Dados Principais do Formato Interno para o Formato XMLDeve-se converter os dados principais em XML ao migrar do IBM InfoSphereMaster Data Management Server for Product Information Management Versões6.0.0 ou 9.0.0 para o IBM InfoSphere Master Data Management CollaborationServer Versão 11.4.

Antes de Iniciar1. Crie espaços de tabela XML e buffer pools conforme descrito no guia de

instalação.2. Certifique-se de que o usuário do banco de dados para o aplicativo InfoSphere

MDM Collaboration Server tenha os privilégios do banco de dados apropriadosconforme mencionado no guia de instalação.

3. Pare o aplicativo InfoSphere MDM Collaboration Server no servidor local.4. Execute o script delete_old_versions.sh para excluir todas as versões antigas.

Use o código de sua empresa e a data atual como valores para os parâmetroscode e end_date.

5. Opcional – Aprimorar a memória disponível para o processo Java: Executar oscript de conversão de dados é um processo intensivo de memória.Recomenda-se fornecer 2 GB de memória para o processo Java atualizando oparâmetro custom_java_options no arquivo $TOP/bin/conf/env_settings.ini.Execute o configureEnv.sh depois de modificar o parâmetrocustom_java_options para assegurar que as configurações de nova memóriaatualizadas entrem em vigor.custom_java_options=-Xmx2048m -Xms256m

Sobre Esta Tarefa

O script de migração de dados requer duas vezes o número de conexões de BDque o número de encadeamentos de execução. Por exemplo, se você usar 10encadeamentos na opção de prompt de comandos, ele exigirá 20 conexões de BD.Você precisa configurar o número de conexões de BD usando esses doisparâmetros de configuração:v db_maxConnection

v db_maxConnection_default

Os dois parâmetros estão disponíveis no arquivo common.properties. Se os valoresdesses parâmetros já forem maiores ou iguais às conexões de BD requeridas, não

Capítulo 3. Migrando de Versões Anteriores 7

será necessário alterar os valores. Se os valores desses parâmetros forem menoresque as conexões de BD requeridas, você deverá aumentar os valores para melhorara velocidade.

Se você tiver mais de 100.000 entradas de dados principais nos catálogos, aumenteo número de encadeamentos. Por exemplo, você pode usar 50 ou 100encadeamentos para concluir a migração de dados mais rápido. O número maisalto de encadeamentos que você pode usar depende das seguintes variáveis noInfoSphere MDM Collaboration Server. É possível avaliar o número ideal deencadeamentos executando o script de migração em um ambiente de teste.v Número de núcleos do processador disponíveisv Número de especificações definidov Memória disponível

Todas as especificações que são definidas no ambiente do InfoSphere MDMCollaboration Server são recuperadas e usadas no processo de conversão de dados.Se você tiver mais de 100 especificações, atualize os parâmetros de armazenamentoem cache de especificação para os valores apropriados para evitar trips frequentesdo banco de dados e melhorar o desempenho geral do script.

Procedimento1. Obtenha a contagem de especificação no InfoSphere MDM Collaboration Server

usando o comando a seguir.$PERL5LIB/runSQL.pl --sql_command="select count(*) from spc;"

2. Atualize esses parâmetros com os valores recuperados da consulta na Etapa 1.Esses parâmetros estão disponíveis no arquivo mdm-cache-config.propertiesno diretório $TOP/etc/default.specCache_KEY_START_VERSION_TO_VALUE.maxElementsInMemory=<spec count>

specCache_KEY_TO_CURRENT_START_VERSION.maxElementsInMemory=<spec count>

specCache_KEY_VERSION_TO_START_VERSION.maxElementsInMemory=<spec count>

Nota: Executar o script configureEnv.sh depois de atualizar o arquivomdm-cache-config.properties sobrescreve os parâmetros com valores padrão.

3. Execute o shell script de migração de dados, migrateDataToXml.sh. Essearquivo está no diretório $TOP/bin/migration.migrateDataToXml.sh --company=<company name> --threads=<number of threads>

Em que

--companyEspecifica o código da empresa que é usado para efetuar logon noInfoSphere MDM Collaboration Server.

--threadsEspecifica o número de encadeamentos. Use um número maior deencadeamentos para melhorar a velocidade, mas assegure-se de queexistam conexões de BD suficientes. O padrão é 1. É recomendadofornecer pelo menos 10 encadeamentos.

Por exemplo,migrateDataToXml.sh --company=ibm --threads=50


O que Fazer Depois

É possível verificar se o script funcionou conforme planejado observando os errosque são exibidos no console e registrados no arquivo default.log no diretório$TOP/logs/default. Uma lista de entradas que falharam ao migrar é exibida nofinal da execução.

O script de migração de dados atualiza o banco de dados em lotes. Se houver umerro, o lote inteiro é retrocedido. Por isso, o número de entradas que falharam aomigrar é maior que as falhas reais. Atualize o valor do parâmetroindex_regeneration_batch_size para 1 no arquivo common.properties e, emseguida, execute o script de migração de dados novamente para reduzir asentradas com falhas reais. É fornecida uma tabela dos motivos possíveis para oserros durante a migração de dados e as ações recomendadas:

Tabela 1. Motivos Possíveis para Erros e as Ações Recomendadas

Motivos para o erro durantea migração de dados Ação recomendada

A migração de dados exibe oseguinte erro:

java.sql.SQLException:ORA-00600: internal errorcode, arguments: [KGHALP1],[0x000000000], [], [], [],[], [], [], [], [], [], []

Certifique-se de estar usando o nível de correção corretopara o banco de dados. Se necessário, atualize o banco dedados e, em seguida, execute o script de migração de dadosnovamente.

A migração de dados exibe oseguinte erro:

java.sql.SQLException:ORA-31061: XDB error:XML event errorORA-19202: Error occurredin XML processingIn line 46 of orastream:LPX-00241: entity referenceis not well formed

Um dos valores de atributo na entrada tem o caractere "&"ou um valor inválido. Atualize a entrada para remover ovalor inválido da interface de edição do item do InfoSphereMDM Collaboration Server e, em seguida, tente a migraçãode dados novamente.

Migrando da V9.1 para a V11.4Para migrar para o IBM InfoSphere Master Data Management Collaboration ServerVersão 11.4 do IBM InfoSphere Master Data Management Server for ProductInformation Management Versão 9.1.0, deve-se executar o script de migraçãoapropriado.

Antes de Iniciar

Antes de ser possível migrar do InfoSphere MDM Server for PIM V9.1.0 para oInfoSphere MDM Collaboration Server V11.4, deve-se assegurar de usarespecificamente o Fix Pack 2 ou fix packs posteriores para a V9.1.0. Se estiverutilizando o V9.1.0 com qualquer outro nível de fix pack, você deverá migrar paraa versão V9.1.0 Fix Pack 2 ou fix packs mais recentes. Conclua as instruções nasnotas sobre a liberação adequadas.

Também é necessário assegurar que todos os espaços de tabela relacionados aoXML sejam criados conforme descrito no guia de instalação. Assegure-se de que o


usuário do banco de dados InfoSphere MDM Collaboration Server tenhaprivilégios apropriados para usar os novos espaços de tabela.

É possível configurar o local do arquivo de log de erro modificando a variável_ERROR_LOGS no script de migração migrateFrom910.sh. Esta variável éconfigurada para $TOP/logs/errfile.log por padrão.

Se estiver usando os nomes de espaço de tabela customizada em vez de USERS ouINDX padrão, deve-se modificar manualmente os nomes de espaço de tabela emcreate_pimdb.sh e create_pimdb_for_zLinux.sh na pasta $TOP/bin/db_creation.Além disso, deve-se modificar manualmente os nomes de espaço de tabela nosarquivos SQL a seguir. Esta modificação deve acontecer antes de iniciar a migraçãopara o InfoSphere MDM Collaboration Server V11.4.

Tabela 2. Arquivos SQL para modificar ao usar nomes de espaço de tabela customizados

Arquivos SQL a modificar quando o DB2for o banco de dados de backend

Arquivos SQL a modificar quando o Oraclefor o banco de dados de backend

Modifique os nomes de espaço de tabela deUSERS, INDX e BLOB_TBL_DATA para osnomes de espaço de tabela customizadosapropriados nos arquivos SQL a seguir nodiretório $TOP/src/db/schema/dbscripts/db2:

addCaeStepEntryDate.sqladdCehEntryId.sqladdObhCompanyId.sqladdSstShared.sql

Modifique os nomes de espaço de tabela deUSERS, INDX e BLOB_TBL_DATA para osnomes de espaço de tabela customizadosapropriados nos seguintes arquivos SQL nodiretório $TOP/src/db/schema/dbscripts/oracle:

addSstShared.sqladd_icm_index.sqladd_lot_index.sqladd_sca_index.sqladd_sit_index1.sqlredefine_ctg_indexes.sqlmodifyIcm1Index.sql

Sobre Esta Tarefa

As etapas a seguir são a única maneira de migrar do InfoSphere MDM Server forPIM V9.1.0 para o InfoSphere MDM Collaboration Server V11.4, e nenhum outromeio. Não é possível utilizar a ferramenta de exportação e importação deambiente.

Procedimento1. Faça backup do esquema de banco de dados existente.2. Instale o InfoSphere MDM Collaboration Server V11.4 em um diretório

diferente.3. Configure seu banco de dados.

a. Para DB2 bancos de dados, crie novos buffer pools e espaços de tabelaconforme mencionado em Configurando o backup de seu banco de dadosDB2 no guia de instalação.

Nota: O tamanho do espaço de tabela XML_DATA deve ser igual ao espaçoocupado pelo espaço de tabela TCTG_ITD_ITEM_DETAIL. É possívellocalizar o tamanho aproximado da tabela usando a seguinte consulta:select (fpages * 16) / 1024 megabytes from syscat.tablesem que tabschema = esquema atuale tabname como ’TCTG_ITD_ITEM_DETAIL’;


b. Para bancos de dados Oracle, crie novos espaços de tabela e, em seguida,instale o componente Oracle XML DB conforme mencionado emConfigurando seu banco de dados Oracle no guia de instalação.

4. Aponte a instância do InfoSphere MDM Collaboration Server V11.4 para oesquema do banco de dados da V9.1.0, Fix Pack 2 ou posterior. Para apontar ainstância para o banco de dados, inclua os parâmetros do banco de dados noarquivo env_settings.ini. Para obter mais informações, consulte ConfigurandoParâmetros Comuns do Banco de Dados.

5. Execute o script de migração migrateFrom910FP.sh. Este script está disponívelno diretório $TOP/bin/migration. Consulte a seção Resultados do resumo demigração. Se a migração não foi bem-sucedida, é possível executar o script demigração novamente.

6. Migre seus dados conforme mencionado em Migrando dados principais doformato interno para o formato XML.

7. Execute o script test_db.sh para verificar o esquema do banco de dados, aconectividade entre o InfoSphere MDM Collaboration Server e os bancos dedados e para verificar o JDBC e as conexões do cliente nativo. Para obter maisinformações, consulte Script test_db.sh.

8. Inicie a instância do InfoSphere MDM Collaboration Server V11.4.

Resultados

Todas as mensagens, como o status de componentes de migração individuais e oresumo geral da migração, são exibidas no console.

Depois de executar o script de migração, as mensagens são exibidas no consoleque indica se a migração foi bem-sucedida ou falhou.

Essa mensagem será exibida se a migração foi bem-sucedida:-----------------------------------------------------------Resumo da migração-----------------------------------------------------------A migração para o IBM InfoSphere Master Data ManagementO Collaboration Server Versão 11.4.0 está concluído. Verifique asmensagens para ver se há algum erro.

Gerando o relatório de verificação do banco de dados...

___________________________________________________________

Tabelas alteradas

===========================================================Não há nenhuma tabela alterada___________________________________________________________

___________________________________________________________

Tabelas Ausentes

===========================================================Não há nenhuma tabela ausente___________________________________________________________

___________________________________________________________

Índices Alterados


===========================================================Não há nenhum índice alterado___________________________________________________________

___________________________________________________________

Índices Ausentes

===========================================================Não há nenhum índice ausente___________________________________________________________

LOG FILE: $TOP/logs/default/default.log

Essa mensagem será exibida se a migração tiver falhado:!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!Falha na Migração: xxxx!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!Consulte o arquivo para obter detalhes adicionais: /home/pimuser/mdmcs11/logs/errfile.log

Essa mensagem será exibida se a migração de módulos específicos tiver falhado:-----------------------------------------------------------Resumo da migração-----------------------------------------------------------A migração dos seguintes módulos falhou:<nomes dos módulos>

Essa mensagem será exibida se houver uma discrepância nas tabelas ou índices dobanco de dados.Gerando o relatório de verificação do banco de dados...

___________________________________________________________

Tabelas alteradas

===========================================================<nomes das tabelas>___________________________________________________________

___________________________________________________________

Tabelas Ausentes


___________________________________________________________

Índices Alterados

===========================================================<nomes dos índices>___________________________________________________________

___________________________________________________________

Índices Ausentes

===========================================================


<nomes dos índices>___________________________________________________________


Revise o arquivo errfile.log para obter mais mensagens. Para erros de SQL,localize a mensagem de erro detalhada a partir do código de erro SQL, corrija oerro e execute o script de migração novamente. Para obter a ação recomendada nasfalhas de migração, consulte Resolvendo problemas de migração. Entre em contatocom o Suporte de Software IBM se o problema persistir depois de corrigir os erros.

Migrando da V10.0 para a V11.4Para migrar para o IBM InfoSphere Master Data Management Collaboration ServerVersão 11.4 do IBM InfoSphere Master Data Management Server for ProductInformation Management Versão 10.0.0, deve-se executar o script de migraçãoapropriado.

Antes de Iniciar

Antes de ser possível migrar do InfoSphere MDM Collaboration Server V10.0.0para a V11.4, deve-se assegurar de usar especificamente o Fix Pack 1 ou posteriorpara a V10.0.0. Se estiver usando a V10.0.0 GA, você deverá migrar para a V10.0.0Fix Pack 1 ou posterior seguindo as instruções nas notas sobre a liberaçãoadequadas.

É possível configurar o local do arquivo de log de erros modificando a variável_ERROR_LOGS no script de migração migrateFrom1000.sh. Esta variável éconfigurada para $TOP/logs/errfile.log por padrão.

Se estiver usando os nomes de espaço de tabela customizada em vez de o USERSou INDX padrão, deve-se modificar manualmente os nomes de espaço de tabelaem create_pimdb.sh e create_pimdb_for_zLinux.sh na pasta $TOP/bin/db_creation. Além disso, deve-se modificar manualmente os nomes de espaço detabela nos arquivos SQL a seguir. Esta modificação deve acontecer antes de iniciara migração para o InfoSphere MDM Collaboration Server V11.4.









Sobre Esta Tarefa

As etapas a seguir são a única maneira de migrar do InfoSphere MDMCollaboration Server V10.0.0 para V11.4, e nenhum outro meio. Não é possívelutilizar a ferramenta de exportação e importação de ambiente.


diferente.3. Aponte a instância do InfoSphere MDM Collaboration Server V11.4 para o

esquema do banco de dados da V10.0.0, Fix Pack 1 ou posterior. Para apontar ainstância para o banco de dados, inclua os parâmetros do banco de dados noarquivo env_settings.ini. Para obter mais informações, consulte ConfigurandoParâmetros Comuns do Banco de Dados.




Resultados





___________________________________________________________

Tabelas alteradas


___________________________________________________________

Tabelas Ausentes

===========================================================Não há nenhuma tabela ausente


___________________________________________________________

___________________________________________________________

Índices Alterados


___________________________________________________________

Índices Ausentes






___________________________________________________________

Tabelas alteradas


___________________________________________________________

Tabelas Ausentes


___________________________________________________________

Índices Alterados



___________________________________________________________

Índices Ausentes




Migrando da V10.1 para a V11.4Para migrar para o IBM InfoSphere Master Data Management Collaboration ServerVersão 11.4 do IBM InfoSphere Master Data Management Collaboration ServerVersão 10.1.0, deve-se executar o script de migração apropriado.

Antes de Iniciar









Sobre Esta Tarefa

É possível migrar para o InfoSphere MDM Collaboration Server Versão 11.4 doInfoSphere MDM Collaboration Server Versão 10.1.0 GA ou qualquer fix pack (1, 6,7, 8, 9, 10 ou 11).


As etapas a seguir são a única maneira de migrar do InfoSphere MDMCollaboration Server V10.1.0 para a V11.4, e nenhum outro meio. Não é possívelutilizar a ferramenta de exportação e importação de ambiente.




esquema do banco de dados da V10.1.0. Para apontar a instância para o bancode dados, inclua os parâmetros do banco de dados no arquivoenv_settings.ini. Para obter mais informações, consulte ConfigurandoParâmetros Comuns do Banco de Dados.




Resultados





___________________________________________________________

Tabelas alteradas


___________________________________________________________

Tabelas Ausentes



___________________________________________________________

Índices Alterados


___________________________________________________________

Índices Ausentes






___________________________________________________________

Tabelas alteradas


___________________________________________________________

Tabelas Ausentes


___________________________________________________________

Índices Alterados

===========================================================<nomes dos índices>


___________________________________________________________

___________________________________________________________

Índices Ausentes




Migrando da V11.0 para a V11.4Para migrar para o IBM InfoSphere Master Data Management Collaboration ServerVersão 11.4 do IBM InfoSphere Master Data Management Collaboration ServerVersão 11.0.0, deve-se executar o script de migração apropriado.

Antes de Iniciar









Sobre Esta Tarefa

É possível migrar para o InfoSphere MDM Collaboration Server Versão 11.4 doInfoSphere MDM Collaboration Server Versão 11.0.0 GA, qualquer fix pack (1 para5).


As etapas a seguir são a única maneira de migrar do InfoSphere MDMCollaboration Server V11.0.0 para V11.4, e nenhum outro meio. Não é possívelutilizar a ferramenta de exportação e importação de ambiente.


Procedimento1. Pare a instância em execução do InfoSphere MDM Collaboration Server V11.0.0.2. Faça backup do esquema de banco de dados existente.3. Instale o InfoSphere MDM Collaboration Server V11.4 em um diretório


esquema do banco de dados da V11.0.0. Para apontar a instância para o bancode dados, inclua os parâmetros do banco de dados no arquivoenv_settings.ini. Para obter mais informações, consulte ConfigurandoParâmetros Comuns do Banco de Dados.




Resultados





___________________________________________________________

Tabelas alteradas


___________________________________________________________


Tabelas Ausentes


___________________________________________________________

Índices Alterados


___________________________________________________________

Índices Ausentes






___________________________________________________________

Tabelas alteradas


___________________________________________________________

Tabelas Ausentes


___________________________________________________________

Índices Alterados



___________________________________________________________

Índices Ausentes




Migrando da V11.3 para a V11.4Para migrar para o IBM InfoSphere Master Data Management Collaboration ServerVersão 11.4 do IBM InfoSphere Master Data Management Collaboration ServerVersão 11.3, deve-se executar o script de migração apropriado.

Antes de Iniciar









Sobre Esta Tarefa

É possível migrar para o InfoSphere MDM Collaboration Server Versão 11.4 doInfoSphere MDM Collaboration Server Versão 11.3 GA.


As etapas a seguir são a única maneira de migrar do InfoSphere MDMCollaboration Server V11.3 para a V11.4, e nenhum outro meio. Não é possívelutilizar a ferramenta de exportação e importação de ambiente.

É possível configurar o local do arquivo do log de erros modificando a variável_ERROR_LOGS no script de migração migrateFrom1130.sh. Esta variável éconfigurada para $TOP/logs/errfile.log por padrão.

Procedimento1. Pare a execução da instância do InfoSphere MDM Collaboration Server V11.3.2. Faça backup do esquema de banco de dados existente.3. Instale o InfoSphere MDM Collaboration Server V11.4 em um diretório


esquema do banco de dados da V11.3. Para apontar a instância para o banco dedados, inclua os parâmetros do banco de dados no arquivo env_settings.ini.Para obter mais informações, consulte Configurando Parâmetros Comuns doBanco de Dados.

5. Execute o script de migração do migrateFrom1130FP.sh. Este script estádisponível no diretório $TOP/bin/migration. Consulte a seção Resultados doresumo de migração. Se a migração não foi bem-sucedida, é possível executar oscript de migração novamente.



Resultados





___________________________________________________________

Tabelas alteradas


___________________________________________________________


Tabelas Ausentes


___________________________________________________________

Índices Alterados


___________________________________________________________

Índices Ausentes






___________________________________________________________

Tabelas alteradas


___________________________________________________________

Tabelas Ausentes


___________________________________________________________

Índices Alterados



___________________________________________________________

Índices Ausentes





Capítulo 4. Migrando Scripts do InfoSphere MDMCollaboration Server

É possível usar scripts para executar várias funções dentro do IBM InfoSphereMaster Data Management Collaboration Server. Os scripts fornecem um alto graude flexibilidade sem comprometer a eficiência da operação ou a facilidade dodesenvolvimento.

Diferenças de Script em Várias VersõesA versão base que é usada para o IBM InfoSphere Master Data ManagementCollaboration Server Versão 11.4 é WebSphere Product Center Versão 5.0.1;portanto, há diferenças funcionais e comportamentais entre a V5.2.1 e a V11.4.

Os atributos de tipo de dados Flag retornam valores diferentes na V11.4. Em V5.2.1,o tipo de dados Flag retornou uma sequência TRUE/FALSE. Em V11.4, o tipo dedados Flag retorna um equivalente de um valor booleano Java, que pode ter osvalores true/false/null. Portanto, quando você compara um atributo desinalizador, a comparação deve ser como a seguir:if (flagValue==null)

Se o valor de um Flag for impresso, por exemplo, out.write(flagValue);, osvalores impressos serão null, false ou true.

Como o código é compilado em Java ao usar compiled_only_mode, ele lançará umaexceção se os scripts IBM InfoSphere Master Data Management CollaborationServer contiverem palavras-chave Java como variáveis. Além disso, scripts nãocompilam se contiverem variáveis que já estejam sendo usadas pelo InfoSphereMDM Collaboration Server no código gerado. Por exemplo, logger e hmContext.

Outra diferença chave existe nos métodos que retornam um ItemSet ou umCategorySet: Na V5.2.1, se o método não buscou nenhum resultado, ele retornounull. Em V5.3.2, e, portanto, em V11.4, esses métodos retornam um conjunto vaziov Aqui estão os métodos que retornam um ItemSet:

– getCtgItemByAttributeValue(String sNodePath, String sValue)

– getItemSetForCategory(Catalog ctg [, Boolean ordered])

– getItemSetForCatalog()

– getItemSetForUnassigned(CategoryTree ctr, boolean readOnly)

– getItemSetForPrimaryKeys(Array pkeys, Boolean bOptimize)

– getItemSetForSelection()

– getSubset(IItemSet items, Integer start_point [, Integer end_point])

v Aqui estão os métodos que retornam um CategorySet:– getCategorySet([Boolean bReadonly])

– getDescendentCategorySetForCategory([Boolean bReadonly])

– getCategorySetByAttributeValue(String attribPath, Object attribValue,[Boolean bReadOnly])

– getCategorySetByPrimaryKey(String primaryKey, [Boolean bReadOnly])

– getCategorySetByLevel(Integer level, [Boolean bReadOnly])


– getCategorySetByFullNamePath(String[] fullNamePaths, String delimiter)

– getCategorySetByItemSecondarySpec(String specName)

– getCategorySetByStandAloneSpec(String specName)

– getLocationsAddedAvailability(CategoryTree locationHierarchy)

– getLocationsChangedToHaveData(CategoryTree locationHierarchy)

– getLocationsChangedToHaveNoData(CategoryTree locationHierarchy)

– getLocationsHavingChangedData(CategoryTree locationHierarchy)

– getAvailableLocations(Object locationOrCategoryTree)

Métodos com diferentes assinaturas na V6.0 e na V11.4A tabela a seguir compara as operações de script incluídas Na Biblioteca de Scriptdo IBM InfoSphere Master Data Management Collaboration Server V11.4

Métodos com diferentes assinaturas no IBM InfoSphere MDM Server for PIM V6.0e InfoSphere MDM Collaboration Server V11.4.

Tabela 7. Uma comparação dos métodos com diferentes assinaturas no V6.0 e V11.4

Operações da V6.0 Operações da V11.4

String exportEnv(EnvObjectListenvObjList, String sDocFilePath)

String exportEnv(EnvObjectList envObjList,String sDocFilePath, [String sMapFilePath])

Métodos apenas na V9.0 transportados para a V11.4Os métodos a seguir estão disponíveis apenas no IBM InfoSphere Master DataManagement Collaboration Server V9.0 transportados para a V11.4.v commitDB()

v new LinkHandler(String wflName)

v updateLinks(IEntrySet entrySet)

v New PathSelectionHandler(ICollaborationArea colArea)

v selectAndSetPath(IEntrySet entrySet,String propertyName)

v MultiMoveHandler(String wflName)

v moveEntries(IEntrySet entrySet,String stepPath)

v loadWF(String filePath)

v checkOutItem(String wfName, String itemID)

v checkOutCategory(String wfName, String categoryId,StringcategoryTreeName)

v new ChildCheckinHandler(String wflName)

v checkInChilds(IEntrySet entrySet, String stepPath)

v TIAttrVerifier(String wflName)

v verifyAttrGroupsAndSetExitValues(IEntrySet entrySet,String []attrCollectionNames)

v new GDSXMLDocument(Doc doc/String str)

v getXMLNodeValue(Boolean bRequired)

v setXMLNodeValue(String sPath, String value)

v getGDSXMLNodeName()

v getXMLNodePath()

v getGDSXMLNode()


v addXMLNode(GDSXMLNode xmlNode [,String path])

v removeXMLNode(Object obj)

v getXMLNode(String path)

v cloneXMLNode()

v setValue(String path, String value)

v getGDSXMLNodes(String path)

v removeAustinNodes(String path)

v getXMLString()

v getGDSXMLNodeFromXMLNode(XMLNode xmlnode)

v getNewPublicationMessageIds()

v getNewPublicationMessageIdsByType(String[] messageTypes)

v getPublicationMessageIdsByDate(String fromDate, String toDate [,StringrecipientGLN])

v MessageItemHandler(String messageId)

v getTradeItems()

v sendConfirmation(String confirmationType,String[] messageIds)

v getLinks()

v changeState()

v getHierarchyTree()

v getAssociatedLinks(String gtin, Boolean fetchChildLinks)

v getInternalCode()

v setNodeType(String nodeType)

v sendCICConfirmationReasonCodes(String confirmationType,StringMsgId,HashMap hmCICReasonCodeData)

v new CICStatus(String confirmationStatusCode, StringconfirmationStatusCodeDescription, String languageISOCode [,StringadditionalConfirmationStatusDescription] [,String correctiveAction][,String expectedCorrectiveInformation])

v getParent(int index)

v getChild(int index)

v getNumberOfChildren()

v getNumberOfParents()

v getRootTradeItem()

v isLeaf()

v getLinkQuantity()

v createNotification(IBusinessObject iObj, String notfType, StringuserName)

v new TradeItemSS(String sGtin, String sGTINName, String sProductType,String sInternalCatCode, [String sDataPoolCatCode])

v getTradeItemSS(String sGTIN,String sTM,String sIP)

v setTradeItemAttributesSS(HashMap hmAttributePathsToValues)

v setTradeItemAttributeSS(String attributePath,String attributeValue)

v getTradeItemAttributeValueSS(String sAttrPath)

v toBoolean(String str)

v validateGTIN(String sGTIN)

v validateGLN(String sGLN)

Capítulo 4. Migrando Scripts do InfoSphere MDM Collaboration Server 29

v getGTINCategory(String sGTIN)

v getGTINTree(String sGTIN, String sProductType, Integer iLinkQuantity,String sLinkStatus)

v addChild(GTINTree tree)

v removeChild(String sGTIN)

v saveTradeItemSS()

v searchTradeItems(HashMap hmSearchParamsToValues)

v getTradeItemParentLinks()

v getTradeItemChildLinks()

v getModifiedTradeItems(String transactionType, Date startDate, DateendDate)

v getItems()

v setUDEXCategoryCode(String code)

v setInternalCategoryCode(String code)

v validateTradeItem()

v validateTradeItemAttribute(String sAttrPath)

v validateTradeItemAttributeGroup(String sAttributeGroup)

v new TradeItemDS(String sEANUCCCode, String sEANUCCCodeType, StringsExtensionName, String sProductType,String sGPCCode[,StringsInternalCatCode ,String sGTIN ,String sGTINName])

v getExchangeSpecificAttribute()

v getTradeItemDS(String sEANUCCCode,String sTM,String sIP,[StringsGTIN],[String recipientGLN])

v setTradeItemAttributesDS(HashMap hmAttributePathsToValues)

v setTradeItemAttributeDS(String attributePath,String attributeValue)

v getTradeItemAttributeValueDS(String sAttrPath)

v saveTradeItemDS()

v getAllTradeItemAttributes()

v searchTradeItemsDS(HashMap hmSearchParamsToValues)

v deleteTMIPVariant()

v deleteGTIN()

v isTradeItemCheckedOut()

v getWWREExchangeSpecificAttribute()

v isWWREInteroperablee()

v addItemSS(HashMap sEntryMap, String strDate)

v synchronizeItemChangesSS(HashMap sEntryMap, String strDate, StringoperationType)

v publishNewItemSS(HashMap sEntryMap, HashMap tradingPartners,StringstrDate, String operationType)

v sendInitialLoadSS(HashMap sEntryMap, HashMap tradingPartners, StringstrDate, String operationType)

v addItemLinksForMassTransactionsSS(HashMap sEntryMap, String strDate)

v getCtgItemAttribValues()

v readGDSPropertiesSS(String sPropkey)

v searchTradeItems(HashMap hmSearchParamsToValues,String start, String end)

v processMassTransaction(String massJobID,HashMap hmSearchParamsToValues)


v HashMap setMassImportSS(boolean bImport)

v publishPublicationList(HashMap hmSearchParamsToValues)

v new TradeItemLink(String parentGTIN, String childGTIN [,IntegerlinkQuantity])

v setLinkAttributes(HashMap hmAttributeNamesToValues [,StringinformationProvider])

v setLinkAttribute(String attributeName,String attributeValue [,StringinformationProvider])

v getTradeItemLink(String parentGTIN, String childGTIN)

v saveTradeItemLink()

v deleteTradeItemLink()

v getLinkAttributeValue(String sAttrName)

v getParentGTIN()

v getChildGTIN()

v new TradingPartner(String sGLN, String sPartnerName, String sCountry,String sGLNID, String itemType)

v new TradingPartner(String sGLN, String sPartnerName, String sCountry,String itemType)

v getTradingPartner(String sGLN)

v setPartnerAttributes(HashMap hmAttributePathsToValues)

v setPartnerAttribute(String attributePath,String attributeValue)

v saveTradingPartner()

v searchTradingPartners(HashMap hmSearchParamsToValues)

v getPartnerAttributeValue(String sAttrPath)

v createTransaction(IBusinessObject iObj, String txnType, String userName)

v isString()

v iterator()

v hasNext()

v next()

v isLangSpecificAttr(String sAttrPath)

v getGDSLanguages()

v flushGDSCache()

v new WWREMessageHandler(String wflName)

v sendMessage(IEntrySet entrySet,String messageType[, ListtransactionVOList])

v new MessageValidationResult(String sMsgID, String sMessage)

v new TradeItemValidationResult(String sKey)

v new AttributeValidationResult(String sKey)

v new ValidationResultObject(String sRuleName)

v addValidationResult(ValidationResultObject refValidationResultObject,String sMessage, String sStatus, String sType, Object objHolder)

v addValidationResultObject(AbstractValidationResultrefAbstractValidationResult, ValidationResultObjectrefValidationResultObject)

v addTradeItemValidationResult(MessageValidationResultrefMessageValidationResult, TradeItemValidationResultrefTradeItemValidationResult)


v addAttributeValidationResult(TradeItemValidationResultrefTradeItemValidationResult,AttributeValidationResultrefAttributeValidationResult)

v getValidationResultObjectList(AbstractValidationResultrefAbstractValidationResult)

v getTradeItemValidationResultList(MessageValidationResultmsgValidationResult)

v getAttributeValidationResultList(TradeItemValidationResulttradeItemValidationResult)

v setValidationResultStatus(boolean bStatus)

v getValidationResultStatus()

v setValidationResultMessage(String message)

v setLocalizedValidationResultMessage(String messageID [,String[]arguments])

v addLocalizedValidationResultMessage(String messageID [,String[]arguments])

v getValidationResultMessage()

v setValidationResultHolder(Object holder)

v getValidationResultHolder()

v setValidationResultType(String sType)

v getValidationResultType()

v getTradeItemsInMsgItemDS(Item msgItem)

v getValidationResult(AbstractValidationResult refAbstractValidationResult)

v getMessageTypeName(Item msgItem)

v getDataPoolNameForMsgItem(Item msgItem)

v new TransactionHandlerDS()

v insertTransactionDS(ICollaborationArea colArea,IEntrySet entrySet,StringstepPathString,String trasactionType,String status,String stepTrasition)

v updateTransactionDS(ICollaborationArea colArea,IEntrySet entrySet,StringstepPathString,String trasactionType,String status,String stepTrasition)

v new StatusUpdaterDS()

v updateTradeItemGlobalStatusDS(IEntrySet entrySet,String status)

v updateTradeItemLocalStatusDS(IEntrySet entrySet,String status)

v updateStatusDS(IEntrySet entrySet,String status)

v new NotificationHandlerDS(String wflName)

v notifyUsersForActionDS(IEntrySet entrySet,String action)

v notifyUsersForActionWithStatusDS(IEntrySet entrySet,String action)

v new InternalSyncHandler()

v synchronize(IEntrySet entrySet)

v new EnrichmentHandler()

v canStartEnrichment(IEntrySet entrySet)

v startEnrichment(IEntrySet entrySet)

v new InitialLoadSaver()

v saveInitLoadEntries(IEntrySet entrySet)

v new MessageValidator()

v checkInitLoadAndSetExitVal(IEntrySet entrySet)

v new CategoryMappingValidator()


v verifyAndSetExitValues(IEntrySet entrySet)

v getTransactionDetails(ICollaborationArea colArea,IEntrySetentrySet,String stepPathString,String trasactionType,String status,StringstepTrasition)

v runWFTest(String ar1,String arg2, String arg3)

v createTestData(String ar1,String arg2)

v GDSCreateMassPublicationItems(IEntrySet entrySet)

v GDSDeleteMassPublicationItems(IEntrySet entrySet)

v GDSCheckFilters(IEntrySet entrySet)

v LogInboundTransaction(IItem msgItem,String transactionType, StringsenderGLN, String msgFilePath)

v TransactionHandlerSS()

v insertTransactionSS(ICollaborationArea colArea,IEntrySet entrySet,StringstepPathString,String trasactionType,String status,String stepTrasition)

v updateTransactionSS(ICollaborationArea colArea,IEntrySet entrySet,StringstepPathString,String trasactionType,String status,String stepTrasition)

v new StatusUpdaterSS()

v updateStatusSS(IEntrySet entrySet,String status)

v updateTradeItemGlobalStatusSS(IEntrySet entrySet,String status)

v updateTradeItemLocalStatusSS(IEntrySet entrySet,String status)

v new NotificationHandlerSS(String wflName)

v notifyUsersForActionSS(IEntrySet entrySet,String action)

v notifyUsersForActionWithStatusSS(IEntrySet entrySet,String action,Stringstatus)

v invokeWorkflowSS(HashMap entryMap, String sWFName)

v publishEntriesToSrcContainer (EntrySet entrySet)

v setLdapOperation (LdapOperation operation)

v setViewableAttributeGroups (String subViewType, String[]/AttrGroup[]attrGroups, [String locationHierarchyName])

v isItemAvailableInLocation (Category location)

v isBinary ()

v reset ()

v getCurrentLocation ()

v getEntryInStep (String stepPath)

v deleteLookupTable (LookupTable lkp)

v assertFalse (Boolean condition, [String message])

v getEntryAttribValues (String sAttribPath)

v getSearchTemplateName ()

v getLdapObjectclasses ()

v getCategoryParentsUsingCache (CategoryCache cat_cache)

v getCtgItemLocationAttribsForKeys (Category location, Object[] aAttribPath[, String sDelimiter])

v getAddedAttributePathsNewEntry ([Category location])

v getItemRootEntryNodesHavingLocationData ()

v getEntryChangedDataSinceLastSave ()

v getDate (int columnIndex)


v addLdapAttribute (LdapAttribute attribute)

v getLocationPathForInheritedValue (String delimiter)

v getModifyLocationHierarchyAvailability (String locationHierarchyName)

v makeItemAvailableInLocations (Category[] locations, [Boolean bRecursive])

v encodeUsingCharset (String charset)

v getLocationsAddedAvailability (CategoryTree locationHierarchy)

v getEntryRelationshipAttrib (String sAttribPath)

v new$LdapObjectclass (String objclass)

v getWflStepView (String subViewType, [String locationHierarchyName])

v getLocationsChangedToHaveData (CategoryTree locationHierarchy)

v setLdapDistinguishedName (LdapAttribute dn)

v getLocation ()

v xmlDocToString ()

v getAvailableLocations (Object locationOrCategoryTree)

v writeFileUsingReader (Reader r)

v setEditableAttributeGroups (String subViewType, String[]/AttrGroup[]attrGroups, [String locationHierarchyName])

v getDynamicSelectionQueryString ()

v setActionModeToExport (String sActionMode)

v addLdapEntry (LdapEntry entry)

v getLdapOperation ()

v getCategory (int columnIndex)

v getHierarchy (int columnIndex)

v removeLocationSpecificData (CategoryTree ctr)

v parseDate (String value, String format[,Locale locale])

v new$SearchQuery (String queryString)

v getStepsForEntry (Entry entry)

v getWsddDocPath ()

v setRequiredAttributeGroups (String subViewType, String[]/AttrGroup[]attrGroups, [String locationHierarchyName])

v getWflStepViews ()

v startExportByName (String sName)

v getErrorsForLocation ()

v getInt (int columnIndex)

v parseXMLNodeWithNameSpace (String sXMLSubPath)

v initializeKeyValueMapping (Object[] aKeyset)

v assertTrue (Boolean condition, [String message])

v getCtgItemAttribsForKeys (Object[] aAttribs [, String sDelimiter])

v getNodeDisplayName ([Locale locale])

v getLocationErrors ()

v getLdapEntries ()

v getRequiredAttributeGroups ([String subViewType], [StringlocationHierarchyName])

v getEntryChangedData (Entry oldEntry, Entry newEntry)

v getLocaleNode (Locale locale)


v locationHasData (Category location)

v execute ()

v makeItemUnavailableInLocations (Category[] locations, [BooleanbRecursive])

v getLdapAttributes ()

v assertNotNull (Object obj, [String message])

v getLocationsHavingChangedData (CategoryTree locationHierarchy)

v getLocationsHavingData (Object locationOrCategoryTree)

v getSpec (int columnIndex)

v getItemLocationAttrib (Category location, String sAttribPath)

v runQuery (String qryString)

v getLdapAttributeValue ()

v defineLocationSpecificData (CategoryTree ctr, Spec spc, AttrGroup[]inhAttrGrps)

v new$SearchTemplate (String name, Array attrGroupNames, Containercontainer, String desc, [String colAreaName, String stepPath])

v getBoolean (int columnIndex)

v setItemLocationData (Item item, CategoryTree locationTree, String[]locFullPaths, String delimiter, Boolean rootIncluded[, Boolean append])

v setImplclass (String implclass)

v isInheriting (Category location, String sAttribPath)

v new$LdapEntry ()

v getLdapAttributeType ()

v setXMLNodeValue (String sPath, String value)

v parseLDIFFile (String filename)

v dropEntry (Entry entry)

v new$DynamicSelection (String selectionName, String queryString)

v makeItemAvailableInLocation (Category location, [Boolean bRecursive])

v getCategoryChildrenUsingCache (CategoryCache cat_cache)

v isDefined (int columnIndex)

v getEntryNodeType ()

v setAuthRequired (Boolean authRequired)

v flushScriptCache ()

v getLocationsRemovedAvailability (CategoryTree locationHierarchy)

v getScriptExecutionMode ()

v getModifiedAttributePathsOldEntry ([Category location])

v copySearchItemData (Item searchItem[, Boolean append])

v copySearchItemLocationTreeData (Item searchItem, CategoryTreelocationTree[, Boolean append])

v createLDIFFile (String docstore_filename, LdapEntrySet entrySet)

v getLong (int columnIndex)

v decodeUsingCharset (String charset)

v moveEntryToNextStep (Entry entry, String stepPath, String exitValue)

v isAuthRequired ()

v getSearchTemplateByName (String name)

v getItemRootEntryNodeForLocation (Category location)


v getViewableAttributeGroups ([String subViewType], [StringlocationHierarchyName])

v moveEntryToColArea (Entry entry, String destColAreaName)

v getCtgViewType ()

v getPossibleEntryNodeValues ()

v getItemUsingEntryRelationshipAttrib (String sAttribPath)

v javaArrayFromScriptArray (Array scriptArray, String type)

v getXMLNode (String nodePath)

v assertEquals (Object expectedValue, Object actualValue, [String message])

v addLdapObjectclass (LdapOperation objectClass)

v new$LdapEntrySet ()

v setNodeIndexed (Boolean)

v isNodeIndexed ()

v getProductCenterURL - Retorna a propriedade trigo_web_url definida noarquivo common.properties, que detém a URL totalmente qualificada, incluindonúmero da porta, do website para o qual os usuários apontam seus navegadorespara acessar essa instância do InfoSphere MDM Collaboration Server.

v assertNull (Object obj, [String message])

v setXMLNodeValues (String sPath, String[] values)

v setModifyLocationHierarchyAvailability (String locationHierarchyName,Boolean canModifyAvailability)

v getFlatEntryNodesOf (EntryNode en)

v checkOutEntry (Entry entry, [String stepPath], [boolean waitForStatus)

v getLocationHierarchyNames ([Boolean canModifyAvailability])

v getGlobalErrors ()

v getItem (int columnIndex)

v getModifiedAttributePathsNewEntry ([Category location])

v deleteCtgView (CtgView ctgView)

v getLocationsChangedToHaveNoData (CategoryTree locationHierarchy)

v new$SearchSelection (Catalog catalog, String name)

v getDouble (int columnIndex)

v moveCursor (int position)

v getXMLNodes (String sPath)

v getLdapObjectclass ()

v new$LdapAttribute (String attributeType, Object attributeValue [, BooleanisBinary, Boolean isExternal)

v getImplclass ()

v getAllUsers ()

v getEditableAttributeGroups ([String subViewType], [StringlocationHierarchyName])

v getXMLNodeValues (String nodePath [, Boolean bRequired])

v getFloat (int columnIndex)

v makeItemUnavailableInLocation (Category location, [Boolean bRecursive])

v deleteSearchTemplate ()

v getDeletedAttributePathsOldEntry ([Category location])

v isExternal ()


v setInheriting (Category location, String sAttribPath, [Boolean flag])

v setWsddDocPath (String wsddDocPath)

v getString (int columnIndex)

v setItemLocationAttrib (Category location, String sAttribPath, ObjectsValue)

v scriptArrayFromJavaArray (OneDimensionalJavaArray)

v setEntryAttribValues (String sAttribPath, Object[] sValues)v getLdapDistinguishedName ()

v executeInBackground (String selectionName)

v getLocationForErrors ()

v disableEntryValidation(Entry collabAreaEntry, String workflowStepAtPath,Boolean disableValidation)

v isEntryNew()

v item.getCtgItemRelatedItemInfo()

Nota:

– Esta operação de script foi reprovada no WebSphere Product Center V5.2.1– Esta operação de script é substituída por

entry::getEntryRelationshipAttrib(string) no InfoSphere MDMCollaboration Server V9.0.0.

v moveUserToOrganization(Category srcOrg,Category dstOrg)

v copyUserToOrganizations(Category[] organizations)

v removeUserFromOrganization(Category organization)

v invocationCacheGet(String key)

v invocationCachePut(String key, Object value)

v invocationCacheRemove(String key)

v invocationCacheClear()

v setDynamicSelectionQueryString(String queryString)

v getExactAttributePath()

v String ExcelCell::getExcelCellEncoding()

Mudanças no comportamento de operações de script queexistem a partir de V5.3.2 e V11.4

A lista a seguir fornece as mudanças no comportamento de operações de scriptexistentes em ambas as Bibliotecas de Scripts, WebSphere Product Center V5.3.2 eIBM InfoSphere Master Data Management Collaboration Server V11.4.

setContainerProperties()Comportamento na V5.3.2.v As propriedades que são especificadas no hashmap PROPERTIES são

configuradas para o contêiner em questão.

Comportamento na V11.4.v As propriedades que são especificadas no hashmap PROPERTIES são

configuradas para o contêiner em questão. A chave de hashmap"SCRIPT_NAME" é, agora, reprovada e "POST_SCRIPT_NAME" deve serusado em seu lugar.

getCategoryAttrib()Comportamento na V5.3.2.


v Retorna o valor do atributo sAttribPath (spec_name/attribute_name)dessa categoria.

Comportamento na V11.4.v Retorna o valor do atributo sAttribPath (spec_name/attribute_name)

dessa categoria, somente quando o Atributo está incluído naVisualização ou Coleta de Atributos, caso contrário, retorna null.

getEntryAttrib()Comportamento na V5.3.2.v Retorna o valor do atributo sAttribPath (spec_name/attribute_name)

dessa entrada.


dessa entrada, somente quando o Atributo está incluído na Visualizaçãoou Coleta de Atributos, caso contrário, retorna null.

getCtgItemAttrib()Comportamento na V5.3.2.v Retorna o valor do atributo sAttribPath (spec_name/attribute_name)

desse item.


desse item somente quando o Atributo está incluído na Visualização ouColeta de Atributos, caso contrário, retorna null.

removeNode()Comportamento na V5.3.2.v Retorna Booleano.

Comportamento na V11.4.v Retorna anulado.

setTypeToExport()Comportamento na V5.3.2.v Configura o tipo de objeto a ser exportado.

Comportamento na V11.4.v Configura o tipo de objeto a ser exportado.

COLLABORATION_AREA_CONTENT, INHERITANCE_RULESremovido da lista de valores aceitáveis para sObjectType.

addObjectByNameToExport()Comportamento na V5.3.2.v COLLABORATION_AREA_CONTENT é um valor aceitável para

sObjectType.

Comportamento na V11.4.v COLLABORATION_AREA_CONTENT é removido da lista de valores

aceitáveis para sObjectType.

addAllObjectsToExport()Comportamento na V5.3.2.v COLLABORATION_AREA_CONTENT é um valor aceitável para

sObjectType.

Comportamento na V11.4.


v COLLABORATION_AREA_CONTENT é removido da lista de valoresaceitáveis para sObjectType.

disableContainerProcessingOptions(String[] options)Comportamento na V5.3.2.v Desativar as opções de processamento especificadas.

Comportamento na V11.4.v Desativar as opções de processamento especificadas. Mais valores

possíveis para o parâmetro de opções: ENTRY_BUILD_SCRIPT eUNIQUE_VALIDATION.

setEntryNodeValue()Comportamento na V5.3.2.1. Cria um nó se não estiver presente.2. Retorna o valor que foi configurado.

Comportamento na V11.4.1. Ele produz um erro se o nó ainda não estiver presente; deve-se criar

um novo nó usando entry.setEntryAttrib().2. Retorna 1/0/-1 com base na ação executada (sucesso, nada foi alterado,

erro).

getEntryNode()Comportamento na V5.3.2.1. Sempre que um novo item ou categoria é criado, uma ocorrência do nó

MultiAttibute está presente por padrão.itemNode.getEntryNode("/SpecForMigTest/Multi#0/Sub-Multi#0")

Retorna o nó.2. Se o caminho especificado não for localizado, V5.3.2 criará e retornará o

nó. Retorna nulo se o caminho não for válido.

Comportamento na V11.4.1. V11.4 produz um erro se o caminho ainda não estiver presente.2. V11.4 não cria um nó.

setEntryNode()Comportamento na V5.3.2.1. A V5.3.2 o criará e retornará o nó; caso contrário, retorna nulo se o

caminho não for válido

Comportamento na V11.4.1. V11.4 produz um erro se o caminho ainda não estiver presente.

getEntryNodeChildren()Comportamento na V5.3.2.1. A V5.3.2 retorna os filhos reais do nó de agrupamento.

itemNode = item.getRootEntryNode(); node =itemNode.setEntryNode("/SpecForMigTest/Multi");

Saída:SpecForMigTest/Multi/Sub-Multi

Comportamento na V11.4.1. V11.4 retorna as ocorrências de vários e não dos filhos reais, por

exemplo


itemNode = item.getRootEntryNode(); node =itemNode.setEntryNode("/SpecForMigTest/Multi");

Saída: /SpecForMigTest/Multi#0 /SpecForMigTest/Multi#1

getEntryNodes()Comportamento na V5.3.2.1. Na V5.3.2 os filhos também são retornados como os caminhos dos

filhos e contêm o caminho especificado na operação de script.itemNode = item.getRootEntryNode(); nodes =itemNode.getEntryNodes("/SpecForMigTest/Multi"); out.writeln(nodes);

Comportamento na V11.4.1. V11.4 não retorna filhos.

getEntryNodeParent()Comportamento na V5.3.2.1. A V5.3.2 retorna os pais reais.

itemNode = item.getRootEntryNode(); node =itemNode.getEntryNodes("/SpecForMigTest/Multi#0/Sub-Multi#0");out.writeln("Node:: " + node[0].getEntryNodePath());out.writeln("Node Parents:: "+ node[0].getEntryNodeParent().getEntryNodePath());

Saída:Nó::SpecForMigTest/Multi/Sub-Multi Node Parents:: SpecForMigTest/Multi

Comportamento na V11.4.1. V11.4 retorna o nó do grupo, em vez do pai real.

itemNode = item.getRootEntryNode(); node =itemNode.getEntryNodes("/SpecForMigTest/Multi#0/Sub-Multi#0");out.writeln("Node:: " + node[0].getEntryNodePath());out.writeln("Node Parents:: "+ node[0].getEntryNodeParent().getEntryNodePath());

Saída:Nó:: SpecForMigTest/Multi/Sub-Multi NodeParents::SpecForMigTest/Multi/Sub-Multi

getFlatEntryNodes()Comportamento na V5.3.2.1. Este método retorna uma matriz de EntryNodes simples desta entrada.

Comportamento na V11.4.Este método criou exceções em versões anteriores e as exceções foramcausadas getEntryNodeValue no entryNode retornado porgetFlatEntryNodes. A exceção ocorre porque agora, com o formulárioserializado há um novo entrynode retornado por getFlatEntryNodeschamado de nó directory. Para atributos simples que são de váriasocorrências, um entrynode extra é retornado e seu node::type é STRINGou qualquer que seja o tipo do atributo. O script tenta obter o valor erelatá-lo. Portanto, uma correção é fornecida na Versão 5.3.2 em que depoisde getFlatEntryNodes retornar os nós, um novo métodogetEntryNodeType() verifica seu tipo. Se acontecer de o tipo ser V, só entãoo nó de entrada será processado. Aqui está o protótipo do método:<prototype>

<![CDATA[String EntryNode::getEntryNodeType()]]></prototype><description>

<![CDATA[return "V" = value, "G" = Agrupamento ou nível superior do diretório especificado,"M" = Multi-diretório (contém várias ocorrências de valores ou agrupamentos))]]></description>


A seguir está um exemplo da implementação.

ctg1 = getCtgByName( "<catalog name>" );itm1 = ctg1.getCtgItemByPrimaryKey( "<primary key of item>" );ents1 = itm1.getFlatEntryNodes();

for( i=0; i<ents1.size(); i++ ){var val1 = "----";var ent1 = ents1[i];

var ePath1 = ent1.getEntryNodeExactPath();out.write( ePath1 + " " );

var type1 = ent1.getEntryNodeType();out.write( type1 + " " );

if( type1 == "V" ){val1 = "" + ent1.getEntryNodeValue();

}else{val1 = "" + ent1.getEntryNodeChildren().size();

}out.writeln( val1 );

}

setTypeToExport(String sObjectType)Comportamento na V5.3.2.v COLLABORATION_AREA_CONTENT é um valor aceitável para

sObjectType

Comportamento na V11.4.v COLLABORATION_AREA_CONTENT é removida da lista de valores

aceitáveis para sObjectType

addObjectByNameToExport(String sEntityName[, String sObjectType, [StringsActionMode]])

Comportamento na V5.3.2.v COLLABORATION_AREA_CONTENT é um valor aceitável para

sObjectType



addAllObjectsToExport([String sObjectType, [String sActionMode]])Comportamento na V5.3.2.v COLLABORATION_AREA_CONTENT é um valor aceitável para

sObjectType



Mudanças no comportamento das operações de script da V6.0e V11.4

A lista a seguir fornece as mudanças no comportamento para as operações descript que existem nas bibliotecas de script do IBM InfoSphere Master DataManagement Collaboration Server V6.0 e V11.4.

exportEnv ()Comportamento na V6.0.v Exporta os objetos do InfoSphere MDM Collaboration Server que são

especificados em envObjList no caminho docstore especificado. OsDocFilePath contém o caminho do arquivo compactado que é exportadopara o armazenamento de documentos. Este método retorna o log comouma sequência.


Comportamento na V11.4.v Exporta os objetos do InfoSphere MDM Collaboration Server que são

especificados em envObjList no caminho docstore especificado. OsDocFilePath contém o caminho do arquivo compactado que é exportadopara o armazenamento de documentos. Se sDocFilePath for especificadocomo file:/// seguido pelo caminho no sistema de arquivos, o arquivocompactado será exportado diretamente para o sistema de arquivos enão para docstore. O parâmetro opcional sMapFilePath é o caminho doarquivo de mapeamento de nomes no sistema de arquivos, que fornece oobjeto para os mapeamentos de nomes de arquivos para os objetos queestão sendo exportados. Este método retorna o log como uma sequência.

Diferenças da API Java Entre Várias VersõesA versão base que é usada para a API do Java API IBM InfoSphere Master DataManagement Collaboration Server Versão 11.4 é o WebSphere Product CenterVersão 5.3.2.

Enums e Métodos API JavaEsta seção fornece os novos métodos e enums incluídos nas interfaces que existemtanto no IBM InfoSphere MDM Server for PIM V6.0.0, Fix Pack 5, V9.1.0 como noIBM InfoSphere Master Data Management Collaboration Server V11.4.

AttributeDefinition.javaenum: AttributeDefinition.Type: RICH_TEXT andEXTERNAL_CONTENT_REFERENCE added

method: public int getId()

AttributeDefinitionProperty.javaenum AttributeDefinitionProperty.Name: GROUP e LOCALE_NODEreprovados

enum AttributeDefinitionProperty.Name: RICH_TEXT incluído

AttributeInstance.javamethod: public void setValueUsingJSON(Object value)

AttributeOwner.javamethod: public AttributeInstance getAttributeInstance(int[]nodeIdArray, int[] indexArray, boolean bFollowInheritance, booleancreateOccurrencesIfNeeded)

Item.javamethod: public OrderedJSONObject toJSON(booleanincludeAttributeType)

method: public void addStatusAndAvailability(OrderedJSONObjectitemJSONObj)

Catalog.javamethod: public PIMCollection<Item> getItems(int[] itemIds)

method: public PIMCollection<Item> getItems(Object[] itemIds)

method: public void setIgnoreCache(boolean ignoreCache)

method: public boolean getIgnoreCache()

method: public boolean isCached()

method: public void setCached(boolean setCached)


method: public OrderedJSONObject toJSON()

CatalogManager.javamethod: public Catalog getCatalog(String catalogName, booleanreturnItem)

method: public Catalog getCatalog(int catalogId)

method: public Catalog getCatalog(int catalogId, boolean returnItem)

CategoryCollaborationArea.javamethod: public CollaborationCategory createCollaborationCategory()

CollaborationCategory.javaenum: CollaborationCategory.SaveResult

method: public SaveResult getSaveResult()

method: public Collection<SecondarySpec> getItemSecondarySpecs()

method: public OrderedJSONObject toJSON(booleanincludeAttributeType)

method: public void addStatusAndAvailability(OrderedJSONObject

collaborationCategoryJSONObj)method: public void addItemSecondarySpec(SecondarySpec spec,Collection<Catalog> catalogs, boolean addToChildCategories, booleanaddAcrossMapping)

method: public void addSecondarySpec(SecondarySpec spec)

method: public void removeItemSecondarySpec(SecondarySpec spec)

CollaborationItem.javamethod: public OrderedJSONObject toJSON(booleanincludeAttributeType)

method:public void addStatusAndAvailability(OrderedJSONObjectcollaborationItemJSONObj)

CollaborationStep.javamethod: public CollaborationObject getCollaborationObject(int id)

enum ValidationError.TypeEstes métodos são incluídos: TOTAL_DIGITS, MIN_EXCLUSIVE,MIN_INCLUSIVE, MAX_EXCLUSIVE, MAX_INCLUSIVE

Context.javamethod: SearchQuery createSearchQuery(String queryString,Collection<Item> items, Catalog catalog)

method: public String setSavepoint()

method: void rollbackToSavepoint(String name)

method: public SearchHelper getSearchHelper()

method: public HistoryManager getHistoryManager()

method: public MessageBundle getMessageBundle()

method: public MessageBundle getMessageBundle(Locale locale)

method: void disableAllAccessChecking()

method: void enableAllAccessChecking()


Category.javaenum: Category.SaveResult

method: public Collection<String[]> getFullDisplayPaths()

method: public Collection<Integer> getSecondarySpecIdsForChildren()

method: public OrderedJSONObject toJSON(booleanincludeAttributeType)

method: public void addStatusAndAvailability(OrderedJSONObjectcategoryJSONObj)

method: public View getDefaultView()

Hierarchy.javamethod: public Category createCategory()

method: public PIMCollection<Category> getCategories(int[]categoryIds)

method: public PIMCollection<Category> getCategories(Object[]categoryIds)

method: public OrderedJSONObject toJSON()

HierarchyManager.javamethod: public Hierarchy getHierarchy(int hierarchyId)

OrganizationManager.javamethod: public OrganizationHierarchy getOrganizationHierarchy(intid)

SearchQuery.javaenum SearchQuery.ColumnType: LOGENTRY added enum:SearchQuery.SearchQueryOp

SearchResultSet.javamethod: public UserDefinedLogEntry getUserDefinedLogEntry(intcolumnIndex) throws PIMSearchException

SelectionManager.javamethod: public Selection getSelection(int selectionId)

Spec.javamethod: public AttributeDefinition getAttributeDefinition(intattributeDefinitionId)

SpecManager.javamethod: public Spec getSpec(int specId)

EnvironmentExporter.javamethod: public String export(ExportList exportList, StringdocumentPath, String mappingPath)

method: public String export(ExportList exportList, StringdocumentPath, boolean checkForRequisites)

checkForRequisites, String mappingPath)method: public String exportAll(String documentPath, StringmappingPath)

SavedSearch.javamethod: public boolean isShared()

method: public void setShared(boolean isShared)


method: public int getCreatorId()

SearchHelper.javamethod: public SavedSearch createSearchTemplate(Catalog catalog, intcreatorId, String name, boolean isShared)

method: public SavedSearch createSearchTemplate(Hierarchy hierarchy,int creatorId, String name, boolean isShared)

method: public SavedSearchcreateSearchTemplate(OrganizationHierarchy orgHierarchy, intcreatorId, String name, boolean isShared)

method: public SavedSearch createSearchTemplate(CollaborationAreacollaborationArea, CollaborationStep step, int creatorId, Stringname, boolean isShared)

method: public SavedSearch getSavedSearch(String name, intcreatorId)

method: public SavedSearch getAccessibleSearchTemplate(String name)

method: public Collection<SavedSearch>getSearchTemplates(Filterfilter)

method: public SavedSearch getPrivateDefaultSearchTemplate(PIMObjectpimObj)

method: public SavedSearch getPrivateDefaultSearchTemplate(PIMObjectpimObj, int userId)

method: public SavedSearch getSharedDefaultSearchTemplate(PIMObjectpimObj)

UIHelper.javamethod: void openEntriesInCollaborationAreaStep(CollaborationStepcollaborationStep, String additionalPredicates, HttpServletRequestrequest, HttpServletResponse response)

LeftPaneDataObject.javamethod: public int getPrimaryHierarchyId()

Novas Interfaces API JavaEsta seção fornece as novas interfaces que são introduzidas no IBM InfoSphereMDM Server for PIM V9.1.0 e naIBM InfoSphere Master Data ManagementCollaboration Server V11.4.v Filterv PIMObjectv HistoryManagerv CMSContentURNv CMSInstancev CMSManagerv AuthorizationHelperv SavedSearchv SearchHelperv LeftPaneDataObjectv LeftPaneDataObjectFactoryv RichTextEditor


v MessageBundlev PackagingTool

Mudanças nos pontos de extensão do JavaEsta seção descreve as mudanças nos pontos de extensão do Java no IBMInfoSphere Master Data Management Collaboration Server V11.4.

CollaborationItemPreviewFunctionArguments.javanew method: PIMCollection<CollaborationItem>getAllCollaborationItems()

ItemPreviewFunctionArguments.javanew method: PIMCollection<Item> getAllItems()

Ajustando Seu Banco de DadosDeve-se ajustar seu banco de dados aumentando a configuração do tamanho deheap se o servidor de banco de dados que está sendo usado for o IBM DB2.

Antes de Iniciar

Antes de poder ajustar seu banco de dados DB2, você deve efetuar login comoadministrador do DB2.

Procedimento1. Execute os comandos a seguir para aumentar a configuração do tamanho de

heap.db2 update database configuration for database <dbname> using applheapsz 8192db2 update database configuration for database

<dbname> using app_ctl_heap_sz 8192db2 update database configuration for database <dbname> using LOGFILSIZ 4000

Em que dbname é o nome real da instância de banco de dados DB2. É possívellocalizar os valores atuais desses parâmetros com os comandos a seguir:db2 get dbm cfgdb2 get db cfg for <dbname>

2. Execute os comandos a seguir para manter as condições de log.update db config for <dbname> using logprimary 10;update db config for <dbname> using logsecond 20;

Nota: Os números anteriores nos comandos do DB2 são somente indicativos.Deve-se obter os valores de parâmetro corretos para seu ambiente a partir doseu DBA.


Capítulo 5. Resolução de Problemas

É possível usar as soluções recomendadas para resolver problemas comuns demigração.

Resolvendo Problemas de Scripts de MigraçãoÉ necessário compilar os scripts de migração antes de poder visualizá-los noconsole do script do IBM InfoSphere Master Data Management CollaborationServer e executá-los. Você também pode usar recursos do InfoSphere MDMCollaboration Server para resolver problemas de scripts.

Executando scripts de migração compiladosÉ necessário modificar o arquivo common.properties antes de utilizar scriptscompilados.

Para usar scripts compilados, certifique-se de que o arquivo common.properties nodiretório $TOP/etc/default tenha a seguinte configuração:script_execution_mode = compiled_only

É possível desativar a compilação de script para scripts individuais incluindo aseguinte diretiva no início do script:script_execution_mode=not_compiled

Entanto, desativar a compilação de script no nível de script não é ideal porque issoleva a uma degradação significativa no desempenho. Para evitar a degradação nodesempenho ao utilizar scripts não compilados, altere o seu servidor que estádefinido para not_compiled em vez de usar a opção de desativar a compilação nonível de script.

Se a configuração do servidor no arquivo common.properties for definida paranot_compiled, a compilação de script para scripts individuais não poderá ser ativadacom as diretivas de nível de script.

Nota: Usar uma combinação de scripts compilados e não compilados irá degradaro desempenho e isso não é o ideal. No entanto, se você tiver que usar estacombinação, há uma limitação: um script não compilado pode iniciar funções emum script compilado, mas um script compilado não pode iniciar uma função emum script não compilado.

Erros Comuns de Compilação de ScriptAo trabalha com scripts compilados, um script pode ser salvo no console do scriptapenas se for compilado corretamente. Se houver um erro, verifique svc.out nodiretório de logs appsvr para a saída javac completa e a mensagem de erro.

A seguir estão alguns erros comuns de compilação:1. Uma instrução break ou return dentro de um bloco forEach*Element() não é

compilada devido a um erro "código não atingível". Para corrigir este problema:forEachItemSetElement(itemSet, item){

return item;


}

Altere-o para:

forEachItemSetElement(itemSet, item){if (item != null){

return item;}

}

Este código é equivalente, mas satisfaz o compilador.2. Se você retornar um valor de uma função, será necessário retornar um valor em

cada caso. Em outras palavras, esse código não compila:function sample() {var e = null;catchError (e) {// do something...return "a string";} if (e != null) {reportError(...);}}

Como ele não retorna um valor se ocorrer uma exceção no bloco catchError, énecessário alterá-lo.function sample() {var e = null;catchError (e) {// do something...

return "a string";}if (e != null) {reportError(...);}return null;}

3. Para problemas graves de compilação, você pode consultar os arquivos Javagerados. Esses arquivos Java gerados estão em um diretório especificado peloparâmetro tmp_dir em common.properties. A convenção de nomenclatura dearquivo Java foi alterada recentemente para incluir o nome do script e umasequência gerada, por exemplo: MyScript12345.java.

4. Além disso, o caminho completo do script a partir de docstore é colocado comocomentário na parte superior de cada arquivo Java gerado. Se estivermapeando docstore para o sistema de arquivos, você poderá executar umcomando grep recursivo para descobrir qual arquivo Java corresponde a umscript.

Erros e Problemas Comuns de Tempo de ExecuçãoExistem problemas conhecidos que podem ser encontrados ao executar scripts.Esses exemplos ilustram alguns desses problemas conhecidos e fornecem algunsinsights sobre como evitá-los ou resolvê-los.

Tipo de argumento inválido:Um tipo de argumento inválido ocorre quando você está passando o tipoerrado de argumento para uma função (por exemplo, um HashMapquando ele requer uma Sequência). Você também pode receber um tipo deargumento inválido quando o IBM InfoSphere Master Data ManagementCollaboration Server não puder inferir o tipo corretamente. Para resolver


esse problema, pode ser necessário utilizar uma operação de script comocheckString() para tornar o tipo explícito.

Tipos de argumentos incompatíveis em comparações:

Se o mesmo tipo de dados, como ==, >, <, <=, não aparecer em ambos oslados de um operador condicional, a expressão será avaliada como false. Sefalse, não resultará em uma mensagem de erro, mas o códigocorrespondente não será executado.

Por exemplo, o seguinte não funciona.var id = “12345”;var my_id = item.getEntryAttrib(caminho para algum atributo que é uma sequência);if ( id == my_id) {// instruções que precisam ser executadas, mas não serão}

A solução neste caso é usar explicitamente:var id = “12345”;var my_id = checkString(item.getEntryAttrib(//algum atributo que seja uma sequência),””);if ( id == my_id) {// instruções a serem executadas}

Análise de XML:

O código a seguir funciona no modo não compilado e também no modocompilado quando executado a partir do sandbox de script:new XmlDocument(xmlDoc);forEachXmlNode("item") {// do the needful}

Entanto, no modo compilado, se este código for usado em uma função debiblioteca de script iniciada por vários usuários, as instruções dentro dobloco forEachXmlNode não serão executadas. Não há nenhuma mensagemde erro; porém, é possível utilizar o código a seguir como uma soluçãoalternativa.var doc = new new XmlDocument(xmlDoc);var xmlNode; forEachXmlNode(doc, "item", xmlNode) {//do the needful}

Resolva problemas e erros de tempo de execuçãoPara resolver erros de tempo de execução no servidor de aplicativos, consulte oarquivo svc.out no diretório appsvr log. Às vezes, examinar o exception.log e odefault.log pode ser útil.

Com a nova convenção de nomenclatura do arquivo Java gerado, é fácil identificarqual script falhou. A mensagem de erro também identifica o número da linha noarquivo Java gerado. Para resolver o problema, visualize o arquivo Java gerado erole até a linha em que ocorreu o erro de tempo de execução. O código Javagerado agora inclui o código de script real como comentários em todas as linhas.

Por exemplo, considere a seguinte parte de código a partir de um arquivo Javagerado de amostra// function checkIfPartyPartyTypeExist(party, partyType)public static Object ScriptFunction__checkIfPartyPartyTypeExist(HashMap hmContext, Object party, ObjectpartyType) throws Exception{// var bRet = false;Object bRet = (java.lang.Boolean) Boolean.FALSE; //var rootEntry = party.getRootEntryNode();Object rootEntry = GenGetRootEntryNodeOperation.execute(hmContext , (IEntry) party);// var entryNodes = rootEntry.getEntryNodes(getCatalogSpecName() + "/Party Types/Party Type Code");Object entryNodes = GenGetEntryNodesOperation.execute(hmContext , (EntryNode) rootEntry, (String)BinaryOperation.execute(BinaryOperation.PLUS, ScriptFunction__getCatalogSpecName(hmContext), "/PartyTypes/Party Type Code"));// var entryNodesSize = entryNodes.size();Object entryNodesSize = (java.lang.Integer) GenSizeOperation.execute(hmContext , (HashMap) entryNodes);

Capítulo 5. Resolução de Problemas 49

Cada uma das linhas que começa com // nos comentários anteriores são código realdo script correspondente do IBM InfoSphere Master Data ManagementCollaboration Server. Esta indicação torna fácil identificar onde ocorreu a falha noscript.

Resolvendo Problemas de MigraçãoDescreve alguns problemas comuns para resolução que podem surgir durante amigração no IBM InfoSphere Master Data Management Collaboration Server.

Problema: exportando grupos de controle de acesso

Ao migrar para o InfoSphere MDM Collaboration Server, é possível ver o seguinteerro relacionado à exportação de grupos e funções de controle de acesso:

AccessControlGroupsExporting ACG and Roles for company: trigo 7/4/13 6:27 AMSTARTED:Export 7/4/13 6:27AM STARTED:Export of AccessControlGroups 7/4/13 6:27 AMINFO:Skipping export of [Default] 7/4/13 6:27 AMFAILED:Export of AccessControlGroups

Este erro significa que houve uma falha na exportação do grupo de controle deacesso (ACG). Verifique os logs no diretório $TOP/logs/default para descobrir omotivo da falha.

Problema: perguntas de migração de GDS fazem distinção entremaiúsculas e minúsculas

Todas as migrações do grupo de controle de acesso de GDS antes do InfoSphereMDM Collaboration Server versão 9.1.0-FP011 fazem distinção entre maiúsculas eminúsculas e s ou n deve ser digitado em minúscula. Antes das migrações doInfoSphere MDM Collaboration Server versão 9.1.0-FP12, umS ou N em maiúsculadeve ser utilizado para questões de migração de GDS.

Problema: Índices ausentes

Ao migrar para o InfoSphere MDM Collaboration Server, pode haver índicesausentes no relatório do console de migração.

Os seguintes erros relacionados aos índices ausentes podem ocorrer durante amigração:

Índices ausentes na tabela SCAÍndices Ausentes|============================================================|SCA_0_PK SCA_CATEGORY_IDSCA_SELECTION_IDSCA_COMPANY_IDSCA_|CATALOG_IDSCA_CAT_TREE_ID

É possível executar este script PERL para resolver esse problema. Escolhe odiretório db2 ou oracle apropriadamente.perl $PERL5LIB/runSQL.pl --sql_file=$TOP/src/db/schema/dbscripts/<db2 ou oracle>/sca_pk.sql

Índices ausentes na tabela DBVÍndices Ausentes|============================================================|DBV_0_UK DBV_VERSION


É possível executar este script PERL para resolver esse problema. Escolhe odiretório db2 ou oracle apropriadamente.perl $PERL5LIB/runSQL.pl --sql_file=$TOP/src/db/schema/gen/<db2 or oracle>/ddl_ver_synchronize.sql. $TOP/bin/compat.sh$JAVA_RT com.ibm.ccd.synchronize.DBSchemaVersion --autoupd

Índices ausentes nas tabelas DOA e CTG (DB2 somente)Índices Ausentes|==============================================| CTG_1_UK CTG_COMPANY_IDCTG_NAME| DOA_0_UK DOA_DOC_IDDOA_CMP_IDDOA_NAME

É possível executar este script PERL para resolver esse problema:perl $PERL5LIB/runSQL.pl--sql_command="alter table tctg_ctg_catalog drop constraint ctg_1_uk;"perl $PERL5LIB/runSQL.pl--sql_command="drop index ictg_ctg_2;"

perl $PERL5LIB/runSQL.pl--sql_command="alter table tctg_ctg_catalogadd constraint ctg_1_uk unique (ctg_company_id, ctg_name);"

perl $PERL5LIB/runSQL.pl--sql_command="create index ictg_ctg_2 ontctg_ctg_catalog ( ctg_name, ctg_company_id)ALLOW REVERSE SCANS;"

perl $PERL5LIB/runSQL.pl--sql_command="alter table TDOC_DOA_DOC_ATTRIBUTESdrop constraint doa_0_uk;"

perl $PERL5LIB/runSQL.pl--sql_command="drop index idoc_doa_0;"

perl $PERL5LIB/runSQL.pl--sql_command="alter table tdoc_doa_doc_attributesadd constraint doa_0_uk unique (doa_doc_id, doa_cmp_id, doa_name);"

perl $PERL5LIB/runSQL.pl--sql_command="create index idoc_doa_0on tdoc_doa_doc_attributes ( doa_name, doa_doc_id, doa_cmp_id)ALLOW REVERSE SCANS;"

Problema: Tabelas ausentes ITX e CAX

Ao migrar para o InfoSphere MDM Collaboration Server, pode haver esse erro norelatório de verificação do BD:___________________________________________________________|Tabelas Ausentes|===========================================================| TCTG_CAX_CATEGORY_CONTENT| TCTG_ITX_ITEM_CONTENT

|Índices ausentes|| CAX_0_PK CAX_ENTRY_IDCAX_NEXT_VERSION_ID| ITX_0_PK ITX_ENTRY_IDITX_NEXT_VERSION_ID

Esse erro indica um problema com a criação do espaço de tabela, a instalação XDBou os parâmetros db. Verifique o arquivo errfile.log no diretório $TOP/logs paraobter a mensagem exata. Certifique-se de que a configuração do banco de dadosseja concluída corretamente e, em seguida, execute o script de migraçãonovamente.

Capítulo 5. Resolução de Problemas 51

Problema: Erro de privilégios insuficientes

Ao executa um script de migração para migrar para o InfoSphere MDMCollaboration Server, pode haver um erro de privilégios insuficientes no console.Exemplos típicos do erro são:

Banco de dados OracleAo utilizar um banco de dados Oracle, o erro pode ser semelhante aoseguinte:create index icnt_eem_2 on tcnt_eem_entry_entry_map (

*ERROR na linha 1:ORA-01031: privilégios insuficientes

Banco de dados DB2Ao utilizar um banco de dados DB2, o erro pode ser semelhante aoseguinte:SQL0551N "USERNAME" não tem o privilégio para executar a operação"CREATE INDEX" no objeto "USERNAME.TWFL_WFE_WORKFLOW_EVENT".SQLSTATE=42501

O usuário do banco de dados não tem privilégios suficientes para criar um índiceno banco de dados. Deve-se conceder o privilégio "criar índice" ao usuário dobanco de dados e, em seguida, executar o script de migração novamente. Deve-setambém conceder acesso ao usuário para poder criar e modificar tabelas.

Problema: Falha do script de migração

Ao executar um script de migração para migrar para o InfoSphere MDMCollaboration Server, o script pode falhar. Um cenário típico de falha de script é:

Falha no módulo data_maintenance_reports-----------------------------------------------------------Resumo da migração-----------------------------------------------------------A migração dos seguintes módulos falhou:data_maintenance_reports

O arquivo $TOP/logs/errfile.log possui o seguinte conteúdo:net.sf.ehcache.distribution.MulticastKeepaliveHeartbeatReceiver$MulticastReceiverThreadrunSEVERE: Captura de encadeamento do receptor multicast lançável. A causa era nula. Continuando...

Há um problema com os parâmetros de configuração de cache, mas o script demigração foi executado e concluído com êxito. Verifique seus parâmetros deconfiguração de cache. Não há necessidade de executar novamente o script demigração.


Avisos

Estas informações foram desenvolvidas para produtos e serviços oferecidos nosEstados Unidos.

Avisos

Essas informações foram desenvolvidas para produtos e serviços oferecidos nosEUA. Este material pode estar disponível na IBM em outros idiomas. No entanto,pode ser necessário possuir uma cópia do produto ou da versão do produto nesteidioma a fim de acessá-lo.

É possível que a IBM não ofereça os produtos, serviços ou recursos discutidosnesta publicação em outros países. Consulte um representante IBM local para obterinformações sobre produtos e serviços disponíveis atualmente em sua área.Qualquer referência a produtos, programas ou serviços IBM não significa queapenas produtos, programas ou serviços IBM possam ser utilizados. Qualquerproduto, programa ou serviço funcionalmente equivalente, que não infrinjanenhum direito de propriedade intelectual da IBM poderá ser utilizado emsubstituição a este produto, programa ou serviço. Entretanto, a avaliação everificação da operação de qualquer produto, programa ou serviço não IBM são deresponsabilidade do Cliente.

A IBM pode ter patentes ou solicitações de patentes pendentes relativas a assuntostratados nesta publicação. O fornecimento desta publicação não lhe garante direitoalgum sobre tais patentes. Pedidos de licença devem ser enviados, por escrito,para:

Gerência de Relações Comerciais e Industriais da IBM BrasilAv. Pasteur, 138-146BotafogoRio de Janeiro, RJCEP 22290-240

Para consultas sobre licença relacionadas a informações de DBCS (Conjunto deCaracteres de Byte Duplo), entre em contato com o Departamento de PropriedadeIntelectual da IBM em seu país ou envie consultas, por escrito, para:

Intellectual Property LicensingLegal and Intellectual Property LawIBM Japan Ltd.19-21, Nihonbashi-Hakozakicho, Chuo-kuTokyo 103-8510, Japan

O parágrafo a seguir não se aplica ao Reino Unido nem a nenhum país em quetais provisões não estejam de acordo com a lei local: A INTERNATIONALBUSINESS MACHINES CORPORATION FORNECE ESTA PUBLICAÇÃO "NOESTADO EM QUE SE ENCONTRA", SEM GARANTIA DE NENHUM TIPO, SEJAEXPRESSA OU IMPLÍCITA, INCLUINDO, MAS A ELAS NÃO SE LIMITANDO,AS GARANTIAS IMPLÍCITAS DE NÃO INFRAÇÃO, COMERCIALIZAÇÃO OUADEQUAÇÃO A UM DETERMINADO PROPÓSITO. Alguns países não permitema exclusão de garantias expressas ou implícitas em certas transações; portanto, essadisposição pode não se aplicar ao Cliente.


Essas informações podem conter imprecisões técnicas ou erros tipográficos. Sãofeitas alterações periódicas nas informações aqui contidas; tais alterações serãoincorporadas em futuras edições desta publicação. A IBM pode, a qualquermomento, aperfeiçoar e/ou alterar os produtos e/ou programas descritos nestapublicação, sem aviso prévio.

Referências nestas informações a websites não IBM são fornecidas apenas porconveniência e não representam de forma alguma um endosso a esses websites. Osmateriais contidos nesses websites não fazem parte dos materiais desse produtoIBM e a utilização desses websites é de inteira responsabilidade do Cliente.

A IBM pode utilizar ou distribuir as informações fornecidas da forma que julgarapropriada sem incorrer em qualquer obrigação para com o Cliente.

Licenciados deste programa que desejam obter informações sobre este assunto comobjetivo de permitir: (i) a troca de informações entre programas criadosindependentemente e outros programas (incluindo este) e (ii) a utilização mútuadas informações trocadas, devem entrar em contato com:

Gerência de Relações Comerciais e Industriais da IBM BrasilAv. Pasteur 138-146BotafogoRio de Janeiro, RJCEP 22290-240

Tais informações podem estar disponíveis, sujeitas a termos e condiçõesapropriadas, incluindo em alguns casos o pagamento de uma taxa.

O programa licenciado descrito neste documento e todo o material licenciadodisponível são fornecidos pela IBM sob os termos do IBM Customer Agreement,do Contrato de Licença do Programa Internacional da IBM ou de qualquer outrocontrato equivalente.

Todos os dados de desempenho aqui contidos foram determinados em umambiente controlado. Portanto, os resultados obtidos em outros ambientesoperacionais podem variar significativamente. Algumas medidas podem ter sidotomadas em sistemas em nível de desenvolvimento e não há garantia de que estasmedidas serão iguais em sistemas geralmente disponíveis. Além disso, algumasmedidas podem ter sido estimadas por extrapolação. Os resultados reais podemvariar. Os usuários deste documento devem verificar os dados aplicáveis para seuambiente específico.

As informações relativas a produtos não IBM foram obtidas junto aos fornecedoresdos respectivos produtos, de seus anúncios publicados ou de outras fontesdisponíveis publicamente. A IBM não testou estes produtos e não pode confirmar aprecisão de seu desempenho, compatibilidade nem qualquer outra reivindicaçãorelacionada a produtos não IBM. Dúvidas sobre os recursos de produtos não IBMdevem ser encaminhadas diretamente a seus fornecedores.

Todas as declarações relacionadas aos objetivos e intenções futuras da IBM estãosujeitas a mudanças ou retiradas sem aviso prévio e representam apenas metas eobjetivos.

Estas informações contêm exemplos de dados e relatórios utilizados nas operaçõesdiárias de negócios. Para ilustrá-los da forma mais completa possível, os exemplos


incluem nomes de indivíduos, empresas, marcas e produtos. Todos estes nomes sãofictícios e qualquer semelhança com os nomes e endereços utilizados por umaempresa real é mera coincidência.

LICENÇA DE COPYRIGHT:

Estas informações contêm programas de aplicativos de amostra na linguagemfonte, ilustrando as técnicas de programação em diversas plataformas operacionais.O Cliente pode copiar, modificar e distribuir estes programas de amostra sem anecessidade de pagar à IBM, com objetivos de desenvolvimento, utilização,marketing ou distribuição de programas aplicativos em conformidade com ainterface de programação de aplicativo para a plataforma operacional para a qualos programas de amostra são criados. Esses exemplos não foram testadoscompletamente em todas as condições. Portanto, a IBM não pode garantir ouimplicar a confiabilidade, manutenção ou função destes programas. Os programasde amostra são fornecidos "NO ESTADO EM QUE SE ENCONTRAM", semgarantia de nenhum tipo. A IBM não é responsável por nenhum dano decorrentedo uso dos programas de amostra.

Cada cópia ou parte destes programas de amostra ou qualquer trabalho derivadodeve incluir um aviso de copyright com os dizeres:

© (nome da empresa) (ano). Partes deste código são derivadas dos Programas deAmostras da IBM Corp. © Copyright IBM Corp. _digite o ano ou anos_. Todos osDireitos Reservados.

Se estas informações estiverem sendo exibidas em cópia eletrônica, as fotografias eilustrações coloridas podem não aparecer.

Considerações de Política de Privacidade

Os produtos de Software IBM, incluindo soluções de software como serviço,("Ofertas de Software") podem usar cookies ou outras tecnologias para coletarinformações sobre o uso do produto, a fim de ajudar a melhorar a experiência dousuário final, para customizar as interações com o usuário final ou para outrospropósitos. Em muitos casos, nenhuma informação identificável pessoalmente écoletada pelas Ofertas de Software. Algumas de nossas Ofertas de Software podemajudá-lo a coletar informações identificáveis pessoalmente. Se essa Oferta deSoftware usar cookies para coletar informações identificáveis pessoalmente,informações específicas sobre o uso de cookies desta oferta são estabelecidasabaixo.

Dependendo das configurações implementadas, essa Oferta de Software pode usarcookies de sessão e persistentes que coletam o nome de cada usuário, o nome deusuário, a senha, o nome do perfil ou outras informações identificáveispessoalmente para propósitos de gerenciamento de sessões, autenticação,usabilidade de usuário aprimorada, configuração de conexão única ou identificaçãode página da web que o usuário tentou carregar antes de efetuar login. Essescookies podem ser desativados, mas desativá-los provavelmente também eliminaráa funcionalidade que eles ativam.

Se as configurações implementadas nesta Oferta de Software fornecerem a vocêcomo cliente a capacidade de coletar informações identificáveis pessoalmente dosusuários finais por meio de cookies e outras tecnologias, você deverá consultarcom seu próprio conselho jurídico sobre as leis aplicáveis a tal coleta de dados,incluindo os requisitos para aviso e consentimento.

Avisos 55

Para obter mais informações sobre o uso de várias tecnologias, incluindo cookies,para esses propósitos, consulte a Política de Privacidade da IBM emwww.ibm.com/privacy e a Declaração de Privacidade Online da IBM emwww.ibm.com/privacy/details, a seção intitulada "Cookies, Web Beacons andOther Technologies", e a "IBM Software Products and Software-as-a-Service PrivacyStatement" em www.ibm.com/software/info/product-privacy.

Instrução geral sobre a segurança do produto

Os sistemas e produtos da IBM são projetados para serem implementados comoparte de uma abrangente abordagem de segurança, que poderá exigir o uso deoutros sistemas, produtos ou serviços para serem mais eficazes. Uma abordagemde segurança abrangente deve ser revista sempre que sistemas e produtos foremincluídos ao seu ambiente.

Nenhum sistema ou produto de TI pode ser feito totalmente seguro, e nenhumúnico produto ou medida de segurança pode ser completamente eficaz naprevenção de acesso indevido.

A segurança do sistema de TI envolve proteger os sistemas e as informaçõesatravés da prevenção, detecção e resposta ao acesso indevido de dentro e fora desua empresa. Acesso incorreto pode resultar em informações que são alteradas,destruídas ou desviadas, ou pode resultar em mau uso de seus sistemas paraatacar outros.

A IBM não garante que os sistemas e produtos são imunes a condutamal-intencionada ou ilegal de nenhuma parte.

A IBM não acredita que qualquer processo único pode ser completamente eficazem ajudar a identificar e solucionar vulnerabilidades de segurança. A IBM possuiuma abordagem multicamadas:v Uma iniciativa interna em curso promove a adoção consistente de práticas de

segurança em desenvolvimento de produtos e serviços, com o objetivo demelhorar continuamente as características de qualidade e segurança de produtose serviços da IBM. Esta iniciativa é descrita no IBM Redguide Segurança emdesenvolvimento: A IBM Secure Engineering Framework Secure Engineering, quecontém informações públicas sobre práticas de desenvolvimento de software daIBM.

v Testes e varreduras de produtos IBM usam diversas tecnologias da IBM paraidentificar e corrigir proativamente defeitos e vulnerabilidades, incluindovulnerabilidades criticamente altas ou maiores. A correção ocorre dentro dosprazos alvo de resposta definidos pela IBM para análise, avaliação de impacto eentrega de correção.

v A IBM Product Security Incident Response Team (PSIRT) gerencia o recebimento,investigação e coordenação interna de informações de vulnerabilidade desegurança relacionadas às ofertas da IBM. A equipe IBM PSIRT atua como umponto focal que pesquisadores de segurança, grupos do segmento de mercado,organizações do governo, fornecedores e clientes podem entrar em contatoatravés do portal IBM PSIRT para relatar potenciais vulnerabilidades desegurança de produtos IBM. Esta equipe coordena junto com as equipes deprodutos e soluções IBM para investigar e identificar o plano de respostaadequado.


http://www.ibm.com/privacy

http://www.ibm.com/privacy/details

http://www.ibm.com/software/info/product-privacy

v Um programa e estrutura de integridade da cadeia de fornecimento globalfornecem aos compradores de produtos de TI uma escolha de parceiros efornecedores de tecnologia acreditados no Open Group Trusted TechnologyForum (OTTF).

Considerando que a segurança dos sistemas de computador e software decomputador é uma questão muito complexa, a IBM não fornece informações sobreas práticas de desenvolvimento para produtos individuais diferentes dasencontradas na documentação do produto padrão ou conforme publicado nasatividades públicas da IBM.

As informações públicas sobre as práticas de desenvolvimento de softwarerecomendadas pela IBM são documentadas no IBM Secure EngineeringFramework. Estas informações são uma compilação de práticas entre unidades denegócios da IBM e as equipes de desenvolvimento.

Na maioria dos casos, as vulnerabilidades publicadas são documentadas emintervalos de tempo hábil, através do IBM Security Bulletins que inclui apontuação de base do Common Vulnerability Scoring System (CVSS) associado.Em alguns casos, a IBM pode entrar em contato com os clientes direta ediscretamente sobre vulnerabilidades específicas.

Os clientes que desejam validar ainda mais a vulnerabilidade do software IBMalém das avaliações que são realizadas internamente pela IBM, são bem-vindospara realizar a sua própria varredura com relação ao software licenciado. Elespodem usar a ferramenta de sua escolha dentro dos termos de licenciamento desoftware existentes. Por exemplo, a varredura é aceitável, mas em compilaçãoinversa ou engenharia reversa, o software IBM não é autorizado, exceto quandoexpressamente permitido por lei, sem a possibilidade de renúncia contratual.

Marcas Registradas

IBM, o logotipo IBM e ibm.com são marcas comerciais ou marcas registradas daInternational Business Machines Corp., registradas em vários países no mundotodo. Outros nomes de produtos e serviços podem ser marcas comerciais da IBMou de outras empresas. Uma lista atual das marcas comerciais da IBM estádisponível na web em "Copyright and trademark information" emwww.ibm.com/legal/copytrade.shtml.

Os termos a seguir são marcas ou marcas registradas de outras empresas:

O Adobe, o logotipo Adobe, PostScript e o logotipo PostScript são marcasregistradas ou marcas comerciais da Adobe Systems Incorporated nos EstadosUnidos e/ou em outros países.

A IT Infrastructure Library é uma marca registrada da Agência Central deComputação e Telecomunicações que agora faz parte do Departamento deComércio do Governo.

Linear Tape-Open, LTO, o logotipoLTO Logo, Ultrium e o logotipo Ultrium sãomarcas comerciais da HP, IBM Corp. e Quantum nos Estados Unidos e em outrospaíses.

Avisos 57

http://www.ibm.com/security/secure-engineering/bulletins.html

http://www.ibm.com/legal/copytrade.shtml

Intel, o logotipo Intel, Intel Inside, o logotipo Intel Inside, Intel Centrino, o logotipoIntel Centrino, Celeron, Intel Xeon, Intel SpeedStep, Itanium e o Pentium sãomarcas comerciais ou marcas registradas da Intel Corporation ou suas subsidiáriasnos Estados Unidos e em outros países.

Linux é uma marca registrada da Linus Torvalds nos Estados Unidos e/ou emoutros países.

Microsoft, Windows, Windows NT e o logotipo Windows são marcas comerciais daMicrosoft Corporation nos Estados Unidos e/ou em outros países.

Java e todas as marcas comerciais e logotipos baseados em Java são marcascomerciais ou marcas registradas da Oracle e/ou de suas afiliadas.

Cell Broadband Engine é uma marca comercial da Sony Computer Entertainment,Inc. nos Estados Unidos e/ou em outros países e é usada sob licença a partir desteponto.

ITIL é uma marca registrada e uma marca registrada da comunidade doDepartamento de Comércio do Governo e está registrada no Departamento deMarcas e Patentes dos Estados Unidos.

UNIX é uma marca registrada do The Open Group nos Estados Unidos e emoutros países.


Índice Remissivo

Numéricos11.4 426.0 289.1 42, 45

Aajustar 46api java

11.4 456.0 42enums 42interfaces 45métodos 42

avisos legais 53

Bbanco de dados

gds 46

Ccomentários

enviando ix

DDiferenças da API Java 42diferenças de script 27

Eenviando comentários ix

Iinformações de pré-requisito ixinformações relacionadas ix

JJava

11.4 46pontos de extensão 46

Mmarcas registradas

lista de 53migração

problemas 47scripts 47visão geral 1

migrandointrodução 3migrando da v10.0 para a v11.4 13

migrando (continuação)migrando da v10.1.0 para a v11.4 16migrando da v11.0.0 para a v11.4 19migrando da v11.3 para a v11.4 22migrando da v9.1.0 para a v11.4 9migrando de versões anteriores 5resolvendo problemas de scripts de

migração 47scripts 27

Rrecursos

novo na Versão 11.4 ixresolução de problemas

entrando em contato com o Suportede Software IBM xi

problemas de migração 50

Sscript

diferenças 28métodos na V11.4 28

scriptscompilando e depurando 47erros comuns de compilação 47erros comuns de tempo de

execução 48mudanças no comportamento da V6.0

e V11.4 41mudanças no comportamento da

versão V5.3.2 e V11.4 37resolvendo erros de tempo de

execução 49serviços de suporte a software

entrando em contato 61suporte

cliente 61suporte ao cliente

entrando em contato 61

VV11.4 28


Entrando em Contato com a IBM

É possível entrar em contato com a IBM para suporte ao cliente, serviços desuporte a software, informações do produto e informações gerais. Também épossível fornecer feedback para a IBM sobre produtos e documentação.

A tabela a seguir lista recursos para suporte ao cliente, serviços de suporte asoftware, treinamento e informações sobre produtos e soluções.

Tabela 8. Recursos da IBM

Recurso Descrição e Local

Documentação do produto para InfoSphereMDM

É possível procurar e navegar por todos osdocumentos do InfoSphere MDM emhttp://pic.dhe.ibm.com/infocenter/mdm/v11r0/index.jsp.

Documentação do produto para InfoSphereMDM Custom Domain Hub, incluindoInfoSphere MDM Reference DataManagement

É possível procurar e navegar por todos osdocumentos do InfoSphere MDM CustomDomain Hub em http://pic.dhe.ibm.com/infocenter/mih/v11r0/index.jsp.

IBM Support Portal É possível customizar as informações desuporte escolhendo os produtos e tópicosque interessam a você emwww.ibm.com/support/.

Serviços de Software É possível localizar informações sobresoftware, TI e Business Consulting Services,no site de soluções em www.ibm.com/businesssolutions/.

Minha IBM É possível gerenciar links para websites IBMe informações que atendem a suasnecessidades específicas de suporte técnicocriando uma conta no site Minha IBM emwww.ibm.com/account/.

Treinamento e Certificação É possível aprender sobre serviços detreinamento técnico e educação projetadospara indivíduos, empresas e organizaçõespúblicas para adquirirem, manterem ouotimizarem suas qualificações em TI, emwww.ibm.com/software/sw-training/.

Representantes IBM É possível entrar em contato com umrepresentante IBM para aprender sobresoluções em www.ibm.com/connect/ibm/us/en/.

Fornecendo Feedback

A tabela a seguir descreve como fornecer feedback para IBM sobre produtos edocumentação de produto.


http://pic.dhe.ibm.com/infocenter/mdm/v11r0/index.jsp

http://pic.dhe.ibm.com/infocenter/mdm/v11r0/index.jsp

http://pic.dhe.ibm.com/infocenter/mih/v11r0/index.jsp

http://pic.dhe.ibm.com/infocenter/mih/v11r0/index.jsp

https://www.ibm.com/support/

http://www.ibm.com/businesssolutions/

http://www.ibm.com/businesssolutions/

http://www.ibm.com/account/

http://www.ibm.com/software/sw-training/

http://www.ibm.com/connect/ibm/us/en/

http://www.ibm.com/connect/ibm/us/en/

Tabela 9. Fornecendo Feedback para a IBM

Tipo de Feedback Ação

Feedback do produto É possível fornecer feedback geral doproduto por meio da Pesquisa de Opiniãode Consumabilidade emwww.ibm.com/software/ucd/consumability/.

Feedback de documentação Para comentar no centro de informações,clique no link Feedback na parte superiordireita de qualquer tópico no centro deinformações. Também é possível enviarcomentários sobre guias de arquivos PDF,sobre o centro de informações ou qualqueroutra documentação das maneiras a seguir:

v Formulário de comentários do leitoronline: www.ibm.com/software/data/rcf/

v E-mail: [email protected]


http://www.ibm.com/software/ucd/consumability/

http://www.ibm.com/software/ucd/consumability/


��

Impresso no Brasil

SC19-4014-02

Guia de Migração - ibm.com · v Perguntas específicas sobre o produto: Se você recebeu...

Documents

Transcript of Guia de Migração - ibm.com · v Perguntas específicas sobre o produto: Se você recebeu...