ADC PDI Manual Operacion y Administración PDI - Gobierno en línea.

PLATAFORMA DE INTEROPERABILIDADPDIMINISTERIO DE COMUNICACIONESINTRANET GUBERNAMENTAL:PLATAFORMA DE INTEROPERABILIDADMANUAL DE OPERACIÓN Y ADMINISTRACION DE PDIDerechos ReservadosBogotá, D.C.

PLATAFORMA DE INTEROPERABILIDADPDIInformación del DocumentoNombre del Proyecto: Plataforma de InteroperabilidadPreparado por: Mauricio Blanco / Luis Felipe García Versión del Documento:: DefinitivaCargo: Líder Desarrollo / Funcionario HP Fecha: 31/07/2007Revisado Por:Fecha de revisión:Lista de DistribuciónDe: Fecha Teléfono/Fax/EmailPara: Acción Fecha Teléfono/Fax/EmailDra. Maria Isabel Mejía Aprobación 31/07/2007 mmejia@agenda.gov.coJose Luis Rodriguez Aprobación 31/07/2007 josel.rodriguez@telecom.net.co*Documento de Operación Plataforma PDI Pagina 2 de 123

PLATAFORMA DE INTEROPERABILIDADPDITabla de Contenido1. AVISO DE CONFIDENCIALIDAD ................................................................................................... 62. ACEPTACIONES ........................................................................................................................ 73. INTRODUCCIÓN ....................................................................................................................... 84. PRESENTACIÓN ........................................................................................................................ 95. CONCEPTOS GENERALES ......................................................................................................... 116. PLATAFORMA DE INTEROPERABILIDAD DEL ESTADO COLOMBIANO ............................................... 136.1 Concepto de la Plataforma de Interoperabilidad. .......................................................... 136.1.1 Usuarios de la Plataforma de Interoperabilidad ...................................................................... 156.2 Trámites y Servicios en la Plataforma de Interoperabilidad. ......................................... 166.2.1 Definición de Trámite .......................................................................................................... 166.2.2 Definición de Servicios. ....................................................................................................... 216.3 Arquitectura de la Plataforma de Interoperabilidad. ..................................................... 236.3.1 Implementación de trámites y servicios. ................................................................................ 236.3.2 Ambientes de ejecución. ...................................................................................................... 257. REGISTRO EN LA PLATAFORMA DE INTEROPERABILIDAD ............................................................ 297.1 Procedimiento para registro de ciudadanos ................................................................... 297.1.1 Procedimiento a seguir por el ciudadano ............................................................................... 297.1.2 Procedimiento a seguir por el administrador de la PDI ............................................................ 337.2 Procedimiento para registro de entidades .............................................................................. 377.2.1 Procedimiento a seguir por la entidad ................................................................................... 377.3 Procedimiento para registro de Usuarios Delegados ................................................................ 427.4 Registro de asociación de certificados digitales de clientes ...................................................... 457.4.1 Firma digital y validación ..................................................................................................... 457.4.2 Registro de asociación de certificados digitales para ciudadanos .............................................. 468. GESTIÓN DE TRÁMITES Y SERVICIOS DE LA PDI ......................................................................... 508.1 Proceso para la creación de Trámites o Servicios. .......................................................... 508.1.1. Diseño del flujo de ejecución del trámite o servicio. ................................................................ 528.1.2. Desarrollo de los servicios de soporte al trámite o servicio. ...................................................... 52Documento de Operación Plataforma PDI Pagina 3 de 123

PLATAFORMA DE INTEROPERABILIDADPDI8.1.3. Requerimientos de los Adaptadores de Agencia Conectada. ..................................................... 538.1.4. Tipos de Web Services requeridos. ....................................................................................... 578.2. Registro del trámite o servicio en la plataforma de Interoperabilidad. ......................... 598.2.1. Creación del trámite o servicio. ............................................................................................ 598.2.2. Adición Trámite .................................................................................................................. 738.3. Gestión de trámites o servicios. ...................................................................................... 768.3.1. Modificación del trámite o servicio. ....................................................................................... 768.3.2. Eliminación del trámite o servicio. ......................................................................................... 798.3.3. Consultas........................................................................................................................... 828.3.4. Reportes. ........................................................................................................................... 859. UTILIZACIÓN DE LOS TRÁMITES Y SERVICIOS EXPUESTOS EN LA PLATAFORMA DE INTEROPERABILIDAD979.1. Sistemas de Información ................................................................................................ 979.1.1. Pasos Previos y Prerrequisitos para conectar Sistemas de Información que invocan tramites/serviciospublicados en la PDI ........................................................................................................... 989.1.2. Conexión a la Interfase de Servicios Web de la PDI ...............................................................1009.2. Uso de tramites/servicios publicados en la PDI por el Ciudadano ................................1049.3. Uso de tramites/servicios publicados en la PDI por el Funcionario Público .................1059.4. Uso de tramites/servicios publicados en la PDI por el Administrador Delegado ..........10510. COMPONENTES PLATAFORMA DE INTEROPERABILIDAD ............................................................. 10611. ELEMENTOS A RESPALDAR EN PLATAFORMA PDI ...................................................................... 11312. PROCEDIMIENTOS RECOMENDADOS DE OPERACION ................................................................. 11412.1. Diaria ...............................................................................................................................11412.1.1. Ingresar al sitio de administración de PDI .............................................................................11412.1.2. Buscar registros de logs .....................................................................................................11512.1.3. Depuración de logs ............................................................................................................11812.2. Semanal ...........................................................................................................................11912.3. Mensual............................................................................................................................12012.4. Anual ...............................................................................................................................12013. RECUPERACION DE DESASTRES .............................................................................................. 12114. SECUENCIA DE ENCENDIDO – APAGADO DE LA PLATAFORMA PDI ............................................... 122Documento de Operación Plataforma PDI Pagina 4 de 123

PLATAFORMA DE INTEROPERABILIDADPDI15. CONSIDERACIONES DEL ENTORNO DE PLATAFORMA DE INTEROPERABILIDAD ............................. 12315.1. Configuración de la Plataforma: ...................................................................................... 12315.2. Reportes: ................................................................................................................... 123Documento de Operación Plataforma PDI Pagina 5 de 123

PLATAFORMA DE INTEROPERABILIDADPDI2. ACEPTACIONESLas siguientes firmas significan la aprobación por parte de Colombia Telecomunicaciones y elprograma Agenda de Conectividad del presente documento.Agenda de ConectividadAgenda de ConectividadNombre: Dra. Maria Isabel Mejía Nombre: Jose Luis RodriguezFecha: 31/07/2007 Fecha: 31/07/2007Documento de Operación Plataforma PDI Pagina 7 de 123

PLATAFORMA DE INTEROPERABILIDADPDI3. INTRODUCCIÓNEl presente documento corresponde a las recomendaciones de operación de la plataformapara el Proyecto PDI diseñado e implementado para El Programa Agenda deConectividad, 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 deSistema Operativo y aplicación Microsoft. Estos elementos requieren de una operacióncorrecta que permita mantener la alta disponibilidad y confiabilidad de la solución.Los procedimientos de operación claros, definidos y establecidos permiten mantener demanera segura y disponible la plataforma y sus servicios.Documento de Operación Plataforma PDI Pagina 8 de 123

PLATAFORMA DE INTEROPERABILIDADPDI4. PRESENTACIÓNLos sistemas de la Administración Pública se adquieren generalmente solución a solución,determinados por la necesidad de adquirir la mejor solución para satisfacer un objetivoespecífico. Como resultado de esto, se crea una amplia gama de islas de información y dedatos a través de la Administración Pública - sin que exista una manera sencilla dedesbloquear los valiosos activos de información que todas ellas contienen en su conjunto,para dar soporte a procesos más útiles y productivos.Los programas de interoperabilidad pueden ayudar a resolver estos problemas. Unacercamiento bien estructurado a la interoperabilidad ayuda a abrir bodegas de datos y deinformación, y permitir que la información sea intercambiada más fácil y útilmente entresistemas. Las aplicaciones de gestión pueden entonces aprovechar toda aquella informaciónintegrada para proporcionar una mejor percepción, un mayor control y una eficienciaoperacional mejorada en la gestión de la información. Como resultado final, es posible estarmejor informados, facilitar la toma de decisiones más oportunas, y todo ello relacionado conuna mejor eficiencia en los costos.Los sistemas de información de las diferentes entidades del Estado Colombiano cumplen conla misión específica para la cual fueron desarrollados, pero estos sistemas de información nosiempre son compatibles entre si, dificultando el intercambio de información y, por lo tanto,haciendo menos eficiente la administración pública. Para garantizar el adecuado flujo deinformación y de interacción entre los sistemas de información de las entidades del Estado,se hace necesario implementar modelos de integración e interoperabilidad que permitan quesistemas de información incompatibles puedan comunicarse adecuadamente. Este conjuntode modelos es el que provee y soporta la Plataforma de Interoperabilidad de la IntranetGubernamental, permitiendo a un sistema de información comunicarse con cualquier otro demanera adecuada.Interacción entre entidades del estado: Intercambio de Información y utilización de Trámitesy Servicios. Las entidades del estado necesitan interactuar por dos razones principales:• Intercambiar información• Utilizar los trámites y servicios integrados, ofrecidos por los sistemas deinformación de las entidades.Estos dos tipos de interacción son los que provee la plataforma de interoperabilidad parasatisfacer los requerimientos de las entidades del Estado.Documento de Operación Plataforma PDI Pagina 9 de 123

PLATAFORMA DE INTEROPERABILIDADPDIInteracción entre las entidades del estado y los ciudadanos: Trámites y servicios en líneaLos ciudadanos necesitan interactuar con las entidades del Estado, para:• Obtener Información• Utilizar servicios en línea• Ejecutar trámites en líneaEstos tres tipos de interacción son los que debe permitir la plataforma de interoperabilidadpara satisfacer los requerimientos de las entidades del Estado y los ciudadanos.Documento de Operación Plataforma PDI Pagina 10 de 123

PLATAFORMA DE INTEROPERABILIDADPDI5. CONCEPTOS GENERALESLa interoperabilidad en este documento está relacionada con la posibilidad de que lossistemas de las Administraciones Públicas trabajen juntos de forma satisfactoria y productivaindependientemente de la tecnología o la aplicación que se utilice, o el proveedor hasuministrado el sistema subyacente.Si bien la interoperabilidad puede tener significados diferentes dependiendo del contexto, eltérmino generalmente es entendido como “la capacidad de diferentes productos y serviciosde tecnología de información para intercambiar y usar datos e información con el objetivo defuncionar juntos en un entorno conectado en red.”Varias fuentes de todo el mundo corroboran esta definición, entre estas:• El Diccionario de Telecomunicaciones de Newton define la interoperabilidad como“la capacidad de gestionar el software y el intercambio de información en una redheterogénea, p. e. una red extensa constituida por varias redes locales diferentes.”• El Acta de e-Government de los EE.UU. del año 2002 define la interoperabilidadcomo “la capacidad con la que comunican e intercambian datos diferentessistemas operativos y de software, aplicaciones, y servicios de una manera exacta,eficaz y consistente.”• De la misma forma, el Acta de Derechos de Autor de Milenio Digital de los EE. UU(DMCA) del año 1998 define la interoperabilidad como “la capacidad con la queprogramas de ordenador intercambian información, así como la de utilizarmutuamente esa información que ha sido intercambiada entre ellos.”• Un libro blanco sobre interoperabilidad creado por EICTA (European IT tradeassociation) en junio de 2004, define la interoperabilidad como “la capacidad dedos o más redes, sistemas, dispositivos, aplicaciones o componentes paraintercambiar información entre ellos y usar la información intercambiada.”• El Marco europeo de Interoperabilidad, una iniciativa para facilitar lainteroperabilidad de servicios y sistemas a nivel pan-europeo, define lainteroperabilidad como “la capacidad de los sistemas de Tecnologías de laInformación y las Comunicaciones (TIC) y de los procesos de negocio quesoportan, para intercambiar datos y permitir compartir la información yconocimientos.”Documento de Operación Plataforma PDI Pagina 11 de 123

PLATAFORMA DE INTEROPERABILIDADPDIEn su acepción más simple, la interoperabilidad trata de asegurar que los sistemas trabajenjuntos. Algunos de los factores subyacentes para la puesta en práctica de programas deinteroperabilidad en la Administración Pública son:• Servicios centrados en los ciudadanos: asegurando el despliegue de serviciospúblicos e información de modo que tengan sentido para los ciudadanos.• Eficacia operacional: facilitando la alineación de procesos empresariales ytecnológicos en la Administración Pública para trabajar con más eficacia, como unaorganización colectiva más que como un conjunto de almacenes de informaciónseparados.• Un retorno de la inversión (ROI), la interoperabilidad entre nuevos entornos ysistemas existentes permite cualquier migración gradual, eficiente y evolutiva anuevas plataformas.El empleo de los estándares apropiados ayuda a establecer la interoperabilidad a través demuchos proveedores, tecnologías y productos existentes en el mercado y de ahí que permitaa productos dispares el hecho de poder compartir datos para funcionar juntos en un entornoconectado en red. Puede alcanzarse mejor este objetivo propuesto mediante unacombinación de aproximaciones complementarias, incluyendo estándares abiertos. Lainteroperabilidad puede ser simplificada enormemente:• Una sintaxis estándar, en la cual la información de todos los sistemas pueda serexpresada inequívocamente.• Unos modelos semánticos estándar, de modo que las organizaciones pudieranexpresar sus prácticas de negocio en un lenguaje consistente.• Unos protocolos estándar, de modo que la información pudiera traspasar fronterasentre entornos operativos y entre organizaciones.• Un estándar intermedio para enlazar comportamientos a documentos de negocio.Documento de Operación Plataforma PDI Pagina 12 de 123

