Documentación técnica - Banco Central de Chile
Contents
1. IPCCB IND Z 2806812 C M IPC Combustibles ndice diciembre 2008 10 gt IPCFU IND Z 200812 C M IPC Frutas y verduras ndice diciembre 2008 100 gt IPCN IND Z 266812 C M IPCN No transables C ndice diciembre 2008 100 gt IPCT IND Z 266812 C M IPCT Transables indice diciembre 2608 10 gt IPCRK IND Z 266812 C M IPCK indice diciembre 2008 100 gt 1PCX1 IND Z 200812 IPCX1 indice diciembre 2008 10 gt ICF 2663 z Imacec a costo de factores ndice 2003 100 gt IMC Z 1986 Imacec ndice 1986 10 gt IMC 2 1986 IMC 2663 IMC 2003 IMC 2663 z Imacec desestacionalizado ndice 1986 108 gt Imacec serie original Cindice 2003 100 gt Imacec desestacionalizado ndice 2003 100 gt Imacec tendencia ciclo ndice 2003 100 gt So S NNNNNNO pr ox de Sx Sx de HL 2 4 Obtener las observaciones para una serie Para obtener las observaciones para una serie se dispone de un m todo llamado GetSeries el cual recibe cinco par metros Estos par metros son e user nombre de usuario entregado por el banco para acceder al sistema e password contrase a del usuario e firsiDate filtro para acotar las observaciones a partir de una fecha de inicio El par metro es opcional El formato debe ser YYYY MM DD e lastDate filtro para acotar las observaciones hasta una fecha de t rmino El par metro es opcional El formato debe ser YYYY MM DD e serieslds filtro para indicar la serie2. serieFame gt seriesKey gt seriesid serieFame gt precision lt br gt foreach serieFame gt obs as obs echo obs gt indexDateString obs gt value lt br gt 2 gt
3. WEB SERVICES Manual t cnico para desarrollador y Q x ee Intemet Client Web Service 1 Introduccion Este Manual considera servir de guia para un desarrollo que deba integrarse con el Web Service que el Banco Central de Chile provee para obtener los datos observaciones de las series de frecuencia diaria mensual trimestral y anual que se dejan disponibles a trav s de esta tecnologia Se debe considerar que estos ejemplos de c digos fuente estan escritos para c digo c y php sin embargo llevar estos ejemplos a java u otros lenguajes no deber a ser problema para el desarrollador Para poder comenzar a usar este Web Service la empresa deber previamente solicitar una cuenta de acceso a trav s del formulario que se encuentra en http si3 bcentral cl estadisticas web_services Webservices registro pdf La url donde se encuentran el WSDL Web Service Description Language de los Web Services que el BCCh disponibiliza est en https si3 bcentral cl SieteWS sietews asmx wsdl Se recomienda revisar la siguiente p gina web http si3 bcentral cl estadisticas web_services index htm 2 Referencia de servicio web y obtenci n de datos El c digo y la aplicaci n de muestra a continuaci n est construida utilizando visual studio 2008 y c como lenguaje En el siguiente cap tulo se desplegar el c digo tanto para c como para php Ambos realizan las mismas operaciones salvo que el primero se ejecuta
4. de la que se quieren obtener las observaciones El par metro es obligatorio Por ejemplo si se desean obtener las observaciones para la primera serie del listado de m s arriba se debe utilizar el ID de sta el cual corresponde a F073 IE5 IND 198601 M Si se quieren obtener todas las del a o 2007 se deber llamar el servicio web como se muestra en el c digo de m s abajo 6 ConsolaDemo Microsoft Yisual Studio Bile ES File Edit View Project Build Debug Data Tools Test ReSharper Window Help H u GW anl F B D Debug Any CPU Wi TR nalarga esa Sela UE Start Page Program cs zx lig wo D 2 Ez consolaDemo Program x a9 mainstring args B y 3 z 815 E string seriesIds new FO 73 IES IND 198601 M g string firstDate 2007 01 01 string lastDate 2007 12 31 using Sietel3 SieteUS new SietelWS Respuesta respuesta SieteWS GetSeries user pass firstDate lastDate serieslds foreach fameSeries serie in respuesta Series foreach obs observacion in serie obs Console WriteLine observacion indexDateString observacion value man sse z 18J0 dx 3 uonnjos ko xogqjoo 1 l Console ReadKey F Error List E Output Test Results Item s Saved Ln 32 Col 13 chi3 Cry En el c digo se observa que es necesario hacer un ciclo foreach dentro de otro ciclo foreach El primer ciclo recorre selecci
5. e WS The following operations are supported For a formal definition please review the Service Description e GetSeries e SearchSeries zi Web reference name BancoCentral Add Reference Una vez que visual studio haya terminado de agregar la referencia y creado las clases necesarias estas podr n ser utilizadas desde la aplicaci n de consola Se debe considerar para efectos de este ejemplo que la referencia se cre con el nombre de BancoCentral 2 3 Obtener las series disponibles Para obtener las series disponibles se dispone de un m todo SearchSeries el cual recibe tres par metros Estos par metros son e user nombre de usuario entregado por el banco para acceder al sistema e password contrase a del usuario e frequencyCode filtro para acotar a el resultado s lo a las series que tienen esa frecuencia Las opciones v lidas de frecuencyCode se listan a continuaci n e DAILY e MONTHLY e QUARTERLY e ANNUAL La siguiente imagen muestra el bloque de c digo necesario para obtener las series que tienen datos con la frecuencia seleccionada MONTHLY para el ejemplo 6 ConsolaDemo Microsoft isual Studio OF xi File Edit View Project Build Debug Data Tools Test ReSharper Window Help a i ggal aal r gt Debug y Any CPU mi BR S 2 0 aS Q Blg Program cs Start Page Ss _ YX li 3 consolaDemo Program 3 using System j using ConsolaDemo BancoCentral namespace Con
6. en una aplicaci n de consola y el segundo en una p gina web Para los desarrollos en PHP los puntos 3 1 y 3 2 pueden ser omitidos 2 1 Creaci n de aplicaci n Para llevar a cabo este paso a paso se debe contar con un proyecto net ya creado en una soluci n En este caso se utilizar una aplicaci n de consola g ConsolaDemo Microsoft isual Studio Ot x File Edit View Project Build Debug Data Tools Test ReSharper Window Help d 32 GA4 482 48 9 4 B Debug gt Any CPU a 5 Sh ESEMETE EENT A a Program cs Start Page Xx PAEA ConsolaDemo Program EN Main string args oq Solution ConsolaDemo 1 project 5 E ConsolaDemo a Properties 3 References Program cs usir 3 us g J ising System j J namespace ConsolaDemo sl class Program 5 static void Main string args t 4 Error List Output Test Results Ready 2 2 Agregar referencia al servicio web Con la aplicaci n creada se deber agregar una referencia el servicio web disponible en la ruta lt RUTA gt Add Web Reference 121 xi Navigate to a web service URL and click Add Reference to add all the available services O back dad URL http flocalhost SieteW s Siete WS asmx y g Go Web services Found at this URL 1 Service Found i NS Siet
7. eteWS GetSeries user pass firstDate lastDate serieslds foreach fameSeries serie in respuesta Series foreach obs observacion in serie obs Console WriteLine observacion indexDateString Console ReadKey observacion value 3 2 Codigo de pagina web en php lt user lt INGRESE_USUARIO gt password lt INGRESE_CLAVE gt frequencyCode MONTHLY wsdl lt DIRECCION_SITIO_WEB gt WSDL client new soapclient wsdl params new stdClass params gt user user params gt password password params gt frequencyCode frequencyCode result client gt SearchSeries params gt SearchSeriesResult foreach result gt SeriesInfos gt internetSeriesInfo as serie echo serie gt seriesld serie gt spanishTitle lt br gt seriesids array FO73 IE5 IND 198601 M firstDate 2007 01 01 lastDate 2007 12 31 client new soapclient wsdl params new stdClass params gt user user params gt password password params gt firstDate firstDate params gt lastDate lastDate params gt serieslds serieslds result client gt GetSeries params gt GetSeriesResult fameSeries result gt Series gt fameSeries Cuando se solicita una sola serie la respuesta no es interpretada como un arreglo if is_array fameSeries 1 fameSeries array fameSeries foreach fameSeries as serieFame echo
8. ona la serie solicitada y el segundo ciclo recorre las observaciones de esta serie Existe un maximo de 1 serie permitido para el cual se pueden obtener las mediciones Un mensaje ser retornado en la respuesta indicando que se solicit mas de una serie QuickWatch oix Add Watch Value 5 respuesta 2 Codigo 9 codigoField A Descripcion The number of series exceed maximum available 4 string yy descripcionField The number of series exceed maximum available string SF Series ConsolaDemo BancoCentral fameSeries 0 ConsolaD Y seriesField ConsolaDemo BancoCentral fameSeries 0 ConsolaD A SeriesInfos ConsolaDemo BancoCentral internetSeriesInfo 0 ConsolaD y seriesInfosField ConsolaDemo BancoCentral internetSeriesInfo 0 ConsolaD La ejecuci n de este c digo da el resultado desplegado a continuaci n en donde destaca la fecha de la observacion una por mes dado que es mensual MONTHLY y el valor de la observacion cx file C Bcentral Codigo ConsolaDemo bin Debug ConsolaDemo EXE 41 61 2007 2 5 Control de errores Como se vio en el ejemplo anterior en caso de solicitar mas series de las permitidas se devolvera una respuesta indicandolo En la respuesta recibida contiene dos propiedades que indicar n el xito o fracaso de la ejecuci n Estas propiedades son Codigo y Descripcion En caso de una ejecuci n sin problemas los valores que retornar n ser n cero y una cadena vac a respectivamente Es
9. solaDemo 4 class Program static void Main string J string user lt INGRESE_USUARIO gt string pass lt INGRESE CLAVE gt string frecuencyCode MONTHLY using SieteWS SieteWS new SietelS Respuesta respuesta SieteUS SearchSeries user pass frecuencyCode foreach internetSeriesInfo seriesInfo in respuesta SeriesInfos man sse D ta 1aJo dx3 YORNIOS o xoqjoo E JaJ0 dx3 194195 E Console WVriteLine seriesInfo seriesld seriesInfo spanishTitle Console ReadKey i E 4 gt Fi Error List Output 2 Test Results Item s Saved La ejecuci n de este c digo despliega el siguiente listado de series Adem s del id de la serie y el nombre en espa ol que son desplegados tambi n se obtiene informaci n de las fechas que tienen observaciones para cada serie Debug ConsolaDemo EXE F673 1E5 IND 198601 M Indice de precios externos para las monedas de Estados La Unidos Jap n Reino Unido Canad y Zona Euro IPE 5 promedio 1986 108 gt FO73 IPE IND 198601 M ndice de precios externos IPE lt promedio 1986 100 gt E FO73 TCR IND 199101 M ndice de tipo de cambio real TCR lt promedio 1986 100 gt FO073 TR5 IND 198601 M ndice de tipo de cambio real para las monedas de Estad os Unidos Jap n Reino Unido Canad y Zona Euro TCR 5 Cpromedio 1986 10 gt IPC IND Z 200812 C M IPC General C ndice diciembre 2008 100 gt
10. to se puede ver en la siguiente imagen QuickWatch ojx Expression Reevaluate respuesta y Add Watch m e Codigo E codigoField 2 Descripcion 9 descripcionField F i Series ConsolaDemo BancoCentral fameSeries 1 ConsolaD y seriesField ConsolaDemo BancoCentral fameSeries 1 ConsolaD 27 SeriesInfos ConsolaDemo BancoCentral internetSeriesInfo 0 ConsolaD E seriesInfosField 4ConsolaDemo BancoCentral internetSeriesInfo 0 ConsolaD 3 Codigo de las aplicaciones Como se mencion en el cap tulo anterior los siguientes bloques de c digo cumplen funcionalidad similar aunque los ambientes de ejecuci n son diferentes 3 1 C digo de aplicaci n de consola en c using System using ConsolaDemo BancoCentral namespace ConsolaDemo class Program static void Main string args string user lt INGRESE_USUARIO gt string pass lt INGRESE_CLAVE gt string frecuencyCode MONTHLY using SieteWS SieteWS new SieteWS Respuesta respuesta SieteWS SearchSeries user pass frecuencyCode foreach internetSeriesInfo seriesInfo in respuesta SeriesInfos Console WriteLine seriesInfo seriesId seriesInfo spanishTitle Console ReadKey string seriesIds new string FO73 IE5 IND 198601 M string firstDate 2007 01 01 string lastDate 2007 12 31 using SieteWS SieteWS new SieteWS Respuesta respuesta Si
Download Pdf Manuals
Related Search