Web Services Data Sources
Web Services Data Sources
Este tutorial explica mediante un ejemplo cómo utilizar web services (WS) como fuente de datos de un modelo.
- Ir a Fuentes de datos, Web Services Data Source, Agregar WebService.
- En la solapa Descripción indicar nombre y descripción del WS.
- En la solapa General:
- Indicar si se utilizará para construir dimensión y si se debe verificar la fuente antes de construir.
- Indicar la ruta completa del archivo XML que el WS devuelve como respuesta (XML request).
- Dependiendo de la estructura del archivo XML puede que se requiera leer mas de una tupla por registro, en este caso indicar el número de tuplas por registro.
- En XPath Principal se muestra la estructura del archivo XML en forma de árbol. Seleccionar el elemento (correspondiente al tag) que se tomará como referencia para direccionar los campos. Esta será la expresión XPath que se visualiza con formato /ItemSearchResponse/Items/Item, por ejemplo, donde ItemSearchResponse es el tag inicial del archivo XML, le siguen a continuación el o los tags hijos.
- En la solapa SOAP:
- Wsdl: ingresar la url del wsdl.
- Service: en este combo editable se debe ingresar o seleccionar el nombre del servicio.
- Service Port: en este combo editable se debe ingresar o seleccionar el puerto del servicio.
- Namespace: ingresar el namespace del WS.
- Iterativo: seleccionar en caso de que se quiera invocar iterativamente al WS, es decir llamar varias veces al WS hasta que no devuelva nada.
- Ingresar el XML Request.
Si se desconocen el service, service port y namespace, se puede presionar el botón a la derecha de wsdl, que completará estos campos de acuerdo al wsdl ingresado.
Existen dos variables que se pueden utilizar opcionalmente en el cuerpo del xml: para distinguir una llamada de la otra (cuando en se selecciona el check iterativo) se pueden utilizar unas expresiones en el XML del request, lo que se puede usar es:${page} o ${page_index}, ${page}comienza en 1, ${page_index}en 0.
- En la solapa Campos se tiene nuevamente el arbol de tags del archivo, donde se deben seleccionar los campos a utilizar. En la lista se tendrá:
- Los atributos del tag, que son los que tienen @ como prefijo.
- Los tags hijos, sin prefijos.
- El tipo de dato asignado inicialmente para todos los campos es String (al igual que cuando se utilizan archivos de texto como fuentes de datos, el usuario debe cambiar al tipo de dato correcto para cada campo). Se puede clickear Vista previa para visualizar los primeros datos.