CHAPTER TWO: DATA, METHODS, AND MEASUREMENT

utilizando

IBM

ODA

for

Manugistics

EstecapítulodescribeIBMODAforManugistics, unagentededescubrimiento de objetos(ObjectDiscoveryAgent,ODA),quecreadefinicionesde objetos

comerciales paraelconectorde JDBC.Debidoa queelconectortrabajaconobjetos queestánbasadosentablaso envistas,ODAforManugisticsutilizatablasdebase de datos,vistas,procedimientosalmacenadosy sinónimos/apodosparadescubrir requisitosdeobjetoscomercialesquesonespecíficosdelafuentededatosJDBC delobjeto.

Nota: ParacomprendercómotrabajaODAforManugistics,puedeserútiltener conocimientossobreconceptosdebasesdedatosycontroladoresJDBC. Estecapítulocontienelasseccionessiguientes:

v _{“Instalación}_y _{utilización”}

v _{“Utilización}_de_ODA_for_Manugistics_en_el_Diseñador_de_objetos_{comerciales”}_en lapágina 79

v _“Contenido_de_la_definición_generada”_en_la_página ₈₉

v _“Archivo_de_definición_de_objeto_comercial_de_ejemplo”_en_la_página₉₂ v _{“Inserción}_de_atributos_que_contienen_objetos_comerciales_hijo”_en_la_página₉₃ v _“Adición_de_información_a _la_definición_de_objeto_comercial” _en_la_página ₉₃

Instalación

y

utilización

Estaseccióntratalostemassiguientes: v _{“Instalación}_de _ODA_for_{Manugistics”}

v _“Antes_de_utilizar_ODA_for_{Manugistics”}_en_la_página₇₆ v _“Inicio_de _ODA_for_{Manugistics”}_en_la_página₇₇

v _{“Ejecución}_de _varias_instancias_de_ODA_for_{Manugistics”}_en_la_página ₇₇ v _{“Utilización}_de_archivos_de_mensajes_error_y_de_rastreo”_en_la_página₇₈

Instalación

de

ODA

for

Manugistics

ParainstalarODAforManugistics,utiliceelprogramadeinstalación deIBM WebSphereBusinessIntegrationAdapter forManugistics.Sigalasinstrucciones contenidasenelmanual SystemInstallationGuideforUNIXoelmanual System InstallationGuideforWindows.Cuandofinaliza lainstalación, losarchivossiguientes estáninstaladoseneldirectoriodelsistemadondeinstalóelproducto:

v _{ODA\Manugistics\BIA_ManugisticsODA.jar} v _{ODA\messages\BIA_ManugisticsODAAgent.txt}

