Se agrega funcionalidad en el cliente, opcional, para prevenir el envío múltiple de formularios.

• Nueva opción para generación en el archivo de configuración de la aplicación (aplicacion.xml): /aplicacion/generacion/formularios/evitar-envio-multiple.
• Nueva opción para formularios: /formulario/evitar-envio-multiple. Tiene mayor prioridad que la opción global en aplicacion.xml.

Esta funcionalidad se puede habilitar globalmente usando aplicacion.xml:/aplicacion/generacion/formularios/evitar-envio-multiple/@habilitar='true' y deshabilitar en formularios individuales con {entidad}_formulario.xml:/formulario/evitar-envio-multiple/@habilitar='false', o viceversa.

Advertencia de compatibilidad: Hasta el momento, si una aplicación generada contenía un archivo con nombre head.inc.php en su directorio raíz, éste se incluía antes de cerrar el elemento head. Esta funcionalidad (no documentada) de inclusión implícita quedó reemplazada por la definición explícita de inclusion_fin_head; por lo tanto, para mantener el comportamiento existente en las aplicaciones que estuvieran utilizando este archivo, se deberá definir inclusion_fin_head con valor 'head.inc.php'.

Para evitar posibles problemas de compatibilidad en aplicaciones existentes, el comportamiento predeterminado sigue siendo no procesar XInclude en los listados asociados; para hacerlo, es necesario habilitarlo explícitamente, usando uno de los siguientes atributos:

• Para toda la aplicación: /aplicacion/generacion/formularios/@procesar-xinclude-documentos-relacionados = "true" en aplicacion.xml.
• Para un campo particular: campo/entidad/@procesar-xinclude = "true" en *_formulario.xml.

• [r2.17.0.927 - 24/05/2016] Se agrega la posibilidad de incluir separadores entre los campos: buscador/personalizado-simple/separador.
• [r2.17.0.926 - 24/05/2016] Nuevo atributo, en tipos texto, calendario, combo y combobd: buscador/personalizado-simple//{texto|calendario|combo|combobd}/@etiqueta-pos.
• [r2.17.0.925 - 24/05/2016] Nuevo atributo: buscador/personalizado-simple//*/@es-param-condicion-consulta.

• Nuevo parámetro en el método Auditor::log(): $en_error.
• Nuevas constantes que definen los valores posibles para este parámetro: Auditor::EN_ERROR_*.

Para que se tengan en cuenta los valores mencionados, debe estar definida la constante PHP XGAP_COMANDO_GENERACION_PDF (ver item previo).

Esta nueva funcionalidad está definida en el código de salida predeterminado, es decir que no se aplica en reportes que usan salida personalizada (/odt/configuracion/salida).

• [r2.16.1.842 - 06/10/2015] Nuevo elemento: /odt/configuracion/template/xslt-adicional.
• [r2.16.1.843 - 06/10/2015] Nuevo elemento: /odt/configuracion/reporte/meta.

• [r2.16.1.824 - 08/09/2015] Los siguientes atributos admiten expresiones embebidas, cuando están habilitadas para la aplicación (/aplicacion/generacion/expresiones-embebidas/@habilitar = 'true'): carpeta/@nombre, carpeta/@roles, carpeta/@id, carpeta/@tip, carpeta/@clase, item/@nombre, item/@roles, item/@id, item/@url, item/@tip, item/@clase, separador/@roles.
• [r2.16.1.825 - 08/09/2015] Nuevos atributos para items: item/@target y item/@usar-seguridad.

• Nuevo parámetro para los métodos PHP Form::combo_bd() y Form::combo_bd_sin_hidden(): $texto_opcion_vacia.
• Nuevo elemento y atributo para campos de formulario @tipo="ComboBD": campo/opcion-combobd-seleccion-vacia/@texto.

Nuevo parámetro en los métodos StartTrans(), CompleteTrans() y FailTrans(): $log = true, para indicar si se debe registrar o no.

