InfoSphere MDM Collaboration Server: Guía de migración · En InfoSpher e MDM Enterprise Edition e...

IBM InfoSphere Master Data Management CollaborationServerVersión 11 Release 5

Guía de migración

SC11-8392-03

IBM

NotaAntes de utilizar esta información y el producto al que da soporte, lea la información contenida en el apartado “Avisos” enla página 53.

Nota de edición

Esta edición es aplicable a la versión 11.5 de IBM InfoSphere Master Data Management y a todos los releases ymodificaciones posteriores hasta que se indique lo contrario en nuevas ediciones.

© Copyright IBM Corporation 2000, 2015.

Contenido

Tablas . . . . . . . . . . . . . .. v

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

Prefacio . . . . . . . . . . . . .. ixNovedades en la versión 11.4 . . . . . . .. ixCómo ponerse en contacto con el soporte de softwarede IBM . . . . . . . . . . . . . . .. x

Capítulo 1. Migración . . . . . . . .. 1

Capítulo 2. Cómo empezar . . . . . .. 3

Capítulo 3. Migración de versionesanteriores . . . . . . . . . . . . .. 5Migrar datos maestros desde el formato interno alformato XML . . . . . . . . . . . . .. 7Migración de V9.1 a V11.5 . . . . . . . . .. 9Migración de V10.1 a V11.5 . . . . . . . .. 13Migración de V11.0 a V11.5 . . . . . . . .. 16Migración de V11.3 a V11.5 . . . . . . . .. 19Migración de V11.4 a V11.5 . . . . . . . .. 22

Capítulo 4. Migración de los scripts deInfoSphere MDM Collaboration Server . 27Diferencias de script en las diversas versiones . .. 27

Métodos con firmes diferentes en V6.0 y V11.5 . 28Métodos exclusivos de V9.0 transferidos a V11.5 28Cambios en el comportamiento de lasoperaciones de script entre V5.3.2 y V11.5 . .. 37Cambios en el comportamiento de lasoperaciones de script de V6.0 y V11.5. . . .. 41

Diferencias de API de Java entre varias versiones.. 42Enumeraciones y métodos de API de Java . .. 42Nuevas interfaces de API de Java . . . . .. 45Cambios en puntos de ampliación Java . . .. 46

Ajuste de la base de datos . . . . . . . .. 46

Capítulo 5. Resolución de problemas 47Resolución de problemas de scripts de migración.. 47

Ejecución de scripts de migración compilados .. 47Errores comunes de compilación de scripts . .. 47Errores y problemas comunes en tiempo deejecución . . . . . . . . . . . . .. 48Resolver errores y problemas de tiempo deejecución . . . . . . . . . . . . .. 49

Resolución de problemas de migración . . . .. 50

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

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

Cómo ponerse en contacto con IBM .. 61

© Copyright IBM Corp. 2000, 2015 iii

iv InfoSphere MDM Collaboration Server: Guía de migración

Tablas

1. Posibles razones de los errores y accionesrecomendadas . . . . . . . . . . .. 9

2. Archivos SQL para modificar cuando seutilizan nombres de espacios de tablapersonalizados . . . . . . . . . .. 10





7. Comparación de métodos con firmas diferentesen V6.0 y V11.5 . . . . . . . . . .. 28

8. Recursos de IBM . . . . . . . . . .. 619. Cómo proporcionar comentarios a IBM 62

© Copyright IBM Corp. 2000, 2015 v

vi InfoSphere MDM Collaboration Server: Guía de migración

Figuras

© Copyright IBM Corp. 2000, 2015 vii

viii InfoSphere MDM Collaboration Server: Guía de migración

Prefacio

Esta información le ayudará a migrar desde IBM® InfoSphere Master DataManagement Server for Product Information Management Versión 9.1.0 y IBMInfoSphere Master Data Management Collaboration Server Versiones 10.0, 10.1, 11.0y 11.3 a IBM InfoSphere Master Data Management Collaboration Server Versión11.4 a través de una serie de subpasos y migraciones.

Sobre esta publicación

La información siguiente describe instrucciones paso a paso, métodosrecomendados, ajustes del rendimiento y cuestiones habituales de la resolución deproblemas.

A quién va dirigida esta publicación

Esta guía de migración está destinada a instaladores, administradores de sistemasy personal de IBM Professional Services para desplegar correctamente el productoen el entorno.

Requisitos previos e información relacionada

Para poder utilizar esta guía de migración, debe estar familiarizado con lainformación siguiente:v InfoSphere MDM Collaboration Server Knowledge Centerv La documentación del servidor de aplicacionesv La documentación del software de la base de datos

Cómo enviar los comentarios

Los comentarios son una ayuda importante para proporcionar información precisay de alta calidad. Si tiene comentarios sobre esta publicación o cualquier otradocumentación de InfoSphere MDM Collaboration Server, utilice la forma siguientepara enviarnos los comentarios:

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

Novedades en la versión 11.4Existen características y funciones nuevas en IBM InfoSphere Master DataManagement Collaboration Server Versión 11.4.

En InfoSphere MDM Enterprise Edition e InfoSphere MDM Collaborative Editionse incluye InfoSphere MDM Collaboration Server.

InfoSphere MDM Collaboration Server permite a las empresas crear un repositorioúnico y actualizado de información sobre productos que se puede utilizar en todala organización para las iniciativas empresariales estratégicas.

Entre los cambios clave del producto se incluyen:

© Copyright IBM Corp. 2000, 2015 ix


Soporte de migración para usuarios de InfoSphere MDM Collaboration ServerLos temas siguientes describen las nuevas rutas para migrar desdeversiones anteriores de InfoSphere MDM Collaboration Server a la versión11.4:v Migrar desde V9.1 a V11.4v Migrar desde V10.1 a V11.4v Migrar desde V11.0 a V11.4v Migrar desde V11.3 a V11.4

Soporte de migración para Advanced Catalog Management (ACM)Advanced Catalog Management (ACM) versión 11.0 FP5 aporta variascaracterísticas nuevas. Para poder utilizar estas características nuevas, debeactualizar el modelo de datos. Para obtener más información, consulteMigrar gestión de catálogos avanzada.

Banking Solution SampleBanking Solution Sample es un modelo de datos de muestra que estáimplementado en el MDM colaborativo para la gestión de datos deproductos bancarios. Para obtener más información, consulte BankingSolution Sample.

Banking Solution ToolkitBanking Solution Toolkit se utiliza para publicar metadatos de solución(por ejemplo, Spec) y datos de producto (por ejemplo, Category y Product)desde el MDM colaborativo y el MDM físico. Para obtener másinformación, consulte MDM físico de IBM InfoSphere.

Mejoras en la API de JavaMejoras en las API de Java de InfoSphere MDM Collaboration Server parael soporte xml de spec unificado. Para obtener más información, consulteDocumentación de IBM Javadoc y Esquema de objeto.

Actualización de pila y aplicaciónInfoSphere MDM Collaboration Server soporta las siguientesactualizaciones de pila nuevas:v Upgrade Rational Architect Developer a 9.1v Upgrade WebSphere Portal Server a 8.5

Actualizaciones de la documentaciónLos artículos siguientes son nuevos o son actualizaciones de ladocumentación:v Temas nuevos y contenido actualizado en la sección IBM WebSphere

Commerce.v Temas nuevos y contenido actualizado en la sección Resolución de

problemas y soporte.v Temas nuevos y contenido actualizado en la sección Asegurar un buen

rendimiento.

Cómo ponerse en contacto con el soporte de software de IBMEl soporte de software de IBM ofrece asistencia para los defectos del producto,responde las preguntas frecuentes (FAQ) y realiza operaciones deredescubrimiento.

x InfoSphere MDM Collaboration Server: Guía de migración

Antes de empezar

Después de intentar encontrar una respuesta o una solución para su caso a travésde otras opciones de autoayuda, como por ejemplo las notas técnicas, puedeponerse en contacto con el soporte de IBM. Antes de ponerse en contacto con elsoporte de software de IBM, su empresa debe disponer de un contrato demantenimiento con IBM activo, y debe contar con la autorización necesaria paraenviar problemas a IBM. Para obtener más información sobre los tipos de soportedisponibles, consulte el tema Support portfolio de la publicación Software SupportHandbook.

Cuando se ponga en contacto con el soporte de software de IBM es importantecomprender qué soporte está disponible a través de IBM:v Preguntas específicas sobre el producto: si ha recibido formación sobre el

producto, puede enviar preguntas o inquietudes específicas.v Soporte para defectos: el análisis y el trabajo necesario que se precisa para

solucionar un defecto del producto o proporcionar un método alternativo.v Operaciones de script: si tiene preguntas respecto a una operación de script o

para informar de un posible defecto con una operación de script, debesimplificar su pregunta o problema a aproximadamente 5 líneas de código omenos.– IBM no proporciona soporte para la depuración o el análisis de scripts

personalizados.v Solicitudes de mejora: solicitudes de nuevas funciones agregadas al producto.

Solicitudes que no se encuentran en el ámbito del soporte de software de IBM yprecisan que se ponga en contacto con su representante de servicios profesionales ode ventas:v Trabajo diverso: trabajo o asistencia que precisa una gran implicación de IBM

durante la instalación o el proceso de implementación que abarca instalacionescomplejas o instalación en diversas plataformas.

v Soporte para clientes sin formación: solicitudes de ayuda detallada IBM pero nose dispone de la formación sobre productos de IBM necesaria. La formación deIBM ofrece formación al cliente si se necesita la formación del personal. Consulteel sitio web de IBM para obtener información específica acerca de los cursosdisponibles.

v Creación de scripts o scripts personalizados: no se ofrece soporte para scriptsque haya escrito o que necesiten depuración. Todos los scripts personalizadosescritos por los servicios profesionales pasan a ser de su propiedad y los debemantener usted, el cliente, después de que se haya completado el trabajo delservicio. El soporte técnico no está disponible para escribir o depurar scriptspersonalizados.

v Recuperación de datos: se recomienda encarecidamente realizar una copia deseguridad de los datos de forma rutinaria.

v Asistencia para el ajuste o el rendimiento, o bien recomendaciones que precisande los datos del cliente.

Procedimiento1. Busque si ya existe una nota técnica respecto a su problema. Para obtener

información adicional sobre la visualización de las notas técnicas.2. Compruebe si un compañero o un equipo de soporte interno puede

proporcionar asistencia.

Prefacio xi

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

3. Defina el problema, reúna información básica y determine la gravedad delproblema. Para recibir ayuda, consulte “Before contacting IBM SoftwareSupport” en el manual Software Support Handbook.

Información básica necesaria

v Toda la información y los valores de configuración.v El comportamiento esperado en comparación con el comportamiento

actual.v Todos los cambios o modificaciones que ha implementado

recientemente.v Determine si se puede recrear el problema.v Defina los pasos que conducen a los problemas que está

experimentando.4. Reúna la información de diagnóstico:v También puede usar la función básica de recopilación de datos de IBM

Support Assistant para recopilar los archivos de configuración y el archivo deanotaciones crítico, consulte www.ibm.com/software/support/isa/ paraobtener información adicional.

v Cree una herramienta de recopilador propia de IBM Support Assistant Litemediante el entorno de trabajo.a. Descargue el complemento del producto en el entorno de trabajo de IBM

Support Assistant.b. Pulse la opción para recopilar y enviar datos . Aparecen tres opciones en

la parte izquierda.c. Seleccione la opción para utilizar IBM Support Assistant Lite.d. Cree el recopilador generado; para ello, asigne valores a las opciones de

recopilador:– Seleccione un recopilador (si el complemento del producto instalado

no se muestra, no dispone de un documento de recopilaciónobligatoria (Must Gather) y no podrá crear un recopilador de IBMSupport Assistant Lite).

– Especifique el directorio de destino.– Especifique el nombre de archivo.– Pulse el botón para exportar.

e. Transfiera el recopilador de IBM Support Assistant Lite exportado a unsistema remoto mediante ftp o cualquier otro protocolo de transferenciade archivos disponible.

