Xi31 sp3 Qaaws Es

Query as a Web Service
SAP BusinessObjects XI3.1 Service Pack 3 windows
Copyright
2010 SAP AG.Reservados todos los derechos. SAP, R/3, SAP NetWeaver, Duet, PartnerEdge, ByDesign, SAP Business ByDesign y otros productos y servicios de SAP mencionados, as como sus logotipos respectivos, son marcas comerciales o marcas registradas de SAP AG en Alemania y en otros pases. Business Objects y el logotipo de Business Objects, BusinessObjects, Crystal Reports, Crystal Decisions, Web Intelligence, Xcelsius y otros productos y servicios de Business Objects mencionados, as como sus logotipos respectivos, son marcas comerciales o marcas registradas de Business Objects S.A. en los Estados Unidos y en otros pases. Business Objects es una empresa de SAP. Todos los dems nombres de productos y servicios mencionados son marcas comerciales de sus respectivas empresas. Los datos de este documento slo tienen carcter informativo. Las especificaciones de productos en cada pas pueden ser diferentes. Estos materiales pueden modificarse sin previo aviso. Estos materiales los proporciona SAP AG y sus empresas afiliadas ("SAP Group") con carcter informativo, sin representacin ni garanta de ningn tipo y SAP Group no se hace responsable de los errores u omisiones en dichos materiales. Las nicas garantas para los productos y servicios de SAP Group son aquellas especificadas en los productos y servicios, si las hubiera. Nada de lo que aparezca en este documento debe interpretarse como garanta adicional. 2010-05-25
Contenido
Captulo 1 Introduccin a Query as a Web Service 7 Qu es Query as a Web Service?.............................................................8 Cmo se utiliza Query as a Web Service como solucin empresarial?......8 Arquitectura de componentes de cliente y servidor de Query as a Web Service.........................................................................................................9 Captulo 2 Instalar Query as a Web Service 11
Requisitos para instalar Query as a Web Service.....................................12 Para instalar Query as a Web Service.......................................................12 Solucin de problemas de instalacin de Query as a Web Service..........13 Asegrese de que CMS se inicie antes que Tomcat............................14 Cambio del CMS predeterminado........................................................14 Activar seguimientos de servicios Web................................................15 Optimizar la disponibilidad de CMS.....................................................16 Optimizacin de consultas en orgenes de datos relacionales para Xcelsius.....................................................................................................17 Activar Xcelsius QaaWS Endpoint.......................................................17 Captulo 3 Iniciar Query as a Web Service 19
Requisitos para iniciar Query as a Web Server.........................................20 Iniciar Query as a Web Service.................................................................20 Iniciar Query as a Web Service por primera vez..................................20 Iniciar Query as a Web Service............................................................21 Iniciar sesin con distintas credenciales de registro............................23 Administrar hosts.......................................................................................23 Para agregar un nuevo host.................................................................24
Contenido
Para editar un host...............................................................................24 Pgina de catlogo de consultas...............................................................26 Captulo 4 Crear una consulta nueva para publicarla como servicio Web 27
Crear y publicar una consulta nueva como servicio Web..........................28 Cmo crear una consulta nueva utilizando el Asistente de publicacin de Query as a Web Service............................................................................28 Para iniciar el Asistente de publicacin de Query as a Web Service....29 Definir las propiedades de descripcin y nombre de consulta.............30 Seleccionar un universo para una consulta.........................................32 Definir una consulta..............................................................................32 Obtener una vista preliminar y publicar una consulta..........................36 Cmo crear una nueva consulta duplicando una ya publicada.................36 Para duplicar una consulta publicada..................................................37 Captulo 5 Administrar consultas como servicios Web 39
Crear carpetas en el catlogo de consultas..............................................40 Editar una consulta como servicio Web.....................................................40 Para cambiar el nombre a una consulta....................................................40 Eliminar una consulta como servicio Web.................................................41 Copiar y pegar una consulta como servicio Web......................................41 Ver las propiedades de la consulta............................................................42 Ver las instancias de servicios Web de consultas disponibles .................42 Cmo implementar consultas en otro servidor Web..................................43 La actualizacin del archivo WSDL cambia en el despliegue de consultas..............................................................................................44 Implementar en otro servidor utilizando la herramienta cliente Query as a Web Service......................................................................................45 Implementar Query as a Web Service desde el Asistente de importacin .............................................................................................................4 6 Implementar Query as a Web Service desde un archivo BIAR...........47
Contenido
Actualizacin de la cach WSDL al desplegar consultas en otro servidor.................................................................................................47 Implementar en otro servidor utilizando la herramienta cliente Query as a Web Service..............................................................................................48 La actualizacin del archivo WSDL cambia en el despliegue de consultas..............................................................................................49 Implementar en otro servidor utilizando la herramienta cliente Query as a Web Service......................................................................................50 Implementar Query as a Web Service desde el Asistente de importacin .............................................................................................................5 1 Implementar Query as a Web Service desde un archivo BIAR...........52 Actualizacin de la cach WSDL al desplegar consultas en otro servidor.................................................................................................52 Implementar Query as a Web Service desde el Asistente de importacin ...................................................................................................................53 La actualizacin del archivo WSDL cambia en el despliegue de consultas..............................................................................................54 Implementar en otro servidor utilizando la herramienta cliente Query as a Web Service......................................................................................54 Implementar Query as a Web Service desde el Asistente de importacin .............................................................................................................5 5 Implementar Query as a Web Service desde un archivo BIAR...........56 Actualizacin de la cach WSDL al desplegar consultas en otro servidor.................................................................................................57 Implementar Query as a Web Service desde un archivo BIAR.................57 La actualizacin del archivo WSDL cambia en el despliegue de consultas..............................................................................................58 Implementar en otro servidor utilizando la herramienta cliente Query as a Web Service......................................................................................59 Implementar Query as a Web Service desde el Asistente de importacin .............................................................................................................6 0 Implementar Query as a Web Service desde un archivo BIAR...........61 Actualizacin de la cach WSDL al desplegar consultas en otro servidor.................................................................................................61
Contenido
Implementar Query as a Web Service en varios servidores Web.............62 Configurar el cliente Query as a Web Service para que se conecte a un servidor Web de proxy inverso.............................................................62 Captulo 6 Consumir consultas como servicios Web con distintas aplicaciones
65
Consumir Query as a Web Service mediante WSDL................................66 Consumir Query as a Web Service en Crystal Xcelsius............................66 Problema por cruce de dominios.........................................................67 Seleccionar el servicio Web.................................................................68 Mensajes de entrada............................................................................69 Mensajes de salida...............................................................................69 Autenticacin en Xcelsius....................................................................69 Consumir Query as a Web Service en Crystal Reports............................70 Consumir Query as a Web Service en Microsoft Office InfoPath..............71 Captulo 7 Descripcin API de llamada del servicio Web 73
Captulo 8
Procedimientos recomendados y limitaciones de Query as a Web Service 77 Procedimientos recomendados al usar Query as a Web Service.............78 Limitaciones en el uso de Query as a Web Service..................................78
Apndice A
Ms informacin
79
ndice
83
Introduccin a Query as a Web Service
Introduccin a Query as a Web Service Qu es Query as a Web Service?
Qu es Query as a Web Service?

Query as a Web Service es una aplicacin de Business Objects que permite a los usuarios de empresas crear y publicar consultas rpidamente como servicios Web. Una consulta como servicio Web es una instruccin SQL que se ha creado en un universo de BusinessObjects y publicado como servicio Web en un servidor host que aloja servicios Web. La consulta como servicio Web est disponible en cualquier aplicacin que utilice servicios Web, y permite a los usuarios acceder a los datos que devuelva la consulta desde la aplicacin. Permite ofrecer informacin de Business Intelligence (BI) de forma segura en cualquier aplicacin que utilice servicios Web. Query as a Web Service tiene un componente de cliente que permite crear consultas a partir de universos, y un servicio Web de servidor que permite a los desarrolladores crear servicios Web a partir de consultas especficas de Business Objects.
Cmo se utiliza Query as a Web Service como solucin empresarial?

Query as a Web Service permite entregar contenido de BI a cualquier interfaz de usuario que pueda procesar servicios Web. Gracias a Query as a Web Service, los usuarios de la empresa definen sus propias consultas a partir de un universo concreto para, acto seguido, publicarlas como servicios Web independientes. Query as a Web Service se puede utilizar para proporcionar nuevas soluciones de cliente para una empresa. Por ejemplo, Crystal Xcelsius utiliza Query as a Web Service para agregar varios orgenes de datos distintos en una vista de BI de confianza. Query as a Web Service tambin habilita varias soluciones de cliente en herramientas como Microsoft Office, Excel e InfoPath. SAP NetWeaver
Introduccin a Query as a Web Service Arquitectura de componentes de cliente y servidor de Query as a Web Service
OpenOffice Aplicaciones de administracin de procesos y reglas de gestin Plataformas Enterprise Service Bus
Nota:
Business Objects presta un amplio abanico de servicios Web para desarrolladores. Los desarrolladores usan estos servicios Web en entornos IDE con lenguajes como C# y Java. Para obtener ms informacin, visite esta pgina: http://diamond.businessobjects.com
Arquitectura de componentes de cliente y servidor de Query as a Web Service

Query as a Web Service cuenta con un diseo perfecto para trabajar con cualquier aplicacin para Windows del mismo modo que otros servicios Web. Query as a Web Service se basa en las especificaciones SOAP, WSDL y XML de W3C para servicios Web. Consta de dos componentes principales: Componente de servidor El componente de servidor (incluido en BusinessObjects XI R3) almacena el catlogo de Query as a Web Service y aloja los servicios Web publicados. Herramienta cliente Se trata de la herramienta en la que los usuarios de la empresa crean y publican consultas como servicios Web. La herramienta cliente se puede instalar en varios equipos que dispongan de acceso al mismo catlogo de Query as a Web Service almacenado en el servidor y capacidad para compartirlo.
Nota:
En esta gua, se utiliza el nombre Query as a Web Service para hacer referencia al cliente. Cuando se aporta informacin que hace referencia al componente de servidor, se denomina componente de servidor de Query as a Web Service.
Introduccin a Query as a Web Service Arquitectura de componentes de cliente y servidor de Query as a Web Service
El cliente se comunica con los componentes de servidor por medio de servicios Web.
10
Instalar Query as a Web Service
Instalar Query as a Web Service Requisitos para instalar Query as a Web Service
Requisitos para instalar Query as a Web Service

Antes de instalar Query as a Web Service, lea el contrato de condiciones de uso y asegrese de cumplir los siguientes requisitos: En el servidor debe tener instalado lo siguiente: BusinessObjects XI Release 3 Enterprise Edition Servicios Web Tomcat u otra aplicacin Web compatible y JDK Para obtener una lista actualizada de aplicaciones Web y versiones compatibles, visite esta direccin: http://support.businessobjects.com/supported_platforms/ En el cliente debe tener instalado lo siguiente antes de instalar Query as a Web Service: .NET Framework 2.0. Se necesita para el cliente Query as a Web Service que se utiliza para crear y publicar consultas. Aqu puede descargar .NET Framework 2.0: http://www.microsoft.com/downloads/details.aspx?Famil yID=0856eacb-4362-4b0d-8edd-aab15c5e04f5&Display Lang=en&displaylang=es La plataforma del cliente debe ser compatible con BusinessObjects XI Release 3. Para obtener una lista actualizada de versiones compatibles, visite esta direccin: http://support.businessobjects.com/supported_platforms/
Para instalar Query as a Web Service

