PLATAFORMA DE INTEROPERABILIDAD PDI - Programa Gobierno en...

71
PLATAFORMA DE INTEROPERABILIDAD PDI MINISTERIO DE COMUNICACIONES I IN NT TR RA AN NE ET T G GU UB BE ER RN NA AM ME EN NT TA AL L: : P PL LA AT TA AF FO OR RM MA A D DE E I IN NT TE ER RO OP PE ER RA AB BI IL LI ID DA AD D MANUAL DE OPERACIÓN Y ADMINISTRACIÓN DEL SISTEMA DE LA APLICACIÓN PLATAFORMA DE INTEROPERABILIDAD. Derechos Reservados Bogotá, D.C.

Transcript of PLATAFORMA DE INTEROPERABILIDAD PDI - Programa Gobierno en...

PLATAFORMA DE INTEROPERABILIDAD PDI

MINISTERIO DE COMUNICACIONES

IINNTTRRAANNEETT GGUUBBEERRNNAAMMEENNTTAALL:: PPLLAATTAAFFOORRMMAA DDEE IINNTTEERROOPPEERRAABBIILLIIDDAADD

MANUAL DE OPERACIÓN Y ADMINISTRACIÓN DEL SISTEMA DE LA APLICACIÓN PLATAFORMA DE INTEROPERABILIDAD.

Derechos Reservados

Bogotá, D.C.

PLATAFORMA DE INTEROPERABILIDAD PDI

Documento de Operación Plataforma PDI Pagina 2 de 71

Información del Documento

Nombre del Proyecto: Plataforma de Interoperabilidad

Preparado por: Mauricio Blanco / Luis Felipe García

Versión del Documento::

Definitiva

Cargo: Líder Desarrollo / Funcionario HP

Fecha: 31/07/2007

Revisado Por:

Lista de Distribución

De: Fecha Teléfono/Fax/Email

Para: Acción Fecha Teléfono/Fax/Email

Dra. Maria Isabel Mejía Aprobación 31/07/2007 [email protected]

Jose Luis Rodriguez Aprobación 31/07/2007 [email protected]

*

PLATAFORMA DE INTEROPERABILIDAD PDI

Documento de Operación Plataforma PDI Pagina 3 de 71

Tabla de Contenido

1. Aviso de Confidencialidad ........................................................................................................... 5

2. Aceptaciones ............................................................................................................................ 6

3. Introducción ............................................................................................................................. 7

3.1 Actualizar Datos ................................................................................................................... 7

3.2 Cambiar Contraseña.............................................................................................................. 8

3.3 Asignar Credenciales ............................................................................................................. 9

3.3.1 Administración de Usuarios .................................................................................................. 12

3.3.2 Crear Usuario de Pruebas .................................................................................................... 12

3.3.3 Crear Usuario Delegado ....................................................................................................... 13

3.4 Trámites ............................................................................................................................ 17

3.4.1 Proceso para la creación de Trámites o Servicios. ................................................................... 17

3.4.2 Diseño del flujo de ejecución del trámite o servicio. ................................................................ 18

3.4.3 Desarrollo de los servicios de soporte al trámite o servicio. ...................................................... 18

3.4.4 Requerimientos de los Adaptadores de Agencia Conectada. ..................................................... 19

3.5 Registro del trámite o servicio en la plataforma de Interoperabilidad. ....................................... 23

3.5.1 Creación del trámite o servicio. ............................................................................................ 23

3.5.2 Adición Trámite .................................................................................................................. 37

3.6 Gestión de trámites o servicios. ............................................................................................ 40

3.6.1 Modificación del trámite o servicio. ....................................................................................... 40

3.6.2 Eliminación del trámite o servicio. ......................................................................................... 43

3.6.3 Consultas........................................................................................................................... 45

3.7 Administrar Noticias ............................................................................................................ 48

3.8 Reportes ............................................................................................................................ 51

3.8.1 Reporte de tiempos de respuesta a usuarios de trámites. ........................................................ 52

3.8.2 Reporte de tiempos de respuesta de llamados de Web Services. .............................................. 54

3.8.3 Reporte estadístico de comportamiento. ................................................................................ 56

3.8.4 Reporte Utilización del sistema. ............................................................................................ 58

3.9 Logs .................................................................................................................................. 60

3.10 Configuración ..................................................................................................................... 60

PLATAFORMA DE INTEROPERABILIDAD PDI

Documento de Operación Plataforma PDI Pagina 4 de 71

3.10.1 Funcional ........................................................................................................................... 61

3.10.2 Técnica ............................................................................................................................. 64

3.11 Administración de Tablas ..................................................................................................... 66

3.11.1 Administrar Tipos de Documentos ........................................................................................ 66

3.11.2 Administrar Países .............................................................................................................. 67

3.11.3 Administrar Departamentos ................................................................................................. 69

3.12 Cerrar Sesión ..................................................................................................................... 71

PLATAFORMA DE INTEROPERABILIDAD PDI

Documento de Operación Plataforma PDI Pagina 5 de 71

1. Aviso de Confidencialidad Nota de propiedad La información y datos contenidos en todas las páginas de este documento elaborado por Colombia Telecomunicaciones S.A. ESP constituyen secretos comerciales o información confidencial y privilegiada de Colombia Telecomunicaciones S.A. ESP de naturaleza comercial o financiera. La citada información se facilita a FONADE y AGENDA DE CONECTIVIDAD bajo las más estrictas obligaciones de confidencialidad, en el bien entendido que éste no revelará la misma a ningún tercero ni la usará, sin permiso de Colombia Telecomunicaciones S.A. ESP, para propósitos distinto de uso interno del presente proyecto. Este documento contiene información confidencial de Colombia Telecomunicaciones S.A. ESP, y está sujeto a las más estrictas obligaciones de confidencialidad.

PLATAFORMA DE INTEROPERABILIDAD PDI

Documento de Operación Plataforma PDI Pagina 6 de 71

2. Aceptaciones Las siguientes firmas significan la aprobación por parte de Colombia Telecomunicaciones y el programa Agenda de Conectividad del presente documento.

Agenda de Conectividad Agenda de Conectividad

Nombre: Dra. Maria Isabel Mejía Nombre: Jose Luis Rodriguez Fecha: 31/07/2007 Fecha: 31/07/2007

PLATAFORMA DE INTEROPERABILIDAD PDI

Documento de Operación Plataforma PDI Pagina 7 de 71

3. Introducción El presente documento corresponde Al manual de usuario del entorno de Administración de operación de la plataforma para Plataforma de Interoperabilidad PDI diseñado e implementado para El Programa Agenda de Conectividad, de manera conjunta por parte de Colombia Telecomunicaciones S.A. ESP. Esta plataforma consta de equipos de cómputo y hardware Hewlett Packard y software de Sistema Operativo y aplicación Microsoft. Estos elementos requieren de una operación correcta que permita mantener la alta disponibilidad y confiabilidad de la solución. Los procedimientos de operación claros, definidos y establecidos permiten mantener de manera segura y disponible la plataforma y sus servicios.

3.1 Actualizar Datos

PLATAFORMA DE INTEROPERABILIDAD PDI

Documento de Operación Plataforma PDI Pagina 8 de 71

Esta opción solo nos permite modificar el correo del Administrador de la plataforma.

3.2 Cambiar Contraseña

• El actor ingresa la contraseña antigua, junto con la nueva y su confirmación. • El sistema valida que la nueva contraseña cumpla con los requerimientos de

seguridad. En caso de fallar la validación, el sistema recuerda al usuario los requerimientos en términos de longitud mínima, y numero mínimo de mayúsculas, minúsculas y caracteres especiales.

• El sistema reemplaza la contraseña anterior por la nueva.

PLATAFORMA DE INTEROPERABILIDAD PDI

Documento de Operación Plataforma PDI Pagina 9 de 71

Precondiciones

• El actor debe tener credenciales de seguridad autenticadas Poscondiciones

• El Actor cuenta con una nueva contraseña • La nueva contraseña cumple con los requerimientos de seguridad de la Plataforma de

Interoperabilidad.

3.3 Asignar Credenciales

El proceso continúa en el sitio de Administración de la PDI, por lo tanto se mostrarán las operaciones que realizará el administrador de la PDI, una vez haya iniciado sesión en el sitio Web correspondiente.

PLATAFORMA DE INTEROPERABILIDAD PDI

Documento de Operación Plataforma PDI Pagina 10 de 71

Se busca el usuario deseado y se hace click en la opción Editar.

El sistema habilita una serie de opciones, en las cuales seleccionamos el checkbox Aprobar y se digita un comentario.

PLATAFORMA DE INTEROPERABILIDAD PDI

Documento de Operación Plataforma PDI Pagina 11 de 71

Una vez seleccionado el usuario y completadas las opciones requeridas hacemos clic en el link Modificar, con lo cual se guarda la información modificada.

PLATAFORMA DE INTEROPERABILIDAD PDI

Documento de Operación Plataforma PDI Pagina 12 de 71

3.3.1 Administración de Usuarios

