Diferencia entre revisiones de «Personalización avanzada del STE»

De Egeasy
Saltar a: navegación, buscar
 
 
(No se muestran 6 ediciones intermedias del mismo usuario)
Línea 1: Línea 1:
 
__TOC__
 
__TOC__
 +
=Personalizar el registro de usuarios=
 +
La aplicación web del Sistema de Tramitación Electrónica, dispone de dos tipo de registro de usuarios, libre y cerrado, el cual lo podemos configurar desde el fichero ''webservice.ini'' (Vease [[Cómo integrar el Sistema de Tramitación Electrónica en egeasy]]).
 +
 +
==Tipos de registro de usuarios==
 +
 +
*'''Registro cerrado'''
 +
Para configurar la aplicación web, para un tipo de registro cerrado, donde ningún usuario pueda darse de alta en el servicio, sin que un administrador de su autorización, debemos por en el fichero ''webservice.ini'' la etiqueta ''TYPE_REGISTRATION'' con el valor ''Close''.
 +
 +
*'''Registro libre'''
 +
Para configurar la aplicación web, para un tipo de registro libre, donde cualquier usuario pueda darse de alta en el servicio, sin ninguna intervención de un administrador, debemos por en el fichero ''webservice.ini'' la etiqueta ''TYPE_REGISTRATION'' con el valor ''Free''.
 +
 +
==El archivo registration.xml==
 +
En la aplicación web del Sistema de Tramitación Electrónica, se puede personalizar el formulario de registro de usuario, para introducir los campos necesarios. Podemos definir distintos tipos de campos en el formulario de registro, los tipos son: ''texto'', ''entero'', ''moneda'' y ''fecha''.
 +
 +
 +
Los campo se construyen en el fichero ''registration.xml'' con la siguiente sintaxis:
 +
*Campo simple
 +
<field_value Field_Identifier="'''IDENTIFICADOR'''" Field_Name="'''NOMBRE_CAMPO'''" Field_Type="'''TIPO_CAMPO'''">
 +
</field_value>
 +
*Campo deplegable
 +
<field_value Field_Identifier="'''IDENTIFICADOR'''" Field_Name="'''NOMBRE_CAMPO'''" Field_Type="'''TIPO_CAMPO'''">
 +
  <allowed_values>
 +
    <item>'''VALOR_1'''</item>
 +
      .
 +
      .
 +
      .
 +
    <item>'''VALOR_N'''</item>
 +
  </allowed_values>
 +
</field_value>
 +
 +
Los valores que están en negrita en la sintaxis simbolizan lo siguiente:
 +
<br>'''IDENTIFICADOR''': Numero único en el fichero que identifica cada campo.
 +
<br>'''NOMBRE_CAMPO''': Nombre que queremos darle al campo en el formulario de registro.
 +
<br>'''TIPO_CAMPO''': Tipo de campo que queremos definir en el formulario. Los posibles valores son ''ftString'', ''ftInteger'', ''ftCurrency'' y ''ftDatetime''.
 +
<br>'''VALOR''': Valor que queremos que se liste en el campo desplegable.
 +
 +
A continuacion podemos ver un ejemplo de cada tipo de campo que se pueden definir en el fichero ''registration.xml''.
 +
 +
*Ejemplo de campo texto
 +
<field_value Field_Identifier="3" Field_Name="Teléfono 2" Field_Type="ftString">
 +
</field_value>
 +
 +
*Ejemplo de campo entero
 +
<field_value Field_Identifier="8" Field_Name="Fax" Field_Type="ftInteger">
 +
</field_value>
 +
 +
*Ejemplo de un campo texto desplegable
 +
<field_value Field_Identifier="1" Field_Name="Género" Field_Type="ftString">
 +
  <allowed_values>
 +
    <item>Masculino</item>
 +
    <item>Femenino</item>
 +
  </allowed_values>
 +
</field_value>
 +
 +
*Ejemplo de campo moneda
 +
<field_value Field_Identifier="9" Field_Name="Ingresos" Field_Type="ftCurrency">
 +
</field_value>
 +
*Ejemplo de campo fecha
 +
<field_value Field_Identifier="10" Field_Name="Fecha de nacimiento" Field_Type="ftDatetime">
 +
</field_value>
 +
 +
 +
A continuación vemos un ejemplo de un posible fichero de registro de usuario.
 +
<?xml version="1.0" encoding="ISO-8859-1"?>
 +
