Generación de fuentes de distribución de datos a partir de informes (Generador de informes)

La extensión de representación de Atom de Reporting Services genera un documento de servicio de Atom que enumera las fuentes de distribución de datos disponibles en un informe paginado y las fuentes de distribución de datos de las regiones de datos de un informe. Esta extensión se usa para generar las fuentes de distribución de datos compatibles con Atom que son legibles y se pueden intercambiar con las aplicaciones que pueden usar las fuentes de distribución de datos generadas en los informes. Por ejemplo, puede utilizar la extensión de representación Atom para las fuentes de distribución de datos generadas que después puede utilizar en Power Pivot o en Power BI.

El documento de servicio Atom enumera al menos una fuente de distribución de datos de cada región de datos de un informe. Según el tipo de región de datos y los datos que esta muestra, Reporting Services podría generar varias fuentes de distribución de datos a partir de una región de datos. Por ejemplo, una matriz o gráfico pueden proporcionar varias fuentes de distribución de datos. Cuando la extensión de representación Atom crea el documento de servicio Atom, se crea un identificador único para cada fuente de distribución de datos y el identificador se usa en la dirección URL para tener acceso al contenido de la fuente de distribución de datos.

La extensión de representación Atom genera los datos de una fuente de distribución de datos de forma similar al modo en que la extensión de representación de valores separados por comas (CSV) representa los datos en un archivo CSV. Al igual que un archivo CSV, la fuente de distribución de datos es una representación plana de los datos del informe. Por ejemplo, una tabla con un grupo de filas que sume las ventas dentro de un grupo repite la suma en cada fila de datos y no hay ninguna fila independiente que solo contenga la suma.

Puede generar documentos y fuentes de distribución de datos de servicio Atom con el portal web de Reporting Services , el servidor de informes, o bien con un sitio de SharePoint integrado con Reporting Services.

Atom se aplica a un par de estándares relacionados. El documento de servicio de Atom cumple la especificación de protocolo de publicación Atom de RFC 5023 y las fuentes de distribución de datos cumplen la especificación de protocolo del formato para redifusión web Atom de RFC 4287.

En las secciones siguientes se proporciona información adicional sobre cómo utilizar la extensión de representación de Atom:

Puede crear y modificar los archivos de definición de informes paginados (.rdl) en el Generador de informes de Microsoft, en Power BI Report Builder y en el Diseñador de informes de SQL Server Data Tools.

Informes como fuentes de distribución de datos

Puede exportar un informe de producción como una fuente de distribución de datos o puede crear un informe cuyo propósito principal sea proporcionar datos, en forma de fuentes de distribución de datos, a las aplicaciones. Mediante el uso de informes como fuente de distribución de datos, tiene otra manera de proporcionar datos a las aplicaciones cuando los datos no son fáciles de acceder a través de proveedores de datos de cliente. O bien, puede usarlos como fuente de distribución de datos cuando prefiera ocultar la complejidad del origen de datos y simplificar el uso de los datos. Otra ventaja de usar los datos de informe como fuente de distribución de datos es que puede usar características de Reporting Services. Estas características incluyen la seguridad, la programación y las instantáneas de informe para administrar los informes que proporcionan fuentes de distribución de datos.

Para sacar el máximo partido de la extensión de representación de Atom, debe saber cómo se representa el informe en las fuentes de distribución de datos. Si usa informes existentes, poder predecir qué fuentes de distribución de datos generan los informes es útil. Si va a escribir el informe específicamente para usarlo como fuente de distribución de datos, ser capaz de incluir los datos y ajustar el diseño del informe para sacar el máximo provecho de las fuentes de distribución de datos es de gran valor.

Para obtener más información, vea Generar fuentes de distribución de datos a partir de un informe (Generador de informes y SSRS).

Documento de servicio de Atom (archivo .atomsvc)

En un documento de servicio de Atom se especifica una conexión a una o varias fuentes de distribución de datos. Como mínimo, la conexión es una dirección URL simple al servicio de datos que genera la fuente.

