Tipo de conexión de lista de SharePoint (SSRS)

Se aplica a: SQL Server 2016 (13.x) Power BI Report Server SharePoint

Para incluir los datos de una lista de Microsoft SharePoint en el informe, debe agregar o crear un conjunto de datos basado en un origen de datos de informe de tipo de lista de Microsoft SharePoint. Este es un tipo de origen de datos integrado que se basa en la extensión de datos de lista de SharePoint de Microsoft SQL Server Reporting Services. Utilice este tipo de origen de datos para recuperar los datos de las listas de SharePoint 2013 y versiones posteriores, así como para conectarse a ellos.

Utilice la información de este tema para crear un origen de datos. Para obtener instrucciones paso a paso, consulte Agregar y comprobar una conexión de datos o un origen de datos (Generador de informes y SSRS).

Cadena de conexión

La cadena de conexión a una lista de SharePoint es la dirección URL al sitio o subsitio de SharePoint; por ejemplo, https://MySharePointWeb/MySharePointSite o https://MySharePointWeb/MySharePointSite/Subsite.

El diseñador de consultas muestra automáticamente las listas de SharePoint para las que el usuario tiene los permisos necesarios para obtener acceso.

Para más ejemplos de cadenas de conexión, vea Creación de cadenas de conexión de datos - Generador de informes y SSRS.

Credenciales

Se necesitan credenciales para ejecutar consultas y obtener una vista previa del informe localmente y desde el servidor de informes. Después de publicar el informe, es posible que necesite cambiar las credenciales para el origen de datos de tal forma que, cuando el informe se ejecute en el servidor de informes, los permisos para recuperar los datos sean válidos. Los tipos de credenciales que se pueden utilizar con esta extensión de datos dependen de la configuración de la tecnología de SharePoint para la lista de SharePoint que se esté utilizando como origen de datos.

En las tablas siguientes se describe el comportamiento de recuperación de credenciales de la extensión de lista de SharePoint cuando se conecta a una lista de SharePoint de una granja local y a una lista remota de SharePoint.

Latabla 1 es para los informes implementados en un sitio heredado de Windows SharePoint. Un sitio heredado de Windows solo admite Kerberos, NTLM y Autenticación basada en formularios (FBA). Latabla 2 es para los informes implementados en un sitio de SharePoint basado en notificaciones.

Tabla 1

Tipo de recuperación	Credenciales admitidas	Autenticación de Windows de modo clásico	*Autenticación de notificaciones
Lista de SharePoint de granja local	Autenticación de Windows (integrada) o Token de usuario de SharePoint	Sí	Sí
	Almacenada, Pedir, Ninguna (con credenciales de Windows) No se admiten credenciales almacenadas y de petición con credenciales que no sean de Windows.	Sí	No
Lista remota de SharePoint	Autenticación de Windows (integrada) o Token de usuario de SharePoint	Sí	No La autenticación basada en formularios y la autenticación basada en notificaciones no se admiten para las listas remotas de SharePoint.
	Almacenada, Pedir, Ninguna (con credenciales de Windows) No se admiten credenciales almacenadas y de petición con credenciales que no sean de Windows.	Sí	No La autenticación basada en formularios y la autenticación basada en notificaciones no se admiten para las listas remotas de SharePoint.

*Autenticación de Windows, Autenticación basada en formularios (FBA), tokens de Secure Application Markup Language (SAML), otros proveedores de identidad o una combinación de más de uno de los proveedores de autenticación mencionados anteriormente.

Tabla 2

Tipo de recuperación	Credenciales admitidas	Autenticación de Windows de modo clásico	*Autenticación de notificaciones
Lista de SharePoint de granja local	Autenticación de Windows (integrada) o Token de usuario de SharePoint	Sí	Sí
	Almacenada, Pedir, Ninguna (con credenciales de Windows) No se admiten credenciales almacenadas y de petición con credenciales que no sean de Windows.	No	No
Lista remota de SharePoint	Autenticación de Windows (integrada) o Token de usuario de SharePoint	Sí	No La autenticación basada en formularios y la autenticación basada en notificaciones no se admiten para las listas remotas de SharePoint.
	Almacenada, Pedir, Ninguna (con credenciales de Windows) No se admiten credenciales almacenadas y de petición con credenciales que no sean de Windows.	No	No La autenticación basada en formularios y la autenticación basada en notificaciones no se admiten para las listas remotas de SharePoint.

*Autenticación de Windows, Autenticación basada en formularios (FBA), tokens de Secure Application Markup Language (SAML), otros proveedores de identidad o una combinación de más de uno de los proveedores de autenticación mencionados anteriormente.