El componente de servidor de Consulta como servicio web se instala de manera automtica como parte de BusinessObjects Enterprise XI 3.1 con Web Intelligence.
12
Instalar Query as a Web Service Solucin de problemas de instalacin de Query as a Web Service
A continuacin, debe instalar la herramienta cliente Query as a Web Service en todos los equipos que vayan a acceder al servidor por medio de los servicios Web. Una vez finalizada la instalacin de Consulta como servicio web, podr definir un sistema host en su primer inicio de sesin. Esto se describe en el apartado de temas relacionados.
Nota:
Los usuarios tienen que formar parte de los administradores o de grupos de diseadores de QaaWS para poder iniciar el cliente Consulta como servicio web y para usarlo con el objetivo de disear consultas. 1. Vaya a la carpeta Add-Ons\Query as a Web Service en el CD de colaterales de BusinessObjects Enterprise o busque el archivo setup.exe de Query as a Web Service en la red. 2. Haga doble clic en setup.exe para iniciar el Asistente de Query as a Web Service. 3. Siga las instrucciones que aparecen en la pantalla del Asistente de instalacin de Query as a Web Service para completar el procedimiento de instalacin.
Temas relacionados
Iniciar Query as a Web Service Administrar hosts
Solucin de problemas de instalacin de Query as a Web Service

Esta seccin contiene informacin que le ayudar a resolver los posibles problemas con la instalacin. Consulte los temas vinculados al final de la seccin para obtener informacin referente a cada uno de los siguientes aspectos: Asegrese de que CMS se inicie antes que Tomcat. Cambie el CMS predeterminado. Active el seguimiento de servicios Web. Optimice la disponibilidad del CMS.
13
Asegrese de que CMS se inicie antes que Tomcat

Es importante iniciar CMS antes que Tomcat. Durante el inicio de Tomcat, en la inicializacin de Servlet, la cach de QaaWS lee la definicin de QaaWS en el repositorio para crear su cach, de modo que debe asegurarse de que CMS se inicie antes que Tomcat. Si CMS se inicia automticamente mediante NT Services, no es preciso realizar la operacin manualmente.
Cambio del CMS predeterminado

De forma predeterminada, Servicios Web se conecta al CMS con el nombre del ordenador local. Si desea utilizar otro CMS, debe cambiar la propiedad de dominio en el archivo dsws.properties. Si utiliza un nmero de puerto de CMS distinto del predeterminado (6400) y no cambia la propiedad de dominio en el archivo dsws.properties, recibir un mensaje de error "Server not found or server may be down (FWM01003) (No se ha encontrado el servidor o servidor inactivo". La solucin consiste en especificar el puerto nuevo en el archivo dsws.properties (ubicado en <RUTA DE INSTALACIN>\warfiles\WebApps\dswsbobje\WEB-NF\classes\) con valor de atributo de dominio (dominio=CMSserverName:port). Esta informacin complementa la disponible en la documentacin de Central Management System.
Definir un nuevo CMS predeterminado para Query as a Web Service

1. Detenga Tomcat. 2. Abra la carpeta de la ruta de instalacin de BusinessObjects Enterprise XI Release 3: [RutaInstalacin]\warfiles\webapps\dswsbob je\WEB-INF\classes 3. Abra el archivo dsws.properties y localice: domain=
14
4. Indique el nombre de su CMS. 5. Guarde y cierre el archivo dsws.properties. 6. Inicie Tomcat.
Activar seguimientos de servicios Web

De haber algn problema de configuracin, puede que el administrador de Business Objects tenga que definir opciones de seguimiento para facilitar las tareas de solucin de problemas. Business Objects recomienda encarecidamente el uso de seguimiento nica y exclusivamente con fines de solucin de problemas en entornos de prueba.
Activar seguimientos de servicios Web

1. En el Administrador de configuracin central (CCM), detenga el servicio "Apache Tomcat 5.5.20". 2. Cambiar el nivel de seguimiento. De modo predeterminado, Query as a Web Service slo realiza el seguimiento de errores. Puede que tenga que suministrar seguimientos adicionales para satisfacer los requisitos del cliente. 3. Edite log4j.properties ubicado en [rutainstalacin]\dsws bobje\WEB-INF\classes\ 4. Escriba lo siguiente en el archivo de propiedades:log4j.log ger.com.businessobjects=DEBUG, BO1 5. Cambie la ubicacin de seguimiento. De modo predeterminado, el seguimiento se realiza en la salida de consola de salida. Si desea realizar el seguimiento de un archivo, aada una marca de comentario a ConsoleAppender y quite dicha marca de RollingFileAppender. Si Tomcat se ha definido como servicio, el seguimiento se registrar en dswsbobje.log, en la ruta C:\WIN DOWS\system32.: # console appender # log4j.appen der.BO1=org.apache.log4j.ConsoleAppender # log4j.appen der.AXIS1=org.apache.log4j.ConsoleAppender #rolling file appender log4j.appender.BO1=org.apache.log4j.Ro llingFileAppender log4j.appender.BO1.File=dswsbobje.log
15
log4j.appender.BO1.Append=false log4j.appender.BO1.Max BackupIndex=5 log4j.appender.BO1.Max FileSize=10 6. En CCM, inicie el servicio "Apache Tomcat 5.5.20".
Optimizar la disponibilidad de CMS

El sistema CMS slo puede tener una base de datos de sistema CMS. La conexin con la base de datos de sistema CMS podra perderse por una de estas razones: La base de datos est inactiva. Se ha producido en corte en la red entre CMS y la base de datos de sistema CMS. Se ha producido un error de software o hardware en la aplicacin o el equipo CMS. En cualquiera de estos casos, la implementacin de dos CMS reduce el riesgo de que ambos CMS pierdan la conexin con la base de datos de sistema CMS ubicada en el equipo CMS. Sin embargo, si la base de datos de sistema CMS est fuera de servicio, ningn sistema CMS podr procesar sin errores las solicitudes entrantes, tanto con un solo CMS como con varios en el clster. Puede limitar riesgos utilizando las soluciones de tolerancia a errores suministradas por el proveedor de la base de datos. Todos los proveedores de bases de datos proporcionan soluciones de tolerancia a errores a fin de minimizar la falta de disponibilidad de una base de datos. Una solucin de tolerancia a errores puede ser la creacin de una base de datos reflejada secundaria que se ejecute en un servidor secundario. Por ejemplo, si la primera base de datos est fuera de servicio, el archivo tns.ora se actualiza automticamente para sealar hacia el servidor de base de datos secundario. Puesto que las medidas de tolerancia a errores son especficas de cada base de datos, en caso de necesitar ms informacin tendr que consultar la documentacin relativa a la que utiliza usted.
Nota:
Si la funcin est disponible y activada, aunque se pierda la conexin de base de datos del sistema, el CMS la restablecer automticamente sin que tenga que intervenir el administrador.
16
Instalar Query as a Web Service Optimizacin de consultas en orgenes de datos relacionales para Xcelsius
Optimizacin de consultas en orgenes de datos relacionales para Xcelsius

Puede beneficiarse de dos nuevos servidores de Xcelsius QaaWS disponibles en este Service Pack para optimizar solicitudes de Consulta como servicio Web en orgenes de datos relacionales desde Xcelsius. Los servidores son los siguientes: Servidor de cach de Xcelsius Servidor de procesamiento de Xcelsius
Nota:
Si no est experimentando problemas de escalabilidad de QaaWS, no tiene que activar los servidores de Endpoint y Xcelsius. Los dos servidores se instalan tanto con el Service Pack completo como con la instalacin de la revisin. Debe activar manualmente los servidores y Xcelsius QaaWS Endpoint en el servidor de aplicaciones web para implementar la optimizacin de consultas. En esta seccin se describe cmo activar Xcelsius QaaWS Endpoint despus de la instalacin, y cmo activar los servidores. Xcelsius QaaWS Endpoint redirecciona las solicitudes relacionales de Xcelsius QaaWS a los nuevos servidores de Xcelsius QaaWS. La instalacin y configuracin de los nuevos servidores se describe en la documentacin de instalacin del Service Pack. Consulte la documentacin Novedades de este Service Pack para obtener una descripcin completa de los nuevos servidores y las ventajas disponibles para los usuarios de Xcelsius que usan solicitudes de Consulta como servicio web en orgenes de datos relacionales.
Activar Xcelsius QaaWS Endpoint