Al representar los datos del informe utilizando la extensión de representación de Atom, el documento de servicio de Atom enumera las fuentes de distribución de datos disponibles para un informe. El documento enumera al menos una fuente de distribución de datos para cada región de datos del informe. Las tablas y medidores generan solo una fuente de distribución de datos cada uno, pero las matrices, listas y gráficos podrían generar varias en función de los datos que muestren.

El diagrama siguiente muestra un informe que utiliza dos tablas y un gráfico.

El documento de servicio de Atom generado con este informe incluye tres fuentes de distribución de datos, una para cada tabla y otra para el gráfico.

Las regiones de datos de matriz podrían tener más de una fuente de distribución de datos, según la estructura de la matriz. El diagrama siguiente muestra un informe que utiliza una matriz que genera dos fuentes de distribución de datos.

En el documento de servicio de Atom generado con este informe se incluyen dos fuentes de distribución de datos, una para cada una de las columnas dinámicas del mismo nivel: Territory y Year. El diagrama siguiente muestra el contenido de cada fuente de distribución de datos.

Fuentes de distribución de datos

La fuente de distribución de datos es un archivo XML que tiene un formato tabular coherente que no cambia con el tiempo y datos variables que pueden ser diferentes cada vez que se ejecuta el informe. Las fuentes de distribución de datos que genera Reporting Services están en el mismo formato que esas actividades generadas por ADO.NET Data Services.

Una fuente de distribución de datos contiene dos secciones: encabezado y datos. La especificación de Atom define los elementos en cada sección. El encabezado incluye información como el esquema de codificación de caracteres para utilizar con las fuentes de distribución de datos.

Sección de encabezado

El siguiente código XML muestra la sección de encabezado de una fuente de distribución de datos.

<?xml version="1.0" encoding="utf-8" standalone="yes"?><feed xmlns:d="https://schemas.microsoft.com/ado/2007/08/dataservices" xmlns:m="https://schemas.microsoft.com/ado/2007/08/dataservices/metadata" xmlns="http://www.w3.org/2005/Atom">

<title type="text"></title>

<id>uuid:1795992c-a6f3-40ec-9243-fbfd0b1a5be3;id=166321</id>

<updated>2009-05-08T23:09:58Z</updated>

Sección de datos

La sección de datos de las fuentes de distribución de datos contiene un elemento <entry> para cada fila del conjunto de filas planas generado por la extensión de representación de Atom.

El diagrama siguiente muestra un informe que utiliza grupos y totales.

En el código XML siguiente se muestra un elemento <entry> de ese informe en una fuente de distribución de datos. Como puede ver, en el elemento <entry> se incluyen los totales de ventas y pedidos del grupo, y los totales de ventas y pedidos de todos los grupos. En el elemento <entry> se incluyen todos los valores del informe.

<entry><id>uuid:1795992c-a6f3-40ec-9243-fbfd0b1a5be3;id=166322</id><title type="text"></title><updated>2009-05-08T23:09:58Z</updated><author /><content type="application/xml"><m:properties>

<d:ProductCategory_Value>Accessories</d:ProductCategory_Value>

<d:OrderYear_Value m:type="Edm.Int32">2001</d:OrderYear_Value>

<d:SumLineTotal_Value m:type="Edm.Decimal">20235.364608</d:SumLineTotal_Value>

<d:SumOrderQty_Value m:type="Edm.Int32">1003</d:SumOrderQty_Value>

<d:SumLineTotal_Total_2_1 m:type="Edm.Decimal">1272072.883926</d:SumLineTotal_Total_2_1>

<d:SumOrderQty_Total_2_1 m:type="Edm.Double">61932</d:SumOrderQty_Total_2_1>

<d:SumLineTotal_Total_2_2 m:type="Edm.Decimal">109846381.399888</d:SumLineTotal_Total_2_2>

