Uso de SQL Server 2005 Reporting Services con SAP NetWeaver Business Intelligence

Principio de la página

Información general de la instalación

Los ensamblados requeridos para usar el proveedor se instalan junto con el Service Pack 1 (SP1) en dos ubicaciones individuales: una ubicación para el entorno de diseño (Business Intelligence Development Studio) y otra para el entorno de tiempo de ejecución (Report Server). La instalación de SP1 copia los archivos en las ubicaciones correspondientes para cada entorno instalado. La instalación se ejecuta en ambas ubicaciones si los entornos de tiempo de ejecución y de diseño están en el mismo equipo. Si sólo se dispone de uno de los entornos al instalar SP1 pero el otro se instala posteriormente, debe volver a ejecutar la instalación de SP1 para instalar los ensamblados requeridos para el nuevo entorno agregado.

Después de instalar el proveedor, debe registrarlo en los entornos para los que se usará. Para el entorno de diseño, debe modificar el archivo RSReportDesigner.config, ubicado en <unidad>:\Archivos de programa\Microsoft Visual Studio 8\Common7\IDE\PrivateAssemblies. Para el entorno de tiempo de ejecución, debe modificar el archivo RSReportServer.config, ubicado en <unidad>:\Archivos de programa\Microsoft SQL Server\MSSQL.n\Reporting Services\ReportServer. Consulte los Libros en pantalla de SQL Server 2005 Service Pack 1 (en inglés) para obtener detalles sobre la configuración.

Figura 1: cuadro de diálogo Selección de cubo.
Ver imagen en tamaño completo

Variables

Las variables de SAP son una forma de crear parámetros de un QueryCube similar a la característica de parámetro de Analysis Services 2005. Ambas permiten la creación de parámetros de los resultados de consultas de MDX al margen de la sintaxis de MDX estándar. Los parámetros de Analysis Services funcionan mediante la creación de parámetros de las consultas de MDX, mientras que las variables de SAP crean parámetros de QueryCube. Esto da lugar a algunas diferencias importantes:

Microsoft .NET Data Provider 1.0 para SAP NetWeaver BI asigna las variables a parámetros de consulta. El proveedor toma el valor de parámetro especificado por el usuario y modifica la consulta para asignar dicho valor a la variable correspondiente.

Al abrir un QueryCube para el que se ha definido una variable, se habilita el cuadro de diálogo Variables. Este cuadro de diálogo enumera en una lista todas las variables definidas y le permite asignar un valor predeterminado a cada variable. Al asignar un valor a una variable, el proveedor genera automáticamente el parámetro de informe correspondiente. Sin embargo, a diferencia de la característica de parámetro de Analysis Services, no se genera una lista de los valores disponibles para el parámetro de informe. Para definir manualmente una lista de valores, siga las instrucciones de la sección Rellenar los valores de parámetro del informe de este artículo.

Se admiten varios tipos de variable. El cuadro de diálogo Variables ofrece un control de selección diferente para cada tipo de variable.

Principio de la página

Consejos y trucos

Esta sección explica algunas técnicas para trabajar con características de Microsoft .NET Data Provider 1.0 para SAP NetWeaver Business Intelligence.

Prueba del proveedor XML/A para SAP BW  con Internet Explorer

Una forma rápida de comprobar que el proveedor XML/A para SAP BW se ha configurado correctamente y que se tiene acceso a los datos de SAP es a través del uso de Internet Explorer para abrir la URL del proveedor XML/A. Si la conexión al proveedor es correcta, debería ver las descripción XML del servicio web, como en la figura 2.

Figura 2: prueba del proveedor XML/A para SAP BW mediante Internet Explorer.
Ver imagen en tamaño completo

Habilitación de QueryCube para el acceso XML/A

Para que un QueryCube sea visible en la interfaz XML/A para SAP BW, éste debe estar configurado para habilitar el acceso externo (desde fuera de BW). Siga los pasos siguientes para habilitar el acceso remoto al QueryCube:

1.	Abra el BEx Query Designer.
2.	En el cuadro de diálogo Query Properties, haga clic en la ficha Extended.
3.	Active la casilla de verificación Allow External Access to this Query y, a continuación, haga clic en OK. Figura 3: configuración de un QueryCube para acceso externo. Ver imagen en tamaño completo