• Nuevo parámetro de configuración de la aplicación: tipos_mensaje_incluir_log.
• Nuevo parámetro en los métodos PHP ObjetoMensaje::nuevo() y ObjetoMensaje::nuevoErrorPredefinido(): $guardar_backtrace.
• Nuevo método PHP ObjetoMensaje::backtrace().

Si en el mismo directorio que xgap.php existe un archivo con nombre xgap.local.php, se usan las definiciones de constantes de configuración que haya en este último, en vez de las correspondientes del primero.

Esto permite mantener xgap.php intacto, simplificando el proceso de actualización de la versión instalada de XGAP, ya que no se pierde la configuración si se sobreescribe este archivo con la nueva versión.

Advertencia de compatibilidad: La versión mínima requerida de PHP pasa a ser 5.2.4.

• Nueva sección en la guía de usuario para documentar este modo: Administración → Modo de mantenimiento.
• Nuevos parámetros de configuración en_mantenimiento, pagina_mantenimiento, mensaje_mantenimiento, paginas_accesibles_en_mantenimiento y rolfs_acceso_en_mantenimiento.
• Nueva página predefinida: aplicacionenmantenimiento_contenido.xml.

Nuevas constantes iSeguridad::VAR_SESION_ID_USUARIO_ACTUAL, iSeguridad::VAR_SESION_NOMBRE_CORTO_USUARIO_ACTUAL, iSeguridad::VAR_SESION_NOMBRE_COMPLETO_USUARIO_ACTUAL, iSeguridad::VAR_SESION_ID_ROLF_ACTUAL y iSeguridad::VAR_SESION_NOMBRE_ROLF_ACTUAL.

Nuevos métodos iSeguridad::usuarioLogueado() y iSeguridad::rolFuncionalUsuarioLogueado(), implementados en Seguridad::usuarioLogueado() y Seguridad::rolFuncionalUsuarioLogueado().

Advertencia de compatibilidad: Las aplicaciones que utilicen una clase de seguridad personalizada (parámetro de configuración clase_seguridad) que no herede de la implementación provista por XGAP (clase Seguridad) deberán implementar estos métodos.

• Se agrega la posibilidad de mostrar acciones predefinidas en los mensajes, una para cerrar el cuadro de mensajes y otra para mantenerlo visible (transformarlo en permanente cuando es transitorio). Estas acciones están controladas por nuevos parámetros de configuración de la aplicación: mostrar_acciones_mensajes_flash, accion_mensajes_flash__cerrar__texto, accion_mensajes_flash__mantener__texto.
• Ahora se puede especificar el efecto a usar cuando se muestran y ocultan los mensajes, mediante los parámetros de configuración de la aplicación efecto_abrir_mensajes_flash_transitorios, efecto_cerrar_mensajes_flash_transitorios, efecto_abrir_mensajes_flash_permanentes, efecto_cerrar_mensajes_flash_permanentes

• Nuevo método Html::heading().
• Los métodos Html::cerrarTag(), Html::elemento(), Html::cerrarComentario() y Html::comentario() reciben un nuevo parámetro: $salto_linea. Si en la invocación no se pasa este parámetro, el comportamiento de los métodos es el mismo que antes.

El elemento generado es un button con clase ButtonLinkFields.

Advertencia de compatibilidad: Las páginas de estos tipos que incluyan manualmente formulario.js, por ejemplo mediante configuracion/inclusiones/archivo, deberían ser modificadas para quitar esta inclusión manual; de lo contrario el archivo se va a estar cargando dos veces.

Nuevos métodos en la clase PHP Flash (flash.inc.php): Flash::estaDeshabilitadoActual(), Flash::estaDeshabilitadoSiguiente(), Flash::cambiarDeshabilitadoActual(), Flash::cambiarDeshabilitadoSiguiente().

• En listado: @nombre-expr y @expr en /listado/configuracion/acciones/accion/destino/parametros/parametro, /listado/columnas/columna/imagen/miniatura/parametros/parametro, /listado/columnas/columna/imagen/link/parametros/parametro y /listado/columnas/acciones/accion/destino/parametros/parametro; @nombre-expr en /listado/columnas/columna/parametros-link/parametro.
• En master: @nombre-expr y @expr en /formulario/acciones/accion/parametros/parametro.

