Instala WalkMe en Oracle Fusion Apps
Breve descripción general
Las aplicaciones de Oracle Fusion tienen una función que te permite añadir tu propio código JavaScript personalizado. Con esta función, podemos añadir el fragmento de WalkMe directamente en estas plataformas sin necesidad de utilizar una extensión separada.
El fragmento de WalkMe es un fragmento especial de código escrito en JavaScript que permite que WalkMe aparezca en tu sitio web. Cada cuenta de WalkMe Editor tiene su propio código de fragmento único. Esta guía te mostrará instrucciones paso a paso sobre cómo instalar el fragmento en tu aplicación de Oracle Fusion.
Configuración/Implementación
Actualiza la configuración de la política de seguridad de contenido de Oracle
La política de seguridad del contenido (CSP) es una función de seguridad que protege a los sitios web de ser atacados por código malicioso. Una forma de hacerlo es limitando los recursos que un sitio web puede cargar.
El perfil ORACLE.ADF.VIEW.ALLOWED_ORIGINS en Oracle se utiliza para especificar qué dominios pueden interactuar con el sitio web. Antes de instalar el fragmento de WalkMe, deberás permitir los recursos del dominio walkme.com a Oracle:
- Ve a ORACLE.ADF.VIEW.ALLOWED_ORIGINS: Valores de perfil.
- Añade 'self' https://*.walkme.com al campo Valor del perfil.
- Haz clic en Guardar
Encuentra tu fragmento
El código de fragmento está disponible en WalkMe Editor. Deberás copiar este código para utilizarlo más tarde en el proceso de incorporación a continuación.
- Haz clic en el botón de configuración (icono de engranaje) en el Editor de WalkMe.
- Haz clic en Configuración del sistema
- Ve a la pestaña Fragmento.
- Selecciona el entorno correcto en el menú desplegable (Prueba/Producción)
- Cada entorno tiene un código de fragmento ligeramente diferente
- Si tienes un sitio de prueba/sandbox/staging, selecciona el fragmento Prueba
- Si deseas el fragmento para publicarlo a tus usuarios finales, selecciona el fragmento de Producción.
- No copies todo el fragmento. En su lugar, copia la URL incrustada en el fragmento y crea un fragmento de código como el siguiente ejemplo:
-
- Ejemplo de fragmento de código para incrustar:
<script src='https://cdn.walkme.com/users/90ffe6d14ea242c19e029b712cbbca83/test/walkme_90ffe6d14ea242c19e029b712cbbca83_https.js'></script>
Descubrir y empezar a usarlo
Es importante determinar a qué tipo de aplicación o página de Oracle deseas añadir el fragmento de WalkMe antes de continuar con el proceso de incrustación. Elige el conjunto adecuado de pasos para incrustar el Fragmento de WalkMe de las opciones que se proporcionan a continuación:
- Crea un nuevo entorno aislado y activa el entorno aislado
- Haz clic en Editar plantilla de página global en Configuración y Acciones.
3. En la pantalla, selecciona el elemento de encabezado central (consulta la etiqueta 1 a continuación).
-
- Esta es la ubicación de la página donde se incrustará el elemento del fragmento
4. En la parte inferior de la página, aparecerá un editor de componentes, puedes utilizar el mouse para expandirlo aproximadamente a la mitad de la página
5. Haz clic en el icono + para añadir un nuevo componente (consulta la etiqueta 2 a continuación).
6. Selecciona Componentes
7. Haz clic en + Añadir junto al marcado HTML y luego en Cerrar.
8. Haz clic en tu nuevo componente de marcado HTML.
-
- En el Editor de marcado en la parte inferior, deberías ver una línea que dice outputText: Nuevo marcado HTML.
- Selecciona outputText: Nuevo marcado HTML.
9. Haz clic en el icono Editar (icono de engranaje).
10. Haz clic en la flecha junto al campo Valor y selecciona Generador de expresiones.
11. Elimina el valor predeterminado y pega el fragmento de WalkMe en su lugar.
12. Haz clic en Aceptar para cerrar el generador de expresiones.
13. Haz clic en Aceptar para cerrar las Propiedades del componente.
14. Haz clic en Cerrar en la parte superior derecha para salir de la interfaz de edición.
Requisitos previos
- Debes tener Visual Builder Studio configurado, que incluya lo siguiente:
- Creación de una instancia de Visual Builder Studio
- Asignar usuarios a los roles correctos
- Visual Builder Studio configurado correctamente para crear/implementar aplicaciones en el entorno elegido.
Crea un proyecto
Nota: estas instrucciones asumen que no tienes un proyecto configurado existente en el que deseas realizar las modificaciones.
- En la consola de VB Studio, ve a la pestaña Organización.
- Haz clic en Crear encima de la lista de proyectos.
- Dale un nombre a tu proyecto como "WalkMe Snippet".
- Selecciona Proyecto vacío
- Elige los valores predeterminados para todos los demás o según lo indique el administrador de Oracle
- Haz clic en Finalizar
Crea un entorno
- En VB Studio Console, abre el proyecto y navega hasta la pestaña de Entornos
- Haz clic en Crear entorno
- Dale un nombre a tu entorno y (descripción opcional)
- Haz clic en Crear
- Nota: este es un contenedor para un entorno real de Oracle. Por ejemplo: DEV1, TEST, UAT
- Nota: este es un contenedor para un entorno real de Oracle. Por ejemplo: DEV1, TEST, UAT
- Abre el entorno y haz clic en Añadir instancia
- Selecciona lo siguiente:
- Tipo de instancia: Oracle Cloud Applications
- Método de autenticación: credenciales de aplicación.
- En Añadir una aplicación de Oracle Cloud utilizando credenciales de aplicación, introduce lo siguiente:
- URL base: la URL que utilizan los usuarios para acceder al entorno.
- Nombre de la instancia: un nombre descriptivo para este entorno.
- Nombre de usuario: credenciales de usuario para un administrador con permisos suficientes para desarrollar aplicaciones.
- Contraseña: contraseña
- Haz clic en Añadir
- Ahora la instancia debería estar disponible
Crea una extensión de aplicación
- En la consola de VB Studio, abre el proyecto y ve a la pestaña Espacios de trabajo.
- Haz clic en Nuevo
- Haz clic en Nueva extensión de aplicación
.
- Introduce la siguiente información en la ventana emergente de Nueva extensión de aplicación.
- Nombre de la extensión: WalkMe Snippet
- Nombre del espacio de trabajo: Déjalo como predeterminado.
- Entorno de desarrollo: selecciona el entorno que creaste anteriormente, o según las indicaciones del administrador de Oracle.
- Aplicación básica Oracle Cloud: Gestión del capital humano (para las páginas principales de Oracle HCM Redwood)
- Sandbox: según las indicaciones del administrador de Oracle.
- Repositorio Git : crea un nuevo repositorio.
- Nombre del repositorio: walkme (o según las indicaciones)
- Nombre de la rama de trabajo: desarrollo (o según las indicaciones)
- Haz clic en Crear
Nota: La gestión del capital humano puede no ser la única aplicación en uso donde se necesita WalkMe. Si ampliar esta aplicación no cubre todas las áreas, consulta la sección al final de este documento: Encontrar la aplicación correcta para extender
Ahora el espacio de trabajo se abrirá automáticamente.
Añade el fragmento de WalkMe y Desplega
- Si aún no estás en el Espacio de trabajo, abre la consola de estudio VB y ve a: Proyectos de organización >Tus proyectos >Espacios de trabajo >Tu espacio de trabajo>
- En IU de aplicaciones, ubica la aplicación unificada.
- En Aplicación unificada, espera encontrar Páginas raíz y selecciona Redwood
- Haz clic en la pestaña JavaScript
5. Pega el fragmento de WalkMe (sin el <script).></etiquetas de script>) dentro de la llamada a la función define
6. Haz clic en Publicar.
7. Selecciona Combinar ahora o Combinar después de la revisión (según lo indique el administrador de Oracle).
8. Añade un comentario para el mensaje de confirmación.
9. Haz clic en Publicar cambios.
Nota: es posible que recibas una advertencia sobre que el sandbox necesita una actualización. Recomendamos a los clientes que hagan lo que se indica y actualicen antes de publicar.
10. Deberías recibir una confirmación. Haz clic en Cerrar
Puedes verificar el estado de la implementación desde la consola de VB Studio. > Compilaciones > Cola de trabajos
Nota: Si ves Esperando al Ejecutor en la columna Progreso, asegúrate de que se haya aprovisionado un Ejecutor en la consola de VB Studio. > Organización > Ejecutor de compilación:
Puedes crear uno aquí si te lo indica tu administrador, que puede tardar hasta 30 minutos en iniciarse. El trabajo de implementación continuará automáticamente una vez que se cree o inicie el Ejecutor.
Eliminar (revertir) una extensión
- Si aún no estás en el Proyecto, abre la consola de VB Studio y navega hasta tu proyecto: Organización > Proyectos > Tu proyecto
- En el menú de navegación, haz clic en Compilaciones > Compilaciones
- Introduce un nombre único en el campo Nombre en el cuadro de diálogo Nuevo trabajo.
- Introduce la descripción del trabajo en el campo Descripción.
- Selecciona OL7 por defecto del sistema para Visual Builder en la plantilla.
- Haz clic en Crear
- En la página de Configuración de tareas, haz clic en Configurar > Configurar
- Haz clic en la pestaña Pasos.
- Selecciona Aplicación desde Añadir Paso
- Selecciona Eliminar
- Selecciona la instancia de Oracle Cloud Applications donde se implementa la aplicación en la instancia
- En Nombre de usuario y Contraseña, introduce las credenciales de un usuario de IDCS que no solo sea un usuario de Oracle Cloud Applications, sino uno que pueda conectarse y desimplementar desde la instancia de producción de Oracle Cloud Application
- En Aplicación base, Nombre y Versión , introduce la aplicación base, el nombre y la versión de la extensión
- Puedes encontrar los detalles en la pestaña Implementaciones del entorno donde se implementa la extensión
- Haz clic en Guardar
- Haz clic en Ejecutar ahora para ejecutar una compilación
Encontrar la aplicación correcta para extender
Elegir la aplicación correcta para extender es clave para una inyección exitosa. Si extendes la aplicación incorrecta, no pasará nada (bueno, ALGUIEN conseguirá WalkMe, pero no donde se espera).
Si las páginas en las que el cliente quiere WalkMe no forman parte de la gestión del capital humano, deberás crear una extensión adicional (o múltiple) y realizar el mismo proceso allí.
Para comenzar, navega hasta la página donde deseas que WalkMe inyecte e inspecciona el documento:
Busca en el DOM un recurso de script llamado app.json. En el atributo de script data-requiremodule, contendrá una URL, en el formato …/applications/<nombre de la aplicación> /app.json
El <nombre de la aplicación> es el nombre de la aplicación que deseas extender:
Notas técnicas
- Oracle no se admite en la web móvil.