Especificación de parámetros de inicio de sesión adicionales en SAP (cliente e idioma)

SAP BW puede aceptar un número de cliente y un idioma como parámetros de inicio de sesión. Para especificar estos parámetros en el origen de datos, puede incrustarlos directamente en su URL de conexión, como se muestra en este ejemplo:

Data Source=http://sap8:8000/sap/bw/xml/soap/xmla?sap-client= 100&sap-language=EN

Si no especifica el número de cliente o el idioma, el servidor usará los valores predeterminados que se configuraron en el servidor. El parámetro sap-language puede aceptar una especificación de idioma de SAP de un carácter o una especificación de idioma ISO 639 de dos caracteres.

Configuración del sistema para establecer comunicaciones seguras

Se recomienda encarecidamente el uso de las conexiones SSL para todas las comunicaciones que se establecen entre Reporting Services y un servidor SAP BW. Si desea usar SSL, el servidor SAP BW debe estar configurado para aceptar conexiones HTTPS y se debe usar “https” en la cadena de conexión para el origen de datos.

Todos los equipos que usen origen de datos SSL deben tener instalado un certificado de cliente. Aquí se incluyen el servidor de informes y los equipos que los autores de informes usan para diseñar informes mediante Reporting Services en Business Intelligence Development Studio. Los usuarios de informes que tienen acceso a los mismos mediante la Web no necesitan tener instalado un certificado SAP BW. Para instalar un certificado en el equipo cliente, siga estos pasos:

Después de instalar el certificado, el equipo debe tener acceso al origen de datos SSL.

Depuración de MDX en el sistema SAP BW

Los usuarios avanzados pueden estar interesados en probar las consultas de MDX sin procesar directamente en el sistema SAP BW. Esto resulta muy útil en caso de que la consulta no se ejecute correctamente. Ejecutar directamente la consulta en el servidor puede ayudar a aislar el origen del problema. Al usar la interfaz gráfica de usuario de SAP, use la transacción MDXTEST para ver el editor de MDX que le permitirá ejecutar consultas de MDX sin procesar y ver los resultados. Esto evita la interfaz XML/A y envía las consultas de MDX directamente al servidor.

Trabajo con propiedades

Al agregar un nodo a una consulta, el generador de consultas crea una instrucción de MDX que solicita la propiedad predeterminada (la que se ve en la vista previa de datos) y algunas propiedades adicionales más. Para las cifras clave, la propiedad predeterminada es el valor numérico sin procesar; sin embargo, también está disponible el valor con formato, así como la representación de la cadena con formato. Para los miembros de dimensión, la propiedad predeterminada es el título descriptivo, aunque también puede usar la propiedad de un solo nombre del miembro.

Las propiedades de celda siguientes están disponibles para las cifras clave:

Las propiedades de metadatos siguientes están disponibles para las dimensiones:

Cuando dispone el orden los campos de un informe en la ficha de diseño del diseñador de informes, puede incluir un campo en el informe arrastrándolo hasta la superficie de diseño. La propiedad Valor del campo se agrega al informe de forma predeterminada. Para usar alguna de las otras propiedades, puede editar la expresión del cuadro de texto para hacer referencia a ella mediante la sintaxis Fields!FieldName.PropertyName, como se muestra en la figura 4.

Figura 4: especificación de propiedades alternativas durante el diseño de informe.
Ver imagen en tamaño completo

Además de las propiedades mencionadas anteriormente, algunas dimensiones presentan propiedades adicionales específicas que se definen en SAP BW. Estas propiedades adicionales se presentan como nodos de la carpeta Propiedades de miembro en la vista de árbol de metadatos. Para que estas propiedades estén disponibles en un informe, arrastre el nodo a la superficie de diseño. La figura 5 muestra el diseñador de consultas después de agregar la propiedad Nombre del grupo Material a la consulta.

Figura 5: inclusión de una propiedad de miembro en una consulta.
Ver imagen en tamaño completo

Para usar la propiedad que se acaba de agregar al informe, modifique la expresión en el cuadro de texto de la superficie de diseño con el fin de usar la sintaxis Fields!FieldName("PropertyName") como se muestra en la figura 6.