v _{ODA\messages\BIA_ManugisticsODAAgent_ll_TT.txt} _(archivos_de _mensajes específicosdeunidioma(ll) ydeunpaísoterritorio(TT).

v _{ODA\Manugistics\start_ManugisticsODA.bat}_(Windows_solamente) v _{ODA/Manugistics/start_ManugisticsODA.sh}_(UNIX _solamente) v _{bin\CWODAEnv.bat}_(Windows _solamente)

Nota: Amenosqueseindique otracosa,elpresentedocumentoutilizabarras inclinadasinvertidas(\)como conveniopararepresentarlasvíasdeacceso dedirectorios.ParalasinstalacionesenUNIX,utilicebarras inclinadas(/) enlugardebarras inclinadasinvertidas.Todaslasvíasde accesodel productoestánreferidasaldirectorio dondeestáinstaladoelproductoenel sistema.

Antes

de

utilizar

ODA

for

Manugistics

Antesdepoder ejecutarODAforManugistics,debeseguirestospasos:

1. InstaleelcontroladorJDBCapropiado.Sigalas instruccionescontenidasenel manualSystemInstallationGuideforUNIX oelmanualSystem InstallationGuide forWindows.

Importante: ODAforManugisticssepuedeconectara unabasede datos cualquierautilizandouncontrolador JDBCqueseacompatiblecon JDBC2.0oposterior.

2. DebidoaqueODAforManugisticscreanombresdeobjetoscomercialesy nombresdeatributosa partirde losnombresdelascorrespondientestablasy columnasdebasesdedatos,ydebido aqueesosnombresdeben estar

especificadosutilizandoISOLatin-1,compruebe queloscomponentesde base dedatosapropiadostengan nombresexpresadosmedianteLatin-1.Sinoesasí, tienelas opcionessiguientes:

v _Cree_manualmente_la_definición_del_objeto _comercial_en_el_Diseñador_de objetoscomerciales.

v _Edite_la_definición_creada_por_ODA_for_Manugistics_para_que_todos_los nombresdeobjetoscomercialesynombresdeatributosestén expresados utilizandoLatin-1.

3. AbraenlamodalidaddeediciónelshelldeUNIXoelarchivode procesopor lotesdeWindows yconfigurelosvaloresdescritosenlaTabla12.

Tabla12.Variablesdeconfiguracióndelshellydelarchivodeprocesoporlotes Variable Explicación Ejemplo

AGENTNAME _Nombre_del_ODA UNIX:AGENTNAME=ManugisticsODA

Windows:set AGENTNAME=ManugisticsODA AGENT Nombredelarchivo

jardelODA

UNIX:AGENT=$CROSSWORLDS/ODA/Manugistics/ BIA_ManugisticsODA.jar

Windows:set AGENT=

%CROSSWORLDS%\ODA\Manugistics\ BIA_ManugisticsODA.jar

DRIVERPATH _Vía_de_acceso_de_la bibliotecadel controladorJDBC; ODAforManugistics utilizalasclasesde controladorpara estableceruna conexiónconuna basededatos especificada. UNIX: DRIVERPATH=$CROSSWORLDS/lib/ \ xwutil.jar:$CROSSWORLDS/lib/ \ xwbase.jar:$CROSSWORLDS/lib/ \ xwsqlserver.jar:$CROSSWORLDS/lib/ \ spy/lib/spy.jar

Windows: set DRIVERPATH=%CROSSWORLDS%\ / lib\xwutil.jar;%CROSSWORLDS%\lib\ / xwbase.jar;%CROSSWORLDS%\lib\ / xwsqlserver.jar;%CROSSWORLDS%\lib\ / spy\lib\spy.jar

Tabla12.Variablesdeconfiguracióndelshellydelarchivodeprocesopor lotes (continuación)

Variable Explicación Ejemplo

DRIVERLIB Víadeaccesodelas bibliotecasnativas utilizadasporel controladorJDBC UNIX:DRIVERLIB=$CROSSWORLDS/lib/db2jdbc.so Windows: DRIVERLIB=%CROSSWORLDS%\bin\db2jdbc.dll

Despuésdeinstalarelcontrolador JDBCydefinirvaloresde configuraciónenel shello archivodeprocesoporlotes,debeseguirlospasossiguientesparacrear objetoscomerciales:

1. InicieelODA.

2. InicieelDiseñadordeobjetoscomerciales.

3. EnelDiseñadorde objetoscomerciales,sigaelprocesonecesariopara configuraryejecutarelODA.

Esteprocesoconstade seispasos,quesedescribencondetalleenlassecciones siguientes.

Inicio

de

ODA

for

Manugistics

PuedeiniciarODAforManugisticsconelscriptdeiniciocorrespondienteal sistemaoperativoqueutilice.

UNIX:

start_ManugisticsODA.sh

Windows:

start_ManugisticsODA.bat

Puedeconfigurary ejecutarODAforManugisticsutilizandoelDiseñadorde objetoscomerciales.ElDiseñadorde objetoscomercialeslocaliza cadaODAde acuerdo conelnombreespecificadoenlavariable AGENTNAMEdecadascripto archivo deprocesoporlotes.Elnombre deODAporomisión paraesteconectores ManugisticsODA.

Ejecución

de

varias

instancias

de

ODA

for

Manugistics

Es recomendablequecambieelnombredelODAcuandoejecutevariasinstancias de él.Paracrearinstanciasadicionalesde ODAforManugisticsconunnombre exclusivo:

v _Cree_un_script_o_archivo _de_proceso_por_lotes_separado_para_cada_instancia. v _Especifique_un_nombre_exclusivo_en_la_variable_AGENTNAME _de_cada_script_o

archivodeprocesopor lotes.

Si ejecutainstancias deODAenmáquinasdiferentes,esrecomendablequeacada nombre deODAantepongacomoprefijoelnombre delamáquinade sistema principal.

LaFigura6 enlapágina 80muestralaventanadelDiseñadordeobjetos comerciales desdelaqueseleccionaelODAparaejecutar.

Utilización

de

archivos

de

mensajes

error

y

de

rastreo

Losarchivosdemensajesdeerrory derastreo(elarchivoporomisión es BIA_ManugisticsODAAgent.txt)estánsituadosen\ODA\messages\,dentrodel directorio delproducto.Estosarchivosutilizanelconveniodedenominación siguiente:

nombreAgenteAgent.txt

Si creavariasinstanciasdelscriptoarchivode procesoporlotesdeODAy

proporcionaunnombreexclusivo paracadaODArepresentado, puededisponerde unarchivo demensajesparacadainstanciade ODA.Como alternativa,puede tenervariosODAconnombresdiferentesqueutilizanelmismo archivode mensajes.Existendosmanerasde especificarunarchivo demensajesválido: v _Si_cambia_el_nombre_de_un_ODA_y_no_crea_un_archivo_de _mensajes_para_él,_debe

cambiarelnombredelarchivo demensajesenelDiseñadorde objetos comercialescomopartede laconfiguracióndeODA.ElDiseñadorde objetos comercialesproporcionaunnombreparaelarchivo demensajes,peronocrea realmenteelarchivo.Sielarchivomostrado comopartede laconfiguración de ODAnoexiste,cambieelvalorparaquehagareferenciaa unarchivoexistente. v _Puede_copiar_el_archivo _de_mensajes_existente_para_un_ODA_determinado,_y

modificarlosegúnseanecesario.ElDiseñadordeobjetoscomercialesdapor supuestoqueelusuarioasignaunnombre acadaarchivode acuerdoconel conveniodedenominación.Porejemplo,silavariableAGENTNAMEespecifica ManugisticsODA1,laherramientasupone queelnombredelarchivodemensajes asociadoesManugisticsODA1Agent.txt.Portanto,cuandoelDiseñadorde objetoscomercialesproporcionaelnombredearchivo confinesdeverificación comopartede laconfiguración deODA,elnombre dearchivoestábasadoenel nombredeODA.Verifiquequeelarchivo demensajesporomisióntiene el nombrecorrectoycorríjalo sifueranecesario.

Importante: Sinoespecificacorrectamenteelnombredelarchivo demensajes cuandoconfiguraelODA,elODAseejecutará sinemitirmensajes. Paraobtenermásinformaciónsobrelaespecificación delnombredel archivo demensajes,consulte“Configurarpropiedadesde

inicialización”enlapágina80.

Duranteelprocesodeconfiguración,debeespecificar:

v _El_nombre_del_archivo_en_el_que_ODA_for_Manugistics_escribe_información_sobre erroresyderastreo.

v _El_nivel_de_rastreo, _que_está_comprendido _entre₀ _y_5.

LaTabla13describeestosvalores. Tabla13.Nivelesderastreo

Nivelderastreo Descripción

0 Registratodosloserrores

1 Rastreatodoslosmensajesentrantesysalientesemitidosparaelmétodo 2 RastrealaspropiedadesdeODAysusvalores

3 Rastrealosnombresdetodoslosobjetoscomerciales 4 Rastreadetallesdetodaslashebrasiniciadas

Tabla13.Nivelesderastreo (continuación) Nivelderastreo Descripción

5 v_Indica_los_valores_de_{inicialización}_del_ODA_para_todas_las_propiedades deéste

v_Rastrea_un_estado_detallado_de_cada_hebra_iniciada_por_ODA_for Manugistics

v_Rastrea_el_vuelco_de_la_definición_de_objeto_comercial

Paraobtener informaciónsobredóndeconfigurarestosvalores,consulte “Configurarpropiedadesdeinicialización”enlapágina80.

Utilización

de

ODA

for

Manugistics

en

el

Diseñador

de

objetos

comerciales

EstaseccióndescribecómoutilizarODAfor ManugisticsenelDiseñadorde objetoscomercialesparacreardefinicionesdeobjetoscomerciales.Paraobtener informaciónsobreeliniciodelDiseñadorde objetoscomerciales,consulteel manual BusinessObjectDevelopmentGuide. Puededescargarestemanualdesdeel centro deinformacióndeIBMWebSphereBusinessIntegrationAdapters:

http://www.ibm.com/websphere/integration/wbiadapters/infocenter

DespuésdeiniciarunODA,debeiniciarelDiseñadordeobjetoscomercialespara configuraryejecutarelODA.Deberealizarseispasos enelDiseñadordeobjetos comerciales paracrearuna definicióndeobjeto comercialutilizandounODA.El Diseñadorde objetoscomercialesproporcionaunasistenteparaguiaralusuarioen laejecución deesospasos.

DespuésdeiniciarelODA,realicelosiguienteparainiciarelasistente: 1. AbraelDiseñadordeobjetoscomerciales.

2. EnelmenúArchivo,seleccioneelsubmenúNuevo utilizandoODA....

ElDiseñadorde objetoscomercialesmostrará laprimeraventanadelasistente, denominadaSeleccionaragente. LaFigura6 enlapágina80muestraesta ventana.

Paraseleccionar,configurary ejecutarelODA,sigaestospasos: 1. “SeleccionarelODA”

2. “Configurarpropiedadesdeinicialización”enlapágina80

3. “Expandirnodosyseleccionarobjetosde basededatos”enlapágina 82 4. “Confirmarlasseleccionesdeobjetosdebase dedatos”enlapágina84 5. “Generardefiniciones”enlapágina85y,opcionalmente,“Proporcionar

informaciónadicional”enlapágina85 6. “Guardardefiniciones”enlapágina89

Seleccionar

el

ODA

LaFigura6 muestraelprimerrecuadrodediálogoquesevisualizaenelasistente de seispasosdelDiseñadordeobjetoscomerciales.Desde estaventana,seleccione elODAparaejecutar.

ParaseleccionarelODA:

1. PulseelbotónBuscaragentes(Findagents)paravisualizarenelcampo AgenteslocalizadostodoslosODAregistradosoqueestánenejecución actualmente.

Nota: SielDiseñadorde objetoscomercialesnolocalizaelODAdeseado, compruebelaconfiguracióndelODA.

2. SeleccioneelODAdeseadoenlalista mostrada.

ElDiseñadordeobjetoscomercialesmostrará enelcampoNombredelagente (Agent’sname)laselecciónhechaporelusuario.

3. PulseSiguiente(Next).

Configurar

propiedades

de

inicialización

Cuando elDiseñadordeobjetoscomercialessecomunica porprimeravezcon ODAforManugistics,solicitaalusuario queespecifiqueunconjuntode

propiedadesdeinicialización, talcomomuestralaFigura7. Puedeguardarestas propiedadesenunperfildesignadoporunnombreparaquenotengaque especificarlas denuevocadavezqueutiliceODAforManugistics.Paraobtener informaciónsobrelaespecificacióndeunperfilde ODA,consulte elmanual

Business ObjectDevelopmentGuide.

Configurelas propiedadesdeODAforManugisticsdescritas enlaTabla14. Tabla14.PropiedadesdeODAforManugistics

Númerode

fila Nombredepropiedad

Tipode

propiedad Descripción

1 UserName String Nombredelusuarioconautorizaciónparaconectarconla basededatos

2 Password String Contraseñadelusuarioconautorizaciónparaconectarcon labasededatos

3 DatabaseUrl _String _URL_que_permite_establecer_una_conexión_con_la_base_de datos.Porejemplo:

jdbc:oracle:thin:@MACHINENAME:1521:SIDNAME 4 DatabaseDriver String Nombredelcontroladorutilizadoparaestablecerla

conexión.Porejemplo:oracle.jdbc.driver.OracleDriver 5 DefaultBOPrefix String Textoqueseañadecomoprefijoalnombredelobjeto

comercialparaqueseaunnombreexclusivo.Sies necesario,puedecambiarestomástarde,cuandoel Diseñadordeobjetoscomercialeslesoliciteespecificarlas propiedadesdelobjetocomercial.Paraobtenermás información,consulte“Proporcionarinformación adicional”enlapágina85.

6 TraceFileName _String _Archivo_en_el_que_ODA_for_Manugistics_escribe

informaciónderastreo.Sielarchivonoexiste,ODAfor Manugisticslocreaeneldirectorio\ODA\Manugistics_._Si_el archivoyaexiste,ODAforManugisticsañadedatosal finaldelarchivo.ODAforManugisticsasignaunnombre alarchivodeacuerdoconelconveniodedenominación. Porejemplo,sielagentesedenominaManugisticsODA, ODAforManugisticscreaunarchivoderastreollamado ManugisticsODAtrace.txt.Utiliceestapropiedadpara especificarunnombrediferenteparaestearchivo. 7 TraceLevel _Integer _Nivel_de_rastreo_habilitado_para_ODA_for_Manugistics.

ConsultelaTabla13enlapágina78.

Tabla14.PropiedadesdeODAforManugistics (continuación) Númerode

fila Nombredepropiedad

Tipode

propiedad Descripción

8 MessageFile _String _Nombre_del_archivo_de_errores_y_de_mensajes._ODA_for Manugisticsmuestraelnombredearchivodeacuerdocon elconveniodedenominación.Porejemplo,sielagentese denominaManugisticsODA,elvalormostradoenla propiedadcorrespondientealarchivodemensajeses ManugisticsODAAgent.txt.Importante:elarchivode erroresydemensajesdebeestarsituadoeneldirectorio \ODA\messages.Utiliceestapropiedadparaverificaro especificarunarchivoexistente.

Importante

Corrijaelnombredelarchivodemensajessielvalorporomisiónmostrado enelDiseñadordeobjetoscomerciales representaunarchivoinexistente.Siel nombre noescorrectocuandosalgade esterecuadrodediálogopara

continuar,elDiseñadorde objetoscomercialesmostrará unmensajedeerror enlaventanadesdelaqueseinicióelODA.Estemensajenoapareceenel Diseñadorde objetoscomerciales.Sinoespecificaunarchivode mensajes válido,elODAseejecutará sinemitirmensajes.

Expandir

nodos

y

seleccionar

objetos

de

base

de

datos

Despuésdequeelusuario haconfiguradotodaslaspropiedadesdeinicialización de ODAforManugistics,elDiseñadordeobjetoscomerciales seconectaalabase de datosespecificadaymuestraunárbolcontodoslosnombresde esquema existentesenlabasededatos.Estosnombres,quesepresentanenformadenodos delárbol,sepuedenexpandir.Pulsesobreellos paravisualizartodaslastablas, vistas,procedimientosalmacenadosy sinónimos/apodosde cadaesquema.La Figura8muestraesterecuadrodediálogoconalgúnesquemaexpandido.

Paraidentificartodoslosobjetosde basededatosqueguardandatosparala definicióndeobjetocomercialgenerada,seleccionetodaslastablas,vistas, procedimientosalmacenados ysinónimos/apodosnecesarios,ypulseNext (Siguiente).Paraobtenerinformaciónsobrecómo filtrarlosobjetosdevueltos, consulte elmanualBusiness ObjectDevelopmentGuide.

ElnombredeesquemaALLSCHEMASseutilizaparafacilitarlarecuperaciónde objetos, comotablasyvistasdebasesdedatos,quenotienenesquemasasociados a losobjetos.CuandoexpandeALLSCHEMAS, semuestraunárbolcontablas, vistas,procedimientosalmacenadosysinónimos/apodos.Cuandoseexpandecada unode estosnodos,aparecentodoslosobjetospertinentesde labasededatos, paracualquieraqueseaelesquemaalquepertenezcaelobjeto.

Confirmar

las

selecciones

de

objetos

de

base

de

datos

Despuésdequeelusuario haidentificadotodoslosobjetosde basededatosque sedebenasociar aladefinicióndeobjetocomercialgenerada,elDiseñadorde objetoscomercialesmuestraunrecuadrodediálogoconsolamentelastablas, vistas,procedimientosalmacenadosy sinónimos/apodosseleccionados. La Figura10muestraesterecuadrodediálogo.

Estaventanaproporcionalasopcionessiguientes: v _Para_confirmar_la_selección,_pulse_Siguiente_(Next).

v _Si_la_selección_no_es_correcta,_pulse_Atrás_(Back)_para_volver_a _la_ventana anteriory hacerloscambios necesarios.Cuandolaselecciónseacorrecta, pulse Siguiente(Next).

Generar

definiciones

Despuésdequeelusuario haconfirmadolosobjetosdebase dedatos,un recuadrode diálogoleinformadequeelDiseñadordeobjetoscomercialesestá creandolas definiciones.

Proporcionar

información

adicional

Si ODAforManugisticsnecesitainformaciónadicional,elDiseñadordeobjetos comerciales muestralaventanaPropiedadesdeobjetocomercial(BOProperties), quesolicitalainformaciónalusuario.

EnlaventanaPropiedadesdeobjetocomercial, escribaomodifiquelainformación siguiente:

v _Prefijo_(Prefix):_texto_que_se_añade_como_prefijo_al_nombre_del_objeto_comercial parahacerqueelnombre seaexclusivo.Siestásatisfechoconelvalorque especificóparalapropiedadDefaultBOPrefixenlaventanaConfiguraragente (Figura7),noesnecesarioquecambieelvalordeestecampo.

v _Verbos_(Verbs):_pulse_en_el_campo_Valor_y _seleccione_uno_o_más_verbos _en_el_menú emergente.Estossonlosverbosadmitidosporelobjetocomercial.

v _Añadir_{procedimiento}_almacenado_(Add_Stored_Procedure):_pulse_Sí_(Yes)_o _No_(No)_en elcampoValor:

– Si seleccionaSíypulsaAceptar, ODAforManugisticsmuestraunaventana conunalistade todoslosatributos deprocedimientoalmacenado.Seleccione losatributos deprocedimientoalmacenadoquedeseeañadiralobjeto comercial.

– Seleccione Noparaasegurarse dequenoseañadaningúnatributode procedimientoalmacenadoaladefinicióndeobjetocomercialcreada. Elvalor poromisiónesSí.

Nota: SiuncampodelrecuadrodediálogoPropiedadesdeobjetocomercial admitevariosvalores,elcampoapareceenblancocuandoseabrepor primeravezelrecuadrode diálogo.Pulseenelcampoparamostraruna listadesplegabledelosvaloresdelcampo.

Losatributosde procedimientoalmacenadoquesedeben añadiralobjeto

comercialsepuedeasociara unodelosprocedimientosalmacenadosexistentesen eseesquemadelabasede datos.Puedeseleccionarunprocedimientoalmacenado enunalista desplegablequemuestratodoslosprocedimientosalmacenadosdela base dedatospertenecientesa eseesquema,juntoa cadaatributode

procedimientoalmacenado.Estainformaciónproducirá lainformaciónespecífica de laaplicaciónnecesariaparaeseatributo.

Lainformaciónespecíficadelaaplicaciónparaelniveldeobjetotieneesteaspecto: TN=nombreTabla

Lainformaciónespecíficadelaaplicaciónparaelniveldeatributotieneeste aspecto: CN=nombreColumna

In document Food Insecurity, Social Inequality, and Social Policy (Page 31-43)