f. Descomprima el recopilador de IBM Support Assistant Lite exportado enla ubicación de destino.

g. Configure JAVA_HOME o asegúrese de que Java™ se encuentra en lasentencia de la variable PATH.

h. Ejecute el mandato runISALite.bat en Windows o el script runISALite.shen UNIX y LINUX desde el directorio tools de IBM Support AssistantLite en el sistema remoto.

i. Dé las respuestas adecuadas a las solicitudes de recopilación queaparezcan.

j. Revise los archivos recopilados o envíelos al soporte de IBM.5. Envíe la información sobre su problema al soporte de software de IBM a través

de una de estas opciones:v En línea: (recomendado)

xii InfoSphere MDM Collaboration Server: Guía de migración

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

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

a. Pulse Open service request en la sección Choose your task de la barrade navegación de la izquierda del sitio de soporte de IBM InfoSphereMaster Data Management Collaboration Server.

b. Pulse ESR / SR y siga las instrucciones proporcionadas en el sitio web deESR.Siga estas directrices y consejos para usar ESR y enviar los PMR:– Adjunte los documentos directamente al PMR para que estén

disponibles para IBM Support Services.– ESR gestiona una lista de todos los PMR que ha visto, de modo que

dispone de acceso inmediato a ellos para comprobar su estado.– Use ESR para configurar las notificaciones automáticas de PMR.– Envíe actualizaciones para PMR que pueda abrir a IBM Support

Services directamente desde ESR.– Al enviar un PMR debe indicar un nivel de gravedad con el fin de que

nos ayude a establecer las prioridades de nuestros recursos respecto aotros PMR que abra:

Gravedad 1Impacto comercial crítico: indica que no puede usar elprograma que provoque un impacto negativo en lasoperaciones. Esta condición precisa una solución inmediata.

Nota: Impacto comercial crítico significa que el sistema deproducción está inactivo y en orden para que el soporte desoftware de IBM trabaje fuera del horario comercial, debeasegurarse de que tiene un contacto disponible 24x7 porteléfono para facilitar las consultas por parte del ingeniero quelleve a cabo la investigación, ejecutar pruebas en su instanciade producción, etc.

Gravedad 2Impacto comercial significativo: indica que el programa esutilizable pero que está muy limitado.

Gravedad 3Impacto comercial moderado: indica que el programa esutilizable con menos funciones significativas (no críticas paralas operaciones) que no están disponibles.

Gravedad 4Impacto comercial mínimo: indica que el problema causa pocoimpacto en las operaciones o que se ha implementado unasolución alternativa razonable al problema.

– Para abrir una solicitud de mejora (una solicitud para nuevasfunciones generales del producto y que no esté relacionada con unapersonalización específica):- Abra un PMR con gravedad 2, 3 o 4, (según el posible beneficio

comercial de la solicitud) y la solicitud se envía a IBM ProductManagement para su revisión. Recibirá un número de solicitud demejora para rastrear el fin que sustituye al número PMR.Normalmente, se necesita su aprobación para cerrar el PMR.

v Por teléfono: para obtener información acerca del número de teléfono al quedebe llamar en su país, diríjase a la página de contactos de la publicaciónSoftware Support Handbook.

Prefacio xiii

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

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

Qué hacer a continuación

Si el problema que indica es un defecto de software, o bien documentaciónimprecisa o incompleta, el soporte de software de IBM crea un Informe de análisisde programa autorizado (APAR). El APAR describe el problema detalladamente.Siempre que sea posible, el soporte de software de IBM ofrece un métodoalternativo que puede implementar hasta que el APAR se resuelve y se distribuyeun arreglo. IBM publica diariamente los APAR resueltos en el sitio web de soportede IBM, para que otros usuarios que tengan el mismo problema puedanbeneficiarse de la misma resolución.

xiv InfoSphere MDM Collaboration Server: Guía de migración

Capítulo 1. Migración

Si utiliza una versión anterior de IBM InfoSphere Master Data ManagementCollaboration Server, puede realizar la migración de la versión de que disponga ala versión más actual.

Esta información sobre la instalación se encuentra también disponible enInfoSphere MDM Collaboration Server Migration Guide, la cual puede encontrarseen formato libro en un archivo PDF. Pulse con el botón derecho del ratón en elenlace y seleccione Guardar destino como para descargar el archivo PDF en elsistema.

© Copyright IBM Corp. 2000, 2015 1

2 InfoSphere MDM Collaboration Server: Guía de migración

Capítulo 2. Cómo empezar

Debe modificar el esquema de base de datos de la instalación actual utilizandoscripts de migración para migrar desde versiones anteriores a IBM InfoSphereMaster Data Management Collaboration Server Versión 11.5.

Debe disponer de los permisos correspondientes para crear y modificar tablas ycrear índices en la base de datos. También debe tener los permisos apropiados paracrear y suprimir archivos en los subdirectorios del directorio $TOP.

La migración implica los pasos básicos siguientes:v Verifique que haya disponible suficiente espacio de tabla de base de datos.v Detenga la instancia que está utilizando el esquema de base de datos.v Realice una copia de seguridad del esquema de base de datos existente.v Instale InfoSphere MDM Collaboration Server V11.5 y especifique el mismo

esquema de base de datos que estaba utilizando la instancia anterior.v Ejecute el script de migración apropiado para modificar el esquema de base de

datos y ponerlo al nivel de InfoSphere MDM Collaboration Server V11.5.


Capítulo 3. Migración de versiones anteriores

Puede migrar a IBM InfoSphere Master Data Management Collaboration ServerVersión 11.5 desde versiones anteriores determinadas.

Son posibles las rutas de migración siguientes para la Versión 11.5:v Migración de V9.0 Fix Pack 8 a V11.5v Migración de V9.1, Fixpack 2 o posterior a V11.5v Migración de V10.0, Fixpack 1 o posterior a V11.5v Migración de V10.1, GA y todos los niveles de fixpack a V11.5v Migración de V11.0, GA y todos los niveles de fixpack a V11.5v Migración de V11.3, GA a V11.5v Migración de V11.4, GA y todos los niveles de fixpack a V11.5

Si desea migrar a un release posterior, no a un fixpack del mismo release, debeutilizar un nuevo directorio de instalación para evitar discrepancias de versión delarchivo JAR.

Una práctica recomendable es suprimir los datos antiguos de InfoSphere MDMCollaboration Server antes de la migración para evitar agotar el espacio de registro.Debe tener un directorio $TOP/logs antes de ejecutar un script de migración.

Si realiza una migración de una versión de fixpack anterior, asegúrese de que noutiliza ninguna API suprimida en los scripts de Excel. Las API siguientes no estándisponibles en el último archivo JAR de POI:v public String getExcelCellEncoding();

v public void setEncoding(String encoding);

v public String getExcelCellEncoding(Object cellObj) throwsAustinException;

Nota:

1. InfoSphere MDM Collaboration Server Excel Parser recibe soporte a través delarchivo .jar de terceros denominado poi-3.7-20101029.jar. Esta bibliotecasoporta el formato Microsoft Excel 2007, que permite más de 255 columnas porhoja de datos. Debe ejecutar el script de informe de resultados de búsquedadetallada. Cuando ejecute este script, utilice la opción de Script de informe deresultados de búsqueda detallada predeterminado (Excel 2007 – formato xlsx)para exportar artículos con más de 255 atributos.

2. Puede exportar resultados de búsqueda detallada a archivos en el formato deExcel 2003 utilizando la opción Script de informe de resultados de búsquedadetallada predeterminado. Sin embargo, con este formato, el informe fallará silos artículos tienen más de 255 atributos.

3. Este JAR no es compatible con .xlsx de Excel 2010.

Importante: Antes de ejecutar los scripts de migración, debe asegurarse de queestá utilizando la versión de base de datos correcta. Consulte los requisitos delsistema para conocer detalles: http://www-01.ibm.com/support/docview.wss?uid=swg27035486. Debe asegurarse también de que el usuario de basede datos de InfoSphere MDM Collaboration Server tenga los privilegios adecuados,


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


tal como se menciona en la guía de instalación. Consulte al equipo de DBA loscambios en los privilegios de usuario de base de datos debidos a políticas deseguridad.

Debe utilizar la versión de base de datos de Oracle o DB2 como se menciona en losrequisitos de sistema. Consulte los requisitos del sistema para conocer detalles:http://www-01.ibm.com/support/docview.wss?uid=swg27035486. Puede consultarla documentación de DB2 u Oracle para actualizar la base de datos DB2 y Oracle ala versión soportada.

Los pasos para migrar el MDM colaborativo con espacios de tablapersonalizados se utilizan en DB2 y Oracle

Si está utilizando nombres de espacios de tabla personalizados en lugar de losnombres predeterminados USERS o INDX, debe modificar manualmente losnombres de espacios de tabla en los archivos SQL siguientes antes de iniciar lamigración a InfoSphere MDM Collaboration Server.

Debe verificar que tiene al menos un 30% de espacio libre en la base de datosantes de iniciar la migración.

Los registros de auditoría no se migran a V11.5. Debido al nuevo formato de lasdescripciones del registro de auditoría que se han incorporado en V9.1.0, lasdescripciones del registro de auditoría existentes en los releases anteriores a V9.1.0no son visibles en V11.5. Por ello se suprimen de la base de datos durante lamigración. Los antiguos registros de auditoría pueden verse utilizando el release apartir del cual va a realizar la migración.

Para garantizar que la migración se lleva a cabo correctamente, deben realizarse deforma manual los pasos siguientes:1. Migre manualmente los archivos de propiedades siguientes. Dado que los

archivos de propiedades forman parte de los sistemas de archivos locales, elmétodo de migración no ofrece soporte a la exportación de archivos depropiedades. Modificar cada propiedad personalizada de los releases anterioresal archivo correspondiente de la nueva versión. No sobrescriba los archivos depropiedades de una versión anterior para una versión nueva, pues se hanañadido nuevos parámetros en V11.5. Consulte la documentación de InfoSphereMDM Collaboration Server para obtener detalles sobre cada archivo depropiedades.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 el contenido del directorio $TOP/public_html/suppliers/<código cmp>/ctg_files en la instancia nueva de cada empresa. Dado queestos archivos forman parte del sistema de archivos local, el método demigración no soporta la exportación del directorio ctg_files.

3. Añada manualmente los archivos JAR de usuario que se necesiten a la nuevainstancia. Estos archivos forma parte del sistema de archivos local, por lo que elmétodo de migración no es compatible con la exportación de archivos JAR deusuario. Para obtener más información sobre la adición de archivos JAR aldespliegue, consulte Despliegue de un archivo .jar personalizado de usuario.

4. Rehaga manualmente estos cambios que había realizado en el Script de informede resultados de búsqueda detallada predeterminado para personalizarlo. La



migración a InfoSphere MDM Collaboration Server V11.5 sobrescribe el scriptexistente en el directorio de almacén de documentos de InfoSphere MDMCollaboration Server /scripts/report. Este script se utiliza para exportarresultados de búsqueda de objetos de InfoSphere MDM Collaboration Server auna hoja Excel. Para obtener más información sobre este script, consulte el temaExportación de los resultados de la búsqueda a Excel.

5. Asegúrese de que no se ha establecido ninguna opción de compilacióndetallada para la compilación de scripts. Verifique que en el archivocommon.properties no se utiliza verbose como valor del parámetroscript_compiler_options. Para obtener más información sobre este parámetro,consulte Parámetros script_compiler_options.

6. Ejecute el script setup.sh para comprobar si la versión de PERL instalada en elsistema es compatible con la versión de InfoSphere MDM Collaboration Serverque tiene instalada. Este script se halla en el directorio $TOP. Si la versión actualde PERL no es compatible, debe instalar una versión nueva.