3.3.2 Crear Usuario de Pruebas El sistema despliega una pantalla solicitando los datos del usuario en este caso Usuario de Pruebas.

PLATAFORMA DE INTEROPERABILIDAD PDI

Documento de Operación Plataforma PDI Pagina 13 de 71

Se diligencia el formulario llenando todos los campos de manera correcta y luego se hace click en el botón Crear Usuario.

3.3.3 Crear Usuario Delegado El sistema despliega una pantalla solicitando los datos del usuario en este caso Usuario Delegado.

PLATAFORMA DE INTEROPERABILIDAD PDI

Documento de Operación Plataforma PDI Pagina 14 de 71

Se diligencia el formulario llenando todos los campos de manera correcta y luego se hace click en el botón Crear Usuario.

PLATAFORMA DE INTEROPERABILIDAD PDI

Documento de Operación Plataforma PDI Pagina 15 de 71

El sistema envía una notificación por pantalla “El usuario ha sido creado“ de que la solicitud ha sido procesada satisfactoriamente

PLATAFORMA DE INTEROPERABILIDAD PDI

Documento de Operación Plataforma PDI Pagina 16 de 71

El sistema envía una notificación por pantalla “El usuario ha sido creado“ de que la solicitud ha sido procesada satisfactoriamente.

PLATAFORMA DE INTEROPERABILIDAD PDI

Documento de Operación Plataforma PDI Pagina 17 de 71

3.4 Trámites

3.4.1 Proceso para la creación de Trámites o Servicios.

La publicación de un nuevo trámite o servicio por parte de una Entidad en la Plataforma de Interoperabilidad sigue el siguiente flujo de actividades:

A continuación se describen cada uno de los elementos de este proceso.

PLATAFORMA DE INTEROPERABILIDAD PDI

Documento de Operación Plataforma PDI Pagina 18 de 71

3.4.2 Diseño del flujo de ejecución del trámite o servicio.

Para poder integrar un trámite o servicio de una entidad del estado a la Plataforma de interoperabilidad, éste debe ser primero modelado. Para modelar el trámite o servicio debe seguirse el proceso descrito en el estándar GEL-XML, tanto para la especificación de datos de entrada como la especificación de datos de salida. Los detalles de las tareas sugeridas para modelar el trámite o servicio y generar los esquemas GEL-XML están relacionadas en los documentos del estándar GEL-XML. Los resultados finales de este proceso son:

o Un esquema XSD de entrada y o Un esquema XSD de salida.

Ambos esquemas existen como archivos (.XSD) y/o almacenados en un Repositorio de Esquemas GEL-XML con acceso desde la PDI.

3.4.3 Desarrollo de los servicios de soporte al trámite o servicio. Los trámites o servicios de la entidad que podrán ser habilitados para conectar desde la Plataforma de interoperabilidad deben residir en un Web Service con características específicas. Estas características requeridas serán descritas en el curso de este capítulo y calificarán el cumplimiento (compliant) del Web Service con la Plataforma de interoperabilidad. Cuando un Web Service satisface estos requerimientos y se califica como compliant, el Web Service se convierte en un Adaptador de Agencia Conectada – AAC – para la Plataforma de interoperabilidad. Los Web Services son elementos fundamentales en la evolución hacia la computación distribuida a través de redes compartidas. Se han convertido en la plataforma de integración de aplicaciones gracias a los estándares abiertos y al énfasis en la comunicación y colaboración entre organizaciones y aplicaciones. Las aplicaciones se estructuran integrando múltiples Web Services de origen distinto que funcionan conjuntamente, sin importar su ubicación o la forma en que se implementaron. La Plataforma de Interoperabilidad tiene base en Web Services entre otras por las siguientes características:

PLATAFORMA DE INTEROPERABILIDAD PDI

Documento de Operación Plataforma PDI Pagina 19 de 71

o Los Web Services ofrecen funciones muy útiles a usuarios del medio Web ya que emplean un protocolo Web estándar que, en la Plataforma de Interoperabilidad, es SOAP.

o Los Web Services permiten describir sus interfaces con suficiente detalle para que el usuario diseñe una aplicación cliente que permita comunicarse con ellas. Esta descripción se proporciona normalmente en un documento WSDL.

o Los conceptos de Web Services está muy extendido y ha sido bastante adoptado como el mecanismo de integración e interoperabilidad por excelencia.

Una de las principales ventajas de la arquitectura de los Web Services es que permite que los programas escritos en lenguajes y plataformas diferentes puedan establecer comunicación entre sí de forma estándar. Otra ventaja de los Web Services es que SOAP es bastante menos complejo que otros modelos, de modo que resulta más fácil que una implementación cumpla con los estándares de SOAP. Adicionalmente, otra ventaja importante es que los Web Services se basan en protocolos estándar, como XML, HTTP y TCP/IP. Muchas entidades gubernamentales y empresas disponen ya de una infraestructura Web, así como de personal y conocimientos para mantenerla, de modo que el esfuerzo y costo de entrada a estos servicios es mucho menor que con otras tecnologías. Por esto, la Plataforma de interoperabilidad utiliza los Web Services como las piezas de software de integración con las entidades gubernamentales y las empresas.

3.4.4 Requerimientos de los Adaptadores de Agencia Conectada. La infraestructura de Web Services se fundamenta en la comunicación por medio de mensajes basados en XML que cumplen con una descripción de servicio publicada. La descripción del servicio es un documento XML escrito en una gramática XML denominada WSDL, Web Services Description Language, que define el formato de mensaje comprensible para el Web Service. La descripción del servicio sirve como acuerdo que define el comportamiento de un Web Service e indica a la Plataforma de Interoperabilidad cómo interactuar con él. El comportamiento de un Web Service está determinado por modelos de mensajería que el servicio define y admite. Estos modelos dictan conceptualmente lo que el consumidor del servicio, en este caso la Plataforma de interoperabilidad, puede esperar que ocurra cuando se envía un mensaje con formato correcto al Web Service. Además de las definiciones de formato de mensaje y los modelos de mensajería, la descripción del servicio puede contener la dirección asociada a cada punto de entrada del Web Service. El formato de esta dirección se ajusta al protocolo utilizado para el

PLATAFORMA DE INTEROPERABILIDAD PDI

Documento de Operación Plataforma PDI Pagina 20 de 71

acceso al servicio, como una dirección URL para HTTP en el caso de la Plataforma de interoperabilidad.

3.4.4.1 Estándares soportados. Los Web Services ofrecen comunicación para sistemas con diferentes sistemas operativos y plataformas de desarrollo. Para conseguir este objetivo, se basan en una familia de especificaciones de protocolos de industria, un conjunto extendido de estos estándares se denomina WS-*. Para la versión 1.0 de la Plataforma de interoperabilidad los estándares de relacionados con Web Services soportados son:

o XML, Versión 1.1 o XML Schema, Versión 1.1 o SOAP, Versión 1.1 o WSDL, Versión 1.1 o XSL, Versión 1.0 o WS-Security 1.0

Con el cumplimiento de los anteriores estándares y versiones, se dice que el Web Service cumple con la especificación Basic Profile 1.0 de WS-I1

3.4.4.2 Interfaces mínimas requeridas. La notación que utiliza un archivo WSDL para describir formatos de mensaje se basa en el estándar XML. Esto significa que es un idioma de programación neutral y basada en estándares, lo cual es ideal para describir interfaces de Web Services que pueden consumirse desde una gran variedad de plataformas y lenguajes de programación. Además de describir el contenido de un mensaje, WSDL define el lugar en el que está disponible el servicio y qué protocolo de comunicaciones se utiliza para hablar al servicio. Esto significa que el archivo WSDL define todos los elementos necesarios para escribir un programa que pueda funcionar con un Web Service. En el Anexo A, se encuentra el esquema XML que define la estructura del WSDL que soporta la versión 1.0 de la Plataforma de interoperabilidad. De este esquema se desprende que se requieren cinco métodos obligatorios para el Adaptador de agencia conectada, estos son:

Método Descripción

1 Mayor información sobre la especificación Basic Profile se puede encontrar en http://www.ws-i.org/Profiles/BasicProfile-1.0-2004-04-16.html

PLATAFORMA DE INTEROPERABILIDAD PDI

Documento de Operación Plataforma PDI Pagina 21 de 71

Consultar Le permite consultar a la PDI si el ciudadano ya había ejecutado previamente ese trámite o servicio, en cuyo caso retorna su resultado. Utiliza como parámetros de búsqueda, las Llaves de Consulta.

Ejecutar Permite iniciar la ejecución de un trámite o servicio en la Entidad. Si el mecanismo de respuesta al usuario es Inmediato, retorna su respuesta, sino, la respuesta puede ser consultada a través de la función ConsultarResultado.

ConsultarResultado Permite obtener la respuesta de trámites o servicios ejecutados de manera No-Inmediata.

VerificarFuncionamiento Le permite consultar a la PDI si el Web Service se encuentra en-línea

Tarifar Le permite a la entidad tarifar la ejecución de un trámite.