• Nuevos métodos: Request::esSeguro(), Request::esquema(), Request::host() y Request::puerto().
• El método Request::metodo() ahora retorna el resultado siempre en mayúsculas.

Además, en la parte inferior de la página principal del generador se agregaron links que llevan a esta nueva página (se muestra automáticamente uno por cada versión de motor instalada).

Se puede usar, por ejemplo, para que un formulario se vuelva a cargar después de realizar la operación, en vez de volver a la página de retorno normal.

Ejemplo: filtro de las opciones de un select de acuerdo al valor seleccionado en otro:

<select id="padre" name="padre">
  <option value="" selected="selected">--</option>
  <option value="p1">Padre 1</option>
  <option value="p2">Padre 2</option>
</select>
<select id="hijo" name="hijo">
  <option value="" selected="selected">--</option>
  <option value="h1">Hijo 1</option>
  <option value="h2">Hijo 2</option>
  <option value="h3">Hijo 3</option>
  <option value="h4">Hijo 4</option>
</select>
<script type="text/javascript">
jQuery(document).ready(function () {
  var combo_padre = obtener_elemento("padre"),
      combo_hijo = obtener_elemento("hijo"),
      datos_filtro = {
        "": true,
        "p1": [ "", "h2", "h3" ]
      };
  XGAP_FORM.Select.setOptionsData(combo_padre, "filtro", datos_filtro, [""], "value");
  (new XGAP_FORM.Select.Chained.ChildOptionsFilterByParentSelectedOptionData(
      combo_padre, combo_hijo, "filtro", "value", [""]))
      .applyFilterOnParentChange();
});
</script>

El resultado es:

• array 'metadatos'
• array 'valores'
• boolean 'agregado'

• Nuevos métodos PHP: Conexion::obtenerListaIndexadaPorClave() y Conexion::literalSql().
• Conexion::obtenerTodos() recibe dos nuevos parámetros opcionales: $numrows y $offset.
• Se modifica Conexion::expresionComparacionBinaria() para que acepte cualquier operador, no sólo uno de los predefinidos.

El elemento campo/validacion-cliente/predefinida tiene el mismo significado que campo/validacion y es la nueva forma recomendada de especificar el tipo de validación de formato, aunque campo/validacion se mantiene por compatibilidad.

Advertencia de compatibilidad: Para solucionar el problema fue necesario modificar DHTML Calendar para renombrar las propiedades que agrega a Date, es decir que cambió parte del API definido por este widget. Específicamente, los cambios fueron los siguientes:

Se provee una manera de indicar por cada solicitud el tipo de disposición de contenido con que se deben retornar documentos no HTML generados por la aplicación, ignorando durante dicha solicitud el valor del parámetro de configuración disposicion_contenido_imprimibles. Para ello se debe pasar en la solicitud un parámetro con el nombre dado por la constante RequestXgap::PARAMETRO_DISPOSICION_CONTENIDO_IMPRIMIBLES y el valor deseado para la disposición de contenido.

La función preparar_salida() ahora es un alias de Formateo::prepararSalidaString(), con algunas mejoras de rendimiento.

• [r2.15.0.543 - 11/05/2013] Nuevos métodos javascript XGAP_FORM.cambiarHabilitacionSeleccionable(), XGAP_FORM.deshabilitarSeleccionable() y XGAP_FORM.habilitarSeleccionable() (formulario.js).
• [r2.15.0.542 - 11/05/2013] Nuevos métodos javascript XGAP.cambiarHabilitacionLink(), XGAP.deshabilitarLink() y XGAP.habilitarLink() (utilidades.js).

Advertencia de compatibilidad: El agregado del tipo hace que cambie:

• el formato del archivo de auditoría; se agrega el tipo como segundo campo en cada línea.
• la estructura de la tabla de auditoría en la base de datos; se puede usar el script bd/update-2_15_0.sql para actualizar las bases de datos de aplicaciones existentes.