Figura 6: Especificación de una propiedad de miembro durante el diseño.
Ver imagen en tamaño completo

También puede crear manualmente un campo para representar una de estas propiedades. Para ello, en el panel Conjuntos de datos, haga clic con el botón secundario en el conjunto de datos y, a continuación, haga clic en Agregar. En el cuadro de diálogo Agregar nuevo campo, escriba un nombre para el campo nuevo y seleccione la opción Campo calculado. Escriba una expresión que defina el campo en el cuadro de texto o haga clic en el botón Generador de expresiones para crear una expresión. En la figura 7 se muestra un campo que hace referencia a la misma propiedad que aparece en la figura 6, pero en la figura 7 se ha usado el nombre técnico en la definición del campo. Se puede tener acceso a una propiedad mediante el nombre descriptivo o el técnico.

Figura 7: adición de un campo de propiedad nuevo.

Después de crear un campo, puede incluirlo en un informe si lo arrastra a la superficie del informe.

Asignación de valores de variable sin usar los parámetros de informe

Al asignar un valor a una variable, el generador de consultas crea parámetros del informe automáticamente según dicha variable. Puede que desee asignar un valor estático a la variable en un informe concreto, en lugar de facilitar al usuario del informe la posibilidad de cambiar el valor. Para ello, asigne un valor a la variable y, a continuación, abra el cuadro de diálogo Report Parameters y seleccione el parámetro de informe correspondiente. Seleccione la opción Interno para el parámetro de informe y, a continuación, seleccione la opción Permitir valor NULL, como se muestra en la figura 8. En el grupo de valores predeterminados, seleccione NULL como valor predeterminado. Haga clic en Aceptar para cerrar el cuadro de diálogo Report Parameters.

Al hacerlo, se deshabilita el parámetro de informe, lo que obliga a que se use el valor de variable que se especificó al principio cuando se creó la variable en el cuadro de diálogo Variables. El usuario no tendrá la opción de especificar un valor para este parámetro.

Figura 8: deshabilitación de un parámetro de informe.
Ver imagen en tamaño completo

Rellenar los valores de parámetro del informe

Mediante los parámetros de informe de Reporting Services, podrá especificar un conjunto de valores del que los usuarios puedan elegir cuando se ejecute un informe. Resulta adecuado configurar una lista de valores posibles para los parámetros, porque facilitará notablemente el uso del informe para los usuarios. Puede escribir manualmente el conjunto de valores posibles para los parámetros mediante la opción No consultado, o bien, puede configurar el informe para que solicite al servidor una lista de los valores posibles. El procedimiento siguiente muestra la forma de rellenar una lista de valores mediante una consulta. Se da por hecho que está trabajando con un QueryCube que ya tiene una variable definida.

1.	Haga clic en Variables para abrir el cuadro de diálogo Variables.
2.	Asigne un valor predeterminado a la variable y, a continuación, haga clic en Aceptar. Esto genera el parámetro de informe correspondiente.
3.	En la lista desplegable Conjunto de datos, seleccione <Nuevo conjunto de datos…> para abrir el cuadro de diálogo Conjunto de datos.
4.	Seleccione el mismo origen de datos del conjunto de datos original. Otorgue un nombre descriptivo al conjunto de datos, como “VAR1_ParameterValues”.
5.	En el panel Metadatos, haga clic en el cubo que contiene la jerarquía primaria de la variable que está configurando. Normalmente es el mismo cubo que el de su conjunto de datos original.
6.	Arrastre la jerarquía primaria a la superficie Diseño.
7.	Haga clic en Actualizar campos para rellenar la lista de campos del conjunto de datos. Debe ver uno o varios campos que se corresponden con la jerarquía recién agregada. Los datos aparecen en el panel de conjuntos de datos debajo del conjunto de datos nuevo, como se muestra en la figura 9. Figure 9: creación de una consulta para un parámetro de informe. Ver imagen en tamaño completo
8.	Haga clic con el botón secundario en el conjunto de datos nuevo y, a continuación, en Agregar. De este modo creará un campo nuevo para cada miembro de la jerarquía que contenga el nombre único del miembro. Se asignarán las variables a los valores según los nombres técnicos de los miembros.
9.	En el cuadro de diálogo Agregar nuevo campo, especifique la propiedad UniqueName como el valor de campo calculado para el campo nuevo. Se muestra un ejemplo en la figura 10. Figure 10: creación de un campo de nombre único.
10.	En el menú Informe, seleccione Report Parameters para abrir el cuadro de diálogo Report Parameters.
11.	En la sección Valores disponibles, seleccione el conjunto de datos nuevo de la lista desplegable Conjunto de datos. En el cuadro de texto del campo Valor, seleccione el campo de nombre único que acaba de crear. En el campo Etiqueta, seleccione el nombre de campo original, como se muestra en la figura 11.
12.	Haga clic en Aceptar para cerrar el cuadro de diálogo. Figure 11: rellenar los valores disponibles desde un conjunto de datos. Ver imagen en tamaño completo