Las anteriores funciones (salvo VerificarFuncionamiento) reciben un documento XML como parámetro de entrada y retornan otro documento XML. La estructura de estos documentos de entrada y salida se describe como parte del Anexo B. Los parámetros de cada una de estas funciones se describen a continuación:

Consultar

Parámetro Tipo Descripción

Consultar Entrada Estructura XML que contiene la información utilizada para consultar el resultado de una ejecución previa del trámite o servicio.

ConsultarResponse Salida Estructura XML que contiene la información de salida de la consulta. En el caso que se haya encontrado una ejecución previa, retorna este resultado.

Ejecutar

Parámetro Tipo Descripción

Ejecutar Entrada Estructura XML que contiene la información utilizada para iniciar la ejecución de un trámite en la Entidad

EjecutarResponse Salida Estructura XML que contiene el resultado de

PLATAFORMA DE INTEROPERABILIDAD PDI

Documento de Operación Plataforma PDI Pagina 22 de 71

iniciar la ejecución de un trámite o servicio en la Entidad.

ConsultarResultado

Parámetro Tipo Descripción

ConsultarResultado Entrada Estructura XML que contiene la información utilizada para consultar el resultado de la ejecución de un trámite o servicio en la Entidad.

ConsultarResultadoResponse Salida Estructura XML que contiene el resultado de la ejecución de un trámite o servicio, si este ya es conocido.

VerificarFuncionamiento

Parámetro Tipo Descripción

VerificarFuncionamiento Entrada Estructura XML que contiene la información utilizada para consultar el estado del sistema de información

booleano Salida Verdadero si el sistema se encuentra activo, de lo contrario False

Tarifar

Parámetro Tipo Descripción

Tarifar Entrada Estructura XML que contiene la información utilizada para tarifar la ejecución de un trámite en la Entidad.

TarifarResponse Salida Estructura XML que contiene el resultado de la tarifación de un trámite

Importante: si un trámite o servicio fue modelado por la entidad para requerir “firma digital”, el total del formulario de entrada (como formulario XHTML) diligenciado por el usuario es firmado utilizando su Certificado Digital. Esto naturalmente implica que solo aquellos usuarios que disponen de un Certificado Digital como medio de Autenticación pueden ejecutar estos trámites o servicios.

PLATAFORMA DE INTEROPERABILIDAD PDI

Documento de Operación Plataforma PDI Pagina 23 de 71

Una vez firmado el formulario, este llega al Web Service de la Entidad en su versión firmada y “plana” (dentro del parámetro “formulariofirmado”), donde puede ser validado y/o almacenado como constancia de no-repudio.

3.5 Registro del trámite o servicio en la plataforma de Interoperabilidad.

3.5.1 Creación del trámite o servicio. La siguiente gráfica muestra la secuencia ocurre en el proceso de registro del trámite o servicio en la Plataforma de interoperabilidad, así como el responsable de cada tarea en el flujo.

Figura 1. Secuencia de registro de un trámite o servicio en la PDI.

La imagen anterior muestra el proceso general de registro de un nuevo trámite o servicio en la PDI. Posterior a la solicitud de registro del trámite o servicio, se debe

PLATAFORMA DE INTEROPERABILIDAD PDI

Documento de Operación Plataforma PDI Pagina 24 de 71

pasar por una instancia de aprobación por parte del Administrador de la PDI, quien debe aprobar su publicación en el ambiente de producción. Es importante resaltar que toda la definición del trámite o servicio queda almacenada en un repositorio lógico independiente. De acuerdo a lo anterior, los pasos puntuales a realizar por parte del administrador de la entidad, dentro de la herramienta para la creación de un trámite o servicio, son los siguientes:

1. Seleccionar la opción Crear Trámite o Crear Servicio, según corresponda en el menú ubicado a la izquierda de la pantalla. 2. Asignar la naturaleza del procedimiento por generar (seleccionar trámite cuando corresponde a un proceso que debe ser ejecutado y procesado bajo una normatividad específica mientras que debe seleccionar servicio no cuenta con dichas características pero sí corresponde a una implementación concreta de la entidad de cara al usuario) (fig. 4.3.1.1. – A). Adicionalmente seleccione el nombre del trámite a crear (fig. 4.3.1.1. – B), el cual ya está previamente cargado en la base de datos del PEC de acuerdo a la entidad que se haya validado; para el caso de creación de servicios, el nombre debe ser digitado directamente sobre el formulario. Oprima el botón Crear para continuar con el siguiente paso.

PLATAFORMA DE INTEROPERABILIDAD PDI

Documento de Operación Plataforma PDI Pagina 25 de 71

(fig. 4.3.1.1. Creación de trámites / Crear Trámite)

3. En la página Modalidad de Respuesta encontrará su correspondiente modalidad de respuesta (fig. 4.3.1.2. – A) la cual inicialmente será Servicio Web ya que su ejecución es en línea. Seguido a ello debe señalar si el procedimiento es personal e intransferible (fig. 4.3.1.2. – B) y posteriormente asignar los esquemas GEL-XML de Entrada y Salida (fig. 4.3.1.2. – C). Cada uno de ellos corresponden a los estándares XML que van a ser implementados para favorecer la uniformidad de los trámites/servicios y de esta manera evitar errores al momento del intercambio de información.

(fig. 4.3.1.2. Creación de trámites / Modalidad de Respuesta)

4. En el siguiente paso, debe asignar los roles que pueden ejecutar el trámite/servicio, es decir, el tipo de usuario que debe llevar a cabo el procedimiento. Puede escoger entre Anónimo si el trámite/servicio puede ser ejecutado por un usuario no registrado, Ciudadano, Sistema de información, Usuario Delgado de Empresa o Usuario Delegado de Entidad (Ver numeral 2.1.1. Usuarios de la Plataforma de Interoperabilidad donde se describen los tipos de usuario).

PLATAFORMA DE INTEROPERABILIDAD PDI

Documento de Operación Plataforma PDI Pagina 26 de 71

5. Una vez asignados los roles, se procede a establecer las Llaves de Consulta las cuales corresponden a los parámetros de validación que tendrá inicialmente el trámite al momento de ser ejecutado. Dicha opción establece los parámetros de búsqueda donde se determina si la información requerida acerca del usuario y si ya está llevando a cabo el trámite/servicio, ya se encuentra en las bases de datos del sistema. En el segmento izquierdo de la pantalla encuentra el árbol de opciones que componen el esquema GEL-XML seleccionado en la pantalla anterior (fig. 4.3.1.3. – A). Haga clic sobre la opción que desea asignar como llave de consulta (fig. 4.3.1.3. – B) y oprima el botón Adicionar (fig. 4.3.1.3. – C). El campo asignado quedará listado en la primera casilla del segmento derecho (fig. 4.3.1.3. – D). Repita el procedimiento anterior si desea establecer más llaves de consulta. Finalmente puede llevar a cabo asociaciones entre los campos que ya se encuentran en el registro del usuario que está llevando a cabo el trámite/servicio y los campos que deben ser diligenciados en el trámite que se está creando. Para hacer esto, seleccione la Llave de Consulta que desea asociar en la primera casilla del segmento derecho (fig. 4.3.1.3. – D) y luego oprima el botón Asociar Credenciales (fig. 4.3.1.3. – E); en la ventana emergente seleccione el campo con el que desea realizar la asociación y oprima le botón Guardar. La asociación quedará registrada en la segunda casilla del segmento derecho (fig. 4.3.1.3. – F).

PLATAFORMA DE INTEROPERABILIDAD PDI

Documento de Operación Plataforma PDI Pagina 27 de 71

(fig. 4.3.1.3. Creación de trámites / Llaves de Consulta)

6. En la siguiente pantalla se cargan las operaciones desde tres (3) adaptadores. En cada casilla deberá ser digitado el URL en el cual se encuentra cada uno de ellos. El primero corresponde al webService de pruebas (fig. 4.3.1.4. – A) el cual asegura la respuesta con el servidor. El segundo es el webService de dummy (fig. 4.3.1.4. – B) el cual clasifica la información que será considerada como prueba. El tercero es el webService de producción (fig. 4.3.1.4. – C) el cual se encarga de la conexión con el servidor final de almacenamiento. Siendo asignados los tres (3) adaptadores de agencia conectada debe oprimir el botón Identificar Operaciones con el fin que el aplicativo reconozca las funciones de cada uno de ellos (fig. 4.3.1.4. – D). Es preciso que en el caso de publicar el trámite/servicio en Preproducción), al menos esté asignado el adaptador de pruebas. Para el caso de publicar finalmente en producción deben ser identificadas y cargadas las operaciones de los tres (3) adaptadores.

PLATAFORMA DE INTEROPERABILIDAD PDI

Documento de Operación Plataforma PDI Pagina 28 de 71

Una vez identificadas las operaciones, el sistema muestra el nombre del servicio y sus respectivas funciones para cada uno de los adaptadores. Para ver el detalle de ella, haga clic sobre el icono el cual mostrará el código de la correspondiente operación (fig. 4.3.1.4. – E). Para continuar con el siguiente paso, debe dar clic en el botón Cargar Operaciones (fig. 4.3.1.4. – F) y esperar el mensaje Operaciones cargadas satisfactoriamente y posteriormente oprimir el botón Siguiente.