• [r2.15.0.488 - 21/01/2013] Nuevo parámetro de configuración de aplicación: duracion_token_csrf.
• [r2.15.0.487 - 21/01/2013] Cambio en la interfaz iSeguridad: nuevo método iSeguridad::destruirSesionAplicacion().

  Advertencia de compatibilidad: Las aplicaciones que utilicen una clase de seguridad personalizada (parámetro de configuración clase_seguridad) que no herede de la implementación provista por XGAP (clase Seguridad) deberán implementar este método.

• [r2.15.0.486 - 21/01/2013] Nuevas clases PHP: XgapRand (rand.inc.php) y XgapCsrf (csrf.inc.php).

  Advertencia de requerimientos: La clase XgapCsrf requiere que esté disponible la extensión Hash de PHP.

• [r2.15.0.485 - 21/01/2013] Nuevo parámetro de configuración: sal_hashes.
  Se incluye un botón en la página de configuración de la aplicación que permite generar un valor aleatorio para este parámetro.

  Advertencia de compatibilidad: Se debe agregar el parámetro sal_hashes al archivo de configuración de las aplicaciones existentes, dado que es requerido.

• [r2.15.0.484 - 21/01/2013] Nueva función javascript (utilidades.js): xgap_random_token().

• [r2.15.0.483 - 21/01/2013] Nuevo elemento para formularios: /formulario/firma-digital.
• [r2.15.0.482 - 21/01/2013] Nuevas clases e interfaces PHP: iXgapPublicKeyInfrastructure, iXgapStoredPublicKeyInfrastructure, iFirmaOperacion, XgapPublicKeyInfrastructure, XgapOpenSslPublicKeyInfrastructureTest, XgapDefaultOpenSslPublicKeyInfrastructure, FirmaOperacion, FirmaOperacionDefault.
• [r2.15.0.481 - 21/01/2013] Nueva constante booleana, disponible para las aplicaciones en tiempo de ejecución: XGAP_FIRMADO_OPERACIONES_HABILITADO; se define automáticamente durante la generación en xgap.php, de acuerdo al valor de aplicacion.xml:/aplicacion/seguridad/@usa-firmas-digitales.
• [r2.15.0.480 - 21/01/2013] Nueva opción de configuración de generación en aplicacion.xml: /aplicacion/seguridad/@usa-firmas-digitales. Permite habilitar o deshabilitar en tiempo de generación el uso del soporte de firmas.
• [r2.15.0.479 - 21/01/2013] Nuevos parámetros de configuración de la aplicación: archivo_clase_pki, clase_pki, archivo_clase_firmaoperacion, clase_firmaoperacion, frase_clave_privada_requerida, certificado_obligatorio_en_carga_clave_privada, codificador_datos_firmaoperacion y archivo_codificador_datos_firmaoperacion.

• Nuevos métodos: Contexto::existeSesion(), Contexto::idSesion(), Contexto::cambiarIdSesion() y Contexto::regenerarIdSesion().
• Por consistencia en los nombres, se agrega el método Contexto::destruirSesionAplicacion() con la misma funcionalidad que Contexto::destruir_sesion_aplicacion() y este último se hace obsoleto, disparando un aviso si se invoca.

Nuevo método PHP Contexto::obtenerTiempoUltimaActividad()

• Nuevos atributos para las definiciones de menúes: /menu/@cache, para indicar el tipo de cache a usar (por defecto se usa cache por rol), y /menu/@id para permitir que las aplicaciones guarden más de un menú en cache.
• Se reconoce un nuevo parámetro en los requests, definido por RequestXgap::PARAMETRO_RECARGA_MENU. Si está presente en el request, se invalida el cache y se reconstruye el menú.

Advertencia de compatibilidad: En el código generado ahora se convierten correctamente los caracteres XML especiales en entidades. Esto implica que si en un archivo de definición de menú se estaban escapando manualmente estos caracteres, se debe corregir para eliminar el escape manual. Por ejemplo, si ppal_menu.xml antes decía:
url="ciudad_listado.php?xgap_historial=reset&agregado=true"
se debe cambiar a:
url="ciudad_listado.php?xgap_historial=reset&agregado=true"

