Manual de uso de la SUBDIRECCIÓN GENERAL DE TECNOLOGÍAS DE LA INFORMACIÓN Y DE LAS COMUNICACIONES Referencia: ITALOMUAIV01 Nº Versión: 1.0 Fecha: Agosto de 2010
Listados con Organismos) Manual de uso de la HISTÓRICO VERSIÓN AUTOR DESCRIPCIÓN FECHA v1.0 Alicia Ranz Ramos Documento original 10/09/2010 Ref.:ITALOMUSAI01 2
Listados con Organismos) Manual de uso de la ÍNDICE 1. INTRODUCCIÓN... 4 1.1. OBJETO DE ESTE DOCUMENTO... 4 1.2. ALCANCE... 4 1.3. DESTINATARIOS... 4 2. CARACTERÍSTICAS GENERALES... 5 3. ACCESO A LA WEB... 6 4. PERFILES... 8 4.1. SUPERADMINISTRADOR... 8 4.2. ADMINISTRADOR... 8 4.3. CONSULTA... 9 4.4. ACCIONES SEGÚN EL PERFIL... 9 5. FUNCIONALIDAD... 11 5.1. GRUPOS... 11 5.2. APLICACIONES... 15 5.3. USUARIOS... 19 5.4. PERFILES... 21 5.5. UNIDADES ORGÁNICAS... 25 5.6. ORGANISMOS DESTINATARIOS... 27 5.7. ESQUEMAS DE DATOS... 29 5.8. TIPOS DE COMUNICACIONES... 33 5.9. LISTADOS... 36 5.10. DATOS DE USUARIO... 37 5.11. CAMBIAR GRUPO... 37 Ref.:ITALOMUSAI01 3
1. INTRODUCCIÓN 1.1. OBJETO DE ESTE DOCUMENTO En este documento se exponen las características de uso de la. 1.2. ALCANCE La aplicación de la se ha realizado para poder mantener y administrar la información del módulo ITALO. El acceso se realiza con conexión segura (https) y con identificación de usuarios, permitiéndose el empleo de certificado electrónico o usuario y contraseña. 1.3. DESTINATARIOS Los destinatarios de este documento son todos aquellos analistas-desarrolladores que creen una aplicación que utilice ITALO. Ref.:ITALOMUSAI01 4
2. CARACTERÍSTICAS GENERALES La web de está destinada a gestionar los datos necesarios para el envío de información de los expedientes asociados a las aplicaciones del Mityc a Organismos destinatarios como la CNE o CORES. El acceso a la aplicación se basa en un sistema de usuarios y perfiles. El perfil del usuario (Superadministrador, Administrador o Consulta) determina la información a la que puede acceder y las acciones que puede realizar en la aplicación. Cada usuario sólo puede pertenecer a un único perfil (por grupo). La identificación del interesado se realiza mediante usuario y contraseña o con certificado digital. Sólo podrán acceder a la web aquellos usuarios que tengan un perfil asignado para un grupo. Ref.:ITALOMUSAI01 5
3. ACCESO A LA WEB Al acceder a la web de ITALO se muestra una pantalla inicial en la que el usuario ha de identificarse, pudiendo hacerlo por usuario y contraseña o por certificado digital : Si el usuario sólo pertenece a un grupo, accederá al menú principal de la aplicación : En caso contrario deberá seleccionar el grupo con el que va a trabajar : Ref.:ITALOMUSAI01 6
Una vez seleccionado el grupo accederá al citado menú principal de la aplicación. Ref.:ITALOMUSAI01 7
4. PERFILES 4.1. SUPERADMINISTRADOR Al seleccionar la opción Administración del menú principal, el SuperAdministrador accederá a las opciones que se muestran en la siguiente pantalla: El SuperAdministrador podrá realizar todas las tareas de administración sobre todos los grupos existentes. Este perfil permite eliminar elementos, algo que el resto de los perfiles no pueden hacer. Es el único perfil que tendrá acceso a la opción Grupos. 4.2. ADMINISTRADOR Para el perfil Administrador se mostrarán las siguientes opciones de administración: Ref.:ITALOMUSAI01 8
El Administrador podrá realizar todas las tareas de administración sobre el grupo al que pertenezca. Este perfil no permite eliminar elementos. 4.3. CONSULTA El perfil Consulta tendrá acceso a las mismas opciones de administración que el perfil Administrador. Este perfil sólo podrá consultar la información del grupo al que pertenezca: aplicaciones, usuarios, perfiles, etc. 4.4. ACCIONES SEGÚN EL PERFIL En la tabla que se muestra a continuación se especifican las posibles acciones a realizar en cada pantalla del menú de administración según el perfil del usuario: Ref.:ITALOMUSAI01 9
Perfiles - SA: SuperAdministrador - A: Administrador - C: Consulta Acciones - I: insertar - M: modificar - E: eliminar - V: ver la información Grupos Aplicaciones Usuarios Perfiles U.O O.D Esquemas T.Comunicación SA I,M,E I,M,E I,M,E I,M,E I,M,E I,M,E I,M,E I,M,E A I,M I,M I,M I,M V V I,M I,M C V V V V V V V V * Las acciones que realizan los perfiles Administrador y Consulta se restringen al grupo al que pertenecen. Ref.:ITALOMUSAI01 10
5. FUNCIONALIDAD Las funcionalidades que se podrán llevar a cabo son las siguientes: - Administración o Grupos o Aplicaciones o Usuarios o Perfiles o Unidades Orgánicas o Organismos Destinatarios o Esquemas de Datos o Tipos de Comunicaciones - Listados - Datos Usuario - Cambiar Grupo 5.1. GRUPOS Al seleccionar la opción Grupos se accede a la siguiente pantalla: Ref.:ITALOMUSAI01 11
Sólo el Superadministrador podrá gestionar la información relativa a los grupos. En la parte superior se muestra un buscador que permite buscar un grupo a partir de su nombre. Al pulsar Buscar se mostrará en el listado inferior el resultado de la búsqueda. Alta de Grupo Para insertar un grupo se ha de pulsar en el botón Crear Grupo, desplegándose una ficha en la que se muestran los datos a rellenar: Un campo en color amarillo indica que dicho dato es obligatorio, y al Guardar sin haberlo rellenado se mostrará un mensaje de aviso como el siguiente: Ref.:ITALOMUSAI01 12
El alta de un grupo se realiza con el campo Activo marcado por defecto, dato que posteriormente podrá ser modificado en caso de que se desee desactivar un grupo. Al registrar el grupo en la base de datos se le asocia un usuario con perfil SuperAdministrador cuyo número de identificación (NifResponsable) será utilizado como parámetro en la llamada que desde cada aplicación se hará al servicio web de ITALO para el envío de la información al organismo destinatario. Modificación de Grupo Para modificar un grupo se debe pulsar en el icono con forma de lupa desplegándose una ficha con los datos del mismo: Ref.:ITALOMUSAI01 13
Tras hacer los cambios oportunos se hará clic en Guardar, mostrándose un mensaje que indica la correcta realización de la operación. Si no se desean realizar modificaciones se puede pulsar Cancelar. Tanto al crear como al modificar se validará que no se repita el nombre del grupo. Eliminación de Grupo Para borrar un grupo se ha de pulsar sobre el botón Eliminar, que sólo será visible en caso de que el grupo se pueda borrar, es decir, en caso de que no tenga aplicaciones o perfiles asociados. Se mostrará el siguiente panel de confirmación: Si se hace clic en Borrar Grupo éste se eliminará definitivamente. Si no se desea realizar dicha operación se puede pulsar Cancelar borrado. Ref.:ITALOMUSAI01 14
5.2. APLICACIONES Al seleccionar la opción Aplicaciones se accede a la siguiente pantalla: Si el perfil del usuario es Superadministrador se visualizan todos los grupos, en caso contrario se muestra únicamente el grupo al que pertenece el usuario. Tanto el Superadministrador como el Administrador podrán insertar y modificar registros, siendo el perfil Consulta el que sólo podrá visualizar la información. Al igual que en la pantalla de Grupos, en la parte superior se muestra un buscador que permite buscar un grupo a partir de su nombre. Alta de Aplicación Para insertar una aplicación se ha de seleccionar un grupo, desplegándose una ficha con los datos del mismo, y si tiene aplicaciones ya asignadas se muestran en la parte inferior: Ref.:ITALOMUSAI01 15
Si seleccionamos un grupo desactivado no se mostrarán las aplicaciones que tenga asociadas. Ej: Ref.:ITALOMUSAI01 16
Para dar de alta una aplicación se ha de pulsar en el botón Crear Aplicación, mostrándose los campos a rellenar: El alta de un grupo se realiza con los campos Activo y Firma marcados por defecto, datos que posteriormente podrán ser modificados en caso de que se desee desactivar una aplicación o no se firme la información enviada al Organismo Destinatario. Modificación de Aplicación Para modificar una aplicación se ha de seleccionar previamente, desplegándose una ficha con sus datos: Ref.:ITALOMUSAI01 17
Tras hacer los cambios oportunos se hará clic en Guardar. Tanto al crear como al modificar se validará que no se repita el código de Registro Telemático asociado a la aplicación. Eliminación de la Aplicación Para borrar una aplicación se ha de pulsar sobre el botón Eliminar, que sólo será visible en caso de que la aplicación se pueda borrar, es decir, en caso de que no se hayan realizado envíos de información a un organismo destinatario o en caso de que no tenga esquemas de validación de la información asociados (ficheros XSD de datos específicos, que trataremos en líneas posteriores). Tras pulsar dicho botón se mostrará un panel de confirmación para desistir de la operación o eliminar definitivamente la aplicación: Ref.:ITALOMUSAI01 18
5.3. USUARIOS Al seleccionar la opción Usuarios se accede a la siguiente pantalla: La información mostrada depende del perfil: - el Superadministrador podrá gestionar la información de cualquier usuario - el Administrador sólo gestionará los usuarios que tengan un perfil para el grupo al que éste pertenezca. - el perfil Consulta sólo visualizará la misma información a la que tiene acceso el Administrador. En la parte superior se muestra un buscador que permite buscar un usuario a partir de su NIF. Alta de Usuario Para insertar un usuario se ha de pulsar en Crear Usuario, mostrándose los campos a rellenar: Ref.:ITALOMUSAI01 19
El campo Validar NIF/NIE se muestra marcado por defecto, lo que implica que el NIF insertado ha de ser válido. En caso de dar de alta un NIF no válido (ej: NIFResponsable) ha de desmarcarse dicha opción. Modificación de Usuario Para modificar un usuario se ha de seleccionar previamente, desplegándose una ficha con sus datos: Ref.:ITALOMUSAI01 20
Tras hacer los cambios oportunos se hará clic en Guardar. Tanto al crear como al modificar se validarán los campos NIF (en caso de estar marcada la opción Validar NIF/NIE) y email. Eliminación Para borrar un usuario se ha de pulsar sobre el botón Eliminar, que sólo será visible en caso de que el usuario se pueda borrar, es decir, en caso de que no tenga perfil/es asociados a un grupo/os. Se mostrará el siguiente panel de confirmación para desistir de la operación o eliminar definitivamente el usuario: 5.4. PERFILES Al seleccionar la opción Perfiles se accede a la siguiente pantalla: Ref.:ITALOMUSAI01 21
Al igual que en el caso de los usuarios, el perfil SuperAdministrador podrá gestionar los perfiles de cualquier usuario, mientras que el perfil Administrador sólo lo hará para los usuarios de su grupo. En la parte superior se muestra un buscador que permite buscar un grupo a partir de su nombre. Alta de Perfil Para asignar un perfil a un usuario se ha de seleccionar previamente un grupo, mostrándose los datos del mismo y los perfiles que ya tiene asociados (en caso de que los tenga): Si seleccionamos un grupo desactivado no se muestran los perfiles asociados. Ej: Ref.:ITALOMUSAI01 22
Para dar de alta un perfil se ha de pulsar en el botón Crear Perfil, mostrándose los campos a rellenar: Se ha de buscar un usuario rellenando el campo NIF y pulsando en el icono con forma de lupa. Si se encuentran resultados se cargarán los datos del usuario, tras lo cual se deberá seleccionar una opción del combo Perfiles y pulsar finalmente Guardar para registrar el perfil. Si no se encuentran resultados se indicará con el siguiente mensaje: Ref.:ITALOMUSAI01 23
Si el usuario ya tiene asignado un perfil para el grupo en cuestión se mostrará el siguiente aviso: Modificación de Perfil Para modificar un perfil se ha de seleccionar previamente, desplegándose una ficha con sus datos: Tras seleccionar la opción en el campo Perfiles se hará clic en Guardar. Eliminación de Perfil Para borrar un perfil se ha de pulsar sobre el botón Eliminar, mostrándose el siguiente panel de confirmación para desistir de la operación o eliminar definitivamente el perfil: Ref.:ITALOMUSAI01 24
5.5. UNIDADES ORGÁNICAS Al seleccionar la opción Unidades Orgánicas se accede a la siguiente pantalla: El perfil Superadministrador es el único que podrá gestionar la información relativa a las Unidades Orgánicas. El resto de perfiles sólo podrán consultar la información. En la parte superior se muestra un buscador que permite buscar una Unidad Orgánica a partir de su nombre. Ref.:ITALOMUSAI01 25
Alta de Unidad Orgánica Para insertar una Unidad Orgánica se ha de pulsar en Crear Unidad Orgánica, mostrándose los campos a rellenar: Tras pulsar Guardar los datos quedarán registrados. Modificación de Unidad Orgánica Para modificar una Unidad Orgánica se ha de seleccionar previamente, desplegándose una ficha con sus datos: Ref.:ITALOMUSAI01 26
Tras hacer los cambios oportunos se hará clic en Guardar. Tanto al crear como al modificar se impedirá la inserción de un CIF ya registrado. Eliminación de Unidad Orgánica Para borrar una Unidad Orgánica se ha de pulsar sobre el botón Eliminar, mostrándose el siguiente panel de confirmación para desistir de la operación o eliminar definitivamente la Unidad Orgánica: 5.6. ORGANISMOS DESTINATARIOS Al seleccionar la opción Organismos Destinatarios se accede a la siguiente pantalla: Ref.:ITALOMUSAI01 27
El perfil Superadministrador es el único que podrá gestionar la información relativa a los Organismos Destinatarios. El resto de perfiles sólo podrán consultar la información. En la parte superior se muestra un buscador que permite buscar un Organismo Destinatario a partir de su nombre. Alta de Organismo Destinatario Para insertar un Organismo Destinatario se pulsará en Crear Organismo Destinatario, mostrándose los campos a rellenar: Tras pulsar Guardar los datos quedarán registrados. Modificación de Organismo Destinatario Para modificar un Organismo Destinatario se ha de seleccionar previamente, desplegándose una ficha con sus datos. Si tiene servidores asociados se mostrarán en la parte inferior: Ref.:ITALOMUSAI01 28
Tras hacer los cambios oportunos se hará clic en Guardar. Para añadir un nuevo servidor, modificarlo o eliminarlo se procederá del mismo modo que para crear, modificar y borrar un Organismo Destinatario. Eliminación de Organismo Destinatario Para borrar un Organismo Destinatario se ha de pulsar sobre el botón Eliminar, mostrándose el siguiente panel de confirmación para desistir de la operación o eliminar definitivamente el organismo: 5.7. ESQUEMAS DE DATOS Al seleccionar la opción Esquemas de datos se accede a la siguiente pantalla: Ref.:ITALOMUSAI01 29
Existen dos tipos de esquemas de datos (ficheros XSD): - de datos fijos, relativos a la información común a todas las aplicaciones que es enviada al organismo destinatario - de datos específicos, relativos a información específica de una aplicación Los esquemas de datos mostrados en el listado dependerán del perfil: - el Superadministrador podrá gestionar la información relativa a todos los tipos de esquemas - el Administrador sólo gestionará los esquemas de datos específicos de las aplicaciones de su grupo - el perfil Consulta sólo podrá visualizar los esquemas de datos específicos de las aplicaciones de su grupo En la parte superior se muestra un buscador que permite buscar un esquema o fichero XSD a partir de su nombre. Dicho esquema podrá descargarse pulsando sobre el icono Descargar en la fila correspondiente. Alta de esquema Para insertar un esquema se ha de pulsar en Crear fichero XSD, mostrándose los campos a rellenar. Ref.:ITALOMUSAI01 30
- Para el SuperAdministrador se mostrará la siguiente ficha: Se muestra la opción Datos Fijos marcada por defecto. En caso de insertar un esquema de datos específicos dicha opción deberá desmarcarse. En el 1º caso el fichero se cargará haciendo clic en Examinar y seleccionando una opción en Tipo de Fichero. En el 2º caso se deberá seleccionar una opción en el campo Aplicaciones. Para registrar finalmente el esquema se pulsará Guardar. Si se inserta un tipo de esquema de datos fijos ya registrado se mostrará un mensaje de aviso. Ej: - En el caso del Administrador se mostrará la siguiente ficha: Como hemos comentado anteriormente, el Administrador sólo gestiona los esquemas de datos Ref.:ITALOMUSAI01 31
específicos, por lo que la opción Datos Fijos se muestra desmarcada y el Tipo de Fichero seleccionado por defecto es el correspondiente al tipo de datos específicos (FicheroXSD3). El Administrador sólo deberá seleccionar una aplicación y cargar el fichero correspondiente, pulsando finalmente Guardar. Modificación de esquema Para modificar un esquema de datos fijos o de datos específicos se deberá pulsar en el icono de consulta correspondiente al fichero, desplegándose una ficha con sus datos. Ejemplo : Se deberá pulsar Examinar para cargar el fichero modificado que sustituirá al anterior. Para modificarlo podemos descargarlo como hemos mencionado anteriormente, y una vez realizados los cambios volverlo a cargar pulsando finalmente en el botón Guardar. En el caso de los esquemas de datos específicos, tanto al insertar como al modificar se validará que su formato sea el correcto: Ref.:ITALOMUSAI01 32
<?xml version="1.0" encoding="utf-8"?> <xs:schema xmlns:xsi="http://www.w3.org/2001/xmlschema-instance" attributeformdefault="unqualified" elementformdefault="qualified" targetnamespace="http://www.ficheros.com/ficheroxsd3" xmlns="http://www.ficheros.com/ficheroxsd3" xmlns:xs="http://www.w3.org/2001/xmlschema"> <xs:element name="datos_especificos"> <xs:complextype> <xs:sequence> --- ELEMENTOS </xs:sequence> </xs:complextype> </xs:element> Eliminación de esquema Para borrar un esquema se ha de pulsar sobre el botón Eliminar, mostrándose un panel de confirmación para desistir de la operación o eliminar definitivamente el esquema: Si el esquema eliminado es de datos fijos, se mostrará el siguiente mensaje: 5.8. TIPOS DE COMUNICACIONES Al seleccionar la opción Tipos de Comunicaciones se accede a la siguiente pantalla: Ref.:ITALOMUSAI01 33
Los perfiles SuperAdministrador y Administrador podrán gestionar la información relativa a los tipos de comunicación. El perfil Consulta sólo visualizará la información. En la parte superior se muestra un buscador que posibilitará buscar un tipo de comunicación a partir de su nombre. Alta de Tipo de Comunicación Para insertar un tipo de comunicación se ha de pulsar en Crear Tipo de Comunicación, mostrándose los campos a rellenar: Tras pulsar Guardar los datos quedarán registrados. Ref.:ITALOMUSAI01 34
Modificación de Tipo de Comunicación Para modificar un Tipo de Comunicación se ha de seleccionar previamente, desplegándose una ficha con sus datos: Tras hacer los cambios oportunos se hará clic en Guardar. Tanto al crear como al modificar se impedirá la inserción en el campo Tipo de un nombre ya registrado. Eliminación de Tipo de Comunicación Para borrar un Tipo de Comunicación se ha de pulsar sobre el botón Eliminar, mostrándose el siguiente panel de confirmación para desistir de la operación o eliminar definitivamente el tipo de comunicación: Ref.:ITALOMUSAI01 35
5.9. LISTADOS Al seleccionar la opción Listados en el menú de la izquierda se accede a la siguiente pantalla: Sólo se podrá consultar la información independientemente del perfil del usuario. Para visualizar la información enviada al organismo destinatario se ha de pulsar sobre el icono Descargar correspondiente al envío, de forma que se mostrará una ventana que nos permitirá abrir directamente el fichero XML o guardarlo: Ref.:ITALOMUSAI01 36
En la parte superior se muestra un buscador que permite buscar un determinado envío a partir de los siguientes criterios de búsqueda: - código de envío - organismo destinatario del envío - estado del envío 5.10. DATOS DE USUARIO Al seleccionar la opción Datos de Usuario en el menú de la izquierda se accede a una pantalla en la que se muestran los datos del usuario. Ej: Se podrán modificar los campos: email, contraseña, teléfono, móvil y fax. Se validará que el campo Email tenga el formato correcto. Si no se desea modificar la contraseña se ha de dejar el campo sin rellenar. Tras pulsar Modificar Datos los cambios quedarán registrados. 5.11. CAMBIAR GRUPO Si un usuario pertenece a más de un grupo, tendrá la posibilidad de acceder a la información asociada a otro grupo sin necesidad de volver a entrar en la aplicación para seleccionar el grupo en cuestión. Para ello deberá pulsar en la opción Cambiar Grupo en el menú de la izquierda, mostrándose una pantalla como la siguiente: Ref.:ITALOMUSAI01 37
Tras seleccionar una opción se ha de pulsar Aceptar, mostrándose el índice de la aplicación y las opciones de administración en función del perfil que el usuario tenga asignada para el grupo seleccionado. Ref.:ITALOMUSAI01 38