Tipo de conexión XML (SSRS)
Para incluir los datos de un origen de datos XML en el informe, deberá tener un conjunto de datos que se base en un origen de datos de informe de tipo XML. Este tipo de origen de datos integrado se basa en la extensión de datos XML. Use este tipo de origen de datos para conectarse y recuperar datos de documentos XML, servicios web o XML incrustado en la consulta.
Esta extensión de datos admite parámetros y credenciales administrados independientemente de la cadena de conexión.
Use la información de este tema para compilar un origen de datos. Para obtener instrucciones paso a paso, vea Agregar y comprobar una conexión de datos o un origen de datos (Generador de informes 3.0 y SSRS).
En este artículo
Cadena de conexión
Credenciales
Consultas
Parámetros
Notas
Temas de procedimientos
Secciones relacionadas
Cadena de conexión
La cadena de conexión debe ser una dirección URL que señale al servicio web, la aplicación basada en web o el documento XML disponible a través de HTTP. Los documentos XML deben tener la extensión XML. También se puede usar una cadena de conexión vacía si se van a incrustar datos XML en la consulta del conjunto de datos.
Los ejemplos siguientes muestran la sintaxis de cadena de conexión para un servicio web y un documento XML, respectivamente. No se admite el protocolo file://.
Tipo de documento XML |
Ejemplo de cadena de conexión |
|---|---|
Servicio web |
http://adventure-works.com/results.aspx |
Documento XML |
https://localhost/XML/Customers.xml |
Documento XML incrustado |
Vacío |
Para obtener más ejemplos de cadenas de conexión, vea Conexiones de datos, orígenes de datos y cadenas de conexión en Generador de informes 3.0.
Credenciales
Se necesitan credenciales para ejecutar consultas y obtener una vista previa del informe localmente y desde el servidor de informes.
Después de publicar el informe, es posible que necesite cambiar las credenciales para el origen de datos de tal forma que, cuando el informe se ejecute en el servidor de informes, los permisos para recuperar los datos sean válidos.
Desde un cliente de creación de informes, están disponibles las siguientes opciones para especificar las credenciales:
Usuario actual de Windows (lo que se conoce también como seguridad integrada).
No se necesitan credenciales. Si no especifica credenciales, se utilizará el acceso anónimo. Asegúrese de haber definido la cuenta de ejecución desatendida para que el servidor de informes se conecte a un origen de datos externo. La extensión de procesamiento de datos XML no pasa credenciales a la dirección URL de destino ni al servicio web; la conexión no se realizará correctamente a menos que haya definido la cuenta de ejecución desatendida. Para obtener más información, vea Configurar la cuenta de ejecución desatendida en la documentación relativa a Reporting Services en los Libros en pantalla de SQL Server, en msdn.microsoft.com.
Las credenciales almacenadas o solicitadas no están admitidas. Recuerde que si deshabilita la seguridad integrada de Windows, no podrá usarla para recuperar datos. Si especifica credenciales almacenadas o solicitadas, se producirá un error en tiempo de ejecución.
Para obtener más información, vea Conexiones de datos, orígenes de datos y cadenas de conexión (SSRS) o Especificar credenciales en el Generador de informes 3.0.
.gif "Icono de flecha usado con el vínculo Volver al principio")
Volver al principio
Consultas
Una consulta especifica qué datos se van a recuperar para un conjunto de datos de informe. Las columnas del conjunto de resultados de una consulta rellenan la colección de campos de un conjunto de datos. Un informe procesa solamente el primer conjunto de resultados recuperado por una consulta.
Debe usar el diseñador de consultas basado en texto para crear la consulta. La consulta debe devolver datos XML.
Para obtener más información acerca del diseñador de consultas basado en texto, vea Interfaz de usuario del Diseñador de consultas basado en texto (Generador de informes 3.0).
En la tabla siguiente se muestran los posibles valores de una consulta de conjunto de datos para un origen de datos de tipo XML.
Consulta de conjunto de datos |
Descripción |
|---|---|
Vacía |
Use una consulta vacía para crear un conjunto de resultados predeterminado. Para crear la consulta predeterminada se lee el origen de datos y se recorre la jerarquía de nodos XML hasta la primera colección de nodos hoja. El conjunto de resultados incluye todos los nodos con valores de texto y todos los atributos de nodo encontrados en el recorrido. Las columnas del conjunto de resultados hacen referencia a los campos del conjunto de datos. |
Una ruta de acceso de elemento |
Especifica la secuencia de nodos que se debe usar al recuperar datos XML del origen de datos. |
Un elemento de consulta XML |
Una especificación de consulta XML con los siguientes elementos opcionales.
Origen de datos XMLElementos XML obligatoriosElementos XML opcionales
Para un servicio web <Method Namespace= "espacio de nombres" Name="MethodName" /> -- or -- <SoapAction> acción soap </SoapAction> <ElementPath> ruta de acceso de elemento </ElementPath> <Method Namespace= "espacio de nombres" Name="MethodName" /> -- or -- <SoapAction> acción soap </SoapAction>
Para un documento XML <ElementPath> ruta de acceso de elemento </ElementPath>
Para un documento XML incrustado <XmlData> XML interno </XmlData> <ElementPath> ruta de acceso de elemento </ElementPath> -- or -- <ElementPath IgnoreNamespaces="true"> ruta de acceso de elemento </ElementPath>
|
Para obtener más información sobre la sintaxis de consulta, vea Sintaxis de consultas XML para especificar datos de informes XML (SSRS) en la documentación relativa a Reporting Services en los Libros en pantalla de SQL Server, en msdn.microsoft.com.
Para obtener ejemplos, vea la página en que se describe cómo usar orígenes de datos XML y de servicio web en Reporting Services.
Requisitos para recuperar datos del servicio web XML
La extensión de procesamiento de datos XML no detecta el esquema de forma automática. Por tanto, debe tener alguna manera de determinar los métodos SOAP que recuperarán los datos que desea. También debe comprender el esquema de direcciones o el espacio de nombres que usa el servicio web para sus datos.
Para un servicio web, se puede proporcionar un elemento <Query> que especifique un método al que se debe llamar o una acción SOAP. Es posible dejar la consulta vacía y usar la consulta predeterminada si el origen de datos XML tiene una estructura jerárquica que genera los datos que se desea usar en el informe. Los valores y los atributos de los nodos de elemento XML recuperados cuando se ejecuta la consulta se asignan a los campos de conjunto de datos que se usan en el informe.
Requisitos para recuperar datos de un documento XML
El servidor debe devolver los datos XML mediante el protocolo HTTP o los datos XML deben estar incrustados en el elemento XML Query. Si se hace referencia directa a un documento XML mediante el protocolo HTTP, la extensión debe ser .xml.
Debe saber cómo crear una consulta XML que recupere todos los datos que necesita. Si no especifica la ruta de un elemento, el comportamiento predeterminado para analizar un documento XML consiste en seleccionar la primera ruta disponible a una colección de nodos hoja en el documento XML. Si el documento XML incluye rutas de acceso adicionales a otras colecciones de nodos hoja relacionados, dichos nodos se omitirán a menos que se especifique una ruta de acceso en la consulta.
Puede proporcionar una ruta de acceso de elemento utilizando una sintaxis XML similar a XQuery.
Para obtener más información, vea Sintaxis de ruta de acceso de elemento para especificar datos de informe XML (SSRS) en la documentación relativa a Reporting Services en los Libros en pantalla de SQL Server, en msdn.microsoft.com.
Parámetros
La consulta no se analiza para identificar los parámetros.
Para agregar parámetros, deberá crearlos manualmente en el cuadro de diálogo Propiedades del conjunto de datos de la página Parámetro.
Volver al principio
Notas
La extensión de datos XML admite la creación de informes a partir de datos XML tabulares y no jerárquicos. Para obtener más información, vea Agregar datos de orígenes de datos externos (SSRS).
No hay compatibilidad integrada para recuperar documentos XML desde una base de datos de SQL Server.
Volver al principio
Temas de procedimientos
Esta sección contiene instrucciones paso a paso para trabajar con conexiones de datos, orígenes de datos y conjuntos de datos.
Agregar y comprobar una conexión de datos o un origen de datos (Generador de informes 3.0 y SSRS)
Agregar un filtro a un conjunto de datos (Generador de informes 3.0 y SSRS)
Volver al principio
Secciones relacionadas
Estas secciones de la documentación proporcionan información conceptual detallada sobre los datos de informe, así como información de procedimientos acerca de cómo definir, personalizar y usar las partes de un informe que están relacionadas con datos.
Agregar datos a un informe (Generador de informes 3.0 y SSRS)
Proporciona información general sobre cómo obtener acceso a los datos del informe.Conexiones de datos, orígenes de datos y cadenas de conexión en Generador de informes 3.0
Proporciona información sobre las conexiones de datos y los orígenes de datos.Crear y agregar conjuntos de datos (Generador de informes 3.0 y SSRS)
Proporciona información sobre conjuntos de datos compartidos e incrustados.Trabajar con campos en un conjunto de datos de informe (Generador de informes 3.0 y SSRS)
Proporciona información sobre la colección de campos de conjunto de datos que genera la consulta.Orígenes de datos admitidos por Reporting Services (SSRS) en la documentación relativa a Reporting Services en los Libros en pantalla de SQL Server.
Proporciona información detallada sobre la plataforma y la compatibilidad de versiones para cada extensión de datos.
Volver al principio