• Nuevos métodos Conexion::blobEncode() y Conexion::blobDecode().
• Los métodos Conexion::ejecutarConsulta(), Conexion::ejecutarConsultaLimitOffset(), Conexion::ejecutarConsultaSegura(), Conexion::ejecutarConsultaSeguraLimitOffset(), Conexion::ejecutarConsultaActualizacion(), Conexion::obtenerPrimeraFila(), Conexion::obtenerPrimero() y Conexion::obtenerTodos() reciben un nuevo parámetro $excepcion, que permite indicar si al producirse un error en la consulta se debe disparar una excepción o generar un error de aplicación, como ocurría hasta ahora; el comportamiento predeterminado sigue siendo generar un error.

Advertencia de compatibilidad: Ahora se verifica más estrictamente la correctitud de los parámetros de configuración durante la carga del archivo conf.inc.php, por lo cual se producirán excepciones en aplicaciones que tengan algún problema de configuración que antes no se detectaba, por ejemplo un parámetro requerido faltante o un parámetro entero definido como string.

• Nuevo método Json::decodificar()
• Nuevo parámetro $opciones en Json::codificar()
• Json::codificar() ahora dispara una excepción si no puede codificar el valor dado.

• Nuevo parámetro en Javascript::codificarString(): $comillas_dobles.
• Se pasa a tener la extensión XMLWriter como dependencia, si se usan menúes de details en masters.

• Nueva clase PHP: SmtpEmail (email.inc.php).
• Nuevos parámetros de configuración: XGAP_CONF_SMTP_HOST, XGAP_CONF_SMTP_PORT, XGAP_CONF_SMTP_USER, XGAP_CONF_SMTP_PASS, XGAP_CONF_SMTP_SECURITY.
• El método Mensaje::mail() ahora envía el email via SMTP si la aplicación está configurada para usar este protocolo.

• [r2.13.3.373 - 20/05/2011]
  • Nuevos elementos para campos en páginas de tipo formulario: /formulario/campos//campo/texto-autocompletable y /formulario/campos//campo/seleccionar-autocompletable, aplicables cuando campo[not(@tipo)] o campo[@tipo="Seleccionable"].
  • Nuevo método PHP: Form::autocompletable() (form.inc.php) y nueva función javascript XGAP_FORM.crearCampoAutocompletable() (formulario.js).
  • Nueva clase PHP: Json (json.inc.php).
• [r2.13.3.374 - 20/05/2011] Nueva función javascript XGAP_FORM.moverFocoAPrimerCampo() (formulario.js).

• Nueva clase singleton Pagina (pagina.inc.php)
• Nuevas clases ObjetoMensaje y ListaMensajes (mensaje.inc.php)
• Nuevos métodos Mensaje::mostrar() y Mensaje::mostrarLista() (mensaje.inc.php).

Se agrega un modo para que el código personalizado tenga la posibilidad de mostrar mensajes en las páginas de una forma estandarizada.
Ejemplo de uso:

<formulario>
    ...
    <codigoExtra>
        ...
        <codigo ubicacion="despues_inicializacion" tipo="PHP">
            <![CDATA[
            ...
            Pagina::instancia()->mensajes()->agregar(ObjetoMensaje::nuevo(
                    'No se pudo realizar la comprobaci&oacute;n.',
                    Mensaje::TIPO_ALERTA));
            ...
            ]]>
        </codigo>
        ...
    </codigoextra>
    ...
</formulario>

Los mensajes almacenados en Pagina::instancia()->mensajes() se muestran automáticamente en páginas de tipo formulario, formulario_reporte, master, listado, seleccion y seleccion_m. Para mostrarlos en páginas de tipo contenido, se puede incluir código similar al siguiente dentro de /pagina/contenido:

if (!Pagina::instancia()->mensajes()->isEmpty()) {
    Mensaje::mostrarLista(Pagina::instancia()->mensajes(), true, null, 'cont-msjs-pag');
}

• Nuevos parámetros en Http::noCache(): $send_content_type, $media_type, $charset.
• Http::headerContentType() ahora no envía charset si el parámetro $charset es vacío.