Autenticación de Windows
Esta opción no se admite en el caso de una tecnología de SharePoint que esté configurada para trabajar con un servidor de informes en el modo de cuenta de confianza. Esto solo se aplica a las versiones anteriores a SQL Server 2012 Reporting Services.

En el caso de una tecnología de SharePoint que esté configurada para trabajar con un servidor de informes en el modo integrado de Windows, esta opción se aplica tanto al usuario de Windows actual como al usuario de SharePoint actual.

En el caso de una tecnología de SharePoint configurada para funcionar sin un servidor de informes (modo local), esta opción no se admite. Para obtener más información sobre el modo local, vea Informes en modo local frente al modo conectado en el Visor de informes (Reporting Services en modo de SharePoint).

No se necesitan credenciales (No usar credenciales):
Para usar esta opción, la cuenta de ejecución desatendida debe estar configurada en el servidor de informes. Para obtener más información, vea Configurar la cuenta de ejecución desatendida (Administrador de configuración del servidor de informes).

Para obtener más información, consulta Creación de cadenas de conexión de datos: generador de informes y SSRS, Especificar información de credenciales y conexión para los orígenes de datos de informes y Orígenes de datos admitidos por Reporting Services (SSRS).

Consultas

Para diseñar una consulta, cree un nuevo conjunto de datos basado en el origen de datos y, a continuación, abra el diseñador de consultas asociado. Para obtener más información, vea Crear un conjunto de datos compartido o un conjunto de datos incrustado (Generador de informes y SSRS).

El diseñador gráfico de consultas de lista de SharePoint muestra cuatro paneles:

Listas de SharePoint: muestra una lista con todas las listas de SharePoint del sitio para este origen de datos. Seleccione una lista y, a continuación, seleccione los campos que desea en su consulta. Los nombres de los campos de este panel son solo nombres descriptivos de SharePoint, también conocidos como nombres para mostrar. Mantenga el mouse sobre un elemento para que se muestren las propiedades siguientes en la información sobre herramientas:

• Nombre Nombre único del campo.

• Identificador Identificador único del campo.

• Tipo de campo Tipo de datos del campo.

• Oculto Determina si el campo se muestra en la vista de lista de SharePoint.

No se admite la selección de campos de varias listas. Puede crear un conjunto de datos para cada lista y seleccionar campos de cada conjunto de datos. Si las listas tienen un campo común, puede utilizar la función de búsqueda en una región de datos de Tablix enlazada a un conjunto de datos para recuperar un valor del otro conjunto de datos que no está enlazado a la región de datos. Para obtener más información, vea Función Lookup (Generador de informes y SSRS).

• Campos seleccionados: muestra los campos que se han seleccionado. Los nombres de campo de este panel son solo nombres descriptivos especificados por un usuario de SharePoint. Al cerrar el diseñador de consultas, estos nombres se ven en la colección de campos de conjunto de datos en el panel Datos de informe. La relación entre los nombres únicos y los nombres descriptivos está disponible en la página Propiedades del conjunto de datos (cuadro de diálogo), Campos (Generador de informes).

• Filtros aplicados: limita los datos que se devuelven desde la lista de SharePoint, antes de que los datos se devuelvan al informe. Seleccione el nombre de campo, el operador y el valor que se deben usar para limitar los datos que se recuperan de la lista. Los operadores varían en función del tipo de datos del valor que se seleccione.

  No se puede cambiar el criterio de ordenación ni especificar grupos en el diseñador gráfico de consultas. Para hacerlo, se deben configurar expresiones de ordenación en el conjunto de datos del informe y expresiones de grupo en las regiones de datos del informe. No se admiten parámetros de consulta. Para filtrar los datos del informe, use filtros de informe o parámetros de informe creados por usted. Para obtener más información, vea Filtrar, agrupar y ordenar datos (Generador de informes y SSRS) y Parámetros de informe (Generador de informes y Diseñador de informes).

• Resultados de consulta: muestra filas de ejemplo que se devuelven cuando se ejecuta la consulta. Si los valores de lista de SharePoint cambian con frecuencia en el sitio de SharePoint, los valores que se ven en el panel de resultados de la consulta podrían diferir de los valores que se ven en el informe.