(fig. 4.3.1.4. Creación de trámites / Carga Operaciones WebService)

7. Paso para Trámites: En este paso, el cual es opcional (para ser tenido en cuenta en los casos que aplique), se deben asignar los trámites prerrequisito que van asociados al trámite que se está generando. En primera instancia cuenta con una herramienta para buscar el trámite, donde selecciona el criterio de búsqueda, bajo las opciones nombre, entidad o descripción (fig. 4.3.1.5. – A); en el siguiente campo ingrese la palabra clave para llevar a cabo la búsqueda (fig. 4.3.1.5. – B). Deje los espacios en blanco para que sean listados todos los trámites. Estando listados los trámites como resultado de la búsqueda, seleccione en el trámite prerrequisito en la columna de la izquierda (fig. 4.3.1.5. – C) y luego oprima el botón Adicionar (fig. 4.3.1.5. – D). El trámite seleccionado será listado en la casilla de la

PLATAFORMA DE INTEROPERABILIDAD PDI

Documento de Operación Plataforma PDI Pagina 29 de 71

derecha (fig. 4.3.1.5. – E). Repita el procedimiento anterior si desea adicionar más trámites. Haga clic en el icono para ver la definición de cada trámite. Si desea eliminar alguno de los trámites elegidos, selecciónelo en la casilla derecha y oprima el botón Eliminar. Oprima el botón Siguiente para continuar con el siguiente paso. Nota: Si no se selecciona ningún trámite prerrequisito siga al paso 11. Paso para Servicios: Paso seguido se determina la información del servicio como la definición si se debe ejecutar en un período determinado para lo cual hace uso de los calendarios que aparecen al momento de seleccionar dicha opción, definición del mecanismo de respuesta al usuario (Inmediata / No Inmediata) y si el servicio requiere el envío de documentos, para lo cual el formulario contará con una herramienta de búsqueda dentro del disco duro del usuario y posterior carga del archivo seleccionado. Oprima el botón Siguiente para continuar el proceso.

PLATAFORMA DE INTEROPERABILIDAD PDI

Documento de Operación Plataforma PDI Pagina 30 de 71

(fig. 4.3.1.5. Creación de trámites / Gestionar Trámites Prerrequisito)

8. Paso para Trámites: A continuación se lleva a cabo las Asociaciones Datos Relevantes para cada trámite que sea necesario dentro de la selección del paso anterior. Seleccione el nombre en la casilla izquierda (fig. 4.3.1.6. – A) y luego oprima el botón Configurar (fig. 4.3.1.6. – B).

PLATAFORMA DE INTEROPERABILIDAD PDI

Documento de Operación Plataforma PDI Pagina 31 de 71

(fig. 4.3.1.6. Creación de trámites / Asociaciones Datos Relevantes)

9. Paso para Trámites: El siguiente paso corresponde a asociar campos entre la casilla izquierda que representa el esquema GEL-XML del formulario de salida del trámite prerrequisito (fig. 4.3.1.7. – A) y los que conforman el formulario del trámite que se está generando, ubicado a la derecha de la pantalla (fig. 4.3.1.7. – B). Para llevar a cabo este procedimiento, haga clic al campo que desea asociar en la izquierda (fig. 4.3.1.7. – C) y después debe hacer lo mismo en la casilla derecha (4.3.1.7. – D). Una vez seleccionados los dos campos que deben ser asociados, haga clic en Asociar (4.3.1.7. – E). Si desea reversar el procedimiento seleccione los dos campos y oprima Desasociar. Las asociaciones generadas serán listadas en la casilla inferior (fig. 4.3.1.7. – F). Terminado el procedimiento oprima le botón Grabar Asociaciones para volver al formulario. Oprima el botón Siguiente para continuar con el próximo paso.

PLATAFORMA DE INTEROPERABILIDAD PDI

Documento de Operación Plataforma PDI Pagina 32 de 71

(fig. 4.3.1.7. Creación de trámites / Asociación de Campos)

10. Paso para Trámites: Paso seguido, se establecen las condiciones de acuerdo a cada rol asignado en el paso 4. Seleccione el rol determinado y haga clic sobre el icono para editar los condicionales. Aparece una pantalla donde se listan todos los campos que conforman el formulario del trámite y junto a cada uno de ellos las posibilidades de condición, el valor de dicha condición y su correspondiente operador:

Condiciones

< | Mayor que > | Menor que

<= | Mayor o igual que >= | Menor o igual que

¡= | Diferente = | Igual

Operador

AND | y OR | o

PLATAFORMA DE INTEROPERABILIDAD PDI

Documento de Operación Plataforma PDI Pagina 33 de 71

Por ejemplo, si necesita que el campo Mayor de Edad obedezca siempre a una respuesta afirmativa, en el listado de campos a los que puede ser aplicadas las condiciones seleccione la opción = (igual) en la columna Condición (fig. 4.3.1.8. – A) y en el campo correspondiente a la columna Valor (fig. 4.3.1.8. – B) asigne el criterio correspondiente a la única respuesta para ser válido el proceso del trámite (en este caso SI). Si la condición además depende de la respuesta dada en otro campo, porque adicionalmente se cumpla asigne la opción AND en la columna Operador (fig. 4.3.1.8. – C). Si la respuesta está entre la primera condición mencionada o un valor asignado en otro campo, seleccione la opción (OR) al final de la primera condición. Las condiciones serán regidas en orden lineal y por defecto, si no es señalado ningún operador, el sistema asume AND. Pueden asignarse cuantas condiciones aplique pero teniendo en cuenta que no serán agrupables sino de ejecución lineal.

(fig. 4.3.1.8. Creación de trámites / Editor de condiciones)

Habiendo estimado las condiciones oprimir le botón Guardar o Cancelar para descartar el procedimiento. Oprimir el botón Siguiente para continuar con el proceso. 11. Paso para Trámites: Paso seguido se determina la información del trámite como la definición si el trámite se debe ejecutar en un período determinado (de acuerdo a

PLATAFORMA DE INTEROPERABILIDAD PDI

Documento de Operación Plataforma PDI Pagina 34 de 71

lo determinado por la norma que rige el trámite) para lo cual hace uso de los calendarios que aparecen al momento de seleccionar dicha opción, definición del mecanismo de respuesta al usuario (Inmediata / No Inmediata) y si el trámite requiere el envío de documentos, para lo cual el formulario contará con una herramienta de búsqueda dentro del disco duro del usuario y posterior carga del archivo seleccionado. Oprima el botón Siguiente para continuar al paso siguiente. 12. El último paso define el diseño del formulario de entrada y salida. Si el servicio/tramite que se publica está enfocado exclusivamente a sistemas de información, este paso no aplica. Desde la casilla izquierda, correspondiente al esquema de entrada del trámite/servicio (fig. 4.3.1.9. – A), tome los campos que complementarían la información del formulario resumido en la casilla derecha correspondiente al diseño del formato de salida (fig. 4.3.1.9. – B). Para llevar a cabo este procedimiento, seleccione el campo en la casilla izquierda (fig. 4.3.1.9. – C) y haciendo uso de la barra de herramientas ubicado en la mitad de la pantalla (fig. 4.3.1.9. – D) realice la inclusión del parámetro. En dicha barra también cuenta con herramientas para subir o bajar campos dentro del diseño del formulario (fig. 4.3.1.9. – E), como también para agregar subtítulos y nuevas tablas (fig. 4.3.1.9. – F). Oprima el botón Vista Previa para visualizar el diseño final del formulario (fig. 4.3.1.9. – G). Seleccionando cada campo en la casilla derecha aparecerán sus correspondientes casillas de configuración en la parte inferior de la pantalla (fig. 4.3.1.9. – H). Las definiciones de cada campo de configuración son:

� Nombre: Término con el que es llamado el campo.

� Comentario: Descripción opcional que se desee asignar al campo.

� Tool Tip de Error: Es el mensaje que aparece como texto alternativo sobre el icono de error, con el fin de señalar al usuario el motivo por le cual no es aceptada la información sugerida en el campo.

� Elemento en el esquema: La manera como es llamado el elemento desde el

GEL-XML.

� Oculto: Si se desea mantener oculto el elemento en el formulario.

PLATAFORMA DE INTEROPERABILIDAD PDI

Documento de Operación Plataforma PDI Pagina 35 de 71

� Expresión regular: Cuando el campo debe ser reconocido bajo un parámetro específico sin restricción alguna.

� Textbox Multilínea: Asignar esta opción cuando la casilla pueda contener

información que necesite suficiente espacio para ser escrita.

� Campo Calculado: Cuando el contenido del campo es el resultado de una operación realizada entre los datos de otros campos contenidos dentro del mismo formulario. Oprima el botón Editar para acceder a la ventada de configuración de dicha opción donde podrá seleccionar los campos y la correspondiente operación.

