Para renderizar una instancia de formulario basta con invocar una URL de G·Forms pasándole por parámetros una serie de datos así como configuración que se quiera aplicar.
La llamada en las aplicaciones clientes suele hacerse incluyendo el contenido renderizado dentro de un iframe o abriendo una ventana que apunta a una URL específica de G·Forms con una serie de parámetros especificados por ticket.
String urlGForms = contextoGForms + "/form/" + ticket
#G·Forms ticket.impl.gforms=es.guadaltel.framework.ticket.impl.DefaultTicket ticket.gforms.lifetime=10000000 ticket.gforms.key=0xFF,0xa34,0xaA3,0xaE4,0x25,0x25,0x25,0x58,0xFF,0x34,0xA3,0xE4,0x25,0x25,0x25,0x58,0xFF,0x34,0xA3,0xE4,0x25,0x25,0x25,0x58,0xFF,0x34,0xA3,0xE4,0x25,0x25,0x25,0x01,0x02
Map<String, String> parametros = new HashMap<String, String>(); // Se añaden los parámetros... Ticket t = TicketFactory.createInstance("gforms"); String ticketString = t.getTicket(parametros);
A continuación se detallan los parámetros que se pueden emplear en la invocación de los formularios, indicando aquellos que son obligatorios.
| Atributo | Descripción | Obligatorio | Opciones | Valor por defecto |
| form | Código del formulario a instanciar | ✔ | - | - |
|---|---|---|---|---|
| version | Versión del formulario que se desea recuperar. Valor entero, si no se indica se toma la última versión publicada | - | - | |
| id | Identificador único para la instancia a invocar. Si no existe, G·Forms crea una nueva instancia con el identificador especificado | ✔ | - | - |
| user | Identificador del usuario que invoca la instancia para auditar los cambios en los datos | ✔ | - | - |
| system | Identificador del sistema/aplicación que invoca la instancia para auditar los cambios en los datos | ✔ | - | - |
| baseSkin | Skin de richfaces a emplear en ejecución del formulario | plain / emeraldTown / blueSky / wine / japanCherry / ruby / classic / deepMarine / laguna / glassX / darkX / classic / wine / deepMarine / sakura / DEFAULT | darkX | |
| customCSS | CSS a emplear en ejecución del formulario | darkX / laguna / ruby | darkX | |
| urlPrevFirstPage | Url a la que redireccionará GForms al pulsar el botón "Anterior" cuando se está en la primera pantalla del formulario. Si no se desea que se muestre el botón se debe especificar el valor “no_url”. | - | La definida en la configuración del formulario | |
| urlNextLastPage | Url a la que redireccionará GForms tras finalizar el formulario. Si no se desea que se muestre el botón se debe especificar el valor “no_url”. | - | La definida en la configuración del formulario | |
| saveOnNextOrPreviousPage | Indica si se guardan los datos cada vez que se cambia de pestaña en el formulario o solo al finalizar o pulsar el botón "Guardar" | true / false | false | |
| readonly | Indica si el formulario se cargará en modo de solo lectura | true / false | false | |
| askPDFOnExit | Indica si al finalizar el formulario se le ofrece al usuario la opción de exportar a PDF el mismo antes de navegar a otra página | true / false | false | |
| allowForwardWithErrors | Indica si se permite navegar entre las páginas aunque existan errores de validación | true / false | false | |
| hideExportButton | Indica si se oculta el botón de exportación de formulario a PDF | true / false | false | |
| admittedLocales | Lista separada por comas de los locales admitidos por el formulario. | es_ES / en_GB / fr_FR / it_IT / de_DE / pt_PT / ca_ES / va_ES / gl_ES | es_ES | |
| defaultLocale | Locale por defecto del formulario. | es_ES / en_GB / fr_FR / it_IT / de_DE / pt_PT / ca_ES / va_ES / gl_ES | es_ES | |
| recoverActivePage | Recupera el formulario por la pestaña que contenga la última pregunta contestada | true / false | false | |
| sequentialMode | Se renderiza en modo secuencial, mostrando N elementos por página. El número de elementos por página se configura en tiempo de diseño | true / false | false | |
| wsRestOnSave | WS Rest a invocar cada vez que se guarde el formulario | - | La definida en la configuración del formulario | |
| nextButtonText | Texto para el botón siguiente | - | Siguiente | |
| backButtonText | Texto para el botón volver | - | Volver | |
| nextExitButtonText | Texto para el botón siguiente en la última página | - | Salir | |
| backExitButtonText | Texto para el botón volver en la primera página | - | Salir | |
| urlExit | Url a la que redireccionará GForms al pulsar el botón "Salir" del formulario. Si no se desea que se muestre el botón se debe especificar el valor “no_url”. | - | La definida en la configuración del formulario | |
| exitButtonText | Texto para el botón salir | - | Salir | |
| keepHiddenValues | Indica si se mantendrán los valores para los elementos no visibles o se sobreescriben con el valor #NOPROCEDE# | - | true | |
| hideLocaleToolBar | Indica si se oculta la barra de idioma en la ejecución de formulario | true / false | false | |
| hideNavigationButtons | Indica si se ocultan los botones de navegación en la ejecución de formulario | true / false | false | |
| askSaveOnExit | Indica si se muestra mensaje de confirmación de cambios al salir del formulario | true / false | true | |
| blockTabNavigation | Indica si se bloquea la navegación a través de pestañas | true / false | true |