PLATAFORMA DE INTEROPERABILIDADPDI6. PLATAFORMA DE INTEROPERABILIDAD DEL ESTADO COLOMBIANOLa plataforma de Interoperabilidad comprende la infraestructura de interoperabilidadmediante la incorporación de estándares de intercambio de información para el gobierno(GEL-XML), y las herramientas que permiten la integración y la interacción adecuada de lossistemas de información de las entidades del estado, y establece una sólida base tecnológicapara el intercambio de información, servicios, y la implementación de trámites en línea.Usuarios FinalesConvencionesUsuariosEnrutadorAdmin.EnrutadorTransaccionalFuncionarioPúblicoGestionasolicitaCiudadanosolicitaGobierno enlínearedireccionaFuncionarioEmpresasolicitaConsume serviciosConsume serviciosS.I. Empresa 1S.I. Empresa 2UsuariosEntidadesUsuariosEmpresasAdmin. PruebasValidaPresta serviciosS.I. Entidad 1S.I. Entidad 1UsuariosEnrutadorAdmin.DelegadopermiteEnrutador TransaccionalRegistra/modifica/ellimina tramites/serviciosadministraPresta serviciosConsume serviciosS.I. Entidad 3S.I. Entidad 2CiudadanoWebServiceS.I. (Sistema deInformación)Admin.Admin. EntidadEmpresaUsuarios AdministradoresFigura 1. Modelo Conceptual Plataforma de Interoperabilidad6.1 Concepto de la Plataforma de Interoperabilidad.La Plataforma de Interoperabilidad del Estado Colombiano permite la conexión de losdiferentes participantes que intervienen en los procesos del Estado Colombiano querequieren de algún tipo de intercambio de información para ejecutar un proceso. Deforma conceptual actúa de concentrador inteligente en un modelo radial (hub andDocumento de Operación Plataforma PDI Pagina 13 de 123

PLATAFORMA DE INTEROPERABILIDADPDIspoke). El concentrador es inteligente porque no solo actúa como concentrador yenrutador si no que es posible definir operaciones compuestas en el centro de la estrellaque integre servicios de múltiples proveedores.Figura 2. Modelo Hub and Spoke de la Plataforma de InteroperabilidadComo se observa en la figura anterior, la Plataforma de Interoperabilidad seencuentra conceptualmente en el centro de la estrella integrando los satélites queinteractúan en los procesos de gobierno del estado colombiano. Esto permite queactúe como gestor y mediador entre los diferentes actores que participan en losprocesos.A partir de este modelo la Plataforma de Interoperabilidad está en capacidad deofrecer a los diferentes satélites del modelo los servicios expuestos por los otros. Así,Documento de Operación Plataforma PDI Pagina 14 de 123

PLATAFORMA DE INTEROPERABILIDADPDIpor ejemplo, un ciudadano puede consumir un servicio ofrecido por una EntidadGubernamental interactuando exclusivamente con la Plataforma de Interoperabilidad.Igualmente, esto permite tener la capacidad de crear cadenas de serviciosespecializando cada uno los participantes como consumidor o prestador de servicios.6.1.1 Usuarios de la Plataforma de InteroperabilidadLos siguientes son los Actores/Usuarios identificados en la Plataforma deInteroperabilidad:Actor/Usuario Descripción Creado en el SistemaporPersona Natural o Ciudadano Persona Natural.N/A(Abstracto)Empresa (Abstracto) Persona Jurídica N/AEntidad (Abstracto) Agencia del gobierno N/AAdministrador de Plataforma Encargado de administrar todos los servicios La instalación del Sistemade Interoperabilidadde gestión que presta la Plataforma deInteroperabilidad.Administrador de Pruebas Ayuda en las labores de verificación y pruebas Administrador de la PDIde nuevos trámites/servicios o nuevasversiones de estos.Administrador Delegado Ayuda al Administrador en las labores de Administrador de la PDIgestión de la PDIAdministrador de Entidad Encargado de la Entidad para la efectuar toda Solicitado por él mismo,la interacción con la Plataforma de Autorizado por elInteroperabilidad, es el encargado de crear y Administrador de la PDImodelar el trámite de su entidad, creación deusuarios delegados de su entidad, hace uso delsistema de gestión para la entidad.Administrador EmpresaUsuario DelegadoCiudadanoUsuario AnónimoPersona encargada de administrar los serviciosde la Plataforma de Interoperabilidad para unaempresa, esta es la encargada de crearusuarios delegado de su empresa y puedehacer uso del sistema de gestión para laempresapersona delegada por una entidad o empresapara ejecutar y consultar trámites en nombrede la entidad o empresaPersona Natural que hace uso de los serviciosde la Plataforma de Interoperabilidad, puedeejecutar trámites, consultar resultado detrámites efectuados.Persona Natural que no tiene o no necesita unusuario en el sistema para poder interactuarSolicitado por él mismo,Autorizado por elAdministrador de la PDIAdministrador de Entidad oEmpresaSolicitado por él mismo,Autorizado por elAdministrador de la PDIN/ADocumento de Operación Plataforma PDI Pagina 15 de 123

PLATAFORMA DE INTEROPERABILIDADPDISistema de Informacióncon el.Sistemas de Información de Entidades oEmpresas que hacen uso de los trámitesexpuestos a través de servicios Web (WebServices) que expone la Plataforma deInteroperabilidad. Estos sistemas deinformación pueden solo iniciar la ejecución deServicios (no trámites).Administrador de Entidad oEmpresa6.2 Trámites y Servicios en la Plataforma de Interoperabilidad.6.2.1 Definición de TrámiteSe considera un trámite a toda interacción entre un ciudadano o una empresa y unaentidad del Estado, así como toda interacción entre entidades del estado. De estamanera, existirían tres tipos de trámites: Trámites informativos o consultas a entidades gubernamentales. Trámites normados o trámites. Trámites no normados o servicios.Los Trámites electrónicos buscan ofrecer una alternativa respecto a los trámitestradicionales, permitiéndole al ciudadano interactuar con el Estado a través de canalesno tradicionales, y a las entidades del Estado interactuar entre ellas, a través de laIntranet gubernamental.Un trámite tradicional puede exigir: Que el ciudadano haga presencia física y se identifique con su documento deidentidad en el momento de realizar el trámite. Fotocopia del documento de identidad. Firma. Huella Digital. Autenticación notarial de la firma o de alguno de los documentos anexos.Así mismo, algunos trámites, para garantizar que la información diligenciada en susformularios no va a ser cambiada, utilizan papel de seguridad. Todos estosrequerimientos van asociados a requerimientos de autenticación, integridad y norepudiación.Documento de Operación Plataforma PDI Pagina 16 de 123

PLATAFORMA DE INTEROPERABILIDADPDIPara que sea viable, un trámite electrónico debe tener características equivalentes a lasde su contraparte tradicional. Un trámite tradicional puede requerir del ciudadano eldiligenciamiento de un formulario, una firma, una huella, que se identifique con sucédula de ciudadanía, un recibo de consignación, documentación anexa, y más.El trámite electrónico debe ofrecer a la entidad información equivalente, que tenga lasmismas características y cumplan con los mismos requerimientos que se piden para eltrámite tradicional. Es por ello que para analizar lo que necesita un trámite electrónico,es necesario estudiar el trámite tradicional y sus características. Un trámite tradicionalpuede ser estructurado de la siguiente manera: Datos Documentos anexos Documentos generados por el usuario o por terceros Documentos generados como resultado de otro trámite Resultado6.2.1.1 Representación de trámitesUn Trámite (Tx) que se representa como un círculo tiene asociado un conjuntode datos de entrada y salida. Los datos de entrada corresponden a los camposnecesarios para la ejecución del trámite, mientras que los de salida estánrelacionados a los resultados de su ejecución. La representación gráfica de esteconcepto es:Figura 3. Representación grafica de un trámite o servicio.La ejecución de un trámite solo se podrá dar si tiene todos los datos de entradarequeridos, ya sean propios u obtenidos de sus trámites prerrequisito. Untrámite puede requerir como insumo (datos de entrada) el resultado (datos desalida) de otros trámites. Así, se define una relación de dependencias entretrámites.Documento de Operación Plataforma PDI Pagina 17 de 123

PLATAFORMA DE INTEROPERABILIDADPDILa ejecución de un Árbol de Trámites como el mostrado en la siguiente gráfica,requiere que se conozcan los datos de entrada de todos los trámites del árbol,conformando así una lista unificada (debido a que puede haber datos comunes)de datos de entrada (compuesta por la unión de los datos de entrada para TA,TB, TC, TE y TG) y salida para el árbol (compuesta por los datos de salida deTA), así:Figura 4. Árbol de ejecución de trámites.Según lo anterior, puede haber datos comunes entre todos los trámites de unárbol, estos solo deben ser solicitados una vez durante la ejecución completa delárbol.La información de entrada de un trámite padre (como TA) está compuesta por lainformación ingresada por el usuario, junto con un subconjunto de los datos desalida para los trámites TB y/o TC. La siguiente gráfica muestra como los datosde salida de un trámite prerrequisito (TB) alimentan algunos datos de entradade un trámite TA:Documento de Operación Plataforma PDI Pagina 18 de 123

PLATAFORMA DE INTEROPERABILIDADPDIFigura 5. Flujo de datos en trámites compuestos.El conjunto de datos de entrada y salida para un trámite, está modelado por unesquema independiente basado en GEL-XML.6.2.1.2 Ejecución de Trámites.La ejecución de un trámite, puede requerir la ejecución previa de los trámitescon los que se relaciona, denominados Trámites Prerrequisitos, y asírecurrentemente.Figura 6. Tramites compuestos.La anterior figura muestra un Árbol de Trámites, donde el trámite TA, tienecomo trámites prerrequisitos, los trámites TB y TC, y a su vez, TC tiene comoDocumento de Operación Plataforma PDI Pagina 19 de 123

PLATAFORMA DE INTEROPERABILIDADPDIprerrequisitos los trámites TE y TG. Con lo anterior, el orden de ejecución finaldel árbol sería por niveles del árbol, como se muestra a continuación:1. TE y TG2. TB y TC3. TAEn un escenario ideal, la ejecución se hará por niveles, sin embargo, puededarse el caso en que la ejecución de TE y TG tome demasiado tiempo y sepueda iniciar la de TB, sin esperar a su culminación.Adicionalmente, se pueden llegar a presentar relaciones más complejas comola mostrada a continuación.Figura 7. Tramite compuesto con prerrequisitos compartidos.En esta variante de la anterior, se puede notar como el trámite TE esprerrequisitos de los trámites TB y TC.La ejecución completa de un árbol consiste de varias fases:1. Obtención de la información requerida (datos de entrada) por cada unode los trámites que deben ser ejecutados en el árbol.2. Ejecución de cada uno de los trámites con la información suministrada.Un árbol de trámites es recorrido de arriba hacia abajo durante la primera fase,y en sentido inverso durante la segunda.Documento de Operación Plataforma PDI Pagina 20 de 123

PLATAFORMA DE INTEROPERABILIDADPDILa primera fase de la ejecución se desglosa en los siguientes pasos:1. Obtener la información para un trámite TX2. Según los datos ingresados para el trámite TX, se evalúa cuáles de sustrámites prerrequisitos son necesarios de ejecutar (algunos de estospuedes ser de ejecución condicional según la información ingresada paraTX).3. Se repite recurrentemente los pasos 1 y 2 para cada uno de los trámitesprerrequisitos que será necesario ejecutar según la evaluación en elpaso 2.6.2.2 Definición de Servicios.Se considera un servicio a toda interacción entre un ciudadano o una empresa y unaentidad del Estado, así como toda interacción entre entidades del estado. De estamanera, existirían dos tipos de servicios: Servicios informativos o consultas a entidades gubernamentales. Trámites no normados o servicios.Los servicios electrónicos buscan ofrecer una alternativa respecto a los serviciostradicionales, permitiéndole al ciudadano interactuar con el Estado a través de canalesno tradicionales, y a las entidades del Estado interactuar entre ellas, a través de laIntranet gubernamental.Un servicio tradicional puede exigir:Que el ciudadano haga presencia física y se identifique con su documento deidentidad en el momento de realizar el servicio.Fotocopia del documento de identidad.Firma.Huella Digital.Autenticación notarial de la firma o de alguno de los documentos anexos.Así mismo, algunos servicios, para garantizar que la información diligenciada en susformularios no va a ser cambiada, utilizan papel de seguridad. Todos estosrequerimientos van asociados a requerimientos de autenticación, integridad y norepudiación.Documento de Operación Plataforma PDI Pagina 21 de 123

PLATAFORMA DE INTEROPERABILIDADPDIPara que sea viable, un servicio electrónico debe tener características equivalentes a lasde su contraparte tradicional. Un servicio tradicional puede requerir del ciudadano eldiligenciamiento de un formulario, una firma, una huella, que se identifique con sucédula de ciudadanía, un recibo de consignación, documentación anexa, y más.El servicio electrónico debe ofrecer a la entidad información equivalente, que tenga lasmismas características y cumplan con los mismos requerimientos que se piden para elservicio tradicional. Es por ello que para analizar lo que necesita un servicio electrónico,es necesario estudiar el servicio tradicional y sus características. Un servicio tradicionalpuede ser estructurado de la siguiente manera:DatosDocumentos anexosDocumentos generados por el usuario o por tercerosResultado6.2.2.1 Representación de serviciosUn Servicio (Tx) que se representa como un círculo tiene asociado un conjuntode datos de entrada y salida. Los datos de entrada corresponden a los camposnecesarios para la ejecución del servicio, mientras que los de salida estánrelacionados a los resultados de su ejecución. La representación gráfica de esteconcepto es:Figura 8. Representación grafica de un servicio.6.2.2.2 Ejecución de servicios.La ejecución de un servicio solo se podrá dar si tiene todos los datos de entradarequeridos.Documento de Operación Plataforma PDI Pagina 22 de 123

PLATAFORMA DE INTEROPERABILIDADPDI6.3 Arquitectura de la Plataforma de Interoperabilidad.6.3.1 Implementación de trámites y servicios.Para que una entidad pueda exponer un trámite o servicio a través de la Plataforma deInteroperabilidad debe registrarlo previamente y seguir una secuencia de pasos que lohabiliten (ver capítulo 4 Gestión de Trámites y Servicios de la PDI). De forma similar,para que un actor pueda consumir un trámite o servicio expuesto a través de laPlataforma de Interoperabilidad debe ejecutar un proceso de registro y autenticación(ver capítulo 3 Registro en la Plataforma de Interoperabilidad).Los Trámites y servicios de las entidades gubernamentales constituyen la base deservicios de la PDI. El modelo requiere que la Entidad desarrolle Web Services concaracterísticas específicas y haga referencia a estos Web Services en la PDI. En capítulosposteriores se describirán las características que deben cumplir el Web Service y elprocedimiento para crear la referencia en la PDI. Un Web Service que satisfaga estosrequerimientos se califica como un Adaptador de Agencia Conectada, abreviadocomo AAC. Un trámite puede tener relación de ejecución con otros trámites. De estaforma es posible crear trámites compuestos que integren lógica de múltiples trámites yentidades. Dentro de estos conceptos se puede entender la PDI como una pasarela deservicios de múltiples prestadores de servicio.CiudadanoAdaptador deAgencia ConectadaEntidad ATramite ASistema deInformaciónEmpresaAdaptador deAgencia ConectadaEntidad ATramite BAdaptador deAgencia ConectadaEntidad BServicio CCiudadanoAdaptador deAgencia ConectadaEntidad CTramite DFigura 9. Presentación de trámites o servicios en la PDI:Documento de Operación Plataforma PDI Pagina 23 de 123