Antes de activar Xcelsius QaaWS Endpoint para optimizar las solicitudes de Consulta como servicio web desde Xcelsius, debe completar los siguientes pasos: Instale el Service Pack 3 de SAP BusinessObjects Enterprise (XI 3.1 SP3). Si solamente desea instalar la revisin, deber registrar los nuevos
17
Instalar Query as a Web Service Optimizacin de consultas en orgenes de datos relacionales para Xcelsius
servidores de Xcelsius. Esta informacin se encuentra en la documentacin de instalacin. Cree los nuevos servidores en la Consola de administracin central (CMC). Consulte la documentacin de la Consola de administracin central para obtener informacin sobre esta tarea y la siguiente. Habilite e inicie los nuevos servidores de Xcelsius.
Debe activar Xcelsius QaaWS Endpoint para permitir el filtrado de datos en los nuevos servidores. As se optimiza el nmero de consultas que puede administrar la Consulta como servicio Web para usuarios de Xcelsius. 1. Detenga el servidor de aplicaciones. 2. Busque y abra el archivo /DSWSBOBJE_INSTALLDIR/WEBINF/web.xml. 3. Agregue la siguiente informacin: <filter> <filter-name> XcelsiusQaawsAccelerator </filter-name> <description> Qaaws Runtime Query Accelerator </description> <filter-class> com.sap.xcelsius.server.QaawsRuntimeRequestFilter </filter-class> </filter> <filter-mapping> <filter-name> XcelsiusQaawsAccelerator </filter-name> <url-pattern>/qaawsservices/*</url-pattern> </filter-mapping> 4. Reinicie el servidor de aplicaciones. Los dos nuevos servidores de Xcelsius estn preparados para procesar cualquier solicitud de Consulta como servicio Web.
18
Iniciar Query as a Web Service
Iniciar Query as a Web Service Requisitos para iniciar Query as a Web Server
Requisitos para iniciar Query as a Web Server

Asegrese de cumplir los siguientes requisitos antes de iniciar Query as a Web Service:
Requisitos para el inicio Descripcin
La pertenencia a un grupo de usuario Usuario registrado como administrador se define en Central Management o definido en el Diseador de grupo de Console. Si necesita que se le incluya QaaWS. en este grupo de usuarios, consulte a su administrador.

Query as a Web Service se utiliza con Central Management System (CMS). CMS contiene el componente de servidor que almacena el catlogo de Query as a Web Service y aloja los servicios Web publicados. Cuando inicia Query as a Web Service por primera vez, debe definir el servidor de host antes de empezar. Cuando inicie Query as a Web Service posteriormente, seleccionar un servidor de host disponible y luego iniciar sesin en CMS. Despus de haber iniciado sesin, se abrir la pgina del catlogo de consultas de Query as a Web Service. En esta pgina, puede iniciar el asistente para la creacin y publicacin de consultas con el fin de publicar una nueva consulta y editar las consultas publicadas existentes.
Iniciar Query as a Web Service por primera vez

Cuando inicia Query as a Web Service por primera vez, debe definir un servidor host en CMS en el que estn instalados los servicios Web. Una vez definido un servidor host, estar disponible automticamente la prxima vez
20
Iniciar Query as a Web Service Iniciar Query as a Web Service
que inicie Query as a Web Service. Puede definir varios servidores host, pero no se pueden conectar ms de uno a la vez. 1. Inicie Query as a Web Service. Se abrir el cuadro de dilogo "Administrar hosts". Este cuadro de dilogo enumera los servidores host disponibles y permite agregar nuevos servidores y editar los que ya existen. La primera vez que se inicia Query as a Web Service la lista est vaca. En primer lugar, debe definir un servidor host. 2. Haga clic en Agregar. Aparece el cuadro de dilogo "Editar un host". Este cuadro contiene los parmetros que se definen para crear un servidor host. Consulte el apartado de temas relacionados para obtener una descripcin de todos los parmetros. 3. Especifique la informacin necesaria en el cuadro de dilogo "Editar un host". 4. Haga clic en Aceptar. Se abrir el cuadro de dilogo "Administrar hosts". Se enumerar el nuevo host. 5. Seleccione el nuevo host y haga clic en Cerrar. Se abrir el cuadro de dilogo "Seleccione sus credenciales". Estar disponible la informacin siguiente del nuevo host. 6. Especifique su contrasea y haga clic en Aceptar. Se abrir la pgina de inicio de cliente Query as a Web Service.

Antes de iniciar Query as a Web Service, asegrese de cumplir los siguientes requisitos. Consulte los temas relacionados para obtener ms informacin. El nombre de usuario debe estar en el grupo de usuarios Diseador de grupo de QaaWS o debe haber iniciado sesin como administrador. Debe haber definido un host de servidor para almacenar el servicio Web de consultas. Debe hacerlo al iniciar por primera vez Query as a Web Service o en cualquier momento, agregando un host en el cuadro de dilogo "Editar un host".
21
Iniciar Query as a Web Service Iniciar Query as a Web Service
Inicie Query as a Web Service seleccionando un servidor host y especificando la informacin de registro en el cuadro de inicio de sesin. Tiene los siguientes campos de registro:
Informacin de inicio de sesin Descripcin Servidor de CMS que almacenan los servicios Web de consultas. Debe definir un servidor host para poder crear una consulta. Servidor Central Management Server (CMS) que aloja el servidor host. Nombre de usuario. Debe ser miembro del grupo de usuarios Diseador de grupo de QaaWS o un administrador. Contrasea de usuario. La asigna el administrador. Tipo de servicio de autenticacin necesario para acceder a CMS. Esta informacin la facilita el administrador. Estn disponibles los siguientes protocolos: Enterprise LDAP Windows AD
Host
Sistema
Usuario
Contrasea
Autenticacin
Seleccione esta opcin si el protocolo de autenticaHabilitar Inicio de sesin cin admite el inicio de sesin nico. Esta opcin nico del Directorio de slo est disponible para Active Directory de WinWindows Active dows. Idioma que se utiliza para la interfaz de usuario. Puede seleccionar un idioma en la lista desplegable. Esta lista contiene los idiomas instalados que admite Business Objects XI Enterprise Suite.
Configuracin regional de la interfaz
1. En el men Inicio de Windows, seleccione Programas > Business Objects XI Release 3 > BusinessObjects Enterprise > Query As A Web Service
22
Se abrir el cuadro de inicio de sesin. 2. Seleccione un nombre de servidor host en la lista desplegable de hosts. 3. Especifique la informacin de sistema, nombre de usuario y contrasea. 4. Haga clic en Opciones. El cuadro de inicio de sesin mostrar las opciones Autenticacin, Inicio de sesin nico y Configuracin regional de la interfaz. 5. Seleccione la informacin de inicio de sesin. 6. Haga clic en Aceptar. Se abrir el catlogo de consultas. En esta pgina puede crear, publicar y administrar consultas como servicios Web.
Iniciar sesin con distintas credenciales de registro

Puede iniciar sesin en Query as a Web Service como nuevo usuario sin salir de la aplicacin. Seleccione Herramientas > Conectar como Se abrir el cuadro de inicio de sesin. Introduzca la nueva informacin de usuario y haga clic en Aceptar.
Administrar hosts
Un host es un componente de servidor de CMS que almacena el catlogo de Query as a Web Service y aloja los servicios Web publicados. Se crea un host al iniciar Query as a Web Service por primera vez. Puede agregar un host a CMS y configurar los parmetros de conexin para los hosts existentes desde el cuadro de dilogo "Administrar hosts". Al cuadro de dilogo "Administrar hosts" se accede desde el men Herramientas o desde el cuadro de inicio de sesin al abrir Query as a Web Service. El cuadro de dilogo "Administrar hosts" enumera los servidores host. Tiene las siguientes opciones de administracin de host:
23
Opcin de administracin de host Agregar
Descripcin Haga clic para definir un nuevo host. Seleccione un nombre de host en la lista y haga clic para editar la definicin del host. Seleccione un nombre de host y haga clic para eliminarlo de la lista. Haga clic para eliminar todos los hosts de la lista.
Editar
Eliminar
Borrar
Para agregar un nuevo host

Puede agregar un nuevo host en el cuadro de dilogo "Administrar hosts". 1. Seleccione Herramientas > Administrar hosts. Se abrir el cuadro de dilogo "Administrar hosts".
Nota:
Tambin puede acceder al cuadro de dilogo "Administrar hosts" desde el cuadro de registro al iniciar sesin en Query as a Web Service. 2. Haga clic en el botn Aadir. Aparece el cuadro de dilogo "Editar un host". 3. Especifique informacin sobre los parmetros de host y haga clic en Aceptar. El host se aadir a la lista del cuadro de dilogo "Administrar hosts". 4. Haga clic en Cerrar.
Para editar un host

Edite una definicin de host en el cuadro de dilogo "Editar un host". Puede editar los siguientes parmetros de host:
24
Parmetros de edicin de host Descripcin Nombre del servidor host. Es el nombre que aparece en el campo Host del cuadro de inicio de sesin. La direccin URL del servidor host. Se especifica automticamente una direccin URL predeterminada para el host. Puede editar la direccin URL si es preciso. Debe comprobar que la direccin de puerto de la direccin URL sea correcta. Nombre del CMS que aloja el host. Es el nombre que aparece en el campo Sistema del cuadro de inicio de sesin.
Nombre
Direccin URL
CMS
Usuario Autenticacin Habilitar inicio de sesin nico del Directorio de Windows Active
Estos parmetros se describen en la seccin "Iniciar Query as a Web Service" del apartado de temas relacionados.
1. Seleccione Herramientas > Administrar hosts. Se abrir el cuadro de dilogo "Administrar hosts".
Nota:
Tambin puede acceder al cuadro de dilogo "Administrar hosts" desde el cuadro de registro al iniciar sesin en Query as a Web Service. 2. Haga clic en un host de la lista. 3. Haga clic en el botn Editar. Aparece el cuadro de dilogo "Editar un host". Contiene los parmetros que se pueden editar para el host. 4. Especifique o modifique uno o ms valores. 5. Haga clic en Aceptar y, a continuacin, en Cerrar. Se abrir el cuadro de inicio de sesin. Las modificaciones en el host se aplican al instante.
25
Iniciar Query as a Web Service Pgina de catlogo de consultas
Pgina de catlogo de consultas

La pgina de catlogo de consultas aparece al iniciar Query as a Web Server. Incluye las consultas publicadas en el servidor host y el universo que utiliza cada consulta. Por cada consulta seleccionada en la lista, se enumeran en el panel de informacin de la derecha el nombre, el nombre de universo, la descripcin y la direccin URL de la descripcin WSDL de la consulta seleccionada. En la pgina de catlogo de consultas, puede crear y publicar nuevas consultas, as como administrar las consultas ya publicadas en el servidor host. En dicha pgina, puede realizar las acciones siguientes:
Men Acciones disponibles Editar Crear una nueva consulta y crear carpetas en la lista de catlogo para almacenar y organizar las consultas. Editar la definicin de una consulta. Duplicar la consulta para utilizar como plantilla para una nueva consulta. Eliminar, cambiar el nombre y actualizar las consultas de la lista. Implementar una consulta en otro servidor host.
Consulta
Hay disponibles las acciones de edicin estndar de Windows Cortar, Copiar y Pegar. Acceder al cuadro de dilogo "Administrar hosts" para agregar, editar y eliminar servidores host. Cerrar sesin e iniciarla como otro usuario o en un host diferente sin cerrar la aplicacin. Acceder al cuadro de dilogo de parmetros avanzados para configurar la direccin URL, los lmites de tiempo de espera y el modo de autenticacin de la consulta.
Herramientas
26
Crear una consulta nueva para publicarla como servicio Web
Crear una consulta nueva para publicarla como servicio Web Crear y publicar una consulta nueva como servicio Web
Crear y publicar una consulta nueva como servicio Web

Puede crear una consulta para publicar como servicio Web de dos modos: Utilice el "Asistente de publicacin de Query as a Web Service" para definir una consulta desde cero. Duplique una consulta existente para utilizarla como plantilla de definicin, y modifique su definicin para crear una nueva consulta.
Cmo crear una consulta nueva utilizando el Asistente de publicacin de Query as a Web Service
Utilice el "Asistente de publicacin de Query as a Web Service" para crear una nueva consulta para publicar como servicio Web. Si desea utilizar una consulta existente como plantilla, consulte la seccin sobre cmo duplicar una consulta publicada en el apartado de temas relacionados. Puede crear y publicar una consulta siguiendo el procedimiento que se describe. Consulte los temas al final de la pgina para acceder directamente a la pgina de la Ayuda que se corresponde con el paso del asistente. Cada pgina de Ayuda describe por completo las propiedades establecidas en la pgina del asistente actual.
Tabla 4-1: Flujo de trabajo de creacin y publicacin de consultas utilizando el asistente
Flujo de trabajo de creacin y publiDescripcin cacin de consultas Inicie el asistente desde la pgina de Iniciar el "Asistente de publicacin de catlogo de consultas. Es la pgina Query as a Web Service" que aparece al iniciar sesin en un host.
28
Crear una consulta nueva para publicarla como servicio Web Cmo crear una consulta nueva utilizando el Asistente de publicacin de Query as a Web Service
Flujo de trabajo de creacin y publiDescripcin cacin de consultas Definir el nombre y la descripcin de la nueva consulta. Escriba el nombre y los comentarios para la consulta.
Puede definir los parmetros para uso de proxy inverso, las restricciones de Configurar las propiedades avanzadas tiempo de espera y el tipo de autenticacin. Seleccione el universo que contenga Elegir un universo como origen de da- los objetos que se utilizarn en la contos para la consulta. sulta. El universo es el origen de datos de la consulta. La consulta se crea utilizando el Panel de consulta para combinar las dimensiones y las medidas, as como para definir las condiciones de la consulta.
Crear la consulta utilizando el Panel de consulta.
Obtenga una vista preliminar de la Obtener una vista preliminar y publicar consulta SQL y publquela como servila nueva consulta como servicio Web. cio Web en el servidor host.
Para iniciar el Asistente de publicacin de Query as a Web Service

Utilice el "Asistente de publicacin de Query as a Web Service" para crear y publicar una nueva consulta. Inicie el asistente desde la pgina de catlogo de consultas. Cada pgina del asistente cuenta con una pgina de Ayuda. 1. Inicie Query as a Web Service. Se abrir el catlogo de consultas. Enumera los servicios Web de consultas actuales almacenados en el servidor host. 2. Seleccione Consulta > Nuevaconsulta. Se abrir la pgina "Descripcin" del "Asistente de publicacin de Query as a Web Service". En esta pgina puede especificar el nombre, la descripcin y los parmetros avanzados.
29
Definir las propiedades de descripcin y nombre de consulta

En la pgina "Descripcin" del "Asistente de publicacin de Query as a Web Service", especifique un nombre y una descripcin para la nueva consulta que se publicar como servicio Web. 1. Especifique un nombre y una descripcin para la consulta. 2. Realice una de las siguientes acciones: Si desea definir los parmetros para el uso de proxy inverso, las restricciones de tiempo de espera de sesin o el tipo de autenticacin, haga clic en el botn Parmetros avanzados. Si no desea configurar los parmetros avanzados, haga clic en Siguiente. En funcin de su eleccin, se abrir el cuadro de dilogo de parmetros avanzados o la siguiente pgina del asistente "Seleccionar un universo".
Definir parmetros avanzados de servicio Web

Puede definir los parmetros siguientes en el cuadro de dilogo "Parmetros avanzados": Uso de proxy inverso con una direccin URL base del servicio Web Restricciones de tiempo de espera de sesin Modo de autenticacin utilizado para consumidores de servicios Web. Este parmetro slo se aplica al servicio Web cuando se consume.
Cada una de estas opciones se describe en los temas indicados al final de la seccin. 1. Haga clic en el botn Avanzado de la pgina "Descripcin" del "Asistente de publicacin de Query as a Web Service". Se abrir el cuadro de dilogo Parmetros avanzados. 2. Realice una de las siguientes acciones: Edite o escriba una nueva direccin URL base del servicio Web. Escriba o utilice las flechas arriba y abajo para especificar un nuevo valor para la restriccin de tiempo de espera de sesin. Seleccione un modo de autenticacin en la lista desplegable.
30
3. Haga clic en Aceptar. Se abrir la pgina Descripcin. Continuar definiendo la consulta en esta pgina.
Direccin URL base del servicio Web

El proxy inverso es la traduccin de la direccin de red de un equipo de una URL de la red indicada a otra URL de otra red, por lo general, una red externa y pblica como Internet. Un servidor denominado miservidor.empresa.es de una red de empresa se podra denominar www.miempresa.es en la red externa. Para que se admita este tipo de despliegue, debe configurar una direccin URL base de los servicios Web. La direccin URL base contiene la direccin URL externa desde la que se debe franquear el acceso al servicio Web, por ejemplo, www.miempresa.es/dswsbobje/.
Tiempo de espera de sesin

A fin de mejorar el rendimiento de Query as a Web Service (en particular, los casos de llamadas en cascada), el proveedor de servicios Web almacena en cach la conexin del usuario al servidor. Se puede configurar el tiempo de espera de la sesin (en segundos) para cada conexin de Query as a Web Service. El valor predeterminado es de 60 segundos. Por ejemplo, si un usuario concreto llama al servicio 1 y, en menos de 60 segundos, llama al servicio 2 con los mismos datos (nombre de usuario y contrasea idnticos), el servidor reutiliza la conexin y reinicializa el tiempo de espera de la sesin.
Modo de autenticacin
El modo de autenticacin indica el tipo de directorio con el que la plataforma BusinessObjects XI valida el inicio de sesin. Algunos ejemplos son Enterprise, LDAP, Windows AD o SAP. Puede establecer el modo de autenticacin para que se defina segn el servicio o para que lo haga el consumidor: Servicio
31
El administrador se ocupa de seleccionar el directorio de autenticacin; todos los usuarios que accedan en lo sucesivo al servicio se autentican en dicho directorio (excepto la opcin sessionID). Todos los directorios de autenticacin compatibles con el servidor se encuentran disponibles para la seleccin en la lista desplegable Modo de autenticacin. Definido por el consumidor El consumidor de la consulta selecciona el modo de autenticacin en el parmetro de entrada authenticationType.
Seleccionar un universo para una consulta

La pgina "Seleccionar un universo" del "Asistente de publicacin de Query as a Web Service" enumera los universos disponibles para el CMS. Seleccione el universo que se utilizar como origen de datos para la consulta. 1. Haga clic en un universo de la lista. En el cuadro de descripcin aparece una descripcin del universo seleccionado. 2. Haga clic en Siguiente. Se abrir la pgina "Consulta" del asistente.
Definir una consulta

La pgina "Consulta" del "Asistente de publicacin de Query as a Web Service" permite utilizar un panel de consultas para definir una consulta basada en un universo. El panel de consulta se basa en el "panel de consulta HTML de Web Intelligence". En esta seccin se describe brevemente el panel de consulta y se incluyen instrucciones para crear una consulta. No obstante, el panel de consulta se describe detalladamente en la gua Elaboracin de consultas mediante Consulta - HTML de Web Intelligence. Para obtener informacin adicional, consulte esta gua en la documentacin de esta versin. El panel de consulta contiene las siguientes reas:
32
rea del panel de consulta Descripcin Panel a la izquierda del panel de consulta que contiene las clases, dimensiones y medidas del universo organizado en una estructura de rbol. Estos objetos se asignan a estructuras SQL de la base de datos. La consulta se crea utilizando estos objetos. Arrastre los objetos de la consulta a este panel. Puede aplicar un orden a los datos para cada objeto haciendo clic con el botn derecho en un objeto y seleccionando el tipo de orden. Arrastre los objetos para definir un filtro que limite los datos que devolver la consulta. Puede seleccionar los operadores de una lista, aplicar un filtro utilizando una constante o una lista de valores o definir una peticin para la entrada de usuario.
Ventana Universo
Panel Objetos del resultado
Panel Filtrar objetos
1. En el panel "Universo", realice una de las siguientes acciones: Haga doble clic en los objetos de la consulta. Seleccione los objetos y arrstrelos al panel "Objetos del resultado". Los objetos de consulta aparecen alineados en el panel "Objetos del resultado". Puede cambiar el orden de un objeto de la consulta seleccionndolo y arrastrndolo a la posicin deseada. Puede eliminar cualquier objeto seleccionndolo y arrastrndolo de nuevo al panel "Universo". 2. Si desea crear un filtro, haga doble clic o arrastre un objeto de filtro al panel "Filtrar objetos". El objeto se asocia automticamente con una lista desplegable de operadores, un cuadro de texto de una constante y una lista desplegable de valores o una peticin. 3. Seleccione un operador y elija el filtro deseado en las listas desplegables. En la seccin de temas relacionados se describen los filtros disponibles. 4. Haga clic en Aceptar. Aparece la pgina "Vista preliminar" del asistente.
33
Definir restricciones de consultas

Puede definir restricciones para optimizar el rendimiento de las consultas. Puede definir las siguientes restricciones:
Restriccin Descripcin Si se selecciona, permite devolver filas duplicadas. De modo predeterminado, la consulta no devuelve filas duplicadas. Tiempo mximo permitido para la recuperacin de datos. El valor predeterminado "-1" indica que esta opcin est desactivada y que se aplica el valor establecido en los parmetros de conexin de universo.
Filas duplicadas
Tiempo mximo de bsqueda
Nmero mximo de filas que puede devolver una consulta. El valor predeterminado Nmero mximo de filas devueltas "-1" indica que esta opcin est desactivada y que se aplica el valor establecido en los parmetros de conexin de universo. El nmero de filas que se debe devolver Conjunto de resultados de ejemplo para un conjunto de resultados de ejemplo antes de ejecutar la consulta.
1. En el panel de consulta, haga clic en el icono de opciones en la parte superior izquierda de la pgina. Aparecer un cuadro de dilogo con las opciones de restriccin de consultas. 2. Defina los valores de restricciones necesarios. 3. Haga clic en Aceptar.
34
Definir el orden de clasificacin de las peticiones

Puede definir un orden para cada objeto del universo. Tambin puede definir una prioridad de ordenacin para un objeto. 1. En el panel de consultas, haga clic en el icono Administrar ordenaciones encima del panel "Universo". Aparecer un cuadro de dilogo con las opciones de ordenacin. 2. Expanda las carpetas del panel "Objetos disponibles" y seleccione un objeto. 3. Haga doble clic en el objeto o en la flecha para colocar el objeto en el panel "Ordenaciones de la consulta". 4. Seleccione el objeto en el panel "Ordenaciones de la consulta" y haga clic en Ascendenteo Descendente. 5. Si es preciso, seleccione un objeto y haga clic en los botones Subir o Bajar. 6. Haga clic en Aceptar.
Definir listas de valores

Las listas de valores se definen seleccionando el objeto en la pgina de consultas y luego definiendo la lista de valores en una pgina de lista de valores. 1. En la pgina de consultas, arrastre un objeto al panel Filtrar objetos. Aparecer un cuadro de texto flanqueado por dos filtros de listas desplegables. 2. En la lista desplegable de la izquierda del cuadro de texto, seleccione En la lista y, a continuacin, elija Lista de valores en la lista desplegable de la derecha del cuadro. Aparece el cuadro de dilogo Lista de valores. 3. Haga doble clic en cada valor del panel de lista que desee que aparezca en la lista de valores. El valor aparecer en el panel Valores seleccionados. 4. Haga clic en Aceptar. Los valores aparecern en el cuadro de texto.
35
Crear una consulta nueva para publicarla como servicio Web Cmo crear una nueva consulta duplicando una ya publicada
Definir peticiones
Una peticin se define seleccionando el objeto en la pgina de consultas y luego abriendo una pgina de peticiones para definirla. 1. En la pgina de consultas, arrastre un objeto de peticin al panel Filtrar objetos. Aparecer un cuadro de texto flanqueado por dos filtros de listas desplegables. 2. Seleccione Peticin en la lista desplegable que hay a la derecha del cuadro de texto. Aparecer un icono de peticin. 3. Haga clic en el icono de peticin. Aparecer un cuadro para definir una peticin. Escriba el texto que desee incluir en la peticin y seleccione las opciones que se aplicarn a la misma. 4. Haga clic en Aceptar.
Obtener una vista preliminar y publicar una consulta

La pgina "Vista preliminar" del "Asistente de publicacin de Query as a Web Service" permite obtener una vista preliminar de los objetos de la consulta y la tabla de resultados. Cuando est satisfecho con la vista preliminar, podr publicar la consulta como servicio Web en el servidor host. 1. Compruebe que el universo, los objetos y el resultado de la consulta sean correctos. 2. Haga clic en Publicar. La consulta se publicar en el servidor host como servicio Web. Se incluir en la pgina de catlogo de consultas.
Cmo crear una nueva consulta duplicando una ya publicada

Puede crear una nueva consulta para publicar duplicando una consulta publicada y utilizndola como plantilla. Una vez duplicada la consulta, se
36
iniciar automticamente el "Asistente de publicacin de Query as a Web Service", y podr modificar la definicin del mismo modo en que se crea una nueva consulta con el asistente. Debe tener los permisos de usuario pertinentes para copiar una consulta en una carpeta y agregar una consulta nueva a otra carpeta.
Para duplicar una consulta publicada

Puede duplicar una consulta para crear una nueva definicin de consulta del modo siguiente: 1. Realice una de las siguientes acciones: Seleccione una consulta en la pgina de catlogo de consultas y elija Consulta > Duplicar. Haga clic con el botn derecho en la lista del catlogo de consultas y seleccione "Duplicar" en la lista. Se abrir el "Asistente de publicacin de Query as a Web Service". 2. Siga los pasos del asistente para cambiar el nombre y modificar la definicin de consulta.
37
38
Administrar consultas como servicios Web
Administrar consultas como servicios Web Crear carpetas en el catlogo de consultas
Crear carpetas en el catlogo de consultas

Puede crear carpetas en la pgina de catlogo de consultas para organizar las consultas de la lista. En la pgina de catlogo de consultas, lleve a cabo una de las siguientes acciones: Haga clic en la carpeta root y seleccione Consulta > Nueva carpeta. Haga clic con el botn derecho en la carpeta raz y seleccione "Nueva carpeta" en la lista. Se crear una nueva carpeta en la lista. Puede crear carpetas en cualquier carpeta de la lista.
Editar una consulta como servicio Web

Puede modificar la definicin de una consulta que se haya publicado como servicio Web en cualquier momento. Al editar una consulta como servicio Web, se puede alterar el WSDL asociado, lo que podra romper el vnculo que emplean otros usuarios para comunicarse con los servicios Web. Business Objects le aconseja que notifique a los usuarios todos los cambios que realice. 1. En el catlogo de consultas, seleccione la consulta que desee editar. 2. Realice una de las siguientes acciones: Seleccione Consulta > Editar. Haga doble clic en una consulta. Haga clic con el botn derecho en una consulta y elija "Editar" en la lista del catlogo. Se abrir el "Asistente de publicacin de Query as a Web Service". 3. Siga los pasos del asistente para editar la consulta y volver a publicarla ms adelante.
Para cambiar el nombre a una consulta

Puede cambiar el nombre de una consulta en el catlogo de consultas. El nuevo nombre se aplicar al instante. No es necesario que vuelva a publicar la consulta para aplicar el nuevo nombre, ya que el servicio Web se identifica
40
Administrar consultas como servicios Web Eliminar una consulta como servicio Web
en el CMS mediante un identificador exclusivo (CUID) en lugar del nombre de consulta que se utilizaba en las versiones anteriores. 1. En la pgina de catlogo de consultas, lleve a cabo una de las siguientes acciones: Haga doble clic en una consulta de la lista. Seleccione una consulta en la lista y elija Consulta > Cambiar nombre La consulta se resaltar. 2. Escriba un nuevo nombre. El nuevo nombre se aplicar al instante.
Eliminar una consulta como servicio Web

Puede eliminar una consulta de la lista del catlogo de consultas. Realice una de las siguientes acciones: Seleccione una consulta de la pgina de catlogo de consultas y elija Editar > Eliminar. Haga clic con el botn derecho en la lista del catlogo de consultas y seleccione "Eliminar" en la lista. La consulta se eliminar del host.
Copiar y pegar una consulta como servicio Web

Puede copiar y pegar consultas entre carpetas del catlogo de consultas. Asegrese de tener los permisos de usuario correspondientes para realizar la operacin de copia. 1. Realice una de las siguientes acciones: Seleccione una consulta en el catlogo de consultas y elija Editar > Copiar. Haga clic con el botn derecho en una consulta del catlogo y seleccione "Copiar" en el men contextual. 2. Haga clic en el lugar donde desee pegar la consulta copiada y seleccione Editar > Pegaro haga clic con el botn derecho y seleccione "Pegar" en la lista.
41
Administrar consultas como servicios Web Ver las propiedades de la consulta
La consulta copiada aparecer en la lista del catlogo de consultas.
Ver las propiedades de la consulta

Puede ver las propiedades de la consulta en la pgina de catlogo de consultas. 1. Seleccione una consulta en la lista que aparece en la pgina de catlogo de consultas. Si es preciso, abra las carpetas para ir a la consulta. Las propiedades se muestran en la parte derecha de la lista de consultas. 2. Haga clic en la direccin URL. El vnculo a la descripcin de consultas se muestra en un explorador Web. La definicin de WSDL se abre en el explorador Web. 3. Haga clic en el vnculo de WSDL de la pgina Web para ver el WSDL.
Ver las instancias de servicios Web de consultas disponibles

Puede ver las instancias disponibles de Query as a Web Service en un explorador Web. Abra un explorador Web y vaya a la direccin URL dswsbobje http://<nombre del servidor>:<nmero de puerto Tom cat>/dswsbobje/ qaawsservices
42
Administrar consultas como servicios Web Cmo implementar consultas en otro servidor Web
Cmo implementar consultas en otro servidor Web

En esta seccin se explica cmo implementar en otro servidor. Debe copiar una definicin de Query as a Web Service de un servidor a otro. Por ejemplo, puede mover una definicin de consulta de un servidor de desarrollo a uno de prueba o produccin. Para realizar el despliegue en otro servidor, dispone de los mtodos siguientes: Query as a Web Service Utilice la opcin Desplegar en otro servidor. La ventaja de este mtodo es que la consulta se actualizar automticamente la cach WSDL de la consulta en el nuevo servidor de la aplicacin. Si no se utiliza este mtodo, deber actualizar manualmente la cach WSDL.
43
Asistente de importacin. Deber actualizar manualmente la cach WSDL para la consulta desplegada. Archivo BIAR. Deber actualizar manualmente la cach WSDL para la consulta desplegada.
Nota:
Antes de empezar, asegrese de que el universo y los usuarios sean iguales en ambos equipos. Use el Asistente de importacin o archivos .biar para importar universos y usuarios. Es importante mantener el mismo CUID durante las operaciones del Asistente de importacin.
Temas relacionados
Actualizacin de la cach WSDL al desplegar consultas en otro servidor
La actualizacin del archivo WSDL cambia en el despliegue de consultas

Las actualizaciones del archivo WSDL han cambiado en esta versin. A partir de esta versin, el servlet almacena todos los archivos WSDL en un archivo .ZIP en el servidor de la aplicacin. Anteriormente, el servlet se conectaba a CMS cada vez que se publicaba una consulta. La WSDL de la consulta se actualizaba de forma dinmica. En esta versin, ya no hay que realizar conexiones con el CMS. Los archivos WSDL se agregan a este archivo .ZIP siempre que se publique o actualice una nueva consulta de QaaWS. Tambin se almacenan parmetros de ejecucin adicionales en la cach WSDL, por ejemplo el modo de autenticacin, as como valores de configuracin regional y tiempo de espera que se utilizan durante el consumo del servicio Web. Al utilizar la opcin Desplegar en otro servidor para desplegar una consulta en otro servidor de aplicacin, la cach WSDL se actualiza de forma automtica. Si se utiliza el Asistente de importacin o un archivo BIAR para desplegar una consulta en otro servidor de aplicacin, deber actualizar manualmente el archivo .ZIP de WSDL. ste se describe en la seccin Temas relacionados.
Temas relacionados
44
Implementar en otro servidor utilizando la herramienta cliente Query as a Web Service

El cliente Query as a Web Service le permite desplegar consultas en otro servidor una vez, por medio del mismo nombre de servicio. Puede usar la opcin Desplegar en otro servidor entre dos servidores que tengan instalada la misma versin de Query as a Web Service. Con esta opcin no es posible migrar consultas de una versin a otra. 1. En el catlogo de consultas, seleccione la aparicin de Query as a Web Service cuya definicin desee copiar. 2. Haga clic en Desplegar en otro servidor. Aparece el cuadro de dilogo Seleccione sus credenciales. 3. Complete la informacin del sistema en el que desee desplegar los servicios Web y, cuando termine, haga clic en Aceptar. La opcin seleccionada de Query as a Web Service aparece en el Asistente de publicacin de Query as a Web Service. 4. Publique Query as a Web Service en el nuevo sistema. Al desplegar una definicin de Query as a Web Service en otro servidor, cambia automticamente la ubicacin del WSDL as como la ubicacin de ejecucin de los servicios.
Nota:
El asistente permite personalizar esta direccin URL basada en el servicio. Tambin puede convertirla en dinmica en proyectos de Xcelsius mediante el cuadro de texto de valores de entrada para la conectividad de servicios Web. Gracias a esta funcionalidad, puede convertir un cuadro de mandos de desarrollo en un cuadro de produccin simplemente cambiando la direccin URL. No es posible desplegar el mismo nombre de servicio de la consulta en el mismo servidor en ms de una ocasin.
45
Implementar Query as a Web Service desde el Asistente de importacin

Para realizar el despliegue con el Asistente de importacin, importe la definicin de Query as a Web Service del servidor de origen al servidor de destino. 1. Inicie el Asistente de importacin en el servidor de origen. 2. Despus de iniciar la sesin en el CMS de origen, seleccione el archivo de destino al que desee exportar las definiciones. 3. En el panel Seleccione los objetos para importar del cuadro de dilogo Asistente de importacin, seleccione Importar carpetas y objetos y, a continuacin, Importar carpetas y objetos de la aplicacin. 4. En el panel Seleccionar carpetas y objetos de aplicacin del cuadro de dilogo Asistente de importacin, expanda la carpeta QaaWS y, a continuacin, las definiciones de Query as a Web Service que le interesen. 5. Contine por los pasos restantes del Asistente de importacin haciendo clic en Siguiente. 6. Abra el Asistente de importacin en el servidor de destino. 7. En el cuadro de dilogo Entorno de origen, seleccione el archivo de origen al que haya exportado las definiciones. 8. Inicie sesin en el CMS de destino. 9. En el panel Seleccione los objetos para importar del cuadro de dilogo Asistente de importacin, seleccione Importar carpetas y objetos y, a continuacin, Importar carpetas y objetos de la aplicacin. 10. En el panel Seleccionar carpetas y objetos de aplicacin del cuadro de dilogo Asistente de importacin, seleccione las definiciones de Query as a Web Service que le interesen. 11. Contine por los pasos restantes del Asistente de importacin haciendo clic en Siguiente. 12. Tras la importacin, apunte la definicin de consulta recin desplegada al servidor Web del sistema de destino.
46
Implementar Query as a Web Service desde un archivo BIAR

Compruebe que el Asistente de importacin est instalado tanto en el servidor de origen como en el servidor de destino. 1. Abra el Asistente de importacin en el servidor de origen. 2. Despus de iniciar la sesin en el CMS de origen, seleccione el archivo .biar de destino al que desee exportar las definiciones. 3. En el panel Seleccione los objetos para importar del cuadro de dilogo Asistente de importacin, seleccione Importar carpetas y objetos y, a continuacin, Importar carpetas y objetos de la aplicacin. 4. En el panel Seleccionar carpetas y objetos de aplicacin del cuadro de dilogo Asistente de importacin, expanda la carpeta QaaWS y, a continuacin, las definiciones de Query as a Web Service que le interesen. 5. Contine por las pginas restantes del Asistente de importacin. 6. Abra el Asistente de importacin en el servidor de destino. 7. En el cuadro de dilogo Entorno de origen, seleccione el archivo .biar al que haya exportado las definiciones. 8. Inicie sesin en el CMS de destino. 9. En el cuadro de dilogo Seleccione los objetos para importar, seleccione Importar carpetas y objetos > Importar carpetas y objetos de la aplicacin. 10. En el cuadro de dilogo Importar carpetas y objetos de la aplicacin, seleccione las definiciones de Query as a Web Service que le interesen. 11. Contine por las pginas restantes del Asistente de importacin. 12. Tras la importacin, apunte la definicin de consulta recin desplegada al servidor Web del sistema de destino.

Si no utiliza la opcin Desplegar en otro servidor en Query as a Web Service para desplegar una consulta a otro servidor, tendr que actualizar manualmente la cach WSDL para asegurarse de que la consulta se
47
Administrar consultas como servicios Web Implementar en otro servidor utilizando la herramienta cliente Query as a Web Service
sincroniza con el Servidor de administracin central (CMS). Esto se hace utilizando el asistente de importacin o un archivo BIAR para desplegar una consulta en otro servidor. Para actualizar manualmente la WDSL cuando una consulta se despliega en otro servidor de aplicacin, haga lo siguiente: Vaya a la siguiente URL: http://<NombreServidorAplicacin>:<puerto>/dswsbobje/qaawsservices/wsdlGenerator Si fuera necesario, especifique la informacin de acceso del CMS.
Los archivos WSDL se actualizan de forma automtica.

48
Nota:

Temas relacionados
49

Nota:
50

51


52
Administrar consultas como servicios Web Implementar Query as a Web Service desde el Asistente de importacin

Para realizar el despliegue con el Asistente de importacin, importe la definicin de Query as a Web Service del servidor de origen al servidor de destino. 1. Inicie el Asistente de importacin en el servidor de origen. 2. Despus de iniciar la sesin en el CMS de origen, seleccione el archivo de destino al que desee exportar las definiciones. 3. En el panel Seleccione los objetos para importar del cuadro de dilogo Asistente de importacin, seleccione Importar carpetas y objetos y, a continuacin, Importar carpetas y objetos de la aplicacin. 4. En el panel Seleccionar carpetas y objetos de aplicacin del cuadro de dilogo Asistente de importacin, expanda la carpeta QaaWS y, a continuacin, las definiciones de Query as a Web Service que le interesen. 5. Contine por los pasos restantes del Asistente de importacin haciendo clic en Siguiente. 6. Abra el Asistente de importacin en el servidor de destino. 7. En el cuadro de dilogo Entorno de origen, seleccione el archivo de origen al que haya exportado las definiciones. 8. Inicie sesin en el CMS de destino. 9. En el panel Seleccione los objetos para importar del cuadro de dilogo Asistente de importacin, seleccione Importar carpetas y objetos y, a continuacin, Importar carpetas y objetos de la aplicacin.
53
10. En el panel Seleccionar carpetas y objetos de aplicacin del cuadro de dilogo Asistente de importacin, seleccione las definiciones de Query as a Web Service que le interesen. 11. Contine por los pasos restantes del Asistente de importacin haciendo clic en Siguiente. 12. Tras la importacin, apunte la definicin de consulta recin desplegada al servidor Web del sistema de destino.

Temas relacionados

El cliente Query as a Web Service le permite desplegar consultas en otro servidor una vez, por medio del mismo nombre de servicio.
54
Puede usar la opcin Desplegar en otro servidor entre dos servidores que tengan instalada la misma versin de Query as a Web Service. Con esta opcin no es posible migrar consultas de una versin a otra. 1. En el catlogo de consultas, seleccione la aparicin de Query as a Web Service cuya definicin desee copiar. 2. Haga clic en Desplegar en otro servidor. Aparece el cuadro de dilogo Seleccione sus credenciales. 3. Complete la informacin del sistema en el que desee desplegar los servicios Web y, cuando termine, haga clic en Aceptar. La opcin seleccionada de Query as a Web Service aparece en el Asistente de publicacin de Query as a Web Service. 4. Publique Query as a Web Service en el nuevo sistema. Al desplegar una definicin de Query as a Web Service en otro servidor, cambia automticamente la ubicacin del WSDL as como la ubicacin de ejecucin de los servicios.
Nota:

Para realizar el despliegue con el Asistente de importacin, importe la definicin de Query as a Web Service del servidor de origen al servidor de destino. 1. Inicie el Asistente de importacin en el servidor de origen. 2. Despus de iniciar la sesin en el CMS de origen, seleccione el archivo de destino al que desee exportar las definiciones.
55
3. En el panel Seleccione los objetos para importar del cuadro de dilogo Asistente de importacin, seleccione Importar carpetas y objetos y, a continuacin, Importar carpetas y objetos de la aplicacin. 4. En el panel Seleccionar carpetas y objetos de aplicacin del cuadro de dilogo Asistente de importacin, expanda la carpeta QaaWS y, a continuacin, las definiciones de Query as a Web Service que le interesen. 5. Contine por los pasos restantes del Asistente de importacin haciendo clic en Siguiente. 6. Abra el Asistente de importacin en el servidor de destino. 7. En el cuadro de dilogo Entorno de origen, seleccione el archivo de origen al que haya exportado las definiciones. 8. Inicie sesin en el CMS de destino. 9. En el panel Seleccione los objetos para importar del cuadro de dilogo Asistente de importacin, seleccione Importar carpetas y objetos y, a continuacin, Importar carpetas y objetos de la aplicacin. 10. En el panel Seleccionar carpetas y objetos de aplicacin del cuadro de dilogo Asistente de importacin, seleccione las definiciones de Query as a Web Service que le interesen. 11. Contine por los pasos restantes del Asistente de importacin haciendo clic en Siguiente. 12. Tras la importacin, apunte la definicin de consulta recin desplegada al servidor Web del sistema de destino.

Compruebe que el Asistente de importacin est instalado tanto en el servidor de origen como en el servidor de destino. 1. Abra el Asistente de importacin en el servidor de origen. 2. Despus de iniciar la sesin en el CMS de origen, seleccione el archivo .biar de destino al que desee exportar las definiciones. 3. En el panel Seleccione los objetos para importar del cuadro de dilogo Asistente de importacin, seleccione Importar carpetas y objetos y, a continuacin, Importar carpetas y objetos de la aplicacin. 4. En el panel Seleccionar carpetas y objetos de aplicacin del cuadro de dilogo Asistente de importacin, expanda la carpeta QaaWS y, a continuacin, las definiciones de Query as a Web Service que le interesen.
56
Administrar consultas como servicios Web Implementar Query as a Web Service desde un archivo BIAR
5. Contine por las pginas restantes del Asistente de importacin. 6. Abra el Asistente de importacin en el servidor de destino. 7. En el cuadro de dilogo Entorno de origen, seleccione el archivo .biar al que haya exportado las definiciones. 8. Inicie sesin en el CMS de destino. 9. En el cuadro de dilogo Seleccione los objetos para importar, seleccione Importar carpetas y objetos > Importar carpetas y objetos de la aplicacin. 10. En el cuadro de dilogo Importar carpetas y objetos de la aplicacin, seleccione las definiciones de Query as a Web Service que le interesen. 11. Contine por las pginas restantes del Asistente de importacin. 12. Tras la importacin, apunte la definicin de consulta recin desplegada al servidor Web del sistema de destino.

Si no utiliza la opcin Desplegar en otro servidor en Query as a Web Service para desplegar una consulta a otro servidor, tendr que actualizar manualmente la cach WSDL para asegurarse de que la consulta se sincroniza con el Servidor de administracin central (CMS). Esto se hace utilizando el asistente de importacin o un archivo BIAR para desplegar una consulta en otro servidor. Para actualizar manualmente la WDSL cuando una consulta se despliega en otro servidor de aplicacin, haga lo siguiente: Vaya a la siguiente URL: http://<NombreServidorAplicacin>:<puerto>/dswsbobje/qaawsservices/wsdlGenerator Si fuera necesario, especifique la informacin de acceso del CMS.

Compruebe que el Asistente de importacin est instalado tanto en el servidor de origen como en el servidor de destino.
57
1. Abra el Asistente de importacin en el servidor de origen. 2. Despus de iniciar la sesin en el CMS de origen, seleccione el archivo .biar de destino al que desee exportar las definiciones. 3. En el panel Seleccione los objetos para importar del cuadro de dilogo Asistente de importacin, seleccione Importar carpetas y objetos y, a continuacin, Importar carpetas y objetos de la aplicacin. 4. En el panel Seleccionar carpetas y objetos de aplicacin del cuadro de dilogo Asistente de importacin, expanda la carpeta QaaWS y, a continuacin, las definiciones de Query as a Web Service que le interesen. 5. Contine por las pginas restantes del Asistente de importacin. 6. Abra el Asistente de importacin en el servidor de destino. 7. En el cuadro de dilogo Entorno de origen, seleccione el archivo .biar al que haya exportado las definiciones. 8. Inicie sesin en el CMS de destino. 9. En el cuadro de dilogo Seleccione los objetos para importar, seleccione Importar carpetas y objetos > Importar carpetas y objetos de la aplicacin. 10. En el cuadro de dilogo Importar carpetas y objetos de la aplicacin, seleccione las definiciones de Query as a Web Service que le interesen. 11. Contine por las pginas restantes del Asistente de importacin. 12. Tras la importacin, apunte la definicin de consulta recin desplegada al servidor Web del sistema de destino.

Las actualizaciones del archivo WSDL han cambiado en esta versin. A partir de esta versin, el servlet almacena todos los archivos WSDL en un archivo .ZIP en el servidor de la aplicacin. Anteriormente, el servlet se conectaba a CMS cada vez que se publicaba una consulta. La WSDL de la consulta se actualizaba de forma dinmica. En esta versin, ya no hay que realizar conexiones con el CMS. Los archivos WSDL se agregan a este archivo .ZIP siempre que se publique o actualice una nueva consulta de QaaWS. Tambin se almacenan parmetros de ejecucin adicionales en la cach WSDL, por ejemplo el modo de autenticacin, as como valores de configuracin regional y tiempo de espera que se utilizan durante el consumo del servicio Web.
58
Al utilizar la opcin Desplegar en otro servidor para desplegar una consulta en otro servidor de aplicacin, la cach WSDL se actualiza de forma automtica. Si se utiliza el Asistente de importacin o un archivo BIAR para desplegar una consulta en otro servidor de aplicacin, deber actualizar manualmente el archivo .ZIP de WSDL. ste se describe en la seccin Temas relacionados.
Temas relacionados

Nota:
El asistente permite personalizar esta direccin URL basada en el servicio. Tambin puede convertirla en dinmica en proyectos de Xcelsius mediante el cuadro de texto de valores de entrada para la conectividad de servicios Web. Gracias a esta funcionalidad, puede convertir un cuadro de mandos
59
de desarrollo en un cuadro de produccin simplemente cambiando la direccin URL. No es posible desplegar el mismo nombre de servicio de la consulta en el mismo servidor en ms de una ocasin.

60


61
Administrar consultas como servicios Web Implementar Query as a Web Service en varios servidores Web
Implementar Query as a Web Service en varios servidores Web

Configurar el cliente Query as a Web Service para que se conecte a un servidor Web de proxy inverso
El proxy inverso es la traduccin de la direccin de red de un equipo de una URL de la red indicada a otra URL de una red externa. Como el cliente Query as a Web Service crea un enlace a los servicios Web del motor de informes, de Query y de BICatalog, debe especificar la direccin URL externa de los servicios Web: wsresource4=QueryService|query web service alo ne|http://[miservidor.miempresa.es]/dswsbobje/servi ces/query 1. Busque el archivo dsws.properties. Este archivo se encuentra en aplicacin Web dswsbobje. 2. Actualice las siguientes propiedades:
62
Nombre de la propieValor de la propiedad dad
wsresource1
ReportEngine|reportengine web service alone|http://[miservidor.miempre sa.es]/dswsbobje/services/reportengi ne BICatalog|bicatalog web service alo ne|[miservidor.miempresa.es] dswsbob je/services/bicatalog QueryService|query web service alo ne|http://[miservidor.miempre sa.es]/dswsbobje/services/query
wsresource2
wsresource4
63
64
Consumir consultas como servicios Web con distintas aplicaciones
Consumir consultas como servicios Web con distintas aplicaciones Consumir Query as a Web Service mediante WSDL
Consumir Query as a Web Service mediante WSDL

WSDL es un lenguaje basado en XML que describe la comunicacin por medio del servicio Web, es decir, los enlaces de protocolo y los formatos de mensaje necesarios para interactuar con los servicios Web enumerados en el directorio. Primero, se describen de forma general las operaciones y los mensajes compatibles y, luego, se enlazan a un protocolo de red y un formato de mensaje concretos. El lenguaje WSDL se emplea a menudo junto con el esquema XML y SOAP a fin de prestar servicios Web por Internet. Si un programa cliente se conecta a un servicio Web, puede leer el WSDL para determinar las funciones disponibles en el servidor. Para buscar el WSDL de Query as a Web Service, seleccinelo en el catlogo de consultas.
Consumir Query as a Web Service en Crystal Xcelsius

Para consumir Query as a Web Service en Crystal Xcelsius, use el Conector de servicios Web.
Nota:
Asegrese de que tiene instalado Crystal Xcelsius 2008 Enterprise para tener acceso a las conexiones del servicio web. El componente Conector de servicios Web facilita la comunicacin de documentos Flash creados en Xcelsius con Query as a Web Service por medio de SOAP usando la funcin de sealar y hacer clic. Los documentos Flash de Xcelsius son independientes y se comunican con el servicio Web para mostrar visualmente los datos. El nico requisito consiste en que el documento Flash ha de tener a su disposicin algn servicio Web basado en SOAP. Al activar el componente Conector de servicios Web, se crea un mensaje basado en SOAP (en esencia, un documento XML), el cual se enva al
66
Consumir consultas como servicios Web con distintas aplicaciones Consumir Query as a Web Service en Crystal Xcelsius
servicio Web. El servicio Web responde con su propio mensaje basado en SOAP. A continuacin, el componente Conector de servicios Web enva estos datos a todos los dems componentes, lo que da como resultado una representacin visual real de los datos. Existen numerosos servicios Web pblicos disponibles, as como infinidad de toolkits y paquetes diferentes para servicios Web basados en SOAP. Para utilizar los paquetes y servicios Web pblicos que ya tengan un servicio Web, slo necesita un documento WSDL para el servicio Web. En el caso de Query as a Web Service, busque el WSDL en las propiedades de cada uno de los servicios Web seleccionndolo en el catlogo de consultas. Consulte el Manual del usuario de Crystal Xcelsius para obtener ms informacin.
Problema por cruce de dominios

Tras descargar el producto Xcelsius de Internet, quiz se tope con dificultades para recuperar los datos con la herramienta Query as a Web Service si el contenido Flash y la herramienta cliente proceden de distintos dominios Web. Esto sucede por motivos de seguridad relacionados con Macromedia Flash. El contenido Flash que se muestra en un explorador no tiene permiso para acceder a datos que residan fuera del dominio Web donde se haya originado el formato del archivo Flash (SWF). La solucin depende de si el servidor de Xcelsius y la herramienta cliente Query as a Web Service se encuentran en el mismo equipo o en mquinas diferentes.
Mismo equipo
Abra el cuadro de dilogo Parmetros opcionales mediante el botn Parmetros avanzados) y modifique el valor de Direccin URL base del servicio Web para que coincida con el dominio Web desde el que ha descargado Xcelsius.
Equipos distintos
Para obtener instrucciones, visite esta pgina:
67
http://www.adobe.com/cfusion/knowledgebase/index.cfm?id=tn_14213
Seleccionar el servicio Web

Para seleccionar el servicio Web, debe hacer que el componente Conector de servicios Web apunte al documento WSDL. 1. Si trabaja con una hoja de clculo de Excel, haga doble clic en el componente Conector de servicios Web para abrir el panel Propiedades. 2. En el panel izquierdo, arrastre el botn Actualizar conexin del cuadro de mandos del lado derecho de la pantalla de la aplicacin. 3. Realice una de las siguientes acciones: Seleccione Datos > Conexiones. Haga clic en el botn Actualizar datos. Aparecer el cuadro de dilogo Seleccionar servicio Web. 4. Haga clic en Agregar. Aparecer una lista de los tipos de conexin disponibles. 5. Seleccione Consultar como servicio Web. Al seleccionar Consultar como servicio Web se asegura de que Xcelsius administre la autenticacin correcta para los parmetros de inicio de sesin. 6. Escriba un nombre para la conexin. 7. En el cuadro Direccin URL WSDL, escriba o pegue la ubicacin del documento WSDL. 8. Haga clic en Importar. Si se ha producido algn error, puede que el documento WSDL no est validado por completo o no cumpla los requisitos del componente Conector de servicios Web. 9. En la lista Mtodos, seleccione el mtodo con el que desee crear un enlace. Para cada servicio Web, slo puede enlazar un mtodo por componente. 10. Haga clic en Aceptar. Ya estn disponibles los mensajes de entrada y salida que puede enlazar a los datos.
68
Mensajes de entrada
En el caso de los mensajes de entrada, slo se pueden enlazar elementos a los datos. Use el botn "-" para quitar carpetas y elementos. De este modo, evita que se enven la carpeta o el campo en el mensaje. El botn "+" sirve para agregar una carpeta o cualquier elemento que se repita.
Mensajes de salida
En el caso de los mensajes de salida, se pueden enlazar tanto elementos como carpetas a los datos. Al seleccionar una carpeta, aparece el nmero de columnas que contiene. Cuando se enlaza a los datos, se asigna una columna a cada uno de los elementos de la carpeta en el mismo orden en que figuren stos. Si selecciona menos columnas, limita los datos enlazados al nmero de columnas seleccionado. Si selecciona ms columnas, se insertan columnas en blanco. Si un elemento se repite en la carpeta, slo se asigna a la columna el primer elemento. Las subcarpetas de la carpeta seleccionada no se pueden asignar. Use el botn "-" para quitar los elementos prescindibles. As se contrae la vista del rbol y se puede reducir el tiempo de procesamiento del documento Flash.
Autenticacin en Xcelsius
Xcelsius ofrece un mecanismo de autenticacin por el cual no tiene que iniciar la sesin en InfoView dos veces con el mismo ID de sesin. Tenga presentes las normas siguientes cuando personalice la autenticacin: Slo se utiliza un ID de sesin existente si el nombre de usuario y la contrasea estn vacos (si no estn codificados ni se han transmitido
69
Consumir consultas como servicios Web con distintas aplicaciones Consumir Query as a Web Service en Crystal Reports
como valores de entrada capturados por un cuadro de dilogo). Esto sucede cuando Query as a Web Service se ejecuta en InfoView o Dashboard Manager. Slo el nombre de usuario y la contrasea no estn vacos, use dichos valores para autenticar al usuario. No se crea ninguna sesin. Como esta situacin es la que se puede aplicar en ms casos, constituye la opcin recomendada para el uso a gran escala. Si no exista ninguna sesin con anterioridad (y el nombre de usuario y la contrasea estn vacos), Xcelsius muestra el cuadro de dilogo de seguridad habitual con el que se crea una sesin. Es lo que ocurre si los diseadores de Xcelsius no crean un cuadro de dilogo de seguridad personalizado.
Consumir Query as a Web Service en Crystal Reports

En esta seccin se explica cmo consume Crystal Reports Query as a Web Service como origen de datos. 1. En la pgina Datos del Asistente para la creacin de informes estndar de Crystal Reports, cree una conexin XML. 2. En la pgina Tipo y ubicacin XML (origen de datos) del cuadro de dilogo XML, seleccione Usar origen de datos de servicio Web y, a continuacin, haga clic en Siguiente. Aparece la pgina Ubicacin del servicio Web. 3. En el campo URL WSDL HTTP, escriba el valor de WSDL para la seleccin de Query as a Web Service. Aparece la pgina Autenticacin. 4. Establezca la autenticacin bsica (si an no lo ha hecho) y, cuando termine, haga clic en Siguiente. Aparece la pgina Servicio Web, puerto y mtodo. 5. Complete la informacin y haga clic en Finalizar. Aparece el cuadro de dilogo Introducir valores.
70
Consumir consultas como servicios Web con distintas aplicaciones Consumir Query as a Web Service en Microsoft Office InfoPath
6. Establezca los parmetros de los servicios Web con la identificacin, la contrasea y las peticiones adecuadas y, luego, haga clic en Aceptar. Vuelve a aparecer la pgina Datos del Asistente para la creacin de informes estndar. 7. Seleccione una de las opciones disponibles y, a continuacin, haga clic en Siguiente. runQueryAsServiceResponse runQueryAsServicetable runQueryAsServicerow Aparece la pgina Campos. 8. Seleccione el campo en el que desee basar la consulta y haga clic en Siguiente. Se crea un informe. 9. Actualizar el informe Ahora, el informe muestra los parmetros correctos.
Consumir Query as a Web Service en Microsoft Office InfoPath

En esta seccin se explica cmo consume Microsoft Office InfoPath Query as a Web Service como origen de datos. 1. En InfoPath, acceda a la lista de tareas Disear un formulario. 2. Haga clic en Nuevo en Conexin de datos. Aparece el Asistente para la conexin de datos. 3. Seleccione Servicio Web y, despus, haga clic en Siguiente. 4. Seleccione Recibir y enviar datos y, a continuacin, haga clic en Siguiente. 5. Escriba o busque el nombre del archivo WSDL y, a continuacin, haga clic en Siguiente. 6. Seleccione la operacin del servicio Web y haga clic en Siguiente. 7. Escriba un nombre para la conexin de datos y, a continuacin, haga clic en Siguiente.
71
Consumir consultas como servicios Web con distintas aplicaciones Consumir Query as a Web Service en Microsoft Office InfoPath
8. Escriba o busque el nombre del servicio Web al que deban enviar sus formularios los usuarios y, a continuacin, haga clic en Siguiente. Aparece la pgina Parmetros.
9. En cada uno de los parmetros, seleccione Formulario completo y, despus, haga clic en Siguiente. 10. Escriba un nombre para la conexin de datos que enva los datos y, a continuacin, haga clic en Siguiente. El formulario de datos aparece en el lado izquierdo y el origen de datos, en el lado derecho. 11. Elabore el formulario y, cuando termine, haga clic en Ejecutar consulta.
72
Descripcin API de llamada del servicio Web
En esta seccin se describen los mtodos generados por una consulta. Query as a Web Service siempre genera los dos mtodos siguientes: runQueryAsAService runQueryAsAServiceEx
Ambos mtodos se corresponden con una llamada de consulta; no obstante, runQueryAsAServiceEx se genera para peticiones de ndice, por lo que hay una diferencia en el tipo de parmetro de entrada Enter_value_s_for_Year_. Este paso se describe a continuacin. Estos dos mtodos siempre requieren el mismo conjunto de parmetros de entrada y producen el mismo conjunto de parmetros de salida, excepto la lista de valores de entrada de peticin, ya que habr tantos parmetros de entrada como peticiones en la consulta. El tercer mtodo generado es valuesOf_Year. Este nombre (as como los nombres de parmetro de peticin) dependen de los nombres de objetos que se utilizan en la consulta, y se generan de forma dinmica. ste tambin se describe en la siguiente tabla: Parmetros de entrada
Tipo cadena cadena Descripcin Informacin de inicio de sesin Informacin de contrasea Establece el patrn de bsqueda en la lista de valores. Puede utilizar los siguientes caracteres comodn en la cadena del patrn: ? : 0 o 1 carcter, * : 0 o n caracteres; por ejemplo, "M?Greggor" encontrar el valor McGreggor, mientras que "M*Greggor" dar como resultado los valores McGreggor y MacGreggor.
Parmetro inicio de sesin Contrasea
searchLOV
cadena
74
Parmetro
Tipo
Descripcin Peticin de valores de ao.
Enter_va lue_s_for_Year_
El mtodo runQueryAsAService requiere la cadena Enter_Year_ Para runQueryAsA- As como valor de peticin para Service: cadena[] el ao.
Para runQueryAsAServiceEx: LovVa- El mtodo runQueryAsAServilueIndex[] ceEx se genera para las peticio-
nes del ndice, por lo que requiere una instancia de LovValueIndex.

Identificador de una sesin de BusinessObjects Enterprise que permite que el servicio Web se conecte al CMS sin datos de inicio de sesin ni contrasea. El servicio Web obtiene el identificador de sesin de la llamada getSessionInfo.
sessionID
cadena
serializedSession
cadena
Permite que el servicio Web se conecte al CMS sin nombre de inicio de sesin ni contrasea mediante una sesin abierta actualmente (sesin en serie). Se puede obtener una sesin en serie de la sesin de plataforma de servicio Web a partir de la llamada getSessionInfo.
Parmetros de salida
75
Parmetro
Tipo
Descripcin La salida de datos es una tabla que consta de un conjunto de filas, cada una de las cuales es una tupla de valores de cada columna. Se trata del equivalente de una tabla vertical en Web Intelligence.
tabla
Tabla
Texto que contiene mensajes o advertencias de

message cadena error que pueden ser generadas por el servidor
al ejecutar la consulta.
creatorname creationdate cadena El nombre del creador de la consulta. dateTi me
La fecha en que se cre la consulta.
La fecha en que se cre la consulta con el formato creationdatefor cadena de la configuracin regional del equipo que se utiliz mated para su creacin. descripcin universo cadena Comentarios cadena Nombre del universo Los metadatos de universo que especifican la duracin del tiempo de ejecucin de la consulta en la base de datos. El nmero de filas devueltas de la base de datos y los metadatos de universo. Devuelve un valor verdadero si el universo define este LOV como bsqueda delegada, por lo que la lista de valores es resuelta por la base de datos con el patrn de entrada de usuarios determinado; de lo contrario, devuelve el valor falso.
queryruntime
int
fetchedrows
int
delegados
boolea no
76
Procedimientos recomendados y limitaciones de Query as a Web Service
Procedimientos recomendados y limitaciones de Query as a Web Service Procedimientos recomendados al usar Query as a Web Service
Procedimientos recomendados al usar Query as a Web Service

Ms sugerencias para usar Query as a Web Service La documentacin de Query as a Web Service se actualiza peridicamente. Si quiere ver la informacin ms reciente, vaya a la biblioteca de documentacin en lnea y utilice el campo de bsqueda para acceder a los procedimientos recomendados de Query as a Web Service. http://support.businessobjects.com/documentation/product_guides/
Limitaciones en el uso de Query as a Web Service

Existen ciertas limitaciones en cuanto al uso de Query as a Web Service. Puede toparse con ellas al crear una consulta o en tiempo de ejecucin.
Limitaciones al crear una consulta
No se pueden usar multicubos No se pueden usar consultas combinadas ni subconsultas No se implementan las peticiones IndexAware (reconocimiento de ndices)
Asimismo, tenga en cuenta que el nombre del servicio Web y sus metadatos estn codificados con el fin de admitir diversos lenguajes de programacin (entre otros, C#, Java, C++, VB o Flash).
Limitaciones en tiempo de ejecucin de una consulta
No se pueden usar restricciones de objetos
78
Ms informacin
Ms informacin
Recurso de informacin
Ubicacin
Informacin del producto SAP Busines- http://www.sap.com sObjects
Seleccione http://help.sap.com > SAP BusinessObjects. Puede acceder a la documentacin ms actualizada sobre todos los productos SAP BusinessObjects y su despliegue en el SAP Help Portal. Puede descargar versiones en PDF o bibliotecas HTML instalables.
SAP Help Portal
Algunos manuales se almacenan en SAP Service Marketplace y no estn disponibles desde SAP Help Portal. Estos manuales aparecen listados en Help Portal junto con un enlace a SAP Service Marketplace. Los clientes con un acuerdo de mantenimiento disponen de una identificacin de usuario registrado para acceder a este sito. Para obtener una identificacin, pngase en contacto con su representante de asistencia al cliente.
80
Ms informacin
Ubicacin
http://service.sap.com/bosap-support > Documentacin

Manuales de instalacin: https://service.sap.com/bo sap-instguides Notas de la versin: http://service.sap.com/releaseno tes
SAP Service Marketplace almacena algunos manuales de instalacin, manuales de actualizacin y migracin, SAP Service Market- de despliegue, notas de las versiones y documentos place de las plataformas compatibles. Los clientes con un acuerdo de mantenimiento disponen de una identificacin de usuario registrado para acceder a este sito. Pngase en contacto su representante de asistencia al cliente para obtener una identificacin. Si se le redirige a SAP Service Marketplace desde SAP Help Portal, utilice el men del panel de navegacin situado a la izquierda para localizar la categora que contiene la documentacin a la que desea acceder. https://boc.sdn.sap.com/
Recursos del desahttps://www.sdn.sap.com/irj/sdn/businessobjects-sdkli rrollador
brary https://www.sdn.sap.com/irj/boc/businessobjects-arti Artculos de SAP BusinessObjects en cles SAP Community Estos artculos se conocan antes como documentos Network tcnicos.
https://service.sap.com/notes
Notas
Estas notas se conocan antes como artculos de Knowledge Base.
81
Ms informacin
Ubicacin
Foros en SAP Comhttps://www.sdn.sap.com/irj/scn/forums munity Network
http://www.sap.com/services/education
Capacitacin
Desde la formacin tradicional en aulas hasta seminarios de e-learning especficos, podemos ofrecer un paquete de formacin que se ajuste a sus necesidades y su estilo preferido de aprendizaje. http://service.sap.com/bosap-support SAP Support Portal contiene informacin acerca de los programas y servicios de asistencia al cliente. Tambin incluye vnculos a un amplio abanico de informacin tcnica y descargas. Los clientes con un acuerdo de mantenimiento disponen de una identificacin de usuario registrado para acceder a este sito. Para obtener una identificacin, pngase en contacto con su representante de asistencia al cliente. http://www.sap.com/services/bysubject/businessob jectsconsulting
Asistencia en lnea al cliente
Consultora
Los consultores pueden acompaarle desde la fase de anlisis inicial hasta la entrega de su proyecto de despliegue. Contamos con expertos en temas como bases de datos relacionales y multidimensionales, conectividad, herramientas de diseo de base de datos y tecnologa de incrustacin personalizada.
82
ndice
A
arquitectura nociones bsicas 9
E
eliminar consultas 41
B
base de datos CMS evitar errores 16
I
iniciar 21 primera vez 20
C
conectarse 20 configurar proxy inverso 62 consultas copiar 41 eliminar 41 copiar procedimiento 41
P
presentacin general 8 proxy inverso configurar 62
Q
Query as a Web Service nociones bsicas 8
D
descripcin de API 74 desplegar servicios web en otro servidor, publicar servicios web en otro servidor 45, 48, 50, 54, 59 documentacin acceder a biblioteca en lnea 78 documentacin en lnea acceder 78
R
runQueryAsAService 74 runQueryAsAServiceEx 74
S
solucin de problemas opciones de tolerancia a errores 16 sugerencias usar Query as a Web Service 78
83
ndice
valuesOf_Year 74
84

Xi31 sp3 Qaaws Es

Cargado por

Información del documento

Título original

Derechos de autor

Formatos disponibles

Compartir este documento

Compartir o incrustar documentos

Opciones para compartir

¿Le pareció útil este documento?

¿Este contenido es inapropiado?

Copyright:

Formatos disponibles

Xi31 sp3 Qaaws Es

Cargado por

Copyright:

Formatos disponibles

Query as a Web Service

SAP BusinessObjects XI3.1 Service Pack 3 windows

Query as a Web Service

Query as a Web Service

Query as a Web Service

Query as a Web Service

Introduccin a Query as a Web Service

Introduccin a Query as a Web Service Qu es Query as a Web Service?

Qu es Query as a Web Service?

Cmo se utiliza Query as a Web Service como solucin empresarial?

Query as a Web Service

Arquitectura de componentes de cliente y servidor de Query as a Web Service

Query as a Web Service

Query as a Web Service

Instalar Query as a Web Service

Requisitos para instalar Query as a Web Service

Para instalar Query as a Web Service

Query as a Web Service

Iniciar Query as a Web Service Administrar hosts

Solucin de problemas de instalacin de Query as a Web Service

Query as a Web Service

Asegrese de que CMS se inicie antes que Tomcat

Cambio del CMS predeterminado

Definir un nuevo CMS predeterminado para Query as a Web Service

Query as a Web Service

4. Indique el nombre de su CMS. 5. Guarde y cierre el archivo dsws.properties. 6. Inicie Tomcat.

Activar seguimientos de servicios Web

Activar seguimientos de servicios Web

Query as a Web Service

Optimizar la disponibilidad de CMS

Query as a Web Service

Optimizacin de consultas en orgenes de datos relacionales para Xcelsius

Activar Xcelsius QaaWS Endpoint

Query as a Web Service

Query as a Web Service

Iniciar Query as a Web Service

Requisitos para iniciar Query as a Web Server

Iniciar Query as a Web Service

Iniciar Query as a Web Service por primera vez

Query as a Web Service

Iniciar Query as a Web Service Iniciar Query as a Web Service

Iniciar Query as a Web Service

Query as a Web Service

Iniciar Query as a Web Service Iniciar Query as a Web Service

Configuracin regional de la interfaz

Query as a Web Service

Iniciar Query as a Web Service Administrar hosts

Iniciar sesin con distintas credenciales de registro

Query as a Web Service

Iniciar Query as a Web Service Administrar hosts

Opcin de administracin de host Agregar

Para agregar un nuevo host

Para editar un host

Query as a Web Service

Iniciar Query as a Web Service Administrar hosts

Query as a Web Service

Iniciar Query as a Web Service Pgina de catlogo de consultas

Pgina de catlogo de consultas

Query as a Web Service

Crear una consulta nueva para publicarla como servicio Web

Crear y publicar una consulta nueva como servicio Web

Query as a Web Service

Crear la consulta utilizando el Panel de consulta.