7. Si instala la versión nueva de InfoSphere MDM Collaboration Server en undirectorio nuevo, debe actualizar el valor de las variables TOP y PERL5LIB en elarchivo .bash_profile. Debe establecer la variable PERL5LIB en el directorio$TOP/bin/perllib.

Migrar datos maestros desde el formato interno al formato XMLDebe convertir los datos maestros a XML al migrar desde IBM InfoSphere MasterData Management Server for Product Information Management Versiones 6.0.0 o9.0.0 a IBM InfoSphere Master Data Management Collaboration Server Versión 11.5.

Antes de empezar1. Cree espacios de tabla XML y agrupaciones de almacenamiento intermedio tal

y como se describe en la guía de instalación.2. Compruebe que el usuario de la base de datos de la aplicación InfoSphere

MDM Collaboration Server tiene los privilegios de base de datos apropiadosque se mencionan en la guía de instalación.

3. Detenga la aplicación InfoSphere MDM Collaboration Server en el servidorlocal.

4. Ejecute el script delete_old_versions.sh para suprimir todas las versionesanteriores. Utilice el código de la empresa y la fecha actual para los valores delos parámetros code y end_date.

5. Opcional - Mejorar la memoria disponible en el proceso Java: la ejecución delscript de conversión de datos es un proceso intensivo de memoria. Serecomienda proporcionar 2 GB de memoria para el proceso de Javaactualizando el parámetro custom_java_options en el archivo$TOP/bin/conf/env_settings.ini. Ejecute configureEnv.sh después demodificar el parámetro custom_java_options para garantizar que los nuevosvalores de memoria actualizados entran en vigor.custom_java_options=-Xmx2048m -Xms256m

Acerca de esta tarea

El script de migración de datos necesita dos veces el número de conexiones de BDque el número de hebras de ejecución. Por ejemplo, si utiliza 10 hebras en laopción de indicador de mandatos, necesitará 20 conexiones de BD. Debe configurarel número de conexiones de BD utilizados los dos parámetros de configuración:v db_maxConnection

Capítulo 3. Migración de versiones anteriores 7

v db_maxConnection_default

Ambos parámetros se encuentran en el archivo common.properties. Si los valoresde estos parámetros son ya iguales o mayores que las conexiones de base de datosnecesarias, no es necesario cambiar estos valores. Si los valores de estos parámetrosson menores que las conexiones de base de datos necesarias, debe aumentar losvalores para mejorar la velocidad.

Si tiene más de 100.000 entradas de datos maestros en los catálogos, aumente elnúmero de hebras. Por ejemplo, puede utilizar 50 o 100 hebras para completar lamigración de datos más rápidamente. El número más alto de hebras que puedeutilizar depende de las variables siguientes en InfoSphere MDM CollaborationServer. Puede evaluar el número óptimo de hebras ejecutando el script demigración en un entorno de prueba.v Número de núcleos de procesador disponiblesv Número de especificaciones definidasv Memoria disponible

Todas las especificaciones que están definidas en el entorno de InfoSphere MDMCollaboration Server se recuperan y utilizan en el proceso de conversión de datos.Si tiene más de 100 especificaciones, actualice los parámetros de puesta enmemoria caché de especificaciones con los valores apropiados para evitar consultasfrecuentes de la base de datos y mejorar el rendimiento global de los scripts.

Procedimiento1. Obtenga el recuento de especificaciones en InfoSphere MDM Collaboration

Server ejecutando el mandatos siguiente.$PERL5LIB/runSQL.pl --sql_command="select count(*) from spc;"

2. Actualice estos parámetros con los valores recuperados de la consulta en elpaso 1. Estos parámetros se encuentran disponibles en el archivomdm-cache-config.properties en el directorio $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: La ejecución del script configureEnv.sh después de actualizar el archivomdm-cache-config.properties sobrescribe los parámetros con los valorespredeterminados.

3. Ejecute el script shell de migración de datos, migrateDataToXml.sh. Este archivose encuentra en el directorio $TOP/bin/migration.migrateDataToXml.sh --company=<company name> --threads=<number of threads>

Donde

--company Especifica el código de la empresa que se utiliza para registrarse enInfoSphere MDM Collaboration Server.

--threadsEspecifica el número de hebras. Utilice el número mayor de hebraspara mejorar la velocidad, pero asegúrese de que existen conexiones deBD suficientes. El número predeterminado es 1. Se recomiendan almenos 10 hebras.


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

Qué hacer a continuación

Se puede verificar que el script ha funcionado como se esperaba observando loserrores que aparecen en la consola y que se han registrado en el archivodefault.log en el directorio $TOP/logs/default. Al final de la ejecución apareceuna lista de las entradas que no se han migrado.

El script de migración de datos actualiza la base de datos en lotes. Si hay algúnerror, el lote entero se retrotrae. De ahí que el número de entradas que no hanmigrado sea mayor que los fallos reales. Actualice el parámetroindex_regeneration_batch_size a 1 en el archivo common.properties y ejecute denuevo el script de migración de datos para reducir el número de entradas respectoal número real de fallos. Se proporciona una tabla con posibles razones de loserrores y las acciones que se recomiendan tomar:

Tabla 1. Posibles razones de los errores y acciones recomendadas

Razones de los erroresdurante la migración dedatos Acción recomendada

La migración de datosmuestra el error siguiente:

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

Compruebe que está utilizando el parche del nivel correctosegún la base de datos. En caso de que sea necesario,actualice la base de datos y ejecute luego de nuevo el scriptde migración de datos.

La migración de datosmuestra el error siguiente:

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

Uno de los valores de atributo en la entrada contiene elcarácter &" o algún valor no incorrecto. Actualice la entradapara eliminar el valor no válido de la interfaz de edición deelementos InfoSphere MDM Collaboration Server e intentede nuevo realizar la migración de datos.

Migración de V9.1 a V11.5Para migrar a IBM InfoSphere Master Data Management Collaboration ServerVersión 11.5 desde IBM InfoSphere Master Data Management Server for ProductInformation Management Versión 9.1.0, debe ejecutar el script de migraciónapropiado.

Antes de empezar

Antes de poder migrar desde InfoSphere MDM Server for PIM V9.1.0 a InfoSphereMDM Collaboration Server V11.5, debe asegurarse de que está utilizandoespecíficamente el Fixpack 2 o fixpacks posteriores para V9.1.0. Si está utilizandoV9.1.0 con cualquier otro nivel de fixpack, debe migrar a V9.1.0 Fixpack 2 ofixpacks posteriores. Siga las instrucciones de las notas de release apropiadas.


También debe asegurarse de que todos los espacios de tabla relacionados con XMLse crean como se describe en la guía de instalación. Asegúrese de que el usuario debase de datos de InfoSphere MDM Collaboration Server tiene los privilegiosapropiados para utilizar los nuevos espacios de tabla.

Puede configurar la ubicación del archivo de registro de errores modificando lavariable _ERROR_LOGS en el script de migración migrateFrom910.sh. De formapredeterminada, el valor de esta variable es $TOP/logs/errfile.log.

Si utiliza nombres de espacios de tabla personalizados en lugar de los nombrespredeterminados USERS o INDX, debe modificar manualmente los nombres deespacios de tabla en los archivos create_pimdb.sh y create_pimdb_for_zLinux.shde la carpeta $TOP/bin/db_creation. Además, debe modificar manualmente losnombres de espacios de tabla en los archivos SQL siguientes. Esta modificación sedebe producir antes de iniciar la migración a InfoSphere MDM CollaborationServer V11.5.

Tabla 2. Archivos SQL para modificar cuando se utilizan nombres de espacios de tablapersonalizados

Archivos SQL para modificar cuando DB2es la base de datos de fondo

Archivos SQL para modificar cuandoOracle es la base de datos de fondo

Sustituya los nombres de espacios de tablaUSERS, INDX y BLOB_TBL_DATA pornombres de espacios de tabla personalizadosapropiados en los archivos SQL siguientesdel directorio $TOP/src/db/schema/dbscripts/db2:

modifySstShared.sqladdCehEntryId.sqladdCehEntryId.sql

Sustituya los nombres de espacios de tablaUSERS, INDX y BLOB_TBL_DATA pornombres de espacios de tabla personalizadosapropiados en los archivos SQL siguientesdel directorio $TOP/src/db/schema/dbscripts/oracle:

add_sca_index.sqladd_sit_index1.sql


Los pasos siguientes son la única manera de migrar desde InfoSphere MDM Serverfor PIM V9.1.0 a InfoSphere MDM Collaboration Server V11.5 y no existe ningúnotro medio. No puede utilizar la herramienta de exportación e importación deentorno.

Procedimiento1. Realice una copia de seguridad del esquema de base de datos existente.2. Instale InfoSphere MDM Collaboration Server V11.5 en un directorio diferente.3. Configure la base de datos.

a. Para las bases de datos DB2, cree agrupaciones de almacenamientointermedio y espacios de tabla nuevos como se menciona en Configuraciónde la base de datos DB2 en la guía de instalación.

Nota: El tamaño del espacio de tabla XML_DATA debe ser igual que elespacio que ocupa el espacio de tabla TCTG_ITD_ITEM_DETAIL. Puedeconocer el tamaño aproximado de la tabla utilizando la consulta siguiente:select (fpages * 16) / 1024 megabytes from syscat.tableswhere tabschema = current schemaand tabname like ’TCTG_ITD_ITEM_DETAIL’;


b. Para bases de datos Oracle, cree nuevos espacios de tabla y luego instale elcomponente de BD de XML de Oracle como se menciona en Configuraciónde la base de datos Oracle en la guía de instalación.

4. Apunte la instancia de InfoSphere MDM Collaboration Server V11.5 al esquemade base de datos de V9.1.0, Fixpack 2 o posterior. Para que la instancia apuntea la base de datos, añada los parámetros de base de datos en el archivoenv_settings.ini. Para obtener más información, consulte Configuración de losparámetros comunes de base de datos.

5. Ejecute el script de migración migrateFrom910FP.sh. Este script se encuentra enel directorio $TOP/bin/migration. Consulte la sección Resultados para ver elresumen de la migración. Si la migración no ha sido satisfactoria, puede volvera ejecutar el script de migración.

6. Migre los datos tal como se indica en Migrar datos maestros desde el formatointerno al formato XML.

7. Ejecute el script test_db.sh para verificar el esquema de base de datos, laconectividad entre InfoSphere MDM Collaboration Server y las bases de datos,y para comprobar las conexiones de cliente nativo y JDBC. Para obtener másinformación, consulte Script test_db.sh.

8. Inicie la instancia de InfoSphere MDM Collaboration Server V11.5.

Resultados

Todos los mensajes, tales como el estado de componentes de migraciónindividuales y el resumen de migración global, se visualizan en la consola.

Después de ejecutar el script de migración, se visualizan mensajes en la consolaque indican si la migración ha sido satisfactoria o ha fallado.

Este mensaje se visualiza si la migración se efectúa correctamente:-----------------------------------------------------------Resumen de la migración-----------------------------------------------------------Migración a IBM InfoSphere Master Data ManagementCollaboration Server Versión 11.5.0 se ha completado.Compruebe si hay errores en los mensajes.

Generando informe de verificación de base de datos...

___________________________________________________________

Tablas modificadas

===========================================================No hay tablas modificadas___________________________________________________________

___________________________________________________________

Tablas que faltan

===========================================================No faltan tablas___________________________________________________________

___________________________________________________________

Índices modificados


===========================================================No hay índices modificados___________________________________________________________

___________________________________________________________

Índices que faltan

===========================================================No faltan índices___________________________________________________________

ARCHIVO DE REGISTRO: $TOP/logs/default/default.log

Este mensaje se visualiza si la migración no se efectúa correctamente:!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!La migración ha fallado : xxxx

!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!Consulte el archivo de para obtener más detalles : /home/pimuser/mdmcs11/logs/errfile.log

Este mensaje se visualiza si falla la migración de módulos específicos:-----------------------------------------------------------Resumen de la migración-----------------------------------------------------------La migración de los módulos siguientes no se ha realizado correctamente:<nombres de módulo>