PLATAFORMA DE INTEROPERABILIDADPDIComo se describe en la grafica anterior, los tramites o servicios son publicados por lasEntidades o Agencias gubernamentales en la Plataforma de Interoperabilidad yexpuestos a los consumidores por la PDI. De esta forma la relación del consumidor deltrámite o servicio es exclusivamente con la PDI que actúa como gestor de ejecución deltrámite o servicio con las entidades.Dada la capacidad de estructurar trámites compuestos en la PDI se establece que larelación de un consumidor de un trámite en la PDI no es necesariamente uno a uno conlas entidades o los tramites expuestos por estas si no que es posible que cuando unciudadano seleccione ejecutar un trámite de una entidad, este trámite establezca unarelación transitiva con otro tramite de otra entidad. La siguiente figura describe estecomportamiento.CiudadanoAdaptador deAgencia ConectadaEntidad ATramite ASistema deInformaciónEmpresaAdaptador deAgencia ConectadaEntidad ATramite BAdaptador deAgencia ConectadaEntidad BServicio CCiudadanoAdaptador deAgencia ConectadaEntidad CTramite DFigura 10. Tramites compuestos en la PDI.Un usuario que consume el trámite D establece una relación indirecta con el Adaptadorde Agencia Conectada para el trámite D en la Entidad C sin requerir ninguna otrarelación. Pero si el servicio que consume es el Trámite B, que requiere del Trámite Dpara la ejecución, el usuario establece una relación transitiva con la Entidad Cejecutando el Trámite D. Este modelo resalta una de las principales características de laPlataforma de Interoperabilidad que es el concepto de desarrollar dinámicamente en laPDI jerarquías de ejecución de trámites compuestos. Esta capacidad determina unaDocumento de Operación Plataforma PDI Pagina 24 de 123

PLATAFORMA DE INTEROPERABILIDADPDInaturaleza de entorno de desarrollo en la PDI para las entidades que están definiendolos trámites y servicios que expondrán a través de la PDI, creando un modelo demúltiples ambientes de ejecución para la Plataforma de Interoperabilidad.6.3.2 Ambientes de ejecución.La naturaleza de plataforma de desarrollo de la PDI requiere de un ambiente dedesarrollo y preproducción en donde los encargados de la EntidadesGubernamentales puedan implementar el trámite y servicio y establecer los trámitesprerrequisito que requiere la ejecución de este. De esta forma un administrador deentidad encargado de la definición de un trámite o servicio tiene la posibilidad de definirlas relaciones entre trámites, conectar los Adaptadores de Agencia Conectada, realizarpruebas de funcionamiento todo esto en un entorno privado antes de que el servicio seapublicado efectivamente al público. Este entorno se denomina dentro de la PDI como elambiente de Preproducción.Documento de Operación Plataforma PDI Pagina 25 de 123

PLATAFORMA DE INTEROPERABILIDADPDIAdministrador dePlataformaSistema deInformaciónAmbiente dePreproducciónAdministración de laPlataforma deInteroperabilidadCiudadanoDe pruebaAAC - PruebasEntidad A - Tramite AAAC – Pru. Rta. Aut.Entidad A - Tramite AAAC - PruebasEntidad A - Tramite BAAC – Pru. Rta. Aut.Entidad A - Tramite BEmpresade pruebasAAC - PruebasEntidad B - Servicio CCiudadanoDe pruebaAAC - PruebasEntidad C - Tramite DAAC – Pru. Rta. Aut.Entidad C - Tramite DAdministrador deEntidadGestión de tramitesPor entidadesFigura 11. Ambiente de Preproducción de la PDI.El ambiente de preproducción constituye un entorno de desarrollo y pruebas paralas que las Entidades puedan definir, probar, estabilizar y solicitar la publicación de lostrámites y servicios que serán publicados en el Ambiente de Producción de la PDI.Este modelo exige crear y mantener usuarios finales de pruebas que deben seradministrados por cada una de las entidades que están en el proceso de pruebas. Lagestión de la entidad se realiza mayoritariamente en este ambiente, es acá donde sedefine el trámite, se establecen las dependencias con otros trámites y se establecenlas propiedades asociadas a los trámites y servicios.En este ambiente se requieren dos tipos de Adaptadores de Agencia Conectada - AAC.Un AAC de pruebas que debe estar conectado a los sistemas de pruebas en laentidad. Es utilizado para probar puntualmente la lógica y funcionalidad de eseDocumento de Operación Plataforma PDI Pagina 26 de 123

PLATAFORMA DE INTEROPERABILIDADPDItrámite particular. Es un modelo idéntico al que estará implementado en producciónpero conectado a los sistemas de prueba en la entidad. Además de este se requiereun segundo tipo de adaptador que permite las pruebas de trámites donde el trámiteen cuestión es un prerrequisito, esto en caso de que la solicitud corresponda a untrámite.En resumen, se identifican tres tipos de AACs:1. AAC de producción2. AAC de pruebas, conectado al sistema de pruebas de la entidad3. AAC que permite las pruebas de trámites donde el trámite en cuestión es unprerrequisito (en caso de que aplique). También denominado AAC “Dummy”.Ambiente dePreproducciónAmbiente deProducciónAdministrador dePlataformaSistema deInformaciónAdministración de laPlataforma deInteroperabilidadCiudadanoDe pruebaEmpresade pruebasCiudadanoDe pruebaTramite A Tramite B Servicio C Tramite DAAC - PruebasEntidad A - Tramite AAAC – Pru. Rta. Aut.Entidad A - Tramite AAAC - PruebasEntidad A - Tramite BAAC – Pru. Rta. Aut.Entidad A - Tramite BAAC - PruebasEntidad B - Servicio CAAC - PruebasEntidad C - Tramite DAAC – Pru. Rta. Aut.Entidad C - Tramite DAdministrador dePlataformaCiudadanoSistema deInformaciónEmpresaCiudadanoAdministración de laPlataforma deInteroperabilidadTramite A Tramite B Servicio C Tramite DAAC - ProducciónEntidad ATramite AAAC - ProducciónEntidad ATramite BAAC - ProducciónEntidad BServicio CAAC - ProducciónEntidad CTramite DGestión de tramitesPor entidadesGestión de tramitesPor entidadesAdministrador deEntidadAdministrador deEntidadProceso de publicaciónFigura 12. Ambientes de preproducción y producción de la PDI.Documento de Operación Plataforma PDI Pagina 27 de 123

PLATAFORMA DE INTEROPERABILIDADPDIUna vez el trámite o servicio ha sido completamente probado en el ambiente depreproducción el administrador de la entidad solicita a la plataforma su publicación enel ambiente de producción, utilizando las herramientas de administración que proveela misma plataforma.Un trámite o servicio publicado puede ser accedido por los usuarios que eladministrador de la entidad haya definido. La siguiente tabla indica cual tipo de AACes llamado por cada uno de los usuarios del sistema dependiendo del ambiente en elque se encuentren:Ciudadano/Usuario DelegadoSistema de InformaciónAmbiente PreproducciónAAC conectado a los sistemas depruebas en la EntidadAAC conectado a los sistemas depruebas en la EntidadAmbiente ProducciónAAC conectado a los sistemas deproducción en la EntidadAAC conectado a los sistemas deproducción en la EntidadDocumento de Operación Plataforma PDI Pagina 28 de 123