<d:SumOrderQty_Total_2_2 m:type="Edm.Double">274914</d:SumOrderQty_Total_2_2></m:properties></content>

</entry>

Trabajo con fuentes de distribución de datos

Todas las fuentes de distribución de datos generadas incluyen los elementos de informe que están en el ámbito del elemento primario de la región de datos que las genera. Imagine un informe con varias tablas y un gráfico. Los cuadros de texto del cuerpo del informe proporcionan texto descriptivo de cada región de datos. Cada entrada de cada fuentes de distribución de datos que el informe genera incluye el valor del cuadro de texto. Por ejemplo, si el texto es "El gráfico muestra el promedio de ventas mensuales por región de ventas", las tres fuentes de distribución de datos incluirían este texto en cada fila.

Si el diseño del informe incluye relaciones de datos jerárquicas, como regiones de datos anidadas, esas relaciones se incluyen en el conjunto de filas planas de datos del informe.

Las filas de datos de las regiones de datos anidadas suelen ser anchas, sobre todo si las tablas anidadas y las matrices incluyen grupos y totales. Podría encontrar de utilidad exportar el informe a una fuente de distribución de datos y ver esta para comprobar que los datos generados son lo que esperaba.

Cuando la extensión de representación Atom crea el documento de servicio Atom, se crea un identificador único para la fuente de distribución de datos y el identificador se usa en la dirección URL para ver el contenido de la misma. El documento de servicio de Atom de ejemplo, mostrado anteriormente, incluye la dirección URL https://ServerName/ReportServer?%2fProduct+Sales+Summary&rs%3aCommand=Render&rs%3aFormat=ATOM&rc%3aItemPath=Tablix1. La dirección URL identifica el informe (resumen de ventas de producto), el formato de representación de Atom (ATOM) y el nombre del elemento de informe (Tablix1).

Los nombres de los elementos de informe tienen como valor predeterminado los nombres de los elementos de lenguaje RDL (Report Definition Language) de los elementos de informe y, a menudo, no son intuitivos ni fáciles recordar. Por ejemplo, el nombre predeterminado de la primera matriz colocada en un informe es Tablix1. Las fuentes de distribución de datos usan estos nombres.

Para que le resulte más fácil trabajar con la fuente de distribución de datos, puede usar la propiedad DataElementName de la región de datos para proporcionar nombres descriptivos. Si proporciona un valor para DataElementName, el subelemento de la fuente de distribución de datos <d> lo usará en lugar del nombre de región de datos predeterminado. Por ejemplo, si el nombre predeterminado de una región de datos es Tablix1 y DataElementName y establece SalesByTerritoryYear, el <d> en la fuente de distribución de datos usa SalesByTerritoryYear. Si la región de datos tiene dos fuentes de distribución de datos como el informe de matriz descrito anteriormente, los nombres usados en las fuentes de distribución de datos son SalesByTerritoryYear _Territory y SalesByTerritoryYear _Year.

Si compara los datos mostrados en el informe y los de las fuentes de distribución de datos, podría observar algunas diferencias. Los informes suelen mostrar datos de fecha y hora, y datos con formato numérico, mientras que la fuente de distribución de datos contiene datos sin formato.

Una fuente de distribución de datos se guarda con la extensión de nombre de archivo .atom. Puede utilizar un editor XML o de texto, como el Bloc de notas, o el Editor XML para ver la estructura de archivos y el contenido.

Aplanar los datos de informe

El representador de Atom proporciona los datos del informe en forma de conjuntos de filas planas en un formato XML. Las reglas para quitar información de estructura jerárquica de las tablas de datos son las mismas que las reglas del procesador de CSV con pocas excepciones:

• La información de estructura jerárquica de los elementos del ámbito se quitan hasta el nivel de detalle. A diferencia del representador de CSV, los cuadros de texto en el nivel superior aparecen en cada entrada escrita en la fuente de distribución de datos.

• Los valores de parámetro de informe se representan en cada fila de la salida.