El usuario del informe tiene ahora una lista desplegable rellenada con los valores posibles para el parámetro de informe. La figura 12 muestra la lista desplegable en la pantalla de vista previa de Business Intelligence Development Studio. La misma lista desplegable estará disponible para los usuarios cuando vean el informe.

Figura 12: parámetro de informe rellenado con los valores de una consulta.
Ver imagen en tamaño completo

Rellenar los parámetros con los valores de un nodo de jerarquía de varios niveles

En el procedimiento anterior, el conjunto de valores de parámetro de informe sólo se puede rellenar desde un campo del conjunto de datos. Sin embargo, en un conjunto de datos, los miembros de niveles distintos de una jerarquía aparecen siempre en columnas individuales y, por lo tanto, en campos individuales. Esto es consecuencia del algoritmo de simplificación definido en la especificación OLE DB para OLAP. ¿Cómo podemos entonces rellenar los valores para una variable con miembros de niveles diferentes de una jerarquía, si los valores de niveles diferentes siempre aparecen en campos individuales? En SAP BW, las variables del nodo de jerarquía pueden aceptar variables de cualquier nivel de la jerarquía.

La solución es modificar la instrucción de MDX, de forma que los valores “All” agregados desde el nivel primario se incluyan en la columna resultante y, a continuación, usar las funciones de Reporting Services para seleccionar el valor correcto. En esta sección, verá paso a paso el proceso para crear un conjunto de parámetros para una jerarquía de varios niveles.

Para asimilar bien esta técnica, debe comprender la función básica del algoritmo de simplificación. El algoritmo de simplificación, que tiene sólo en cuenta una propiedad de dimensión única y una jerarquía única en los ejes distintos del eje-0, indica la presencia de una columna para cada nivel de la jerarquía, desde la parte superior de la jerarquía en sentido descendente hasta el nivel más cercano a la hoja. Sin embargo, la consulta predeterminada generada por el diseñador de consultas al arrastrar una jerarquía al panel de diseño selecciona todos los miembros sólo a partir del nivel de hoja inferior. La instrucción de MDX siguiente representa la consulta predeterminada creada al arrastrar la jerarquía a la superficie de diseño:

SELECT 
NON EMPTY {[Measures].[1MEHY2C418T0QYBP2KX9KQBG6]} ON COLUMNS, 
NON EMPTY {[0D_COUNTRY                    PM_COUNTRY].[LEVEL02].ALLMEMBERS
} 
DIMENSION PROPERTIES MEMBER_CAPTION, MEMBER_UNIQUE_NAME ON ROWS 
FROM [0D_PU_C01/ZD_PU_C01_VAR1] CELL PROPERTIES VALUE
        

En la consulta de ejemplo, el conjunto de resultados devuelto contiene una columna para cada nivel que no tenga el valor ALL de la jerarquía, en sentido descendente hasta el nivel inferior especificado, como se muestra en la figura 13.

Figura 13: conjunto de resultados de una consulta de jerarquía predeterminada.

Ahora, cambie a modo de MDX y modifique la consulta de modo que se incluyan todos los miembros definidos con “All”. En lugar de seleccionar sólo los miembros del nivel de hoja, modifique la instrucción MDX para seleccionar todos los miembros de la jerarquía completa.

