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.
Report Definition Language (RDL) es una representación XML de una definición de informe de SQL Server Reporting Services. Una definición de informe contiene información acerca de la recuperación y el diseño de los datos de un informe. RDL está formado por elementos XML que cumplen la sintaxis XML creada para Reporting Services. Puede agregar sus propias funciones personalizadas para controlar los valores de los elementos del informe, los estilos y el formato mediante el acceso a conjuntos de código dentro de los archivos de definición de informes.
RDL promueve la interoperabilidad de productos de generación de informes comerciales al definir un esquema común que habilita el intercambio de definiciones de informe. Cualquier protocolo o interfaz de programación que funciona con XML se puede utilizar con RDL. RDL es:
Un esquema XML para las definiciones de informe.
Un formato de intercambio para las empresas y otros fabricantes.
Esquema extensible y abierto que admite espacios de nombres adicionales y elementos personalizados.
Especificaciones de RDL
Para descargar las especificaciones de versiones específicas de esquema, vea Especificación del lenguaje RDL.
Definición de esquema XML de RDL
Un archivo del lenguaje de definición de informes (RDL) de SQL Server Reporting Services se valida mediante un archivo de definición de esquema XML (XSD). El esquema define las reglas para dónde se pueden producir elementos RDL en un archivo .rdl. Un elemento incluye su tipo de datos y cardinalidad, es decir, el número de repeticiones permitidas. Los elementos pueden ser simples o complejos. Un elemento simple no tiene elementos secundarios ni atributos. Un elemento complejo tiene hijos y, opcionalmente, atributos.
Por ejemplo, el esquema incluye el elemento ReportParametersRDL , que es el tipo ReportParametersTypecomplejo . Por convención, un tipo complejo para un elemento es el nombre del elemento seguido de la palabra Type. Un ReportParameters elemento puede estar contenido por el Report elemento (un tipo complejo) y puede contener ReportParameter elementos. Un ReportParameterType es un tipo simple que solo puede ser uno de los siguientes valores: Boolean, DateTime, Integer, Floato String. Para obtener más información sobre los tipos de datos de esquema XML, vea Parte 2 del esquema XML: tipos de datos Segunda edición.
El XSD de RDL está disponible en el archivo ReportDefinition.xsd, que se encuentra en la carpeta Extras del CD-ROM del producto. También está disponible en el servidor de informes a través de la siguiente dirección URL: https://servername/reportserver/reportdefinition.xsd.
Creación de RDL
Debido a la naturaleza abierta y extensible de RDL, se pueden crear diversas herramientas y aplicaciones que generan RDL en función de su esquema XML.
Reporting Services proporciona varias herramientas para crear archivos RDL. Para obtener más información, vea Herramientas de Reporting Services.
Una de las formas más fáciles de generar RDL desde una aplicación es usar las clases de Microsoft .NET Framework del System.Xml espacio de nombres y System.Linq espacio de nombres. Una clase en particular, la clase XmlTextWriter , se puede usar para escribir RDL. Con XmlTextWriter, puede generar una definición de informe completa en cualquier aplicación .NET Framework . Los desarrolladores también pueden ampliar RDL agregando elementos de informe personalizados con propiedades personalizadas. Para obtener más información sobre la clase XmlTextWriter y el System.Xml espacio de nombres, consulte la Guía del desarrollador de Microsoft .NET Framework. Para obtener más información sobre Language-Integrated Consulta (LINQ), busque "LINQ to XML" en MSDN.
La extensión de archivo estándar para los archivos de definición de informe es .rdl. También puede desarrollar archivos de definición para informes de clientes, que tienen la extensión .rdlc. El tipo MIME para ambas extensiones es text/xml. Para obtener más información sobre los informes, vea Reporting Services Reports (SSRS).
Tipos de RDL
En la tabla siguiente se enumeran los tipos usados en los atributos y elementos del lenguaje RDL.
| Tipo | Descripción |
|---|---|
Binary |
Una propiedad con un valor binario codificado de base 64. |
Boolean |
Propiedad con true o false como valor del objeto . A menos que se especifique lo contrario, el valor de un objeto booleano opcional omitido es False. |
Date |
Propiedad con un valor completo de fecha o fecha y hora especificado con el formato de fecha ISO8601: AAAA-MM-DD[THH:MM[:SS[.S]]]. |
Enum |
Propiedad con un valor de texto de cadena que debe estar en una lista de valores designados. |
Float |
Propiedad con un valor de tipo Float. Se utiliza un punto (.) como separador decimal opcional. |
Integer |
Propiedad con un valor de tipo Integer (int32). |
Language |
Propiedad con un valor de texto que contiene un código de idioma y referencia cultural, como "es-es" para español de España. El valor debe ser un idioma específico o un idioma neutro para el que se defina un idioma predeterminado en Microsoft .NET Framework. |
Name |
Propiedad con un valor de texto de cadena. Los nombres deben ser únicos en el espacio de nombres del elemento. Si no se especifica, el espacio de nombres de un elemento es el objeto contenedor más interno que tiene un nombre. |
NormalizedString |
Propiedad con un valor de texto de cadena que se ha normalizado. |
Size |
Un elemento de tamaño debe contener un número (con un punto utilizado como separador decimal opcional). El número debe ir seguido de un designador para una unidad de longitud CSS como cm, mm, in, pt o pc. Dejar un espacio entre el número y el designador es opcional. Para obtener más información sobre los designadores de tamaño, vea Referencia de unidades de longitud CSS. En RDL, el valor máximo de Size es 160 in. El tamaño mínimo es de 0 pulgadas. |
String |
Propiedad con un valor de texto de cadena. |
UnsignedInt |
Una propiedad con un valor de tipo Integer (uint32) sin signo. |
Variant |
Una propiedad con cualquier tipo XML sencillo. |
Tipos de datos de RDL
La enumeración DataType define el tipo de datos de un atributo, expresión o parámetro en RDL. En la tabla siguiente se muestra cómo se corresponden los tipos de datos CLR (Common Language Runtime) con los tipos de datos RDL.
| Tipos CLR | Tipo de datos correspondiente |
|---|---|
| Booleano | Booleano |
| DateTime, DateTimeOffset | Fecha y hora |
| Int16, Int32, UInt16, Byte, SByte | Entero |
| Single, Double | Flotar |
| String, Char, GUID, Timespan | Cuerda |
Véase también
Localizar la versión del esquema de definición de informes (SSRS)
Uso de ensamblados personalizados con informes
Elementos de informe personalizados