Para que los datos jerárquicos y los datos agrupados puedan representarse en el formato compatible con Atom, es necesario quitar la información de estructura jerárquica. La extensión de representación quita información de estructura jerárquica en el informe y lo convierte en una estructura de árbol que representa los grupos anidados dentro de la región de datos. Al aplanar un informe, se producen los siguientes resultados:

• La jerarquía de fila se aplana antes que de las jerarquías de columna.

• Los miembros de la jerarquía de filas se representan en la fuente de distribución de datos antes que los miembros de la jerarquía de columnas.

• Las columnas se ordenan de la manera siguiente: los cuadros de texto del cuerpo se ordenan de izquierda a derecha y de arriba abajo seguidos por las regiones de datos, que se ordenan de izquierda a derecha y de arriba abajo.

• Las columnas de una región de datos se ordenan de la manera siguiente: los miembros de las esquinas, los miembros de la jerarquía de fila, los miembros de la jerarquía de columna y, a continuación, las celdas.

• Las regiones de datos del mismo nivel son regiones de datos o grupos dinámicos que comparten una región de datos común o un antecesor dinámico. Los datos del mismo nivel se identifican creando una bifurcación del árbol sin información de estructura jerárquica.

Para obtener más información, vea Tablas, matrices y listas (Generador de informes y SSRS).

Reglas de representación de Atom

La extensión de representación de Atom omite la información siguiente al representar una fuente de distribución de datos:

• Formato y diseño

• Encabezado de página

• Pie de página

• Elementos de informes personalizados

• Rectángulos

• Líneas

• Imágenes

• Subtotales automáticos

El resto de los elementos del informe se ordenan, de arriba a abajo y de izquierda a derecha. Cada elemento se representa en una columna. Si el informe contiene elementos de datos anidados, como listas o tablas, los elementos primarios se repiten en cada fila.

En la tabla siguiente se indica el aspecto de los elementos de informe cuando se representan:

Elemento	Comportamiento de la representación
Tabla	Realiza la representación mediante la expansión de la tabla y la creación de una fila y una columna para cada fila y columna del nivel máximo de detalle. Las filas y columnas de subtotal no tienen encabezados de columna ni de fila. No se admiten informes detallados.
Matrix	Realiza la representación mediante la expansión de la matriz y la creación de una fila y una columna para cada fila y columna del nivel máximo de detalle. Las filas y columnas de subtotal no tienen encabezados de columna ni de fila.
List	Representa un registro para cada instancia o fila de detalle de la lista.
Subinforme	El elemento primario se repite en todas las instancias del contenido.
Gráfico	Representa un registro con todas las etiquetas de gráfico de cada valor de gráfico. Las etiquetas de las series y las categorías de las jerarquías se quitan y se incluyen en la fila de un valor de gráfico.
Barra de datos	Se representa como un gráfico. Normalmente, una barra de datos no incluye jerarquías ni etiquetas.
Minigráfico	Se representa como un gráfico. Normalmente, un minigráfico no incluye jerarquías ni etiquetas.
Indicador	Se representa como un único registro con los valores máximo y mínimo de la escala lineal, los valores inicial y final del intervalo, y el valor del puntero.
Indicador	Se representa como un único registro con el nombre del estado activo, los estados disponibles y el valor de los datos.
Map	Genera una fuente de distribución de datos para cada región de datos del mapa. Si varias capas de mapa utilizan la misma región de datos, las fuentes de distribución de datos los incluyen a todos. Las fuentes de distribución de datos incluyen un registro con las etiquetas y valores para cada miembro de mapa de la capa de mapa.

Valores de configuración de la información del dispositivo

Puede cambiar parte de la configuración predeterminada de este representador, incluido el esquema de codificación que se desea utilizar. Para obtener más información, consulte Configuraciones de información del dispositivo ATOM.

Contenido relacionado

• Exportación a un archivo CSV
• Exportación de informes

¿Tiene alguna pregunta más? Puede plantear sus dudas en el foro de Reporting Services.