<registration_form>
 +
  <field_value Field_Identifier="1" Field_Name="Género" Field_Type="ftString">
 +
      <allowed_values>
 +
        <item>Masculino</item>
 +
        <item>Femenino</item>
 +
      </allowed_values>
 +
  </field_value>
 +
  <field_value Field_Identifier="2" Field_Name="Teléfono 1" Field_Type="ftString">
 +
  </field_value>
 +
  <field_value Field_Identifier="3" Field_Name="Teléfono 2" Field_Type="ftString">
 +
  </field_value>
 +
  <field_value Field_Identifier="8" Field_Name="Fax" Field_Type="ftInteger">
 +
  </field_value>
 +
  <field_value Field_Identifier="4" Field_Name="Dirección" Field_Type="ftString">
 +
  </field_value>
 +
  <field_value Field_Identifier="5" Field_Name="Código postal" Field_Type="ftString">
 +
  </field_value>
 +
  <field_value Field_Identifier="6" Field_Name="Localidad" Field_Type="ftString">
 +
  </field_value>
 +
  <field_value Field_Identifier="7" Field_Name="Provincia" Field_Type="ftString">
 +
  </field_value>
 +
</registration_form>
 +
 +
=Personalizar el CSS=
 +
Para personalizar la apariencia de la aplicación web, podemos modificar los archivos CSS que estan en la ruta C:\xampp\tomcat\webapps\ste\WebContent\styles, donde el código CSS esta organizado en distintos archivos para una mejor localización.
 +
 +
=Personalizar el HTML=
 +
Para personalizar el html de la aplicación web, podemos modificar los archivos html que estan en la ruta C:\xampp\tomcat\webapps\ste\templates, donde el código html esta organizado en distintos archivos para una mejor localización.
 +
 +
=Personalizar el texto en la aplicación web=
 +
Para personalizar el texto que aparece en la aplicación web, que es estático y no depende de la programación en ODL de la plataforma egeasy, disponemos en la ruta C:\xampp\tomcat\webapps\ste\languages de cuatro ficheros por idioma. El nombre de los ficheros se construye mediante  NOMBREIDIOMA.NOMBREFICHERO.lang. Los archivos que disponemos para el idioma español, son los siguientes
 +
*'''es.errors.lang''': Fichero que contiene el texto referente a los mensajes de error
 +
*'''es.labels.lang''': Fichero que contiene el texto referente al nombre de los botones, link, etc.
 +
*'''es.images.lang''': Fichero que contiene las imagenes que se tienen definidas en la aplicación web.
 +
*'''es.messages.lang''': Fichero que contiene el texto referente a los mensajes de la aplicación web, que son estaticos. No confundir con los mensajes que podemos programar mediante ODL en la plataforma egeasy.
 +
 +
<!--
 +
=Personalizar las vistas=
 +
En la aplicación web del Sistema de Tramitación Electrónica, podemos crear vistas personalizadas de las tareas que interactuan con la aplicación web. Esto permite modificar y dar el comportamiento a los campos que se desee. Para el desarrollo de este articulo vamos a plantear el ejemplo de aplicar formulas para calcular valores de campos a partir de lo introducido por el usuario en algún otro campo.
 +
-->
 +
 +
 +
  
  

Revisión actual del 11:26 22 jun 2009

Personalizar el registro de usuarios

La aplicación web del Sistema de Tramitación Electrónica, dispone de dos tipo de registro de usuarios, libre y cerrado, el cual lo podemos configurar desde el fichero webservice.ini (Vease Cómo integrar el Sistema de Tramitación Electrónica en egeasy).

Tipos de registro de usuarios

  • Registro cerrado

Para configurar la aplicación web, para un tipo de registro cerrado, donde ningún usuario pueda darse de alta en el servicio, sin que un administrador de su autorización, debemos por en el fichero webservice.ini la etiqueta TYPE_REGISTRATION con el valor Close.

  • Registro libre

Para configurar la aplicación web, para un tipo de registro libre, donde cualquier usuario pueda darse de alta en el servicio, sin ninguna intervención de un administrador, debemos por en el fichero webservice.ini la etiqueta TYPE_REGISTRATION con el valor Free.

El archivo registration.xml

En la aplicación web del Sistema de Tramitación Electrónica, se puede personalizar el formulario de registro de usuario, para introducir los campos necesarios. Podemos definir distintos tipos de campos en el formulario de registro, los tipos son: texto, entero, moneda y fecha.


Los campo se construyen en el fichero registration.xml con la siguiente sintaxis:

  • Campo simple