• Campos seleccionados: muestra los campos que se han seleccionado. Los nombres de campo de este panel son solo nombres descriptivos especificados por un usuario de SharePoint. Al cerrar el diseñador de consultas, estos nombres se ven en la colección de campos de conjunto de datos en el panel Datos de informe. La relación entre los nombres únicos y los nombres descriptivos está disponible en la página Propiedades del conjunto de datos (cuadro de diálogo), Campos (Generador de informes).

• Filtros aplicados: limita los datos que se devuelven desde la lista de SharePoint, antes de que los datos se devuelvan al informe. Seleccione el nombre de campo, el operador y el valor que se deben usar para limitar los datos que se recuperan de la lista. Los operadores varían en función del tipo de datos del valor que se seleccione.

  No se puede cambiar el criterio de ordenación ni especificar grupos en el diseñador gráfico de consultas. Para hacerlo, se deben configurar expresiones de ordenación en el conjunto de datos del informe y expresiones de grupo en las regiones de datos del informe. No se admiten parámetros de consulta. Para filtrar los datos del informe, use filtros de informe o parámetros de informe creados por usted. Para obtener más información, vea Filtrar, agrupar y ordenar datos (Generador de informes y SSRS) y Parámetros de informe (Generador de informes y Diseñador de informes).

• Resultados de consulta: muestra filas de ejemplo que se devuelven cuando se ejecuta la consulta. Si los valores de lista de SharePoint cambian con frecuencia en el sitio de SharePoint, los valores que se ven en el panel de resultados de la consulta podrían diferir de los valores que se ven en el informe.

Para obtener más información, vea Diseñador de consultas de lista de SharePoint (Generador de informes).

Texto de consulta

Para ver la consulta generada por el diseñador gráfico de consultas, cambie al diseñador de consultas basado en texto. En esta vista, puede ver el XML creado por el diseñador gráfico de consultas. El XML incluye elementos para el nombre de la lista, la colección de campos y el filtro.

Ejemplo 1. Campos especificados para una lista

En el siguiente ejemplo se muestra una consulta de SharePoint con el formato correcto:

<RSSharePointList>  
<listName>MyList</listName>  
<viewFields>  
  <FieldRef Name="Field1"/>  
  <FieldRef Name="Field4"/>  
</viewFields>  
<Query>  
  <Where>  
    <And>  
      <Gt>  
        <FieldRef Name="Field1"/>  
        <Value Type="Integer">1</Value>  
      </Gt>  
      <IsNotNull>  
        <FieldRef Name="Field2"/>  
        <Value Type="string"/>  
      </IsNotNull>   
    </And>  
  </Where>  
</Query>  
</RSSharePointList>  

Puede modificar esta vista de la consulta, siempre que siga siendo texto XML con el formato correcto.

Ejemplo 2. Todos los campos para una lista

También puede especificar solo el nombre de una lista y se devuelven todos los campos, incluidos los campos ocultos. En el siguiente ejemplo se recuperan todos los campos de una lista denominada Tareas:

<RSSharePointList>  
<listName>Tasks</listName>  
</RSSharePointList>  

Todos los campos de la lista Tareas se devuelven en los resultados de la consulta.

Parámetros

Esta extensión de datos no admite parámetros.

Temas de procedimientos

Esta sección contiene instrucciones paso a paso para trabajar con conexiones de datos, orígenes de datos y conjuntos de datos.

Agregar y comprobar una conexión de datos o un origen de datos (Generador de informes y SSRS)

Crear un conjunto de datos compartido o un conjunto de datos incrustado (Generador de informes y SSRS)

Agregar un filtro a un conjunto de datos (Generador de informes y SSRS)

Secciones relacionadas

Estas secciones de la documentación proporcionan información conceptual detallada sobre los datos de informe, así como información de procedimientos acerca de cómo definir, personalizar y usar las partes de un informe que están relacionadas con datos.

Conjuntos de datos de informe (SSRS)
Proporciona información general sobre cómo obtener acceso a los datos del informe.

Creación de cadenas de conexión de datos - Generador de informes y SSRS
Proporciona información sobre las conexiones de datos y los orígenes de datos.

Conjuntos de datos incrustados y compartidos de informe (Generador de informes y SSRS)
Proporciona información sobre conjuntos de datos compartidos e incrustados.

Colección Campos del conjunto de datos (Generador de informes y SSRS)
Proporciona información sobre la colección de campos de conjunto de datos que genera la consulta.

Orígenes de datos admitidos por Reporting Services (SSRS).
Proporciona información detallada sobre la compatibilidad de versiones y plataformas para cada extensión de datos.

Consulte también

Parámetros de informe
Filtrar, agrupar y ordenar datos
Expresiones (Generador de informes y SSRS)

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