Usar bibliotecas de acciones de servidor
Para usar las bibliotecas de acciones de servidor debe llamarlas desde una solución. Cuando lo haga pueden darse dos situaciones:
•Si un grupo de acciones de una biblioteca de acciones de servidor se diseña para que devuelva un valor a la solución emisora, la llamada se realiza vía una acción Permitir. El motivo es que la acción Permitir se define con una variable que se puede configurar para que reciba el resultado del grupo de acciones (imagen siguiente). Después esta variable se puede usar dentro de la solución que emite las llamadas. En la imagen siguiente se puede ver una llamada realizada al grupo de acciones ScanFolder de una biblioteca de acciones de servidor con la acción Permitir. El resultado del grupo de acciones se pasa a la variable \$FolderReadout de la solución que emite las llamadas.
•Si el grupo de acciones de la biblioteca de acciones de servidor se configura para que ejecute acciones en el servidor (independientemente de la solución que emite las llamadas y del dispositivo cliente), no devolverá un valor de retorno que se pueda enviar a la solución emisora. Esto significa que solo se puede llamar al grupo de acciones cuando se necesita, sin que sea necesaria la acción Permitir. En este caso solo tiene que arrastrar el grupo de acciones de la biblioteca de acciones de servidor hasta el punto en el que quiere que se ejecute durante el procesamiento de las acciones de un evento ( acciones imagen siguiente).
Llamar al grupo de acciones de una acción biblioteca de acciones de servidor
En una solución principal, para llamar a una biblioteca de acciones de servidor debe seguir estos pasos:
1.En el panel Archivos haga clic con el botón derecho del ratón en el elemento Bibliotecas de acciones de servidor para acceder al menú contextual correspondiente y seleccione Agregar biblioteca de acciones de servidor (imagen siguiente). También puede usar el comando de menú Reestructurar | Agregar biblioteca de acciones de servidor.
2.En el cuadro de diálogo que aparece navegue hasta la biblioteca acciones que quiere agregar, selecciónela y haga clic en Abrir. La biblioteca de acciones de servidor se añade a la lista de bibliotecas de acciones de servidor y sus grupos de acciones se habilitan para las llamadas.
3.Vaya al cuadro de diálogo Acciones del evento en el que quiere usar la acción Abrir URL biblioteca de acciones de servidor.
4.En ese cuadro de diálogo podrá ver y usar todos los grupos de acciones de la acción Abrir URL biblioteca que ha añadido (imagen siguiente). Recuerde que el icono de los grupos de acciones de las bibliotecas de acciones de servidor es distinto al de los grupos de acciones locales.
5.Arrastre el grupo de acciones a la ubicación donde quiere usarlo (primera imagen de este apartado).
6.Una vez haya guardado la solución puede implementarla en el mismo MobileTogether Server en el que implementó la acción biblioteca de acciones de servidor.
Puntos importantes
Tenga en cuenta las siguientes consideraciones con respecto al uso de los grupos de acciones de las bibliotecas de acciones de servidor:
•Puede añadir más de una acción biblioteca de acciones de servidor a una solución. En la solución puede usar los grupos de acciones de todas las acción bibliotecas de acciones de servidor que haya añadido.
•Si modifica una acción biblioteca de acciones de servidor de forma sustancial, como cambiándole el nombre a algún parámetro, deberá modificar la solución en consonancia.
•Si modifica una biblioteca de acciones de servidor y quiere ejecutar una simulación de una solución que llama a esa biblioteca de acciones de servidor, puede volver a cargar la biblioteca de acciones de servidor en el panel Archivos de la solución.
Ejemplo
En nuestro archivo de ejemplo, MainSolution.mtd, cuando el usuario selecciona una colección que examinar en el cuadro combinado Escanear esta carpeta (imagen siguiente), ocurre lo siguiente:
1.En la solución (emisora) principal, el nombre de la colección (Libros, Películas o Música) se guarda en el nodo de fuente de página \$PERSISTENT/Root/UserSelection después de que se haya seleccionado en el cuadro combinado de la solución (primera imagen en este ejemplo e imagen siguiente).
2.Se llama al grupo de acciones ScanFolder de la biblioteca de acciones de servidor ServerLibrary.mtd y el nombre de la colección seleccionado por el usuario se pasa como valor del parámetro \$FolderToScan (primera imagen en este ejemplo).
3.Se ejecuta el grupo de acciones y se examina la carpeta que corresponde al nombre enviado con la acción Leer carpeta del grupo de acciones de la biblioteca de acciones de servidor (consulte Crear una biblioteca Acción de servidor).
4.La estructura de datos que al examinar la carpeta se devuelve a la solución que emite las llamadas, MainSolution.mtd, y se almacena en la variable \$FolderReadout de la solución emisora (primera imagen en este ejemplo).
5.La estructura de datos de \$FolderReadout reemplaza la de \$XML1.
6.La fuente de página \$XML1 aparece como tabla (imagen siguiente).
