Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
La extensión de representación Atom de Reporting Services genera un documento de servicio Atom que enumera las fuentes de datos disponibles de un informe paginado y las fuentes de datos de las regiones de datos de un informe. Use esta extensión para generar fuentes de datos conformes con Atom que sean legibles y puedan intercambiarse con aplicaciones capaces de consumir fuentes de datos generadas a partir de informes. Por ejemplo, puede utilizar la extensión de representación Atom para generar canales de datos que después puede usar en Power Pivot o Power BI.
El documento de servicio de Atom enumera al menos un canal de datos por 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, una fuente 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 funciones incluyen la seguridad, la programación y las capturas de informes para administrar los informes que proporcionan fuentes 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 utiliza informes existentes, resulta útil poder predecir qué flujos de datos generan los informes. 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.
El documento de servicio Atom generado a partir de este informe incluye dos fuentes de datos, una por cada una de las columnas de pares dinámicas: 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 datos generadas por Reporting Services tienen el mismo formato que las 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.
El siguiente XML muestra un elemento <entry> de ese informe en un canal 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>
Trabajar con fuentes 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 facilitar el trabajo con la fuente de datos, puede usar la propiedad DataElementName de la región de datos para proporcionar nombres legibles. 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 establece SalesByTerritoryYear, entonces el <d> de la fuente 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 datos se guarda con la extensión 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 aplanar las tablas de datos son las mismas que las del renderizador CSV, con algunas 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 los parámetros del informe se muestran en cada fila del resultado.
Los datos jerárquicos y agrupados deben aplanarse para poder representarse en un formato compatible con Atom. 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. Cuando se aplana 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 del renderizado |
|---|---|
| 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. |
| Lista | 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 del gráfico para cada valor del 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. |
| Mapa | 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. El flujo de datos incluye un registro con las etiquetas y los valores de cada elemento del mapa de la capa del mapa. |
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.