Mostrando entradas con la etiqueta Listas. Mostrar todas las entradas
Mostrando entradas con la etiqueta Listas. Mostrar todas las entradas

lunes, 22 de julio de 2013

Crear listas externas - BCS

En esta entrada se va a mostrar una funcionalidad muy potente de SharePoint 2010. Se trata de las listas externas o Business Conectivity Service (BCS). Los BCS extendienden la funcionalidad que ofrecían los BDC de SharePoint 2007, ya que también permite la actualización.
Para crear una lista externa primero hay que crear los tipo de contenido externo. En este ejemplo se crearán los tipos de contenido externo desde el SharePoint Designer. En el menú de la izquierda, se accede a Tipos de Contenido Externo
Tipo de contenido externo
Tipo de contenido externo
 Arriba a la izquierda se selecciona Tipo de Contenido Externo para crear uno nuevo:
Nuevo Tipo
Al pulsar se abre una pestaña de Nuevo Tipo de Contenido. En esta pestaña se define el nombre y el nombre a mostrar. Para configurar los enlaces externos y las operaciones se pulsa en el enlace que hay a la derecha de Sistema externo.
Configurar sistema externo
Pulsando se abre la pestaña de Diseñador de Operaciones. Se pulsa en el botón Agregar Conexión para definir una nueva conexión a una base de datos.
Agregar Conexion
Al pulsar Agregar Conexion, se define el tipo de origen de datos. En este caso se seleccionará SQL Server. En la siguiente ventana se define el servidor de la base de datos, el nombre de la base de datos y el nombre de conexión que se mostrará.
Conexion SQL Server
Una vez creada, se mostrará la conexión en el explorador de origen de datos. Se selecciona el origen de datos en el que se van a definir las operaciones, y se pulsa con el botón derecho en la tabla deseada.
Seleccionar Tabla
Se pulsa la acción que se quiere definir y se abrirá una ventana con los distintos pasos a seguir. Se pueden elegir que campos se mostrarán en esa acción y cuales no.
Definir Accion
Una vez definidas las acciones se guardan los cambios con el botón de arriba a la izquierda.Guardar tipo de contenido
Después de guardar el tipo de contenido externo, en el portal de SharePoint 2010 se accede a Todo el contenido del sitio. Y después se pulsa el botón Crear.Boton Crear
En la siguiente ventana se selecciona Lista Externa y Crear. En la siguiente ventana se define el nombre que tendrá la lista y abajo del todo se define el tipo de contenido externo que utilizará. Para ello se pulsa el botón de abajo a la derecha.
Declarar Tipo de Contenido Externo
Al pulsar se abrirá una ventana con los tipos de contenido externos definidos en el sitio de SharePoint. Se selecciona uno, y después de pulsa el botón de aceptar.
Después de esto se debería mostrar la lista externa con su contenido, pero algunas veces no se muestra porque no se han definido los permisos. Para ello se accede a la Administración Central de SharePoint 2010. Se pulsa en Gestión de Aplicaciones de Servicio y después en Servicio de conexiones de datos empresariales.
BCS
Se mostrarán los distintos tipos de contenido externo definidos. Se selecciona el deseado y se pulsa el botón Configurar Permisos. A continuación se abre una ventana como la siguiente:
Ventana permisos
En esta ventana se declara los distintos permisos que tendrán los distintos usuarios y se pulsa el botón de aceptar.

Ahora si se visualizarán las listas externas.

Vistas - Filtrar elementos de una Lista de SharePoint

Al editar o crear una vista de una lista puede ser muy útil filtrar los elementos de la lista. Para poder filtrar, se accede al cuarto campo de la edición de una vista. Por defecto ese campo está configurado para que muestre todos los elementos de la vista. Para filtrar se selecciona la opción que hay debajo. A continuación hay que definir los valores de filtro de las columnas. Se puede definir el valor de filtro de hasta diez columnas. Para definir los filtros, primero hay que seleccionar una columna. A continuación se selecciona el tipo de comparación que se quiere hacer. Por ejemplo: es igual a, es mayor que, es mayor o igual que… etc. Por último se introduce el valor de filtro. En este punto se pueden utilizar las siguientes variables: [Yo] y [Hoy]. Escribiendo la variable [Yo], se filtrarán los elementos de la lista cuyo contenido en esa columna se compare con el usuario actual. La variable [Hoy] sirve para filtrar según la fecha actual. Esta variable, al ser de tipo fecha, permite añadirle operaciones de suma y resta. Es decir, que al definir el valor de filtro, escribiendo [Hoy]-1, filtrará los elementos con la fecha de ayer. Y escribiendo [Hoy]+7, filtrará los elementos con fecha de dentro de una semana.
Por último, si se desea filtrar por otra columna, se repiten los pasos anteriores definiendo otra columna distinta. Pero antes, hay que definir la lógica booleana que relaciona las columnas.

jueves, 7 de marzo de 2013

Consultar lista que excedan los límites

Para garantizar el rendimiento de SharePoint, las listas tienen definidos unos límites que no permiten hacer consultas de elementos por encima de estos. Por ejemplo, si tenemos puesto el límite a 5.000 elementos de lista, no vamos a poder ejecutar una consulta que devuelva un número superior de elementos, salvo que seamos administradores, que tienen otro límite definido y puede ser superior.

Esto no quiere decir que las listas de SharePoint no puedan almacenar más de estos límites, todo lo contrario, si las listas están bien definidas y tenemos una buena infraestructura, las listas soportan un gran número de elementos. El problema de rendimiento nos lo podemos encontrar realizando una consulta que devuelva muchos elementos y que, por ejemplo, se muestre en un sitio sin paginado. Con esta situación nos encontramos con dos problemas, el primero es el ViewState de la página ASP.NET con más de 5.000 filas en una lista, y el segundo en el servidor con esa cantidad de información en memoria.

En SharePoint 2010, tenemos una nueva clase, Microsoft.Office.Server.Utilities.ContentIterator, que nos permite realizar iteraciones sobre los elementos de las listas, sin que nos encontremos con la excepción de límite de consulta superado. Veamos un ejemplo.

protected void QueryWithContentIterator()
{
    //Creamos un CAML Query
    string query = @"<View>
        <Query>
            <Where>
                <And>
                    <BeginsWith>
                        <FieldRef Name='TITLE' />
                        <Value Type='Text'>TF</Value>
                    </BeginsWith>
                </And>
            </Where>
        </Query>
    </View>";
    
    //Instanciamos el iterator y procesamos los elementos del SPQuery
    var iterator = new ContentIterator();
    var listQuery = new SPQuery();
    listQuery.Query = query;
    SPList list = SPContext.Current.Web.Lists["Clientes"];
    //Cuando procesamos los elementos, tenemos que suscribirnos a los eventos de Error y de Procesado de Elemento
    iterator.ProcessListItems(list,
        listQuery,
        ProcessItem,
        ProcessError
    );
}
 
public    bool ProcessError(SPListItem item, Exception e) 
{ 
    //Capturamos el error
    return true; 
}
public void ProcessItem(SPListItem item)
{
    //Código para realizar acciones sobre el elemento actual.
}

Esta nueva clase nos da la posibilidad de hacer consultas procesando elemento a elemento de la misma, aún así, tengamos en cuenta que la interfaz de usuario debería de ser capaz de manejar esta cantidad de datos, por ejemplo, con paginación.