Definir conjuntos de datos de informe para datos XML

Actualizado: 14 de abril de 2006

Reporting Services proporciona una extensión de procesamiento de datos que admite la recuperación de datos de informe desde orígenes de datos XML. Los informes pueden utilizar datos de documentos XML y servicios Web, o incrustar XML en la consulta. No hay compatibilidad para recuperar documentos XML de una base de datos de SQL Server. Un conjunto de datos de Reporting Services incluye un origen de datos, una consulta y una colección de campos.

Las instrucciones paso a paso para configurar el origen de datos y el conjunto de datos, agregar campos al diseño del informe y crear un informe que muestre los datos XML recuperados desde un servicio Web XML se encuentran en Tutorial: Usar datos XML en un informe.

Conectar con un origen de datos XML y recuperar datos

Para recuperar datos XML en un informe, cree un origen de datos con una cadena de conexión que especifique una dirección URL para un servicio Web o documento XML. También puede crear un origen de datos con una cadena de conexión vacía e incrustar los datos XML en la consulta del conjunto de datos.

Cada origen de datos XML debe tener las siguientes características:

  • El origen de datos debe ser XML. Reporting Services incluye una extensión de procesamiento de datos XML para recuperar y procesar los datos en un informe.
  • Debe configurar credenciales para la seguridad integrada de Windows o no usar credenciales.
    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.
    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 una cuenta para procesar informes en modo desatendido.
  • 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 utilizar una cadena de conexión vacía si se van a incrustar datos XML en la consulta del conjunto de datos.
  • La consulta debe devolver datos XML. En el caso de los documentos XML, se puede proporcionar una ruta de acceso de elemento con sintaxis XML similar a XQuery, tal como se describe en Sintaxis de ruta de acceso de elemento para especificar datos de informe XML. 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 utilizar la consulta predeterminada si el origen de datos XML tiene una estructura jerárquica que genera los datos que se desea utilizar en el informe. Los valores y atributos de los nodos de elementos XML recuperados cuando se ejecuta la consulta están asignados a los campos del conjunto de datos que se utilizan en el informe.
  • Debe utilizar el diseñador de consultas genérico para crear la consulta. La consulta no se analiza para identificar parámetros, por lo que es necesario crearlos a través de la ficha Parámetro del cuadro de diálogo Conjunto de datos. Para obtener más información acerca de la sintaxis de consulta, vea Sintaxis de consulta XML para especificar datos de informe XML. Para obtener más información acerca del diseñador de consultas genérico, vea Herramientas de diseño de consultas en Reporting Services.

Cadenas de conexión para orígenes de datos XML

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ía

Para obtener más información acerca de cómo definir un origen de datos, vea Cómo crear o editar un origen de datos específico del informe (Diseñador de informes).

Consultas de conjuntos de datos con orígenes de datos XML

Un conjunto de datos incluye una consulta, que es el texto del comando que se ejecuta en un origen de datos para recuperar un conjunto de resultados específico. El conjunto de resultados hace referencia a la colección de campos de un conjunto de datos. Para limitar los resultados devueltos desde el origen de datos, se pueden establecer valores de filtro en el conjunto de datos. 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 utilizar 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 XML

Elementos XML obligatorios

Elementos XML opcionales

Para un servicio Web<Method Namespace="espacio de nombres" Name="MethodName" /> O bien <SoapAction>acción soap</SoapAction>``<ElementPath> ruta de acceso de elemento </ElementPath>``<Method Namespace="espacio de nombres" Name="MethodName" /> O bien <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> O bien <ElementPath IgnoreNamespaces="true"> ruta de acceso de elemento </ElementPath>

Para especificar espacios de nombres, use el elemento de consulta XML (Query); para pasarlos por alto, use el atributo IgnoreNamespaces en la ruta de acceso de elemento XML (ElementPath). Para obtener más información acerca del elemento de consulta XML (Query), vea Sintaxis de consulta XML para especificar datos de informe XML. Para obtener más información acerca de la sintaxis de ruta de acceso de elemento, vea Sintaxis de ruta de acceso de elemento para especificar datos de informe XML.

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 utiliza el servicio Web para sus datos.

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 del mismo nivel, dichos nodos se omitirán a menos que se especifique una ruta de acceso en la consulta. Para obtener más información, vea Sintaxis de ruta de acceso de elemento para especificar datos de informe XML.

Recursos externos

Usar orígenes de datos XML y de servicio Web en Reporting Services (puede estar en inglés)

Vea también

Conceptos

Conectar con un origen de datos

Otros recursos

Tutorial: Usar datos XML en un informe

Ayuda e información

Obtener ayuda sobre SQL Server 2005

Historial de cambios

Versión Historial

14 de abril de 2006

Contenido nuevo:
  • Información y vínculos sobre las rutas de acceso de elemento y los elementos de consulta XML.
  • Datos XML incrustados.