IBM
WebSphere
Business
Integration
Adapters
Guía
del
usuario
de
Adapter
for
Manugistics
V
1.1.x
IBM
WebSphere
Business
Integration
Adapters
Guía
del
usuario
de
Adapter
for
Manugistics
V
1.1.x
Nota
Antesdeutilizarlainformacióndeestemanualyelproductoalquesirvedecomplemento,lealainformacióncontenidaen lasección“Avisos”enlapágina139.
25dejuniode2004
EstaedicióndelpresentedocumentoesaplicablealproductoIBMWebSphereBusinessIntegrationAdapterfor Manugistics(5724-H28),versión1.1.xyatodoslosreleasesymodificacionesposterioreshastaqueseindiquelo contrarioennuevasediciones.
EstemanualeslatraduccióndeloriginalinglésAdapterforManugisticsUserGuide.
Paraenviarnoscomentariossobreestedocumento,puedeenviaruncorreoelectró[email protected]. Nosinteresaconocersuopinión.
CuandoenvíainformaciónaIBM,otorgaaIBMunderechonoexclusivoparautilizarodistribuirlainformaciónen cualquierformaqueIBMconsidereapropiada,sincontraerningunaobligaciónconelremitentedelainformación.
Contenido
Acerca
de
este
documento
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
. v
Aquiénvadirigidoestemanual. . . v
Documentosafines . . . v
Conveniostipográficos. . . vi
Novedades
en
este
release
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
. vii
Novedadesenelrelease1.1.x . . . vii
Novedadesenelrelease1.0. . . vii
Capítulo
1.
Visión
general
del
conector
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
. 1
Componentesdelconector. . . 1
Cómoactúaelconector. . . 2
Capítulo
2.
Instalación
y
configuración
del
conector
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
. 9
Entornodeladaptador . . . 9
Prerrequisitos. . . 10
Instalacióndeladaptadorydelosarchivosasociados . . . 11
Estructuradearchivosinstalada . . . 11
HabilitacióndeManugisticsparaelconector . . . 13
Habilitacióndelsoporteparavarioscontroladores . . . 17
Habilitacióndelaclasegestorapersonalizadadeobjetoscomerciales . . . 17
Configuracióndelconector . . . 18
Creacióndevariasinstanciasdeunconector . . . 32
Iniciodelconector . . . 33
Detencióndelconector . . . 34
Capítulo
3.
Descripción
de
los
objetos
comerciales
en
su
relación
con
el
conector
.
.
. 37
Conveniosdedenominaciónparaobjetoscomercialesyatributos . . . 37
Estructuradelosobjetoscomerciales . . . 37
Procesosdeverbosdeobjetocomercial . . . 42
Propiedadesdeatributosdeobjetoscomerciales . . . 60
Informaciónespecíficadelaaplicaciónparaobjetoscomerciales. . . 62
Capítulo
4.
Creación
de
definiciones
de
objetos
comerciales
utilizando
IBM
ODA
for
Manugistics
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
. 75
Instalaciónyutilización . . . 75
UtilizacióndeODAforManugisticsenelDiseñadordeobjetoscomerciales. . . 79
Contenidodeladefinicióngenerada . . . 89
Archivodedefinicióndeobjetocomercialdeejemplo . . . 92
Insercióndeatributosquecontienenobjetoscomercialeshijo. . . 93
Adicióndeinformaciónaladefinicióndeobjetocomercial . . . 93
Capítulo
5.
Resolución
y
manejo
de
errores
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
. 95
Problemasdeinicio. . . 95
Procesodesucesos . . . 95
Correlación(solamenteparaelintermediariodeintegraciónInterChangeServer) . . . 95
Manejoyregistrodeerrores. . . 97
Pérdidadelaconexiónconlaaplicación. . . 98
Errordebúsquedafueradesecuencia . . . 98
Errorderecursoocupado. . . 99
FuncionamientoincorrectodeODAforManugisticsdebidoauncontroladorJDBCnocompatible . . . 99
Propiedadesnuevasypropiedadessuprimidas . . . 101
Configuracióndepropiedadesestándardeconector . . . 101
Resumendelaspropiedadesestándar . . . 103
Propiedadesdeconfiguraciónestándar. . . 107
Apéndice
B.
Configurador
de
conectores
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
. 121
VisióngeneraldelConfiguradordeconectores . . . 121
IniciodelConfiguradordeconectores . . . 122
EjecucióndelConfiguradordesdeelGestordelsistema . . . 123
Creacióndeunaplantilladepropiedadesespecíficadelconector . . . 123
Creacióndeunarchivodeconfiguraciónnuevo. . . 126
Utilizacióndeunarchivoexistente . . . 127
Finalizacióndeunarchivodeconfiguración . . . 128
Definicióndepropiedadesenelarchivodeconfiguración . . . 129
Guardarelarchivodeconfiguración. . . 135
Modificacióndeunarchivodeconfiguración. . . 135
Finalizacióndelaconfiguración . . . 136
UsodelConfiguradordeconectoresenunentornoglobalizado . . . 136
Apéndice
C.
Utilización
de
valores
nulos
y
valores
en
blanco
.
.
.
.
.
.
.
.
.
.
. 137
Situacionesaprobadasydeerror. . . 137
Funcionalidad . . . 138
Avisos
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
. 139
Informacióndelainterfazdeprogramación . . . 140
Acerca
de
este
documento
LaofertadeproductosdeIBM(R)WebSphere(R)Business IntegrationAdapter proporcionaconectividad deintegraciónparatecnologíasavanzadasdee-business, aplicacionesempresariales, sistemasheredadosygrandessistemas.Lafamilia de productosincluyeherramientasy modelosparapersonalizar,crearygestionar componentes afindeintegrarprocesos empresariales.
Estedocumentodescribelainstalación,configuración,y desarrollode objetosde negocioparaelAdaptadordeManugistics.
A
quién
va
dirigido
este
manual
Estedocumentoestápensadoparaasesores,desarrolladoresyadministradoresde sistemas quehacenusodelconectorensitios Webdelcliente.
Documentos
afines
Elconjuntocompletode documentaciónexistenteparaesteproductodescribelas funciones ycomponentesquesoncomunesa todaslasinstalacionesdeWebSphere Business IntegrationAdapters,eincluyeinformacióndeconsultasobre
componentes determinados.
Puedeinstalarladocumentación pertinentedesdelossitios Websiguientes: v Paraobtenerinformacióngeneral sobreadaptadores;parautilizaradaptadores
conintermediariosde mensajesdeWebSphere(WebSphereMQIntegrator, WebSphereMQIntegrator Broker,WebSphereBusiness IntegrationMessage Broker);yparautilizaradaptadoresconWebSphereApplicationServer: http://www.ibm.com/websphere/integration/wbiadapters/infocenter v ParautilizaradaptadoresconInterChangeServer:
http://www.ibm.com/websphere/integration/wicserver/infocenter
http://www.ibm.com/websphere/integration/wbicollaborations/infocenter v Paraobtenermásinformaciónsobreintermediariosde mensajes(WebSphere
MQIntegratorBroker,WebSphereMQIntegrator yWebSphereBusiness IntegrationMessageBroker):
http://www.ibm.com/software/integration/mqfamily/library/manualsa/ v ParaobtenermásinformaciónsobreWebSphereApplicationServer:
http://www.ibm.com/software/webservers/appserv/library.html Estossitios Webcontieneninstruccionessencillasparadescargar,instalary visualizar ladocumentación.
Nota: PuedeencontrarinformaciónimportantesobreelproductoenNotasde soportetécnicoyComunicadosemitidosdespuésdelapublicacióndel presentedocumento.EstosdocumentosadicionalessehallanenelsitioWeb desoportetécnicode WebSphereBusiness Integration:
Convenios
tipográficos
Estedocumentoutilizalosconveniossiguientes:
font courier Indicaunvalorliteral,talcomounnombredemandato,un nombredearchivo,informaciónquedebeescribirelusuario oinformaciónqueelsistemamuestraenlapantalla.
negrita Indicauntérminonuevo,cuandoapareceporprimeravez.
cursiva, Indicaunnombrevariableounareferenciacruzada.
líneadecontornoazul Sóloesvisiblecuandosevisualizaelmanualenlapantallae indicaunhiperenlacedereferenciacruzada.Pulseconel ratóndentrodelalíneadecontornoparairhaciaelobjetoal queapuntalareferencia.
DirProducto Representaeldirectoriodondeestáinstaladoelproducto. ParaelentornodeIBMWebSphereInterChangeServer,el directorioporomisióndelproductoes
“IBM\WebSphereICS”.ParaelentornodeIBMWebSphere BusinessIntegrationAdapters,eldirectorioporomisióndel productoes“WebSphereAdapters”.
{ } Enunalíneadesintaxis,seutilizanllavesparadelimitarun conjuntodeopcionesdelascualeselusuariodebeelegiruna sola.
| Enunalíneadesintaxis,seutilizaunabarraverticalpara separarunconjuntodeopcionesdelascualeselusuario debeelegirunasola.
[ ] Enunalíneadesintaxis,loscorchetesrectosdelimitanun parámetroopcional.
... Enunalíneadesintaxis,lospuntossuspensivosdenotanla repeticióndelparámetroanterior.Porejemplo,opción[,...] significaquepuedeespecificarvariasopciones,separadas porcomas.
< > Loscorchetesangularesdelimitanelementosindividualesde unnombreparadistinguirlosentresí,talcomoen
<nombre_servidor><nombre_conector>tmp.log.
/, \ Enelpresentedocumento,lasbarrasinclinadasinvertidas (\)seutilizancomoconveniopararepresentarlasvíasde accesodedirectorios.ParalasinstalacionesenUNIX(R)
, utilicebarrasinclinadas(/)enlugardebarrasinclinadas invertidas.Todaslasvíasdeaccesodelproductoestán referidasaldirectoriodonderesideelconectordeJDBCenel sistemadelusuario.
UNIX:/Windows:(TM)
Lospárrafosquecomienzanconcualquieradeestasdos especificacionesindicannotasquedescribendiferencias específicasdelsistemaoperativo.
%texto%y$texto EnWindows,eltextodelimitadoporsímbolosdeporcentaje (%)indicaelvalordelavariabledelsistemaovariablede usuariotexto.LanotaciónequivalenteenunentornoUNIX es$texto,quedenotaelvalordelavariabledeentorno
Novedades
en
este
release
Novedades
en
el
release
1.1.x
Actualizadoenjuniode2004.Elreleasede estedocumentoparalaversión1.1.x deladaptadorcontienelasiguiente informaciónnuevaocorregida:
v EladaptadoradmitelautilizacióndeManugisticsNetWORKSCollaborate, versión7.2.Debidoaestanuevafuncionalidad,elnombredeladaptadorseha cambiadoaAdapter forManugistics.
v Sehanañadidonuevaspropiedadesdeconfiguración específicasdelconector: QueryTimeOut,ReturnDummyBOForSP,SelectiveCommitForPolly
UseDefaultsWhenPolling(quesustituyea UseDefaultsForRetrieve).Seha documentadouna propiedadexistente:DriverSupportForLong.
v Eladaptadoradmitelautilizacióndeunnuevoparámetroparalosatributosde tipoDATEenlainformaciónespecíficadelaaplicación.
v Elconectorreconoce estosnombresdeatributos deprocedimientoalmacenado paraelverboDeltaUpdate:BeforeDeltaUpdateSP,AfterDeltaUpdateSP,
DeltaUpdateSP.
v ElÁrbolde esquemacontieneelnodoadicionalsinónimos/apodospara identificarobjetosdebase dedatosquesedebenasociar conladefiniciónde objetocomercialcreada.
v ElÁrbolde esquemacontieneelnombredeesquemaALLSCHEMASpara ayudararecuperarobjetosdebasesdedatosquenotienenesquemas asociados conlosobjetos.
v Enlaversión1.1.x,AdapterforManugisticsnosepuedeutilizarenSolaris 7.0, porloquelasreferenciasa esaplataformasehaneliminadodelapresenteguía.
Novedades
en
el
release
1.0
Actualizadoenfebrerode2004.Elrelease deestedocumentocontienelasiguiente informaciónnuevaocorregida:sehaañadido elparámetrode nombre-valor [PH=true|false]a la“Informaciónespecíficade laaplicaciónparaatributos simples” enelCapítulo3.
Diciembre de2003
Laversión1.0eselprimerrelease delmanual AdapterforManugisticsDemandand Fulfillment Management,Guíadel usuario.
Capítulo
1.
Visión
general
del
conector
Losconectoresconstandedospartes:lainfraestructuradelconectoryel componenteespecífico dela aplicación.Lainfraestructuradelconector,cuyo códigoescomúna todoslosconectores, actúacomointermediarioentreel intermediariode integracióny elcomponenteespecíficodelaaplicación.El componenteespecíficodelaaplicacióncontienecódigoqueestáadaptadoa una determinadaaplicaciónotecnología (enestecaso,JDBC).Lainfraestructuradel conector proporcionalosserviciossiguientesentreelintermediariodeintegracióny elcomponenteespecíficodelaaplicación:
v Recibey envíaobjetoscomerciales
v Gestionaelintercambiodemensajesdeinicioymensajesadministrativos
Estecapítulodescribeelcomponenteconectorde IBMWebSphereBusiness IntegrationAdapter forManugistics.Observequeelpresentedocumentocontiene informacióntantosobrelainfraestructuradelconectorcomosobreelcomponente específicodelaaplicación.Seutilizaeltérminoconectorparahacerreferenciaa ambos elementos.Paraobtenermásinformaciónsobrelarelacióndelintermediario de integraciónconelconector,consulte elmanualIBM WebSphereInterChange Server SystemAdministrationGuideoIBMWebSphere BusinessIntegrationAdapters ImplementationGuideforWebSphereMQIntegratorBroker.
Estecapítulocontienelasseccionessiguientes: v “Componentesdelconector”
v “Cómoactúaelconector”enlapágina2
Componentes
del
conector
ElconectordeManugisticspermitequeelintermediariodeintegraciónintercambie objetoscomercialesconunaaplicaciónbasadaencualquierbase dedatos
compatibleconuncontroladorqueseajustaa laespecificaciónJDBC2.0o posterior.Estasecciónproporcionaunadescripcióngeneral delaarquitecturadel conector ydelusoquehacedediversoscontroladoresJDBC.
Paraespecificarelcontroladorquedebeutilizarelconectorparaconectarconla base dedatos,consulte“Habilitacióndelsoporteparavarioscontroladores”enla página 17.
Elconectorconectaconlabasede datosdelaaplicaciónutilizandoelmecanismo de JDBCConnect.Unparámetrodeconfiguración específicodelconector
(DatabaseURL) lepermiteespecificarelnombre delservidor debasesdedatosal quesedebeconectarelconector.Paraobtenerinformaciónsobrelosparámetrosde configuración, consulte“Configuracióndelconector”enlapágina18.
Cuando seiniciaelconector,establece unconjuntode conexionesconlabasede datos.Elconectorutilizaconexionesdeesteconjuntoparaelprocesodetodaslas transaccionesconlabasededatos.Cuandofinalizalaejecucióndelconector,se cierran todaslasconexionesdelconjunto.
Arquitectura
del
conector
LaFigura1 muestraloscomponentesdelconector ysusrelacionesconelsistema de integraciónempresarial.
Cómo
actúa
el
conector
Estaseccióndescribecómo losmetadatosmejoranlaflexibilidaddelconector,y proporcionauna descripcióngeneraldelprocesodelosobjetoscomercialesydela notificación desucesos.
El
conector
y
los
metadatos
Elconectorestágobernadopor metadatos.EnelentornodeIBM WebSphere Business IntegrationAdapter,losmetadatosson datosespecíficosdelaaplicación quesealmacenanenobjetoscomercialesy queayudanalconectorensu
interacciónconlaaplicación.Unconectorgobernado pormetadatosmanejacada objeto comercialcompatibledeacuerdoconmetadatosqueestáncodificadosenla definicióndelobjetocomercial,enlugarde hacerlobasándoseeninstrucciones codificadasenelconector.
Losmetadatosdeobjetocomercialincluyenlaestructurade unobjetocomercial, losvaloresdesuspropiedadesdeatributosyelcontenidodesu información específica delaaplicación.Debidoa queelconectorestágobernadopormetadatos, puedemanejarobjetoscomercialesnuevosomodificadossin necesitar
modificacionesenelcódigodelconector.
ElconectorejecutasentenciasdeSQLo procedimientosalmacenadospara
recuperaro cambiardatosenlabasededatos/aplicación.Paracrearsentenciasde SQLdinámicooprocedimientosalmacenados,elconector utilizametadatos
específicos delaaplicación.EstassentenciasdeSQLyprocedimientosalmacenados realizanlasaccionesnecesariasde recuperaciónocambioenlabasede
datos/aplicación paraelobjetocomercialyparaelverboqueelconectorestá procesando. Paraobtenerinformaciónsobreelusodeinformaciónespecíficade la aplicación,consulte elCapítulo3,“Descripciónde losobjetoscomercialesensu relaciónconelconector”,enlapágina 37.
Proceso
de
objetos
comerciales
Estasecciónproporcionaunavisión generaldecómoelconectorprocesa peticiones de objetoscomercialesy sucesosdeaplicación.Paraobtenerinformaciónmás detallada, consulte“Procesosdeverbos deobjetocomercial”enlapágina42.
Proceso
de
peticiones
de
objetos
comerciales
Cuando elconectorrecibe unapeticiónparaefectuarunaoperacióndeaplicación, elconectorprocesa recursivamenteobjetoscomerciales jerárquicos;esdecir,efectúa losmismospasosparacadaobjetocomercialhijohastaquehaprocesadotodoslos objetoscomercialesindividuales.Elordenenelqueelconector procesalosobjetos comerciales hijoy elobjetocomercialdenivelsuperiordependedesilosobjetos comerciales hijoestáncontenidosconosinpropietarioy desiestáncontenidos con cardinalidadsimple ocardinalidadmúltiple.
Nota: Eltérmino objetocomercialjerárquicohacereferenciaa unobjetocomercial completo,incluidostodoslosobjetoscomerciales hijoqueelobjeto contiene acualquier nivel.Eltérminoobjeto comercialindividualhacereferenciaa unsóloobjetocomercial,conindependenciade losobjetoscomercialeshijo quepuedacontener oenlosqueestécontenido.Eltérminoobjetocomercial denivelsuperiorhacereferenciaalobjetocomercialindividualsituado enlo másaltodelajerarquíayquenotieneningúnobjetocomercialpadre. Recuperación deobjetoscomerciales: Cuandounintermediariodeintegración solicitaalconectorquerecupereunobjetocomercialjerárquicodelabasede datos, elconectorintentadevolverunobjetocomercialquecoincidaexactamenteconla representación actualde eseobjetocomercialenlabasededatos.Es decir,todos losatributos simplesde cadaobjeto comercialindividual devueltoalintermediario de integracióncoincidenconelvalor delcampocorrespondientedelabasede datos.Además,elnúmerodeobjetoscomercialesindividualesencadamatriz contenida porelobjetocomercialdevueltocoincide conelnúmerodehijosenla base dedatosparaesamatriz.
Pararealizarunarecuperación,elconectorutilizalosvaloresde claveprimariadel objeto comercialde nivelsuperiorparadescender recursivamenteporlosdatos correspondientesdelabasede datos.
Recuperación deobjetoscomercialesporcontenido: Cuando unintermediariode integraciónsolicitaalconectorquerecupere unobjetocomercialjerárquico
basándose envaloresdeatributos node clavedelobjetocomercialde nivel superior,elconector utilizaelvalor detodoslosatributos nonuloscomocriterio pararecuperarlosdatos.
Creacióndeobjetoscomerciales: Cuandounintermediariode integraciónsolicita alconector quecreeunobjeto comercialjerárquico enlabasede datos,elconector efectúa estospasos:
1. Crearecursivamentecadaobjetocomercialhijode cardinalidadsimple contenidoconpropietarioenlabase dedatos.
2. Procesacadaobjeto comercialhijodecardinalidadsimple contenidosin propietario.
4. Crealosobjetoscomerciales hijode cardinalidadsimplequeguardanla relaciónpadre/hijoenelhijo.
5. Creacadaobjetocomercialhijode cardinalidadmúltiple.
Modificación deobjetoscomerciales: Cuando unintermediariodeintegración solicitaalconectorqueactualiceunobjeto comercialjerárquico enlabase dedatos, elconectorefectúa estospasos:
1. Utilizalosvaloresdeclave primariadelobjetocomercialdeorigenpara recuperarlaentidadcorrespondientedelabasede datos.
2. Actualiza recursivamentetodosloshijosde cardinalidadsimpledelobjeto comercialdenivelsuperior.
3. Paralosobjetoscomerciales hijode cardinalidadsimplequeguardanlarelación padre/hijoenelpadre,elconector establececadavalorde claveforáneadel padre enelvalorde laclave primariadelcorrespondienteobjetocomercialhijo decardinalidadsimple.
4. Actualiza todoslosatributossimplesdelobjetocomercialrecuperado,excepto aquélloscuyo atributocorrespondienteenelobjetocomercialdeorigen contieneelvalor CxIgnore.
5. Establece todoslosvaloresdeclaveforáneadecadahijoqueguardalarelación padre/hijoenelhijo(tanto decardinalidadsimplecomomúltiple) enelvalor declave primariadelcorrespondienteobjetocomercialpadre.
6. Procesatodaslasmatricesdelobjeto comercialrecuperado.
Supresióndeobjetoscomerciales: Cuandounintermediariode integración solicitaalconectorquesuprimaunobjetocomercialjerárquicodelabasede datos, elconectorefectúa estospasos:
1. Suprimeloshijosdecardinalidadsimple. 2. Suprimeloshijosdecardinalidadmúltiple. 3. Suprimeelobjetocomercialdenivelsuperior.
Proceso
de
sucesos
de
aplicación
ElconectormanejalossucesosCrear,ActualizarySuprimirgeneradosporla aplicación delamaneradescritaacontinuación.
NotificaciónparaCrear: Cuandoelconector encuentraunsucesoCrearenla tabla desucesos,creaunobjetocomercialdeltipo especificadoporelsuceso, establece losvaloresde claveparaelobjetocomercial(utilizandolasclaves especificadas enlatabla desucesos)yrecuperaelobjetocomercialdelabasede datos.Despuésderecuperarelobjetocomercial,elconectorloenvía juntoconel verboCrearalintermediariodeintegración.
NotificaciónparaActualizar: CuandoelconectorencuentraunsucesoActualizar enlatabla desucesos,creaunobjetocomercialdeltipoespecificado porelsuceso, establece losvaloresde claveparaelobjetocomercial(utilizandolasclaves
especificadas enlatabla desucesos)yrecuperaelobjetocomercialdelabasede datos.Despuésderecuperarelobjetocomercial,elconectorloenvía juntoconel verboActualizaralintermediariodeintegración.
NotificaciónparaSuprimir: Cuandoelconector encuentraunsucesoSuprimiren latabla desucesos,creaunobjeto comercialdeltipoespecificado porelsuceso, establece losvaloresde claveparaelobjetocomercial(utilizandolasclaves especificadas enlatabla desucesos)yenvíaelobjetocomercialjuntoconelverbo Suprimiralintermediariodeintegración.Todoslosvaloresexceptolosvaloresde
clave seestablecenenCxIgnore.Sialgunode loscamposquenosondeclaveson importantes ensu sitio,modifiqueelvalorde loscampossegúnseanecesario. Elconectormanejalasoperacioneslógicasyfísicasde Suprimirqueson
desencadenadas porlaaplicación delconector.Enelcasodelas supresionesfísicas, elmecanismoSmartFilteringeliminatodoslossucesosnoprocesadosdelobjeto comercial(talescomoCrearoActualizar)antesdeinsertarelsucesoSuprimirenla tabla desucesos.Enelcasodelassupresiones lógicas,elconectorinsertaun sucesoSuprimirenlatabla desucesossin eliminarotrossucesosparaelobjeto comercial.
Recuperación deobjetoscomercialesparaelproceso desucesos: La
Recuperación deunobjetocomercialparaelprocesodesucesospuederealizarse de dosmaneras.LaprimeraeslaRecuperación basadaenatributosdeclavede un objeto comercial.LasegundaeslaRecuperaciónbasada enatributos declavey atributos nodeclave.Enestecaso,elobjetocomercialnecesitasercompatiblecon elverboRetrieveByContentydebeutilizarelparnombre_valorparalasclavesde objeto.
Nota: Silaclavedeobjetonoutilizaelparnombre_valor,lasclavescontenidasen elcampodeclaves deobjetodeben seguirelmismoordenquelasclaves contenidasenelobjetocomercial.
Notificación
de
sucesos
Elmecanismode detecciónde sucesosdelconector utilizaunatablade sucesos, una tabladearchivado,procedimientosalmacenadosy desencadenantesdebase de datos.Debidoalaexistenciadeposiblespuntosde errorasociados alproceso de sucesos,elprocesodegestióndesucesosnosuprimeunsucesodelatablade sucesoshastaqueseha insertadoenlatabla dearchivado.
Losdesencadenantesde basededatosañadendatosauna tabladesucesoscada vez queseproduceunsucesodeinterésenlabase dedatos.Elconectorsondea estatabla segúnunintervalo regularconfigurable, recuperalossucesosy los procesa primeroporordende prioridadyluegosecuencialmente.Cuandoel conector haprocesadounsuceso, seactualizaelestadodelsuceso.
Nota: Elusuario debeañadir losdesencadenantes alabasededatoscomo parte delprocedimientodeinstalación.
Elvalorde lapropiedadArchiveProcesseddelconectordeterminasielconector archivaunsucesoenlatabla dearchivadodespuésde actualizarelestadodel suceso. ParaobtenermásinformaciónsobrelapropiedadArchiveProcessed, consulte “Configuracióndelconector”enlapágina18.
LaTabla1 muestracómoserealizaelarchivadodependiendodelvalor dela propiedadArchiveProcessed.
Tabla1.Manerasderealizarseelarchivado Valorde
ArchiveProcessed
Razónparasuprimirdela
tabladesucesos Accióndelconector
trueosinvalor Procesadoconéxito Archivadocon estadodeSentto InterChange
Procesadosinéxito ArchivadoconestadodeError Noexisteningunasuscripción Archivadoconestadode
Tabla1.Manerasderealizarseelarchivado (continuación) Valorde
ArchiveProcessed
Razónparasuprimirdela
tabladesucesos Accióndelconector
false Procesadoconéxito Nosearchivaysesuprimedela tabladesucesos
Procesadosinéxito Permaneceenlatabladesucesos conelestadodeError
Noexisteningunasuscripción paraelobjetocomercial
Permaneceenlatabladesucesos conelestadodeUnsubscribed
SmartFilteringesunmecanismo dentrode losdesencadenantesdebasede datos queminimizaelvolumendeprocesoquedebenrealizarelintermediariode integraciónyelconector.Porejemplo,siunaaplicaciónha actualizado15vecesel objeto comercialContratodesdelaúltimavezqueelconector comprobóla existenciade sucesos,SmartFilteringguardaesoscambios comounúnicosuceso deActualizar.
Manejo
de
conexiones
perdidas
de
base
de
datos
Existen muchasrazonesparaperderuna conexióndebase dedatos.Siseproduce estapérdida,elconector concluyesuejecución.LaespecificaciónJDBCno
proporcionaunmecanismoparadetectar conexionesperdidas.Debidoa queel conector puedetrabajarconbasesde datosdiferentes,noexisteuna única definicióndecódigodeerrorparaunaconexiónperdidaconuna basededatos. SeutilizalapropiedadPingQuery paragestionarestadetección.Si seproduceun errordurante unapeticióndellamadadeservicio,elconectorejecutaPingQuery paraverificar queelerrornosedebióauna conexiónperdidaconunabasede datos.SilaoperaciónPingQueryfallaylapropiedadAutoCommittieneelvalor ″false″, elconector intentarácrearunanuevaconexiónconlabasede datos.Si el conector lograestableceruna nuevaconexiónconlabase dedatos,continuaráel proceso;encasocontrario,elconector devuelveelcódigoderetorno
APPRESPONSETIMEOUT,quehacequeconcluya laejecución delconector. SeejecutaPingQuery siseproduceunerroralaccedera unabasededatospara cualquier tipodetransacción. Porejemplo:
v Alaccederalastablasde sucesosydearchivado
v Alrecuperarelobjetocomercialqueestáasociadoalsuceso v Alcrearo actualizarunregistrorelativoa unobjetocomercial
Proceso
de
datos
dependientes
del
entorno
local
Elconectorsehainternacionalizadoparaquepuedatrabajarconjuegosde caracteres dedoblebyteyemitirmensajesenelidiomaespecificado.Cuandoel conector transfieredatosdesdeuna ubicacióna otraquehaceusodeunjuegode códigos decaracteresdiferentequelaubicacióndeorigen,elconectorrealizauna conversióndecaracteres parapreservarelsignificadodelosdatos.
ElentornodeejecuciónJava(TM)delaMáquinaVirtualJava (JavaVirtualMachine, JVM)representa losdatosutilizandoeljuegodecódigos decaracteresUnicode. Unicodecontienecodificacionesde caracteresparalamayoríade juegosde códigos de caracteresconocidos(tanto deunsólobytecomode variosbytes).Lamayoría de loscomponentesdelsistemaWebSphereBusinessIntegrationestánescritosen Java. Portanto,paralamayoríadeloscomponentesdelsistemaWebSphere
Business Integration,nohaynecesidadderealizarunaconversióndecaracteres cuando setransfierendatosentreloscomponentes.
Pararegistrarmensajesde errore informativosutilizandoelidiomaadecuadoy paraelpaísoterritorioapropiado,configurelapropiedaddeconfiguración estándar Localeparasu entorno.Paraobtenermásinformaciónsobreestas
propiedades, consulteelApéndiceA,“Propiedadesdeconfiguración estándarpara conectores”,enlapágina101.
Nota: Parahabilitarjuegosdecódigos decaracteresdiferentes, consultela documentaciónde Manugistics.
Capítulo
2.
Instalación
y
configuración
del
conector
Estecapítulodescribelainstalaciónyconfiguración deIBM WebSphereBusiness IntegrationAdapter forManugisticsy laconfiguracióndeaplicacionespara trabajarconelconector.Estecapítulocontienelas seccionessiguientes: v “Entornodeladaptador”
v “Prerrequisitos”enlapágina10
v “Estructurade archivosinstalada”enlapágina11
v “HabilitacióndeManugisticsparaelconector”enlapágina 13 v “Habilitacióndelsoporteparavarioscontroladores”enlapágina17
v “Habilitacióndelaclasegestorapersonalizadadeobjetoscomerciales”enla página17
v “Configuracióndelconector”enlapágina18
v “Creacióndevariasinstancias deunconector”enlapágina32 v “Iniciodelconector”enlapágina 33
Entorno
del
adaptador
Antesdeinstalar, configuraryutilizareladaptador,debeconocerlosrequisitosdel adaptadorreferentesalentorno.Estosrequisitosestánlistadosenlasección
siguiente.
v “Compatibilidadconelintermediario” v “Plataformasdeladaptador”enlapágina10 v “Dependenciasdeladaptador”enlapágina10 v “Globalización”enlapágina10
Compatibilidad
con
el
intermediario
Lainfraestructuradeadaptadorutilizadaporunadaptadordebeser compatible conlaversióndelintermediario(ointermediarios) deintegraciónconloscualesse comunica eladaptador.Lainfraestructuradeladaptadorseinstalaalinstalarel intermediariode integraciónoalinstalareladaptador, dependiendodel intermediariode integraciónqueseutilice.Laversión 1.1.xdeAdapter for Manugisticssepuedeutilizarconlainfraestructuradeadaptadorylos intermediarios deintegraciónsiguientes:
v Infraestructuradeadaptador:
WebSphereBusiness IntegrationAdapterFramework,versiones2.3.1y2.4. v Intermediariosdeintegración:
-WebSphereInterChangeServer,versiones4.1.1,4.2, 4.2.1y4.2.2 -WebSphereMQIntegrator,versión2.1.0
-WebSphereMQIntegrator Broker,versión2.1.0
-WebSphereBusiness IntegrationMessageBroker,versión5.0
-WebSphereApplicationServer Enterprise,versión5.0.2,conWebSphere StudioApplicationDeveloperIntegrationEdition,versión5.0.1
Consulte lasNotasdereleaseparaconocer posiblesexcepciones.
ParaWebSphereInterChangeServer (ICS),consulteIBMWebSphere InterChangeServerSystemInstallationGuideforUNIXolacorrespondiente guíaparaWindows(forWindows).
Paraintermediariosdemensajesde WebSphere,consulteImplementing AdapterswithWebSphereMessageBrokers.
ParaWebSphereApplicationServer, consulteImplementingAdapterswith WebSphereApplicationServer.
Plataformas
del
adaptador
Eladaptadorsepuedeutilizarenlasplataformas siguientes: Sistemasoperativos: v AIX(R)5.1,AIX5.2 v Solaris8.0 v HPUX11i v Windows2000 Bases dedatos: v Oracle9i Softwaredeterceros:
v ManugisticsDemand andFulfillmentManagement,versión7.1. v ManugisticsNetWORKSCollaborate,versión7.2
Dependencias
del
adaptador
Si estáutilizandouna basededatosOracle,debeinstalarlasbibliotecasde OracleOCI.
Globalización
Eladaptadorestáhabilitado parajuegosdecaracteres dedoblebyte(DBCS)yestá traducido.
Prerrequisitos
Antesdeutilizarelconector,debeseguirestospasos:
v InstaleelAdapterDevelopmentKitsólosipiensa ampliaromodificar la funcionalidaddeladaptador.
Sielconector seejecutaenunamáquinadiferentequeelintermediariode integración,instaleelAdapter DevelopmentKitqueseacompatibleconla versióndelintermediariode integraciónqueestáutilizando.
v InstaleelcontroladorJDBC queseutilizará.
v Verifiquequesehayainstaladotodoelsoftwareespecíficodelproveedor, incluidoslosrequisitosreferentesalcontroladorJDBC.
Porejemplo,siestáutilizandoelcontroladorJDBC deTipo2paraunabase de datosOracle,debeinstalarlasbibliotecasde OracleOCI.
v Compruebelaexistenciadeunacuentadeusuario enlaaplicación. Elconectorprocesa datosdelasbasesdedatosManugisticsquesean
compatiblesconcontroladoresquecumplenlaespecificaciónJDBC.Paraqueel conectorproceselosdatosdelabasede datos,conlaquesecomunica
directamente,debeteneracceso auna cuentade usuarioya unacontraseñaque seaválidaparalaaplicación.Lacuentadeusuario debetenerlosprivilegios
necesariospararecuperar,insertar, actualizarysuprimirdatosde labase de datosdelaaplicación.Sitodavíanodisponedeunacuentaasí,debecrearuna. v Compruebeeljuegodecódigosdecaracteres delabasededatos conectada.
ElentornodeejecuciónJava delaMáquinaVirtualJava(JavaVirtualMachine, JVM)representalosdatosutilizandoeljuegode códigosdecaracteresUnicode. Unicodecontienecodificacionesde caracteresparalamayoríadejuegosde caracteresconocidos(tantode unsólobytecomode variosbytes).Comoel conectorestáescritoenJava,reconoce eljuegode códigosUnicode.
Instalación
del
adaptador
y
de
los
archivos
asociados
Paraobtener informaciónsobrelainstalaciónde losproductosdeladaptador WebSphereBusinessIntegration, consulteeldocumentoInstallationGuidefor WebSphereBusiness IntegrationAdapters,queseencuentraenelcentrode informacióndeWebSphereBusinessIntegrationAdapters, enelsitioWeb siguiente:
http://www.ibm.com/websphere/integration/wbiadapters/infocenter
Estructura
de
archivos
instalada
Lassubsecciones siguientesdescribenlaestructuradearchivosinstaladadel adaptadorenunsistemaUNIX oWindows.
Nota: Amenosqueseindiqueotra cosa,lasseccionesrestantesdeestecapítulo sonrelevantesparalainstalación deladaptadortantoenUNIXcomoen Windows.
Instalación
en
un
sistema
UNIX
Paraobtener instruccionessobrelainstalación deAdapter forManugisticsenun sistemaUNIX,consulteelmanualInstallationGuideforWebSphereBusiness Integration Adapters.
LaTabla2 enlapágina 12describelaestructura dearchivosUNIXutilizadaporel conector.
Tabla2.EstructuradearchivosUNIXinstaladaparaelconector
SubdirectoriodeDirProducto Descripción
connectors/Manugistics ContienelosarchivosBIA_Manugistics.jary start_Manugistics.shdelconector.Elarchivo start_Manugistics.shesunscriptdeiniciodel sistemautilizadoporelconector.Estescriptse invocadesdeelscriptdelgestordeconectores genéricos.CuandoelusuarioseleccionaInstalar,en elConfiguradordeconectores(WebSphereMQ IntegratorBrokercomointermediariodeintegración )oenlapantallaConfiguracióndeconectoresdel Gestordelsistema(InterChangeServercomo intermediariodeintegración),elprogramade instalacióndeIBMWebSphereBusinessIntegration Adaptercreaunreiniciadorpersonalizadoparaeste scriptdelgestordeconectores.Cuandouseel conectorconInterChangeServer,utiliceeste reiniciadorpersonalizadoparainiciarydetenerel conector.CuandouseelconectorconWebSphereMQ IntegratorBroker,utiliceestereiniciador
personalizadosolamenteparainiciarelconector. Utiliceelmandatomqsiremotestopadapterpara detenerelconector.
connectors/Manugistics/dependencies ContienelosscriptsdeSQLmedianteloscualesse creanlastablasdesucesos,lastablasdearchivadoy lastablasdeidentificadoresexclusivos.
connectors/messages ContieneelarchivoBIA_ManugisticsAdapter.txt. repository/Manugistics ContieneelarchivoBIA_CN_Manugistics.txt.
/lib ContieneelarchivoWBIA.jar
/bin ContieneelarchivoCWConnEnv.sh.
Paraobtener másinformaciónsobrelainstalacióndelcomponenteconector, consulte unadelasguías siguientes,enfuncióndelintermediariode integración queestéutilizando:
v SystemInstallationGuideforUNIX(cuandoseutilizaInterChangeServer como intermediariode integración)
v IBMWebSphereBusinessIntegrationAdaptersImplementationGuideforWebSphere
MQIntegratorBroker(cuandoseutilizaWebSphereMQIntegratorBrokercomo intermediariode integración)
Estructura
de
archivos
instalada
en
un
sistema
Windows
Paraobtener instruccionessobrelainstalación deAdapter forManugisticsenun sistemaWindows,consulte elmanualInstallationGuideforWebSphereBusiness Integration Adapters.LaTabla3describelaestructurade archivosWindows utilizadaporelconector.
Tabla3.EstructuradearchivosWindowsinstaladaparaelconector
SubdirectoriodeDirProducto Descripción
connectors\Manugistics ContienelosarchivosBIA_Manugistics.jary start_Manugistics.batdelconector.
connectors\Manugistics\dependencies ContienelosscriptsdeSQLmedianteloscualessecrean lastablasdesucesos,lastablasdearchivadoylastablas deidentificadoresexclusivos.
connectors\messages ContieneelarchivoBIA_ManugisticsAdapter.txt. repository\Manugistics ContieneelarchivoBIA_CN_Manugistics.txt.
Tabla3.EstructuradearchivosWindowsinstaladaparaelconector (continuación)
SubdirectoriodeDirProducto Descripción
\lib ContieneelarchivoWBIA.jar
\bin ContieneelarchivoCWConnEnv.bat.
Elprogramadeinstalación añadeuniconoparaelarchivodelconectorenelmenú de IBMWebSphereBusinessIntegrationAdapters.Paradisponerdeuna forma rápida deiniciarelconector,creeunaccesodirectoparaestearchivo enel escritorio.
Paraobtener másinformaciónsobrelainstalacióndelcomponenteconector, consulte unadelasguías siguientes,enfuncióndelintermediariodeintegración queestéutilizando:
v SystemInstallationGuideforWindows(cuandoseutilizaInterChangeServercomo intermediariode integración)
v IBMWebSphereBusinessIntegrationAdaptersImplementationGuideforWebSphere
MQIntegratorBroker(cuando seutilizaWebSphereMQIntegratorBrokercomo intermediariode integración)
Habilitación
de
Manugistics
para
el
conector
Estaseccióntratalostemassiguientes:
v “ConfiguracióndelastablasdegeneracióndeinterfazdeManugistics” v “Configuracióndelprocesode sucesosydearchivado”enlapágina14 v “Tablasdesucesosyde archivado”enlapágina15
v “ScriptsdeSQLparainstalarlastablasdesucesosy dearchivado”enlapágina 15
v “Esquemadelastablasdesucesosy dearchivado”enlapágina 16
Configuración
de
las
tablas
de
generación
de
interfaz
de
Manugistics
Adapter forManugisticsseintegrará,utilizandoIGP(InterfaceGeneration Program)ysustablasdeinterfaz,conobjetoscomercialesde laconexiónJDBCy de WebSphereBusiness IntegrationAdaptersquecrean/actualizan/suprimeny recuperandatosdelabase dedatos.IGPesunprocesoenelqueseutilizantablas intermediasparapropagardatoshaciatablasactivasdebase dedatos,mediantela ejecución dediversosprocedimientosespecíficosdelaaplicación.
Paraquelaspeticionesdellamadadeserviciocreen yactualicenvaloresde datos enlabasede datos,eladaptadorutilizarálastablasdeinterfazdeIGPcomo ubicaciónintermediaparalosvalores. Esteprocesosupone colocardatosenlas tablasde interfaz,loscualesseprocesanmedianteprocedimientosalmacenadosy setrasladanatablasactivas.Estosprocedimientosalmacenadospermiten realizar comprobacionesde integridaddelosdatos.
NecesitaráejecutaryconfigurarIGP(InterfaceGenerationProgram)de
ManugisticsparacrearInserciones,ActualizacionesyActualizaciones/Inserciones paralosdatosdeseadosdelatabla deintegración.Consulte elmanualManugistics WebWorks Guideparaconocer detalles.
Debe configurarelmecanismodenotificación desucesosenlabasededatospara queelconectorpuedaprocesarlaentregadesucesos.Paraello,deberealizarestas tareas:
v Creelastablasde sucesosydearchivadoenlabasededatos.
v Instaledesencadenantesdebasede datosenlastablasdelaaplicaciónpara poderutilizarlosobjetoscomercialesnecesarios.Sesupone queelusuario desarrollasuspropiosdesencadenantesde basededatos.
v Opcionalmente,instaleuna tablacontador.Efectúeestepasosólosisolicitaal conectorquegenereunIDexclusivoalcrearunobjetocomercial.Paraobtener másinformaciónsobrelageneraciónde losIDexclusivos, consultelaexplicación sobreelparámetroUID=CW.uidcolumnname[=UseIfMissing].
Lasseccionesquesiguenproporcionaninformaciónsobrelacreacióny configuración delastablasde sucesosydearchivado.
Configuración
del
proceso
de
sucesos
y
de
archivado
Paraconfigurarelproceso desucesosydearchivado,debeutilizarpropiedadesde configuración paraespecificarlainformaciónsiguiente:
v Elnombrede latabla desucesos(EventTableName). Nonecesitaespecificarun valorparaestapropiedadsiutilizaelconectorsolamenteparaprocesar peticionesde objetoscomerciales.
v La frecuencia de intervalo (“PollFrequency” en la página 115). v Elnúmerodesucesosparacadaintervalode sondeo(PollQuantity). v Elnombrede latabla dearchivado(ArchiveTableName).
v Indicacióndesielconector archivalossucesosnosuscritosy noprocesados (ArchiveProcessed).Paraobtenerinformaciónsobrelasuscripciónquesea específicadelintermediariode integraciónutilizado,consultelaguíade implementacióndelintermediario.
v ElIDexclusivodelconector,elcualesimportantecuandovariosconectores sondeanlamismatabla(ConnectorID).
PuedetambiénespecificarunvalorparalapropiedadEventOrderByparaindicarel ordende lossucesosquesedebenprocesar.Paraobtenerinformaciónsobreestas y otraspropiedadesdeconfiguración,consulte elApéndiceA, “Propiedadesde configuración estándarparaconectores”,enlapágina 101ylaTabla6 enlapágina 19.
Nota: Lacreaciónde lastablasdesucesosyde archivadoesopcional.Sin embargo,siespecificaunvalor paraEventTableName,peronoutilizael conectorparasondearsucesosynocreaunatabla desucesos,seproduceun tiempodeesperaexcedidoparaelconector.Paraevitarestetiempode esperaexcedido,establezca elvalorde EventTableNameennull(comoserie decaracteres).
Por omisión,elnombrede latabla decoladesucesosesxworlds_events,yel nombre delatablade coladearchivado esxworlds_archive_events.
Parautilizarelconectorsolamenteparaelprocesodepeticiones,utilicelaopción -fnoaliniciarelconector yestablezcaelvalordeEventTableNameennull(como seriede caracteres).
Si elcontroladorutilizado noescompatibleconlaclaseJavaDatabaseMetaData,y nodesea queelconectorcompruebelaexistenciadetablasdesucesos yde
archivado,inhabilitelapropiedadCheckForEventTableInInitestableciendosuvalor enfalse.Por omisión,suvalorestrue.Noesrecomendableestablecerelvaloren false.
Nota: Sisusitio noarchivará sucesosenlatabla dearchivado,establezcaelvalor deArchiveProcessedenfalse.
Tablas
de
sucesos
y
de
archivado
Elconectorutilizalatablade sucesosparaponerencolasucesosquesedeben registrar.Sihaestablecidoelvalorde lapropiedadArchiveProcesseden″true″o noespecificaningúnvalor,elconectorutilizalatablade archivadoparaalmacenar sucesosdespués deactualizarsuestado enlatabla desucesos.
Paracadasuceso,elconectorobtieneelnombredelobjeto comercial,elverboy la clave contenidosenlatabla desucesos.Elconectorutilizaestainformaciónpara recuperarlaentidadcompletadelaaplicación.Silaentidadseha cambiado después deregistrarelsucesoporprimeravez,elconectorobtieneelsucesoinicial y todosloscambios subsiguientes.Esdecir,siunaentidadsecreay actualizaantes de queelconectorlaobtengadelatablade sucesos,elconectorobtieneambos cambios dedatosenelintervaloindividual.
Sonposibleslostresresultadossiguientesparacadasucesoprocesadoporun conector:
v Elsucesoseprocesóconéxito v Elsucesonoseprocesóconéxito
v Elsucesonosesuscribió (paraobtener informaciónsobrelasuscripciónquesea específicadelintermediariodeintegraciónutilizado,consultelaguíade
implementacióndelintermediario)
Si lossucesos nosesuprimendelatabladesucesos despuésdeserrecogidospor elconector,malgastanespacioenlatabla.Perosisesuprimen, lossucesosno procesados sepierdeny noesposiblehacerunanálisis retrospectivodelproceso de lossucesos.Portanto,esrecomendablequetambiéncreeunatabla de
archivado ymantengaasignadoelvalor ″true″alapropiedadArchiveProcessed. Cadavezquesesuprimeunsucesodelatablade sucesos,primero elconector lo insertaenlatablade archivado.
Nota: Siseproducenproblemasalaccederalabasede datosdelaaplicaciónque impidenqueelconectorsuprima unsucesodelatabla desucesosoinserte unsucesoenlatablade archivado,elconectordevuelveelcódigode retornoAPPRESPONSETIMEOUT.
Scripts
de
SQL
para
instalar
las
tablas
de
sucesos
y
de
archivado
Estosscripts seproporcionansólocomomodeloparaayudarlea crearlas tablas necesariasparaelconector.Paraotrasbasesdedatos,creesusscriptsutilizando como guíaestosscriptsproporcionados.
Losscripts parainstalarlastablasdesucesos,dearchivadoy deidentificadores exclusivosparaunabasede datosOracleson:
v event_table_oracle.sql v event_package_oracle.sql
v uid_table_oracle.sql
Estosarchivosestánsituadosenlosdirectoriossiguientes: UNIX:
connectors/Manugistics/dependencies/
Windows:
connectors\Manugistics\dependencies\
Nota: Elordeny tipodedatosenlascolumnasde lastablasesmuyimportante. Consulte“Esquemade lastablasdesucesosyde archivado”paraverel ordenytipocorrectos.
Es recomendablequeeladministradorde basesdedatoso lapersonaencargada de implementarelconectormodifiqueestosscriptsdeacuerdo conlosrequisitos específicos delainstalaciónylas necesidadesde optimizaciónde lasconsultas.Por ejemplo, estosscriptsnocreaníndicesenlastablas.Lapersonaencargadade implementar elconector debecrearíndicesparamejorarelrendimientoconel optimizador deconsultas.
Esquema
de
las
tablas
de
sucesos
y
de
archivado
LaTabla4 describelascolumnasdelastablasdesucesosy dearchivado. Tabla4.Esquemadelastablasdesucesosydearchivado
Nombre Descripción Tipo Restricción
id_suceso Identificadorinternodelsuceso NUMBER Claveprimaria id_conector IDexclusivodelconectorparaelcualestá
destinadoelsuceso.Estevaloresimportante cuandovariosconectoressondeanlamismatabla.
VARCHAR
clave_objeto Claveprimariadelobjetocomercial.Laclavese puederepresentarenformadeunpar
nombre_valor,ocomounconjuntodeclaves delimitadasporunsignodedospuntosuotro delimitadorconfigurable(porejemplo,
1000065:10056:2333).Consultelaexplicacióndela propiedad“EventKeyDel”enlapágina24para obtenermásinformación.
VARCHAR Nonull
nombre_objeto Nombredelobjetocomercial VARCHAR Nonull verbo_objeto Verboasociadoalsuceso VARCHAR Nonull prioridad_suceso Prioridaddelsuceso(0eslamásalta,neslamás
baja),queelconectorutilizaparaobtenersucesos enfuncióndelaprioridad.Elconectornoutiliza estevalorparaaumentarodisminuirprioridades.
NUMBER Nonull
tiempo_suceso Fechayhoraenqueseprodujoelsuceso DATETIME Fecha/horaactual poromisión(parala tabladearchivado,la horarealdelsuceso) tiempo_archivado Fechayhoraenquesearchivóelsuceso(sólo
aplicablealatabladearchivado)
DATETIME Fecha/horade archivado estado_suceso -2(Erroralenviarsucesoalintermediariode
integración)
NUMBER Nonull -1(Erroralprocesarsuceso)
0(Preparadoparasondeo)
Tabla4.Esquemadelastablasdesucesosydearchivado (continuación)
Nombre Descripción Tipo Restricción
2(Noexistensuscripcionesparaelobjeto comercial)
3(Enproceso).Esteestadosóloseutilizaenla tabladesucesos;noseutilizaenlatablade archivado.
comentario_suceso Descripcióndelsucesouerror VARCHAR
Habilitación
del
soporte
para
varios
controladores
Puedeespecificarelcontroladorsiguiendoestospasos: 1. Instaleelcontroladorensumáquina.
2. Coloqueenelsubdirectorioconnectors/Manugisticsdeldirectoriodel producto, todaslasbibliotecasdinámicasqueelconectornecesitadurantela ejecución.
3. Editeelarchivo deiniciodelconector paraincluir enlavariable
JDBCDRIVERPATHtodaslasvíasdeaccesode clasespertinentes(incluidala informaciónsobrelicencias,siesnecesario).
EnUNIX,elarchivo deinicioes:
DirProducto/connectors/Manugistics/start_Manugistics.sh
EnWindows,elarchivodeinicioes:
DirProducto\connectors\Manugistics\start_Manugistics.bat
4. Especifiqueunvalor paralapropiedad deconfiguraciónJDBCDriverClass. Nota: Paratodaslascaracterísticasconlasqueescompatible,elconector
puedetrabajarconcualquiercontroladorquecumplalaespecificación JDBC2.0osuperior.Sielcontroladornopuedeutilizaruna característica determinada,elconectornofuncionadebidamente.Porejemplo, siel controladornopuedeutilizartodaslasllamadasdemétodoutilizadas porODAforManugistics,elarchivodeanotaciones cronológicasde ODAdenotaelprocesoqueelcontroladornopuedeutilizar.Enesecaso, debeutilizaruncontroladordiferente.
Habilitación
de
la
clase
gestora
personalizada
de
objetos
comerciales
Elconectorescompatibleconlaclasegestorapersonalizadadeobjetoscomerciales, CustomBOH.EstaclaseimplementalainterfazJDBCBOhandlerInterface.Lasintaxis de estainterfazes:
public interface JDBCBOhandlerInterface{
public int doVerbForCustom(CWConnectorBusObj busObj) throws VerbProcessingFailedException, ConnectionFailureException; }
Cuando implementeelmétododoVerbForCustom,asegúresedequeemitalasdos excepciones,peroquenolasreciba.Definatambiénelestadoyelmensajedecada excepciónantesdeemitirla.
v VerbProcessingFailedException—Seemitecuando fallalaoperación especificadaporelverbo.
v ConnectionFailureException—Seemitecuandoelconectornopuedeestablecer conexiónconlaaplicación.
v EspecifiqueelnombredeclaseCustomBOH enlainformaciónsobreelverboque esespecíficade laaplicación.
Elconectorbuscaenesainformaciónparaobtenerelnombre delaclasegestora personalizadadeobjetoscomerciales.Utilice estasintaxis:
CustomBOH=nombreClaseGestoraPersonalizadaObjetosCom
Porejemplo,supongaquelainformaciónsobreelverboqueesespecíficade la aplicaciónestáespecificadade estamanera:
CustomBOH=JDBCBOhandlerForOverrideSQL
Enestecaso,JDBCBOhandlerForOverrideSQLeselnombre delaclasegestora personalizadadeobjetoscomerciales.
v Asegúresede queCustomBOH pertenecea com.crossworlds.connectors.JDBC Sielconector encuentra“CustomBOH=“enlainformaciónsobreelverboespecífica delaaplicaciónyencuentralaclaseenelpaquete
com.crossworlds.connectors.JDBC,elconectorejecutaelgestorpersonalizadode objetoscomerciales.SielconectornoencuentraCustomBOH,emiteunerrorpara indicarquenopudoencontrarlaclase.
Configuración
del
conector
Debe definirlaspropiedadesdeconfiguración delconector antesde ejecutarlo, tanto laspropiedadesestándarcomo lasespecíficasdelconector.Utilicela herramientaConfiguradorde conectoresparadefinirlaspropiedadesde configuración deunconector:
v SielintermediariodeintegraciónesInterChangeServer,accedaa esa herramientadesdeelGestordelsistema.
v SielintermediariodeintegraciónesWebSphereMQIntegrator Broker,accedaa esaherramientadesdelacarpetadelprogramaIBMWebSphereBusiness IntegrationAdapter.
Paraobtener másinformaciónsobreelConfiguradorde conectores,consulteel ApéndiceB,“Configuradordeconectores”,enlapágina121.
Propiedades
de
configuración
estándar
Laspropiedadesdeconfiguración estándarproporcionaninformaciónque utilizadan todoslosconectores. ConsulteelApéndiceA, “Propiedadesde
configuración estándarparaconectores”,enlapágina 101paraobtenerinformación detallada sobreestaspropiedades.
Importante: ComoelconectorparaproductosJDBCpuedetrabajarconambos intermediariosde integración,InterChangeServery WebSphereMQ Integrator Broker,laspropiedadesde configuracióndeambos intermediariosson relevantesparaelconector.
Además,consultelaTabla5 paraobtenerinformacióndeconfiguración específica delproductoIBMWebSphereBusinessIntegrationAdapterforJDBC.La
informacióndeestatabla complementalainformacióndelapéndice. Tabla5.Informaciónsobrepropiedadesespecíficadelconector
Propiedades Notas
CharacterEncoding Esteconectornoutilizalapropiedad CharacterEncoding.
Tabla5.Informaciónsobrepropiedadesespecíficadelconector (continuación)
Propiedades Notas
Locale Comoelconectorsehainternacionalizado, sepuedecambiarelvalordelapropiedad Locale.
Nota: Sicomointermediarioutiliza WebSphereMQIntegratorBroker,debe utilizarelmismoentornolocal(locale)para eladaptador,elintermediarioylas
aplicaciones.
Tenga encuentaquedebeproporcionarunvalorparalapropiedadde configuración ApplicationNameantesdeejecutarelconector.
Propiedades
específicas
del
conector
Laspropiedadesdeconfiguración específicasdelconectorproporcionan informaciónqueelconectornecesitadurante laejecución.Laspropiedades
específicas delconector tambiénproporcionanunamaneradecambiarinformación estática ológicacontenidaenelconector,sintenerquevolveracodificary
reconstruirelconector.
LaTabla6 listalaspropiedadesdeconfiguración delconector quesonespecíficas de él.Consultelasseccionessiguientesparaobtener explicacionesdelas
propiedades.
Tabla6.Propiedadesdeconfiguraciónespecíficasdelconector
Nombre Valoresposibles Valorporomisión Obligatorio
ApplicationPassword Contraseñaparalacuentade usuariodelconector
Sí* ApplicationUserName Nombredelacuentadeusuario
delconector
Sí*
ArchiveProcessed trueofalse true No
ArchiveTableName Nombredelatabladelacolade archivado
xworlds_archive_events SísiArchive Processedestrue
AutoCommit trueofalse false No
CheckforEventTableInInit trueofalse true No ChildUpdatePhyDelete trueofalse false No
CloseDBConnection trueofalse false No
ConnectorID IDexclusivodelconector null No DatabaseURL Nombredelservidordebasesde
datos
Sí DateFormat Seriedecaracteresparadenotar
unafechayunahora
MM/dd/aaaa HH:mm:ss
No DriverConnectionProperties Propiedadesadicionalesdela
conexióndelcontroladorJDBC
No DriverSupportForLong trueofalse true No EventKeyDel Carácterocaracterespara
delimitarlascolumnasdeclave deobjetoenlatabladesucesos
punto y coma (;) No
EventOrderBy none, NombreColumna, NombreColumna, ...]
No
Tabla6.Propiedadesdeconfiguraciónespecíficasdelconector (continuación)
Nombre Valoresposibles Valorporomisión Obligatorio
EventTableName Nombredelatabladelacolade sucesos
xworlds_events Sí,siesnecesario elsondeodela tabladesucesos; null(comoserie decaracteres)siel sondeonoes necesario JDBCDriverClass nombredeclasedel
controlador
Sí MaximumDatabaseConnections Númerodeconexiones
simultáneasdebasededatos
5 Sí
PingQuery SELECT 1 FROM <nombre_tabla> No
PollQuantity Valoresentre1y500 1 No
PreserveUIDSeq trueofalse true No
QueryTimeOut Valorentero,expresadoen segundos
No RDBMS.initsession SentenciadeSQLmediantela
queseinicializacadasesiónde basededatos
No
RDBMSVendor Oracle,Others Sí
ReplaceAllStr trueofalse false No
ReplaceStrList Conjuntoformadoporun carácterindividual,un delimitadordecaracteresyla seriedecaracteresde sustitucióndelcarácter. También,variosconjuntosasí conundelimitadorde terminaciónentreellos.
Q,DSQNota:enla herramientade configuraciónde
conectores,estoscaracteres representanunacomilla simple,seguidadeuna comaydoscomillas simples.
No
RetryCountAndInterval Cuenta,intervaloensegundos 3,20 No
ReturnDummyBOForSP trueofalse false No
SchemaName Esquemaenelqueresidenlos sucesos
No SelectiveCommitForPoll trueofalse false No SPBeforePollCall Nombredelprocedimiento
almacenadoquesedebe ejecutarparacadallamadade sondeo
No
StrDelimiter Delimitadoresdecaracteresy determinaciónutilizadosen lapropiedadReplaceStrList
,: No
TimingStats 0,1,2 0 No
UniqueIDTableName Nombredelatablautilizadapara crearlosID
xworlds_uid No
UseDefaults trueofalse false Sí
UseDefaultsForCreatingChildBOs trueofalse false No UseDefaultsWhenPolling trueofalse true No
*NoesnecesarioutilizarApplicationPasswordniApplicationUserNamesise utilizalaautenticaciónfiable.
ApplicationPassword
Contraseña paralacuentade usuariodelconector. Noexistevalorporomisión.
ApplicationUserName
Nombrede lacuentade usuariodelconector. Noexistevalorporomisión.
ArchiveProcessed
Especifica sielconectorarchivasucesosparaloscualesnoexisten suscripciones actuales.
Asigneelvalor trueaestapropiedadsideseaquelossucesosseinsertenenla tabla dearchivadoantesdeser suprimidosde latabladesucesos.
Asigneelvalor falsea estapropiedadsidesea queelconectornorealiceel proceso dearchivado.Enestecaso,elconectornocompruebaelvalor dela propiedad ArchiveTableName.SiArchiveProcessedtieneelvalorfalse,elconector realizaestas acciones:
v Sielsucesoseprocesasatisfactoriamente,elconectorlosuprimede latablade sucesosynoloarchiva.
v Sielconector nosesuscribealobjetocomercialdelsuceso, elconector dejael sucesoenlatablade sucesosycambia suestadoa Unsubscribed.Paraobtener informaciónsobrelasuscripciónqueseaespecíficadelintermediariode integraciónutilizado,consulte laguía deimplementacióndelintermediario. v Sielobjetocomercialencuentraunproblemamientrasseprocesa, elconector
dejaelsucesoenlatablade sucesosyelestado delsucesoseestablece enError. Si elvalorde estapropiedadseestablece enfalseyelvolumendesondeo
(PollQuantity) esbajo,elconectorpareceestarsondeandolatablade sucesos,pero enrealidadestásimplementecaptandolosmismossucesos repetidamente.
Si estapropiedad notiene ningúnvalorasignado,elconectorconsideraqueel valor estrue.SilapropiedadArchiveTableNametampocotieneningúnvalor asignado,elconectorconsideraqueelnombredelatabla dearchivadoes xworlds_archive_events.
Elvalorporomisión estrue.
ArchiveTableName
Nombrede latabla delacoladearchivado.
Si elvalorde lapropiedadArchiveProcessedestáestablecidoenfalse,noes necesarioespecificarunvalor paralapropiedadArchiveTableName.
Elnombreporomisiónesxworlds_archive_events.
AutoCommit
EstapropiedadpermiteconfigurarelvalordeAutoCommit.Cuandoelvalores true,todaslastransaccionesseconfirmanautomáticamente.Algunasbasesde datos(tales comoSybase)necesitan queAutoCommitseestablezcaentrue.Si se establece enfalse,losprocedimientosalmacenadosdeSybase fallarán.
