Registrar aplicación externa
Prerrequisitos
- Acceso al menú Registro > Automatización > Aplicación externa (PM042).
- Acceso al componente SoftExpert Workflow.
Introducción
Las aplicaciones externas son PHP ejecutados en el servidor y pueden ser invocadas durante la ejecución de un proceso en SoftExpert Workflow. Pueden estar disponibles tanto en el servidor de SoftExpert Suite como en una página web.
Se utilizan para resolver problemas específicos que SoftExpert Suite, de forma nativa, aún no atiende.
Su ejecución se realiza de dos formas:
- Durante la ejecución de una actividad del sistema que no tiene interacción humana. En este caso, el sistema ejecutará su aplicación y seguirá el proceso.
- Durante la acción de una actividad del usuario. Aquí es posible configurar para que ocurra la ejecución de la aplicación externa y, en seguida, la ejecución de la actividad. O simplemente ejecute la aplicación externa sin ejecutar la actividad.
Entornos con SoftExpert Suite en servidor GNU/Linux:
A partir de la versión 2.1.3, las aplicaciones externas personalizadas que se encontraban en la carpeta web ahora deberán estar en la carpeta customization, manteniendo la estructura de ruta a la que pertenecían; por ejemplo, la siguiente carpeta (considerando que /usr/local/se sea la ruta en la que se instaló SoftExpert Suite):
- /usr/local/se/web/wwwroot/workflow/wf_app
A partir de la 2.1.3, pasa a estar en:
- /usr/local/se/customization/web/wwwroot/workflow/wf_app
Registrar aplicación externa
1. Acceda al menú Registro > Automatización > Aplicación externa (PM042).
2. Haga clic en el botón
.
3. Informe el identificador y el nombre de la aplicación externa.
4. En la pestaña General, observe que el campo Utilizar aplicación externa nativa está habilitado. Esto indica que se utilizarán las aplicaciones nativas del sistema.
5. Si mantiene habilitada la opción Utilizar aplicación externa nativa, en el campo Aplicaciones nativas, seleccione la opción que desee.
6. Si deshabilita la opción Utilizar aplicación externa nativa, en el campo Ruta de la aplicación, informe la ruta completa donde se encuentra la aplicación externa. Por ejemplo: "http://intranet/login.php".
7. En el campo Descripción, incluya información adicional sobre la aplicación.
8. Haga clic en el botón
.
Incluir los parámetros de la aplicación externa
Después de guardar la aplicación externa la primera vez durante el registro, se habilita la pestaña Parámetros, en la que se deben informar todos los parámetros que se pueden pasar al llamar a la aplicación externa.
1. En la pestaña Parámetros, haga clic en el botón
.
2. En el campo Identificador, introduzca el nombre del parámetro que se va a pasar a la aplicación externa.
3. Marque el campo Parámetro fijo para todas las llamadas para que el parámetro sea fijo para todas las llamadas a la aplicación externa.
4. En el campo Tipo, informe si el valor del parámetro será constante o variable.
5. Si el tipo del parámetro seleccionado es Constante, en el campo Valor constante, introduzca el valor que se pasará a la aplicación externa.
6. Si es necesario, informe una descripción para el parámetro.
7. Haga clic en el botón
.

Diferencia entre los tipos de parámetros:
- Parámetro constante: el sistema siempre enviará el mismo valor a la aplicación externa, independientemente de la actividad o proceso que se utilice.
- Parámetro variable: es posible informar el valor durante la configuración de la aplicación externa en una actividad. De esta forma, en un proceso, la aplicación externa puede recibir un valor y, en otro proceso, otro valor.
Configurar propiedades de la pantalla
En la pestaña Ventana WEB de la pantalla de datos de la aplicación externa, se deben configurar las propiedades de la pantalla si el tipo de ejecución es WEB.
1. En la pantalla Datos de la aplicación externa, vaya a la pestaña Ventana WEB.
2. Seleccione el posicionamiento de la pantalla en el momento de la llamada de la aplicación externa. Elija entre las opciones: Centralizado, Maximizado, Superior izquierda o Personalizado.
3. Los campos Ancho y Altura se habilitarán si en el campo Posicionamiento se selecciona una de las opciones: Centralizado, Superior izquierdo o Personalizado. En ese caso, introduzca la altura y el ancho (en píxeles) de la pantalla de la aplicación externa.
4. Los campos Eje X y Eje Y se habilitarán si en el campo Posicionamiento se selecciona la opción Personalizado. En este caso, informe la posición de la pantalla, mediante los campos Eje X y Eje Y (en pixeles), e informe el tamaño de la pantalla de la aplicación externa mediante los campos Altura y Ancho (en pixeles).
5. La pestaña presenta algunas opciones más. Consulte en la tabla a continuación qué representa cada una:
| Barra de botones | Seleccione esta opción para mostrar la barra de herramientas del navegador de internet en la pantalla. |
| Barra de direcciones | Seleccione esta opción para mostrar la barra de direcciones del navegador de internet en la pantalla. |
| Barra de estado | Seleccione esta opción para mostrar la barra de estado en la pantalla. |
| Barra de desplazamiento | Seleccione esta opción para mostrar las barras de desplazamiento (vertical y horizontal) en la pantalla. |
| Menú | Seleccione esta opción para mostrar el menú en la pantalla. |
| Cambio de tamaño | Seleccione esta opción para que se permita redefinir el tamaño de la pantalla. |

6. Haga clic en el botón
.
Al finalizar todas las configuraciones de la aplicación externa, haga clic en el botón
.
Conclusión
La aplicación externa estará registrada y lista para ser utilizada en la ejecución de un proceso en SoftExpert Workflow.