• Nuevos métodos: Conexion.estaConectado() y Conexion.reconectar().
• Cambios en los metadatos retornados por Conexion.metaDatos():
  • Se incluyen tres nuevos campos: 'gentype', 'size' y 'scale'. El campo 'gentype' puede tomar cualquiera de los valores definidos por las nuevas constantes Conexion::DATATYPE_*.
  • Se modifican los valores devueltos en los campos 'len' y 'clen', dado que eran inconsistentes: en algunos casos representaban la longitud del campo y en otros su tamaño; ahora corresponden siempre a la longitud y el campo 'size' al tamaño.

• Nuevos parámetros de configuración de la aplicación tecla_acceso_boton_agregar, tecla_acceso_boton_agregar_seguir, tecla_acceso_boton_borrar, tecla_acceso_boton_cancelar y tecla_acceso_boton_guardar.
• Nuevos atributos /formulario/configuracion/boton-agregar/@teclaacceso, /formulario/configuracion/boton-agregar-seguir/@teclaacceso, /formulario/configuracion/boton-borrar/@teclaacceso, /formulario/configuracion/boton-cancelar/@teclaacceso y /formulario/configuracion/boton-guardar/@teclaacceso.

• error_formulario_contenido.xml [r263]
• error_contenido.xml [r263]
• index_contenido.xml [r296]
• login_contenido.xml [r298]
• logout_contenido.xml [r298]
• seguridad_contenido.xml [r321]
• seleccionarrol_contenido.xml [r323]

• Nuevo método Flash::instancia().
• El método Flash::mantener() ahora mantiene también el tiempo de presentación actual; este comportamiento se puede controlar con el nuevo parámetro $mantener_tiempo_presentacion.

• Nuevo elemento para campos de formulario de tipo 'Lista' y 'ListaBD': /formulario//campos//campo/controles-seleccion-lista, que indica que se debe adjuntar a la lista una serie de controles para modificar la selección de sus elementos, los cuales permiten seleccionar y deseleccionar todos los elementos, y restaurar la selección inicial.
  Es posible especificar opciones para estos controles mediante elementos hijos de controles-seleccion-lista.
• Nuevos parámetros para Form::select_multiple() (form.inc.php): $controles_seleccion y $opciones_controles_seleccion.
• Nueva función javascript (formulario.js): restaurarSeleccionSelect().

• Cambios en la clase Flash: nuevos métodos Flash::tiempoPresentacionActual(), Flash::cambiarTiempoPresentacionActual(), Flash::tiempoPresentacionSiguiente() y Flash::cambiarTiempoPresentacionSiguiente(); nueva constante Flash::TIEMPO_PRESENTACION_INDETERMINADO.
• Se elimina la constante Componentes::DURACION_MENSAJE_FLASH.

• Nuevos tipos de campo de formulario (/formulario/campos//campo/@tipo): Lista y ListaBD.
• Nuevo elemento para campos de formulario de tipo Combo o Radio (/formulario/campos//campo[@tipo="Combo" or @tipo="Radio"]): select/options, alternativo al ya existente select/option.

• Nuevos métodos PHP: Html::atributoTexto() y Html::atributoSimple().
• Se escapa correctamente (a) la salida HTML generada por Html::abrirTag() y el parámetro $titulo de los métodos de la clase Form; (b) la salida javascript producida por la clase Tooltip; (c) el código PHP generado a partir de /formulario/campos//campo/tip, /formulario/campos//campo[@tipo='Link']/etiqueta, /formulario/campos//campo[@tipo='Link']/click y /formulario/campos//campo[@tipo='Link']/destino-link/parametros/parametro/@valor. Advertencia de compatibilidad: Esto provoca problemas en aplicaciones existentes que escapan el texto manualmente en los lugares mencionados, dado que se produce un doble escape.

• Nuevo atributo: validacionExtra/@metodo-http.
• El código PHP en validacionExtra/codigo tiene disponibles nuevos parámetros: &$mensaje_usuario, &$mensaje_debug y &$params_extra, que permiten pasar mensajes y parámetros arbitrarios a la página de error.