Professional Documents
Culture Documents
In-Application Support
Oracle User Productivity Kit In-Application Support Copyright 1998, 2012, Oracle y/o sus subsidiarias. Todos los derechos reservados. Oracle es marca comercial registrada de Oracle Corporation y/o sus subsidiarias. Todos los dems nombres pueden ser marcas comerciales de sus respectivos propietarios. Este software y la documentacin relacionada estn sujetos a un contrato de licencia que incluye restricciones de uso y revelacin, y se encuentran protegidos por la legislacin sobre la propiedad intelectual. A menos que figure explcitamente en el contrato de licencia o est permitido por la ley, no se podr utilizar, copiar, reproducir, traducir, emitir, modificar, conceder licencias, transmitir, distribuir, exhibir, representar, publicar ni mostrar ninguna parte, de ninguna forma, por ningn medio. Queda prohibida la ingeniera inversa, desensamblaje o descompilacin de este software, excepto en la medida en que sean necesarios para conseguir interoperabilidad segn lo especificado por la legislacin aplicable. La informacin contenida en este documento puede someterse a modificaciones sin previo aviso y no se garantiza que se encuentre exenta de errores. Si detecta algn error, le agradeceremos que nos lo comunique por escrito. Si este software o la documentacin relacionada se entrega al Gobierno de EE.UU. o a cualquier entidad que adquiera licencias en nombre del Gobierno de EE.UU. se aplicar la siguiente disposicin: U.S. GOVERNMENT RIGHTS Programs, software, databases, and related documentation and technical data delivered to U.S. Government customers are "commercial computer software" or "commercial technical data" pursuant to the applicable Federal Acquisition Regulation and agency-specific supplemental regulations. As such, the use, duplication, disclosure, modification, and adaptation shall be subject to the restrictions and license terms set forth in the applicable Government contract, and, to the extent applicable by the terms of the Government contract, the additional rights set forth in FAR 52.227-19, Commercial Computer Software License (December 2007). Oracle USA, Inc., 500 Oracle Parkway, Redwood City, CA 94065. Este software se ha desarrollado para uso general en diversas aplicaciones de gestin de la informacin. No se ha diseado ni est destinado para utilizarse en aplicaciones de riesgo inherente, incluidas las aplicaciones que pueden causar daos personales. Si utiliza este software en aplicaciones de riesgo, usted ser responsable de tomar todas las medidas apropiadas de prevencin de fallos, copia de seguridad, redundancia o de cualquier otro tipo para garantizar la seguridad en el uso de este software. Oracle Corporation y sus subsidiarias declinan toda responsabilidad derivada de los daos causados por el uso de este software en aplicaciones de riesgo. Este software y la documentacin pueden ofrecer acceso a contenidos, productos o servicios de terceros o informacin sobre los mismos. Ni Oracle Corporation ni sus subsidiarias sern responsables de ofrecer cualquier tipo de garanta sobre el contenido, los productos o los servicios de terceros y renuncian explcitamente a ello. Oracle Corporation y sus subsidiarias no se harn responsables de las prdidas, los costes o los daos en los que se incurra como consecuencia del acceso o el uso de contenidos, productos o servicios de terceros.
Contenido
1 Descripcin general de soporte en la aplicacin ................................... 1
1.1 Plan para distribuir la asistencia dentro de la aplicacin ..................................... 1 1.2 Configuracin de la aplicacin de destino y creacin de contenido ....................... 2
iii
Integracin del men Ayuda: este mtodo permite a los usuarios invocar contenido de soporte en la aplicacin sensible al contexto mediante el men Ayuda de la aplicacin de destino o el vnculo Ayuda. Ayuda Inteligente: botn de la barra de herramientas para navegadores que los usuarios finales pueden utilizar para acceder al contenido de soporte en la aplicacin sensible al contexto.
El mecanismo de ayuda contextual utilizado para las aplicaciones de destino se denomina ExactMatch. Esta tcnica permite al Reproductor mostrar una lista de contenidos relacionados con la actividad del usuario final en la aplicacin. La pertinencia de la lista de contenido se determina en funcin de determinados elementos de contenido que incluyen la misma informacin contextual registrada durante la creacin de contenido en Developer. El mecanismo de ayuda contextual para aplicaciones que no son de destino y se basan en navegador se denomina SmartMatch. Esta tcnica realiza anlisis estadsticos para clasificar el contenido ms probable y generar una lista de contenidos pertinentes. De este modo, es posible utilizar el botn de la barra de herramientas SmartHelp para distribuir asistencia contextual dentro de la aplicacin destinada a cualquier aplicacin basada en navegador. Por ltimo, incluso el contenido creado para aplicaciones que no son de destino, antes de la introduccin de la tecnologa SmartMatch, puede distribuirse por medio del botn SmartHelp de la barra de herramientas del navegador, pero no ser contextual. En este caso, el esquema muestra todos los elementos de contenido, aunque el usuario podra buscar los elementos adecuados, por medio de la funcin de bsqueda o examinando el esquema del contenido. Consulte el manual Distribucin de contenido para obtener ms informacin acerca de la distribucin de contenido del Reproductor.
Qu mecanismo de distribucin es el ms adecuado para la aplicacin del usuario: la integracin del men Ayuda en una aplicacin de destino o una distribucin basada en SmartHelp? Quines tienen que participar, qu deben hacer y cundo debe ocurrir?
Las respuestas a estas preguntas ofrecern la informacin necesaria para implantar correctamente la integracin del men Ayuda y la ayuda contextual. Las tareas siguientes deben completarse para distribuir correctamente asistencia dentro de la aplicacin.
Crea el contenido en el Desarrollador: aunque el contexto de muchas aplicaciones se captura de modo automtico, se recomienda comprobar dicha captura. Para realizar esta comprobacin, abra el tema en el Editor de temas y, a continuacin, abra el editor de ID de contexto. Si el campo Tipo muestra Coincidencia Inteligente o Coincidencia Exacta, significa que se ha capturado contexto. Si aparece Sin Coincidencia, no se captur contexto. Adems, mientras se graba un tema, aparece un icono en la Grabadora que indica el estado de reconocimiento del contexto. Publique el contenido. Proporciona al administrador del servidor web el contenido publicado.
Distribuye el contenido publicado a un servidor web. Proporciona la URL del contenido al administrador de la aplicacin y accede a ese directorio de modo que el administrador de la aplicacin pueda crear los archivos de configuracin necesarios.
Administrador de aplicaciones
Realiza los pasos de configuracin detallados en esta gua para cada aplicacin Recibe la URL del contenido suministrada por el administrador del servidor web Realice los pasos de integracin del men Ayuda para configurar la direccin URL, si procede.
Usuario de pruebas
Verifique que el contenido publicado aparece en la aplicacin, por medio de la opcin de integracin del men Ayuda o del botn de SmartHelp, segn el tipo de distribucin que se haya utilizado.
Si se trata de distribuir ayuda contextual, el usuario de prueba deber coordinar con el programador de contenido para tener en cuenta qu partes de la aplicacin se han utilizado para crear contenido y, luego, verificar que el contenido se abre con una lista adecuada de temas pertinentes.
Oracle E-Business Suite: requiere que se instalen los archivos de biblioteca en el servidor de aplicacin (servidor de formularios applcore) para poder grabar contenido. Consulte el apartado Implementar la integracin de ayuda sensible al contexto en Oracle E-Business Suite ms adelante en este mismo manual para obtener ms informacin sobre la instalacin de archivos de biblioteca para Oracle E-Business Suite. Nota: Oracle E-Business Suite 12.1.2 ya no necesita los archivos de biblioteca, pero se debe aadir un perfil en el formulario del perfil del sistema.
PeopleSoft Enterprise: se recomienda que estn instalados y configurados los PeopleBooks antes de comenzar a grabar contenido.
Si desea distribuir ayuda sensible al contexto, compruebe siempre que se ha capturado el contexto durante la grabacin. Consulte Reconocimiento de contexto en la Grabadora, en el captulo Grabar y editar contenido de tema, del manual Desarrollo de contenido, para obtener ms informacin sobre la captura de contexto durante la grabacin.
Obtenga el contenido en forma de paquete del Reproductor que un autor ha creado y publicado desde el Desarrollador. Configure el contenido con la utilidad de configuracin del Reproductor para soporte en la aplicacin con el fin de establecer las opciones de Ayuda Inteligente. Consulte Configurar Ayuda Inteligente. Distribuya el contenido en un servidor web.
Instale Ayuda Inteligente distribuyendo un vnculo o envindolo a los usuarios finales. Consulte Instalar Ayuda Inteligente para aplicaciones basadas en navegador.
Obtenga el contenido en forma de paquete del Reproductor que un autor ha creado y publicado desde el Desarrollador. Configure el contenido con la utilidad de configuracin del Reproductor para soporte en la aplicacin con el fin de establecer las opciones de integracin de la ayuda. Consulte Opciones de configuracin especficas de la aplicacin. Distribuya el contenido en un servidor Web. Integre la ayuda en la aplicacin de destino ajustando la configuracin de la aplicacin de destino para iniciar el contenido. Consulte el apartado correspondiente a su aplicacin en Integrar la ayuda en las aplicaciones de destino.
Cree y publique contenido: los autores utilizan Developer para crear y grabar contenido y, posteriormente, publicarlo en el formato del Reproductor. El resultado ser una estructura de carpetas, donde habr una subcarpeta denominada PlayerPackage. PlayerPackage es la carpeta que necesita. Comprar contenido: algunos proveedores de aplicaciones de empresa venden contenido ya preparado para sus aplicaciones, con el fin de ayudar a los clientes a comprender la funcionalidad de la aplicacin y las opciones de configuracin. Si compra contenido, debera recibir una carpeta PlayerPackage completa.
Nota: cuando se publica un paquete del reproductor, solo se incluyen las carpetas de aplicaciones de destino que se grabaron en el contenido. Cuando se inicia la utilidad, solo muestra los vnculos para configurar estas aplicaciones. Si desea configurar tambin otras aplicaciones de destino, puede copiar las carpetas de las otras aplicaciones de destino en el paquete del reproductor. Cuando la utilidad detecta las carpetas adicionales, muestra tambin los vnculos para esas aplicaciones. Todas las carpetas de aplicaciones de destino se almacenan en la biblioteca, en un paquete denominado hintconfig. Se encuentra en la misma ubicacin que todas las dems carpetas, es decir, /System/Publishing/In-Application Support/<brand>. A medida que se efectan modificaciones en las opciones de configuracin y se guardan, en la columna Actividad situada en la parte derecha de la pgina principal se va mostrando la informacin acerca de la fecha y hora del cambio, as como el nombre de la persona que lo realiz. Es posible aadir un nombre en el campo Me llamo, en la parte superior de la pgina. El nombre que se aada o seleccione en la lista desplegable aparecer en la columna Actividad y tambin en Notas. Puede aadir o cambiar su nombre en cualquier pgina. En la pgina de inicio tambin puede cambiar el idioma de la interfaz. Para iniciar la utilidad de configuracin del Reproductor para soporte en la aplicacin (localmente): 1. 2. Acceda a la carpeta donde se encuentra el paquete del Reproductor. Si utiliza Internet Explorer, ejecute el archivo inappconfig.cmd O bien Si utiliza Mozilla Firefox, ejecute el archivo inappconfig_ff.cmd. Notas de uso Es posible aadir notas a cada opcin o a la totalidad del el archivo de configuracin. Estas notas se guardan como comentarios en el archivo de configuracin. Las notas se pueden utilizar para aadir informacin, como, por ejemplo, sobre los motivos de una modificacin. Para aadir, editar o eliminar una nota: 1. 2. Inicie la Utilidad de configuracin y abra una pgina para una aplicacin. Para aadir una nota a un campo, haga clic en ese campo. O bien Para aadir una nota que afecte a todo el archivo de configuracin, haga clic en el cuadro Notas, en la parte superior de la pgina. 3. 4. Escriba el texto de la nota y haga clic en Aceptar. Para editar una nota, haga clic en el cuadro de texto correspondiente a la nota, realice las modificaciones y haga clic en Aceptar. Para eliminar una nota, haga clic en en la nota. en en la barra azul que aparece junto a
5.
Guardar el archivo de configuracin Si inicia la Utilidad de configuracin desde el archivo de comandos, el archivo de configuracin (odcustomurl.js) se guardar directamente en la carpeta adecuada, dentro de la carpeta de contenido de la unidad local. Nota: si no est seguro de que el archivo de configuracin se haya guardado correctamente, puede repetir la operacin de guardado. Aparecer la pgina Guardar configuracin, donde se
muestra la ubicacin en la que se ha guardado el archivo. Si es necesario, puede guardar el archivo de forma manual y, a continuacin, utilizar la opcin Comprobar para verificar que el archivo est en la ubicacin correcta. Para guardar el archivo de configuracin en el equipo local: 1. Haga clic en Guardar. Aparecer la pgina Comprobar configuracin, donde se muestra el nombre del archivo y la ubicacin donde se ha guardado.
Revertir la configuracin En la parte inferior de cada pgina de parmetros de configuracin, existe el botn Revertir. Esta opcin permite cambiar todos los parmetros de la pgina, para que sean los mismos que los de la ltima ocasin en que se guard la configuracin. Para revertir la configuracin: 1. Haga clic en Revertir.
Restablecer valores predeterminados Tambin puede restablecer la configuracin original de las opciones. En la parte inferior de cada pgina aparece el botn Restablecer valores predeterminados, que recupera los valores predeterminados originales de todas las opciones de la pgina. Para restablecer los valores predeterminados: 1. Para restablecer todos los campos de una pgina en sus valores predeterminados, haga clic en el botn Restablecer valores predeterminados, situado en la parte inferior de la pgina.
Por lo tanto, cuando se configura Ayuda Inteligente, siempre se debe especificar un idioma predeterminado para cada aplicacin. La pgina de configuracin de Ayuda Inteligente proporciona tres opciones:
Aplicacin: proporciona una lista de todas las aplicaciones admitidas. Elija el que sea apropiado para el contenido. Idioma: proporciona una lista de idiomas con cdigos regionales. Elija el que sea apropiado para el contenido. URL: escriba la URL de la carpeta raz del contenido; por ejemplo, http://<nombreservidor>/<carpeta de contenido>. No especifique una pgina concreta, como, por ejemplo, index.html.
Para configurar opciones de SmartHelp: 1. 2. 3. 4. 5. 6. Inicie la Utilidad de configuracin. Haga clic en el vnculo Ayuda Inteligente. En el campo Aplicacin, elija la aplicacin para la que desea especificar la ubicacin del contenido. En el campo Idioma, elija el idioma del contenido de esa ubicacin. En el campo URL, escriba la URL de la carpeta del contenido de la aplicacin. Si tiene ms de una aplicacin para la que desea activar la Ayuda Inteligente, haga clic en 7. y escriba otra URL.
Haga clic en Guardar. Nota: para eliminar una fila, haga clic en reorganizar las filas con y . en la barra gris. Tambin puede
Texto de ficha de Reproductor predeterminado: el Reproductor predeterminado es aquel desde el que se inici la utilidad de configuracin. Se trata del Reproductor que se ejecuta si no se configura la pgina de puerta de enlace. Adems, si se configura cualquier clase de segmentacin de contenido, como la compatibilidad con varios idiomas, slo se aplica al Reproductor predeterminado. Con esta opcin, se puede determinar el nombre que aparece en la ficha para el Reproductor predeterminado. Fichas: la seccin Fichas contiene tres opciones. La primera opcin es el campo Texto de ficha. Esto permite especificar el texto que se desea que aparezca en la ficha. La segunda opcin es la lista Tipo, que tiene tres opciones. Utilice la opcin del Reproductor para iniciar cualquier contenido del Reproductor. Estas dos opciones del Reproductor no estn sujetas al idioma o a cualquier otra segmentacin de contenido que se pueda configurar. Use la opcin de URL para iniciar un sitio o pgina web de Internet o de la intranet. En funcin de la aplicacin de destino que est configurando, tambin puede aparecer una opcin para iniciar la ayuda de la aplicacin de destino. En funcin de la aplicacin de destino que se configure, tambin puede aparecer una opcin para iniciar la ayuda de la aplicacin de destino. Nota: debe comprobar que haya contenido vlido en la URL especificada. La tercera opcin es el campo URL. Escriba la URL de la raz de la carpeta PlayerPackage (no especifique una pgina concreta, como, por ejemplo, index.html) o de la pgina Web. Adems, puede utilizar y para aadir y eliminar filas, o y para cambiar el orden de las fichas. No puede cambiar el orden de la ficha predeterminada del reproductor; siempre ser la que est situada ms a la izquierda.
Recordar ficha activa: si esta opcin es S, se coloca una cookie en el sistema del usuario de modo que la pgina de puerta de enlace se inicie con la ficha que estaba activa la ltima vez que el usuario accedi a ella. Texto de men de vnculo: esta opcin permite cambiar el nombre del texto del men del vnculo que aparece en la pgina de puerta de enlace. Vnculos: la seccin Vnculos contiene tres opciones. La primera opcin es el campo Texto de vnculo, que permite especificar el texto que se desea para el elemento del men del vnculo. La segunda opcin es la lista Tipo, que tiene tres opciones. Esto permite especificar el texto que se desea para el elemento en el men del vnculo. La segunda opcin es la lista Tipo, que tiene tres opciones. Utilice la opcin del Reproductor para iniciar cualquier contenido del Reproductor. Estas dos opciones del Reproductor no estn sujetas al idioma o a cualquier otra segmentacin de contenido que se pueda configurar. Use la opcin de URL para iniciar un sitio o pgina web de Internet o de la intranet. En funcin de la aplicacin de destino que est configurando, tambin puede aparecer una opcin para iniciar la ayuda de la aplicacin de destino. La tercera opcin es el campo URL. Escriba la URL de la raz de la carpeta PlayerPackage (no especifique una pgina concreta, como, por ejemplo, index.html) o de la pgina Web. Adems, puede utilizar orden de los vnculos. y para aadir y eliminar filas, o y para cambiar el
Configurar contenido en varios idiomas Las opciones de esta funcin permiten configurar la ayuda para iniciar el contenido adecuado, si se ha desarrollado contenido en varios idiomas. Esta funcin slo est disponible para determinadas aplicaciones de destino. Nota: la ficha Reproductor predeterminado en una configuracin de puerta de enlace con fichas tiene en cuenta el idioma o cualquier otro tipo de segmentacin.
URL de contenido por idioma: en esta opcin hay dos campos, Idioma y URL de contenido. Utilice la lista de Idioma para seleccionar un idioma y, a continuacin, en el campo URL de contenido, introduzca la URL que seala a la raz del paquete del reproductor correspondiente a ese idioma. No aada index.html ni ninguna otra pgina. Puede hacer clic en para aadir nuevas filas, segn sea necesario, para para quitar los idiomas admitir todos los idiomas disponibles, o puede hacer clic en que ya no necesite.
URL de contenido predeterminado: se trata de una URL que hace referencia al contenido que se debe iniciar, si el idioma no est definido en la lista URL de contenido por idioma. Por ejemplo, si ha definido ingls, espaol, francs y alemn y alguien se conecta en italiano, puede especificar que se inicie el contenido en ingls. Si no se encuentra ningn idioma coincidente, se utilizar el contenido del Reproductor que se configura; por ejemplo, desde donde se inici la utilidad de configuracin.
Configurar opciones avanzadas Las opciones de esta funcin permiten controlar el modo en que se muestra el esquema cuando se inicia el contenido y sealan al contenido, si se mueve la carpeta de secuencias de comandos.
Presentacin de esquema: si se ha configurado el esquema para iniciarse con funcionalidad contextual, el esquema slo contendr los elementos relacionados con la tarea que el usuario realiza en la aplicacin de destino. Se denomina contenido aplicable y es la configuracin predeterminada. Si, por el contrario, se desea que se muestre la totalidad del esquema de contenido, puede cambiarse esta opcin para mostrar todo el contenido. Los usuarios pueden cambiar entre las vistas de
Versin de Oracle: especifique 11i o R12. Es necesario para que la segmentacin del idioma funcione correctamente.
10
Segmentacin de contenido por: esta opcin permite elegir el tipo de segmentacin. Cuando se modifica esta opcin, los campos en URL de contenido por segmento se ajustan como corresponda. Tipo de GUI: si se elige segmentar el contenido por tipo de GUI, aparecer este campo, que permite especificar la interfaz grfica de usuario de cada URL de contenido. Parmetro SAP: si decide segmentar el contenido por parmetro de usuario de SAP, aparece este campo, que le permite especificar el valor de los datos de usuario de SAP para cada URL de contenido. Nota: para utilizar este parmetro para la segmentacin, se debe crear el parmetro /GKOD/Y_ROLE en cada registro maestro de usuario de SAP (transaccin SU01). Los valores de los registros maestros y los valores del campo Parmetro SAP deben coincidir para que se devuelva el contenido correcto.
Opciones adicionales
Contexto parcial: al grabar contenido, se capturan identificadores de contexto que permiten la funcionalidad contextual. En SAP, estos identificadores constan de tres componentes como mximo: el cdigo de transaccin (T), el nombre del programa (P) y el nmero de pantalla (S). Puede introducirse el valor adecuado que controle cul de estos componentes se utiliza para encontrar el contenido aplicable. El valor predeterminado consiste en utilizar los tres componentes. Nota: esta opcin slo es necesaria si existen problemas con la funcionalidad contextual. Antes de usarla, pngase en contacto con el servicio de soporte tcnico.
11
Para configurar Agile CNM: 1. 2. 3. 4. 5. Inicie sesin en la aplicacin Agile CNM. Haga clic en el vnculo Administration. Haga clic en el vnculo System Settings. Haga clic en el campo Online Help URL. Cambie la URL para que haga referencia al archivo agilecnm_gateway.html del paquete del Reproductor. Ejemplo: http://<servidor>/<directorio>/agilecnm/hemi/agilecnm_gateway.html 6. Haga clic en Guardar.
12
http://<servidor>/<dir>/psentone/hemi/pste1_gateway.html
Se recomienda tomar nota de la URL de ayuda de PeopleBooks original para poder utilizarla posteriormente, en caso necesario. Nota: al configurar las colas de Media Object se puede utilizar el contenido de la ayuda como el nombre de la cola y hacer referencia al archivo pste1_gateway.html en ..\psentone\hemi, en la carpeta de contenido publicado como las rutas de colas en lnea y sin conexin.
Para la instalacin de iSeries-i5: www/<servidor HTTP>; por ejemplo, apachedft/htdocs/JWALK/JWALKAPP/A9100APP Para la instalacin de Windows NT-2000-2003 Server: C:\Inetpub\wwwroot\JWALKAPP\A9100APP o C:\Archivos de programa\Apache Software Foundation\Apache2.2\htdocs\JWALKAPP\A9100APP
UPKVIEWI: establzcalo en Y para que se muestre el icono de funcionalidad contextual en los mens del programa. UPKVIEWH: establzcalo en Y para que se muestre View Content Option (ver opcin de contenido) en el men desplegable de la ayuda. UPKHELP: se muestra texto cuando se pasa el ratn por encima del icono de funcionalidad contextual. UPKHELPOPT: se muestra texto para la opcin en el men desplegable de la ayuda. UPKPath: debe establecerse en la ruta de la ubicacin del contenido. Por ejemplo: http://<servidor>/<directorio virtual>/jdeworld/hemi/jdeworld_gateway.html?CTXEX=
Si se coloca el contenido de la ayuda en el servidor de Windows que admite la interfaz de cliente de JWalk, no ser necesario realizar ninguna configuracin adicional. En cambio, si ese contenido est en otra ubicacin, deber configurarse el archivo odcustomurl.js.
13
6. 7.
Comprobar la configuracin existente de la biblioteca personalizada El archivo .pll entregado con el Desarrollador se escribe con SPECIAL7 como el valor predeterminado. Este valor predeterminado es una sugerencia. Puede utilizarse cualquiera entre 1 y 15. Si no se han creado aplicaciones especficas de Oracle que utilicen el evento SPECIAL, puede utilizarse el predeterminado. En cambio, si se han creado aplicaciones especficas de Oracle que s utilizan el evento SPECIAL, puede tomarse el valor 7 y deber encontrarse otro valor adecuado, sin utilizar, entre 1 y 15.
14
Es posible utilizar las siguientes lneas de comandos para encontrar un valor sin utilizar, en lugar de editar y compilar repetidamente el archivo custom.pll: cd $AU_TOP/forms/US; grep -i APP_SPECIAL.ENABLE `find . -name "*.fmb" -print`| grep SPECIAL7| grep -i PROPERTY_ON cd $AU_TOP/resource; grep -i APP_SPECIAL.ENABLE `find . -name "*.fmb" -print`| grep SPECIAL7| g rep -i PROPERTY_ON Si se recibe un resultado parecido a la sentencia siguiente, significa que ya se est utilizando ese valor. ./CSCCCCRC.fmb:app_special.enable('SPECIAL7', PROPERTY_ON); Distribuir una biblioteca personalizada Si no ha distribuido una biblioteca personalizada en el servidor de aplicaciones de Oracle, realice los pasos que se especifican a continuacin. Para distribuir una biblioteca personalizada: 1. 2. Realice una copia de seguridad del archivo CUSTOM.pll existente en CUSTOM.pll.orig. Busque el archivo ODPNCustomPLL.zip en la carpeta de ORACLE donde est instalado el Desarrollador y extraiga los archivos CUSTOM.pll y ODPN.pll. Cpielos en la carpeta $AU_TOP/resource del servidor de Aplicaciones Oracle. Nota: $AU_TOP se define como una variable y hace referencia a /oracle/VIS/apps/apps_st/appl/au en sistemas operativos Unix y Windows. 3. Asegrese de que nadie est utilizando actualmente Aplicaciones Oracle (formularios web). Cierre el servicio Oracle Forms Server si ejecuta la versin 11i. Nota: no es necesario cerrar ningn servicio si se ejecuta la versin R12. 4. En $AU_TOP/resource, compile los archivos de biblioteca ODPN.pll y CUSTOM.pll con el comando correspondiente a la versin de EBS: Servidor Oracle 11.5.10: ifcmp60 module=ODPN.pll module_type=LIBRARY userid=apps/apps@<instance> compile_all=yes ifcmp60 module=CUSTOM.pll module_type=LIBRARY userid=apps/apps@<instance> compile_all=yes Para Oracle E-Business Suite R12: frmcmp module=ODPN.pll module_type=library userid=apps/apps@<instance> compile_all=yes frmcmp module=CUSTOM.pll module_type=library userid=apps/apps@<instance> compile_all=yes Nota: sustituya la cadena de conexin de la base de datos para reflejar su instancia. Nota: no es necesario apagar el servidor de formularios para Oracle E-Business Suite R12. Modificar una biblioteca personalizada existente Si dispone de una lgica personalizada en la biblioteca personalizada (CUSTOM.pll) que no desea sobrescribir, realice los siguientes pasos. Debe colocar una lnea de cdigo en la biblioteca personalizada que realizar una llamada a una nueva biblioteca (ODPN.pll). A
15
continuacin, slo tendr que volver a compilar el archivo CUSTOM.pll, si desea recibir nuevas versiones de ODPN.pll con actualizaciones de software. Para modificar una biblioteca personalizada: 1. 2. 3. Realice una copia de seguridad del archivo CUSTOM.pll existente en CUSTOM.pll.orig. Copie CUSTOM.pll de la carpeta $AU_TOP/resource del servidor de aplicaciones de Oracle a un equipo cliente donde est instalado Oracle Forms Builder. Copie APPCORE2.pll de la carpeta $AU_TOP/resource del servidor de aplicaciones de Oracle a un equipo cliente donde est instalado Oracle Forms Builder. Debe ser la misma carpeta que se utiliz en el paso anterior. Busque el archivo ODPNCustomPLL.zip en la carpeta de ORACLE donde est instalado el Desarrollador y extraiga el archivo ODPN.pll. Cpielo en el equipo cliente dentro de la misma carpeta que las copias anteriores del archivo. Abra CUSTOM.pll con Oracle Forms Builder y asocie ODPN.pll. Coloque este archivo en la misma carpeta del equipo cliente donde estaba CUSTOM.pll antes de la asociacin. Conteste afirmativamente, cuando se le pregunte si desea quitar la ruta de directorio. Aada el cdigo siguiente al procedimiento Event: gkod_event (event_name, 'SPECIAL7'); Nota: puede utilizar cualquier nmero del 1 al 15 en el comando SPECIAL, siempre y cuando no haya conflictos. Consulte Comprobar la configuracin de biblioteca personalizada existente para obtener informacin ms detallada. A partir de Oracle EBS 12.1, el comando SPECIAL se puede reemplazar con el comando MENUX, donde X es un nmero del 1 al 15. 8. 9. Asegrese de que nadie est utilizando actualmente Aplicaciones Oracle (formularios web). Cierre el servicio Oracle Forms Server. Copie los archivos CUSTOM.pll y ODPN.pll del cliente a la carpeta $AU_TOP/resource del servidor de aplicaciones de Oracle.
4.
5.
6. 7.
10. Compile los archivos ODPN.pll y CUSTOM.pll. Para ello, realice los pasos 5 y 6 de la seccin anterior. Modificar el perfil HELP_WEB_AGENT Debe modificarse el perfil de HELP_WEB_AGENT en Oracle para que seale al archivo oracle_gateway.html, del contenido del Reproductor distribuido en el servidor. Para Oracle E-Business Suite 11i, la URL consta de dos partes: la ruta del archivo oracle_gateway.html (situado en la carpeta \oracle\hemi del contenido del Reproductor) y la ruta del archivo dbc predeterminado del servidor de Oracle. A continuacin se muestra un ejemplo para la versin 11i: URL=http://<nombre de servidor>:<puerto>/oracle/hemi/oracle_gateway.html?dbc=d:\oracle\o11iappl\fnd\11.5.0\sec ure\<nombre de servidor>.dbc A continuacin se muestra un ejemplo para la versin R12: URL=http://<nombre de servidor>:<puerto>/oracle/hemi/oracle_gateway.html
16
Para modificar el perfil de HELP_WEB_AGENT en Oracle E-Business Suite: 1. 2. 3. 4. Regstrese en la aplicacin Oracle EBS a travs de un navegador web como administrador. Haga clic en el vnculo Administrador del sistema y busque el perfil Sistema. Cuando se inicie el formulario Java, escriba APPLICATIONS_HELP% en el campo Perfil y haga clic en Buscar. Introduzca o edite la URL con la ruta a oracle_gateway.html. Nota: para Oracle 11.5.10i, incluya la ubicacin del archivo .dbc en la cadena de la URL. Una vez completados los cambios, detenga y reinicie el servicio Oracle Forms. 5. 6. Para aplicar el cambio de perfil en la sesin actual, cierre las aplicaciones de Oracle y vuelva a iniciar sesin. Haga clic en Ayuda en Oracle para que se inicie el Reproductor.
5. 6.
17
Debe tener acceso a la funcin de seguridad Administrador de WLS, as como una de las otras funciones: Administrador de implantacin de aplicaciones Consultor de implantacin de aplicaciones Administrador de aplicaciones Desarrollador de aplicaciones Para configurar la aplicacin de Oracle Fusion para la integracin del men Ayuda: 1. 2. 3. 4. 5. 6. 7. 8. 9. Inicie Functional Setup Manager. Haga clic en el vnculo Registrar aplicaciones empresariales. Haga clic en el botn Aadir, para aadir un nuevo registro a la aplicacin Fusion. La aplicacin que va a registrar es Oracle User Productivity Kit. Haga clic en la lista Entorno empresarial y seleccione el elemento oracle. Haga clic en la flecha situada a la derecha del campo Aplicacin empresarial y haga clic en Buscar..., en la parte inferior de la lista. En el campo Nombre, introduzca oracle user productivity kit y haga clic en el botn Buscar. En la lista Nombre, haga clic en Oracle User Productivity Kit y en Aceptar. En el campo Nombre, de la seccin de informacin bsica, introduzca Oracle User Productivity Kit. En la seccin de detalles del servidor, haga clic en la lista Protocolo de servidor y haga clic en http o https.
10. En el campo Host de servidor externo, introduzca el nombre del host de servidor que se utiliza para las comunicaciones externas; por ejemplo, ap6008fems.us.oracle.com. 11. En el campo Puerto de servidor externo, introduzca el puerto correcto; por ejemplo, 8080. Nota: en la seccin de mdulos asociados, observe que el valor del campo Raz contextual sea "upkcontent". Debe ser el nombre del directorio virtual donde se encuentra el contenido. Es un campo no editable. 12. Haga clic en el botn Guardar y cerrar. El vnculo de Oracle User Productivity Kit aparecer bajo el men Ayuda. No ser necesario reiniciar el servidor Web.
18
KCenter: ayuda de la interfaz de usuario principal. Gestor: ayuda de la aplicacin Gestor, que se inicia cuando un usuario hace clic en el vnculo Gestor del panel de navegacin. Informes: ayuda de la aplicacin Informes, que se inicia cuando un usuario hace clic en el vnculo Informes del panel de navegacin.
Cada carpeta contiene un paquete del Reproductor. Copie el paquete del Reproductor con la ayuda personalizada en la carpeta correcta. Por ejemplo, para sustituir la ayuda predeterminada con la ayuda personalizada de la interfaz principal de Knowledge Center en ingls, vaya a esta carpeta: C:\Archivos de programa\User Productivity Kit\Knowledge Center\Web Server\KCenter\Documentation\EN\Help\KCenter Nota: se recomienda encarecidamente que comprima el paquete del Reproductor existente a modo de copia de seguridad antes de copiar el paquete personalizado.
19
4. 5. 6.
Indique el servidor y el directorio del servidor Web en la opcin URL de User Productivity Kit. Guarde la configuracin. Reinicie los servicios Web de Weblogic. Una vez que se reinicie el servidor Web, el nuevo vnculo aparece en el men de la pgina.
2.4.11 Primavera P6
Primavera P6 se puede configurar para iniciar ayuda sensible al contexto a travs del vnculo Tutoriales del men Ayuda. Cuando el usuario hace clic en el vnculo Tutoriales, se inicia la ayuda del reproductor. Puede crear su propio contenido personalizado y hacer que el vnculo Tutoriales haga referencia al mismo. Para configurar el vnculo Tutoriales de modo que inicie contenido personalizado: 1. 2. 3. 4. 5. Inicie la herramienta Administrator. Expanda la carpeta Primavera P6 Configuration de la carpeta Custom. Expanda la carpeta Application y, a continuacin, Tutorials. Edite el valor del campo Activar Tutoriales y cmbielo a verdadero, si es necesario. Edite el campo Tutorials URL de modo que haga referencia a la ubicacin del contenido personalizado. Slo necesita especificar el servidor y el directorio virtual; por ejemplo, http://<servidor>/<directorio virtual>. Haga clic en Guardar cambios.
6.
Registrar un objeto en SAP Service Marketplace. Copiar los archivos de transporte en el servidor SAP. Importar los archivos de transporte al sistema SAP. Personalizar el men Ayuda de SAP. Editar el cdigo ABAP para personalizar la funcin "help_start" en SAP con el fin de iniciar el Reproductor. Configurar la URL de SAP. En este paso se deben configurar las direcciones URL para que sealen el contenido de SAP.
Para la instalacin es necesario un usuario de SAP Service Marketplace con derechos de administracin. En el sistema SAP de destino es necesario un usuario con derechos de programacin, registrado como programador. Registrar un objeto en el sistema SAP Service Marketplace Este procedimiento debe llevarlo a cabo un administrador de SAP o alguien con derechos administrativos para poder realizar la instalacin del servidor SAP de destino en SAP Marketplace.
20
Registre el objeto siguiente: "PgmID:R3TR, Object:FUGR, ObjectName:SHL2" y tome nota de la clave de acceso. Copiar los archivos de transporte en el servidor SAP El archivo de transporte contiene los archivos Kxxxxxx.nnn y Rxxxxxx.nnn, donde x y n variarn segn la versin de Developer a la que pertenezca el archivo de transporte. Estos archivos deben copiarse en el servidor SAP. Estn ubicados en un archivo denominado HEMITransport.zip dentro de la carpeta front de la instalacin de Developer. Nota: para descomprimir los archivos se necesitar una utilidad de descompresin como, por ejemplo, WinZip. Importar los archivos de transporte Los archivos de transporte que se han copiado al servidor SAP deben importarse al sistema SAP. Este paso deber ser realizado por un administrador. Todos los objetos de este transporte se encuentran en el espacio de nombre de desarrollo registrado /GKOD/. Este espacio de nombre de desarrollo garantiza que no se produzcan problemas con los nombres en el sistema SAP debido al transporte. Nota: si desea comprobar los registros de importacin del transporte, seleccione el men Goto y, a continuacin, el comando Import History. Se acepta un cdigo de retorno 4 (advertencia) e inferior. Nota especial para sistemas basados en SAP Unicode Si el sistema SAP est basado en Unicode, aplique el transporte de la siguiente forma a travs de la lnea de comandos. Compruebe que su perfil de instancias tiene el siguiente conjunto de parmetros: abap/unicode_check=on. Aplique el transporte a travs del siguiente procedimiento de la lnea de comandos: 1. 2. Acceda al directorio \usr\sap\trans\bin. Escriba lo siguiente: tp addtobuffer nnnKxxxxxx <SID> 3. Escriba lo siguiente: tp import nnnKxxxxxx <SID> -Dsetunicodeflag=true client<num> pf=TP_DOMAIN_<SID>.pfl Ejemplo:
21
Para personalizar el men Ayuda de SAP: 1. 2. 3. 4. Con la transaccin se37, modifique el mdulo de funcin HELP_START. Necesitar la clave de acceso obtenida anteriormente. (Nota: el mensaje de estado...) Inserte una modificacin encima de la lnea con la instruccin "when 'GLOS'." Introduzca la modificacin "include /GKOD/..." Guarde y active la modificacin.
Personalizar la funcin HELP_START en SAP En este paso, debe editar el cdigo para personalizar la funcin help_start en SAP. Esta funcin inicia los comandos del men de ayuda de SAP y se debe modificar para iniciar el reproductor con parmetros especiales. Nota: es posible que aparezca el mensaje de estado "El objeto FUNC_HELP_START forma parte de la interfaz de Basis; no est permitido desarrollarlo". Este mensaje no es un error y podr continuar con el procedimiento. Para personalizar la funcin HELP_START: 1. 2. 3. Introduzca *OnDemand Include. Pulse Intro. Escriba include /GKOD/Y_START_ONDEMAND.
El espacio entre include y la barra / de la instruccin anterior, as como el punto final de la misma son necesarios. Configurar la URL de la puerta de enlace En este paso, debe configurar la entrada de men de ayuda creada para que haga referencia al contenido distribuido. El contenido debe estar instalado en un servidor web para determinar las URL correctas que se van a introducir en el sistema. Puede establecerse la URL para que seale al contenido del reproductor de cualquier cliente o puede establecer direcciones URL base dependientes del cliente. Si se introduce una direccin URL base predeterminada y se selecciona la opcin Enabled, la entrada se utilizar para conectar con el contenido del reproductor en cualquier cliente de forma predeterminada. Si se guarda la entrada con la opcin Enabled sin seleccionar, no se utilizar la direccin URL base predeterminada en el sistema. Si no desea utilizar la direccin URL base predeterminada, deber introducir una cadena vaca en la tabla. Si la entrada no est definida, recibir un mensaje de error. Tambin se pueden crear direcciones URL base dependientes del cliente. Si no hay una entrada en la tabla de la URL base dependiente del cliente de un cliente concreto, se utilizar para dicho cliente la URL base predeterminada. Si la opcin Enabled est seleccionada para un cliente, la URL del cliente se utilizar como la URL base. Cuando la opcin Enabled no est seleccionada para un cliente, el contenido del reproductor estar desactivado en el cliente y los usuarios recibirn un mensaje de error cuando conecten con el contenido del reproductor. Debe iniciar sesin en el sistema SAP como un usuario con derechos de programacin. Dado que la tabla que va a utilizar est definida como independiente del cliente, podr iniciar sesin en cualquier cliente para cambiar las entradas. Para configurar la URL de puerta de enlace: 1. Acceda a la transaccin /n/GKOD/SS.
22
2. 3.
En el men Setup, seleccione Default Base URL. En el campo Default Base URL, introduzca la ruta de la pgina sap_gateway.html del contenido de SAP del servidor Web. Deber ser una URL completa que incluya la pgina sap_gateway.html. La pgina sap_gateway.html se encuentra en la carpeta front\hemi, dentro de la instalacin del reproductor. Si es necesario, haga clic en la opcin Enabled para seleccionarla. Haga clic en Haga clic en Guardar. Continuar.
4. 5. 6. 7. 8.
En el men Setup, elija Client Dependent Base URL. En el campo Table/View, especifique /GKOD/YEXTHLPURM si es necesario.
Traducir el men Ayuda Puede traducir los elementos del men de SAP a distintos idiomas locales. A continuacin, el men Ayuda aparecer en el idioma especificado por el usuario durante el inicio de sesin en SAP GUI.
3.
4. 5. 6.
23
permanecer en la carpeta de contenido publicado. 7. Repita este procedimiento para todos los idiomas que desee configurar.
Nota: si desea que el vnculo de contenido se abra en la pgina de ayuda de Siebel, con el vnculo del Reproductor en el rea de encabezado, cambie la opcin Mostrar ayuda de Siebel en la utilidad de configuracin.
24
Ejecutar los controles y complementos para ActiveX: activar Activar la secuencia de comandos de los controles de ActiveX marcados como seguros: activar
Nota: si Internet Explorer y el sistema operativo son compatibles con el modo protegido, las ubicaciones de contenido y las aplicaciones utilizadas con la Ayuda Inteligente debern tener el mismo modo de Internet Explorer, sea protegido o no. Para instalar SmartHelp, los usuarios pueden acceder a la siguiente pgina desde Internet Explorer: http://<servidor>/<directorio_contenido>/smarthelpsetup.html Para poder realizar la instalacin, en los sistemas operativos Windows es necesario disponer de privilegios, como mnimo, de usuario avanzado o superior (administrador). Es posible que los administradores del sistema tengan que modificar los permisos de usuarios o grupos pertinentes. Se recomienda que la URL de la Ayuda Inteligente forme parte de una zona de seguridad de Internet Explorer equivalente a los parmetros predefinidos de seguridad baja o media-baja. Resolucin de problemas Si la pgina smarthelpsetup.html muestra un error, aada ?diagnosticmode a la URL para ofrecer informacin adicional. Por ejemplo: http://<servidor>/<directorio_contenido>/smarthelpsetup.html?diagnosticmode En la mayora de los casos, despus de reiniciar el navegador, el nuevo botn de la barra de herramientas aparecer de modo automtico. Sin embargo, si el usuario ha personalizado la barra de herramientas de Internet Explorer, es posible que el nuevo botn no aparezca. En este caso, el botn de la barra de herramientas se aadir a las opciones del cuadro de dilogo Personalizar la barra de herramientas y aparecer al restablecer la barra de herramientas. Si desea obtener ms informacin, consulte el artculo sobre Microsoft Developer Network en la direccin http://msdn2.microsoft.com/en-us/library/Aa753588.aspx. Nota para Internet Explorer 9: cuando se instala Ayuda Inteligente y, a continuacin, se reinicia Internet Explorer, aparece un mensaje sobre el asistente de Ayuda Inteligente. Seleccione Habilitar y, a continuacin, reinicie Internet Explorer de nuevo para permitir que Ayuda Inteligente funcione. En algunas versiones de Internet Explorer, puede que no se muestre la barra de herramientas completa. El botn SmartHelp se aadir en el rea de lista desplegable para ms botones. Actualizar la versin de Ayuda Inteligente Si se actualiza el contenido publicado o su versin en el servidor, el contenido nuevo puede contener una versin ms reciente de SmartHelp con recursos nuevos. Por ello, hay que tener en cuenta que el botn SmartHelp de la versin anterior no puede cargar el contenido ms reciente. Para que SmartHelp actualice su versin, el usuario debe iniciar la configuracin. Si SmartHelp no funciona despus de una actualizacin del navegador, se puede iniciar la pgina de configuracin para actualizarlo o volver a configurarlo. Desinstalar de Internet Explorer 1. 2. Busque el objeto auxiliar de navegador de Ayuda Inteligente (complementos cargados actualmente) y desactvelo. Reinicie el navegador.
25
3. 4.
Busque el control activex de Ayuda Inteligente (controles descargados) y elimnelo. Reinicie el navegador.
26
Ejemplos: smarthelpsetup.exe /browser:IE admite slo complementos de Internet Explorer smarthelpsetup.exe /browser:IE;FF admite complementos de Internet Explorer y FireFox smarthelpsetup.exe /browser:all admite todos los complementos de todos los navegadores Nota: si se est grabando la instalacin correspondiente a una instalacin desatendida, la lista muestra todos los complementos disponibles en el paquete de instalacin, con independencia de los navegadores instalados en el equipo o los parmetros de lnea de comandos utilizados.
Instalacin desatendida
Una vez que se ha grabado el archivo de parmetros, se puede utilizar el parmetro /s para ejecutar la instalacin en modo silencioso. De forma predeterminada, el proceso de instalacin buscar el archivo de respuesta (.iss) en el mismo directorio en el que est setup.exe. Utilice
27
el parmetro /f1 para especificar una ubicacin del archivo .iss distinta. El archivo de respuesta (.iss) se debe insertar con el archivo setup.exe o debe estar ubicado en una ubicacin accesible para todos los equipos y con la misma asignacin de unidad que con la que se almacenaron en el archivo de respuesta. Para ejecutar una instalacin desatendida, en la lnea de comandos debe utilizar los parmetros estndar de InstallShield para una instalacin silenciosa. /s: ejecuta el instalador en modo silencioso /f1[scriptfile]: nombre del archivo de respuesta que se crea al ejecutar el instalador en modo de grabacin, incluida la ruta. /f2[logfile]: nombre del archivo de registro de la instalacin que se crea al ejecutar el instalador en modo silencioso, incluida la ruta. Este parmetro es opcional; si no se utiliza, el archivo de registro se crear en la misma carpeta que el archivo de respuesta. Ejemplo: "<ubicacin del archivo de instalacin>\smarthelpsetup.exe" /s /f1"<ubicacin del archivo de respuesta>\smarthelpsetup.iss" Sample: "x:\my folder\smarthelpsetup.exe" /s /f1"x:\smarthelpsetup.iss" Se pueden utilizar los parmetros de lnea de comandos especficos de Ayuda Inteligente (/browser:[browser] y /force), pero deben incluirse despus de todos los parmetros de lnea de comandos estndar de InstallShield. Por ejemplo: smarthelpsetup.exe /s /f1"<ubicacin del archivo de respuesta>\smarthelpsetup.iss" /browser:[browser] /force. Para utilizar el instalador de Ayuda Inteligente, abra una ventana de smbolo del sistema y ejecute el archivo smarthelpsetup.exe que se encuentra en la carpeta \stdhemi\smarthelp del paquete del Reproductor publicado. A continuacin, se le pedir que seleccione el idioma del instalador y aparecer la pantalla de bienvenida. Durante la instalacin, continuar el proceso a travs de estas pantallas en el asistente de instalacin.
Opciones de configuracin: puede elegir el complemento adecuado en la lista. La lista est limitada por los navegadores de Internet compatibles que estn instalados en la estacin de trabajo local. Seleccionar ubicacin de destino: puede aceptar la ubicacin de destino predeterminada o hacer clic en Cambiar para especificar una diferente. La ubicacin de destino es el directorio de destino donde se instalarn los archivos de Ayuda Inteligente. Seleccin de idioma: elija el idioma de Ayuda Inteligente. Configuracin inicial: especifique la ruta donde se encuentra la configuracin de Ayuda Inteligente, con el formato "http://<nombreservidor>/<directorio_virtual>". Se trata de la ubicacin de la carpeta raz de un paquete del Reproductor en el servidor web. Listo para instalar: el asistente de instalacin est listo para instalar el software. Haga clic en Atrs, para revisar o modificar la configuracin. Estado de configuracin: esta pantalla aparece mientras se instalan los complementos y se realizan configuraciones en la estacin de trabajo local para activar Ayuda Inteligente. El Asistente de InstallShield ha finalizado: los complementos se han instalado.
28
29