Aparece este mensaje si hay alguna discrepancia en las tablas o índices de la basede datos.Generando informe de verificación de base de datos...

___________________________________________________________

Tablas modificadas

===========================================================<nombres de tablas>___________________________________________________________

___________________________________________________________

Tablas que faltan


___________________________________________________________


===========================================================<nombres de los índices>___________________________________________________________

___________________________________________________________

Índices que faltan

===========================================================<nombres de los índices>


___________________________________________________________


Revise el archivo errfile.log para obtener más mensajes. Para los errores de SQL,busque el mensaje de error detallado del código de error de SQL, corrija el error yvuelva a ejecutar el script de migración. Consulte las acciones recomendadas o loserrores de migración en Resolución de problemas de migración. Póngase encontacto con el IBM Software Support si persiste el problema tras rectificar loserrores.

Migración de V10.1 a V11.5Para migrar a IBM InfoSphere Master Data Management Collaboration ServerVersión 11.5 desde IBM InfoSphere Master Data Management Collaboration ServerVersión 10.1.0, debe ejecutar el script de migración apropiado.

Antes de empezar






addCaeStepEntryDate.sqladdCehEntryId.sqladdObhCompanyId.sqladdSstShared.sql


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


Puede migrar a InfoSphere MDM Collaboration Server Versión 11.5 desdeInfoSphere MDM Collaboration Server Versión 10.1.0 GA o cualquier fixpack (1, 6,7, 8, 9, 10, 11 o 12).

Los pasos siguientes son la única forma de migrar desde InfoSphere MDMCollaboration Server V10.1.0 a V11.5 y no existe ningún otro medio. No puedeutilizar la herramienta de exportación e importación de entorno.


Puede configurar la ubicación del archivo de registro de errores modificando lavariable _ERROR_LOGS en el script de migración migrateFrom1010.sh. De formapredeterminada, el valor de esta variable es $TOP/logs/errfile.log.

Procedimiento1. Realice una copia de seguridad del esquema de base de datos existente.2. Instale InfoSphere MDM Collaboration Server V11.5 en un directorio diferente.3. Apunte la instancia de InfoSphere MDM Collaboration Server V11.5 al esquema

de base de datos V10.1.0. Para que la instancia apunte a la base de datos, añadalos parámetros de base de datos en el archivo env_settings.ini. Para obtenermás información, consulte Configuración de los parámetros comunes de basede datos.

4. Ejecute el script de migración migrateFrom1010FP.sh. Este script se encuentraen el directorio $TOP/bin/migration. Consulte la sección Resultados para ver elresumen de la migración. Si la migración no ha sido satisfactoria, puede volvera ejecutar el script de migración.



Resultados





___________________________________________________________

Tablas modificadas


___________________________________________________________

Tablas que faltan

===========================================================No faltan tablas___________________________________________________________

___________________________________________________________




___________________________________________________________

Índices que faltan







___________________________________________________________

Tablas modificadas


___________________________________________________________

Tablas que faltan


___________________________________________________________



___________________________________________________________

Índices que faltan





Migración de V11.0 a V11.5Para migrar a IBM InfoSphere Master Data Management Collaboration ServerVersión 11.5 desde IBM InfoSphere Master Data Management Collaboration ServerVersión 11.0.0, debe ejecutar el script de migración apropiado.

Antes de empezar






addCaeStepEntryDate.sqladdCehEntryId.sqladdObhCompanyId.sqladdSstShared.sql


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


Puede migrar a InfoSphere MDM Collaboration Server Versión 11.5 desdeInfoSphere MDM Collaboration Server Versión 11.0.0 GA, y cualquier fixpack (1 al5).


Los pasos siguientes son la única forma de migrar desde InfoSphere MDMCollaboration Server V11.0.0 a V11.5 y no existe ningún otro medio. No puedeutilizar la herramienta de exportación e importación de entorno.

Puede definir la ubicación del archivo de registro de errores modificando lavariable _ERROR_LOGS en el script de migración migrateFrom1100.sh. De formapredeterminada, el valor de esta variable es $TOP/logs/errfile.log.

Procedimiento1. Detenga la instancia de InfoSphere MDM Collaboration Server V11.0.0 que se

está ejecutando.2. Realice una copia de seguridad del esquema de base de datos existente.3. Instale InfoSphere MDM Collaboration Server V11.5 en un directorio diferente.4. Apunte la instancia de InfoSphere MDM Collaboration Server V11.5 al esquema

de base de datos V11.0.0. Para que la instancia apunte a la base de datos, añadalos parámetros de base de datos en el archivo env_settings.ini. Para obtenermás información, consulte Configuración de los parámetros comunes de basede datos.

5. Ejecute el script de migración de migrateFrom1100FP.sh. Este script seencuentra en el directorio $TOP/bin/migration. Consulte la sección Resultadospara ver el resumen de la migración. Si la migración no ha sido satisfactoria,puede volver a ejecutar el script de migración.



Resultados





___________________________________________________________

Tablas modificadas


___________________________________________________________


Tablas que faltan

===========================================================No faltan tablas___________________________________________________________

___________________________________________________________



___________________________________________________________

Índices que faltan







___________________________________________________________

Tablas modificadas


___________________________________________________________

Tablas que faltan


___________________________________________________________




___________________________________________________________

Índices que faltan




Migración de V11.3 a V11.5Para migrar a IBM InfoSphere Master Data Management Collaboration ServerVersión 11.5 desde IBM InfoSphere Master Data Management Collaboration ServerVersión 11.3, debe ejecutar el script de migración apropiado.

Antes de empezar






addCehEntryId.sql




Puede migrar a InfoSphere MDM Collaboration Server Versión 11.5 desdeInfoSphere MDM Collaboration Server Versión 11.3 GA.


Los pasos siguientes son la única forma de migrar desde InfoSphere MDMCollaboration Server V11.3 a V11.5 y no existe ningún otro medio. No puedeutilizar la herramienta de exportación e importación de entorno.


Procedimiento1. Detenga la instancia de InfoSphere MDM Collaboration Server V11.3 que se


de base de datos V11.3. Para que la instancia apunte a la base de datos, añadalos parámetros de base de datos en el archivo env_settings.ini. Para obtenermás información, consulte Configuración de los parámetros comunes de basede datos.

5. Ejecute el script de migración de migrateFrom1130FP.sh. Este script seencuentra en el directorio $TOP/bin/migration. Consulte la sección Resultadospara ver el resumen de la migración. Si la migración no ha sido satisfactoria,puede volver a ejecutar el script de migración.



Resultados





___________________________________________________________

Tablas modificadas


___________________________________________________________


Tablas que faltan

===========================================================No faltan tablas___________________________________________________________

___________________________________________________________



___________________________________________________________

Índices que faltan







___________________________________________________________

Tablas modificadas


___________________________________________________________

Tablas que faltan


___________________________________________________________




___________________________________________________________

Índices que faltan




Migración de V11.4 a V11.5Para migrar a IBM InfoSphere Master Data Management Collaboration ServerVersión 11.5 desde IBM InfoSphere Master Data Management Collaboration ServerVersión 11.4, debe ejecutar el script de migración apropiado.

Antes de empezar






addCehEntryId.sql




Puede migrar a InfoSphere MDM Collaboration Server Versión 11.5 desdeInfoSphere MDM Collaboration Server Versión 11.4 GA.


Los pasos siguientes son la única forma de migrar desde InfoSphere MDMCollaboration Server V11.4 a V11.5 y no existe ningún otro medio. No puedeutilizar la herramienta de exportación e importación de entorno.


Procedimiento1. Detenga la instancia de InfoSphere MDM Collaboration Server V11.4 que se


de base de datos V11.5. Para que la instancia apunte a la base de datos, añadalos parámetros de base de datos en el archivo env_settings.ini. Para obtenermás información, consulte Configuración de los parámetros comunes de basede datos.

5. Ejecute el script de migración migrateFrom1140FP.sh. Este script se encuentraen el directorio $TOP/bin/migration. Consulte la sección Resultados para ver elresumen de la migración. Si la migración no ha sido satisfactoria, puede volvera ejecutar el script de migración.



Resultados





___________________________________________________________

Tablas modificadas


___________________________________________________________


Tablas que faltan

===========================================================No faltan tablas___________________________________________________________

___________________________________________________________



___________________________________________________________

Índices que faltan







___________________________________________________________

Tablas modificadas


___________________________________________________________

Tablas que faltan


___________________________________________________________




___________________________________________________________

Índices que faltan





Capítulo 4. Migración de los scripts de InfoSphere MDMCollaboration Server

Puede utilizar scripts para realizar varias funciones en IBM InfoSphere Master DataManagement Collaboration Server. Los scripts proporcionan un alto nivel deflexibilidad sin comprometer la eficacia de la operación o la simplicidad dedesarrollo.

Diferencias de script en las diversas versionesLa versión base que se utiliza para IBM InfoSphere Master Data ManagementCollaboration Server Versión 11.5 es WebSphere Product Center Versión 5.0.1; porlo tanto, existen diferencias funcionales y de comportamiento entre V5.2.1 y V11.5.

Los atributos del tipo de datos Flag devuelven valores diferentes en V11.5. EnV5.2.1, el tipo de datos Flag devolvía una serie TRUE/FALSE. En V11.5, el tipo dedatos Flag devuelve un equivalente de un valor booleano Java, que puede tener losvalores true/false/null. Por lo tanto, cuando compare un atributo flag, lacomparación debe ser como se indica a continuación:if (flagValue==null)

Si la salida muestra un valor Flag, por ejemplo, out.write(flagValue);, los valoresresultantes pueden ser null, false o true.

Debido a que el código se compila en Java cuando utiliza compiled_only_mode, seemite una excepción si los scripts de IBM InfoSphere Master Data ManagementCollaboration Server contienen palabras clave de Java como variables. Además, losscripts no se compilan si contienen variables que ya están en uso en InfoSphereMDM Collaboration Server en el código generado. Por ejemplo, logger y hmContext.

Existe otra diferencia esencial en los métodos que devuelven un ItemSet o unCategorySet: En V5.2.1, si el método no recuperaba ningún resultado, devolvía null.En V5.3.2, y por lo tanto en V11.5, estos métodos devuelven un conjunto vacíov Los métodos que devuelven un ItemSet son los siguientes:

– 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 Estos son los métodos que devuelven un 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 con firmes diferentes en V6.0 y V11.5La tabla siguiente compara las operaciones de script añadidas a la Biblioteca descripts de IBM InfoSphere Master Data Management Collaboration Server V11.5:

Métodos con firmas diferentes en IBM InfoSphere MDM Server para PIM V6.0 yInfoSphere MDM Collaboration Server V11.5.

Tabla 7. Comparación de métodos con firmas diferentes en V6.0 y V11.5

Operaciones de V6.0 Operaciones de V11.5

String exportEnv(EnvObjectListenvObjList, String sDocFilePath)

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

Métodos exclusivos de V9.0 transferidos a V11.5Los métodos siguientes sólo están disponibles en IBM InfoSphere Master DataManagement Collaboration Server V9.0 y se han transferido a V11.5.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. Migración de los scripts de 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: devuelve la propiedad trigo_web_url definida en elarchivo common.properties, que contiene el URL totalmente calificado, incluidoel número de puerto, del sitio web donde los usuarios apuntan a losnavegadores para acceder a esta instancia de InfoSphere MDM CollaborationServer.

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 operación de script quedó en desuso en WebSphere Product CenterVersión 5.2.1

– Esta operación de script se sustituye porentry::getEntryRelationshipAttrib(string attribpath) en InfoSphereMDM Collaboration 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()

Cambios en el comportamiento de las operaciones de scriptentre V5.3.2 y V11.5

La lista siguiente indica los cambios de comportamiento de las operaciones descript que existen en las bibliotecas de scripts de WebSphere Product Center V5.3.2y IBM InfoSphere Master Data Management Collaboration Server V11.5.