PLATAFORMA DE INTEROPERABILIDADPDI7. REGISTRO EN LA PLATAFORMA DE INTEROPERABILIDADPara solicitar las credenciales de autenticación, ya sea para publicar o usar servicios, en laPlataforma de Interoperabilidad las entidades gubernamentales deben comunicarse con laAgenda de Conectividad donde se establece el procedimiento a seguir para la solicitud yemisión de las credenciales requeridas.Como respuesta a la solicitud el solicitante recibirá las instrucciones de acceso al Sitio Webpara registro, previa aprobación del requerimiento.En general, el procedimiento a seguir en la solicitud y emisión de las credenciales para losciudadanos y/o administradores es el mismo, difiere solamente los campos que se debendiligenciar.7.1 Procedimiento para registro de ciudadanos7.1.1 Procedimiento a seguir por el ciudadano1. Se entra al sitio Web correspondiente en este caso el sitio de ciudadanos (URL:http://200.21.208.237/PDISitioCiudadanos/Login.aspx), se hace clic en el link Ingresopor primera vez.Documento de Operación Plataforma PDI Pagina 29 de 123

PLATAFORMA DE INTEROPERABILIDADPDIDocumento de Operación Plataforma PDI Pagina 30 de 123

PLATAFORMA DE INTEROPERABILIDADPDI2. El sistema despliega una pantalla solicitando los datos del usuario (InformaciónPersonal e Información de Seguridad) que va a ser agregado en la Plataforma deInteroperabilidad (PDI).Documento de Operación Plataforma PDI Pagina 31 de 123

PLATAFORMA DE INTEROPERABILIDADPDI3. Se diligencia el formulario llenando todos los campos de manera correcta y se haceclic en el botón enviar formulario.Documento de Operación Plataforma PDI Pagina 32 de 123

PLATAFORMA DE INTEROPERABILIDADPDI4. El sistema envía una notificación por pantalla de que la solicitud ha sido enviadasatisfactoriamente.7.1.2 Procedimiento a seguir por el administrador de la PDIEl proceso continúa en el sitio de Administración de la PDI, por lo tanto se mostrarán lasoperaciones que realizará el administrador de la PDI, una vez haya iniciado sesión en elsitio Web correspondiente.Documento de Operación Plataforma PDI Pagina 33 de 123

PLATAFORMA DE INTEROPERABILIDADPDI1. Se ingresa al sitio de administración de la PDI, se digita el usuario y la contraseñacorrespondiente y luego se presiona el botón Aceptar.2. El sistema despliega la pantalla de bienvenida al sitio, luego en el menú deopciones se hace click en el link (Asignar Credenciales).Documento de Operación Plataforma PDI Pagina 34 de 123

PLATAFORMA DE INTEROPERABILIDADPDI3. Se busca el usuario deseado y se hace click en la opción Editar.Documento de Operación Plataforma PDI Pagina 35 de 123

PLATAFORMA DE INTEROPERABILIDADPDI4. El sistema habilita una serie de opciones, en las cuales seleccionamos el checkboxAprobar y se digita un comentario.Documento de Operación Plataforma PDI Pagina 36 de 123

PLATAFORMA DE INTEROPERABILIDADPDI5. Una vez seleccionado el usuario y completadas las opciones requeridas hacemos clic en ellink Modificar, con lo cual se guarda la información modificada.7.2 Procedimiento para registro de entidades7.2.1 Procedimiento a seguir por la entidad1. Se entra al sitio Web correspondiente en este caso Entidades (URL:http://200.21.208.237/PDIAdminEntidades/Login.aspx), se ingresa la informaciónsolicitada (Tipo Documento, No.Documento, Nit, Contraseña) de administrador deentidad autorizado en la plataforma de interoperabilidad luego se hace click en elbotón aceptar.Documento de Operación Plataforma PDI Pagina 37 de 123

PLATAFORMA DE INTEROPERABILIDADPDI2. El sistema despliega la pantalla de administración de entidades, en el menú deopciones para Sistemas de Información se observa el link (Crear) correspondientepara su creación en la plataforma de interoperabilidad.Documento de Operación Plataforma PDI Pagina 38 de 123

PLATAFORMA DE INTEROPERABILIDADPDI3. El sistema despliega una pantalla solicitando los datos del usuario en este casousuario Sistema de Información, se diligencia el formulario llenando todos loscampos de manera correcta y luego se hace click en el botón Crear Usuario.Documento de Operación Plataforma PDI Pagina 39 de 123

PLATAFORMA DE INTEROPERABILIDADPDI4. El sistema envía una notificación por pantalla “Usuario creado con Éxito, se envió uncorreo electrónico con los datos de la credencial“ de que la solicitud ha sidoprocesada satisfactoriamente.Documento de Operación Plataforma PDI Pagina 40 de 123

PLATAFORMA DE INTEROPERABILIDADPDIEl usuario Administrador de Entidad, continua con el proceso dando click en el botónContinuar.5. El sistema despliega la pantalla de administración de entidades, donde puedegestionar acciones para el sistema de información creado con son: editar, listar,buscar trámites para S. de I., Listar trámites ofrecidos para S. de I.Documento de Operación Plataforma PDI Pagina 41 de 123

PLATAFORMA DE INTEROPERABILIDADPDI7.3 Procedimiento para registro de Usuarios Delegados1. El administrador de la entidad entra al sitio Web correspondiente en este caso Entidades(URL: http://200.21.208.237/PDIAdminEntidades/Login.aspx), se ingresa la informaciónsolicitada (Tipo Documento, No.Documento, Nit, Contraseña) de administrador deentidad autorizado en la plataforma de interoperabilidad luego se hace click en el botónaceptar.Documento de Operación Plataforma PDI Pagina 42 de 123

PLATAFORMA DE INTEROPERABILIDADPDI2. El sistema despliega la pantalla de administración de entidades, en el menú de opcionespara Administración de Usuarios Delegados se observa el link (Crear Usuario Delegado)correspondiente para su creación en la plataforma de interoperabilidad.Documento de Operación Plataforma PDI Pagina 43 de 123

PLATAFORMA DE INTEROPERABILIDADPDI3. El sistema despliega una pantalla solicitando los datos del usuario en este caso UsuarioDelegado.4. Se diligencia el formulario llenando todos los campos de manera correcta y luego sehace click en el botón Crear Usuario.Documento de Operación Plataforma PDI Pagina 44 de 123

PLATAFORMA DE INTEROPERABILIDADPDI5. El sistema envía una notificación por pantalla “El usuario ha sido creado“ de que lasolicitud ha sido procesada satisfactoriamente.7.4 Registro de asociación de certificados digitales de clientes7.4.1 Firma digital y validaciónLa PDI incluye el uso de certificados digitales 1 para la autenticación en el proceso deingreso del ciudadano. En la funcionalidad se extiende el uso de certificados digitalespara la firma de la información transferida entre la plataforma de interoperabilidad y lasentidades y viceversa. En el numeral 4.1.3.3. Seguridad se establece el esquema devalidación en conjunto con las normas de seguridad de la plataforma.1 Certicamara, entidad certificadora y autorizada por la Superintendencia de Industria y ComercioDocumento de Operación Plataforma PDI Pagina 45 de 123

PLATAFORMA DE INTEROPERABILIDADPDIEl uso de certificados digitales en la PDI, permite:1. Asegurar la entrada (autenticación) a los sitios de Ciudadanos, Empresas,Entidades y Administración de la PDI.2. Firmar mensajes asegurando su procedencia y autoría, en la plataforma deinteroperabilidad.3. Encriptar la comunicación de manera que sólo el destinatario pueda verla.7.4.2 Registro de asociación de certificados digitales para ciudadanos1. Se entra al sitio Web correspondiente en este caso el sitio de ciudadanos (URL:http://200.21.208.237/PDISitioCiudadanos/Login.aspx), se ingresan los datos delciudadano a modificar, luego se hace click en el botón Aceptar.El sistema despliega una pantalla de administración de información de ciudadanos, enmenú de opciones se hace click en Actualizar Datos.Documento de Operación Plataforma PDI Pagina 46 de 123

PLATAFORMA DE INTEROPERABILIDADPDI2. En la pantalla se hace click en el botón Editar, para modificar la información delciudadano entre otros la de Asociar nuevo certificado o Eliminar certificado.Documento de Operación Plataforma PDI Pagina 47 de 123

PLATAFORMA DE INTEROPERABILIDADPDIEl proceso continua haciendo click en el botón Actualizar.3. El sistema envía una notificación por pantalla de que la solicitud de modificación hasido procesada satisfactoriamente.Documento de Operación Plataforma PDI Pagina 48 de 123

PLATAFORMA DE INTEROPERABILIDADPDIDocumento de Operación Plataforma PDI Pagina 49 de 123

PLATAFORMA DE INTEROPERABILIDADPDI8. GESTIÓN DE TRÁMITES Y SERVICIOS DE LA PDI8.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 Plataformade Interoperabilidad sigue el siguiente flujo de actividades:Documento de Operación Plataforma PDI Pagina 50 de 123

PLATAFORMA DE INTEROPERABILIDADPDIDocumento de Operación Plataforma PDI Pagina 51 de 123

PLATAFORMA DE INTEROPERABILIDADPDIA continuación se describen cada uno de los elementos de este proceso.8.1.1. 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 deinteroperabilidad, éste debe ser primero modelado. Para modelar el trámite o serviciodebe seguirse el proceso descrito en el estándar GEL-XML, tanto para la especificaciónde datos de entrada como la especificación de datos de salida. Los detalles de lastareas sugeridas para modelar el trámite o servicio y generar los esquemas GEL-XMLestán relacionadas en los documentos del estándar GEL-XML. Los resultados finales deeste proceso son:o Un esquema XSD de entrada yo Un esquema XSD de salida.Ambos esquemas existen como archivos (.XSD) y/o almacenados en un Repositorio deEsquemas GEL-XML con acceso desde la PDI.8.1.2. 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 desdela Plataforma de interoperabilidad deben residir en un Web Service con característicasespecíficas. Estas características requeridas serán descritas en el curso de estecapítulo y calificarán el cumplimiento (compliant) del Web Service con la Plataformade interoperabilidad. Cuando un Web Service satisface estos requerimientos y secalifica como compliant, el Web Service se convierte en un Adaptador de AgenciaConectada – AAC – para la Plataforma de interoperabilidad.Los Web Services son elementos fundamentales en la evolución hacia la computacióndistribuida a través de redes compartidas. Se han convertido en la plataforma deintegración de aplicaciones gracias a los estándares abiertos y al énfasis en lacomunicación y colaboración entre organizaciones y aplicaciones. Las aplicaciones seestructuran integrando múltiples Web Services de origen distinto que funcionanconjuntamente, sin importar su ubicación o la forma en que se implementaron.La Plataforma de Interoperabilidad tiene base en Web Services entre otras por lassiguientes características:Documento de Operación Plataforma PDI Pagina 52 de 123

PLATAFORMA DE INTEROPERABILIDADPDIo Los Web Services ofrecen funciones muy útiles a usuarios del medio Web yaque emplean un protocolo Web estándar que, en la Plataforma deInteroperabilidad, es SOAP.o Los Web Services permiten describir sus interfaces con suficiente detalle paraque 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 bastanteadoptado como el mecanismo de integración e interoperabilidad por excelencia.Una de las principales ventajas de la arquitectura de los Web Services es que permiteque los programas escritos en lenguajes y plataformas diferentes puedan establecercomunicación entre sí de forma estándar. Otra ventaja de los Web Services es queSOAP es bastante menos complejo que otros modelos, de modo que resulta más fácilque una implementación cumpla con los estándares de SOAP. Adicionalmente, otraventaja importante es que los Web Services se basan en protocolos estándar, comoXML, HTTP y TCP/IP. Muchas entidades gubernamentales y empresas disponen ya deuna infraestructura Web, así como de personal y conocimientos para mantenerla, demodo que el esfuerzo y costo de entrada a estos servicios es mucho menor que conotras tecnologías. Por esto, la Plataforma de interoperabilidad utiliza los Web Servicescomo las piezas de software de integración con las entidades gubernamentales y lasempresas.8.1.3. Requerimientos de los Adaptadores de Agencia Conectada.La infraestructura de Web Services se fundamenta en la comunicación por medio demensajes basados en XML que cumplen con una descripción de servicio publicada. Ladescripción del servicio es un documento XML escrito en una gramática XMLdenominada WSDL, Web Services Description Language, que define el formato demensaje comprensible para el Web Service. La descripción del servicio sirve comoacuerdo que define el comportamiento de un Web Service e indica a la Plataforma deInteroperabilidad cómo interactuar con él. El comportamiento de un Web Service estádeterminado por modelos de mensajería que el servicio define y admite. Estosmodelos dictan conceptualmente lo que el consumidor del servicio, en este caso laPlataforma de interoperabilidad, puede esperar que ocurra cuando se envía unmensaje con formato correcto al Web Service.Además de las definiciones de formato de mensaje y los modelos de mensajería, ladescripción del servicio puede contener la dirección asociada a cada punto de entradadel Web Service. El formato de esta dirección se ajusta al protocolo utilizado para elDocumento de Operación Plataforma PDI Pagina 53 de 123

PLATAFORMA DE INTEROPERABILIDADPDIacceso al servicio, como una dirección URL para HTTP en el caso de la Plataforma deinteroperabilidad.8.1.3.1. Estándares soportados.Los Web Services ofrecen comunicación para sistemas con diferentes sistemasoperativos y plataformas de desarrollo. Para conseguir este objetivo, se basan enuna familia de especificaciones de protocolos de industria, un conjunto extendidode estos estándares se denomina WS-*. Para la versión 1.0 de la Plataforma deinteroperabilidad los estándares de relacionados con Web Services soportados son:o XML, Versión 1.1o XML Schema, Versión 1.1o SOAP, Versión 1.1o WSDL, Versión 1.1o XSL, Versión 1.0o WS-Security 1.0Con el cumplimiento de los anteriores estándares y versiones, se dice que el WebService cumple con la especificación Basic Profile 1.0 de WS-I 28.1.3.2. Interfaces mínimas requeridas.La notación que utiliza un archivo WSDL para describir formatos de mensaje sebasa en el estándar XML. Esto significa que es un idioma de programación neutraly basada en estándares, lo cual es ideal para describir interfaces de Web Servicesque pueden consumirse desde una gran variedad de plataformas y lenguajes deprogramación. Además de describir el contenido de un mensaje, WSDL define ellugar en el que está disponible el servicio y qué protocolo de comunicaciones seutiliza para hablar al servicio. Esto significa que el archivo WSDL define todos loselementos necesarios para escribir un programa que pueda funcionar con un WebService. En el Anexo A, se encuentra el esquema XML que define la estructura delWSDL que soporta la versión 1.0 de la Plataforma de interoperabilidad. De esteesquema se desprende que se requieren cinco métodos obligatorios para elAdaptador de agencia conectada, estos son:MétodoConsultarDescripciónLe permite consultar a la PDI si el ciudadano ya había ejecutado previamenteese trámite o servicio, en cuyo caso retorna su resultado. Utiliza como2Mayor información sobre la especificación Basic Profile se puede encontrar en http://www.wsi.org/Profiles/BasicProfile-1.0-2004-04-16.htmlDocumento de Operación Plataforma PDI Pagina 54 de 123

PLATAFORMA DE INTEROPERABILIDADPDIEjecutarConsultarResultadoVerificarFuncionamientoTarifarparámetros de búsqueda, las Llaves de Consulta.Permite iniciar la ejecución de un trámite o servicio en la Entidad. Si elmecanismo de respuesta al usuario es Inmediato, retorna su respuesta, sino,la respuesta puede ser consultada a través de la función ConsultarResultado.Permite obtener la respuesta de trámites o servicios ejecutados de maneraNo-Inmediata.Le permite consultar a la PDI si el Web Service se encuentra en-líneaLe permite a la entidad tarifar la ejecución de un trámite.Las anteriores funciones (salvo VerificarFuncionamiento) reciben un documentoXML como parámetro de entrada y retornan otro documento XML. La estructurade estos documentos de entrada y salida se describe como parte del Anexo B. Losparámetros de cada una de estas funciones se describen a continuación:ConsultarParámetro Tipo DescripciónConsultar Entrada Estructura XML que contiene la información utilizada paraconsultar el resultado de una ejecución previa del trámiteo servicio.ConsultarResponse Salida Estructura XML que contiene la información de salida dela consulta. En el caso que se haya encontrado unaejecución previa, retorna este resultado.EjecutarParámetro Tipo DescripciónEjecutar Entrada Estructura XML que contiene la información utilizada parainiciar la ejecución de un trámite en la EntidadEjecutarResponse Salida Estructura XML que contiene el resultado de iniciar laejecución de un trámite o servicio en la Entidad.ConsultarResultadoParámetro Tipo DescripciónConsultarResultado Entrada Estructura XML que contiene la información utilizada paraconsultar el resultado de la ejecución de un trámite oservicio en la Entidad.ConsultarResultadoResponse Salida Estructura XML que contiene el resultado de la ejecuciónde un trámite o servicio, si este ya es conocido.Documento de Operación Plataforma PDI Pagina 55 de 123

PLATAFORMA DE INTEROPERABILIDADPDIVerificarFuncionamientoParámetro Tipo DescripciónVerificarFuncionamiento Entrada Estructura XML que contiene la información utilizada paraconsultar el estado del sistema de informaciónbooleano Salida Verdadero si el sistema se encuentra activo, de locontrario FalseTarifarParámetro Tipo DescripciónTarifar Entrada Estructura XML que contiene la información utilizada paratarifar la ejecución de un trámite en la Entidad.TarifarResponse Salida Estructura XML que contiene el resultado de la tarifaciónde un trámiteImportante: si un trámite o servicio fue modelado por la entidad para requerir “firmadigital”, el total del formulario de entrada (como formulario XHTML) diligenciado por elusuario es firmado utilizando su Certificado Digital. Esto naturalmente implica que soloaquellos usuarios que disponen de un Certificado Digital como medio de Autenticaciónpueden ejecutar estos trámites o servicios.Una vez firmado el formulario, este llega al Web Service de la Entidad en su versiónfirmada y “plana” (dentro del parámetro “formulariofirmado”), donde puede ser validadoy/o almacenado como constancia de no-repudio.Documento de Operación Plataforma PDI Pagina 56 de 123

PLATAFORMA DE INTEROPERABILIDADPDI8.1.3.3. SeguridadWS-Security y en conjunto con Certificados Digitales deben ser utilizados paraproporcionar la autenticación, confidencialidad, e integridad de los mensajesSOAP intercambiados entre la PDI y el Web Service que soporta el trámite oservicio en la entidad. La siguiente grafica muestra como WS-Security es utilizadoen conjunto con Certificados Digitales X.509 para asegurar el intercambio demensajes SOAP. Note como ambos sistemas deben conocer previamente las LlavesPúblicas de su contraparte:El Anexo C muestra el contenido del archivo de políticas (Policies) que describe losrequerimientos de seguridad (WS-Security) que debería exigir un Web Service quesoporte un Trámite/Servicio.Importante: Solo si se cumplen los requisitos de seguridad indicados en laspolíticas, se podrá calificar el Adaptador de Agencia Conectada – AAC –comocompliant con la Plataforma de interoperabilidad.8.1.4. Tipos de Web Services requeridos.La Plataforma de interoperabilidad requiere tres Adaptadores de agencia conectadapara el soporte interno por cada uno de los trámites o servicios que sean registradosen la Plataforma. Estos adaptadores son:o Adaptador de pruebas.o Adaptador de pruebas de respuesta automática (también conocido como“dummy”).o Adaptador de producción.Documento de Operación Plataforma PDI Pagina 57 de 123

PLATAFORMA DE INTEROPERABILIDADPDITodos estos tres Adaptadores exponen la misma interfase de llamados (WSDL).8.1.4.1. Adaptador de pruebas.El propósito de este adaptador es atender los requerimientos de prueba delambiente de pre-producción de la Plataforma de interoperabilidad específicamentepara el trámite o servicio que atiende el adaptador. Debe estar conectado a lossistemas de pruebas de la entidad gubernamental, igualmente debe estar en unrecurso de localización URL especifico y particular para el adaptador. La naturalezade respuesta de este adaptador puede ser sincrónica o asincrónica, así comopuede requerir intervención humana para obtener la respuesta a la solicitud deservicio.8.1.4.2. Adaptador de pruebas de respuesta automática.El propósito de este adaptador es atender los requerimientos de prueba delambiente de pre-producción de la Plataforma de interoperabilidad para aquellostrámites o servicios para los cuales el trámite o servicio específico es unprerrequisito. Debe estar en un recurso de localización URL específico y particularpara el adaptador. La naturaleza de respuesta de este adaptador puede sersincrónica o asincrónica, pero debe producir una respuesta sin requeririntervención humana.Este adaptador debe contener la lógica de negocio internamente, y de ser la mejoropción, sin requerir conexión a los sistemas de información de la entidad. Estacaracterística implica que las reglas de negocio para datos de prueba deladaptador deben ser suficientemente completas para lograr modelar las diferentesrespuestas que pueden entregar el trámite o servicio en diferentes escenarios deejecución.8.1.4.3. Adaptador de producción.El propósito de este adaptador es atender los requerimientos del ambiente deproducción de la Plataforma de interoperabilidad. Debe estar en un recurso delocalización URL específico y particular para el adaptador. Está conectado a lossistemas de producción de la entidad y contiene toda la lógica para resolver eltrámite o servicio en producción. Es a este adaptador donde debe apuntar laPlataforma de Interoperabilidad en producción.Documento de Operación Plataforma PDI Pagina 58 de 123

PLATAFORMA DE INTEROPERABILIDADPDI8.2. Registro del trámite o servicio en la plataforma de Interoperabilidad.8.2.1. Creación del trámite o servicio.La siguiente gráfica muestra la secuencia ocurre en el proceso de registro del trámiteo servicio en la Plataforma de interoperabilidad, así como el responsable de cada tareaen el flujo.Figura 13. 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 oservicio en la PDI. Posterior a la solicitud de registro del trámite o servicio, se debepasar por una instancia de aprobación por parte del Administrador de la PDI, quienDocumento de Operación Plataforma PDI Pagina 59 de 123

PLATAFORMA DE INTEROPERABILIDADPDIdebe aprobar su publicación en el ambiente de producción. Es importante resaltarque toda la definición del trámite o servicio queda almacenada en un repositoriológico independiente.De acuerdo a lo anterior, los pasos puntuales a realizar por parte del administrador dela entidad, dentro de la herramienta para la creación de un trámite o servicio, son lossiguientes:1. Seleccionar la opción Crear Trámite o Crear Servicio, según corresponda en elmenú ubicado a la izquierda de la pantalla.2. Asignar la naturaleza del procedimiento por generar (seleccionar trámite cuandocorresponde a un proceso que debe ser ejecutado y procesado bajo una normatividadespecífica mientras que debe seleccionar servicio no cuenta con dichascaracterísticas pero sí corresponde a una implementación concreta de la entidad decara al usuario) (fig. 4.3.1.1. – A). Adicionalmente seleccione el nombre del trámite acrear (fig. 4.3.1.1. – B), el cual ya está previamente cargado en la base de datos delPEC de acuerdo a la entidad que se haya validado; para el caso de creación deservicios, el nombre debe ser digitado directamente sobre el formulario. Oprima elbotón Crear para continuar con el siguiente paso.Documento de Operación Plataforma PDI Pagina 60 de 123

PLATAFORMA DE INTEROPERABILIDADPDI(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 derespuesta (fig. 4.3.1.2. – A) la cual inicialmente será Servicio Web ya que su ejecuciónes en línea. Seguido a ello debe señalar si el procedimiento es personal eintransferible (fig. 4.3.1.2. – B) y posteriormente asignar los esquemas GEL-XML deEntrada y Salida (fig. 4.3.1.2. – C). Cada uno de ellos corresponden a los estándaresXML que van a ser implementados para favorecer la uniformidad de lostrámites/servicios y de esta manera evitar errores al momento del intercambio deinformació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 eltrá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 unusuario no registrado, Ciudadano, Sistema de información, Usuario Delgado deEmpresa o Usuario Delegado de Entidad (Ver numeral 2.1.1. Usuarios de laPlataforma de Interoperabilidad donde se describen los tipos de usuario).Documento de Operación Plataforma PDI Pagina 61 de 123

PLATAFORMA DE INTEROPERABILIDADPDI5. Una vez asignados los roles, se procede a establecer las Llaves de Consulta lascuales corresponden a los parámetros de validación que tendrá inicialmente el trámiteal momento de ser ejecutado. Dicha opción establece los parámetros de búsquedadonde 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 componenel 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 enla primera casilla del segmento derecho (fig. 4.3.1.3. – D). Repita el procedimientoanterior si desea establecer más llaves de consulta.Finalmente puede llevar a cabo asociaciones entre los campos que ya se encuentranen el registro del usuario que está llevando a cabo el trámite/servicio y los camposque 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 segmentoderecho (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 realizarla asociación y oprima le botón Guardar. La asociación quedará registrada en lasegunda casilla del segmento derecho (fig. 4.3.1.3. – F).Documento de Operación Plataforma PDI Pagina 62 de 123

PLATAFORMA DE INTEROPERABILIDADPDI(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. Encada casilla deberá ser digitado el URL en el cual se encuentra cada uno de ellos. Elprimero corresponde al webService de pruebas (fig. 4.3.1.4. – A) el cual asegura larespuesta 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 elwebService de producción (fig. 4.3.1.4. – C) el cual se encarga de la conexión con elservidor final de almacenamiento.Siendo asignados los tres (3) adaptadores de agencia conectada debe oprimir el botónIdentificar Operaciones con el fin que el aplicativo reconozca las funciones de cadauno de ellos (fig. 4.3.1.4. – D). Es preciso que en el caso de publicar eltrá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 cargadaslas operaciones de los tres (3) adaptadores.Documento de Operación Plataforma PDI Pagina 63 de 123

PLATAFORMA DE INTEROPERABILIDADPDIUna vez identificadas las operaciones, el sistema muestra el nombre del servicio y susrespectivas 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 yposteriormente 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 enlos casos que aplique), se deben asignar los trámites prerrequisito que van asociadosal trámite que se está generando. En primera instancia cuenta con una herramientapara buscar el trámite, donde selecciona el criterio de búsqueda, bajo las opcionesnombre, entidad o descripción (fig. 4.3.1.5. – A); en el siguiente campo ingrese lapalabra clave para llevar a cabo la búsqueda (fig. 4.3.1.5. – B). Deje los espacios enblanco para que sean listados todos los trámites.Estando listados los trámites como resultado de la búsqueda, seleccione en el trámiteprerrequisito en la columna de la izquierda (fig. 4.3.1.5. – C) y luego oprima el botónAdicionar (fig. 4.3.1.5. – D). El trámite seleccionado será listado en la casilla de laDocumento de Operación Plataforma PDI Pagina 64 de 123

PLATAFORMA DE INTEROPERABILIDADPDIderecha (fig. 4.3.1.5. – E). Repita el procedimiento anterior si desea adicionar mástrámites.Haga clic en el iconopara ver la definición de cada trámite.Si desea eliminar alguno de los trámites elegidos, selecciónelo en la casilla derecha yoprima 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 ladefinición si se debe ejecutar en un período determinado para lo cual hace uso de loscalendarios que aparecen al momento de seleccionar dicha opción, definición delmecanismo de respuesta al usuario (Inmediata / No Inmediata) y si el serviciorequiere el envío de documentos, para lo cual el formulario contará con unaherramienta de búsqueda dentro del disco duro del usuario y posterior carga delarchivo seleccionado. Oprima el botón Siguiente para continuar el proceso.Documento de Operación Plataforma PDI Pagina 65 de 123

PLATAFORMA DE INTEROPERABILIDADPDI(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 DatosRelevantes para cada trámite que sea necesario dentro de la selección del pasoanterior. Seleccione el nombre en la casilla izquierda (fig. 4.3.1.6. – A) y luego oprimael botón Configurar (fig. 4.3.1.6. – B).Documento de Operación Plataforma PDI Pagina 66 de 123

PLATAFORMA DE INTEROPERABILIDADPDI(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 casillaizquierda que representa el esquema GEL-XML del formulario de salida del trámiteprerrequisito (fig. 4.3.1.7. – A) y los que conforman el formulario del trámite que seestá generando, ubicado a la derecha de la pantalla (fig. 4.3.1.7. – B). Para llevar acabo 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). Unavez 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 oprimaDesasociar. Las asociaciones generadas serán listadas en la casilla inferior (fig.4.3.1.7. – F). Terminado el procedimiento oprima le botón Grabar Asociacionespara volver al formulario. Oprima el botón Siguiente para continuar con el próximopaso.Documento de Operación Plataforma PDI Pagina 67 de 123

PLATAFORMA DE INTEROPERABILIDADPDI(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 acada rol asignado en el paso 4. Seleccione el rol determinado y haga clic sobre elicono para editar los condicionales. Aparece una pantalla donde se listan todos loscampos que conforman el formulario del trámite y junto a cada uno de ellos lasposibilidades de condición, el valor de dicha condición y su correspondiente operador:Condiciones< | Mayor que> | Menor que= | Menor o igual que¡= | Diferente= | IgualOperadorAND | yOR | oDocumento de Operación Plataforma PDI Pagina 68 de 123

PLATAFORMA DE INTEROPERABILIDADPDIPor ejemplo, si necesita que el campo Mayor de Edad obedezca siempre a unarespuesta afirmativa, en el listado de campos a los que puede ser aplicadas lascondiciones 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 criteriocorrespondiente a la única respuesta para ser válido el proceso del trámite (en estecaso 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 valorasignado 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únoperador, el sistema asume AND. Pueden asignarse cuantas condiciones aplique peroteniendo 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 paradescartar 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 comola definición si el trámite se debe ejecutar en un período determinado (de acuerdo aDocumento de Operación Plataforma PDI Pagina 69 de 123

PLATAFORMA DE INTEROPERABILIDADPDIlo determinado por la norma que rige el trámite) para lo cual hace uso de loscalendarios que aparecen al momento de seleccionar dicha opción, definición delmecanismo de respuesta al usuario (Inmediata / No Inmediata) y si el trámiterequiere el envío de documentos, para lo cual el formulario contará con unaherramienta de búsqueda dentro del disco duro del usuario y posterior carga delarchivo 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 elservicio/tramite que se publica está enfocado exclusivamente a sistemas deinformación, este paso no aplica. Desde la casilla izquierda, correspondiente alesquema de entrada del trámite/servicio (fig. 4.3.1.9. – A), tome los campos quecomplementarían la información del formulario resumido en la casilla derechacorrespondiente al diseño del formato de salida (fig. 4.3.1.9. – B). Para llevar a caboeste procedimiento, seleccione el campo en la casilla izquierda (fig. 4.3.1.9. – C) yhaciendo 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 conherramientas 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). Oprimael 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 correspondientescasillas 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 elicono de error, con el fin de señalar al usuario el motivo por le cual no esaceptada la información sugerida en el campo.Elemento en el esquema: La manera como es llamado el elemento desde elGEL-XML.Oculto: Si se desea mantener oculto el elemento en el formulario.Documento de Operación Plataforma PDI Pagina 70 de 123

PLATAFORMA DE INTEROPERABILIDADPDIExpresión regular: Cuando el campo debe ser reconocido bajo un parámetroespecífico sin restricción alguna.Textbox Multilínea: Asignar esta opción cuando la casilla pueda contenerinformación que necesite suficiente espacio para ser escrita.Campo Calculado: Cuando el contenido del campo es el resultado de unaoperación realizada entre los datos de otros campos contenidos dentro delmismo formulario. Oprima el botón Editar para acceder a la ventada deconfiguración de dicha opción donde podrá seleccionar los campos y lacorrespondiente operación.Asociar credenciales del registro: Oprimiendo el botón editar aparecerá unapantalla donde podrá asociar el campo bajo ciertas variables en relación a unresultado 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ínimode caracteres.Valores: Enumeración asignada en el caso que el campo contenga variasopciones de respuesta. Este parámetro ya viene contenido en el esquema y porlo tanto no es editable.Longitud Máxima: Si el contenido del campo debe contener un número máximode caracteres.Activado por: Si el campo debe ser activado dependiendo de la informaciónincorporada en otro campo del formulario. Oprimir el botón Adicionar Reglade Activación para acceder a la ventana que lista las posibilidades deconfiguración.Documento de Operación Plataforma PDI Pagina 71 de 123

PLATAFORMA DE INTEROPERABILIDADPDI(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 losnombrados campos de configuración.Documento de Operación Plataforma PDI Pagina 72 de 123

PLATAFORMA DE INTEROPERABILIDADPDIUna vez finalizada la configuración del formulario oprima el botón Siguiente parallevar a cabo todo el procedimiento anterior pero para el formulario de salida. Una vezhecho la configuración necesaria, oprima el botón Siguiente para poder visualizardicho formulario. Posteriormente el botón Crear Trámite o Crear Servicio.8.2.2. Adición TrámiteUna vez creado el trámite/servicio, se adiciona para comenzar su proceso de pruebasy posterior publicación. Para este caso, terminado el proceso del punto anterior, le esasignado el estado “Activo en pruebas” y aparecerá listado haciendo clic en el vínculoTrámites ubicado en el menú a la izquierda de su monitor (fig. 4.3.2.1. ); en dichapantalla podrá llevar a cabo la búsqueda de los trámites/servicios generados dentro dela entidad (fig. 4.3.2.1. – A). Adicionalmente se consulta su estado y tiene acceso alas 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 deCreación , Solicitar Modificación , Solicitud de Eliminación , Inactivar ,Configuración de webService por defecto , y Eliminación .Documento de Operación Plataforma PDI Pagina 73 de 123

PLATAFORMA DE INTEROPERABILIDADPDI(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, alo 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 quesolicita la creación (fig. 4.3.2.2. – A) y debe adjuntar el instructivo que señalará aladministrador de pruebas las características principales del webService correspondiente aDummy (fig. 4.3.2.2. – B) y a Pruebas (fig. 4.3.2.2. – C), usados en la generación deltrá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 idiomade 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 unnú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 correspondienteevaluación. De acuerdo a los resultados, dicho perfil puede: A) Preaprobar el trámite/serviciopara que así el administrador PDI lleve a cabo la aprobación final. B) Reportar Errores en elcaso que los encuentre, los cuales serán relacionados en la bitácora asociada a la solicitud, lacual puede ser consultada haciendo clic en el número asignado por el sistema cuando fueefectuada la solicitud.Documento de Operación Plataforma PDI Pagina 74 de 123

PLATAFORMA DE INTEROPERABILIDADPDIParalelamente, dentro de sus funciones puede: C) Adicionar comentarios en la mencionadabitá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 quefinalmente el administrador de la entidad se encargue de la publicación quien a ese punto yaestá en disposición de hacerlo o cancelar el proceso. B) Rechazar la solicitud, agregando losrespectivos comentarios a la bitácora.Paso 3.Estando aprobada la creación del trámite/servicio, éste aparecerá en el listado de la secciónSolicitudes (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 pasospendientes o Cerrada si es el último paso por definir), Estado de la solicitud (SolicitarModificació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 desolicitud 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 deproducción.Documento de Operación Plataforma PDI Pagina 75 de 123

PLATAFORMA DE INTEROPERABILIDADPDI(fig. 4.3.2.3. Adición de trámites / Listado de Solicitudes de trámites/servicios)8.3. Gestión de trámites o servicios.Una vez una entidad ha publicado un Trámite/Servicio en la PDI, puede ejercer laboresde gestión sobre este, los siguientes son los pasos de cada una de estas labores:8.3.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 delas opciones de administración con que dispone el administrador de la entidad.Documento de Operación Plataforma PDI Pagina 76 de 123

PLATAFORMA DE INTEROPERABILIDADPDIFigura 14a. 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 acabo 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 AdministradorPDI entienda los cambios que se desean realizar. Señale los campos que van a serDocumento de Operación Plataforma PDI Pagina 77 de 123

PLATAFORMA DE INTEROPERABILIDADPDImodificados (fig. 4.3.3.1. A), ingrese el comentario correspondiente dirigido alAdministrador PDI (fig. 4.3.3.1. – B) y asigne los documentos de instructivo queseñ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 deltrámite/servicio.Una vez ingresados esos datos, oprimir el botón Enviar Solicitud. Le será asignadoun 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 .Documento de Operación Plataforma PDI Pagina 78 de 123

PLATAFORMA DE INTEROPERABILIDADPDIEl 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 deacuerdo a las necesidades.Habiendo efectuado los cambios, haga clic en el ícono para reportar los cambios aladministrador de pruebas. A partir de este momento, el proceso es el mismo que elllevado a cabo en la solicitud de creación del trámite/servicio, desde el punto en queel administrador de pruebas lo comienza a evaluar.Paso 3.Estando aprobada la modificación del trámite/servicio, en el listado de la secciónSolicitudes, haga clic en el ícono para llevar a cabo su publicación en el ambientede producción.8.3.2. Eliminación del trámite o servicio.Documento de Operación Plataforma PDI Pagina 79 de 123

PLATAFORMA DE INTEROPERABILIDADPDIFigura 15b. Secuencia de eliminación de un trámite o servicio en la PDI.Documento de Operación Plataforma PDI Pagina 80 de 123

PLATAFORMA DE INTEROPERABILIDADPDIPaso 1.Cuando la entidad desea eliminar un trámite/servicio, debe hacer la solicitud alAdministrador 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 deseaeliminar haga clic sobre su correspondiente ícono .En ese momento aparecerá una ventana emergente donde puede seleccionar la fechade 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á asignadoun 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 aeliminarlo desde el listado generado en la sección Solicitudes mediante clic al ícono .Documento de Operación Plataforma PDI Pagina 81 de 123

PLATAFORMA DE INTEROPERABILIDADPDI8.3.3. Consultas8.3.3.1. Consulta de Trámites Ofrecidos.Una vez generados los trámites y/o servicios, puede llevar a cabo la consulta delos mismos y llevar a cabo su respectivo seguimiento. A continuación la descripciónde los pasos para realizar la consulta:1. Seleccionar la opción Trámites Ofrecidos en el menú ubicado a la izquierda dela pantalla. Dentro de esta sección podrá consultar los trámites que a la fechaestán registrados como ofrecidos por la entidad a los ciudadanos.2. Encontrará dos fragmentos, el superior (fig. 4.3.5.1. – A) donde podrá realizarla 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 Hastapara determinar la fecha de publicación del trámite o servicio. Si la búsquedaconsiste en el estado del trámite, puede seleccionar bajo los criterios Conrespuesta, Con error, Rechazado, Esperando Entidad, Esperando prerrequisitos,Listo para ejecutar, Con error ejecución, Preparando ejecución los cuales sondefinidos en el punto de modificación de trámites. También puede llevar a cabo labúsqueda por el nombre del trámite. Deje todos los espacios en blanco si deseabuscar bajo todos los parámetros. Oprima el botón Buscar para ejecutar labú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 todoslos registros haga uso del sistema de paginación ubicado en la parte inferiorcentral de la tabla (fig. 4.3.5.1. – F).Documento de Operación Plataforma PDI Pagina 82 de 123

PLATAFORMA DE INTEROPERABILIDADPDI(fig. 4.3.5.1. Trámites Ofrecidos / Consulta)8.3.3.2. Consulta de Trámites Consumidos.Dentro de los trámites y/o servicios generados y que han sido consumidos porUsuarios Delegados de la Entidad (Persona delegada por una entidad o empresapara ejecutar y consultar trámites en nombre de la entidad o empresa), seencuentra esta categoría la cual puede ser consultada siguiendo los pasos que sedescriben a continuación.1. Seleccionar la opción Trámites Consumidos en el menú ubicado a la izquierdade la pantalla. Dentro de esta sección podrá consultar los trámites que a la fechaestán registrados como ofrecidos por la entidad a los usuarios delegados.Documento de Operación Plataforma PDI Pagina 83 de 123

PLATAFORMA DE INTEROPERABILIDADPDI2. Encontrará dos fragmentos, el superior (fig. 4.3.6.1. – A) donde podrá realizarla búsqueda bajo los criterios de Nombre del Trámite (fig. 4.3.6.1. – B), Nombredel Usuario Delegado (fig. 4.3.6.1. – C), Estado (fig. 4.3. 6.1. – D), Fecha deSolicitud (fig. 4.3.6.1. – E) o Fecha de Entrega (fig. 4.3. 6.1. – F). Al igual que elpunto anterior, haga clic sobre cada icono tanto en la casilla Desde como en lacasilla 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 elestado del trámite, puede seleccionar bajo los criterios Con respuesta, Con error,Rechazado, Esperando Entidad, Esperando prerrequisitos, Listo para ejecutar, Conerror ejecución, Preparando ejecución. Deje todos los espacios en blanco si deseabuscar bajo todos los parámetros. Oprima el botón Buscar para ejecutar labú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. Paraconsultar todos los registros haga uso del sistema de paginación ubicado en laparte inferior central de la tabla.Documento de Operación Plataforma PDI Pagina 84 de 123

PLATAFORMA DE INTEROPERABILIDADPDI(fig. 4.3.6.1. Trámites Consumidos / Consulta)8.3.4. Reportes.La PDI cuenta con un módulo de reportes, con el cual se puede hacer seguimiento dediferentes parámetros de comportamiento de cara al usuario final y al rendimientoDocumento de Operación Plataforma PDI Pagina 85 de 123

PLATAFORMA DE INTEROPERABILIDADPDImismo de la Plataforma. Esto con el fin que el administrador, tanto de las entidadescomo 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 de trámites y servicios consumidos por la entidad.o Reporte estadístico de comportamiento.o Reporte utilización del sistema.8.3.4.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 dichasecció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/orango de fechas del reporte. Deje los espacios en blanco para ver el listadocompleto de reportes disponibles. Oprima el botón buscar (fig. 4.3.7.1. –B) parallevar a cabo el proceso.Siendo listados los reportes disponibles de acuerdo a los parámetros de búsquedaasignados (fig. 4.3.7.1. –C) , seleccione el que le interese ver en detalle haciendoclic 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 partemedia de la pantalla.Documento de Operación Plataforma PDI Pagina 86 de 123

PLATAFORMA DE INTEROPERABILIDADPDI(fig. 4.3.7.1. Reporte Tiempos de Respuesta a usuarios – Búsqueda)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 deherramientas 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 porpalabra 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. Lascuatro primeras describen los datos básicos del trámite/servicio consultado. Lacolumna Vista Plataforma (fig. 4.3.7.2. – F) se compone a su vez de tres (3)Documento de Operación Plataforma PDI Pagina 87 de 123

PLATAFORMA DE INTEROPERABILIDADPDIcolumnas 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 ensegundos respecto al comportamiento de la plataforma). La columna VistaCiudadano (fig. 4.3.7.2. – G) cuenta con los mismos parámetros con la diferenciaque 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)8.3.4.2. Reporte de tiempos de respuesta de llamados de Web Services.Respecto a la búsqueda de un reporte específico correspondiente a llamados deadaptadores, debe seleccionar cualquiera de los diferentes campos (fig. 4.3.7.3. –A): Naturaleza del trámite, nombre, descripción, agrupado por, formato depromedio y/o rango de fechas del reporte. Deje los espacios en blanco para ver ellistado completo de reportes disponibles. Oprima el botón buscar (fig. 4.3.7.3. – B)para llevar a cabo el proceso.Documento de Operación Plataforma PDI Pagina 88 de 123

PLATAFORMA DE INTEROPERABILIDADPDIUna vez listados los reportes disponibles correspondientes a los parámetros debúsqueda seleccionados (fig. 4.3.7.3. – C), escoja el que desee ver en detallehaciendo 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) ubicadoen la parte media de la pantalla.(fig. 4.3.7.3. Reporte Tiempos de Respuesta llamados a Web Services – Búsqueda)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 deherramientas 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 debúsqueda, junto con la descripción de del año con más ejecuciones exitosas y añocon más ejecuciones fallidas.Documento de Operación Plataforma PDI Pagina 89 de 123

PLATAFORMA DE INTEROPERABILIDADPDIUna tabla más abajo (fig. 4.3.7.4.- C) encontrará los parámetros de descripción deltrámite tales como Año, Mes, Semana/Día, Entidad, Trámite, Código, Versión y lascolumnas Método Ejecución y Método Consulta, las cuales a su vez se dividen enEjecuciones Exitosas, Ejecuciones Fallidas y Tiempo Promedio de Respuesta ensegundos tanto para el primer como para el segundo concepto. Estos parámetrosdescriben los datos referentes al promedio, al máximo y al mínimo de ejecuciones.Posteriormente encontrará las gráficas que sustentan los datos anteriormentesuministrados (fig. 4.3.7.4.- D).(fig. 4.3.7.4. Reporte Tiempos de Respuesta llamados a Web Services – Resultados)Documento de Operación Plataforma PDI Pagina 90 de 123

PLATAFORMA DE INTEROPERABILIDADPDI8.3.4.3. Reporte de trámites y servicios consumidos por la entidadPara esta opción, el administrador de la entidad cuenta con los parámetros debúsqueda de reportes Agrupado por (fig. 4.3.7.5. – A), Rango de fechas delreporte (fig. 4.3.7.5. – B) y la opción Comparar (fig. 4.3.7.5. – C) para serhabilitada en el caso que se desee ejecutar dicho proceso entre varios reportes.Una vez asignados los parámetros haga clic en el botón Ver Reporte (fig. 4.3.7.5.– D). Deje los espacios en blanco para ver todos los resultados disponibles.(fig. 4.3.7.5. Reporte Trámites / Servicios consumidos por la entidad – Búsqueda)Una vez listado el resultado de la búsqueda, y haciendo uso de la herramienta demanejo de reportes (fig. 4.3.7.6. – A) ya descrita en el primer caso, accede a losdatos establecidos bajo parámetros como promedio y total (fig. 4.3.7.6. – B),sumado al listado de los 10 trámites consumidos por la entidad, los cuales seránlistados bajo los criterios de Periodo, Trámite, Código, Versión, Número deEjecuciones y Número de Consultas (fig. 4.3.7.6. – C).Documento de Operación Plataforma PDI Pagina 91 de 123

PLATAFORMA DE INTEROPERABILIDADPDI(fig. 4.3.7.6. Reporte Trámites / Servicios consumidos por la entidad – Resultados)8.3.4.4. Reporte estadístico de comportamiento.En cuanto a la búsqueda de un reporte estadístico de comportamiento, seleccionecualquiera 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 delreporte. Adicionalmente cuenta con la opción comparar (fig. 4.3.7.7. – B) para serhabilitada 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.Estando listados los reportes disponibles de acuerdo a los parámetros de búsquedaasignados (fig. 4.3.7.7. – D), seleccione el que le interese ver en detalle haciendoclic 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 partemedia de la pantalla.Documento de Operación Plataforma PDI Pagina 92 de 123

PLATAFORMA DE INTEROPERABILIDADPDI(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 ubicadaen 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 laentidad, el año al que corresponde el reporte, el mes y los días en curso. Por cadauno de ellos estarán relacionados el número de ejecuciones y consultas realizadas(fig. 4.3.7.8. – B).En la parte inferior del reporte se encontrarán las correspondientes gráficas quesustentan los datos suministrados anteriormente (fig. 4.3.7.8. – C).Documento de Operación Plataforma PDI Pagina 93 de 123

PLATAFORMA DE INTEROPERABILIDADPDI(fig. 4.3.7.8. Reporte Estadístico de Comportamiento – Resultados)8.3.4.5. Reporte Utilización del sistema.Referente a la búsqueda de un reporte orientado a la utilización del sistema debeseleccionar cualquiera de los diferentes campos (fig. 4.3.7.9. – A): Naturaleza deltrámite, nombre, descripción, tipo usuario, formato y/o rango de fechas delreporte. Deje los espacios en blanco para ver el listado completo de reportesdisponibles. Oprima el botón buscar (fig. 4.3.7.9. – B) para llevar a cabo elproceso.Siendo listados los reportes disponibles correspondientes a los parámetros debúsqueda asignados anteriormente (fig. 4.3.7.9. – C), escoja el que desee ver endetalle 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.Documento de Operación Plataforma PDI Pagina 94 de 123

PLATAFORMA DE INTEROPERABILIDADPDI(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á enla 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 cualseñala el nombre de la entidad, el tipo de ejecución (trámite ó servicio) yposteriormente los campos de seguimiento de rendimiento como Numero deAccesos, Número de Consultas, Número de Solicitudes Fallidas, Número deSolicitudes Exitosas, Número de Fallas, Duración promedio de ejecución, Tiempomínimo de ejecución y tiempo máximo de ejecución. Para cada una de estas filascorresponde cada trámite o servicio registrado a la entidad con suscorrespondientes valores y su respectivo gran total (fig. 4.3.7.10. – C).Documento de Operación Plataforma PDI Pagina 95 de 123

PLATAFORMA DE INTEROPERABILIDADPDI(fig. 4.3.7.10. Reporte Estadístico Utilización del Sistema – Resultados)Documento de Operación Plataforma PDI Pagina 96 de 123

PLATAFORMA DE INTEROPERABILIDADPDI9. UTILIZACIÓN DE LOS TRÁMITES Y SERVICIOS EXPUESTOS EN LAPLATAFORMA DE INTEROPERABILIDAD9.1. Sistemas de InformaciónAdemás de interactuar con humanos (Ciudadanos, Usuarios Delegados, etc.), la PDItambién puede responder a solicitudes de ejecución de Trámites o Servicios desdeSistemas de Información en Entidades Públicas o Privadas previamente registradas. Elsiguiente gráfico muestra este modo de operación unificado:Figura 16. Sistema de Información utilizando la PDI.Una de las ventajas más importantes de este modelo unificado es que los Sistemas deInformación pueden aprovechar la infraestructura de hardware y software que ya existepara atender las ejecuciones de trámites o servicios hechas por humanos, además quepuede hacer uso de muchos de los trámites o servicios ya modelados. En términosgenerales un trámite o servicio puede llegar a ser modelado para ser utilizado de igualmanera por un humano y por un Sistema de Información.Sin embargo, existen algunas restricciones sobre el tipo de trámites o servicios quepueden ser ejecutados:o Estos no pueden tener prerrequisitoso Estos no pueden requerir pagos (esto solo debido a que el actual Proveedor deServicios de Pagos en el país – PSE – no fue diseñado para ser utilizado porsistemas de información).Gracias a este modelo, la PDI brinda una interfaz común de llamados, que abstrae todoslos detalles funcionales y tecnológicos de los Trámites y Servicios a sus consumidores (losSistemas de información en este caso).La naturaleza (y plataforma tecnológica) de estos sistemas de información es muyvariada, debido a esto, la funcionalidad de ejecución de Trámites o Servicios se expone aDocumento de Operación Plataforma PDI Pagina 97 de 123

PLATAFORMA DE INTEROPERABILIDADPDItravés de una Capa de Servicios Web. Esta capa expone una interfaz de llamado común,independiente del trámite o servicios que se desee ejecutar, o de su versión. Lo anterior,facilita la utilización de esta interfaz y evita cambios en el sistema de información debidoa nuevas versiones de los trámites o servicios utilizados. Además de habilitar el acceso aesta interfaz a través de estándares independientes de tecnología como SOAP, tambiénse encuentra asegurada utilizando otro estándar como lo es WS-Security. La escogenciade este estándar garantiza la autenticación, confidencialidad, e integridad de losmensajes SOAP que se intercambien entre el Sistema de Información y la PDI.Importante: dependiendo de su modalidad de llamado, la ejecución de trámites oservicios puede realizarse de manera Inmediata (sincrónica) o No-Inmediata(asincrónica). Dependiendo de esto, el Sistema de Información debe llamar al método deejecución correspondiente en la Capa de Servicios Web.La siguiente información debe permitir a un Administrador de Entidad o Empresaconectar sus Sistemas de Información a la PDI, y ejecutar trámites o servicios.9.1.1. Pasos Previos y Prerrequisitos para conectar Sistemas de Información queinvocan tramites/servicios publicados en la PDIPara que una Entidad o Empresa pueda conectar alguno de sus sistemas deinformación a la PDI debe cumplir los siguientes pasos y prerrequisitos:1. Tener credencial de Administrador de Entidad o Empresa: A través de la PDI elAdministrador de Entidad o Empresa crea una cuenta de acceso al Sistema deInformación, de la misma forma como puede crear una cuenta para un UsuarioDelegado, con la diferencia que aquí lo esta haciendo para una aplicación. Esteproceso es detallado en el punto 3 “Registro en la Plataforma deInteroperabilidad”.2. Conocer el nombre del trámite o servicio que se quiere ejecutar, incluyendo sunúmero de versión. Este proceso es detallado en el punto 3 “Registro en laPlataforma de Interoperabilidad”.3. Validar a través de la PDI que la nueva cuenta de acceso al Sistema deInformación tenga acceso al trámite o servicio deseado. Cada trámite o servicioorientado a Sistemas de Información puede tener una Lista de Control de Accesosque restringe de que Sistemas de Información puede recibir llamados de ejecución.La entidad que requiere hacer uso del servicio debe comunicarse con la entidadque lo provee para ser autorizado.Documento de Operación Plataforma PDI Pagina 98 de 123

PLATAFORMA DE INTEROPERABILIDADPDI4. Tener acceso a los esquemas GEL-XML (XSD) de Entrada y Salida (URLs donde seencuentran publicados estos), que describen la estructura de la información deentrada y salida del tramite o servicio a ejecutar. Estos van a describir la estructurade la información XML que espera y va a devolver la versión del trámite o servicio.El acceso al esquema también lo entrega la entidad responsable de exponer elservicio.5. Tener acceso a la descripción WSDL de Capa de Servicios Web de la PDI. Estadescripción puede ser encontrada en las siguientes URLs dependiendo delambiente en el que se desee invocar:Ambiente URLPreproducción http://200.21.208.237/WebServicePDI/WebServicePDI.asmx?WSDLProducción http://200.21.208.237:8077/WebServicePDI/WebServicePDI.asmx?WSDLCon base en esta descripción, y dependiendo de la herramienta de desarrollo que seutilice, se puede crear un Proxy en el Sistema de Información que representalocalmente la interfaz del servicio. El código del Sistema de Información puedeentonces llamar al Web Service a través de este Proxy local. Este Proxy debe estardirigido a las siguientes URLs dependiendo del ambiente en el que se desee invocar:AmbientePreproducciónProducciónURLhttp://200.21.208.237/WebServicePDI/WebServicePDI.asmxhttp://200.21.208.237:8077/WebServicePDI/WebServicePDI.asmx6. Tal como se mencionó, el mecanismo de seguridad de los llamados (Autenticaciónen ambos sentidos, Encripción y Firmado Digital) entre el Sistema de Informacióny la Interfaz de Servicios Web utiliza el estándar WS-Security. Este mecanismo dela forma como se configuró en la PDI utiliza Certificados Digitales X.509 deservidor en ambos extremos. Sabiendo esto, es necesario obtener y configurar enel servidor del Sistema de Información la llave pública del Certificado de la PDI (enMicrosoft Windows se almacena como un archivo con terminación .CER) y obtenerun Certificado Digital de Servidor (http://www.certicamara.com.co). Una vez laEntidad o Empresa obtenga este certificado debe hacer llegar la llave pública deeste al Administrador de la PDI.7. Cumplir con los requerimientos adicionales de seguridad a nivel de comunicaciones(protocolo) establecidos (por ejemplo: VPNs, SSL, etc.)8. Una vez desarrollados estos pasos se procede a realizar los cambios necesarios enel código del Sistema de Información para conectarse a la Interfaz de ServiciosWeb de la PDI. La naturaleza de estos cambios y el esfuerzo que implica dependenDocumento de Operación Plataforma PDI Pagina 99 de 123

PLATAFORMA DE INTEROPERABILIDADPDImucho de la plataforma tecnológica y ambiente de programación del Sistema deInformación. La sección llamada “Conexión a la Interfaz de Servicios Web de laPDI” brinda la información que puede requerir cualquier conexión a la Interfaz deServicios Web de la PDI independiente de la tecnología con que esté desarrolladoel Sistema de Información. Verifique que el ambiente de programación de laconexión al menos soporte los siguientes estándares:XML Schema, Versión 1.1SOAP, Versión 1.1/1.2WSDL, Versión 1.1WS-Security 1.0/1.1MTOMCon el cumplimiento de los anteriores estándares y versiones, se dice que el WebService cumple con la especificación Basic Profile 1.0 de WS-I9.1.2. Conexión a la Interfase de Servicios Web de la PDIUna vez se tiene acceso al WSDL que contiene la descripción XML de la interfaz delWeb Service, se puede conocer la estructura de los mensajes SOAP que reciben yresponden cada uno de los métodos expuestos por el Web Service.Importante: un Sistema de Información puede ejecutar trámites o servicios tanto enel ambiente de preproducción como de producción. Las descripciones de ambos sonidénticas, simplemente cambian sus URLs.La siguiente tabla muestra los métodos expuestos por el Web Service:MétodoEjecutarEjecutarAsyncConsultarResultadoDescripciónPermite ejecutar un trámite de manera Inmediata (Sincrónica)Permite ejecutar un trámite de manera No-Inmediata (Asincrónica). Despuésde llamar este método, se puede consultar periódicamente (polling) elresultado de la ejecución del trámite o servicio a través del métodoConsultarResultado.Permite consultar el resultado de la ejecución No-Inmediata de un trámite oservicio con ayuda de un Tiquete y un Número de Rastreo.Importante: la información de entrada o salida de un trámite o servicio tambiénpuede incluir un archivo adjunto (de ser necesario, mas de uno puede ser agrupadodentro de un .ZIP). Este archivo se puede serializar en un parámetro especial delmétodo de ejecución tal como se observa a continuación. La Capa de Servicios WebDocumento de Operación Plataforma PDI Pagina 100 de 123

PLATAFORMA DE INTEROPERABILIDADPDIsoporta el estándar MTOM que optimiza la serialización y transmisión de estosarchivos en llamados SOAP. Verifique que su implementación tiene soporte a esteestándar.Algunos aspectos adicionales en el tema de archivos adjuntos a tener encuenta:• El tamaño máximo de los archivos adjuntos de entrada es de 3 MB (configurableen la PDI).• Los archivos adjuntos de entrada y salida son sujetos a un proceso de revisión porvirus durante su paso por la PDI.La descripción de cada método se incluye a continuación:EjecutarParámetro Tipo DescripciónEjecutar Entrada Estructura XML que contiene la información de entrada dela ejecución. Su estructura se describe a continuación:• codigoTramite (entero): identifica universalmente eltrámite o servicio a ejecutar.• versionTramite (flotante): identifica la versión deltrámite o servicio.• xmlEntradaEjecucion (XML): Documento XML,representa la información de entrada del trámite oservicio. Cumple con el esquema GEL-XML de entradadel trámite o servicio.• Documento: estructura XML con la información delarchivo adjunto de entrada. Contiene:oonombreArchivo (string): nombre delarchivo.Archivo (base64Binary): archivo serializadobase64 utilizando MTOM.EjecutarResponse Salida Estructura XML que contiene la información de salida dela ejecución. Su estructura se describe a continuación:• resultado (booleano): indica el éxito de la ejecución.• resultadoEjecucion (enumeración string):información del resultado de la ejecución, que puedeser “EjecucionSatisfactoria” o “ErrorInterno”.• motivoRechazo (string): descripción del error deejecución (si lo hubo).• XmlRespuesta (XML): Documento XML, representala información de salida del trámite o servicio. Cumplecon el esquema GEL-XML de salida del trámite oDocumento de Operación Plataforma PDI Pagina 101 de 123

PLATAFORMA DE INTEROPERABILIDADPDIEjecutarAsyncservicio.Parámetro Tipo Descripción• Documento: estructura XML con la información delarchivo adjunto de salida. Contiene:oonombreArchivo (string): nombre delarchivo.Archivo (base64Binary): archivo serializadobase64 utilizando MTOM.EjecutarAsync Entrada Estructura XML que contiene la información de entrada dela ejecución. Su estructura se describe a continuación:• codigoTramite (entero): identifica universalmente eltrámite o servicio a ejecutar.• versionTramite (flotante): identifica la versión deltrámite o servicio.• xmlEntradaEjecucion (XML): Documento XML,representa la información de entrada del trámite oservicio. Cumple con el esquema GEL-XML de entradadel trámite o servicio.• Documento: estructura XML con la información delarchivo adjunto de entrada. Contiene:oonombreArchivo (string): nombre delarchivo.Archivo (base64Binary): archivoserializado base64.EjecutarAsyncResponse Salida Estructura XML que contiene la información de salida dela ejecución. Su estructura se describe a continuación:• resultado (booleano): indica el éxito de la ejecución.• resultadoEjecucion (enumeración string):información del resultado de la ejecución, que puedeser “EjecucionSatisfactoria” o “ErrorInterno”.• motivoRechazo (string): descripción del error deejecución (si lo hubo).• tiquete (entero mayor de cero): este es unconsecutivo asignado por la PDI, común a cada unode los tramites/servicios en un Árbol. Puede llegar aser igual a numeroRastreo en el caso de árbolescompuestos por un solo trámite/servicio.• numeroRastreo (entero mayor de cero): este es unconsecutivo asignado por la PDI, único para cadainstancia del trámite/servicio.Documento de Operación Plataforma PDI Pagina 102 de 123

PLATAFORMA DE INTEROPERABILIDADPDIConsultarResultadoParámetro Tipo DescripciónConsultarResultado Entrada Estructura XML que contiene la información utilizada paraconsultar el resultado de la ejecución. Su estructura sedescribe a continuación:• tiquete (entero mayor de cero):• numeroRastreo (entero mayor de cero):ConsultarResultadoResponse Salida Estructura XML que contiene la información de salida dela consulta. Su estructura se describe a continuación:• resultado (booleano): indica el éxito de la operaciónde consulta.• resultadoConsulta (enumeración string):información del resultado de la ejecución, que puedeser “EnEjecucion”, “SiExisteDocumento”,“NoExisteDocumento”, o “ErrorInterno”.• motivoRechazo (string): descripción del error deconsulta (si lo hubo).• XmlRespuesta (XML): Documento XML, representala información de salida del trámite o servicio. Cumplecon el esquema GEL-XML de salida del trámite oservicio.• Documento: estructura XML con la información delarchivo adjunto de salida. Contiene:oonombreArchivo (string): nombre delarchivo.Archivo (base64Binary): archivo serializadobase64 utilizando MTOM.9.1.2.1. SeguridadTal como ya se ha mencionado, WS-Security y los Certificados Digitales deben serutilizados para proporcionar la autenticación, confidencialidad, e integridad de losmensajes SOAP intercambiados entre el Sistema de Información y la PDI. Lasiguiente grafica muestra como WS-Security es utilizado en conjunto conCertificados Digitales X.509 para asegurar el intercambio de mensajes SOAP. Notecomo ambos sistemas deben conocer previamente las Llaves Públicas de sucontraparte:Documento de Operación Plataforma PDI Pagina 103 de 123

PLATAFORMA DE INTEROPERABILIDADPDIFigura 17. Intercambio seguro en la PDI.Adicional a los requerimientos de WS-Security, el Sistema de Información debeenviar como parte de la petición SOAP el usuario y password que le fueronasignados por el Administrador de la Entidad o Empresa en la PDI. Estos sonenviados como parte del Header del mensaje SOAP (envelope), utilizando lossiguientes parámetros:Parámetro Tipo de Dato DescripciónUsuario String Cuenta del Sistema de Información en la PDI. Creada porel Administrador de Entidad o Empresa respectivo.Clave String Password asociada a la cuenta de usuario.El Anexo D muestra el contenido del archivo de políticas (Policies) que describe losrequerimientos de seguridad (WS-Security) del Web Service.9.2. Uso de tramites/servicios publicados en la PDI por el CiudadanoLa PDI adicionalmente interactúa con Ciudadanos, donde la PDI también puederesponder a solicitudes de ejecución de Trámites o Servicios en Entidades Públicas oPrivadas previamente registradas, para el detalle del proceso y las actividadesrelacionadas con ciudadanos se debe consultar el manual de usuario de la plataforma deinteroperabilidad y el demo de la solución de acuerdo al sitio Web (Web Site) de acceso ala solución.Documento de Operación Plataforma PDI Pagina 104 de 123

PLATAFORMA DE INTEROPERABILIDADPDI9.3. Uso de tramites/servicios publicados en la PDI por el FuncionarioPúblicoLa PDI adicionalmente interactúa con Funcionarios Públicos, donde la PDI también puederesponder a solicitudes de ejecución de Trámites o Servicios en Entidades Públicas oPrivadas previamente registradas, para el detalle del proceso y las actividadesrelacionadas con Funcionario Publico se debe consultar el manual de usuario de laplataforma de interoperabilidad y el demo de la solución de acuerdo al sitio Web (WebSite) de acceso a la solución.9.4. Uso de tramites/servicios publicados en la PDI por el AdministradorDelegadoLa PDI adicionalmente interactúa con Administrador Delegado, donde la PDI tambiénpuede responder a solicitudes de ejecución de Trámites o Servicios en Entidades Públicaso Privadas previamente registradas, para el detalle del proceso y las actividadesrelacionadas con Administrador Delegado se debe consultar el manual de usuario de laplataforma de interoperabilidad y el demo de la solución de acuerdo al sitio Web (WebSite) de acceso a la solución.Documento de Operación Plataforma PDI Pagina 105 de 123

PLATAFORMA DE INTEROPERABILIDADPDI10. COMPONENTES PLATAFORMA DE INTEROPERABILIDADLa Plataforma de Interoperabilidad (plataforma PDI) está conformada fundamentalmente porcomponentes de hardware de plataforma Hewlett Packard y de software Microsoft, tanto anivel de sistema operativo como de aplicación.La solución involucra cinco (5) servidores HP Proliant DL580 G3 (tipo IIA), tres (3) servidoresHP Proliant DL380 G4 (tipo I) y un almacenamiento externo basado en un (1) HPStorageWorks MSA1000. El sistema operativo de los servidores es Microsoft Windows 2003R2 Enterprise Edition en idioma Inglés y como aplicativo Microsoft SQLserver 2000 SP3Enterprise Edition. La solución requiere de un ambiente de Directorio Activo para operarcorrectamente y en forma segura.El cuadro adjunto relaciona los equiposinstalados para la plataforma PDI:Los servidores HP Proliant tienen instalados el paquete de software denominado ProliantSupport Pack (PSP) v7.51, que incluye entre otras la herramienta SURVEY.EXE que puedeejecutarse para generar un archivo texto SURVEY.TXT en cual describe completamente laconfiguración del servidora nivel de hardware, drivers instalados y servicios activos.Se recomienda generar el listado cada vez que haya cambios en el hardware, actualizaciónde drivers. Se ejecuta C:\COMPAQ\SURVEY\survey.exe este genera el archivo C:\COMPAQ\SURVEY\survey.txtEn general esta plataforma tienen componentes redundantes en cuanto a las capas de Basede Datos, Aplicación y Front-End. Para mantener los niveles de disponibilidad HPperiódicamente Hewlett Packard publica en su página web, la actualización del ProliantDocumento de Operación Plataforma PDI Pagina 106 de 123

PLATAFORMA DE INTEROPERABILIDADPDISupport Pack (PSP), con las versiones más recientes de Drivers, Agentes y utilitarios para suplataforma de hardware:http://welcome.hp.com/country/us/en/support.html?pageDisplay=driversEl siguiente link corresponde a la página para el HP Proliant DL380 G4:Documento de Operación Plataforma PDI Pagina 107 de 123

PLATAFORMA DE INTEROPERABILIDADPDIEl link para el servidor DL580 G3, es:Documento de Operación Plataforma PDI Pagina 108 de 123

PLATAFORMA DE INTEROPERABILIDADPDIEl link para descargar el HP Proliant Support Pack (PSP) más reciente (v7.60) es:http://h18023.www1.hp.com/support/files/server/us/download/24184.htmlEn cuanto a actualizaciones relacionadas con el sistema operativo, Microsoft liberamensualmente el segundo Martes un paquete de actualizaciones de seguridad disponiblesmediante el link:http://windowsupdate.microsoft.comEstas actualizaciones deben ser evaluadas para medir su impacto sobre la funcionalidad queofrece cada servidor y seleccionar aquellas que se requieran aplicar en la plataforma.Documento de Operación Plataforma PDI Pagina 109 de 123

PLATAFORMA DE INTEROPERABILIDADPDIDocumento de Operación Plataforma PDI Pagina 110 de 123

PLATAFORMA DE INTEROPERABILIDADPDIDocumento de Operación Plataforma PDI Pagina 111 de 123

PLATAFORMA DE INTEROPERABILIDADPDIDocumento de Operación Plataforma PDI Pagina 112 de 123

PLATAFORMA DE INTEROPERABILIDADPDI11. ELEMENTOS A RESPALDAR EN PLATAFORMA PDIExisten elementos que son necesarios respaldar (backup) para proteger la información yrecuperar la funcionalidad en caso de falla. Estos elementos corresponden a:Instancia en cluster de SQL (WBOGSQL05)Bases de datos a respaldar:Bases de Datos propias de PDIo PDIo PDILOGSo PDILOGSPRODo PDIPAGOSo PDIPAGOSPRODo PDIPRODBases de datos de Biztalko BiztalkDTADBo BiztalkMgmtDVo BiztalkMsgBoxDbo SSODBMáquina de Reportes (WBOGRS01)o PDIPRODo PDILOGSPRODRecursos de archivo de cluster (WBOGDB10)o archivosDownload (N:\PDI\archivosDownload)o archivosLogs (N:\PDI\archivosLogs)o archivosUpload (N:\PDI\archivosUpload)o instructivosPruebasUpload (N:\PDI\instructivosPruebasUpload)Para todos los servidores de la plataforma se deben generar backups de SYSTEM STATE víaNTBACKUP y de la Metabase del IIS (Internet Information Services v6.0) desde su interfacede administración.Documento de Operación Plataforma PDI Pagina 113 de 123

PLATAFORMA DE INTEROPERABILIDADPDI12. PROCEDIMIENTOS RECOMENDADOS DE OPERACION12.1. DiariaRevisión de Event Logs (Visor de Sucesos). Verificar el Event Log (Visor de Sucesos) deAplicación de Windows Server en busca de eventos de error o warnings (avisos). Los eventosde error se visualizan con una señal roja (stop) y los eventos de aviso se visualizan con unaseñal amarilla (warning). Además, es conveniente observar los eventos de información(mostrados con una señal azul) para asegurarse de que el servidor está funcionandocorrectamente.Realizar Backup de datos de la plataforma:• Realizar Backup del “System State” y de la Metabase IIS de los 8 servidores.o Este backup debe hacerse adicionalmente cada vez que haya un cambio en laconfiguración.• Realizar Backup de las bases de datos y logs, con rotación de cintas semanal.De igual manera se revisan los logs própios de la aplicación, se describe este procedimiento:12.1.1. Ingresar al sitio de administración de PDI• Ingresar al siguiente URL http://200.21.208.237/PDIAdministracion• Ingresar las credencialesDocumento de Operación Plataforma PDI Pagina 114 de 123

PLATAFORMA DE INTEROPERABILIDADPDI12.1.2. Buscar registros de logs• Seleccionar la opción de ver Errores técnicos o logs de auditoria como lo muestrala siguiente figuraDocumento de Operación Plataforma PDI Pagina 115 de 123

PLATAFORMA DE INTEROPERABILIDADPDI• Ingresar los criterios de búsqueda y oprimir buscarDocumento de Operación Plataforma PDI Pagina 116 de 123

PLATAFORMA DE INTEROPERABILIDADPDI• Si desea consultar el detalle del registro , seleccionar el ID del eventoDocumento de Operación Plataforma PDI Pagina 117 de 123

PLATAFORMA DE INTEROPERABILIDADPDI12.1.3. Depuración de logs• Seleccionar la opción del menú de errores técnicos o logs de auditoria• En la sección de inferior de la pantalla ingresar los criterios para eliminar registros• Confirmar los registros a eliminarDocumento de Operación Plataforma PDI Pagina 118 de 123

PLATAFORMA DE INTEROPERABILIDADPDI12.2. SemanalDefinir instancias de Monitoreo del Sistema que permitan establecer una línea base delcomportamiento de cada servidor. Esta línea base es una referencia que ayuda a detectaren forma temprana algún comportamiento que pueda llegar a impactar la disponibilidadde la aplicación ó del servidor mismo.Los componentes a monitorear son PROCESSOR, MEMORY, NETWORK y DISKS. Loscontadores pueden darle la pauta al administrador del sistema sobre acciones iniciales atomar para mantenerla operación del servidor y su funcionalidad. Esta línea base puedeirse moviendo en la medida que los requerimientos al sistema sean más exigente encuanto a su poder de procesamiento. A partir de este tipo de información se puedeoportunamente solicitar algún tipo de actualización (upgrade) para algún servidor.Realizar Backup de datos de la plataforma:o Realizar Full Backup el día Domingo del disco del sistemao Realizar Backup el día Domingo del “System State” y de la Metabase IIS de los8 servidores.Documento de Operación Plataforma PDI Pagina 119 de 123

PLATAFORMA DE INTEROPERABILIDADPDI Este backup debe hacerse adicionalmente cada vez que haya un cambioen la configuración.o Realizar Backup el día Domingo de las bases de datos y logs, con rotación decintas mensual.12.3. MensualRealizar Backup de datos de la plataforma:• Realizar Backup el último Domingo del mes del “System State” y de la MetabaseIIS de los 8 servidores.• Realizar Backup el último Domingo del mes de las bases de datos y logs, conrotación de cintas según los requerimientos del negocio.12.4. AnualRealizar Backup de datos de la plataforma:• Realizar Backup el último Domingo del año del “System State” y de la MetabaseIIS de los 8 servidores.• Realizar Backup el último Domingo del año de las bases de datos y logs, conrotación de cintas cada según los requerimientos del negocio.Documento de Operación Plataforma PDI Pagina 120 de 123

PLATAFORMA DE INTEROPERABILIDADPDI13. RECUPERACION DE DESASTRESCon los esquemas de Backup anotados en los procedimientos anteriores, se construye laestrategia para recuperar la información de las bases de datos y logs de la plataforma PDI.El proceso de reinstalación de la plataforma se describe en el numeral 2 del presentedocumento.Componentes involucrados:o Controlador de Dominio: El servidor WBOGDC04 mantiene la información del Serviciode Directorio Activo y de Autenticación. Si el servidor falla se debe reinstalar SistemaOperativo y recuperar Full Backup del disco del Sistema. Posteriormente recuperar elmás reciente Backup de System State para restablecer la funcionalidad de los serviciosde esta máquina.o Servidor de Reportes: El servidor WBOGRS01 en caso de falla, debe reinstalarse elSistema Operativo y recuperar Full Backup del disco del Sistema. Posteriormenterecuperar el más reciente Backup de System State, Metabase, Bases de Datos y Logspara restablecer la funcionalidad de los servicios de esta máquina.o Capa de Aplicación: Se soporta con un Network Load Balance (NLB) que mantiene laoperación en caso de falla de uno de los servidores. Para recuperar el servidor fallido,debe reinstalarse el Sistema Operativo e integrarlo nuevamente al NLB. Posteriormenterecuperar el más reciente Backup de System State y Metabase para restablecer lafuncionalidad de los servicios de esta máquina.o Front End: Se soporta también con un Network Load Balance (NLB) que mantiene laoperación en caso de falla de uno de los servidores. Para recuperar el servidor fallido,debe reinstalarse el Sistema Operativo e integrarlo nuevamente al NLB. Posteriormenterecuperar el más reciente Backup de System State y Metabase para restablecer lafuncionalidad de los servicios de esta máquina.o Cluster Base de Datos: Soportado por 2 servidores en cluster de Microsoft que mantienela funcionalidad en caso de falla de uno de los dos servidores. Para recuperar el servidorfallido, debe reinstalarse el Sistema Operativo y agregarlo al cluster MSCS. Reinstalaraplicativo MS SQLserver y sus services packs.Documento de Operación Plataforma PDI Pagina 121 de 123

PLATAFORMA DE INTEROPERABILIDADPDI14. SECUENCIA DE ENCENDIDO – APAGADO DE LA PLATAFORMA PDIEsta plataforma consta de 8 servidores HP Proliant y 1 storage MSA1000. En caso de sernecesario intervenir la plataforma y que se requiera apagar/energizar el sistema poractividades como mantenimiento eléctrico, las secuencias son las siguientes:Documento de Operación Plataforma PDI Pagina 122 de 123

PLATAFORMA DE INTEROPERABILIDADPDI15. CONSIDERACIONES DEL ENTORNO DE PLATAFORMA DEINTEROPERABILIDAD15.1. Configuración de la Plataforma:• Al instalar se deben de modificar los dominios a tramitador• Al instalar se deben de modificar los parámetros de configuración• web.config: Hay que verificar que de debe de crear el directorio virtual para almacenar los archivos, comoindica el manual• Demo: Para modificar esta información debe de dirigirse a la la página index-contactenos.htm, dentrode la carpeta ayuda de cada sitio y colocar la información necesaria15.2. Reportes:• Por diseño solo se consultan trámites teniendo en cuenta la llave MAXIMA_HISTORIA, la cual está enmeses, esa puede ser una causa del incidente, para ver todos los trámites o servicios hay que especificarTODAS las fechas en el detalle de la búsqueda.• La confirmación de eliminación de LOGS es la pantalla donde se encuentra descarga del archivo de excel,adicionalmente se genera un nuevo registro de LOG de Auditoria informando la actividad realizada sobrelos datosDocumento de Operación Plataforma PDI Pagina 123 de 123