� Asociar credenciales del registro: Oprimiendo el botón editar aparecerá una

pantalla donde podrá asociar el campo bajo ciertas variables en relación a un resultado determinado.

� Tipo de Dato: Categoría del campo asignado desde el esquema GEL-XML.

� Longitud Mínima: Si el contenido del campo debe contener un número mínimo

de caracteres.

� Valores: Enumeración asignada en el caso que el campo contenga varias opciones de respuesta. Este parámetro ya viene contenido en el esquema y por lo tanto no es editable.

� Longitud Máxima: Si el contenido del campo debe contener un número máximo

de caracteres.

� Activado por: Si el campo debe ser activado dependiendo de la información incorporada en otro campo del formulario. Oprimir el botón Adicionar Regla de Activación para acceder a la ventana que lista las posibilidades de configuración.

PLATAFORMA DE INTEROPERABILIDAD PDI

Documento de Operación Plataforma PDI Pagina 36 de 71

(fig. 4.3.1.9. Creación de trámites / Formulario de Entrada y Salida)

Oprimir el botón Actualizar para llevar a cabo los cambios realizados en los nombrados campos de configuración.

PLATAFORMA DE INTEROPERABILIDAD PDI

Documento de Operación Plataforma PDI Pagina 37 de 71

Una vez finalizada la configuración del formulario oprima el botón Siguiente para llevar a cabo todo el procedimiento anterior pero para el formulario de salida. Una vez hecho la configuración necesaria, oprima el botón Siguiente para poder visualizar dicho formulario. Posteriormente el botón Crear Trámite o Crear Servicio.

3.5.2 Adición Trámite Una vez creado el trámite/servicio, se adiciona para comenzar su proceso de pruebas y posterior publicación. Para este caso, terminado el proceso del punto anterior, le es asignado el estado “Activo en pruebas” y aparecerá listado haciendo clic en el vínculo Trámites ubicado en el menú a la izquierda de su monitor (fig. 4.3.2.1. ); en dicha pantalla podrá llevar a cabo la búsqueda de los trámites/servicios generados dentro de la entidad (fig. 4.3.2.1. – A). Adicionalmente se consulta su estado y tiene acceso a las respectivas operaciones (fig. 4.3.2.1. – B), como Ver Definición del trámite/servicio , Consultar el árbol de trámites prerrequisito , Modificación , Solicitud de

Creación , Solicitar Modificación , Solicitud de Eliminación , Inactivar , Configuración de webService por defecto , y Eliminación .

PLATAFORMA DE INTEROPERABILIDAD PDI

Documento de Operación Plataforma PDI Pagina 38 de 71

(fig. 4.3.2.1. Adición de trámites / Listado de trámites/servicios) Paso 1. Para llevar a cabo la solicitud, oprima el ícono en el listado anteriormente mencionado, a lo cual aparecerá una ventana (fig. 4.3.2.2. ) que registra y envía la solicitud que será recibida por el administrador de pruebas. En dicha ventana debe digitar el texto con el que solicita la creación (fig. 4.3.2.2. – A) y debe adjuntar el instructivo que señalará al administrador de pruebas las características principales del webService correspondiente a Dummy (fig. 4.3.2.2. – B) y a Pruebas (fig. 4.3.2.2. – C), usados en la generación del trámite/servicio. Dichos documentos, los cuales pueden ser manejados en cualquier formato de texto (txt, doc, etc.), son cargados oprimiendo el botón Browse o Seleccionar (dependiendo del idioma de su sistema operativo) y posteriormente ubicándolos dentro de su disco duro. Una vez ingresados esos datos, oprimir el botón Enviar Solicitud. Le será asignado un número para llevar a cabo el seguimiento de aprobación y posterior adición.

(fig. 4.3.2.2. Adición de trámites / Solicitud Adición de trámites/servicios)

Paso 2. Una vez la solicitud llega al administrador de pruebas, este inicia la correspondiente evaluación. De acuerdo a los resultados, dicho perfil puede: A) Preaprobar el trámite/servicio para que así el administrador PDI lleve a cabo la aprobación final. B) Reportar Errores en el caso que los encuentre, los cuales serán relacionados en la bitácora asociada a la solicitud, la cual puede ser consultada haciendo clic en el número asignado por el sistema cuando fue efectuada la solicitud.

PLATAFORMA DE INTEROPERABILIDAD PDI

Documento de Operación Plataforma PDI Pagina 39 de 71

Paralelamente, dentro de sus funciones puede: C) Adicionar comentarios en la mencionada bitácora. D) Reasignar responsables a la evaluación del trámite/servicio. Siendo Preaprobada la solicitud, el administrador PDI puede: A) Aprobar la solicitud para que finalmente el administrador de la entidad se encargue de la publicación quien a ese punto ya está en disposición de hacerlo o cancelar el proceso. B) Rechazar la solicitud, agregando los respectivos comentarios a la bitácora.

Paso 3. Estando aprobada la creación del trámite/servicio, éste aparecerá en el listado de la sección Solicitudes (fig. 4.3.2.3.), donde estarán listadas todas las solicitudes en curso (fig. 4.3.2.3. – A ) bajo parámetros como Nombre trámite/servicio, Vida Solicitud (Abierta si tiene pasos pendientes o Cerrada si es el último paso por definir), Estado de la solicitud (Solicitar Modificación de Trámite, Aprobar Autorización, Solicitar Aprobación Modificación de Trámite, Iniciar Pruebas, Adicionar Comentarios, Reasignar, Reportar Errores, Reenviar Solicitud, Pre-Aprobar, Aprobar, Rechazar, Solicitar Eliminar Trámite, Rechazar Autorización Eliminación, Aprobar Autorización Eliminación, Eliminar Trámite, Publicar, Cancelar) , Tipo Solicitud (Adición, Autorización de Modificación/Eliminación, Modificación, Eliminación), Fecha de solicitud y Fecha de última operación. Haga clic en el ícono (fig. 4.3.2.3. – B) para llevar a cabo su publicación en el ambiente de producción.

PLATAFORMA DE INTEROPERABILIDAD PDI

Documento de Operación Plataforma PDI Pagina 40 de 71

(fig. 4.3.2.3. Adición de trámites / Listado de Solicitudes de trámites/servicios)

3.6 Gestión de trámites o servicios.

Una vez una entidad ha publicado un Trámite/Servicio en la PDI, puede ejercer labores de gestión sobre este, los siguientes son los pasos de cada una de estas labores:

3.6.1 Modificación del trámite o servicio.

Cuando el trámite/servicio está activo y la entidad considera que debe ser corregido, procede a solicitar al administrador PDI la correspondiente modificación, por medio de las opciones de administración con que dispone el administrador de la entidad.

PLATAFORMA DE INTEROPERABILIDAD PDI

Documento de Operación Plataforma PDI Pagina 41 de 71

Figura 2a. Secuencia de modificación de un trámite o servicio en la PDI.

Paso 1. En el caso de ser necesaria una modificación dentro de un trámite/servicio, se lleva a cabo la solicitud al Administrador PDI, en el listado de trámites, oprimiendo el ícono .

En ese momento se desplegará una ventana emergente la cual contiene un formulario (fig. 4.3.3.1.) que busca reunir la información necesaria para que el Administrador PDI entienda los cambios que se desean realizar. Señale los campos que van a ser modificados (fig. 4.3.3.1. A), ingrese el comentario correspondiente dirigido al

PLATAFORMA DE INTEROPERABILIDAD PDI

Documento de Operación Plataforma PDI Pagina 42 de 71

Administrador PDI (fig. 4.3.3.1. – B) y asigne los documentos de instructivo que señalan las características principales del Web Service correspondiente a Dummy (fig. 4.3.3.1. – C) y a Pruebas (fig. 4.3.3.1. – D), usados en la generación del trámite/servicio. Una vez ingresados esos datos, oprimir el botón Enviar Solicitud. Le será asignado un número para llevar a cabo el seguimiento de aprobación y posterior adición.

(fig. 4.3.3.1. Modificación de trámites / Formulario de Solicitud)

Paso 2. Una vez aprobada la solicitud por parte del Administrador PDI, el trámite aparecerá listado en la opción Solicitudes. Para proceder con la modificación, haga clic en el ícono .

PLATAFORMA DE INTEROPERABILIDAD PDI

Documento de Operación Plataforma PDI Pagina 43 de 71

El proceso de modificación será el mismo que llevó a cabo la generación del trámite, con la diferencia que el sistema carga los datos ya ingresados para ser cambiados de acuerdo a las necesidades. Habiendo efectuado los cambios, haga clic en el ícono para reportar los cambios al administrador de pruebas. A partir de este momento, el proceso es el mismo que el llevado a cabo en la solicitud de creación del trámite/servicio, desde el punto en que el administrador de pruebas lo comienza a evaluar.

Paso 3. Estando aprobada la modificación del trámite/servicio, en el listado de la sección Solicitudes, haga clic en el ícono para llevar a cabo su publicación en el ambiente de producción.

3.6.2 Eliminación del trámite o servicio.