setContainerProperties()Comportamiento en V5.3.2.v Las propiedades que se especifican en la correlación hash de

PROPERTIES se han establecido para el contenedor en cuestión.

Comportamiento en V11.5.v Las propiedades que se especifican en la correlación hash de

PROPERTIES se han establecido para el contenedor en cuestión. La clavede correlación hash "SCRIPT_NAME" ha quedado en desuso y en sulugar debe utilizarse "POST_SCRIPT_NAME".


getCategoryAttrib()Comportamiento en V5.3.2.v Devuelve el valor del atributo sAttribPath (nombre_especificación/

nombre_atributo) de esta categoría.

Comportamiento en V11.5.v Devuelve el valor del atributo sAttribPath (nombre_especificación/

nombre_atributo) de esta categoría, sólo cuando el atributo se incluye enla colección de vistas o atributos; de lo contrario, devuelve un valornulo.

getEntryAttrib()Comportamiento en V5.3.2.v Devuelve el valor del atributo de sAttribPath (nombre_especificación/

nombre_atributo) de esta entrada.


nombre_atributo) de esta entrada, sólo cuando el atributo se incluye enla colección de vistas o atributos; de lo contrario, devuelve un valornulo.

getCtgItemAttrib()Comportamiento en V5.3.2.v Devuelve el valor del atributo de sAttribPath (nombre_especificación/

nombre_atributo) de este artículo.


nombre_atributo) de este artículo, sólo cuando el atributo se incluye enla colección de vistas o atributos; de lo contrario, devuelve un valornulo.

removeNode()Comportamiento en V5.3.2.v Devuelve un valor booleano.

Comportamiento en V11.5.v Devuelve un valor nulo.

setTypeToExport()Comportamiento en V5.3.2.v Establece el tipo de objeto que se va a exportar.

Comportamiento en V11.5.v Establece el tipo de objeto que se va a exportar.

COLLABORATION_AREA_CONTENT e INHERITANCE_RULES seeliminan de la lista de los valores aceptables para sObjectType.

addObjectByNameToExport()Comportamiento en V5.3.2.v COLLABORATION_AREA_CONTENT es un valor aceptable para

sObjectType.

Comportamiento en V11.5.v COLLABORATION_AREA_CONTENT se elimina de la lista de los

valores aceptables para sObjectType.


addAllObjectsToExport()Comportamiento en V5.3.2.v COLLABORATION_AREA_CONTENT es un valor aceptable para

sObjectType.


valores aceptables para sObjectType.

disableContainerProcessingOptions(String[] options)Comportamiento en V5.3.2.v Inhabilita las opciones de proceso especificadas.

Comportamiento en V11.5.v Inhabilita las opciones de proceso especificadas. Más valores posibles

para el parámetro options: ENTRY_BUILD_SCRIPT yUNIQUE_VALIDATION.

setEntryNodeValue()Comportamiento en V5.3.2.1. Crea un nodo si no está presente.2. Devuelve el valor, que se ha establecido.

Comportamiento en V11.5.1. Produce un error si el nodo ya no está presente; debe crear un nodo

nuevo utilizando entry.setEntryAttrib().2. Devuelve 1/0/-1 basándose en la acción realizada (correcto, no se ha

modificado nada, error).

getEntryNode()Comportamiento en V5.3.2.1. Cada vez que se crea un nuevo artículo o categoría, está presente una

aparición del nodo MultiAttibute de forma predeterminada.itemNode.getEntryNode("/SpecForMigTest/Multi#0/Sub-Multi#0")

Devuelve el nodo.2. Si no se encuentra la vía de acceso especificada, V5.3.2 la crea y

devuelve el nodo. Devuelve nulo si la vía de acceso no es válida.

Comportamiento en V11.5.1. V11.5 produce un error si la vía de acceso no está ya presente.2. V11.5 no crea un nodo.

setEntryNode()Comportamiento en V5.3.2.1. V5.3.2 crea y devuelve el nodo; de lo contrario, devuelve nulo si la vía

de acceso no es válida

Comportamiento en V11.5.1. V11.5 produce un error si la vía de acceso no está ya presente.

getEntryNodeChildren()Comportamiento en V5.3.2.1. V5.3.2 devuelve los hijos reales del nodo de agrupación.

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

Salida:SpecForMigTest/Multi/Sub-Multi


Comportamiento en V11.5.1. V11.5 devuelve las apariciones de varios hijos y no de los hijos reales,

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

Salida: /SpecForMigTest/Multi#0 /SpecForMigTest/Multi#1

getEntryNodes()Comportamiento en V5.3.2.1. En V5.3.2, los hijos también se devuelven pues las vías de acceso de los

hijos contienen la vía de acceso que está especificada en la operación descript.itemNode = item.getRootEntryNode(); nodes =itemNode.getEntryNodes("/SpecForMigTest/Multi"); out.writeln(nodes);

Comportamiento en V11.5.1. V11.5 no devuelve hijos.

getEntryNodeParent()Comportamiento en V5.3.2.1. V5.3.2 devuelve los padres reales.

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());

Salida:Node:: SpecForMigTest/Multi/Sub-Multi Node Parents:: SpecForMigTest/Multi

Comportamiento en V11.5.1. V11.5 devuelve el nodo de grupo en vez del padre 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());

Salida:Node:: SpecForMigTest/Multi/Sub-Multi Node Parents::SpecForMigTest/Multi/Sub-Multi

getFlatEntryNodes()Comportamiento en V5.3.2.1. Este método devuelve una matriz de EntryNodes sin formato de esta

entrada.

Comportamiento en V11.5.Este método ha generado excepciones en versiones anteriores y lasexcepciones se producían debido a que getFlatEntryNodes devolvíagetEntryNodeValue en entryNode. La excepción es porque ahora con elformato serializado tiene un nuevo entrynode devuelto porgetFlatEntryNodes, llamado nodo directory. Para atributos únicos quetienen múltiples apariciones, se devuelve un entrynode adicional y sunode::type es STRING o el tipo de atributo que sea. El script intentaobtener el valor y notificarlo. Por lo tanto, se proporciona un arreglo en laVersión 5.3.2, donde después de que getFlatEntryNodes devuelve losnodos, un nuevo método getEntryNodeType() comprueba el tipo. Si el tiporesulta ser V, únicamente se procesa el nodo de entrada. El prototipo delmétodo es el siguiente:


<prototipo><![CDATA[String EntryNode::getEntryNodeType()]]>

</prototipo><descripción>

<![CDATA[return "V" = valor, "G" = agrupación o nivel superior deldirectorio de especificaciones,"M" = Múltiples directorios (contiene varias apariciones de valores oagrupaciones))]]></descripción>

Lo siguiente es un ejemplo de implementación.

ctg1 = getCtgByName( "<nombre de catálogo>" );itm1 = ctg1.getCtgItemByPrimaryKey( "<clave primaria de artículo>" );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)Comportamiento en V5.3.2.v COLLABORATION_AREA_CONTENT es un valor aceptable para

sObjectType


valores aceptables para sObjectType

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

Comportamiento en V5.3.2.v COLLABORATION_AREA_CONTENT es un valor aceptable para

sObjectType



addAllObjectsToExport ([String sObjectType, [String sActionMode]])Comportamiento en V5.3.2.v COLLABORATION_AREA_CONTENT es un valor aceptable para

sObjectType



Cambios en el comportamiento de las operaciones de scriptde V6.0 y V11.5

La lista siguiente indica los cambios de comportamiento de las operaciones descript existentes en las bibliotecas de scripts de IBM InfoSphere Master DataManagement Collaboration Server V6.0 y V11.5.


exportEnv ()Comportamiento en V6.0.v Exporta los objetos de InfoSphere MDM Collaboration Server que están

especificados en envObjList en la vía de acceso de almacén dedocumentos especificado. La variable sDocFilePath contiene la vía deacceso del archivo comprimido que se exporta al almacén dedocumentos. Este método devuelve las anotaciones como una serie.

Comportamiento en V11.5.v Exporta los objetos de InfoSphere MDM Collaboration Server que están

especificados en envObjList en la vía de acceso de almacén dedocumentos especificado. La variable sDocFilePath contiene la vía deacceso del archivo comprimido que se exporta al almacén dedocumentos. Si sDocFilePath se proporciona como file:/// seguido de lavía de acceso en el sistema de archivos, el archivo comprimido seexporta directamente al sistema de archivos y no al almacén dedocumentos. El parámetro opcional sMapFilePath es la vía de acceso delarchivo de correlación de nombres en el sistema de archivos, queproporciona el archivo a las correlaciones de nombre de archivo para losobjetos que se están exportando. Este método devuelve las anotacionescomo una serie.

Diferencias de API de Java entre varias versionesLa versión base que se utiliza para la API de Java en IBM InfoSphere Master DataManagement Collaboration Server Versión 11.5 es WebSphere Product CenterVersión 5.3.2.

Enumeraciones y métodos de API de JavaEsta sección indica los nuevos métodos y enumeraciones que se han añadido a lasinterfaces existentes en IBM InfoSphere MDM Server for PIM V6.0.0, Fixpack 5,V9.1.0 y IBM InfoSphere Master Data Management Collaboration Server V11.5.

AttributeDefinition.java Enumeración: AttributeDefinition.Type: RICH_TEXT yEXTERNAL_CONTENT_REFERENCE añadidas

Método: public int getId()

AttributeDefinitionProperty.javaEnumeración: AttributeDefinitionProperty.Name: GROUP y LOCALE_NODEen desuso

Enumeración: AttributeDefinitionProperty.Name: RICH_TEXT añadida

AttributeInstance.javaMétodo: public void setValueUsingJSON(Object value)

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

Item.javaMétodo: public OrderedJSONObject toJSON(booleanincludeAttributeType)

Método: public void addStatusAndAvailability(OrderedJSONObjectitemJSONObj)


Catalog.javaMétodo: public PIMCollection<Item> getItems(int[] itemIds)

Método: public PIMCollection<Item> getItems(Object[] itemIds)

Método: public void setIgnoreCache(boolean ignoreCache)

Método: public boolean getIgnoreCache()

Método: public boolean isCached()

Método: public void setCached(boolean setCached)

Método: public OrderedJSONObject toJSON()

CatalogManager.javaMétodo: public Catalog getCatalog(String catalogName, booleanreturnItem)

Método: public Catalog getCatalog(int catalogId)

Método: public Catalog getCatalog(int catalogId, boolean returnItem)

CategoryCollaborationArea.javaMétodo: public CollaborationCategory createCollaborationCategory()

CollaborationCategory.javaEnumeración: CollaborationCategory.SaveResult

Método: public SaveResult getSaveResult()

Método: public Collection<SecondarySpec> getItemSecondarySpecs()

Método: public OrderedJSONObject toJSON(booleanincludeAttributeType)

