Download - Query as a Web Service
5/11/2018 Query as a Web Service - slidepdf.com
http://slidepdf.com/reader/full/query-as-a-web-service 1/84
Query as a Web Service
SAP BusinessObjects XI3.1 Service Pack 3
windows
5/11/2018 Query as a Web Service - slidepdf.com
http://slidepdf.com/reader/full/query-as-a-web-service 2/84
© 2010 SAP AG.Reservados todos los derechos. SAP, R/3, SAP NetWeaver,Duet,PartnerEdge,ByDesign, SAPBusiness ByDesign y otros productosy servicios
Copyright
de SAP mencionados, así como sus logotipos respectivos, sonmarcascomercialeso marcas registradas de SAP AG en Alemania y en otros países. Business Objectsy el logotipo de Business Objects, BusinessObjects, Crystal Reports, Crystal
Decisions, Web Intelligence, Xcelsius y otros productos y servicios de BusinessObjects mencionados, así como sus logotipos respectivos, sonmarcascomercialeso marcas registradas de Business Objects S.A. en los Estados Unidos y en otrospaíses. Business Objects es una empresa de SAP. Todos los demás nombres deproductos y servicios mencionados son marcas comerciales de sus respectivasempresas. Los datos de este documento sólo tienen carácter informativo. Lasespecificaciones de productosen cada país puedenserdiferentes. Estos materialespueden modificarse sin previo aviso. Estos materiales los proporciona SAP AG ysus empresas afiliadas ("SAP Group") con carácter informativo, sin representaciónni garantía de ningún tipo y SAP Group no se hace responsable de los errores uomisiones en dichos materiales. Las únicas garantías para los productos y serviciosde SAP Group son aquellas especificadas en los productos y servicios, si las
hubiera. Nada de lo que aparezca en este documento debe interpretarse comogarantía adicional.
2010-05-25
5/11/2018 Query as a Web Service - slidepdf.com
http://slidepdf.com/reader/full/query-as-a-web-service 3/84
ContenidoIntroducción a Query as a Web Service 7Capítulo 1
¿Qué es Query as a Web Service?.............................................................8
Cómo se utiliza Query as a Web Service como solución empresarial?......8
Arquitectura de componentes de cliente y servidor de Query as a WebService.........................................................................................................9
Instalar Query as a Web Service 11Capítulo 2
Requisitos para instalar Query as a Web Service.....................................12
Para instalar Query as a Web Service.......................................................12
Solución de problemas de instalación de Query as a Web Service..........13
Asegúrese 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
Optimización de consultas en orígenes de datos relacionales paraXcelsius.....................................................................................................17
Activar Xcelsius QaaWS Endpoint.......................................................17
Iniciar Query as a Web Service 19Capítulo 3
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 sesión con distintas credenciales de registro............................23
Administrar hosts.......................................................................................23
Para agregar un nuevo host.................................................................24
Query as a Web Service 3
5/11/2018 Query as a Web Service - slidepdf.com
http://slidepdf.com/reader/full/query-as-a-web-service 4/84
Para editar un host...............................................................................24
Página de catálogo de consultas...............................................................26
Crear una consulta nueva para publicarla como servicio Web 27Capítulo 4
Crear y publicar una consulta nueva como servicio Web..........................28
Cómo crear una consulta nueva utilizando el Asistente de publicación deQuery as a Web Service............................................................................28
Para iniciar el Asistente de publicación de Query as a Web Service....29
Definir las propiedades de descripción y nombre de consulta.............30
Seleccionar un universo para una consulta.........................................32
Definir una consulta..............................................................................32Obtener una vista preliminar y publicar una consulta..........................36
Cómo crear una nueva consulta duplicando una ya publicada.................36
Para duplicar una consulta publicada..................................................37
Administrar consultas como servicios Web 39Capítulo 5
Crear carpetas en el catálogo 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
Cómo implementar consultas en otro servidor Web..................................43
La actualización del archivo WSDL cambia en el despliegue deconsultas..............................................................................................44
Implementar en otro servidor utilizando la herramienta cliente Query as
a Web Service......................................................................................45Implementar Query as a Web Service desde el Asistente de importación.............................................................................................................46
Implementar Query as a Web Service desde un archivo BIAR...........47
4 Query as a Web Service
Contenido
5/11/2018 Query as a Web Service - slidepdf.com
http://slidepdf.com/reader/full/query-as-a-web-service 5/84
Actualización de la caché WSDL al desplegar consultas en otroservidor.................................................................................................47
Implementar en otro servidor utilizando la herramienta cliente Query as aWeb Service..............................................................................................48
La actualización del archivo WSDL cambia en el despliegue deconsultas..............................................................................................49
Implementar en otro servidor utilizando la herramienta cliente Query asa Web Service......................................................................................50
Implementar Query as a Web Service desde el Asistente de importación.............................................................................................................51
Implementar Query as a Web Service desde un archivo BIAR...........52
Actualización de la caché WSDL al desplegar consultas en otroservidor.................................................................................................52
Implementar Query as a Web Service desde el Asistente de importación...................................................................................................................53
La actualización del archivo WSDL cambia en el despliegue deconsultas..............................................................................................54
Implementar en otro servidor utilizando la herramienta cliente Query asa Web Service......................................................................................54
Implementar Query as a Web Service desde el Asistente de importación.............................................................................................................55
Implementar Query as a Web Service desde un archivo BIAR...........56
Actualización de la caché WSDL al desplegar consultas en otroservidor.................................................................................................57
Implementar Query as a Web Service desde un archivo BIAR.................57
La actualización del archivo WSDL cambia en el despliegue deconsultas..............................................................................................58
Implementar en otro servidor utilizando la herramienta cliente Query asa Web Service......................................................................................59
Implementar Query as a Web Service desde el Asistente de importación
.............................................................................................................60Implementar Query as a Web Service desde un archivo BIAR...........61
Actualización de la caché WSDL al desplegar consultas en otroservidor.................................................................................................61
Query as a Web Service 5
Contenido
5/11/2018 Query as a Web Service - slidepdf.com
http://slidepdf.com/reader/full/query-as-a-web-service 6/84
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
Consumir consultas como servicios Web con distintasaplicaciones 65
Capítulo 6
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............................................................................69Mensajes de salida...............................................................................69
Autenticación en Xcelsius....................................................................69
Consumir Query as a Web Service en Crystal Reports............................70
Consumir Query as a Web Service en Microsoft Office InfoPath..............71
Descripción API de llamada del servicio Web 73Capítulo 7
Procedimientos recomendados y limitaciones de Query as a Web
Service 77
Capítulo 8
Procedimientos recomendados al usar Query as a Web Service.............78
Limitaciones en el uso de Query as a Web Service..................................78
Más información 79Apéndice A
Índice 83
6 Query as a Web Service
Contenido
5/11/2018 Query as a Web Service - slidepdf.com
http://slidepdf.com/reader/full/query-as-a-web-service 7/84
Introducción a Query as aWeb Service
1
5/11/2018 Query as a Web Service - slidepdf.com
http://slidepdf.com/reader/full/query-as-a-web-service 8/84
¿Qué es Query as a Web Service?
Query as a Web Service es una aplicación de Business Objects que permitea los usuarios de empresas crear y publicar consultas rápidamente comoservicios Web.
Una consulta como servicio Web es una instrucción SQL que se ha creadoen un universo de BusinessObjects y publicado como servicio Web en unservidor host que aloja servicios Web.
La consulta como servicio Web está disponible en cualquier aplicación queutilice servicios Web, y permite a los usuarios acceder a los datos quedevuelva la consulta desde la aplicación. Permite ofrecer información de
Business Intelligence (BI) de forma segura en cualquier aplicación que utiliceservicios 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 permitea los desarrolladores crear servicios Web a partir de consultas específicasde Business Objects.
Cómo se utiliza Query as a Web Service
como solución empresarial?Query as a Web Service permite entregar contenido de BI a cualquier interfazde usuario que pueda procesar servicios Web. Gracias a Query as a WebService, los usuarios de la empresa definen sus propias consultas a partir de un universo concreto para, acto seguido, publicarlas como servicios Webindependientes.
Query as a Web Service se puede utilizar para proporcionar nuevassoluciones de cliente para una empresa. Por ejemplo, Crystal Xcelsius utilizaQuery as a Web Service para agregar varios orígenes de datos distintos en
una vista de BI de confianza.Query as a Web Service también habilita varias soluciones de cliente enherramientas como
• Microsoft Office, Excel e InfoPath.• SAP NetWeaver
8 Query as a Web Service
Introducción a Query as a Web Service1 ¿Qué es Query as a Web Service?
5/11/2018 Query as a Web Service - slidepdf.com
http://slidepdf.com/reader/full/query-as-a-web-service 9/84
• OpenOffice
• Aplicaciones de administración de procesos y reglas de gestión
• Plataformas Enterprise Service Bus
Nota:Business Objects presta un amplio abanico de servicios Web paradesarrolladores. Los desarrolladores usan estos servicios Web en entornosIDE con lenguajes como C# y Java. Para obtener más información, visiteesta página:
http://diamond.businessobjects.com
Arquitectura de componentes de clientey servidor de Query as a Web Service
Query as a Web Service cuenta con un diseño perfecto para trabajar concualquier aplicación para Windows del mismo modo que otros servicios Web.
Query as a Web Service se basa en las especificaciones SOAP, WSDL yXML de W3C para servicios Web. Consta de dos componentes principales:
• Componente de servidor
El componente de servidor (incluidoen BusinessObjects XI R3) almacena
el catálogo de Query as a Web Service y aloja los servicios Webpublicados.
• Herramienta cliente
Se trata de la herramienta en la que los usuarios de la empresa crean ypublican consultas como servicios Web. La herramienta cliente se puedeinstalar en varios equipos que dispongan de acceso al mismo catálogode Query as a Web Service almacenado en el servidor y capacidad paracompartirlo.
Nota:En esta guía, se utiliza el nombre Query as a Web Service para hacer referencia al cliente. Cuando se aporta información que hace referenciaal componente de servidor, se denomina componente de servidor deQuery as a Web Service.
Query as a Web Service 9
1Introducción a Query as a Web Service
Arquitectura de componentes de cliente y servidor de Query as a Web Service
5/11/2018 Query as a Web Service - slidepdf.com
http://slidepdf.com/reader/full/query-as-a-web-service 10/84
El cliente se comunica con los componentes de servidor por medio deservicios Web.
10 Query as a Web Service
Introducción a Query as a Web Service1 Arquitectura de componentes de cliente y servidor de Query as a Web Service
5/11/2018 Query as a Web Service - slidepdf.com
http://slidepdf.com/reader/full/query-as-a-web-service 11/84
Instalar Query as a WebService
2
5/11/2018 Query as a Web Service - slidepdf.com
http://slidepdf.com/reader/full/query-as-a-web-service 12/84
Requisitos para instalar Query as a Web
ServiceAntes de instalar Query as a Web Service, lea el contrato de condicionesde uso y asegúrese de cumplir los siguientes requisitos:
En el servidor debe tener instalado lo siguiente:
• BusinessObjects XI Release 3 Enterprise Edition• Servicios Web
• Tomcat u otra aplicación Web compatible y JDK
Para obtener una lista actualizada de aplicaciones Web y versionescompatibles, visite esta dirección:
http://support.businessobjects.com/supported_platforms/
En el cliente debe tener instalado lo siguiente antes de instalar Query as aWeb Service:
• .NET Framework 2.0. Se necesita para el cliente Query as a Web Serviceque 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 XIRelease 3. Para obtener una lista actualizada de versiones compatibles,visite esta dirección:
http://support.businessobjects.com/supported_platforms/
Para instalar Query as a Web Service
El componente de servidor de Consulta como servicio web se instala demanera automática como parte de BusinessObjects Enterprise XI 3.1 conWeb Intelligence.
12 Query as a Web Service
Instalar Query as a Web Service2 Requisitos para instalar Query as a Web Service
5/11/2018 Query as a Web Service - slidepdf.com
http://slidepdf.com/reader/full/query-as-a-web-service 13/84
A continuación, debe instalar la herramienta cliente Query as a Web Serviceen todos los equipos que vayan a acceder al servidor por medio de losservicios Web. Una vez finalizada la instalación de Consulta como servicioweb, podrá definir un sistema ‘host’ en su primer inicio de sesión. Esto se
describe en el apartado de temas relacionados.Nota:Los usuarios tienen que formar parte de los administradores o de grupos dediseñadores de QaaWS para poder iniciar el cliente Consulta como servicioweb y para usarlo con el objetivo de diseñar consultas.
1. Vaya a la carpeta Add-Ons\Query as a Web Service en el CD decolaterales de BusinessObjects Enterprise o busque el archivo setup.exede Query as a Web Service en la red.
2. Haga doble clic en setup.exe para iniciar el Asistente de Query as a WebService.
3. Siga las instrucciones que aparecen en la pantalla del Asistente deinstalación de Query as a Web Service para completar el procedimientode instalación.
Temas relacionados
• Iniciar Query as a Web Service
• Administrar hosts
Solución de problemas de instalación deQuery as a Web Service
Esta sección contiene información que le ayudará a resolver los posiblesproblemas con la instalación. Consulte los temas vinculados al final de lasección para obtener información referente a cada uno de los siguientesaspectos:
• Asegúrese de que CMS se inicie antes que Tomcat.
• Cambie el CMS predeterminado.• Active el seguimiento de servicios Web.• Optimice la disponibilidad del CMS.
Query as a Web Service 13
2Instalar Query as a Web Service
Solución de problemas de instalación de Query as a Web Service
5/11/2018 Query as a Web Service - slidepdf.com
http://slidepdf.com/reader/full/query-as-a-web-service 14/84
Asegúrese de que CMS se inicie antes que Tomcat
Es importante iniciar CMS antes que Tomcat.
Durante el inicio de Tomcat, en la inicialización de Servlet, la caché deQaaWS lee la definición 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 automáticamente mediante NT Services, no es precisorealizar la operación manualmente.
Cambio del CMS predeterminado
De forma predeterminada, Servicios Web se conecta al CMS con el nombredel ordenador local. Si desea utilizar otro CMS, debe cambiar la propiedadde dominio en el archivo dsws.properties.
Si utiliza un número 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 solución consiste en especificar el puerto nuevo en el archivodsws.properties (ubicado en <RUTA DEINSTALACIÓN>\warfiles\WebApps\dswsbobje\WEB-NF\classes\) con valor de atributo de dominio (dominio=CMSserverName:port).
Esta información complementa la disponible en la documentación de CentralManagement System.
Definir un nuevo CMS predeterminado para Query as a Web
Service
1. Detenga Tomcat.
2. Abra la carpeta de la ruta de instalación de BusinessObjects EnterpriseXI Release 3: [RutaInstalación]\warfiles\webapps\dswsbob
je\WEB-INF\classes
3. Abra el archivo dsws.properties y localice: domain=
14 Query as a Web Service
Instalar Query as a Web Service2 Solución de problemas de instalación de Query as a Web Service
5/11/2018 Query as a Web Service - slidepdf.com
http://slidepdf.com/reader/full/query-as-a-web-service 15/84
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 algún problema de configuración, puede que el administrador deBusiness Objects tenga que definir opciones de seguimiento para facilitar las tareas de solución de problemas.
Business Objects recomienda encarecidamente el uso de seguimiento únicay exclusivamente con fines de solución de problemas en entornos de prueba.
Activar seguimientos de servicios Web
1. En el Administrador de configuración central (CCM), detenga el servicio"Apache Tomcat 5.5.20".
2. Cambiar el nivel de seguimiento.
De modo predeterminado, Query as a Web Service sólo realiza elseguimiento de errores. Puede que tenga que suministrar seguimientosadicionales para satisfacer los requisitos del cliente.
3. Edite log4j.properties ubicado en [rutainstalación]\dswsbobje\WEB-INF\classes\
4. Escriba lo siguiente en el archivo de propiedades:log4j.log
ger.com.businessobjects=DEBUG, BO1
5. Cambie la ubicación de seguimiento.
De modo predeterminado, el seguimiento se realiza en la salida deconsola de salida. Si desea realizar el seguimiento de un archivo, añadauna marca de comentario a ConsoleAppender y quite dicha marca deRollingFileAppender. Si Tomcat se ha definido como servicio, el
seguimiento se registrará en dswsbobje.log, en la ruta C:\WINDOWS\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
Query as a Web Service 15
2Instalar Query as a Web Service
Solución de problemas de instalación de Query as a Web Service
5/11/2018 Query as a Web Service - slidepdf.com
http://slidepdf.com/reader/full/query-as-a-web-service 16/84
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 sólo puede tener una base de datos de sistema CMS. Laconexión con la base de datos de sistema CMS podría perderse por una deestas 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 aplicación o el
equipo CMS.
En cualquiera de estos casos, la implementación de dos CMS reduce elriesgo de que ambos CMS pierdan la conexión con la base de datos desistema CMS ubicada en el equipo CMS.
Sin embargo, si la base de datos de sistema CMS está fuera de servicio,ningún sistema CMS podrá procesar sin errores las solicitudes entrantes,tanto con un solo CMS como con varios en el clúster.
Puede limitar riesgos utilizando las soluciones de tolerancia a erroressuministradas por el proveedor de la base de datos. Todos los proveedoresde bases de datos proporcionan soluciones de tolerancia a errores a fin deminimizar la falta de disponibilidad de una base de datos. Una solución detolerancia a errores puede ser la creación de una base de datos reflejadasecundaria que se ejecute en un servidor secundario. Por ejemplo, si laprimera base de datos está fuera de servicio, el archivo tns.ora se actualizaautomáticamente para señalar hacia el servidor de base de datos secundario.Puesto que las medidas de tolerancia a errores son específicas de cadabase de datos, en caso de necesitar más información tendrá que consultar
la documentación relativa a la que utiliza usted.Nota:Si la función está disponible y activada, aunque se pierda la conexión debase de datos del sistema, el CMS la restablecerá automáticamente sin quetenga que intervenir el administrador.
16 Query as a Web Service
Instalar Query as a Web Service2 Solución de problemas de instalación de Query as a Web Service
5/11/2018 Query as a Web Service - slidepdf.com
http://slidepdf.com/reader/full/query-as-a-web-service 17/84
Optimización de consultas en orígenesde datos relacionales para Xcelsius
Puedebeneficiarsede dosnuevosservidores de Xcelsius QaaWSdisponiblesen este Service Pack para optimizar solicitudes de Consulta como servicioWeb en orígenes de datos relacionales desde Xcelsius. Los servidores sonlos 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 comocon la instalación de la revisión. Debe activar manualmente los servidoresy Xcelsius QaaWS Endpoint en el servidor de aplicaciones web paraimplementar la optimización de consultas.
En esta sección se describe cómo activar Xcelsius QaaWS Endpoint despuésde la instalación, y cómo activar los servidores. Xcelsius QaaWS Endpointredirecciona las solicitudes relacionales de Xcelsius QaaWS a los nuevosservidores de Xcelsius QaaWS.
La instalación y configuración de los nuevos servidores se describe en ladocumentación de instalación del Service Pack.
Consulte la documentación Novedades de este Service Pack para obtener una descripción completa de los nuevos servidores y las ventajas disponiblespara los usuarios de Xcelsius que usan solicitudes de Consulta como servicioweb en orígenes de datos relacionales.
Activar Xcelsius QaaWS Endpoint
Antes de activar Xcelsius QaaWS Endpoint para optimizar las solicitudesde Consulta como servicio webdesde Xcelsius,debe completar los siguientespasos:
• Instale el Service Pack 3 de SAP BusinessObjects Enterprise (XI 3.1SP3). Si solamente desea instalar la revisión, deberá registrar los nuevos
Query as a Web Service 17
2Instalar Query as a Web Service
Optimización de consultas en orígenes de datos relacionales para Xcelsius
5/11/2018 Query as a Web Service - slidepdf.com
http://slidepdf.com/reader/full/query-as-a-web-service 18/84
servidores de Xcelsius. Esta información se encuentra en ladocumentación de instalación.
• Cree los nuevos servidores en la Consola de administración central(CMC). Consulte la documentación de la Consola de administracióncentral para obtener información 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 enlos nuevos servidores. Así se optimiza el número de consultas que puedeadministrar la Consulta como servicio Web para usuarios de Xcelsius.
1. Detenga el servidor de aplicaciones.
2. Busque y abra el archivo /DSWSBOBJE_INSTALLDIR/WEB-
INF/web.xml.
3. Agregue la siguiente información:<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 deXcelsius están preparados para procesar cualquier solicitud de Consultacomo servicio Web.
18 Query as a Web Service
Instalar Query as a Web Service2 Optimización de consultas en orígenes de datos relacionales para Xcelsius
5/11/2018 Query as a Web Service - slidepdf.com
http://slidepdf.com/reader/full/query-as-a-web-service 19/84
Iniciar Query as a WebService
3
5/11/2018 Query as a Web Service - slidepdf.com
http://slidepdf.com/reader/full/query-as-a-web-service 20/84
Requisitos para iniciar Query as a Web
ServerAsegúrese de cumplir los siguientes requisitos antes de iniciar Query as aWeb Service:
DescripciónRequisitos para el inicio
La pertenencia a un grupo de usuariose define en Central ManagementConsole. Si necesita que se le incluyaen este grupo de usuarios, consulte a
su administrador.
Usuario registrado comoadministrador o definido en el Diseñador de grupo deQaaWS.
Iniciar Query as a Web Service
Query as a Web Service se utiliza con Central Management System (CMS).CMS contiene el componente de servidor que almacena el catálogo de Queryas a Web Service y aloja los servicios Web publicados.
Cuando inicia Query as a Web Service por primera vez, debe definir elservidor de host antes de empezar.
Cuando inicie Query as a Web Service posteriormente, seleccionará unservidor de host disponible y luego iniciará sesión en CMS.
Después de haber iniciado sesión, se abrirá la página del catálogo deconsultas de Query as a Web Service. En esta página, puede iniciar elasistente para la creación y publicación 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 unservidor host en CMS en el que estén instalados los servicios Web. Una vezdefinido un servidor host, estará disponible automáticamente la próxima vez
20 Query as a Web Service
Iniciar Query as a Web Service3 Requisitos para iniciar Query as a Web Server
5/11/2018 Query as a Web Service - slidepdf.com
http://slidepdf.com/reader/full/query-as-a-web-service 21/84
que inicie Query as a Web Service. Puede definir varios servidores host,pero no se pueden conectar más de uno a la vez.
1. Inicie Query as a Web Service.
Se abrirá el cuadro de diálogo "Administrar hosts". Este cuadro de diálogoenumera los servidores host disponibles y permite agregar nuevosservidores y editar los que ya existen. La primera vez que se inicia Queryas a Web Service la lista está vacía. En primer lugar, debe definir unservidor host.
2. Haga clic en Agregar .
Aparece el cuadro de diálogo "Editar un host". Este cuadro contiene losparámetros que se definen para crear un servidor host. Consulte elapartado de temas relacionados para obtener una descripción de todoslos parámetros.
3. Especifique la información necesaria en el cuadro de diálogo "Editar unhost".
4. Haga clic en Aceptar.
Se abrirá el cuadro de diálogo "Administrar hosts". Se enumerará el nuevohost.
5. Seleccione el nuevo host y haga clic en Cerrar .
Se abrirá el cuadro de diálogo "Seleccione sus credenciales". Estarádisponible la información siguiente del nuevo host.
6. Especifique su contraseña y haga clic en Aceptar .Se abrirá la página de inicio de cliente Query as a Web Service.
Iniciar Query as a Web Service
Antes de iniciar Query as a Web Service, asegúrese de cumplir los siguientesrequisitos. Consulte los temas relacionados para obtener más información.
• El nombre de usuario debe estar en el grupo de usuarios Diseñador de
grupo de QaaWS o debe haber iniciado sesión 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 WebService o en cualquier momento, agregando un host en el cuadro dediálogo "Editar un host".
Query as a Web Service 21
3Iniciar Query as a Web ServiceIniciar Query as a Web Service
5/11/2018 Query as a Web Service - slidepdf.com
http://slidepdf.com/reader/full/query-as-a-web-service 22/84
Inicie Query as a Web Service seleccionando un servidor host y especificandola información de registro en el cuadro de inicio de sesión. Tiene lossiguientes campos de registro:
DescripciónInformación de iniciode sesión
Servidor de CMS que almacenan los servicios Webde consultas. Debe definir un servidor host para po-der crear una consulta.
Host
Servidor Central Management Server (CMS) quealoja el servidor host.
Sistema
Nombre de usuario. Debe ser miembro del grupo deusuarios Diseñador de grupo de QaaWS o un admi-nistrador.
Usuario
Contraseña de usuario. La asigna el administrador.Contraseña
Tipo de servicio de autenticación necesario para ac-ceder a CMS. Esta información la facilita el adminis-trador. Están disponibles los siguientes protocolos:• Enterprise
• LDAP
• Windows AD
Autenticación
Seleccione esta opción si el protocolo de autentica-ción admite el inicio de sesión único. Esta opciónsólo está disponible para Active Directory de Win-dows.
Habilitar Inicio de sesiónúnico del Directorio deWindows Active
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.
Configuración regionalde la interfaz
1. En el menú Inicio de Windows, seleccione Programas > BusinessObjects XI Release 3 > BusinessObjects Enterprise > Query As AWeb Service
22 Query as a Web Service
Iniciar Query as a Web Service3 Iniciar Query as a Web Service
5/11/2018 Query as a Web Service - slidepdf.com
http://slidepdf.com/reader/full/query-as-a-web-service 23/84
Se abrirá el cuadro de inicio de sesión.
2. Seleccione un nombre de servidor host en la lista desplegable de hosts.
3. Especifique la información de sistema, nombre de usuario y contraseña.
4. Haga clic en Opciones.El cuadro de inicio de sesión mostrará las opciones Autenticación, Iniciode sesión único y Configuración regional de la interfaz.
5. Seleccione la información de inicio de sesión.
6. Haga clic en Aceptar.
Se abrirá el catálogo de consultas. En esta página puede crear, publicar y administrar consultas como servicios Web.
Iniciar sesión con distintas credenciales de registro
Puede iniciar sesión en Query as a Web Service como nuevo usuario sinsalir de la aplicación.
• Seleccione Herramientas > Conectar como
Se abrirá el cuadro de inicio de sesión. Introduzca la nueva informaciónde usuario y haga clic en Aceptar.
Administrar hostsUn host es un componente de servidor de CMS que almacena el catálogode Query as a Web Service y aloja los servicios Web publicados. Se creaun host al iniciar Query as a Web Service por primera vez. Puede agregar un host a CMS y configurar los parámetros de conexión para los hostsexistentes desde el cuadro de diálogo "Administrar hosts".
Al cuadro de diálogo "Administrar hosts" se accede desde el menúHerramientas o desde el cuadro de inicio de sesión al abrir Query as a WebService.
El cuadro de diálogo "Administrar hosts" enumera los servidores host. Tienelas siguientes opciones de administración de host:
Query as a Web Service 23
3Iniciar Query as a Web Service
Administrar hosts
5/11/2018 Query as a Web Service - slidepdf.com
http://slidepdf.com/reader/full/query-as-a-web-service 24/84
DescripciónOpción de administración de host
Haga clic para definir un nuevo host.Agregar
Seleccione un nombre de host en lalista y haga clic para editar la definicióndel host.
Editar
Seleccione un nombre de host y hagaclic para eliminarlo de la lista.
Eliminar
Haga clic para eliminar todos los hostsde la lista.
Borrar
Para agregar un nuevo host
Puede agregar un nuevo host en el cuadro de diálogo "Administrar hosts".
1. Seleccione Herramientas > Administrar hosts.
Se abrirá el cuadro de diálogo "Administrar hosts".
Nota:
También puede acceder al cuadro de diálogo "Administrar hosts" desdeel cuadro de registro al iniciar sesión en Query as a Web Service.
2. Haga clic en el botón Añadir .
Aparece el cuadro de diálogo "Editar un host".
3. Especifique información sobre los parámetros de host y haga clic enAceptar .
El host se añadirá a la lista del cuadro de diálogo "Administrar hosts".
4. Haga clic en Cerrar .
Para editar un host
Edite una definición de host en el cuadro de diálogo "Editar un host". Puedeeditar los siguientes parámetros de host:
24 Query as a Web Service
Iniciar Query as a Web Service3 Administrar hosts
5/11/2018 Query as a Web Service - slidepdf.com
http://slidepdf.com/reader/full/query-as-a-web-service 25/84
DescripciónParámetros de edición de host
Nombre del servidor host. Es el nombre que
aparece en el campo Host del cuadro de ini-cio de sesión.Nombre
La dirección URL del servidor host. Se espe-cifica automáticamente una dirección URLpredeterminada para el host. Puede editar ladirección URL si es preciso. Debe comprobar que la dirección de puerto de la dirección URLsea correcta.
Dirección URL
Nombre del CMS que aloja el host. Es el
nombre que aparece en el campo Sistemadel cuadro de inicio de sesión.
CMS
Estos parámetros se describen en la sección"Iniciar Query as a Web Service" del apartadode temas relacionados.
• Usuario• Autenticación• Habilitar inicio de sesión
único del Directorio deWindows Active
1. Seleccione Herramientas > Administrar hosts.
Se abrirá el cuadro de diálogo "Administrar hosts".
Nota:También puede acceder al cuadro de diálogo "Administrar hosts" desdeel cuadro de registro al iniciar sesión en Query as a Web Service.
2. Haga clic en un host de la lista.
3. Haga clic en el botón Editar .
Aparece el cuadro de diálogo "Editar un host". Contiene los parámetros
que se pueden editar para el host.4. Especifique o modifique uno o más valores.
5. Haga clic en Aceptar y, a continuación, en Cerrar .
Se abrirá el cuadro de inicio de sesión. Las modificaciones en el host seaplican al instante.
Query as a Web Service 25
3Iniciar Query as a Web Service
Administrar hosts
5/11/2018 Query as a Web Service - slidepdf.com
http://slidepdf.com/reader/full/query-as-a-web-service 26/84
Página de catálogo de consultas
La página de catálogo de consultas aparece al iniciar Query as a Web Server.Incluye las consultas publicadas en el servidor host y el universo que utilizacada consulta. Por cada consulta seleccionada en la lista, se enumeran enel panel de información de la derecha el nombre, el nombre de universo, ladescripción y la dirección URL de la descripción WSDL de la consultaseleccionada.
En la página de catálogo de consultas, puede crear y publicar nuevasconsultas, así como administrar las consultas ya publicadas en el servidor host.
En dicha página, puede realizar las acciones siguientes:
Acciones disponiblesMenú
• Crear una nueva consulta y crear carpetas en la lista decatálogo para almacenar y organizar las consultas.
• Editar la definición 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 edición estándar de WindowsCortar, Copiar y Pegar.
Editar
• Acceder al cuadro de diálogo "Administrar hosts" paraagregar, editar y eliminar servidores host.
• Cerrar sesión e iniciarla como otro usuario o en un hostdiferente sin cerrar la aplicación.
• Acceder al cuadro de diálogo de parámetros avanzadospara configurar la dirección URL, los límites de tiempo de
espera y el modo de autenticación de la consulta.
Herramientas
26 Query as a Web Service
Iniciar Query as a Web Service3 Página de catálogo de consultas
5/11/2018 Query as a Web Service - slidepdf.com
http://slidepdf.com/reader/full/query-as-a-web-service 27/84
Crear una consulta nuevapara publicarla comoservicio Web
4
5/11/2018 Query as a Web Service - slidepdf.com
http://slidepdf.com/reader/full/query-as-a-web-service 28/84
Crear y publicar una consulta nueva como
servicio WebPuede crear una consulta para publicar como servicio Web de dos modos:
• Utilice el "Asistente de publicación de Query as a Web Service" paradefinir una consulta desde cero.
• Duplique una consulta existente para utilizarla como plantilla de definición,y modifique su definición para crear una nueva consulta.
Cómo crear una consulta nueva utilizandoel Asistente de publicación de Query asa Web Service
Utilice el "Asistente de publicación 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 secciónsobre cómo duplicar una consulta publicada en el apartado de temasrelacionados.
Puede crear y publicar una consulta siguiendo el procedimiento que sedescribe. Consulte los temas al final de la página para acceder directamentea la página de la Ayuda que se corresponde con el paso del asistente. Cadapágina de Ayuda describe por completo las propiedades establecidas en lapágina del asistente actual.
Tabla 4-1: Flujo de trabajo de creación y publicación de consultas utilizando el asistente
DescripciónFlujo de trabajo de creación y publi-cación de consultas
Inicie el asistente desde la página decatálogo de consultas. Es la páginaque aparece al iniciar sesión en unhost.
Iniciar el "Asistente de publicación deQuery as a Web Service"
28 Query as a Web Service
Crear una consulta nueva para publicarla como servicio Web4 Crear y publicar una consulta nueva como servicio Web
5/11/2018 Query as a Web Service - slidepdf.com
http://slidepdf.com/reader/full/query-as-a-web-service 29/84
DescripciónFlujo de trabajo de creación y publi-cación de consultas
Escriba el nombre y los comentariospara la consulta.
Definir el nombre y la descripción dela nueva consulta.
Puede definir los parámetros para usode proxy inverso, las restricciones detiempo de espera y el tipo de autentica-ción.
Configurar las propiedades avanzadas
Seleccione el universo que contengalos objetos que se utilizarán en la con-sulta. El universo es el origen de datosde la consulta.
Elegir un universo como origen de da-tos para la consulta.
La consulta se crea utilizando el Panelde consulta para combinar las dimen-siones y las medidas, así como paradefinir las condiciones de la consulta.
Crear la consulta utilizando el Panelde consulta.
Obtenga una vista preliminar de laconsulta SQL y publíquela como servi-cio Web en el servidor host.
Obtener una vista preliminar y publicar la nueva consulta como servicio Web.
Para iniciar el Asistente de publicación de Query asa Web Service
Utilice el "Asistente de publicación de Query as a Web Service" para crear y publicar una nueva consulta. Inicie el asistente desde la página de catálogode consultas. Cada página del asistente cuenta con una página de Ayuda.
1. Inicie Query as a Web Service.
Se abrirá el catálogo de consultas. Enumera los servicios Web deconsultas actuales almacenados en el servidor host.
2. Seleccione Consulta > Nuevaconsulta.
Se abrirá la página "Descripción" del "Asistente de publicación de Queryas a Web Service". En esta página puede especificar el nombre, ladescripción y los parámetros avanzados.
Query as a Web Service 29
4Crear una consulta nueva para publicarla como servicio Web
Cómo crear una consulta nueva utilizando el Asistente de publicación de Query as a Web Service
5/11/2018 Query as a Web Service - slidepdf.com
http://slidepdf.com/reader/full/query-as-a-web-service 30/84
Definir las propiedades de descripción y nombre deconsulta
En la página "Descripción" del "Asistente de publicación de Query as a WebService", especifique un nombre y una descripción para la nueva consultaque se publicará como servicio Web.
1. Especifique un nombre y una descripción para la consulta.
2. Realice una de las siguientes acciones:
• Si desea definir los parámetros para el uso de proxy inverso, lasrestricciones de tiempo de espera de sesión o el tipo de autenticación,haga clic en el botón Parámetros avanzados.
• Si no desea configurar los parámetros avanzados, haga clic enSiguiente.
En función de su elección, se abrirá el cuadro de diálogo de parámetrosavanzados o la siguiente página del asistente "Seleccionar un universo".
Definir parámetros avanzados de servicio Web
Puede definir los parámetros siguientes en el cuadro de diálogo "Parámetrosavanzados":
• Uso de proxy inverso con una dirección URL base del servicio Web• Restricciones de tiempo de espera de sesión• Modo de autenticación utilizado para consumidores de servicios Web.
Este parámetro sólo se aplica al servicio Web cuando se consume.
Cada una de estas opciones se describe en los temas indicados al final dela sección.
1. Haga clic en el botón Avanzado de la página "Descripción" del "Asistentede publicación de Query as a Web Service".
Se abrirá el cuadro de diálogo Parámetros avanzados.2. Realice una de las siguientes acciones:
• Edite o escriba una nueva dirección URL base del servicio Web.• Escriba o utilice las flechas arriba y abajo para especificar un nuevo
valor para la restricción de tiempo de espera de sesión.• Seleccione un modo de autenticación en la lista desplegable.
30 Query as a Web Service
Crear una consulta nueva para publicarla como servicio Web4 Cómo crear una consulta nueva utilizando el Asistente de publicación de Query as a Web Service
5/11/2018 Query as a Web Service - slidepdf.com
http://slidepdf.com/reader/full/query-as-a-web-service 31/84
3. Haga clic en Aceptar .
Se abrirá la página Descripción. Continuará definiendo la consulta enesta página.
Dirección URL base del servicio Web
El proxy inverso es la traducción de la dirección de red de un equipo de unaURL de la red indicada a otra URL de otra red, por lo general, una red externay pública como Internet.
Un servidor denominado miservidor.empresa.esdeuna red deempresase podría denominar www.miempresa.es en la red externa.
Para que se admita este tipo de despliegue, debe configurar una direcciónURL base de los servicios Web. La dirección URL base contiene la dirección
URL externa desde la que se debe franquear el acceso al servicio Web, por ejemplo, www.miempresa.es/dswsbobje/.
Tiempo de espera de sesión
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 almacenaen caché la conexión del usuario al servidor. Se puede configurar el tiempode espera de la sesión (en segundos) para cada conexión de Query as aWeb Service. El valor predeterminado es de 60 segundos.
Por ejemplo, si un usuario concreto llama al servicio 1 y, en menos de 60segundos, llama al servicio 2 con los mismos datos (nombre de usuario ycontraseña idénticos), el servidor reutiliza la conexión y reinicializa el tiempode espera de la sesión.
Modo de autenticación
El modo de autenticación indica el tipo de directorio con el que la plataformaBusinessObjects XI valida el inicio de sesión.
Algunos ejemplos son Enterprise, LDAP, Windows AD o SAP.
Puede establecer el modo de autenticación para que se defina según elservicio o para que lo haga el consumidor:
• Servicio
Query as a Web Service 31
4Crear una consulta nueva para publicarla como servicio Web
Cómo crear una consulta nueva utilizando el Asistente de publicación de Query as a Web Service
5/11/2018 Query as a Web Service - slidepdf.com
http://slidepdf.com/reader/full/query-as-a-web-service 32/84
El administrador se ocupa de seleccionar el directorio de autenticación;todos los usuarios que accedan en lo sucesivo al servicio se autenticanen dicho directorio (excepto la opción sessionID).
Todos los directorios de autenticación compatibles con el servidor seencuentran disponibles para la selección en la lista desplegable Modode autenticación.
• Definido por el consumidor
El consumidor de la consulta selecciona el modo de autenticación en elparámetro de entrada authenticationType.
Seleccionar un universo para una consulta
La página "Seleccionar un universo" del "Asistente de publicación de Queryas 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 descripción aparece una descripción del universoseleccionado.
2. Haga clic en Siguiente.
Se abrirá la página "Consulta" del asistente.
Definir una consulta
La página "Consulta" del "Asistente de publicación de Query as a WebService" permite utilizar un panel de consultas para definir una consultabasada en un universo. El panel de consulta se basa en el "panel de consultaHTML de Web Intelligence". En esta sección se describe brevemente el
panel de consulta y se incluyen instrucciones para crear una consulta. Noobstante, el panel de consulta se describe detalladamente en la guíaElaboración de consultas mediante Consulta - HTML de Web Intelligence.Para obtener información adicional, consulte esta guía en la documentaciónde esta versión.
El panel de consulta contiene las siguientes áreas:
32 Query as a Web Service
Crear una consulta nueva para publicarla como servicio Web4 Cómo crear una consulta nueva utilizando el Asistente de publicación de Query as a Web Service
5/11/2018 Query as a Web Service - slidepdf.com
http://slidepdf.com/reader/full/query-as-a-web-service 33/84
DescripciónÁrea del panel de consulta
Panel a la izquierda del panel de consulta que
contiene las clases, dimensiones y medidas deluniverso organizado en una estructura de árbol.Estos objetos se asignan a estructuras SQL dela base de datos. La consulta se crea utilizandoestos objetos.
Ventana Universo
Arrastre los objetos de la consulta a este panel.Puede aplicar un orden a los datos para cadaobjeto haciendo clic con el botón derecho en unobjeto y seleccionando el tipo de orden.
Panel Objetos del resultado
Arrastre los objetos para definir un filtro que limi-te los datos que devolverá la consulta. Puedeseleccionar los operadores de una lista, aplicar un filtro utilizando una constante o una lista devalores o definir una petición para la entrada deusuario.
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 arrástrelos al panel "Objetos del resultado".
Los objetos de consulta aparecen alineados en el panel "Objetos delresultado". Puede cambiar el orden de un objeto de la consultaseleccionándolo y arrastrándolo a la posición deseada. Puede eliminar cualquier objeto seleccionándolo y arrastrándolo de nuevo al panel"Universo".
2. Si desea crear un filtro, haga doble clic o arrastre un objeto de filtro alpanel "Filtrar objetos".
El objeto se asocia automáticamente con una lista desplegable de
operadores, un cuadro de texto de una constante y una lista desplegablede valores o una petición.
3. Seleccione un operador y elija el filtro deseado en las listas desplegables.En la sección de temas relacionados se describen los filtros disponibles.
4. Haga clic en Aceptar .
Aparece la página "Vista preliminar" del asistente.
Query as a Web Service 33
4Crear una consulta nueva para publicarla como servicio Web
Cómo crear una consulta nueva utilizando el Asistente de publicación de Query as a Web Service
5/11/2018 Query as a Web Service - slidepdf.com
http://slidepdf.com/reader/full/query-as-a-web-service 34/84
Definir restricciones de consultas
Puede definir restricciones para optimizar el rendimiento de las consultas.Puede definir las siguientes restricciones:
DescripciónRestricción
Si se selecciona, permite devolver filasduplicadas. De modo predeterminado, laconsulta no devuelve filas duplicadas.
Filas duplicadas
Tiempo máximo permitido para la recupe-ración de datos. El valor predeterminado
"-1" indica que esta opción está desactiva-da y que se aplica el valor establecido enlos parámetros de conexión de universo.
Tiempo máximo de búsqueda
Número máximo de filas que puede devol-ver una consulta. El valor predeterminado"-1" indica que esta opción está desactiva-da y que se aplica el valor establecido enlos parámetros de conexión de universo.
Número máximo de filas devueltas
El número de filas que se debe devolver para un conjunto de resultados de ejemploantes de ejecutar la consulta.
Conjunto de resultados de ejemplo
1. En el panel de consulta, haga clic en el icono de opciones en la partesuperior izquierda de la página.
Aparecerá un cuadro de diálogo con las opciones de restricción deconsultas.
2. Defina los valores de restricciones necesarios.
3. Haga clic en Aceptar .
34 Query as a Web Service
Crear una consulta nueva para publicarla como servicio Web4 Cómo crear una consulta nueva utilizando el Asistente de publicación de Query as a Web Service
5/11/2018 Query as a Web Service - slidepdf.com
http://slidepdf.com/reader/full/query-as-a-web-service 35/84
Definir el orden de clasificación de las peticiones
Puede definir un orden para cada objeto del universo. También puede definir una prioridad de ordenación para un objeto.
1. Enel panel de consultas, haga clic en el icono Administrar ordenacionesencima del panel "Universo".
Aparecerá un cuadro de diálogo con las opciones de ordenación.
2. Expanda las carpetas del panel "Objetos disponibles" y seleccione unobjeto.
3. Haga doble clic en el objeto o en la flecha para colocar el objeto en elpanel "Ordenaciones de la consulta".
4. Seleccione el objeto en el panel "Ordenaciones de la consulta" y hagaclic en Ascendenteo Descendente.
5. Si es preciso, seleccione un objeto y haga clic en los botones Subir oBajar .
6. Haga clic en Aceptar .
Definir listas de valores
Las listas de valores se definen seleccionando el objeto en la página de
consultas y luego definiendo la lista de valores en una página de lista devalores.
1. En la página de consultas, arrastre un objeto al panel Filtrar objetos.
Aparecerá un cuadro de texto flanqueado por dos filtros de listasdesplegables.
2. En la lista desplegable de la izquierda del cuadro de texto, seleccioneEn la lista y, a continuación, elija Lista de valores en la lista desplegablede la derecha del cuadro.
Aparece el cuadro de diálogo Lista de valores.
3. Haga doble clic en cada valor del panel de lista que desee que aparezcaen la lista de valores. El valor aparecerá en el panel Valoresseleccionados.
4. Haga clic en Aceptar.
Los valores aparecerán en el cuadro de texto.
Query as a Web Service 35
4Crear una consulta nueva para publicarla como servicio Web
Cómo crear una consulta nueva utilizando el Asistente de publicación de Query as a Web Service
5/11/2018 Query as a Web Service - slidepdf.com
http://slidepdf.com/reader/full/query-as-a-web-service 36/84
Definir peticiones
Una petición se define seleccionando el objeto en la página de consultas yluego abriendo una página de peticiones para definirla.
1. En la página de consultas, arrastre un objeto de petición al panel Filtrar objetos.
Aparecerá un cuadro de texto flanqueado por dos filtros de listasdesplegables.
2. Seleccione Petición en la lista desplegable que hay a la derecha delcuadro de texto.
Aparecerá un icono de petición.
3. Haga clic en el icono de petición.Aparecerá un cuadro para definir una petición. Escriba el texto que deseeincluir en la petición y seleccione las opciones que se aplicarán a lamisma.
4. Haga clic en Aceptar.
Obtener una vista preliminar y publicar una consulta
La página "Vista preliminar" del "Asistente de publicación de Query as aWeb Service" permite obtener una vista preliminar de los objetos de laconsulta y la tabla de resultados. Cuando esté satisfecho con la vistapreliminar, podrá publicar la consulta como servicio Web en el servidor host.
1. Compruebe que el universo, los objetos y el resultado de la consulta seancorrectos.
2. Haga clic en Publicar .
La consulta se publicará en el servidor host como servicio Web. Se incluiráen la página de catálogo de consultas.
Cómo crear una nueva consultaduplicando una ya publicada
Puede crear una nueva consulta para publicar duplicando una consultapublicada y utilizándola como plantilla. Una vez duplicada la consulta, se
36 Query as a Web Service
Crear una consulta nueva para publicarla como servicio Web4 Cómo crear una nueva consulta duplicando una ya publicada
5/11/2018 Query as a Web Service - slidepdf.com
http://slidepdf.com/reader/full/query-as-a-web-service 37/84
iniciará automáticamente el "Asistente de publicación de Query as a WebService", y podrá modificar la definición del mismo modo en que se creauna nueva consulta con el asistente.
Debe tener los permisos de usuario pertinentes para copiar una consulta enuna carpeta y agregar una consulta nueva a otra carpeta.
Para duplicar una consulta publicada
Puede duplicar una consulta para crear una nueva definición de consultadel modo siguiente:
1. Realice una de las siguientes acciones:
• Seleccione una consulta en la página de catálogo de consultas y elijaConsulta > Duplicar .
• Haga clic con el botón derecho en la lista del catálogo de consultasy seleccione "Duplicar" en la lista.
Se abrirá el "Asistente de publicación de Query as a Web Service".
2. Siga los pasos del asistente para cambiar el nombre y modificar ladefinición de consulta.
Query as a Web Service 37
4Crear una consulta nueva para publicarla como servicio WebCómo crear una nueva consulta duplicando una ya publicada
5/11/2018 Query as a Web Service - slidepdf.com
http://slidepdf.com/reader/full/query-as-a-web-service 38/84
38 Query as a Web Service
Crear una consulta nueva para publicarla como servicio Web4 Cómo crear una nueva consulta duplicando una ya publicada
5/11/2018 Query as a Web Service - slidepdf.com
http://slidepdf.com/reader/full/query-as-a-web-service 39/84
Administrar consultas comoservicios Web
5
5/11/2018 Query as a Web Service - slidepdf.com
http://slidepdf.com/reader/full/query-as-a-web-service 40/84
Crear carpetas en el catálogo de consultas
Puede crear carpetas en la página de catálogo de consultas para organizar las consultas de la lista.
• En la página de catálogo de consultas, lleve a cabo una de las siguientesacciones:
• Haga clic en la carpeta root y seleccione Consulta > Nueva carpeta.• Haga clic con el botón derecho en la carpeta raíz 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 definición de una consulta que se haya publicado comoservicio Web en cualquier momento. Al editar una consulta como servicioWeb, se puede alterar el “WSDL” asociado, lo que podría romper el vínculoque emplean otros usuarios para comunicarse con los servicios Web.
Business Objects le aconseja que notifique a los usuarios todos los cambiosque realice.
1. En el catálogo 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 botón derecho en una consulta y elija "Editar" en la
lista del catálogo.
Se abrirá el "Asistente de publicación de Query as a Web Service".
3. Siga los pasos del asistente para editar la consulta y volver a publicarlamás adelante.
Para cambiar el nombre a una consulta
Puede cambiar el nombre de una consulta en el catálogo de consultas. Elnuevo 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 Query as a Web Service
Administrar consultas como servicios Web5 Crear carpetas en el catálogo de consultas
5/11/2018 Query as a Web Service - slidepdf.com
http://slidepdf.com/reader/full/query-as-a-web-service 41/84
en el CMS mediante un identificador exclusivo (CUID) en lugar del nombrede consulta que se utilizaba en las versiones anteriores.
1. En la página de catálogo de consultas, lleve a cabo una de las siguientesacciones:
• 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 WebPuede eliminar una consulta de la lista del catálogo de consultas.
• Realice una de las siguientes acciones:
• Seleccione una consulta de la página de catálogo de consultas y elijaEditar > Eliminar .
• Haga clic con el botón derecho en la lista del catálogo de consultasy 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 catálogo de consultas.Asegúrese de tener los permisos de usuario correspondientes para realizar la operación de copia.
1. Realice una de las siguientes acciones:
• Seleccione una consulta en el catálogo de consultas y elija Editar >
Copiar .• Haga clic con el botón derecho en una consulta del catálogo y
seleccione "Copiar" en el menú contextual.
2. Haga clic en el lugar donde desee pegar la consulta copiada y seleccioneEditar > Pegar o haga clic con el botón derecho y seleccione "Pegar" enla lista.
Query as a Web Service 41
5Administrar consultas como servicios Web
Eliminar una consulta como servicio Web
5/11/2018 Query as a Web Service - slidepdf.com
http://slidepdf.com/reader/full/query-as-a-web-service 42/84
La consulta copiada aparecerá en la lista del catálogo de consultas.
Ver las propiedades de la consulta
Puede ver las propiedades de la consulta en la página de catálogo deconsultas.
1. Seleccione una consulta en la lista que aparece en la página de catálogode 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 dirección URL.
El vínculo a la descripción de consultas se muestra en un explorador Web. La definición de WSDL se abre en el explorador Web.
3. Haga clic en el vínculo de WSDL de la página Web para ver el WSDL.
Ver las instancias de servicios Web deconsultas disponibles
Puede ver las instancias disponibles de Query as a Web Service en unexplorador Web.
• Abra un explorador Web y vaya a la dirección URL dswsbobje
http://<nombre del servidor>:<número de puerto Tom
cat>/dswsbobje/ qaawsservices
42 Query as a Web Service
Administrar consultas como servicios Web5 Ver las propiedades de la consulta
5/11/2018 Query as a Web Service - slidepdf.com
http://slidepdf.com/reader/full/query-as-a-web-service 43/84
Cómo implementar consultas en otroservidor Web
En esta sección se explica cómo implementar en otro servidor. Debe copiar una definición de Query as a Web Service de un servidor a otro. Por ejemplo,puede mover una definición de consulta de un servidor de desarrollo a unode prueba o producción.
Para realizar el despliegue en otro servidor, dispone de los métodos
siguientes:• Query as a Web Service
Utilice la opción Desplegar en otro servidor . La ventaja de este métodoes que la consulta se actualizará automáticamente la caché WSDL dela consulta en el nuevo servidor de la aplicación. Si no se utiliza estemétodo, deberá actualizar manualmente la caché WSDL.
Query as a Web Service 43
5Administrar consultas como servicios Web
Cómo implementar consultas en otro servidor Web
5/11/2018 Query as a Web Service - slidepdf.com
http://slidepdf.com/reader/full/query-as-a-web-service 44/84
• Asistente de importación. Deberá actualizar manualmente la caché WSDLpara la consulta desplegada.
• Archivo BIAR. Deberá actualizar manualmente la caché WSDL para laconsulta desplegada.
Nota:Antes de empezar, asegúrese de que el universo y los usuarios sean igualesen ambos equipos. Use el Asistente de importación o archivos .biar paraimportar universos y usuarios. Es importante mantener el mismo CUIDdurante las operaciones del Asistente de importación.
Temas relacionados
• Actualización de la caché WSDL al desplegar consultas en otro servidor
La actualización del archivo WSDL cambia en eldespliegue de consultas
Las actualizaciones del archivo WSDL han cambiado en esta versión. Apartir de esta versión, el servlet almacena todos los archivos WSDL en unarchivo .ZIP en el servidor de la aplicación. Anteriormente, el servlet seconectaba a CMS cada vez que se publicaba una consulta. La WSDL de laconsulta se actualizaba de forma dinámica. En esta versión, ya no hay querealizar conexiones con el CMS. Los archivos WSDL se agregan a este
archivo .ZIP siempre que se publique o actualice una nueva consulta deQaaWS. También se almacenan parámetros de ejecución adicionales en lacaché WSDL, por ejemplo el modo de autenticación, así como valores deconfiguración regional y tiempo de espera que se utilizan durante el consumodel servicio Web.
Al utilizar la opción Desplegar en otro servidor para desplegar una consultaen otro servidor de aplicación, la caché WSDL se actualiza de formaautomática. Si se utiliza el Asistente de importación o un archivo BIAR paradesplegar una consulta en otro servidor de aplicación, deberá actualizar manualmente el archivo .ZIP de WSDL. Éste se describe en la secciónTemas relacionados.
Temas relacionados
• Actualización de la caché WSDL al desplegar consultas en otro servidor
44 Query as a Web Service
Administrar consultas como servicios Web5 Cómo implementar consultas en otro servidor Web
5/11/2018 Query as a Web Service - slidepdf.com
http://slidepdf.com/reader/full/query-as-a-web-service 45/84
Implementar en otro servidor utilizando laherramienta cliente Query as a Web Service
El cliente Query as a Web Service le permite desplegar consultas en otroservidor una vez, por medio del mismo nombre de servicio.
Puede usar la opción Desplegar en otro servidor entre dos servidores quetengan instalada la misma versión de Query as a Web Service. Con estaopción no es posible migrar consultas de una versión a otra.
1. En el catálogo de consultas, seleccione la aparición de Query as a WebService cuya definición desee copiar.
2. Haga clic en Desplegar en otro servidor .
Aparece el cuadro de diálogo Seleccione sus credenciales.
3. Complete la información del sistema en el que desee desplegar losservicios Web y, cuando termine, haga clic en Aceptar .
La opción seleccionada de Query as a Web Service aparece en elAsistente de publicación de Query as a Web Service.
4. Publique Query as a Web Service en el nuevo sistema.
Al desplegar una definición de Query as a Web Service en otro servidor,
cambia automáticamente la ubicación del WSDL así como la ubicación deejecución de los servicios.
Nota:El asistente permite personalizar esta dirección URL basada en el servicio.También puede convertirla en dinámica en proyectos de Xcelsius medianteel cuadro de texto de valores de entrada para la conectividad de serviciosWeb. Gracias a esta funcionalidad, puede convertir un cuadro de mandosde desarrollo en un cuadro de producción simplemente cambiando ladirección URL.
No es posible desplegar el mismo nombre de servicio de la consulta en elmismo servidor en más de una ocasión.
Query as a Web Service 45
5Administrar consultas como servicios Web
Cómo implementar consultas en otro servidor Web
5/11/2018 Query as a Web Service - slidepdf.com
http://slidepdf.com/reader/full/query-as-a-web-service 46/84
Implementar Query as a Web Service desde elAsistente de importación
Para realizar el despliegue con el Asistente de importación, importe ladefinición de Query as a Web Service del servidor de origen al servidor dedestino.
1. Inicie el Asistente de importación en el servidor de origen.
2. Después de iniciar la sesión en el CMS de origen, seleccione el archivode destino al que desee exportar las definiciones.
3. En el panel Seleccione los objetos para importar del cuadro de diálogoAsistente de importación, seleccione Importar carpetas y objetos y, a
continuación, Importar carpetas y objetos de la aplicación.4. En el panel Seleccionar carpetas y objetos de aplicación del cuadro de
diálogo Asistente de importación, expanda la carpeta QaaWS y, acontinuación, las definiciones de Query as a Web Service que le interesen.
5. Continúe por los pasos restantes del Asistente de importación haciendoclic en Siguiente.
6. Abra el Asistente de importación en el servidor de destino.
7. En el cuadro de diálogo Entorno de origen, seleccione el archivo de origenal que haya exportado las definiciones.
8. Inicie sesión en el CMS de destino.9. En el panel Seleccione los objetos para importar del cuadro de diálogo
Asistente de importación, seleccione Importar carpetas y objetos y,a continuación, Importar carpetas y objetos de la aplicación.
10. En el panel Seleccionar carpetas y objetos de aplicación del cuadrode diálogo Asistente de importación, seleccione las definiciones deQuery as a Web Service que le interesen.
11. Continúe por los pasos restantes del Asistente de importación haciendoclic en Siguiente.
12. Tras la importación, apunte la definición de consulta recién desplegadaal servidor Web del sistema de destino.
46 Query as a Web Service
Administrar consultas como servicios Web5 Cómo implementar consultas en otro servidor Web
5/11/2018 Query as a Web Service - slidepdf.com
http://slidepdf.com/reader/full/query-as-a-web-service 47/84
Implementar Query as a Web Service desde unarchivo BIAR
Compruebe que el Asistente de importación esté instalado tanto en el servidor de origen como en el servidor de destino.
1. Abra el Asistente de importación en el servidor de origen.
2. Después de iniciar la sesión 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 diálogoAsistente de importación, seleccione Importar carpetas y objetos y, acontinuación, Importar carpetas y objetos de la aplicación.
4. En el panel Seleccionar carpetas y objetos de aplicación del cuadrode diálogo Asistente de importación, expanda la carpeta QaaWS y, acontinuación, las definiciones de Query as a Web Service que le interesen.
5. Continúe por las páginas restantes del Asistente de importación.
6. Abra el Asistente de importación en el servidor de destino.
7. En el cuadro de diálogo Entorno de origen, seleccione el archivo .biar alque haya exportado las definiciones.
8. Inicie sesión en el CMS de destino.
9. En el cuadro de diálogo Seleccione los objetos para importar, seleccione
Importar carpetas y objetos > Importar carpetas y objetos de laaplicación.
10. En el cuadro de diálogo Importar carpetas y objetos de la aplicación,seleccione las definiciones de Query as a Web Service que le interesen.
11. Continúe por las páginas restantes del Asistente de importación.
12. Tras la importación, apunte la definición de consulta recién desplegadaal servidor Web del sistema de destino.
Actualización de la caché WSDL al desplegarconsultas en otro servidor
Si no utiliza la opción Desplegar en otro servidor en Query as a WebService para desplegar una consulta a otro servidor, tendrá que actualizar manualmente la caché WSDL para asegurarse de que la consulta se
Query as a Web Service 47
5Administrar consultas como servicios Web
Cómo implementar consultas en otro servidor Web
5/11/2018 Query as a Web Service - slidepdf.com
http://slidepdf.com/reader/full/query-as-a-web-service 48/84
sincroniza con el Servidor de administración central (CMS). Esto se haceutilizando el asistente de importación o un archivo BIAR para desplegar unaconsulta en otro servidor.
Para actualizar manualmente la WDSL cuando una consulta se despliegaen otro servidor de aplicación, haga lo siguiente:
• Vaya a la siguiente URL:http://<NombreServidorAplicación>:<puerto>/dswsbobje/qaawsservices/wsdlGenerator
• Si fuera necesario, especifique la información de acceso del CMS.
Los archivos WSDL se actualizan de forma automática.
Implementar en otro servidor utilizando
la herramienta cliente Query as a WebService
El cliente Query as a Web Service le permite desplegar consultas en otroservidor una vez, por medio del mismo nombre de servicio.
Puede usar la opción Desplegar en otro servidor entre dos servidores quetengan instalada la misma versión de Query as a Web Service. Con estaopción no es posible migrar consultas de una versión a otra.
1. En el catálogo de consultas, seleccione la aparición de Query as a WebService cuya definición desee copiar.
2. Haga clic en Desplegar en otro servidor .
Aparece el cuadro de diálogo Seleccione sus credenciales.
3. Complete la información del sistema en el que desee desplegar losservicios Web y, cuando termine, haga clic en Aceptar .
La opción seleccionada de Query as a Web Service aparece en elAsistente de publicación de Query as a Web Service.
4. Publique Query as a Web Service en el nuevo sistema.Al desplegar una definición de Query as a Web Service en otro servidor,cambia automáticamente la ubicación del WSDL así como la ubicación deejecución de los servicios.
48 Query as a Web Service
Administrar consultas como servicios Web5 Implementar en otro servidor utilizando la herramienta cliente Query as a Web Service
5/11/2018 Query as a Web Service - slidepdf.com
http://slidepdf.com/reader/full/query-as-a-web-service 49/84
Nota:El asistente permite personalizar esta dirección URL basada en el servicio.También puede convertirla en dinámica en proyectos de Xcelsius medianteel cuadro de texto de valores de entrada para la conectividad de servicios
Web. Gracias a esta funcionalidad, puede convertir un cuadro de mandosde desarrollo en un cuadro de producción simplemente cambiando ladirección URL.
No es posible desplegar el mismo nombre de servicio de la consulta en elmismo servidor en más de una ocasión.
La actualización del archivo WSDL cambia en eldespliegue de consultas
Las actualizaciones del archivo WSDL han cambiado en esta versión. Apartir de esta versión, el servlet almacena todos los archivos WSDL en unarchivo .ZIP en el servidor de la aplicación. Anteriormente, el servlet seconectaba a CMS cada vez que se publicaba una consulta. La WSDL de laconsulta se actualizaba de forma dinámica. En esta versión, ya no hay querealizar conexiones con el CMS. Los archivos WSDL se agregan a estearchivo .ZIP siempre que se publique o actualice una nueva consulta deQaaWS. También se almacenan parámetros de ejecución adicionales en lacaché WSDL, por ejemplo el modo de autenticación, así como valores de
configuración regional y tiempo de espera que se utilizan durante el consumodel servicio Web.
Al utilizar la opción Desplegar en otro servidor para desplegar una consultaen otro servidor de aplicación, la caché WSDL se actualiza de formaautomática. Si se utiliza el Asistente de importación o un archivo BIAR paradesplegar una consulta en otro servidor de aplicación, deberá actualizar manualmente el archivo .ZIP de WSDL. Éste se describe en la secciónTemas relacionados.
Temas relacionados
• Actualización de la caché WSDL al desplegar consultas en otro servidor
Query as a Web Service 49
5Administrar consultas como servicios Web
Implementar en otro servidor utilizando la herramienta cliente Query as a Web Service
5/11/2018 Query as a Web Service - slidepdf.com
http://slidepdf.com/reader/full/query-as-a-web-service 50/84
Implementar en otro servidor utilizando laherramienta cliente Query as a Web Service
El cliente Query as a Web Service le permite desplegar consultas en otroservidor una vez, por medio del mismo nombre de servicio.
Puede usar la opción Desplegar en otro servidor entre dos servidores quetengan instalada la misma versión de Query as a Web Service. Con estaopción no es posible migrar consultas de una versión a otra.
1. En el catálogo de consultas, seleccione la aparición de Query as a WebService cuya definición desee copiar.
2. Haga clic en Desplegar en otro servidor .
Aparece el cuadro de diálogo Seleccione sus credenciales.
3. Complete la información del sistema en el que desee desplegar losservicios Web y, cuando termine, haga clic en Aceptar .
La opción seleccionada de Query as a Web Service aparece en elAsistente de publicación de Query as a Web Service.
4. Publique Query as a Web Service en el nuevo sistema.
Al desplegar una definición de Query as a Web Service en otro servidor,
cambia automáticamente la ubicación del WSDL así como la ubicación deejecución de los servicios.
Nota:El asistente permite personalizar esta dirección URL basada en el servicio.También puede convertirla en dinámica en proyectos de Xcelsius medianteel cuadro de texto de valores de entrada para la conectividad de serviciosWeb. Gracias a esta funcionalidad, puede convertir un cuadro de mandosde desarrollo en un cuadro de producción simplemente cambiando ladirección URL.
No es posible desplegar el mismo nombre de servicio de la consulta en elmismo servidor en más de una ocasión.
50 Query as a Web Service
Administrar consultas como servicios Web5 Implementar en otro servidor utilizando la herramienta cliente Query as a Web Service
5/11/2018 Query as a Web Service - slidepdf.com
http://slidepdf.com/reader/full/query-as-a-web-service 51/84
Implementar Query as a Web Service desde elAsistente de importación
Para realizar el despliegue con el Asistente de importación, importe ladefinición de Query as a Web Service del servidor de origen al servidor dedestino.
1. Inicie el Asistente de importación en el servidor de origen.
2. Después de iniciar la sesión en el CMS de origen, seleccione el archivode destino al que desee exportar las definiciones.
3. En el panel Seleccione los objetos para importar del cuadro de diálogoAsistente de importación, seleccione Importar carpetas y objetos y, a
continuación, Importar carpetas y objetos de la aplicación.4. En el panel Seleccionar carpetas y objetos de aplicación del cuadro de
diálogo Asistente de importación, expanda la carpeta QaaWS y, acontinuación, las definiciones de Query as a Web Service que le interesen.
5. Continúe por los pasos restantes del Asistente de importación haciendoclic en Siguiente.
6. Abra el Asistente de importación en el servidor de destino.
7. En el cuadro de diálogo Entorno de origen, seleccione el archivo de origenal que haya exportado las definiciones.
8. Inicie sesión en el CMS de destino.9. En el panel Seleccione los objetos para importar del cuadro de diálogo
Asistente de importación, seleccione Importar carpetas y objetos y,a continuación, Importar carpetas y objetos de la aplicación.
10. En el panel Seleccionar carpetas y objetos de aplicación del cuadrode diálogo Asistente de importación, seleccione las definiciones deQuery as a Web Service que le interesen.
11. Continúe por los pasos restantes del Asistente de importación haciendoclic en Siguiente.
12. Tras la importación, apunte la definición de consulta recién desplegadaal servidor Web del sistema de destino.
Query as a Web Service 51
5Administrar consultas como servicios Web
Implementar en otro servidor utilizando la herramienta cliente Query as a Web Service
5/11/2018 Query as a Web Service - slidepdf.com
http://slidepdf.com/reader/full/query-as-a-web-service 52/84
Implementar Query as a Web Service desde unarchivo BIAR
Compruebe que el Asistente de importación esté instalado tanto en el servidor de origen como en el servidor de destino.
1. Abra el Asistente de importación en el servidor de origen.
2. Después de iniciar la sesión 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 diálogoAsistente de importación, seleccione Importar carpetas y objetos y, acontinuación, Importar carpetas y objetos de la aplicación.
4. En el panel Seleccionar carpetas y objetos de aplicación del cuadrode diálogo Asistente de importación, expanda la carpeta QaaWS y, acontinuación, las definiciones de Query as a Web Service que le interesen.
5. Continúe por las páginas restantes del Asistente de importación.
6. Abra el Asistente de importación en el servidor de destino.
7. En el cuadro de diálogo Entorno de origen, seleccione el archivo .biar alque haya exportado las definiciones.
8. Inicie sesión en el CMS de destino.
9. En el cuadro de diálogo Seleccione los objetos para importar, seleccione
Importar carpetas y objetos > Importar carpetas y objetos de laaplicación.
10. En el cuadro de diálogo Importar carpetas y objetos de la aplicación,seleccione las definiciones de Query as a Web Service que le interesen.
11. Continúe por las páginas restantes del Asistente de importación.
12. Tras la importación, apunte la definición de consulta recién desplegadaal servidor Web del sistema de destino.
Actualización de la caché WSDL al desplegarconsultas en otro servidor
Si no utiliza la opción Desplegar en otro servidor en Query as a WebService para desplegar una consulta a otro servidor, tendrá que actualizar manualmente la caché WSDL para asegurarse de que la consulta se
52 Query as a Web Service
Administrar consultas como servicios Web5 Implementar en otro servidor utilizando la herramienta cliente Query as a Web Service
5/11/2018 Query as a Web Service - slidepdf.com
http://slidepdf.com/reader/full/query-as-a-web-service 53/84
sincroniza con el Servidor de administración central (CMS). Esto se haceutilizando el asistente de importación o un archivo BIAR para desplegar unaconsulta en otro servidor.
Para actualizar manualmente la WDSL cuando una consulta se despliegaen otro servidor de aplicación, haga lo siguiente:
• Vaya a la siguiente URL:http://<NombreServidorAplicación>:<puerto>/dswsbobje/qaawsservices/wsdlGenerator
• Si fuera necesario, especifique la información de acceso del CMS.
Los archivos WSDL se actualizan de forma automática.
Implementar Query as a Web Service
desde el Asistente de importaciónPara realizar el despliegue con el Asistente de importación, importe ladefinición de Query as a Web Service del servidor de origen al servidor dedestino.
1. Inicie el Asistente de importación en el servidor de origen.
2. Después de iniciar la sesión en el CMS de origen, seleccione el archivode destino al que desee exportar las definiciones.
3. En el panel Seleccione los objetos para importar del cuadro de diálogo
Asistente de importación, seleccione Importar carpetas y objetos y, acontinuación, Importar carpetas y objetos de la aplicación.
4. En el panel Seleccionar carpetas y objetos de aplicación del cuadro dediálogo Asistente de importación, expanda la carpeta QaaWS y, acontinuación, las definiciones de Query as a Web Service que le interesen.
5. Continúe por los pasos restantes del Asistente de importación haciendoclic en Siguiente.
6. Abra el Asistente de importación en el servidor de destino.
7. En el cuadro de diálogo Entorno de origen, seleccione el archivo de origen
al que haya exportado las definiciones.8. Inicie sesión en el CMS de destino.
9. En el panel Seleccione los objetos para importar del cuadro de diálogoAsistente de importación, seleccione Importar carpetas y objetos y,a continuación, Importar carpetas y objetos de la aplicación.
Query as a Web Service 53
5Administrar consultas como servicios Web
Implementar Query as a Web Service desde el Asistente de importación
5/11/2018 Query as a Web Service - slidepdf.com
http://slidepdf.com/reader/full/query-as-a-web-service 54/84
10. En el panel Seleccionar carpetas y objetos de aplicación del cuadrode diálogo Asistente de importación, seleccione las definiciones deQuery as a Web Service que le interesen.
11. Continúe por los pasos restantes del Asistente de importación haciendoclic en Siguiente.
12. Tras la importación, apunte la definición de consulta recién desplegadaal servidor Web del sistema de destino.
La actualización del archivo WSDL cambia en eldespliegue de consultas
Las actualizaciones del archivo WSDL han cambiado en esta versión. A
partir de esta versión, el servlet almacena todos los archivos WSDL en unarchivo .ZIP en el servidor de la aplicación. Anteriormente, el servlet seconectaba a CMS cada vez que se publicaba una consulta. La WSDL de laconsulta se actualizaba de forma dinámica. En esta versión, ya no hay querealizar conexiones con el CMS. Los archivos WSDL se agregan a estearchivo .ZIP siempre que se publique o actualice una nueva consulta deQaaWS. También se almacenan parámetros de ejecución adicionales en lacaché WSDL, por ejemplo el modo de autenticación, así como valores deconfiguración regional y tiempo de espera que se utilizan durante el consumodel servicio Web.
Al utilizar la opción Desplegar en otro servidor para desplegar una consultaen otro servidor de aplicación, la caché WSDL se actualiza de formaautomática. Si se utiliza el Asistente de importación o un archivo BIAR paradesplegar una consulta en otro servidor de aplicación, deberá actualizar manualmente el archivo .ZIP de WSDL. Éste se describe en la secciónTemas relacionados.
Temas relacionados
• Actualización de la caché WSDL al desplegar consultas en otro servidor
Implementar en otro servidor utilizando laherramienta cliente Query as a Web Service
El cliente Query as a Web Service le permite desplegar consultas en otroservidor una vez, por medio del mismo nombre de servicio.
54 Query as a Web Service
Administrar consultas como servicios Web5 Implementar Query as a Web Service desde el Asistente de importación
5/11/2018 Query as a Web Service - slidepdf.com
http://slidepdf.com/reader/full/query-as-a-web-service 55/84
Puede usar la opción Desplegar en otro servidor entre dos servidores quetengan instalada la misma versión de Query as a Web Service. Con estaopción no es posible migrar consultas de una versión a otra.
1. En el catálogo de consultas, seleccione la aparición de Query as a WebService cuya definición desee copiar.
2. Haga clic en Desplegar en otro servidor .
Aparece el cuadro de diálogo Seleccione sus credenciales.
3. Complete la información del sistema en el que desee desplegar losservicios Web y, cuando termine, haga clic en Aceptar .
La opción seleccionada de Query as a Web Service aparece en elAsistente de publicación de Query as a Web Service.
4. Publique Query as a Web Service en el nuevo sistema.Al desplegar una definición de Query as a Web Service en otro servidor,cambia automáticamente la ubicación del WSDL así como la ubicación deejecución de los servicios.
Nota:El asistente permite personalizar esta dirección URL basada en el servicio.También puede convertirla en dinámica en proyectos de Xcelsius medianteel cuadro de texto de valores de entrada para la conectividad de serviciosWeb. Gracias a esta funcionalidad, puede convertir un cuadro de mandosde desarrollo en un cuadro de producción simplemente cambiando ladirección URL.
No es posible desplegar el mismo nombre de servicio de la consulta en elmismo servidor en más de una ocasión.
Implementar Query as a Web Service desde elAsistente de importación
Para realizar el despliegue con el Asistente de importación, importe ladefinición de Query as a Web Service del servidor de origen al servidor dedestino.
1. Inicie el Asistente de importación en el servidor de origen.
2. Después de iniciar la sesión en el CMS de origen, seleccione el archivode destino al que desee exportar las definiciones.
Query as a Web Service 55
5Administrar consultas como servicios Web
Implementar Query as a Web Service desde el Asistente de importación
5/11/2018 Query as a Web Service - slidepdf.com
http://slidepdf.com/reader/full/query-as-a-web-service 56/84
3. En el panel Seleccione los objetos para importar del cuadro de diálogoAsistente de importación, seleccione Importar carpetas y objetos y, acontinuación, Importar carpetas y objetos de la aplicación.
4. En el panel Seleccionar carpetas y objetos de aplicación del cuadro dediálogo Asistente de importación, expanda la carpeta QaaWS y, acontinuación, las definiciones de Query as a Web Service que le interesen.
5. Continúe por los pasos restantes del Asistente de importación haciendoclic en Siguiente.
6. Abra el Asistente de importación en el servidor de destino.
7. En el cuadro de diálogo Entorno de origen, seleccione el archivo de origenal que haya exportado las definiciones.
8. Inicie sesión en el CMS de destino.
9. En el panel Seleccione los objetos para importar del cuadro de diálogo
Asistente de importación, seleccione Importar carpetas y objetos y,a continuación, Importar carpetas y objetos de la aplicación.
10. En el panel Seleccionar carpetas y objetos de aplicación del cuadrode diálogo Asistente de importación, seleccione las definiciones deQuery as a Web Service que le interesen.
11. Continúe por los pasos restantes del Asistente de importación haciendoclic en Siguiente.
12. Tras la importación, apunte la definición de consulta recién desplegadaal servidor Web del sistema de destino.
Implementar Query as a Web Service desde unarchivo BIAR
Compruebe que el Asistente de importación esté instalado tanto en el servidor de origen como en el servidor de destino.
1. Abra el Asistente de importación en el servidor de origen.
2. Después de iniciar la sesión 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 diálogo
Asistente de importación, seleccione Importar carpetas y objetos y, acontinuación, Importar carpetas y objetos de la aplicación.
4. En el panel Seleccionar carpetas y objetos de aplicación del cuadrode diálogo Asistente de importación, expanda la carpeta QaaWS y, acontinuación, las definiciones de Query as a Web Service que le interesen.
56 Query as a Web Service
Administrar consultas como servicios Web5 Implementar Query as a Web Service desde el Asistente de importación
5/11/2018 Query as a Web Service - slidepdf.com
http://slidepdf.com/reader/full/query-as-a-web-service 57/84
5. Continúe por las páginas restantes del Asistente de importación.
6. Abra el Asistente de importación en el servidor de destino.
7. En el cuadro de diálogo Entorno de origen, seleccione el archivo .biar al
que haya exportado las definiciones.8. Inicie sesión en el CMS de destino.
9. En el cuadro de diálogo Seleccione los objetos para importar, seleccioneImportar carpetas y objetos > Importar carpetas y objetos de laaplicación.
10. En el cuadro de diálogo Importar carpetas y objetos de la aplicación,seleccione las definiciones de Query as a Web Service que le interesen.
11. Continúe por las páginas restantes del Asistente de importación.
12. Tras la importación, apunte la definición de consulta recién desplegada
al servidor Web del sistema de destino.
Actualización de la caché WSDL al desplegarconsultas en otro servidor
Si no utiliza la opción Desplegar en otro servidor en Query as a WebService para desplegar una consulta a otro servidor, tendrá que actualizar manualmente la caché WSDL para asegurarse de que la consulta sesincroniza con el Servidor de administración central (CMS). Esto se hace
utilizando el asistente de importación o un archivo BIAR para desplegar unaconsulta en otro servidor.
Para actualizar manualmente la WDSL cuando una consulta se despliegaen otro servidor de aplicación, haga lo siguiente:
• Vaya a la siguiente URL:http://<NombreServidorAplicación>:<puerto>/dswsbobje/qaawsservices/wsdlGenerator
• Si fuera necesario, especifique la información de acceso del CMS.
Los archivos WSDL se actualizan de forma automática.
Implementar Query as a Web Servicedesde un archivo BIAR
Compruebe que el Asistente de importación esté instalado tanto en el servidor de origen como en el servidor de destino.
Query as a Web Service 57
5Administrar consultas como servicios Web
Implementar Query as a Web Service desde un archivo BIAR
5/11/2018 Query as a Web Service - slidepdf.com
http://slidepdf.com/reader/full/query-as-a-web-service 58/84
1. Abra el Asistente de importación en el servidor de origen.
2. Después de iniciar la sesión 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 diálogoAsistente de importación, seleccione Importar carpetas y objetos y, acontinuación, Importar carpetas y objetos de la aplicación.
4. En el panel Seleccionar carpetas y objetos de aplicación del cuadrode diálogo Asistente de importación, expanda la carpeta QaaWS y, acontinuación, las definiciones de Query as a Web Service que le interesen.
5. Continúe por las páginas restantes del Asistente de importación.
6. Abra el Asistente de importación en el servidor de destino.
7. En el cuadro de diálogo Entorno de origen, seleccione el archivo .biar alque haya exportado las definiciones.
8. Inicie sesión en el CMS de destino.
9. En el cuadro de diálogo Seleccione los objetos para importar, seleccioneImportar carpetas y objetos > Importar carpetas y objetos de laaplicación.
10. En el cuadro de diálogo Importar carpetas y objetos de la aplicación,seleccione las definiciones de Query as a Web Service que le interesen.
11. Continúe por las páginas restantes del Asistente de importación.
12. Tras la importación, apunte la definición de consulta recién desplegadaal servidor Web del sistema de destino.
La actualización del archivo WSDL cambia en eldespliegue de consultas
Las actualizaciones del archivo WSDL han cambiado en esta versión. Apartir de esta versión, el servlet almacena todos los archivos WSDL en unarchivo .ZIP en el servidor de la aplicación. Anteriormente, el servlet seconectaba a CMS cada vez que se publicaba una consulta. La WSDL de laconsulta se actualizaba de forma dinámica. En esta versión, ya no hay que
realizar conexiones con el CMS. Los archivos WSDL se agregan a estearchivo .ZIP siempre que se publique o actualice una nueva consulta deQaaWS. También se almacenan parámetros de ejecución adicionales en lacaché WSDL, por ejemplo el modo de autenticación, así como valores deconfiguración regional y tiempo de espera que se utilizan durante el consumodel servicio Web.
58 Query as a Web Service
Administrar consultas como servicios Web5 Implementar Query as a Web Service desde un archivo BIAR
5/11/2018 Query as a Web Service - slidepdf.com
http://slidepdf.com/reader/full/query-as-a-web-service 59/84
Al utilizar la opción Desplegar en otro servidor para desplegar una consultaen otro servidor de aplicación, la caché WSDL se actualiza de formaautomática. Si se utiliza el Asistente de importación o un archivo BIAR paradesplegar una consulta en otro servidor de aplicación, deberá actualizar
manualmente el archivo .ZIP de WSDL. Éste se describe en la secciónTemas relacionados.
Temas relacionados
• Actualización de la caché WSDL al desplegar consultas en otro servidor
Implementar en otro servidor utilizando laherramienta cliente Query as a Web Service
El cliente Query as a Web Service le permite desplegar consultas en otroservidor una vez, por medio del mismo nombre de servicio.
Puede usar la opción Desplegar en otro servidor entre dos servidores quetengan instalada la misma versión de Query as a Web Service. Con estaopción no es posible migrar consultas de una versión a otra.
1. En el catálogo de consultas, seleccione la aparición de Query as a WebService cuya definición desee copiar.
2. Haga clic en Desplegar en otro servidor .
Aparece el cuadro de diálogo Seleccione sus credenciales.
3. Complete la información del sistema en el que desee desplegar losservicios Web y, cuando termine, haga clic en Aceptar .
La opción seleccionada de Query as a Web Service aparece en elAsistente de publicación de Query as a Web Service.
4. Publique Query as a Web Service en el nuevo sistema.
Al desplegar una definición de Query as a Web Service en otro servidor,cambia automáticamente la ubicación del WSDL así como la ubicación deejecución de los servicios.
Nota:El asistente permite personalizar esta dirección URL basada en el servicio.También puede convertirla en dinámica en proyectos de Xcelsius medianteel cuadro de texto de valores de entrada para la conectividad de serviciosWeb. Gracias a esta funcionalidad, puede convertir un cuadro de mandos
Query as a Web Service 59
5Administrar consultas como servicios Web
Implementar Query as a Web Service desde un archivo BIAR
5/11/2018 Query as a Web Service - slidepdf.com
http://slidepdf.com/reader/full/query-as-a-web-service 60/84
de desarrollo en un cuadro de producción simplemente cambiando ladirección URL.
No es posible desplegar el mismo nombre de servicio de la consulta en el
mismo servidor en más de una ocasión.
Implementar Query as a Web Service desde elAsistente de importación
Para realizar el despliegue con el Asistente de importación, importe ladefinición de Query as a Web Service del servidor de origen al servidor dedestino.
1. Inicie el Asistente de importación en el servidor de origen.2. Después de iniciar la sesión 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 diálogoAsistente de importación, seleccione Importar carpetas y objetos y, acontinuación, Importar carpetas y objetos de la aplicación.
4. En el panel Seleccionar carpetas y objetos de aplicación del cuadro dediálogo Asistente de importación, expanda la carpeta QaaWS y, acontinuación, las definiciones de Query as a Web Service que le interesen.
5. Continúe por los pasos restantes del Asistente de importación haciendoclic en Siguiente.
6. Abra el Asistente de importación en el servidor de destino.
7. En el cuadro de diálogo Entorno de origen, seleccione el archivo de origenal que haya exportado las definiciones.
8. Inicie sesión en el CMS de destino.
9. En el panel Seleccione los objetos para importar del cuadro de diálogoAsistente de importación, seleccione Importar carpetas y objetos y,a continuación, Importar carpetas y objetos de la aplicación.
10. En el panel Seleccionar carpetas y objetos de aplicación del cuadro
de diálogo Asistente de importación, seleccione las definiciones deQuery as a Web Service que le interesen.
11. Continúe por los pasos restantes del Asistente de importación haciendoclic en Siguiente.
12. Tras la importación, apunte la definición de consulta recién desplegadaal servidor Web del sistema de destino.
60 Query as a Web Service
Administrar consultas como servicios Web5 Implementar Query as a Web Service desde un archivo BIAR
5/11/2018 Query as a Web Service - slidepdf.com
http://slidepdf.com/reader/full/query-as-a-web-service 61/84
Implementar Query as a Web Service desde unarchivo BIAR
Compruebe que el Asistente de importación esté instalado tanto en el servidor de origen como en el servidor de destino.
1. Abra el Asistente de importación en el servidor de origen.
2. Después de iniciar la sesión 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 diálogoAsistente de importación, seleccione Importar carpetas y objetos y, acontinuación, Importar carpetas y objetos de la aplicación.
4. En el panel Seleccionar carpetas y objetos de aplicación del cuadrode diálogo Asistente de importación, expanda la carpeta QaaWS y, acontinuación, las definiciones de Query as a Web Service que le interesen.
5. Continúe por las páginas restantes del Asistente de importación.
6. Abra el Asistente de importación en el servidor de destino.
7. En el cuadro de diálogo Entorno de origen, seleccione el archivo .biar alque haya exportado las definiciones.
8. Inicie sesión en el CMS de destino.
9. En el cuadro de diálogo Seleccione los objetos para importar, seleccione
Importar carpetas y objetos > Importar carpetas y objetos de laaplicación.
10. En el cuadro de diálogo Importar carpetas y objetos de la aplicación,seleccione las definiciones de Query as a Web Service que le interesen.
11. Continúe por las páginas restantes del Asistente de importación.
12. Tras la importación, apunte la definición de consulta recién desplegadaal servidor Web del sistema de destino.
Actualización de la caché WSDL al desplegarconsultas en otro servidor
Si no utiliza la opción Desplegar en otro servidor en Query as a WebService para desplegar una consulta a otro servidor, tendrá que actualizar manualmente la caché WSDL para asegurarse de que la consulta se
Query as a Web Service 61
5Administrar consultas como servicios Web
Implementar Query as a Web Service desde un archivo BIAR
5/11/2018 Query as a Web Service - slidepdf.com
http://slidepdf.com/reader/full/query-as-a-web-service 62/84
sincroniza con el Servidor de administración central (CMS). Esto se haceutilizando el asistente de importación o un archivo BIAR para desplegar unaconsulta en otro servidor.
Para actualizar manualmente la WDSL cuando una consulta se despliegaen otro servidor de aplicación, haga lo siguiente:
• Vaya a la siguiente URL:http://<NombreServidorAplicación>:<puerto>/dswsbobje/qaawsservices/wsdlGenerator
• Si fuera necesario, especifique la información de acceso del CMS.
Los archivos WSDL se actualizan de forma automática.
Implementar Query as a Web Service en
varios servidores Web
Configurar el cliente Query as a Web Service paraque se conecte a un servidor Web de proxy inverso
El proxy inverso es la traducción de la dirección de red de un equipo de unaURL de la red indicada a otra URL de una red externa. Como el cliente Queryas a Web Service crea un enlace a los servicios Web del motor de informes,
de Query y de BICatalog, debe especificar la dirección URL externa de losservicios 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 aplicación Web dswsbobje.
2. Actualice las siguientes propiedades:
62 Query as a Web Service
Administrar consultas como servicios Web5 Implementar Query as a Web Service en varios servidores Web
5/11/2018 Query as a Web Service - slidepdf.com
http://slidepdf.com/reader/full/query-as-a-web-service 63/84
Valor de la propiedadNombre de la propie-dad
ReportEngine|reportengine web servicealone|http://[miservidor.miempre
sa.es]/dswsbobje/services/reportengi
ne
wsresource1
BICatalog|bicatalog web service alo
ne|[miservidor.miempresa.es] dswsbobje/services/bicatalog
wsresource2
QueryService|query web service alo
ne|http://[miservidor.miempre
sa.es]/dswsbobje/services/query
wsresource4
Query as a Web Service 63
5Administrar consultas como servicios Web
Implementar Query as a Web Service en varios servidores Web
5/11/2018 Query as a Web Service - slidepdf.com
http://slidepdf.com/reader/full/query-as-a-web-service 64/84
64 Query as a Web Service
Administrar consultas como servicios Web5 Implementar Query as a Web Service en varios servidores Web
5/11/2018 Query as a Web Service - slidepdf.com
http://slidepdf.com/reader/full/query-as-a-web-service 65/84
Consumir consultas comoservicios Web con distintasaplicaciones
6
5/11/2018 Query as a Web Service - slidepdf.com
http://slidepdf.com/reader/full/query-as-a-web-service 66/84
Consumir Query as a Web Service
mediante WSDLWSDL es un lenguaje basado en XML que describe la comunicación por medio del servicio Web, es decir, los enlaces de protocolo y los formatos demensaje necesarios para interactuar con los servicios Web enumerados enel directorio.
Primero, se describen de forma general las operaciones y los mensajescompatibles y, luego, se enlazan a un protocolo de red y un formato demensaje concretos. El lenguaje WSDL se emplea a menudo junto con elesquema XML y SOAP a fin de prestar servicios Web por Internet.
Si un programa cliente se conecta a un servicio Web, puede leer el WSDLpara determinar las funciones disponibles en el servidor.
Para buscar el WSDLde Query as a Web Service, selecciónelo en el catálogode consultas.
Consumir Query as a Web Service enCrystal Xcelsius
Para consumir Query as a Web Service en Crystal Xcelsius, use el Conector de servicios Web.
Nota:Asegúrese de que tiene instalado Crystal Xcelsius 2008 Enterprise paratener acceso a las conexiones del servicio web.
El componente Conector de servicios Web facilita la comunicación dedocumentos Flash creados en Xcelsius con Query as a Web Service por medio de SOAP usando la función de señalar y hacer clic. Los documentos
Flash de Xcelsius son independientes y se comunican con el servicio Webpara mostrar visualmente los datos. El único requisito consiste en que eldocumento Flash ha de tener a su disposición algún servicio Web basadoen SOAP.
Al activar el componente Conector de servicios Web, se crea un mensajebasado en SOAP (en esencia, un documento XML), el cual se envía al
66 Query as a Web Service
Consumir consultas como servicios Web con distintas aplicaciones6 Consumir Query as a Web Service mediante WSDL
5/11/2018 Query as a Web Service - slidepdf.com
http://slidepdf.com/reader/full/query-as-a-web-service 67/84
servicio Web. El servicio Web responde con su propio mensaje basado enSOAP. A continuación, el componente Conector de servicios Web envíaestos datos a todos los demás componentes, lo que da como resultado unarepresentación visual real de los datos.
Existen numerosos servicios Web públicos disponibles, así como infinidadde toolkits y paquetes diferentes para servicios Web basados en SOAP.Para utilizar los paquetes y servicios Web públicos que ya tengan un servicioWeb, sólo necesita un documento WSDL para el servicio Web. En el casode Query as a Web Service, busque el WSDL en las propiedades de cadauno de los servicios Web seleccionándolo en el catálogo de consultas.
Consulte el Manual del usuario de Crystal Xcelsius para obtener másinformación.
Problema por cruce de dominios
Tras descargar el producto Xcelsius de Internet, quizá se tope con dificultadespara recuperar los datos con la herramienta Query as a Web Service si elcontenido Flash y la herramienta cliente proceden de distintos dominiosWeb.
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 originadoel formato del archivo Flash (SWF).
La solución depende de si el servidor de Xcelsius y la herramienta clienteQuery as a Web Service se encuentran en el mismo equipo o en máquinasdiferentes.
Mismo equipo
Abra el cuadro de diálogo Parámetros opcionales mediante el botónParámetros avanzados) y modifique el valor de Dirección URL base del
servicio Web para que coincida con el dominio Web desde el que hadescargado Xcelsius.
Equipos distintos
Para obtener instrucciones, visite esta página:
Query as a Web Service 67
6Consumir consultas como servicios Web con distintas aplicaciones
Consumir Query as a Web Service en Crystal Xcelsius
5/11/2018 Query as a Web Service - slidepdf.com
http://slidepdf.com/reader/full/query-as-a-web-service 68/84
http://www.adobe.com/cfusion/knowledgebase/index.cfm?id=tn_14213
Seleccionar el servicio WebPara seleccionar el servicio Web, debe hacer que el componente Conector de servicios Web apunte al documento WSDL.
1. Si trabaja con una hoja de cálculo de Excel, haga doble clic en elcomponente Conector de servicios Web para abrir el panel Propiedades.
2. En el panel izquierdo, arrastre el botón Actualizar conexión del cuadrode mandos del lado derecho de la pantalla de la aplicación.
3. Realice una de las siguientes acciones:
• Seleccione Datos > Conexiones.• Haga clic en el botón Actualizar datos.
Aparecerá el cuadro de diálogo Seleccionar servicio Web.
4. Haga clic en Agregar .
Aparecerá una lista de los tipos de conexión disponibles.
5. Seleccione Consultar como servicio Web.
Al seleccionar Consultar como servicio Web se asegura de que Xcelsiusadministre la autenticación correcta para los parámetros de inicio desesión.
6. Escriba un nombre para la conexión.
7. En el cuadro Dirección URL WSDL, escriba o pegue la ubicación deldocumento WSDL.
8. Haga clic en Importar .
Si se ha producido algún error, puede que el documento WSDL no estévalidado por completo o no cumpla los requisitos del componenteConector de servicios Web.
9. En la lista Métodos, seleccione el método con el que desee crear un
enlace.Para cada servicio Web, sólo puede enlazar un método por componente.
10. Haga clic en Aceptar .
Ya están disponibles los mensajes de entrada y salida que puede enlazar a los datos.
68 Query as a Web Service
Consumir consultas como servicios Web con distintas aplicaciones6 Consumir Query as a Web Service en Crystal Xcelsius
5/11/2018 Query as a Web Service - slidepdf.com
http://slidepdf.com/reader/full/query-as-a-web-service 69/84
Mensajes de entrada
En el caso de los mensajes de entrada, sólo se pueden enlazar elementosa los datos.
Use el botón "-" para quitar carpetas y elementos. De este modo, evita quese envíen la carpeta o el campo en el mensaje.
El botón "+" sirve para agregar una carpeta o cualquier elemento que serepita.
Mensajes de salida
En el caso de los mensajes de salida, se pueden enlazar tanto elementoscomo carpetas a los datos.
Al seleccionar una carpeta, aparece el número de columnas que contiene.Cuando se enlaza a los datos, se asigna una columna a cada uno de loselementos de la carpeta en el mismo orden en que figuren éstos.
Si selecciona menos columnas, limita los datos enlazados al número decolumnas seleccionado. Si selecciona más columnas, se insertan columnas
en blanco. Si un elemento se repite en la carpeta, sólo se asigna a la columnael primer elemento. Las subcarpetas de la carpeta seleccionada no se puedenasignar.
Use el botón "-" para quitar los elementos prescindibles. Así se contrae lavista del árbol y se puede reducir el tiempo de procesamiento del documentoFlash.
Autenticación en Xcelsius
Xcelsius ofrece un mecanismo de autenticación por el cual no tiene queiniciar la sesión en InfoView dos veces con el mismo ID de sesión.
Tenga presentes las normas siguientes cuando personalice la autenticación:
• Sólo se utiliza un ID de sesión existente si el nombre de usuario y lacontraseña están vacíos (si no están codificados ni se han transmitido
Query as a Web Service 69
6Consumir consultas como servicios Web con distintas aplicaciones
Consumir Query as a Web Service en Crystal Xcelsius
5/11/2018 Query as a Web Service - slidepdf.com
http://slidepdf.com/reader/full/query-as-a-web-service 70/84
como valores de entrada capturados por un cuadro de diálogo). Estosucede cuando Query as a Web Service se ejecuta en InfoView oDashboard Manager.
• Sólo el nombre de usuario y la contraseña no están vacíos, use dichosvalores para autenticar al usuario. No se crea ninguna sesión. Como estasituación es la que se puede aplicar en más casos, constituye la opciónrecomendada para el uso a gran escala.
• Si no existía ninguna sesión con anterioridad (y el nombre de usuario yla contraseña están vacíos), Xcelsius muestra el cuadro de diálogo deseguridad habitual con el que se crea una sesión. Es lo que ocurre si losdiseñadores de Xcelsius no crean un cuadro de diálogo de seguridadpersonalizado.
Consumir Query as a Web Service enCrystal Reports
En esta sección se explica cómo consume Crystal Reports Query as a WebService como origen de datos.
1. En la página Datos del Asistente para la creación de informes estándar de Crystal Reports, cree una conexión XML.
2. En la página Tipo y ubicación XML (origen de datos) del cuadro de diálogoXML, seleccione Usar origen de datos de servicio Web y, acontinuación, haga clic en Siguiente.
Aparece la página Ubicación del servicio Web.
3. En el campo URL WSDL HTTP, escriba el valor de WSDL para laselección de Query as a Web Service.
Aparece la página Autenticación.
4. Establezca la autenticación básica (si aún no lo ha hecho) y, cuandotermine, haga clic en Siguiente.
Aparece la página Servicio Web, puerto y método.
5. Complete la información y haga clic en Finalizar .
Aparece el cuadro de diálogo Introducir valores.
70 Query as a Web Service
Consumir consultas como servicios Web con distintas aplicaciones6 Consumir Query as a Web Service en Crystal Reports
5/11/2018 Query as a Web Service - slidepdf.com
http://slidepdf.com/reader/full/query-as-a-web-service 71/84
6. Establezca los parámetros de los servicios Web con la identificación, lacontraseña y las peticiones adecuadas y, luego, haga clic en Aceptar .
Vuelve a aparecer la página Datos del Asistente para la creación de
informes estándar.7. Seleccione una de las opciones disponibles y, a continuación, haga clic
en Siguiente.
• runQueryAsServiceResponse• runQueryAsServicetable• runQueryAsServicerow
Aparece la página Campos.
8. Seleccione el campo en el que desee basar la consulta y haga clic enSiguiente.
Se crea un informe.
9. Actualizar el informe
Ahora, el informe muestra los parámetros correctos.
Consumir Query as a Web Service enMicrosoft Office InfoPath
En esta sección se explica cómo consume Microsoft Office InfoPath Queryas a Web Service como origen de datos.
1. En InfoPath, acceda a la lista de tareas Diseñar un formulario.
2. Haga clic en Nuevo en Conexión de datos.
Aparece el Asistente para la conexión de datos.
3. Seleccione Servicio Web y, después, haga clic en Siguiente.
4. Seleccione Recibir y enviar datos y, a continuación, haga clic enSiguiente.
5. Escriba o busque el nombre del archivo WSDL y, a continuación, hagaclic en Siguiente.
6. Seleccione la operación del servicio Web y haga clic en Siguiente.
7. Escriba un nombre para la conexión de datos y, a continuación, hagaclic en Siguiente.
Query as a Web Service 71
6Consumir consultas como servicios Web con distintas aplicaciones
Consumir Query as a Web Service en Microsoft Office InfoPath
5/11/2018 Query as a Web Service - slidepdf.com
http://slidepdf.com/reader/full/query-as-a-web-service 72/84
8. Escriba o busque el nombre del servicio Web al que deban enviar susformularios los usuarios y, a continuación, haga clic en Siguiente.
Aparece la página Parámetros.
9. En cada uno de los parámetros, seleccione Formulario completo y,después, haga clic en Siguiente.
10. Escriba un nombre para la conexión de datos que envía los datos y, acontinuación, 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 Query as a Web Service
Consumir consultas como servicios Web con distintas aplicaciones6 Consumir Query as a Web Service en Microsoft Office InfoPath
5/11/2018 Query as a Web Service - slidepdf.com
http://slidepdf.com/reader/full/query-as-a-web-service 73/84
Descripción API de llamadadel servicio Web
7
5/11/2018 Query as a Web Service - slidepdf.com
http://slidepdf.com/reader/full/query-as-a-web-service 74/84
En esta sección se describen los métodos generados por una consulta.
Query as a Web Service siempre genera los dos métodos siguientes:
• runQueryAsAService• runQueryAsAServiceEx
Ambos métodos se corresponden con una llamada de consulta; no obstante,runQueryAsAServiceEx se genera para peticiones de índice, por lo que hayuna diferencia en el tipo de parámetro de entrada Enter_value_s_for_Year_.Este paso se describe a continuación.
Estos dos métodos siempre requieren el mismo conjunto de parámetros deentrada y producen el mismo conjunto de parámetros de salida, excepto lalista de valores de entrada de petición, ya que habrá tantos parámetros deentrada como peticiones en la consulta.
El tercer método generado es valuesOf_Year. Este nombre (así como losnombres de parámetro de petición) dependen de los nombres de objetosque se utilizan en la consulta, y se generan de forma dinámica. Éste tambiénse describe en la siguiente tabla:
• Parámetros de entrada
DescripciónTipoParámetro
Información de inicio de sesióncadenainicio de sesión
Información de contraseñacadenaContraseña
Establece el patrónde búsquedaen la lista de valores. Puede utili-zar los siguientes caracteres co-modín en la cadena del patrón:? : 0 o 1 carácter, * : 0 o n carac-teres; por ejemplo, "M?Greggor"encontrará el valor McGreggor,mientras que "M*Greggor" dará
como resultado los valores Mc-Greggor y MacGreggor.
cadenasearchLOV
74 Query as a Web Service
Descripción API de llamada del servicio Web7
5/11/2018 Query as a Web Service - slidepdf.com
http://slidepdf.com/reader/full/query-as-a-web-service 75/84
DescripciónTipoParámetro
Petición de valores de año.
El método runQueryAsAServicerequiere la cadena Enter_Year_ As como valor de petición parael año.
El método runQueryAsAServi-ceEx se genera para las peticio-nes del índice, por loque requie-re una instancia de LovValueIn-dex.
• Para runQueryAsA-Service: cadena[]
• Para runQueryAsA-ServiceEx: LovVa-lueIndex[]
Enter_value_s_for_Year_
Identificador de una sesión deBusinessObjects Enterprise quepermite que el servicio Web seconecte al CMS sin datos de ini-cio de sesión ni contraseña. Elservicio Web obtiene el identifica-dor de sesión de la llamada get-SessionInfo.
cadenasessionID
Permite que el servicio Web se
conecte al CMS sin nombre deinicio de sesión ni contraseñamediante una sesión abiertaactualmente (sesión en serie).Se puede obtener una sesiónen serie de la sesión deplatafor-ma de servicio Web a partir dela llamada getSessionInfo.
cadenaserializedSession
• Parámetros de salida
Query as a Web Service 75
Descripción API de llamada del servicio Web
5/11/2018 Query as a Web Service - slidepdf.com
http://slidepdf.com/reader/full/query-as-a-web-service 76/84
DescripciónTipoParámetro
La salida de datos es una tabla que consta de unconjunto de filas, cada una de las cuales es una tuplade valores de cada columna. Se trata del equivalentede una tabla vertical en Web Intelligence.
Tablatabla
Texto que contiene mensajes o advertencias deerror que pueden ser generadas por el servidor al ejecutar la consulta.
cadenamessage
El nombre del creador de la consulta.cadenacreatorname
La fecha en que se creó la consulta.dateTimecreationdate
La fecha en que se creó la consulta con el formatode la configuración regional del equipo que se utilizópara su creación.
cadenacreationdatefor mated
Comentarioscadenadescripción
Nombre del universocadenauniverso
Los metadatos de universo que especifican la dura-
ción del tiempo de ejecución de la consulta en labase de datos.
intqueryruntime
El número de filas devueltas de la base de datos ylos metadatos de universo.
intfetchedrows
Devuelve un valor verdadero si el universo defineeste LOV como búsqueda delegada, por lo que lalista de valores es resuelta por la base de datos conel patrón de entrada de usuarios determinado; de locontrario, devuelve el valor falso.
booleano
delegados
76 Query as a Web Service
Descripción API de llamada del servicio Web7
5/11/2018 Query as a Web Service - slidepdf.com
http://slidepdf.com/reader/full/query-as-a-web-service 77/84
Procedimientosrecomendados ylimitaciones de Query as aWeb Service
8
5/11/2018 Query as a Web Service - slidepdf.com
http://slidepdf.com/reader/full/query-as-a-web-service 78/84
Procedimientos recomendados al usar
Query as a Web ServiceMás sugerencias para usar Query as a Web Service
La documentación de Query as a Web Service se actualiza periódicamente.Si quiere ver la información más reciente, vaya a la biblioteca dedocumentación en línea y utilice el campo de búsqueda para acceder a losprocedimientos recomendados de Query as a Web Service.
http://support.businessobjects.com/documentation/product_guides/
Limitaciones en el uso de Query as a WebService
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 ejecución.
Limitaciones al crear una consulta
• No se pueden usar multicubos
• No se pueden usar consultas combinadas ni subconsultas• No se implementan laspeticiones IndexAware (reconocimientode índices)
Asimismo, tenga en cuenta que el nombre del servicio Web y sus metadatosestán codificados con el fin de admitir diversos lenguajes de programación(entre otros, C#, Java, C++, VB o Flash).
Limitaciones en tiempo de ejecución de una consulta
• No se pueden usar restricciones de objetos
78 Query as a Web Service
Procedimientos recomendados y limitaciones de Query as a Web Service8 Procedimientos recomendados al usar Query as a Web Service
5/11/2018 Query as a Web Service - slidepdf.com
http://slidepdf.com/reader/full/query-as-a-web-service 79/84
Más información
A
5/11/2018 Query as a Web Service - slidepdf.com
http://slidepdf.com/reader/full/query-as-a-web-service 80/84
UbicaciónRecurso de infor-mación
http://www.sap.comInformación del pro-ducto SAP Busines-sObjects
Seleccione http://help.sap.com > SAP BusinessOb- jects.
Puede acceder a la documentación más actualizadasobre todos los productos SAP BusinessObjects y sudespliegue en el SAP Help Portal. Puede descargar versiones en PDF o bibliotecas HTML instalables.
Algunos manuales se almacenan en SAP ServiceMarketplace y no están disponibles desde SAP HelpPortal. Estos manuales aparecen listados en HelpPortal junto con un enlace a SAP Service Marketplace.Los clientes con un acuerdo de mantenimiento dispo-nen de una identificación de usuario registrado paraacceder a este sito. Para obtener una identificación,póngase en contacto con su representante de asisten-cia al cliente.
SAP Help Portal
80 Query as a Web Service
Más informaciónA
5/11/2018 Query as a Web Service - slidepdf.com
http://slidepdf.com/reader/full/query-as-a-web-service 81/84
UbicaciónRecurso de infor-mación
http://service.sap.com/bosap-support > Documentación• Manuales de instalación: https://service.sap.com/bo
sap-instguides
• Notas de la versión: http://service.sap.com/releaseno
tes
SAPService Marketplace almacena algunos manualesde instalación, manuales de actualización y migración,de despliegue, notas de las versiones y documentosde las plataformas compatibles. Los clientes con unacuerdo de mantenimiento disponen de una identifica-ción de usuario registrado para acceder a este sito.Póngase en contacto su representante de asistenciaal cliente para obtener una identificación. Si se le redi-rige a SAP Service Marketplace desde SAP HelpPortal, utilice el menú del panel de navegación situadoa la izquierda para localizar la categoría que contienela documentación a la que desea acceder.
SAPServiceMarket-place
https://boc.sdn.sap.com/
https://www.sdn.sap.com/irj/sdn/businessobjects-sdkli
brary
Recursos del desa-rrollador
https://www.sdn.sap.com/irj/boc/businessobjects-arti
cles
Estos artículos se conocían antes como documentostécnicos.
Artículos de SAPBusinessObjects enSAP CommunityNetwork
https://service.sap.com/notes
Estas notas se conocían antes como artículos deKnowledge Base.
Notas
Query as a Web Service 81
AMás información
5/11/2018 Query as a Web Service - slidepdf.com
http://slidepdf.com/reader/full/query-as-a-web-service 82/84
UbicaciónRecurso de infor-mación
https://www.sdn.sap.com/irj/scn/forumsForos en SAP Com-munity Network
http://www.sap.com/services/education
Desde la formación tradicional en aulas hasta semina-rios de e-learning específicos, podemos ofrecer unpaquete de formación que se ajuste a sus necesidadesy su estilo preferido de aprendizaje.
Capacitación
http://service.sap.com/bosap-support
SAP Support Portal contiene información acerca delos programas y servicios de asistencia al cliente.También incluye vínculos a un amplio abanico de in-formación técnica y descargas. Los clientes con unacuerdo de mantenimiento disponen de una identifica-ción de usuario registrado para acceder a este sito.Para obtener una identificación, póngase en contactocon su representante de asistencia al cliente.
Asistencia en líneaal cliente
http://www.sap.com/services/bysubject/businessob
jectsconsulting
Los consultores pueden acompañarle desde la fasede análisis inicial hasta la entrega de su proyecto dedespliegue. Contamos con expertos en temas comobases de datos relacionales y multidimensionales,conectividad, herramientasde diseñode base de datosy tecnología de incrustación personalizada.
Consultoría
82 Query as a Web Service
Más informaciónA
5/11/2018 Query as a Web Service - slidepdf.com
http://slidepdf.com/reader/full/query-as-a-web-service 83/84
ÍndiceA
arquitecturanociones básicas 9
B
base de datos CMSevitar errores 16
C
conectarse 20configurar
proxy inverso 62consultas
copiar 41eliminar 41
copiar
procedimiento 41
D
descripción de API 74desplegar
servicios web en otro servidor, publicar servicios web en otro servidor 45, 48,
50, 54, 59documentación
acceder a biblioteca en línea 78
documentación en líneaacceder 78
E
eliminar consultas 41
I
iniciar 21primera vez 20
P
presentación general 8proxy inverso
configurar 62
Q
Query as a Web Servicenociones básicas 8
R
runQueryAsAService 74runQueryAsAServiceEx 74
S
solución de problemas
opciones de tolerancia a errores 16sugerenciasusar Query as a Web Service 78
Query as a Web Service 83