SELECT 
NON EMPTY {[Measures].[1MEHY2C418T0QYBP2KX9KQBG6]} ON COLUMNS, 
NON EMPTY {[0D_COUNTRY                    PM_COUNTRY].ALLMEMBERS} 
DIMENSION PROPERTIES MEMBER_CAPTION, MEMBER_UNIQUE_NAME ON ROWS 
FROM [0D_PU_C01/ZD_PU_C01_VAR1] CELL PROPERTIES VALUE
        

El conjunto de resultados de esta consulta se muestra en la figura 14. Las entradas vacías de la columna de hoja (PM_CountryLevel02) representan los miembros definidos con “All”, que son valores agregados al nivel primario. La primera fila, que contiene dos de estas entradas vacías, es el miembro ALL para la jerarquía completa. La segunda fila contiene EUROPE en la primera columna y una entrada vacía en la columna de hoja; es el miembro que representa “All” para Europa. La sexta fila contiene AMERICA en la primera columna y una entrada vacía en la columna de hoja; representa “All” para América. Este conjunto de datos nos ofrece una fila aparte para los miembros de la jerarquía que se deseen poner a disposición como valores posibles para la variable de nodo de jerarquía.

Figura 14: conjunto de resultados que incluye los miembros All

A continuación, crearemos algunos campos que consolidarán toda la información requerida. En primer lugar, cree un campo de etiqueta.

1.	Haga clic con el botón secundario en el conjunto de datos de parámetro de la ventana de conjunto de datos y, a continuación, haga clic en Agregar.
2.	En el cuadro de diálogo Agregar campo, escriba un nombre descriptivo para el campo: por ejemplo, PM_COUNTRY_Parameter_Labels.
3.	Seleccione la opción Campo calculado.
4.	Haga clic en el botón Generador de expresiones en el cuadro de texto Valor con el fin de crear una expresión que seleccione el valor de la columna del segundo nivel si no está vacía y en caso de que lo esté, el valor de la columna del primer nivel. Para ello, use la función IIf de Reporting Services: =IIf(Fields!PM_Country_Level_02.Value = "", Fields!PM_Country_Level_01.Value, Fields!PM_Country_Level_02.Value)
5.	Haga clic en Aceptar.
6.	Siga los pasos 1-3 para crear un campo que consolide todos los nombres únicos para el campo Valor.
7.	En el cuadro de texto Valor, escriba la siguiente fórmula: =IIf(Fields!PM_Country_Level_02.Value = "", Fields!PM_Country_Level_01.UniqueName, Fields!PM_Country_Level_02.UniqueName)
8.	Abra el cuadro de diálogo Report Parameter.
9.	En el grupo de valores disponibles, asigne el campo Valor y el campo Etiqueta a estos campos compuestos, como se muestra en la figura 15. Figura 15: asignación de valores de parámetro de informe mediante campos consolidados. Ver imagen en tamaño completo

El usuario del informe puede ahora seleccionar valores de niveles distintos de la jerarquía. Por ejemplo, en la figura 16, la lista desplegable contiene nodos del nivel de continente (EUROPE, AMERICA) y nodos del nivel de país (Germany, France, USA).

Figura 16: lista de selección de parámetros de niveles individuales de una jerarquía.
Ver imagen en tamaño completo

Puede propagar este método a una jerarquía con más niveles. Para ello, en la expresión de campo calculado, anide instrucciones IIf múltiples para cubrir los niveles que le interesan.

Este método se puede aplicar cuando desee que la lista de selección incluya todos los niveles en sentido descendente hasta el nivel de hoja. Sin embargo, si sólo desea las selecciones de algunos niveles superiores, debe modificar la instrucción MDX; en caso contrario, la lista de selección contendrá valores por duplicado. En lugar de seleccionar todos los miembros de la dimensión completa, use la función DRILLDOWNLEVEL de MDX para obtener los detalles del nivel deseado. Comience por el nivel superior en el que tenga interés y descienda para obtener los detalles hasta el nivel inferior deseado. El ejemplo siguiente de una instrucción MDX muestra cómo obtener los detalles desde el primer nivel dos veces, para conocer todos los miembros del primer al tercer nivel en sentido descendente.