Método: public void addStatusAndAvailability(OrderedJSONObject

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

Método: public void addSecondarySpec(SecondarySpec spec)

Método: public void removeItemSecondarySpec(SecondarySpec spec)

CollaborationItem.javaMétodo: public OrderedJSONObject toJSON(booleanincludeAttributeType)

Método: public void addStatusAndAvailability(OrderedJSONObjectcollaborationItemJSONObj)

CollaborationStep.javaMétodo: public CollaborationObject getCollaborationObject(int id)

enum ValidationError.TypeSe han añadido estos métodos: TOTAL_DIGITS, MIN_EXCLUSIVE,MIN_INCLUSIVE, MAX_EXCLUSIVE, MAX_INCLUSIVE

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

Método: public String setSavepoint()

Método: void rollbackToSavepoint(String name)


Método: public SearchHelper getSearchHelper()

Método: public HistoryManager getHistoryManager()

Método: public MessageBundle getMessageBundle()

Método: public MessageBundle getMessageBundle(Locale locale)

Método: void disableAllAccessChecking()

Método: void enableAllAccessChecking()

Category.javaEnumeración: Category.SaveResult

Método: public Collection<String[]> getFullDisplayPaths()

Método: public Collection<Integer> getSecondarySpecIdsForChildren()

Método: public OrderedJSONObject toJSON(booleanincludeAttributeType)

Método: public void addStatusAndAvailability(OrderedJSONObjectcategoryJSONObj)

Método: public View getDefaultView()

Hierarchy.javaMétodo: public Category createCategory()

Método: public PIMCollection<Category> getCategories(int[]categoryIds)

Método: public PIMCollection<Category> getCategories(Object[]categoryIds)

Método: public OrderedJSONObject toJSON()

HierarchyManager.javaMétodo: public Hierarchy getHierarchy(int hierarchyId)

OrganizationManager.javaMétodo: public OrganizationHierarchy getOrganizationHierarchy(intid)

SearchQuery.javaEnumeración: SearchQuery.ColumnType: LOGENTRY añadida; enumeración:SearchQuery.SearchQueryOp

SearchResultSet.javaMétodo: public UserDefinedLogEntry getUserDefinedLogEntry(intcolumnIndex) throws PIMSearchException

SelectionManager.javaMétodo: public Selection getSelection(int selectionId)

Spec.javaMétodo: public AttributeDefinition getAttributeDefinition(intattributeDefinitionId)

SpecManager.javaMétodo: public Spec getSpec(int specId)

EnvironmentExporter.javaMétodo: public String export(ExportList exportList, StringdocumentPath, String mappingPath)


Método: public String export(ExportList exportList, StringdocumentPath, boolean checkForRequisites)

checkForRequisites, String mappingPath)Método: public String exportAll(String documentPath, StringmappingPath)

SavedSearch.javaMétodo: public boolean isShared()

Método: public void setShared(boolean isShared)

Método: public int getCreatorId()

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

Método: public SavedSearch createSearchTemplate(Hierarchy hierarchy,int creatorId, String name, boolean isShared)

Método: public SavedSearchcreateSearchTemplate(OrganizationHierarchy orgHierarchy, intcreatorId, String name, boolean isShared)

Método: public SavedSearch createSearchTemplate(CollaborationAreacollaborationArea, CollaborationStep step, int creatorId, Stringname, boolean isShared)

Método: public SavedSearch getSavedSearch(String name, intcreatorId)

Método: public SavedSearch getAccessibleSearchTemplate(String name)

Método: public Collection<SavedSearch>getSearchTemplates(Filterfilter)

Método: public SavedSearch getPrivateDefaultSearchTemplate(PIMObjectpimObj)

Método: public SavedSearch getPrivateDefaultSearchTemplate(PIMObjectpimObj, int userId)

Método: public SavedSearch getSharedDefaultSearchTemplate(PIMObjectpimObj)

UIHelper.javaMétodo: void openEntriesInCollaborationAreaStep(CollaborationStepcollaborationStep, String additionalPredicates, HttpServletRequestrequest, HttpServletResponse response)

LeftPaneDataObject.javaMétodo: public int getPrimaryHierarchyId()

Nuevas interfaces de API de JavaEsta sección indica las nuevas interfaces que se han añadido a IBM InfoSphereMDM Server for PIM V9.1.0 y IBM InfoSphere Master Data ManagementCollaboration Server V11.5.v Filterv PIMObjectv HistoryManagerv CMSContentURN


v CMSInstancev CMSManagerv AuthorizationHelperv SavedSearchv SearchHelperv LeftPaneDataObjectv LeftPaneDataObjectFactoryv RichTextEditorv MessageBundlev PackagingTool

Cambios en puntos de ampliación JavaEsta sección describe los cambios realizados en los puntos de ampliación Java enIBM InfoSphere Master Data Management Collaboration Server V11.5.

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

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

Ajuste de la base de datosDebe ajustar la base de datos aumentando el valor de tamaño de almacenamientodinámico si el servidor de bases de datos que se utiliza es IBM DB2.

Antes de empezar

Para ajustar la base de datos DB2, debe iniciar la sesión como administrador deDB2.

Procedimiento1. Ejecute los mandatos siguientes para aumentar el valor del tamaño de

almacenamiento dinámico.db2 update database configuration for database <nombre_bd> using applheapsz 8192db2 update database configuration for database <nombre_bd> using app_ctl_heap_sz 8192db2 update database configuration for database <nombre_bd> using LOGFILSIZ 4000

Donde nombre_bd es el nombre real de la instancia de base de datos DB2. Puedeencontrar los valores actuales de estos parámetros con los mandatos siguientes:db2 get dbm cfgdb2 get db cfg for <nombre_bd>

2. Ejecute los mandatos siguientes para mantener las condiciones de registro.update db config for <nombre_bd> using logprimary 10;update db config for <nombre_bd> using logsecond 20;

Nota: Los números anteriores en los mandatos DB2 son sólo indicativos. Debesolicitar al administrador de base de datos los valores de parámetro correctospara el entorno.


Capítulo 5. Resolución de problemas

Pueden utilizarse las soluciones recomendadas para resolver los problemascomunes de migración.

Resolución de problemas de scripts de migraciónPara poder visualizar los scripts de migración en la consola de scripts de IBMInfoSphere Master Data Management Collaboration Server, es necesariocompilarlos y ejecutarlos. También puede utilizar los recursos de InfoSphere MDMCollaboration Server para resolver los problemas de los scripts.

Ejecución de scripts de migración compiladosEs necesario modificar el archivo common.properties antes de utilizar scriptscompilados.

Para utilizar scripts compilados, asegúrese de que el archivo common.properties enel directorio $TOP/etc/default tiene el valor siguiente:script_execution_mode = compiled_only

Puede inhabilitar la compilación de scripts para determinados scripts incluyendo ladirectiva siguiente al principio del script:script_execution_mode=not_compiled

Sin embargo, la inhabilitación de la compilación de scripts a nivel de script no esideal porque produce una disminución significativa del rendimiento. Para evitar ladisminución del rendimiento al utilizar scripts no compilados, cambie el servidorque se ha establecido en not_compiled en lugar de utilizar la opción de inhabilitar lacompilación a nivel de script.

Si el valor de servidor en el archivo common.properties se establece ennot_compiled, la compilación de script para determinados scripts no puedehabilitarse con las directivas de nivel de script.

Nota: La utilización de una combinación de scripts compilados y no compiladosdegrada el rendimiento y no es lo mejor. Sin embargo, si debe utilizar estacombinación, existe una limitación: un script no compilado puede iniciar funcionesen un script compilado, pero un script compilado no puede iniciar una función enun script no compilado.

Errores comunes de compilación de scriptsCuando se trabaja con scripts compilados, se puede guardar un script en la consolade scripts sólo si se compila correctamente. Si hay un error, compruebe svc.out enel directorio de registros appsvr la salida javac completa y el mensaje de error.

A continuación se presentan algunos errores comunes de compilación:1. Una sentencia break o return dentro de un bloque forEach*Element() no se

compila debido a un error de "código inaccesible". Para arreglar este problema:forEachItemSetElement(itemSet, item){

return item;


}

Cámbielo por:

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

return item;}

}

Este código es equivalente, pero satisface al compilador.2. Si devuelve un valor de una función, debe devolver un valor en cada caso. En

