Altova MobileTogether Designer

Crear bibliotecas de acciones de servidor

Inicio Anterior Inicio Siguiente

Se usa el mismo proceso para crear una acción biblioteca de acciones de servidor que para crear una solución. Básicamente se usa para procesar grupos de acciones. Puede definir estructuras de fuentes de página para que la acción biblioteca de acciones de servidor use datos de esas estructuras. Sin embargo, como una acción biblioteca de acciones de servidor se ejecuta en el servidor (por lo que no tendrá interfaz de usuario), están deshabilitados todos los controles y la posibilidad de añadir nuevas páginas. Además, como una biblioteca de acciones de servidor solo puede ejecutar acciones en el lado servidor, como enviar un correo electrónico desde el servidor o actualizar un nodo en una de sus fuentes de página, este tipo de acciones son las únicas permitidas en una biblioteca de acciones de servidor; el resto de acciones se deshabilitan.

 

Para ver una descripción más completa de las bibliotecas de acciones de servidor consulte el apartado Bibliotecas de acciones de servidor.

 

Crear una acción biblioteca de acciones de servidor nueva

Para crear una biblioteca de acciones de servidor nueva siga estos pasos:

 

1.Haga clic en Archivo | Biblioteca de acciones de servidor nueva para abrir un archivo de diseño para esa biblioteca de acciones de servidor. Al hacer clic en ese comando se crea un diseño de biblioteca de acciones de servidor nuevo. La interfaz de MobileTogether Designer tendrá un aspecto parecido al de una solución pero muchas de las características estarán deshabilitadas (véase el primer párrafo de este apartado).

2.En la ventana principal haga clic en el botón Grupos de acciones para crear un grupo de acciones.

3.En el cuadro de diálogo Grupos de acciones que aparece (imagen siguiente) haga clic en el botón Agregar un grupo del panel Grupos de acciones (dentro de un círculo rojo en la imagen siguiente).

Clic para expandir/contraer

4.Cree un grupo de acciones tal y como se describe en la sección Grupos de acciones. Recuerde que puede definir los parámetros de ese grupo de acciones. Los parámetros son prácticos si quiere pasar datos de la solución (emisora) principal al grupo de acciones en la bibliotecas de acciones de servidor. Recuerde que la biblioteca de acciones de servidor no tiene acceso a los datos de la solución emisora. Es decir, si quiere pasar datos de la solución principal al grupo de acciones de la biblioteca de acciones de servidor, debe usar los parámetros para ello.

5.Guarde la acción biblioteca de acciones de servidor con el comando Archivo | Guardar.

6.Implemente la biblioteca de acciones de servidor con el comando Archivo | Implementar en MobileTogether Server. Recuerde que la biblioteca de acciones de servidor se debe implementar en el mismo MobileTogether Server que la solución que emite las llamadas y que el servidor debe ser edición Advanced Edition. La ubicación del servidor en que se guarda la biblioteca de acciones de servidor viene definida por el sistema, se selecciona automáticamente al usar el comando de implementación y no se puede modificar. (En todos los MobileTogether Server las acción bibliotecas de acciones de servidor se guardan en una única carpeta destinada para ello.)

 

Puntos importantes

Tenga en cuenta las siguientes consideraciones con respecto a las bibliotecas de acciones de servidor:

 

Se deben implementar en MobileTogether Server Advanced Edition.

Una biblioteca de acciones de servidor puede llamar a otras.

Si modifica una biblioteca de acciones de servidor debe volver a implementarla para que esos cambios sean accesibles a las soluciones emisoras de llamadas.

En el apartado Usar bibliotecas de acciones de servidor explicamos cómo acceder a ellas.

 

Ejemplo

La biblioteca de acciones de servidor de ejemplo que describimos en este apartado es ServerLibrary.mtd y se encuentra en la carpeta ServerActionLibraries de la carpeta Tutorials. Puede abrir este archivo de biblioteca de servidor y hacer clic en el botón Grupos de acciones para ir a la definición del grupo de acciones ScanFolder (imagen siguiente).

 

Para que la simulación funcione debe indicar las rutas de acceso a las carpetas de su sistema en la definición de la acción Leer carpeta del grupo de acciones. Después puede simular la solución emisora de llamadas MainSolution.mtd. Para ver un resumen sobre cómo funcionan juntos los dos archivos de ejemplo, MainSolution.mtd y ServerLibrary.mtd, consulte la descripción del ejemplo en la sección acción Bibliotecas de acciones de servidor.

Clic para expandir/contraer

Tenga en cuenta que:

 

La biblioteca de acciones de servidor contiene un grupo de acciones, ScanFolder, cuya definición puede verse en la imagen anterior.

Se ha declarado un parámetro (\$FolderToScan) para el grupo de acciones. La solución emisora de llamadas pasa el valor al grupo de acciones (consulte bibliotecas de acciones de servidor y Usar bibliotecas de acciones de servidor).

Cuando se añade la acción Leer carpeta al grupo de acciones se crea automáticamente una fuente de página llamada \$MT_FILEINFO en la biblioteca de acciones de servidor para que guarde los datos que se obtienen con la acción Leer carpeta.

La carpeta que se debe leer se indica en la opción Carpeta de la acción Leer carpeta (en un círculo verde en la imagen anterior). En nuestro ejemplo se usa una expresión XPath para indicar que se debe leer una carpeta distinta para cada opción (Books, Films y Music). Observe que las condiciones de la expresión XPath (imagen siguiente) usan la variable \$FolderToScan, que contiene la selección del usuario (Books, Films o Music) y que se envía desde la solución emisora de las llamadas.

MTDServerLibsCreateSLib03ExXPath

Las rutas de acceso a las carpetas se construyen concatenando las distintas partes de la ruta correspondiente. En esta expresión XPath puede modificar las rutas de acceso a las tres carpetas que se quieren examinar. Si quiere ejecutar una simulación con carpetas de verdad, indique en las rutas carpetas reales de su sistema.

La acción Restaurar se usa para restaurar la fuente de página \$MT_FILEINFO antes de que se ejecute la acción Leer carpeta.

La acción final del grupo de acciones, que ejecuta la acción Valor devuelto, es devolver la estructura de \$MT_FILEINFO como resultado del grupo de acciones. La estructura se pasa a la solución emisora de llamadas, a la variable \$FolderReadout de la acción Permitir que llama al grupo de acciones (véase bibliotecas de acciones de servidor y Usar bibliotecas de acciones de servidor).

 

Nota:para que las simulaciones de MainSolution.mtd funcionen debe indicar carpetas reales de su sistema en las rutas de acceso. Estas definiciones se encuentran en la opción Carpeta de la acción Leer carpeta.

 

© 2017-2023 Altova GmbH