SELECT 
NON EMPTY {[Measures].[57FQA4HFVVTQPYLPVV4RP673N] } ON COLUMNS, 
NON EMPTY {DRILLDOWNLEVEL(DRILLDOWNLEVEL([0D_DBSIC1
BRANCHE SIC_HIERARCHIE].[LEVEL01].ALLMEMBERS))} 
DIMENSION PROPERTIES MEMBER_CAPTION, MEMBER_UNIQUE_NAME ON ROWS 
FROM [0D_DX_C02/Z_DX_TEST] CELL PROPERTIES VALUE
	

El conjunto de filas resultante es similar al de la figura 17.

Figura 17: conjunto de resultados de una consulta para la obtención de detalles en sentido descendente.
Ver imagen en tamaño completo

Ahora puede definir los campos calculados en el informe para consolidar los valores de las distintas columnas mediante la técnica descrita anteriormente.

Especificación de los intervalos de valores a través de Report Parameters

Como se ha descrito en la sección Variables, puede crear variables que tomen valores múltiples o que tomen un intervalo de valores. Las variables definidas como variables interval pueden aceptar un especificador de intervalos como valor. En un especificador de intervalos, se define un valor superior e inferior; todos los valores comprendidos en ese intervalo se usan automáticamente como valores en la consulta. Si desea que el usuario pueda especificar un intervalo de valores, también debe especificar que el parámetro del informe es un parámetro multivalor. Para crear un parámetro multivalor, en el cuadro de diálogo Report Parameters, seleccione la opción Multi-value.

Si el proveedor recibe valores múltiples para una variable que se ha definido como una variable de intervalo, tomará los dos primeros valores como los especificadores de intervalo superior e inferior respectivamente. Si el proveedor recibe un único valor, sólo éste se pasará a la variable.

Si desea definir una variable como variable de intervalo, abra el SAP BW Variables Wizard o el BEx Query Designer. En el cuadro de diálogo SAP BW Variables Editor, seleccione Interval como el valor en la lista Variable Represents.

Principio de la página

Solución de problemas

Al intentar ver un informe, el servidor de informes muestra este mensaje:
“Se ha intentado utilizar una extensión de datos 'SAPBW' que no está registrada en este servidor de informes.”

Este error indica que el servidor de informes no se ha configurado correctamente. Consulte la sección Información general de la instalación para obtener más información sobre el registro del proveedor con el servidor de informes.

La vista de árbol de metadatos muestra un nodo de error con el mensaje siguiente:
“Error al recuperar nodos secundarios: Guid debe contener 32 dígitos con 4 guiones (xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx).”

Este es un problema habitual en los servidores SAP BW 3.5 del nivel de Service Pack 15 (referencia de nota en SAP: 893807). para solucionar este problema, actualice el servidor SAP BW al nivel de Service Pack 16 o posterior.

No puedo realizar operaciones aritméticas en los datos de cifras clave porque los valores se devuelven en cadenas con formato.

La propiedad ReturnCellProperties de XML/A permite especificar el formato de los datos de la celda mediante la cláusula CELL PROPERTIES de MDX. La compatibilidad con esta propiedad se agregó en el nivel de Service Pack 16 (referencia de nota en SAP: 895234). después de instalar este Service Pack, los valores predeterminados devueltos a la extensión son valores numéricos sin formato. Sin embargo, aún puede tener acceso a la propiedad de valores con formato mediante el método FormattedValue en Reporting Services.

Las consultas que hacen referencia a dimensiones múltiples no se ejecutan correctamente en el servidor.

Existe un problema conocido con BW3.5 SP11 y SP12 que provoca que el servidor procese los cross-joins en una memoria sin resultados. Por lo tanto, las consultas con cross-joins grandes pueden producir un error cuando se agota la memoria del servidor. Este problema se ha solucionado a partir de SP13 (referencia de nota en SAP: 836849).

en modo de MDX, la consulta tiene al menos un eje y el primer eje contiene un conjunto vacío. Sin embargo, muestra el mensaje de error “No se puede preparar la consulta: La consulta debe tener como mínimo un eje. El primer eje de la consulta no debe tener múltiples jerarquías ni debe hacer referencia a otra dimensión que no sea la dimensión Medidas."

Esto se debe a un problema con la forma en que SAP BW administra las consultas que no hacen referencia a la dimensión Medidas. Es probable que este problema se solucione en un Service Pack futuro. De momento, haga siempre referencia a una medida, como mínimo, en el primer eje.