Figura 3b. Secuencia de eliminación de un trámite o servicio en la PDI.

PLATAFORMA DE INTEROPERABILIDAD PDI

Documento de Operación Plataforma PDI Pagina 44 de 71

Paso 1. Cuando la entidad desea eliminar un trámite/servicio, debe hacer la solicitud al Administrador PDI, quien la rechaza o aprueba. Para llevar a cabo el proceso, seleccione la opción Trámites y habiendo identificado el trámite/servicio que desea eliminar haga clic sobre su correspondiente ícono . En ese momento aparecerá una ventana emergente donde puede seleccionar la fecha de eliminación del trámite/servicio (fig. 4.3.4.1. – A) y el correspondiente comentario (fig. 4.3.4.1. – B). El administrador PDI será el encargado de aprobar o rechazar. Una vez ingresados esos datos, oprimir el botón Enviar Solicitud. Le será asignado un número para llevar a cabo el seguimiento de aprobación y posterior adición.

(fig. 4.3.4.1. Eliminación de trámites / Formulario de Solicitud)

Paso 2. Una vez aprobada la solicitud, es el administrador de la entidad quien procede a eliminarlo desde el listado generado en la sección Solicitudes mediante clic al ícono .

PLATAFORMA DE INTEROPERABILIDAD PDI

Documento de Operación Plataforma PDI Pagina 45 de 71

3.6.3 Consultas

3.6.3.1 Consulta de Trámites Ofrecidos.

Una vez generados los trámites y/o servicios, puede llevar a cabo la consulta de los mismos y llevar a cabo su respectivo seguimiento. A continuación la descripción de los pasos para realizar la consulta: 1. Seleccionar la opción Trámites Ofrecidos en el menú ubicado a la izquierda de la pantalla. Dentro de esta sección podrá consultar los trámites que a la fecha están registrados como ofrecidos por la entidad a los ciudadanos. 2. Encontrará dos fragmentos, el superior (fig. 4.3.5.1. – A) donde podrá realizar la búsqueda bajo los criterios de Fecha de Solicitud (fig. 4.3.5.1. – B), Estado (fig. 4.3.5.1. – C) o Nombre del Trámite (fig. 4.3.5.1. – D). Para la primera opción, haga clic sobre cada icono tanto en la casilla Desde como en la casilla Hasta para determinar la fecha de publicación del trámite o servicio. Si la búsqueda consiste en el estado del trámite, puede seleccionar bajo los criterios Con respuesta, Con error, Rechazado, Esperando Entidad, Esperando prerrequisitos, Listo para ejecutar, Con error ejecución, Preparando ejecución los cuales son definidos en el punto de modificación de trámites. También puede llevar a cabo la búsqueda por el nombre del trámite. Deje todos los espacios en blanco si desea buscar bajo todos los parámetros. Oprima el botón Buscar para ejecutar la búsqueda.

3. En la tabla inferior aparecerán los resultados de la búsqueda (fig. 4.3.5.1. – E) los cuales podrán ser ordenados por el criterio que encabeza cada columna. Podrá ver la respuesta a cada trámite haciendo clic en el icono . Para consultar todos los registros haga uso del sistema de paginación ubicado en la parte inferior central de la tabla (fig. 4.3.5.1. – F).

PLATAFORMA DE INTEROPERABILIDAD PDI

Documento de Operación Plataforma PDI Pagina 46 de 71

(fig. 4.3.5.1. Trámites Ofrecidos / Consulta)

3.6.3.2 Consulta de Trámites Consumidos. Dentro de los trámites y/o servicios generados y que han sido consumidos por Usuarios Delegados de la Entidad (Persona delegada por una entidad o empresa para ejecutar y consultar trámites en nombre de la entidad o empresa), se encuentra esta categoría la cual puede ser consultada siguiendo los pasos que se describen a continuación. 1. Seleccionar la opción Trámites Consumidos en el menú ubicado a la izquierda de la pantalla. Dentro de esta sección podrá consultar los trámites que a la fecha están registrados como ofrecidos por la entidad a los usuarios delegados.

PLATAFORMA DE INTEROPERABILIDAD PDI

Documento de Operación Plataforma PDI Pagina 47 de 71

2. Encontrará dos fragmentos, el superior (fig. 4.3.6.1. – A) donde podrá realizar la búsqueda bajo los criterios de Nombre del Trámite (fig. 4.3.6.1. – B), Nombre del Usuario Delegado (fig. 4.3.6.1. – C), Estado (fig. 4.3. 6.1. – D), Fecha de Solicitud (fig. 4.3.6.1. – E) o Fecha de Entrega (fig. 4.3. 6.1. – F). Al igual que el punto anterior, haga clic sobre cada icono tanto en la casilla Desde como en la casilla Hasta en cualquiera de los dos parámetros (fecha solicitud y fecha entrega) para determinar el criterio de búsqueda por tiempo. Si la búsqueda consiste en el estado del trámite, puede seleccionar bajo los criterios Con respuesta, Con error, Rechazado, Esperando Entidad, Esperando prerrequisitos, Listo para ejecutar, Con error ejecución, Preparando ejecución. Deje todos los espacios en blanco si desea buscar bajo todos los parámetros. Oprima el botón Buscar para ejecutar la búsqueda. 3. En la tabla inferior aparecerán los resultados de la búsqueda (fig. 4.3.6.1- G) los cuales podrán ser ordenados por el criterio que encabeza cada columna. Para consultar todos los registros haga uso del sistema de paginación ubicado en la parte inferior central de la tabla.

PLATAFORMA DE INTEROPERABILIDAD PDI

Documento de Operación Plataforma PDI Pagina 48 de 71

(fig. 4.3.6.1. Trámites Consumidos / Consulta)

3.7 Administrar Noticias Este modulo permite la publicación de noticias en la plataforma:

PLATAFORMA DE INTEROPERABILIDAD PDI

Documento de Operación Plataforma PDI Pagina 49 de 71

Nueva Noticia Se deben de ingresar los siguientes Parámetros:

Parámetro

Roles Seleccionar los roles para los cuales aplica la Noticia

Asunto Titulo del Mensaje

Mensaje Cuerpo del Mensaje

Vigente Desde Inicio de la Vigencia de la Noticia

Vigente Hasta Final de la Vigencia de la Noticia

PLATAFORMA DE INTEROPERABILIDAD PDI

Documento de Operación Plataforma PDI Pagina 50 de 71

PLATAFORMA DE INTEROPERABILIDAD PDI

Documento de Operación Plataforma PDI Pagina 51 de 71

3.8 Reportes

La PDI cuenta con un módulo de reportes, con el cual se puede hacer seguimiento de diferentes parámetros de comportamiento de cara al usuario final y al rendimiento mismo de la Plataforma. Esto con el fin que el administrador, tanto de las entidades como de la plataforma en sí, puedan llevar a cabo el respectivo control. Entre los reportes ofrecidos a entidades se encuentran:

o Reporte de tiempos de respuesta a usuarios de trámites. o Reporte de tiempos de respuesta de llamados de Web Services. o Reporte estadístico de comportamiento. o Reporte utilización del sistema.

PLATAFORMA DE INTEROPERABILIDAD PDI

Documento de Operación Plataforma PDI Pagina 52 de 71

3.8.1 Reporte de tiempos de respuesta a usuarios de trámites.

Para llevar a cabo la búsqueda de un reporte específico, una vez ingresado a dicha sección (fig. 4.3.7.1.), seleccione cualquiera de los diferentes campos (fig. 4.3.7.1. –A): Naturaleza del trámite, nombre, descripción, tipo de usuario, formato y/o rango de fechas del reporte. Deje los espacios en blanco para ver el listado completo de reportes disponibles. Oprima el botón buscar (fig. 4.3.7.1. –B) para llevar a cabo el proceso. Siendo listados los reportes disponibles de acuerdo a los parámetros de búsqueda asignados (fig. 4.3.7.1. –C) , seleccione el que le interese ver en detalle haciendo clic sobre el checkbox ubicado en la columna derecha de la tabla (fig. 4.3.7.1. –D) y posteriormente en el botón Ver Reporte (fig. 4.3.7.1. –E) ubicado en la parte media de la pantalla.

(fig. 4.3.7.1. Reporte Tiempos de Respuesta a usuarios – Búsqueda)

PLATAFORMA DE INTEROPERABILIDAD PDI

Documento de Operación Plataforma PDI Pagina 53 de 71