<field_value Field_Identifier="IDENTIFICADOR" Field_Name="NOMBRE_CAMPO" Field_Type="TIPO_CAMPO">
</field_value>
  • Campo deplegable
<field_value Field_Identifier="IDENTIFICADOR" Field_Name="NOMBRE_CAMPO" Field_Type="TIPO_CAMPO">
  <allowed_values>
    <item>VALOR_1</item>
      .
      .
      .
    <item>VALOR_N</item>
  </allowed_values>
</field_value>

Los valores que están en negrita en la sintaxis simbolizan lo siguiente:
IDENTIFICADOR: Numero único en el fichero que identifica cada campo.
NOMBRE_CAMPO: Nombre que queremos darle al campo en el formulario de registro.
TIPO_CAMPO: Tipo de campo que queremos definir en el formulario. Los posibles valores son ftString, ftInteger, ftCurrency y ftDatetime.
VALOR: Valor que queremos que se liste en el campo desplegable.

A continuacion podemos ver un ejemplo de cada tipo de campo que se pueden definir en el fichero registration.xml.

  • Ejemplo de campo texto
<field_value Field_Identifier="3" Field_Name="Teléfono 2" Field_Type="ftString">
</field_value>
  • Ejemplo de campo entero
<field_value Field_Identifier="8" Field_Name="Fax" Field_Type="ftInteger">
</field_value>
  • Ejemplo de un campo texto desplegable
<field_value Field_Identifier="1" Field_Name="Género" Field_Type="ftString">
  <allowed_values>
    <item>Masculino</item>
    <item>Femenino</item>
  </allowed_values>
</field_value>
  • Ejemplo de campo moneda
<field_value Field_Identifier="9" Field_Name="Ingresos" Field_Type="ftCurrency">
</field_value>
  • Ejemplo de campo fecha
<field_value Field_Identifier="10" Field_Name="Fecha de nacimiento" Field_Type="ftDatetime">
</field_value>


A continuación vemos un ejemplo de un posible fichero de registro de usuario.

<?xml version="1.0" encoding="ISO-8859-1"?>
<registration_form>
  <field_value Field_Identifier="1" Field_Name="Género" Field_Type="ftString">
     <allowed_values>
        <item>Masculino</item>
        <item>Femenino</item>
     </allowed_values>
  </field_value>
  <field_value Field_Identifier="2" Field_Name="Teléfono 1" Field_Type="ftString">
  </field_value>
  <field_value Field_Identifier="3" Field_Name="Teléfono 2" Field_Type="ftString">
  </field_value>
  <field_value Field_Identifier="8" Field_Name="Fax" Field_Type="ftInteger">
  </field_value>
  <field_value Field_Identifier="4" Field_Name="Dirección" Field_Type="ftString">
  </field_value>
  <field_value Field_Identifier="5" Field_Name="Código postal" Field_Type="ftString">
  </field_value>
  <field_value Field_Identifier="6" Field_Name="Localidad" Field_Type="ftString">
  </field_value>
  <field_value Field_Identifier="7" Field_Name="Provincia" Field_Type="ftString">
  </field_value>
</registration_form>

Personalizar el CSS

Para personalizar la apariencia de la aplicación web, podemos modificar los archivos CSS que estan en la ruta C:\xampp\tomcat\webapps\ste\WebContent\styles, donde el código CSS esta organizado en distintos archivos para una mejor localización.

Personalizar el HTML

Para personalizar el html de la aplicación web, podemos modificar los archivos html que estan en la ruta C:\xampp\tomcat\webapps\ste\templates, donde el código html esta organizado en distintos archivos para una mejor localización.

Personalizar el texto en la aplicación web

Para personalizar el texto que aparece en la aplicación web, que es estático y no depende de la programación en ODL de la plataforma egeasy, disponemos en la ruta C:\xampp\tomcat\webapps\ste\languages de cuatro ficheros por idioma. El nombre de los ficheros se construye mediante NOMBREIDIOMA.NOMBREFICHERO.lang. Los archivos que disponemos para el idioma español, son los siguientes

  • es.errors.lang: Fichero que contiene el texto referente a los mensajes de error
  • es.labels.lang: Fichero que contiene el texto referente al nombre de los botones, link, etc.
  • es.images.lang: Fichero que contiene las imagenes que se tienen definidas en la aplicación web.
  • es.messages.lang: Fichero que contiene el texto referente a los mensajes de la aplicación web, que son estaticos. No confundir con los mensajes que podemos programar mediante ODL en la plataforma egeasy.