otras palabras, este código no se compila:function sample() {var e = null;catchError (e) {// efectuar una acción...return "a string";} if (e != null) {reportError(...);}}

Puesto que no devuelve un valor, si se produce una excepción en el bloquecatchError, es necesario cambiarlo.function sample() {var e = null;catchError (e) {// efectuar una acción...

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

3. En caso de problemas importantes de compilación, puede buscar en losarchivos Java generados. Estos archivos Java generados están en un directorioque especificado por el parámetro dir_tmp en common.properties. El conveniode denominación de archivo Java se ha modificado recientemente para incluirel nombre de script y una secuencia generada, por ejemplo:MyScript12345.java.

4. Asimismo, la vía de acceso completa del script del almacén de documentos secoloca como comentario en la parte superior de cada archivo Java. Si estácorrelacionando el almacén de documentos con el sistema de archivos, puedeejecutar un mandato grep de forma recursiva para averiguar qué archivo Javacoincide con un script.

Errores y problemas comunes en tiempo de ejecuciónExisten algunos problemas conocidos que pueden surgir cuando se ejecuta scripts.Estos ejemplos ilustran algunos de estos problemas conocidos y proporcionaninformación sobre cómo evitarlos o resolverlos.

Tipo de argumento no válido:Se produce un tipo de argumento no válido cuando se pasa un tipo deargumento incorrecto a una función (por ejemplo, una correlación hashcuando se necesita una serie). También puede recibir un tipo de argumentono válido cuando IBM InfoSphere Master Data Management Collaboration


Server no puede inferir el tipo correctamente. Para solucionar esteproblema, es posible que necesite utilizar una operación de script comocheckString() para hacer que el tipo sea explícito.

Tipos de argumentos no coincidentes en comparaciones:

Si no aparece el mismo tipo de datos, por ejemplo ==, >, <, <=, en amboslados de un operador condicional, la expresión se evalúa como falsa. Si esfalsa, no produce un mensaje de error, pero no se ejecuta el códigocorrespondiente.

Por ejemplo, lo siguiente no funciona.var id = “12345” ;var my_id = item.getEntryAttrib(vía de acceso a algún atributo que es una secuencia) ;if ( id == my_id) {// sentencias que deben ejecutarse pero que no se ejecutarán

}

La solución en este caso consiste en utilizar explícitamente:var id = “12345” ;var my_id = checkString(item.getEntryAttrib(//algún atributo que es una secuencia),””) ;if ( id == my_id) {// sentencias que deben ejecutarse

}

Análisis XML:

El código siguiente funciona en modalidad no compilada e incluso enmodalidad compilada cuando se ejecuta desde el sandbox de script:new XmlDocument(xmlDoc) ;forEachXmlNode("item") {// efectuar lo que sea necesario}

Sin embargo, en modalidad compilada, si se utiliza este código en unafunción de biblioteca de scripts iniciada por varios usuarios, las sentenciasdel bloque forEachXmlNode no se ejecutan. Aunque no hay ningún mensajede error, puede utilizar el código siguiente como método alternativo.var doc = new new XmlDocument(xmlDoc) ;var xmlNode ; forEachXmlNode(doc, "item", xmlNode) {// efectuar lo que sea necesario}

Resolver errores y problemas de tiempo de ejecuciónPara resolver errores de tiempo de ejecución en el servidor de aplicaciones,consulte el archivo svc.out en el directorio appsvr log. A veces, puede ser útilexaminar exception.log y default.log.

Con el nuevo convenio de denominación de archivos Java generado, es fácilidentificar qué script ha fallado. El mensaje de error también identifica el númerode línea en el archivo Java generado. Para resolver el problema, vea el archivo Javagenerado y desplácese a la línea en la que se ha producido el error de tiempo deejecución. El código Java generado incluye ahora código de script como comentariocada pocas líneas.

Por ejemplo, tenga en cuenta la parte de código siguiente de un archivo Javagenerado de ejemplo// 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. Resolución de problemas 49

Cada una de las líneas que empiezan con // en los comentarios anteriores soncódigo real del script de IBM InfoSphere Master Data Management CollaborationServer correspondiente. Esta indicación hace que sea más fácil identificar dónde seha producido la anomalía en el script.

Resolución de problemas de migraciónDescribe algunos problemas comunes para resolver problemas que pueden surgirdurante la migración en IBM InfoSphere Master Data Management CollaborationServer.

Problema: Exportación de grupos de control de acceso

Al migrar a InfoSphere MDM Collaboration Server, es posible que vea el errorsiguiente que está relacionado con la exportación de grupos de control de acceso yroles:

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 error indica que se ha producido una anomalía al exportar el grupo de controlde acceso (ACG). Compruebe los registros del directorio $TOP/logs/default paraaveriguar la razón de la anomalía.

Problema: Las preguntas de migración de GDS son sensibles alas mayúsculas y minúsculas

Todas las migraciones de grupo de control de acceso de GDS anteriores aInfoSphere MDM Collaboration Server versión 9.1.0-FP011 son sensibles a lasmayúsculas y minúsculas e y o n se deben entrar en minúsculas. Antes de lasmigraciones de InfoSphere MDM Collaboration Server versión 9.1.0-FP12, se debíautilizar una Y o N mayúscula para las preguntas de migración de GDS.

Problema: Faltan índices

Al migrar a InfoSphere MDM Collaboration Server, puede ver los índices quefaltan en el informe de consola de migración.

Durante la migración se pueden producir los errores siguientes que estánrelacionados con los índices que faltan:

Índices que faltan en la tabla de SCAÍndices que faltan|============================================================|SCA_0_PK SCA_CATEGORY_IDSCA_SELECTION_IDSCA_COMPANY_IDSCA_|CATALOG_IDSCA_CAT_TREE_ID

Se puede ejecutar este script de PERL para resolver este problema. Elijadirectorio db2 u oracle según corresponda.perl $PERL5LIB/runSQL.pl --sql_file=$TOP/src/db/schema/dbscripts/<db2 or oracle>/sca_pk.sql


Índices que faltan en la tabla de DBVÍndices que faltan|============================================================|DBV_0_UK DBV_VERSION

Se puede ejecutar este script de PERL para resolver este problema. Elijadirectorio db2 u oracle según corresponda.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 que faltan en las tablas de DOA y CTG (sólo DB2) Índices que faltan|==============================================| CTG_1_UK CTG_COMPANY_IDCTG_NAME| DOA_0_UK DOA_DOC_IDDOA_CMP_IDDOA_NAME

Se puede ejecutar este script de PERL para resolver este 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: Faltan tablas ITX y CAX

Cuando se migra a InfoSphere MDM Collaboration Server, es posible que vea esteerror en el informe de verificación de BD:___________________________________________________________|Faltan tablas|===========================================================| TCTG_CAX_CATEGORY_CONTENT| TCTG_ITX_ITEM_CONTENT

|Faltan índices|| CAX_0_PK CAX_ENTRY_IDCAX_NEXT_VERSION_ID| ITX_0_PK ITX_ENTRY_IDITX_NEXT_VERSION_ID

Capítulo 5. Resolución de problemas 51

Este error indica un problema con la creación de espacio de tabla, la instalación deXDB o los parámetros db. Compruebe el mensaje exacto en el archivo errfile.logen el directorio $TOP/logs. Compruebe que la configuración de base de datos estárealizada correctamente y ejecute luego de nuevo el script de migración.

Problema: Error de privilegios insuficientes

Cuando se ejecuta un script de migración para migrar a InfoSphere MDMCollaboration Server, puede que vea un error de privilegios insuficientes en laconsola. Los ejemplos típicos del error son

Base de datos OracleCuando se utiliza una base de datos Oracle, el error puede ser similar alsiguiente:create index icnt_eem_2 on tcnt_eem_entry_entry_map (

*ERROR at line 1:ORA-01031: insufficient privileges

Base de datos DB2 Cuando se utiliza una base de datos DB2, el error puede ser similar alsiguiente:SQL0551N "USERNAME" does not have the privilege to perform operation"CREATE INDEX" on object "USERNAME.TWFL_WFE_WORKFLOW_EVENT". SQLSTATE=42501

El usuario de la base de datos no dispone de privilegios suficientes pera crear uníndice en la base de datos. Debe otorgar privilegio de creación de índice al usuariode la base de datos y, a continuación, volver a ejecutar el script de migración.También tiene que otorgar acceso al usuario para poder crear y modificar tablas.

Problema: Anomalía de script de migración

Cuando se ejecuta un script de migración para migrar a InfoSphere MDMCollaboration Server, el script puede fallar. Un escenario típico de error de script es

Anomalía en el módulo data_maintenance_reports-----------------------------------------------------------Resumen de la migración-----------------------------------------------------------La migración de los módulos siguientes no se ha realizado correctamente:data_maintenance_reports

El archivo $TOP/logs/errfile.log contiene lo siguiente:net.sf.ehcache.distribution.MulticastKeepaliveHeartbeatReceiver$MulticastReceiverThreadrunSEVERE: Multicast receiver thread caught throwable. Cause was null. Continuing...

Hay un problema con los parámetros de configuración de memoria caché, pero elscript de migración se ha ejecutado y completado satisfactoriamente. Compruebelos parámetros de configuración de memoria caché. No es necesario volver aejecutar el script de migración.


Avisos

Esta información se ha desarrollado para productos y servicios que se ofrecen enEstados Unidos.

Avisos

Esta información se ha desarrollado para productos y servicios que se ofrecen enEstados Unidos. Esta información puede estar disponible en IBM en otros idiomas.Pero puede ser necesario que el usuario posea una copia del producto o versión deproducto en ese idioma para poder acceder a él.

Puede que IBM no ofrezca en otros países los productos, servicios o característicasque se describen en este documento. Consulte al representante local de IBM paraobtener información sobre los productos y servicios que están disponiblesactualmente en su zona geográfica. Cualquier referencia a un producto, programa oservicio de IBM no indica ni implica que únicamente se puede utilizar dichoproducto, programa o servicio deIBM. En su lugar, se puede utilizar cualquierproducto, programa o servicio funcionalmente equivalente que no infrinja ningunode los derechos de propiedad intelectual de IBM. Pero corresponde al usuarioevaluar y verificar el funcionamiento de cualquier producto, programa o servicioque no sea de IBM.

IBM puede tener patentes o solicitudes de patente en tramitación que abarquentemas tratados en este documento. La entrega del presente documento al usuariono le otorga ninguna licencia sobre esas patentes. Puede enviar consultas sobrelicencias, por escrito, a:

IBM Director of LicensingIBM CorporationNorth Castle DriveArmonk, NY 10504-1785EE.UU.

Para formular consultas relacionadas con el juego de caracteres de doble byte(DBCS), póngase en contacto con el departamento de propiedad intelectual de IBMen su país o envíe sus consultas por escrito a la dirección siguiente:

Intellectual Property LicensingLegal and Intellectual Property LawIBM Japan Ltd.19-21, Nihonbashi-Hakozakicho, Chuo-kuTokio 103-8510, Japón

El párrafo siguiente no es aplicable al Reino Unido ni a ningún otro país dondetales disposiciones sean incompatibles con la legislación local:INTERNATIONAL BUSINESS MACHINES CORPORATION PROPORCIONAESTA PUBLICACIÓN "TAL CUAL", SIN GARANTÍA DE NINGUNA CLASE, YASEA EXPRESA O IMPLÍCITA, INCLUIDAS, PERO SIN LIMITARSE A ELLAS, LASGARANTÍAS IMPLÍCITAS DE NO VULNERACIÓN DE DERECHOS,COMERCIABILIDAD O ADECUACIÓN PARA UN FIN DETERMINADO. Algunos


estados no permiten la renuncia a las garantías explícitas o implícitas endeterminadas transacciones, por lo tanto, es posible que esta declaración no resulteaplicable en su caso.

Esta información puede contener imprecisiones técnicas o errores tipográficos.Periódicamente se realizan cambios en la información aquí contenida; estoscambios se incorporarán a las nuevas ediciones de la publicación. En cualquiermomento y sin previo aviso, IBM puede hacer mejoras o cambios en los productoso programas descritos en esta publicación.

Las referencias contenidas en la presente información a sitios web que no son deIBM se proporcionan solamente para la comodidad del usuario y no son un avalde esos sitios web. Los materiales de esos sitios web no forma parte de losmateriales de este producto de IBM y el uso de esos sitios web se realiza bajo laresponsabilidad del usuario.

IBM puede utilizar o distribuir la información que el usuario le proporcione decualquier manera que IBM considere adecuada, sin incurrir en ninguna obligaciónrespecto al usuario.

Los licenciatarios de este programa que deseen tener información sobre él parapermitir: (i) el intercambio de información entre programas creados por separado yotros programas (incluido el presente) y (ii) el uso mutuo de la informaciónintercambiada, se deben poner en contacto con:

IBM CorporationJ46A/G4555 Bailey AvenueSan José, CA 95141-1003 EE.UU.

Esta información puede estar disponible, sujeta a los términos y condicionesapropiados, incluido, en algunos casos, el pago de una tarifa.

El programa bajo licencia descrito es este documento y todo el material bajolicencia asociado a él lo proporciona IBM según los términos del Acuerdo delCliente de IBM, el Acuerdo Internacional de Programas bajo Licencia de IBM ocualquier acuerdo equivalente entre el usuario e IBM.

Los datos de rendimiento contenidos en este documento se han determinado en unentorno controlado. Por lo tanto, los resultados obtenidos en otros entornosoperativos pueden variar de forma significativa. Algunas mediciones se puedenhaber realizado en sistemas a nivel de desarrollo y no es seguro que estasmediciones serán las mismas en los sistemas de uso general. Además, algunasmediciones se han calculado mediante extrapolación. Los resultados reales podríanvariar. Los usuarios del presente documento deben verificar los datos aplicablescorrespondientes al entorno específico utilizado.

La información referente a productos que no son de IBM se ha obtenido a partir delos proveedores de esos productos, sus anuncios publicados u otras fuentesdisponibles públicamente. IBM no ha probado esos productos y no puedeconfirmar la exactitud del rendimiento, la compatibilidad ni ninguna otradeclaración referente a productos que no son de IBM. Las preguntas referentes aprestaciones de productos que no son de IBM se debe dirigir a los proveedores deesos productos.


Todas las declaraciones relativas a la orientación o intención futura de IBM estánsujetas a cambio o anulación sin previo aviso y representan solamente metas yobjetivos.

La presente información contiene ejemplos de datos e informes que se utilizan enoperaciones comerciales diarias. Para ilustrarlos de la forma más completa posible,los ejemplos incluyen nombres de personas, empresas, marcas y productos. Todosestos nombres son ficticios. Cualquier similitud con los nombres y direccionesutilizados por una empresa real es completamente accidental.

LICENCIA DE COPYRIGHT:

La presente información contiene programas de aplicación de muestra escritos enlenguaje fuente, que muestran el uso de técnicas de programación en diversasplataformas operativas. Puede copiar, modificar y distribuir estos programas demuestra en cualquier forma, sin pagar a IBM, con los fines de desarrollar, utilizar,comercializar o distribuir programas de aplicación de acuerdo con la interfaz deprogramación de aplicaciones correspondiente a la plataforma operativa para laque están escritos los programas de muestra. Los ejemplos no se han probadoexhaustivamente bajo todas las condiciones. Por lo tanto, IBM no puede asegurarni implicar la fiabilidad, capacidad de servicio ni función de estos programas. Losprogramas de ejemplo se proporcionan "TAL CUAL", sin ningún tipo de garantía.IBM no es responsable de ningún daño resultante del uso de los programas demuestra.

Cada copia o cualquier parte de estos programas de muestra o cualquier trabajoderivado debe incluir un aviso de copyright, de esta manera:

© (nombre de la empresa) (año). Partes de este código derivan de los Programasde muestra de IBM Corporation. © Copyright IBM Corp. _escriba el año o años_.Reservados todos los derechos.

Si está viendo la presente información en forma de copia software, las fotografías yfiguras en color pueden no ser visibles.

Consideraciones sobre la política de privacidad

Los productos de software de IBM, incluido el software ofrecido como solucionesde servicio ("Ofertas de software") pueden utilizar cookies u otras tecnologías pararecoger información sobre el uso del producto, ayudar a mejorar la experiencia delusuario final, ajustar las interacciones con el usuario final o para otros fines. Enmuchos casos, las ofertas de software no recogen información de identificaciónpersonal. Algunas de las ofertas de software pueden ayudarle a recogerinformación de identificación personal. Si esta oferta de software utiliza cookiespara recoger información de identificación personal, más adelante se proporcionainformación específica sobre el uso de cookies por parte de la oferta de software.

Dependiendo de las configuraciones desplegadas, esta solución de software puedenutilizar cookies de sesión y cookies persistentes para recoger el nombre, contraseña,perfil y otra información de identificación personal con fines de gestión de lasesión, autenticación, mejora de la usabilidad del usuario, configuración del iniciode sesión único o identificación de páginas web que el usuario ha intentado cargarantes del inicio de sesión. Estos cookies se pueden inhabilitar, pero con ello sepierde la funcionalidad que los cookies hacen posible.

Avisos 55

Si las configuraciones desplegadas para la oferta de software le permiten recogerinformación de identificación personal del usuario final a través de cookies y otrastecnologías, debe buscar asesoramiento legal sobre las leyes aplicables a esarecogida de datos, incluidos los requisitos de previo aviso y consentimiento.

Para obtener información sobre el uso de cookies y otras tecnologías con fines derecogida de datos, consulte la Política de privacidad de IBM enwww.ibm.com/privacy y la declaración de Privacidad en línea de IBM enwww.ibm.com/privacy/details, la sección titulada "Cookies, Web Beacons andOther Technologies" y la declaración "IBM Software Products andSoftware-as-a-Service Privacy Statement" en www.ibm.com/software/info/product-privacy.

Declaración general respecto a la seguridad del producto

Los sistemas y productos IBM están diseñados para ser implementados como partede un sistema de seguridad completo que puede necesitar el uso de otros sistemas,productos o servicios para que sea lo más efectivo posible. Se debe revisar elsistema de seguridad completo cada vez que se añaden sistemas o productos alentorno de trabajo.

Ningún sistema o producto de tecnologías de la información puede sercompletamente seguro y ningún producto o medida de seguridad puede sercompletamente efectivo para impedir el acceso no autorizado.

La seguridad del sistema de tecnologías de la información supone proteger lossistemas y la información mediante la prevención, detección y respuesta al accesono autorizado desde dentro y fuera de la empresa. El acceso no autorizado puedeproducir como resultado la alteración, destrucción o uso indebido de lainformación, o el uso indebido de los sistemas para atacar a otros usuarios.

IBM no garantiza que los sistemas y productos son inmunes a la conductamalintencionada o ilegal de cualquier usuario.

IBM no cree que un proceso cualquiera puede ser completamente efectivo paraayudar a identificar y trata los riesgos de seguridad. IBM utiliza un sistema avarios niveles:v Una iniciativa continua interna fomenta la adopción coherente de prácticas de

seguridad en el desarrollo de productos y servicios, con el objetivo de mejorarcontinuamente las características de calidad y seguridad de todos los productosy servicios de IBM. Esta iniciativa está descrita en la publicación Security inDevelopment: The IBM Secure Engineering Framework, perteneciente a la serie IBMRedGuides, que contiene información pública sobre prácticas de desarrollo desoftware de IBM.

v Las pruebas y exámenes de los productos IBM utilizan diversas tecnologías deIBM para identificar y corregir proactivamente los defectos y lasvulnerabilidades, incluidas las vulnerabilidades altas o críticas. El proceso decorrección tiene lugar dentro de los plazos de tiempo de respuesta definidos porIBM para el análisis, evaluación de efectos y entrega de arreglos.

v El equipo PSIRT (Product Security Incident Response Team) de IBM gestiona larecepción, investigación y coordinación interna de la información sobre riesgosde seguridad correspondiente a los productos IBM. El equipo PSIRT de IBMactúa como punto focal con el que pueden contactar, a través del portal de IBMPSIRT, los investigadores de seguridad, grupos industriales, organizaciones delgobierno, proveedores y clientes para notificar posibles riesgos de seguridad de


http://www.ibm.com/privacy

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

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

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

productos IBM. Este equipo trabaja en coordinación con los equipos paraproductos y soluciones de IBM para investigar y establecer el plan de respuestaapropiado.

v Un programa de integridad de la cadena de suministro y una infraestructuraglobales proporcionan a los compradores de productos de tecnologías de lainformación una gama de socios y proveedores de tecnología acreditadospertenecientes al Open Group Trusted Technology Forum (OTTF).

Debido a que la seguridad de los sistemas informáticos y del software es un temamuy complejo, IBM no proporciona información sobre prácticas de desarrollo desoftware para productos individuales, excepto la que se encuentra en ladocumentación estándar del producto o la información publicada a través de lasactividades públicas de IBM.

IBM Secure Engineering Framework contiene información pública sobre lasprácticas de desarrollo de software recomendadas por IBM. Esta información esuna compilación de prácticas procedentes de diversas unidades de negocio yequipos de desarrollo de IBM.

En la mayoría de los casos, los riesgos de seguridad publicados se describenperiódicamente mediante los boletines IBM Security Bulletins, los cuales incluyenla puntuación base definida por CVSS (Common Vulnerability Scoring System). Enalgunos casos, IBM puede contactar de forma directa y confidencial con los clientespara tratar riesgos de seguridad determinados.

Los clientes que deseen comprobar la vulnerabilidad del software de IBM enadición a los análisis que IBM realiza internamente pueden ejecutar sus propiosexámenes para software bajo licencia. Los clientes pueden utilizar la herramientaque deseen dentro de los términos de las licencias de software existentes. Porejemplo, la exploración es aceptable, pero la compilación inversa o ingenieríainversa de software de IBM no está autorizada salvo si lo permite explícitamente laley sin posibilidad de renuncia contractual.

Marcas registradas

IBM, el logotipo de IBM e ibm.com son marcas registradas de InternationalBusiness Machines Corp. en muchas jurisdicciones de todo el mundo. Otrosnombres de productos y servicios pueden ser marcas registradas de IBM o de otrasempresas. Encontrará una lista actual de marcas registradas de IBM en la páginaweb "Copyright and trademark information" situada en www.ibm.com/legal/copytrade.shtml.

Los términos siguientes son marcas registradas de otras compañías:

Adobe, el logotipo de Adobe, PostScript y el logotipo de PostScript son marcasregistradas de Adobe Systems Incorporated en Estados Unidos o en otros países.

IT Infrastructure Library es una marca registrada de la Agencia Central deInformática y Telecomunicaciones, que ahora forma parte de la Oficina deComercio Gubernamental.

Linear Tape-Open, LTO, el logotipo de LTO, Ultrium y el logotipo de Ultrium sonmarcas registradas de HP, IBM Corp. y Quantum en Estados Unidos y en otrospaíses.

Avisos 57

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

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

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

Intel, el logotipo de Intel, Intel Inside, el logotipo de Intel Inside, Intel Centrino, ellogotipo de Intel Centrino, Celeron, Intel Xeon, Intel SpeedStep, Itanium y Pentiumson marcas registradas de Intel Corporation o de sus empresas filiales en EstadosUnidos y en otros países.

Linux es una marca registrada de Linus Torvalds en Estados Unidos o en otrospaíses.

Microsoft, Windows, Windows NT y el logotipo de Windows son marcasregistradas de Microsoft Corporation en Estados Unidos o en otros países.

Java y todas las marcas registradas y logotipos basados en Java son marcasregistradas de Oracle o de sus empresas filiales.

Cell Broadband Engine es una marca registrada de Sony Computer Entertainment,Inc. en Estados Unidos o en otros países, y se utiliza bajo licencia.

ITIL es una marca registrada, y una marca comunitaria registrada del Ministerio dela Presidencia, y está registrada en la Oficina de Marcas y Patentes de EstadosUnidos.

UNIX es una marca registrada de The Open Group en Estados Unidos y otrospaíses.


Índice

Números11.5 426.0 289.1 42, 45

Aajustar 46API de java

11.5 456.0 42enumeraciones 42interfaces 45métodos 42

avisos legales 53

Bbase de datos

gds 46

Ccomentarios

enviar ix

DDiferencias de la API de Java 42diferencias de script 27

Eenviar comentarios ix

Ffunciones

nuevas en versión 11.4 ix

Iinformación de requisitos previos ixinformación relacionada ix

JJava

11.5 46puntos de ampliación 46

Mmarcas registradas

lista de 53

migraciónproblemas 47scripts 47visión general 1

migrarintroducción 3migración de versiones anteriores 5migrar desde v10.1.0 a v11.5 13migrar desde v11.0.0 a v11.5 16migrar desde v11.3 a v11.5 19migrar desde V11.4 a V11.5 22migrar desde v9.1.0 a v11.5 9resolución de problemas de scripts de migración 47scripts 27

Rresolución de problemas

ponerse en contacto con el soporte de software de IBM xiproblemas de migración 50

Sscript

diferencias 28métodos de V11.5 28

scriptscambios de comportamiento en V6.0 y V11.5 42cambios de comportamiento entre V5.3.2 y V11.5 37compilación y depuración 47errores comunes de compilación 47errores comunes en tiempo de ejecución 48resolución de errores en tiempo de ejecución 49

servicios de softwarecómo ponerse en contacto con 61

soportecliente 61

soporte al clientecómo ponerse en contacto con 61

VV11.5 28


Cómo ponerse en contacto con IBM

Puede ponerse en contacto con IBM para recibir soporte al cliente, servicios desoftware, información de producto e información general. También puedeproporcionar comentarios sobre los productos y la documentación de IBM.

La siguiente tabla enumera los recursos para soporte al cliente, servicios desoftware, formación, e información de productos y soluciones.

Tabla 8. Recursos de IBM

Recurso Descripción y ubicación

Documentación del producto paraInfoSphere MDM

Puede realizar búsquedas y consultar todoslos documentos de InfoSphere MDM enhttp://pic.dhe.ibm.com/infocenter/mdm/v11r0/index.jsp.

Información del producto de InfoSphereMDM Custom Domain Hub, que incluyeInfoSphere MDM Reference DataManagement

Puede realizar búsquedas y consultar todoslos documentos de InfoSphere MDMCustom Domain Hub enhttp://pic.dhe.ibm.com/infocenter/mih/v11r0/index.jsp.

IBM Support Portal Puede personalizar la información desoporte seleccionando los productos temasque le interesan en www.ibm.com/support/.

Servicios de software Encontrará información sobre software, TI yservicios de consultoría de negocio en elsitio web de soluciones, enwww.ibm.com/businesssolutions/.

Mi IBM Puede gestionar enlaces con los sitios webde IBM y la información que más se ajustena sus necesidades de soporte técnicoespecíficas creando una cuenta en el sitio MiIBM, en www.ibm.com/account/.

Formación y certificación Puede obtener información sobre serviciosde formación técnica para usuarios,empresas y organizaciones públicas con elfin de adquirir, mantener y optimizar susconocimientos de TI en www.ibm.com/software/sw-training/.

Representantes de IBM Puede ponerse en contacto con unrepresentante de IBM para obtenerinformación sobre soluciones enwww.ibm.com/connect/ibm/us/en/.

Facilitar comentarios

En la tabla siguiente se describe cómo enviar comentarios a IBM sobre losproductos y la documentación de productos.


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/account/

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

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

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

Tabla 9. Cómo proporcionar comentarios a IBM

Tipo de comentarios Acción

Comentarios sobre el producto Puede proporcionar sus comentariosgenerales sobre productos mediante laEncuesta de idoneidad enwww.ibm.com/software/ucd/consumability/.

Comentarios sobre la documentación Para realizar comentarios acerca delInformation Center, pulse el enlaceComentarios situado en la parte superiorderecha de cualquiera de los temas delInformation Center. También puede enviarsus comentarios sobre los manuales enarchivos PDF, el Information Center ocualquier otra documentación de lossiguientes modos:

v Formulario de comentarios del lector enlínea: www.ibm.com/software/data/rcf/

v Correo electrónico: [email protected]


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

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


Cómo ponerse en contacto con IBM 63

IBM®

Impreso en España

SC11-8392-03

InfoSphere MDM Collaboration Server: Guía de migración · En InfoSpher e MDM Enterprise Edition e...

Documents

Transcript of InfoSphere MDM Collaboration Server: Guía de migración · En InfoSpher e MDM Enterprise Edition e...