D O C U M E N T O T É C N I C O G U Í A D E U S O D E L W D S L -
E N T I D A D D E S T I N O
SERIE DE NORMAS Y PROCEDIMIENTOS
BORRADOR DOCUMENTO TÉCNICO GUÍA DE USO DEL WDSL – ENTIDAD
DESTINO
SERIE DE NORMAS Y PROCEDIMIENTOS
BORRADOR DOCUMENTO TECNICO – IPLEMENTACIÓN WSDL ENTIDAD DESTINO
Tabla de contenido
1. Introducción ... 1
2. Alcance ... 1
3. Términos empleados ... 2
4. Dirección de recursos ... 2
5. Configuración del URL destino ... 2
6. Archivos para generar la clase del WSDL ... 2
7. Generación de la clase ... 2
Confidencialidad: Público
1 Edición N° 0
Sistema Nacional de Pagos Electrónicos
Sistemas de Pagos - BCCR Año 2013
1. Introducción
El contenido de este documento describe de manera técnica la guía de uso del WDSL para que una entidad actue como destino del servicio de Pagos Monedero Bancario (PMB).
En particular, el objetivo de este documento es servir a los departamentos de informática de cada entidad bancaria como guía de implementación del WDSL cómo entidad de destino para agilizar la participación de las mismas en el servicio.
2. Alcance
Este documento explica los elementos técnicos para que una entidad pueda implementar el WSDL y así logre servir como destino a los servicios de negocio de Pagos Monedero Bancario (PMB).
Confidencialidad: Público
BORRADOR DOCUMENTO TECNICO – IPLEMENTACIÓN WSDL ENTIDAD DESTINO
2 Edición N° 0
3. Términos empleados
Para los fines del presente documento, se entenderá por:
BCCR: Banco Central de Costa Rica.
SINPE: Sistema Nacional de Pagos Electrónicos.
PMB: Servicio de Pagos Monedero Bancario.
WCF: Windows Comunication Foundation, es un marco tecnológico de trabajo para la creación de aplicaciones orientadas a servicios, en nuestro caso es la tecnología utilizada para la comunicación entre las entidades participantes y el Banco Central.
WSDL: Web Services Description Language
4. Dirección de recursos
En la siguiente dirección web podrá acceder a todos los recursos necesarios para la implementación del WSDL como una entidad cliente.
http://varela/documentacion/SERVICIOS%20EN%20TIEMPO%20REAL/ENTIDAD%20DESTIN O/Pruebas%20Monedero%20Bancario/WCF%20Destino/
5. Configuración del URL destino
El servicio implementado por la entidad en el destino debe publicarse en un IIS utilizando la tenología WCF de Microsoft. El URL de este WCF debe estar asegurado mediante el certificado digital asignado al nodo.
El URL y el CN del subject del certificado deben de configurarse dentro de las parámetros del SINPE para iniciar la puesta en marcha del servicio.
Esta configuración debe hacerse por medio del Centro de Operaciones del SINPE.
6. Archivos para generar la clase del WSDL
A continuación se detallan los archivos necesarios para generar la clase con la cual se debe implementar el WSDL, estos pueden ser accedidos desde la dirección de recursos.
bccr.sinpe.pmb.destino.wsdl bccr.sinpe.pmb.destino.xsd bccr.sinpe.pmb.si.model.xsd
schemas.microsoft.com.2003.10.Serialization.xsd
7. Generación de la clase
Para la generación de la clase necesaria para la implementación se debe usar la herramienta svcutil.exe en la línea de comandos del Visual Studio. Prmero se debe navegar hasta la
Confidencialidad: Público
3 Edición N° 0 carpeta donde se encuentren los archivos necesarios descritos en la sección anterior y seguidamente ejectuar la sintaxis especificada a continuación:
svcutil bccr.sinpe.pmb.destino.wsdl bccr.sinpe.pmb.destino.xsd bccr.sinpe.pmb.si.model.xsd
schemas.microsoft.com.2003.10.Serialization.xsd Esto genera los siguientes dos archivos dentro de la misma carpeta:
MonederoBancario.cs, output.config
La acción queda ilustrada en la siguiente figura en donde los archivos son colocados a manera de ejemplo en una carpeta llamada WSDL en la unidad E:
El output.config debe ser usado para crear el web.config del proyecto y del archivo MonederoBancario.cs debe ser usada la interfaz IMonederoBancario como contrato para implementar el proyecto.