La pantalla siguiente encontrará los resultados al(los) reporte(s) seleccionados (fig. 4.3.7.2.). En primera instancia contará en la parte superior con una barra de herramientas la cual le permitirá navegar entre páginas del reporte (fig. 4.3.7.2. – A), asignar el ancho de la página (fig. 4.3.7.2. – B), casilla de búsqueda por palabra clave (fig. 4.3.7.2. – C) y módulo de exportación en diferentes formatos (fig. 4.3.7.2. – D). También cuenta con un botón para imprimir el reporte (fig. 4.3.7.2. – E). En cuanto al detalle del reporte contará con seis (6) columnas principales a saber: Entidad, Tipo, Trámite, Prerrequisito, Vista Plataforma y Vista Ciudadano. Las cuatro primeras describen los datos básicos del trámite/servicio consultado. La columna Vista Plataforma (fig. 4.3.7.2. – F) se compone a su vez de tres (3) columnas adicionales que son Duración promedio de ejecución del trámite, Tiempo mínimo de ejecución y Tiempo máximo de ejecución (medidos en segundos respecto al comportamiento de la plataforma). La columna Vista Ciudadano (fig. 4.3.7.2. – G) cuenta con los mismos parámetros con la diferencia que son medidos respecto al usuario. Al final se encontrarán totalizados los resultados por cada columna.

(fig. 4.3.7.2. Reporte Tiempos de Respuesta a usuarios – Resultados)

PLATAFORMA DE INTEROPERABILIDAD PDI

Documento de Operación Plataforma PDI Pagina 54 de 71

3.8.2 Reporte de tiempos de respuesta de llamados de Web Services.

Respecto a la búsqueda de un reporte específico correspondiente a llamados de adaptadores, debe seleccionar cualquiera de los diferentes campos (fig. 4.3.7.3. – A): Naturaleza del trámite, nombre, descripción, agrupado por, formato de promedio y/o rango de fechas del reporte. Deje los espacios en blanco para ver el listado completo de reportes disponibles. Oprima el botón buscar (fig. 4.3.7.3. – B) para llevar a cabo el proceso. Una vez listados los reportes disponibles correspondientes a los parámetros de búsqueda seleccionados (fig. 4.3.7.3. – C), escoja el que desee ver en detalle haciendo clic sobre el checkbox ubicado en la columna derecha de la tabla (fig. 4.3.7.3. – D) y posteriormente en el botón Ver Reporte (fig. 4.3.7.3. – E) ubicado en la parte media de la pantalla.

(fig. 4.3.7.3. Reporte Tiempos de Respuesta llamados a Web Services – Búsqueda)

PLATAFORMA DE INTEROPERABILIDAD PDI

Documento de Operación Plataforma PDI Pagina 55 de 71

En la siguiente pantalla encontrará los resultados al(los) reporte(s) seleccionados (fig. 4.3.7.4.). En primera instancia contará en la parte superior con una barra de herramientas similar a la dispuesta en el reporte anteriormente descrito (fig. 4.3.7.4. – A), donde adicionalmente contará con un segmento inicial (fig. 4.3.7.4.- B) el cual señala el período de tiempo seleccionado en los parámetros de búsqueda, junto con la descripción de del año con más ejecuciones exitosas y año con más ejecuciones fallidas. Una tabla más abajo (fig. 4.3.7.4.- C) encontrará los parámetros de descripción del trámite tales como Año, Mes, Semana/Día, Entidad, Trámite, Código, Versión y las columnas Método Ejecución y Método Consulta, las cuales a su vez se dividen en Ejecuciones Exitosas, Ejecuciones Fallidas y Tiempo Promedio de Respuesta en segundos tanto para el primer como para el segundo concepto. Estos parámetros describen los datos referentes al promedio, al máximo y al mínimo de ejecuciones. Posteriormente encontrará las gráficas que sustentan los datos anteriormente suministrados (fig. 4.3.7.4.- D).

PLATAFORMA DE INTEROPERABILIDAD PDI

Documento de Operación Plataforma PDI Pagina 56 de 71

(fig. 4.3.7.4. Reporte Tiempos de Respuesta llamados a Web Services – Resultados)

3.8.3 Reporte estadístico de comportamiento.

En cuanto a la búsqueda de un reporte estadístico de comportamiento, seleccione cualquiera de los diferentes campos (fig. 4.3.7.7. – A): Naturaleza del trámite, nombre, descripción, tipo de usuario, agrupado por y/o rango de fechas del reporte. Adicionalmente cuenta con la opción comparar (fig. 4.3.7.7. – B) para ser habilitada en el caso que se desee ejecutar dicho proceso entre varios reportes. Deje los espacios en blanco para ver el listado completo de reportes disponibles. Oprima el botón buscar (fig. 4.3.7.7. – C) para llevar a cabo el proceso.

PLATAFORMA DE INTEROPERABILIDAD PDI

Documento de Operación Plataforma PDI Pagina 57 de 71

Estando listados los reportes disponibles de acuerdo a los parámetros de búsqueda asignados (fig. 4.3.7.7. – D), seleccione el que le interese ver en detalle haciendo clic sobre el checkbox ubicado en la columna derecha de la tabla (fig. 4.3.7.7. – E) y posteriormente en el botón Ver Reporte (fig. 4.3.7.7. – F) ubicado en la parte media de la pantalla.

(fig. 4.3.7.7. Reporte Estadístico de Comportamiento – Búsqueda)

La pantalla siguiente encontrará los resultados al(los) reporte(s) seleccionados (fig. 4.3.7.8.). Nuevamente podrá hacer uso de la barra de herramientas ubicada en la parte superior de la pantalla (fig. 4.3.7.8. – A). Adicionalmente encontrará una primera tabla la columna fecha en la cual estará relacionado el nombre de la entidad, el año al que corresponde el reporte, el mes y los días en curso. Por cada uno de ellos estarán relacionados el número de ejecuciones y consultas realizadas (fig. 4.3.7.8. – B).

PLATAFORMA DE INTEROPERABILIDAD PDI

Documento de Operación Plataforma PDI Pagina 58 de 71

En la parte inferior del reporte se encontrarán las correspondientes gráficas que sustentan los datos suministrados anteriormente (fig. 4.3.7.8. – C).

(fig. 4.3.7.8. Reporte Estadístico de Comportamiento – Resultados)

3.8.4 Reporte Utilización del sistema.

Referente a la búsqueda de un reporte orientado a la utilización del sistema debe seleccionar cualquiera de los diferentes campos (fig. 4.3.7.9. – A): Naturaleza del trámite, nombre, descripción, tipo usuario, formato y/o rango de fechas del reporte. Deje los espacios en blanco para ver el listado completo de reportes disponibles. Oprima el botón buscar (fig. 4.3.7.9. – B) para llevar a cabo el proceso. Siendo listados los reportes disponibles correspondientes a los parámetros de búsqueda asignados anteriormente (fig. 4.3.7.9. – C), escoja el que desee ver en detalle haciendo clic sobre el checkbox ubicado en la columna derecha de la tabla (fig. 4.3.7.9. – D) y posteriormente en el botón Ver Reporte (fig. 4.3.7.9. – E) ubicado en la parte media de la pantalla.

PLATAFORMA DE INTEROPERABILIDAD PDI

Documento de Operación Plataforma PDI Pagina 59 de 71

(fig. 4.3.7.9. Reporte Estadístico Utilización del Sistema – Búsqueda)

En la siguiente pantalla encontrará los resultados al(los) reporte(s) seleccionados (fig. 4.3.7.10.). Como ya ha sido nombrado en los reportes anteriores, contará en la parte superior con la barra de herramientas para navegación del mismo (fig. 4.3.7.10. – A), donde también contará con un segmento (fig. 4.3.7.10. – B) el cual señala el nombre de la entidad, el tipo de ejecución (trámite ó servicio) y posteriormente los campos de seguimiento de rendimiento como Numero de Accesos, Número de Consultas, Número de Solicitudes Fallidas, Número de Solicitudes Exitosas, Número de Fallas, Duración promedio de ejecución, Tiempo mínimo de ejecución y tiempo máximo de ejecución. Para cada una de estas filas corresponde cada trámite o servicio registrado a la entidad con sus correspondientes valores y su respectivo gran total (fig. 4.3.7.10. – C).

PLATAFORMA DE INTEROPERABILIDAD PDI

Documento de Operación Plataforma PDI Pagina 60 de 71

(fig. 4.3.7.10. Reporte Estadístico Utilización del Sistema – Resultados)

3.9 Logs Para mayor información sobre esta funcionalidad favor remitirse al manual de Auditoria de la Plataforma de Interoperabilidad:

ADC PDI Manual de Auditoria de la aplicación Plataforma de Interoperabilidad.doc

3.10 Configuración En esta sección se modifican los parámetros iniciales de configuración de los diferentes entornos de la Plataforma de Interoperabilidad: • Entidades • Ciudadano • Empresas • Administración PDI

PLATAFORMA DE INTEROPERABILIDAD PDI

Documento de Operación Plataforma PDI Pagina 61 de 71

3.10.1 Funcional

3.10.1.1 Generales

Parámetro

URL de la aplicación PREPRODUCCION

Este parámetro es utilizado cuando se le envía un correo Administrador de entidad indicándole el URL desde donde se puede solicitar un trámite en PREPRODUCCION, el valor debe ser el URL donde se encuentra instalada la aplicación, recuerde la diferencia entre PREPRODUCCION y PRODUCCION.

URL de la aplicación PRODUCCION

Este parámetro es utilizado cuando se le envía un correo Administrador de entidad indicándole el URL desde donde se puede solicitar un trámite en PRODUCCION, el valor debe ser el URL donde se encuentra instalada la aplicación, recuerde la diferencia entre PREPRODUCCION y PRODUCCION.

Correo de PDI El correo electrónico usado para enviar correos desde PDI.

3.10.1.2 Entidades

Parámetro

Longitud Máxima Nombre Trámite

Este parámetro es utilizado para el máximo número de caracteres para mostrar del nombre de un trámite

Longitud Máxima Nombre Trámite en Árbol

Este parámetro es utilizado para el máximo número de caracteres para mostrar del nombre de un trámite cuando se encuentra desplegado dentro de un árbol

Tamaño de Paginación Este parámetro es utilizado para regular el número de registros que salen en las tablas de los resultados de búsquedas.

Máxima Historia de Este parámetro es usado para restringir por

PLATAFORMA DE INTEROPERABILIDAD PDI

Documento de Operación Plataforma PDI Pagina 62 de 71

Trámites fecha (máximo hasta esta fecha) los trámites que se listan en las búsquedas de resultados de los mismos. El valor de este parámetro en meses.

Máxima Historia Este parámetro representa el tiempo máximo que se mantiene un trámite en el histórico. El valor de este parámetro es en meses.

Filtro tipos de archivos Este parámetro representa los tipos de archivos que se pueden subir como instructivos de prueba. El valor de este parámetro es una cadena de caracteres indicando cuales tipos de archivos son validos, ej: “.doc, .ppt, .jpg

3.10.1.3 Empresas

Parámetro

Longitud Máxima Nombre Trámite

Este parámetro es utilizado para el máximo número de caracteres para mostrar del nombre de un trámite

Tamaño de Paginación Este parámetro es utilizado para regular el número de registros que salen en las tablas de los resultados de búsquedas.

Máxima Historia de Trámites

Este parámetro es usado para restringir por fecha (máximo hasta esta fecha) los trámites que se listan en las búsquedas de resultados de los mismos. El valor de este parámetro en meses.

Máxima Historia Este parámetro representa el tiempo máximo que se mantiene un trámite en el histórico. El valor de este parámetro es en meses.

3.10.1.4 Ciudadanos

Parámetro

Longitud Máxima Nombre Este parámetro es utilizado para el máximo

PLATAFORMA DE INTEROPERABILIDAD PDI

Documento de Operación Plataforma PDI Pagina 63 de 71

Trámite número de caracteres para mostrar del nombre de un trámite

Tamaño de Paginación Este parámetro es utilizado para regular el número de registros que salen en las tablas de los resultados de búsquedas.

Máxima Historia de Trámites

Este parámetro es usado para restringir por fecha (máximo hasta esta fecha) los trámites que se listan en las búsquedas de resultados de los mismos. El valor de este parámetro en meses.

Máxima Historia Este parámetro representa el tiempo máximo que se mantiene un trámite en el histórico. El valor de este parámetro es en meses.

Filtro tipos de archivos Este parámetro representa los tipos de archivos que se pueden subir como instructivos de prueba. El valor de este parámetro es una cadena de caracteres indicando cuales tipos de archivos son validos, ej: “.doc, .ppt, .jpg

Error al Subir el Archivo Este parámetro representa el error que le aparecerá al usuario ciudadano cuando ocurra un error al intentar subir un archivo que no cumpla con el filtro de tipo de archivo

3.10.1.5 Administrador PDI

Parámetro

Longitud Máxima Nombre Trámite

Este parámetro es utilizado para el máximo número de caracteres para mostrar del nombre de un trámite

Longitud Máxima Nombre Trámite en Árbol

Este parámetro es utilizado para el máximo número de caracteres para mostrar del nombre de un trámite cuando se encuentra desplegado dentro de un árbol

Tamaño de Paginación Este parámetro es utilizado para regular el número de registros que salen en las tablas de los resultados de búsquedas.

PLATAFORMA DE INTEROPERABILIDAD PDI

Documento de Operación Plataforma PDI Pagina 64 de 71

Máxima Historia de Trámites

Este parámetro es usado para restringir por fecha (máximo hasta esta fecha) los trámites que se listan en las búsquedas de resultados de los mismos. El valor de este parámetro en meses.

Máxima Historia Este parámetro representa el tiempo máximo que se mantiene un trámite en el histórico. El valor de este parámetro es en meses.

Máxima fecha de solicitud pendiente

Este parámetro representa el tiempo máximo para que una solicitud esté en estado “Pendiente” antes de estar resaltada en rojo. El valor de este parámetro es en días.

3.10.2 Técnica

3.10.2.1 Generales

Parámetro

TimeOut WebService Entidad

Este parámetro es utilizado para especificar el tiempo de espera de respuesta cuando se hace un llamado a un Web Service de una entidad. El valor de esta llave está en Milisegundos.

Directorio destino Archivos Directorio en el cual van a quedar los archivos que sean subidos en los formularios. El valor de esta llave debe ser un path a un directorio, ej: “\\Servidor\Carpeta”

Directorio Archivos Respuesta

Directorio en el cual van a quedar los archivos que vienen como respuesta de la entidad. El valor de esta llave debe ser un path a un directorio, ej: “\\Servidor\Carpeta”

Directorio Archivos Logs Directorio en el cual van a quedar los archivos que se generan al eliminar registros de logs. El valor de esta llave debe ser un path a un directorio, ej: “\\Servidor\Carpeta”

PLATAFORMA DE INTEROPERABILIDAD PDI

Documento de Operación Plataforma PDI Pagina 65 de 71

3.10.2.2 Administración Empresas

Parámetro

TimeOut WebService Este parámetro es utilizado para especificar el tiempo de espera de respuesta cuando se hace un llamado a un Web Service de una entidad. El valor de esta llave está en Milisegundos.

3.10.2.3 Administración Entidades

Parámetro

TimeOut WebService Este parámetro es utilizado para especificar el tiempo de espera de respuesta cuando se hace un llamado a un Web Service de una entidad. El valor de esta llave está en Milisegundos.

Dirección Servidor de Reportes

Este parámetro indica el URL del servidor de Reportes

3.10.2.4 Sitio Ciudadanos

Parámetro

TimeOut WebService Este parámetro es utilizado para especificar el tiempo de espera de respuesta cuando se hace un llamado a un Web Service de una entidad. El valor de esta llave está en Milisegundos.

Dirección Archivos Ciudadanos

Directorio donde se almacenan los archivos que vienen como respuesta de la entidad.

3.10.2.5 Sitio Administración PDI

Parámetro

TimeOut WebService Este parámetro es utilizado para especificar el tiempo de espera de respuesta cuando se hace

PLATAFORMA DE INTEROPERABILIDAD PDI

Documento de Operación Plataforma PDI Pagina 66 de 71

un llamado a un Web Service de una entidad. El valor de esta llave está en Milisegundos.

Dirección Servidor de Reportes

Este parámetro indica el URL del servidor de Reportes

3.11 Administración de Tablas

3.11.1 Administrar Tipos de Documentos Esta función permite generar nuevos tipos de documentos (Cedula de Ciudadania, Número de Identificación Tributaria, Cedula de Extranjería, etc)

Al seleccionar el link Crear Nuevo, nos carga la siguiente pantalla, debemos ingresar el ID y la Descripción para el nuevo Documento:

PLATAFORMA DE INTEROPERABILIDAD PDI

Documento de Operación Plataforma PDI Pagina 67 de 71

3.11.2 Administrar Países Este modulo permite crear, modificar y eliminar parámetros de países:

PLATAFORMA DE INTEROPERABILIDAD PDI

Documento de Operación Plataforma PDI Pagina 68 de 71

Crear Código es la llave de la tabla, por lo que este valor debe ser único y no se puede repetir. El Código es tipo Carácter por lo que la aplicación difiere del Código 1 del Código 01.

PLATAFORMA DE INTEROPERABILIDAD PDI

Documento de Operación Plataforma PDI Pagina 69 de 71

Modificar Permite editar los campos de Código y Nombre, es de anotar que si se modifica el código este no debe de existir en ningún otro pais.

Eliminar Al seleccionar el Link Eliminar, automáticamente se genera una ventana de confirmación para la eliminación del mismo

3.11.3 Administrar Departamentos Este modulo permite crear, modificar y eliminar parámetros de Departamentos:

PLATAFORMA DE INTEROPERABILIDAD PDI

Documento de Operación Plataforma PDI Pagina 70 de 71

Crear Código es la llave de la tabla, por lo que este valor debe ser único y no se puede repetir. El Código es tipo Carácter por lo que la aplicación difiere del Código 1 del ID Código.01

PLATAFORMA DE INTEROPERABILIDAD PDI

Documento de Operación Plataforma PDI Pagina 71 de 71

Modificar Permite editar los campos de Código y Nombre, es de anotar que si se modifica el código este no debe de existir en ningún otro Departamento.

Eliminar Al seleccionar el Link Eliminar, automáticamente se genera una ventana de confirmación para la eliminación del mismo

3.12 Cerrar Sesión