Agregador de Bibliotecas
Jarmit Agregador de Bibliotecas reúne o agrega archivos y sus metadatos de múltiples bibliotecas de documentos desde cualquier lugar dentro de su inquilino de SharePoint Online en una sola tabla.
Ejemplos de casos de uso:
- Unifique las declaraciones de gastos de todos los departamentos en una sola página.
- Agrupe toda la documentación del producto.
- Vea todos sus documentos de los sitios de proyectos activos.
- Ver todas las solicitudes de pedidos pendientes de los clientes que tiene asignados.
La interfaz de usuario tiene potentes funciones como paginación, ordenación y filtros globales y por columna. Los usuarios solo podrán ver los archivos a los que se les ha asignado permiso en SharePoint.
Mientras se edita el elemento web en una página de SharePoint, Jarmit Library Aggregator muestra una herramienta de configuración especial para hacer que la preparación del elemento web sea un proceso sencillo paso a paso para los no expertos. Para usuarios avanzados, Jarmit Library Aggregator se puede configurar manualmente para permitir consultas más complejas.
Soporte multilingüe: inglés y español
Cómo funciona - Interfaz de usuario
En la parte superior del elemento web Jarmit Agregador de Bibliotecas, se encuentra el selector de idioma en la esquina derecha. El idioma predeterminado se establecerá automáticamente según el idioma en el que el usuario está viendo SharePoint actualmente, pero se puede cambiar en cualquier momento.
El botón ‘Vaciar’ se usa para eliminar todos los filtros y ordenación de la tabla de archivos a continuación.
En el lado derecho hay un cuadro de búsqueda que aplica una búsqueda global entre todas las columnas que se muestran para el texto ingresado.
Finalmente, los encabezados de las columnas muestran el nombre de la columna con un icono de ordenación a la derecha y, si está configurado, un icono de filtro a la izquierda.
La ordenación se puede hacer en una o más columnas. Al hacer clic una vez en el icono de ordenación, se aplicará una ordenación ascendente en esa columna. Al hacer clic por segunda vez, cambie la dirección de ordenación a descendente.
Después de aplicar la ordenación en una columna, para aplicar un segundo nivel de ordenación en otra columna, mantenga presionada la metatecla (CTRL en Windows, CMD en Mac) y haga clic en el ícono de ordenación en la siguiente columna por la que desea ordenar.
Los números junto al icono de ordenación mostrarán en qué orden se aplica la ordenación.
Filtros
Filtro de texto
El filtro de texto le permite aplicar uno o dos filtros. El enlace ‘Agregar regla’ en el cuadro de diálogo de filtro muestra el segundo filtro, y el menú desplegable superior le permite decidir si ambos filtros deben coincidir para que aparezca el archivo (Coincidir todo) o si el archivo se mostrará si alguno de los filtros coincide (Coincide con cualquiera).
Los filtros de texto pueden ser de varios tipos:
- Comience con
- Contenga
- No contenga
- Termine con
- Igual a
- Diferente a
Filtro de fecha
Los filtros de fecha pueden ser:
- Fecha igual a
- Fecha diferente a
- Fecha antes de
- Fecha después de
El filtro de fecha también le permite aplicar uno o dos filtros usando la opción ‘Agregar regla’ como antes. Esto puede ser muy útil si busca archivos en los que la fecha de la columna que está filtrando debe estar entre dos fechas. En este caso, use ‘Coincidir todo’ y un filtro con ‘Fecha después de’ y el segundo filtro con ‘Fecha antes de’.
Filtro de número
Los tipos de filtro disponibles para el filtro de números son:
- Igual a
- Diferente a
- Menor que
- Menor o igual a
- Mayor que
- Mayor o igual a
Se pueden aplicar uno o dos filtros, coincidiendo con uno o ambos, y el valor del filtro solo permite introducir valores numéricos.
Filtro de entre
Una alternativa a la aplicación de dos filtros numéricos es el filtro entre, que muestra un control deslizante de dos extremos entre un valor mínimo y máximo.
Para usar, simplemente deslice el límite inferior y superior para mostrar los archivos con el valor de esta columna entre los dos.
Filtro de Sí/No
El filtro Sí/No o booleano es el más simple de todos.
Seleccione la casilla de verificación en el filtro que muestra una marca y se mostrarán los archivos cuyo valor de columna sea Sí.
Cuando vuelva a hacer clic en la casilla de verificación, mostrará una ‘X’ y filtrará los archivos cuyo valor de columna sea No.
Cuando la casilla de verificación está vacía, no hay filtro.
Fintro de en
El filtro ‘en’ le permite elegir de una lista de opciones y se mostrará cualquier archivo cuyo valor de columna sea cualquiera de los valores que seleccione para filtrar.
La lista de valores a elegir la establece la persona que edita el elemento web y, en el caso de que haya una lista larga de valores posibles, el filtro contiene su propio filtro para encontrar el valor que buscas.
Cómo funciona - Interfaz del editor
El panel de propiedades
El panel de propiedades de Jarmit Library Aggregator tiene dos secciones: configuración global y configuración de licencia.
Configuración global
Solo hay dos configuraciones para hacer que Jarmit Library Aggregator funcione: la configuración de columnas y la configuración de consultas.
La configuración de columnas define qué columnas aparecerán para los usuarios, su tipo (fieldtype), filtro (filter), canalizar (pipe) y transformación (transform) junto con otras propiedades adicionales según el tipo de columna y datos a tratar.
La configuración de la consulta define qué datos se solicitan de cada biblioteca de documentos para que se muestren. Esto incluye una lista de campos, qué campos se «expanden» y cualquier filtro, todo basado en las llamadas API REST estándar de OData SharePoint.
Ambos ajustes de configuración están definidos en JSON y parecen terriblemente complicados, pero no se preocupe, solo son visibles para que los usuarios avanzados puedan modificarlos para lograr resultados especiales y complejos.
Los detalles del esquema tanto para la configuración como para las configuraciones avanzadas de ejemplo se proporcionan a continuación.
Para todos los demás, hay una herramienta de configuración especial integrada en el elemento web para que la creación de estos dos ajustes de configuración sea tan fácil como 1-2-3. Pero más de eso después.
Configuración de licencia
Finalmente, la sección de licencias del panel de propiedades le permite agregar su código de licencia, que le enviamos después de la compra.
El botón ‘Aplicar’ en la parte inferior guarda la configuración de su elemento web.
La herramienta de configuración
Obviamente, no todo el mundo es un desarrollador experto de SharePoint; estaríamos sin trabajo si lo fueran 😜
Por esta razón, Jarmit Agregador de Bibliotecas se ha creado con una «herramienta de configuración» especial que solo aparece cuando se está editando el elemento web.
Esta herramienta lo guía a través del proceso de selección de la biblioteca de documentos principal, qué campos se mostrarán, definirá su filtro de columna individual y cualquier transformación o formato de datos que se requiera y, finalmente, qué bibliotecas adicionales se combinarán junto con un filtro de datos común que se aplicará a cada biblioteca.
Selección de biblioteca primaria
Para comenzar el proceso de configuración, debe elegir una biblioteca de documentos ‘primaria’, de la cual elegirá los campos que mostrará.
No importa cuál de las bibliotecas elija como principal entre todas las que desee combinar.
Pegue la URL del sitio de SharePoint que contiene la biblioteca de documentos principal elegida en el formulario y haga clic en «Cargar».
La URL debe ser como https://tu-inquilino.sharepoint.com, https://tu-inquilino.sharepoint.com/sites/otro-sitio o https://tu-inquilino.sharepoint.com/sites/otro-sitio/subsitio
La lista de bibliotecas de documentos disponibles en el sitio se mostrará en el menú desplegable a continuación. No aparecerán bibliotecas de documentos ocultos o bibliotecas basadas en otras plantillas. Si desea utilizar estos, debe utilizar la configuración manual.
Seleccione la biblioteca de documentos deseada del menú desplegable y se cargarán sus campos.
Selección y configuración de columnas
Debajo del menú desplegable, aparecerá una lista de posibles campos de metadatos. Esta lista será la misma que la lista de campos que puede agregar a una vista de biblioteca de SharePoint, incluidos varios campos internos.
Primero aparecen dos columnas especiales: Archivo y Carpeta.
Columna archivo
La columna Archivo es obligatoria, por lo que se selecciona automáticamente. De forma predeterminada, se eligen el filtro ‘text’ y la transformación ‘link’. El filtro de texto activa un filtro que permite filtrar según el nombre del archivo, y la transformación del enlace convierte el nombre del archivo en un enlace que abre el archivo en una nueva pestaña en el navegador.
Tanto el filtro como la transformación se pueden desactivar seleccionando ‘none’ en cada menú desplegable.
Si lo desea, puede definir un nuevo encabezado de columna en lugar de ‘Nombre del archivo’, pero no puede estar vacío.
Columna carpeta
La columna Carpeta es similar a la columna Archivo, pero no es obligatoria. Para mostrar esta columna, marque la casilla de verificación ‘Mostrar’.
Esta columna está configurada con la transformación ‘link’ de forma predeterminada, que se muestra como un ícono de carpeta en el que se puede hacer clic, abriendo la carpeta que contiene el archivo en una nueva pestaña.
La transformación ‘link’ se puede desactivar, configurarla en ‘none’ y se puede activar un filtro de texto, si lo desea.
Al igual que con todas las definiciones de columna, el nombre de la columna ‘Carpeta’ se puede cambiar, pero no puede estar vacío.
Columnas Text y Note
El tipo de columna ‘Text’ corresponde a campos de metadatos del tipo ‘Una línea de texto’.
El tipo de columna ‘Note’ corresponde a campos de metadatos del tipo ‘Varias líneas de texto’.
Ambos tipos de columna tienen las mismas opciones de configuración.
Además de modificar el nombre de la columna, que por defecto es el nombre de visualización del campo de la biblioteca, se puede activar un filtro de texto en la columna.
Columnas Choice y MultiChoice
El tipo de columna ‘Choice’ corresponde a los campos de metadatos del tipo ‘Elección’.
El tipo de columna ‘MultiChoice’ corresponde a los campos de metadatos del tipo ‘Elección’ cuando la opción ‘Casillas (permitir varias selecciones) se ha establecido en la configuración de la biblioteca.
Además de modificar el nombre de la columna y seleccionar el filtro de texto, también puede definir el filtro ‘in’, que proporciona un menú desplegable de valores en el filtro de la columna.
La lista de opciones en el filtro desplegable se define en el cuadro de texto ‘dropdownlist’ con cada opción en una nueva línea.
Además del valor de ‘fieldtype’, puede reconocer una columna ‘MultiChoice’ de una columna ‘Choice’ normal ya que tiene un ‘*’ antes de su icono.
Columna Number
El tipo de columna ‘Number’ corresponde a campos de metadatos del tipo ‘Número’ sin la opción ‘Mostrar como porcentaje’ seleccionada.
Las opciones de filtro son ‘none’ (sin filtro), ‘number’ (filtro numérico) y ‘between’, que requiere valores para minValue y maxValue y se muestra como un control deslizante para que el usuario seleccione valores inferiores y superiores para filtrar.
Las opciones ‘pipe’, que definen cómo se muestran los datos, son ‘none’, ‘decimal’, ‘percent’ y ‘currency’. Si se selecciona la moneda, se debe ingresar un código de moneda. El código de moneda es el valor ISO 4217.
La ‘pipe’ percent asume valores entre 0 (0%) y 1 (100%). La ‘pipe’ decimal mostrará el número de acuerdo con el idioma actual seleccionado.
Columna Percent
El tipo de columna ‘percent’ corresponde a campos de metadatos del tipo ‘Número’ con la opción ‘Mostrar como porcentaje’ seleccionada.
Las opciones de filtro son las mismas que las columnas de números (‘none’, ‘number’ or ‘between’), pero las opciones de ‘pipe’ solo permiten ‘none’, ‘decimal’ o ‘percent’.
Columna Currency
La columna ‘Currency’ es, nuevamente, similar a la columna ‘Number’ con los mismos filtros (‘none’, ‘number’ or ‘between’), pero nuevamente las ‘pipe’ disponibles son diferentes: ‘none’, ‘decimal’ or ‘currency’.
Una vez más, el código de moneda introducido debe ser el valor ISO 4217 de tres caracteres.
Columna DateTime
Las opciones ‘filter’, ‘pipe’ y ‘transform’ para la columna DateTime son idénticas: ‘none’ o ‘date’. Cuando se selecciona la ‘pipe’ de ‘date’, la transform también debe ser ‘date’ y se debe ingresar un valor para ‘dateFormat’.
Los formatos de fecha predefinidos se pueden encontrar aquí y las opciones de formato personalizado aquí.
Columnas Lookup y LookupMulti
Las columnas lookup y lookupmulti tienen posibilidades de configuración complejas debido al hecho de que la columna en la lista o biblioteca de búsqueda principal puede ser de varios tipos diferentes, incluida una sola línea de texto, número, fecha/hora, etc.
Pero no se preocupe, ¡la herramienta de configuración lo tiene cubierto!
A medida que configura las opciones de filter, pipe y transform, los valores de las otras opciones se filtrarán automáticamente para mostrarle solo los valores permitidos y las configuraciones adicionales requeridas, como valores mínimos y máximos, formato de fecha, etc., aparecerán automáticamente cuando sea necesario para ser configurado.
El campo ‘lookupfield’ es obligatorio y se rellena con el nombre interno del campo en la lista o biblioteca asociada.
Para restablecer la configuración de la columna para elegir una diferente, simplemente vuelva a poner la configuración de filter, pipe y transform en ‘none’ para comenzar de nuevo.
De manera similar a las columnas Choice y MultiChoice, la columna LookupMulti tiene un ‘*’ antes de su icono para diferenciarla de una columna Choice simple.
Columna Boolean
La columna ‘Boolean’ corresponde al tipo de columna Sí/No de SharePoint y tiene una configuración muy sencilla.
Puede elegir no tener filtro o el filtro ‘boolean’ en la columna, ¡y eso es todo amigos!
Columnas User y UserMulti
Las columnas user y usermulti son como las columnas lookup y lookupmulti en el sentido de que tienen un ‘lookupfield’ que debe configurarse. La diferencia es que esta configuración tiene un conjunto fijo de valores que puede ser:
Title, Name, EMail, MobilePhone, SipAddress, Department, JobTitle, FirstName, LastName, WorkPhone, UserName, Office, ID, Modified, Created.
Si bien la mayoría de estos no serán útiles para la mayoría de las personas, los hemos incluido todos para que estén completos.
La herramienta de configuración cambiará automáticamente las opciones disponibles para cada configuración para este tipo de columnas según los valores seleccionados.
Por ejemplo, el filter, pipe y transform de ‘date’ solo están disponibles para los valores de campo de búsqueda ‘Modified’ y ‘Created’.
Al igual que antes con las columnas lookup, para comenzar de nuevo, restablezca el campo lookupfield a ‘Title’ y filter, pipe y transform a ‘none’.
Columnas URL0 y URL1
Si bien los tipos de columna URL0 y URL1 se originan en la columna de SharePoint «hipervínculo o imagen», se tratan de manera diferente ya que representan tipos de información muy diferentes.
Para las columnas URL0 (enlace), establecer la transformación en ‘link’ crea un enlace en el que se puede hacer clic para que el usuario lo abra y establezca el valor de canalización en ‘html’.
De manera similar, las columnas URL1 (imagen) pueden tener su valor de transformación establecido en ‘image’, lo que mostrará la URL en los datos como una imagen en la que se puede hacer clic en la tabla. Cuando la transformación se establece en ‘image’, la ‘pipe’ tendrá el valor ‘html’ seleccionado automáticamente.
Selección de bibliotecas adicionales
Debajo de la selección de campos, puede agregar las bibliotecas adicionales que comparten las mismas columnas que eligió mostrar.
Pegue la URL del sitio o subsitio de SharePoint y haga clic en el botón Cargar. Aparecerá una lista de bibliotecas de documentos para que seleccione una. Luego haga clic en el botón Añadir.
La herramienta de configuración luego verificará para asegurarse de que todas las columnas estén presentes y sean correctas de acuerdo con los campos que ha elegido anteriormente.
Si hay algún problema, la herramienta de configuración lo alertará y la biblioteca no se agregará. Si la biblioteca se agrega a la siguiente tabla, no se encontraron problemas.
Para eliminar una biblioteca de la configuración, simplemente haga clic en el icono de la papelera roja.
Una vez que comience a agregar bibliotecas adicionales, no podrá cambiar la selección y la configuración de los campos. Para modificar los campos para mostrar, primero debe eliminar todas las bibliotecas adicionales. Esto es para garantizar que las comprobaciones realizadas al agregar bibliotecas adicionales sean correctas.
Filtros de datos opcionales
Opcionalmente, puede agregar un filtro a todos los archivos que se mostrarán en Jarmit Agregador de Bibliotecas. Estos filtros son filtros OData estándar con algunas limitaciones en cuanto a lo que permitirá SharePoint.
Filtros OData del API REST de SharePoint explicado
En primer lugar, SharePoint solo admite el filtrado en determinados tipos de columnas. Estos tipos de columnas son:
- Una línea de texto
- Elección
- Elección (selección múltiple)
- Sí/No (con ‘eq’ o ‘ne’ y valores 1 para sí/verdadero, 0 para no/falso y null para ningún valor establecido)
- Fecha y hora
- Número (con o sin ‘Mostrar como porcentaje’)
- Moneda
- Búsqueda (con o sin ‘Permitir varios valores’, especificando lookupfield p.ej. lookup/Title eq ‘valor’)
- Persona o grupo (con o sin ‘Permitir selecciones múltiples’, especificando lookupfield p.ej. personfield/Title eq ‘Mad Max’
Luego, según el tipo de datos que contiene la columna, SharePoint admite diferentes tipos de filtros.
Para valores numéricos:
- lt – menor que
- le – menor o igual a
- gt – mayor que
- ge – mayor o igual a
- eq – igual a
- ne – diferente a
Los operadores numéricos también se pueden aplicar a los valores de fecha/hora comparándolos con una fecha con formato como:
datecolumn lt datetime'2023-05-15T00:00:00Z'
Para valores textuales:
- startswith(nombre_de_columna, ‘texta a comprobar’)
- substringof(‘texta a comprobar’, nombre_de_columna)
- eq – igual a
- ne – diferente a
Puede encontrar información en Internet, incluida la propia documentación de Microsoft que indica funciones de fecha/hora como año (nombre de columna), mes (nombre de columna), etc… pero, lamentablemente, si intenta esto, fallará con un mensaje «consulta no válida». Estas funciones solo funcionan en los servicios web basados en SOAP más antiguos, como _vti_bin/listdata.svc, que no son compatibles con el elemento web.
Finalmente, puedes combinar filtros con las operaciones ‘and’ o ‘or’.
Ejemplos de filtros
substringof('urgente', columna_de_texto)
– devuelve archivos donde la columna de una línea de texto ‘columna_de_texto’ contiene el valor ‘urgente’
(columna_numbero ge 100) and (startswith('alto', columna_eleccion))
– devuelve archivos donde la columna de número ‘columna_numbero’ es mayor o igual a 100 Y la columna de elección ‘columna_eleccion’ empieza con el texto ‘alto’.
(ficheroenviado eq 1) or (porcentajecompletado gt 0.75)
– devuelve archivos donde la columna Sí/No ‘filesent’ es Sí O la columna de tipo número configurado para porcentajes ‘porcentajecompletado’ es mayor que 75%.
Limitar el número de archivos a mostrar
Si, por cualquier motivo, desea restringir la cantidad de archivos que se mostrarán, puede agregar la opción ‘top’ de OData al final del filtro opcional.
Los valores válidos para ‘top’ son de 1 a 5000.
Por ejemplo:
prioridad eq 'alto'&$top=20
devolverá los primeros 20 archivos donde el campo ‘prioridad’ es igual a ‘alta’.
Si no hay filtro, aún puede agregar la opción ‘top’ de esta manera:
&$top=100
Configuraciones avanzadas
La herramienta de configuración puede ayudar a los usuarios a reunir fácilmente archivos de varias bibliotecas de documentos, pero tiene sus limitaciones.
Las configuraciones de columna y consulta en el panel de propiedades se pueden modificar manualmente para lograr resultados más avanzados. Para facilitar esto, recomendamos copiar y pegar el código base generado por la herramienta de configuración en una aplicación de programación que admita JSON, como Visual Studio Code, que es gratuito y se puede instalar en Windows, Mac o Linux. Dentro de Visual Studio Code, puede formatear el JSON para que sea más fácil de leer haciendo clic con el botón derecho y seleccionando «Formatear documento» o Shift-Alt-F.
En primer lugar, los filtros de datos opcionales se aplican a cada consulta en la herramienta de configuración, lo que significa que se aplican a todas las bibliotecas. Si desea utilizar diferentes filtros en bibliotecas específicas, puede modificar los filtros manualmente en la configuración de consulta.
Microsoft tiene un diagrama útil que muestra los filtros que se pueden aplicar aquí, pero ignore la sección «date and time»: estos operadores no funcionan en la API REST de SharePoint. La herramienta de configuración se ocupa de los campos de selección y las secciones de expansión del diagrama. La ordenación se define de forma predeterminada y el usuario puede ordenar todas las columnas, y el elemento web Jarmit Library Aggregator automáticamente se encarga de paginar los resultados para garantizar que se carguen todos los datos.
Aquí hay un filtro útil que puede usar:
- Restringir archivos devueltos a una carpeta específica – &$filter=startswith(FileRef, ‘/nombrebiblioteca/nombrecarpeta/’) or &$filter=startswith(FileDirRef, ‘/nombrebiblioteca/nombrecarpeta/nombresubcarpeta/’)
Configuración de consulta
La configuración de la consulta es relativamente sencilla.
Hay una propiedad llamada ‘queryConfig’ que contiene una matriz de objetos con las propiedades ‘type’, ‘endpoint’ y ‘body’.
Las propiedades ‘type’ y ‘body’ se incluyen para una versión futura cuando se admitirán consultas CAML, pero por ahora ‘type’ siempre debe ser ‘normal’ y ‘body’ siempre debe ser una cadena vacía.
La propiedad ‘endpoint’ es para la URL de la API REST de SharePoint. Debe apuntar a una biblioteca de documentos estándar e incluir ‘$expand=File’.
Si necesita una versión de Jarmit Agregador de Bibliotecas que pueda conectarse a bibliotecas basadas en una plantilla diferente, póngase en contacto y podemos prepararle una versión especial.
Configuración de columnas
La configuración de la columna es, por otro lado, un poco más complicada.
La herramienta de configuración incorpora todas las reglas necesarias para generar correctamente la configuración de la columna para cada tipo de columna de metadatos admitida, pero si le gusta ensuciarse las manos, aquí tiene los detalles.
En primer lugar, la lista de tipos de campos de metadatos admitidos es:
- Una línea de texto (Text)
- Varias líneas de texto (Note)
- Elección (Choice)
- Elección con ‘permitir varias selecciones’ (MultiChoice)
- Número (Number)
- Número con ‘Mostrar como porcentaje’ (Percent)
- Moneda (Currency)
- Fecha y hora (DateTime)
- Búsqueda (Lookup)
- Búsqueda con ‘Permitir varios valores’ (LookupMulti)
- Sí/No (Boolean)
- Persona o grupo (User)
- Persona o grupo con ‘Permitir selecciones múltiples’ (UserMulti)
- Hipervínculo o imagen con ‘formatear URL como hipervínculo’ (URL0)
- Hipervínculo o imagen con ‘formatear URL como imagen’ (URL1)
Tipos de campos de metadatos que aún no se admiten:
- Calculado
- Imagen
- Resultado de la tarea
- Datos externos
- Metadatos administrados
- Ubicación (moderno)
Es posible que estos tipos de campos de metadatos se admitan en una versión futura. Si necesita uno de estos campos ahora, háganoslo saber.
Los atributos ‘field’ (nombre de campo interno), ‘fieldname’ (nombre que se mostrará en el encabezado de la columna), ‘fieldtype’ (uno de los valores anteriores), ‘filter’ (qué filtro de columna habilitar), ‘pipe’ (formato de visualización) y ‘transform’ (transformación de datos especial que se aplicará a los datos sin procesar) son necesarios para cada definición de columna.
Los otros atributos ‘lookupfield’, ‘dateFormat’, ‘currencyCode’ y ‘dropdownlist’ son obligatorios según el tipo de campo, el filtro, la ‘pipe’ y la transformación seleccionados.
Columnas File y FileDirRef
Hay dos tipos de columnas especiales predefinidas en la herramienta de configuración: File y FileDirRef.
La columna File es obligatoria: muestra el nombre del archivo, incluida la extensión. Los únicos atributos que se pueden modificar son ‘fieldname’ para llamar a la columna algo diferente, ‘filter’ que puede ser ‘text’ o ‘none’ y ‘transform’ que puede ser ‘link’ para mostrar el nombre del archivo como un enlace al archivo o ‘none’ para mostrar el nombre del campo como texto sin formato.
Todos los demás atributos deben ser como se muestra en la imagen de arriba.
La columna FileDirRef le permite mostrar un ícono de carpeta que abre la carpeta donde reside el archivo en una nueva pestaña y comparte las mismas reglas de configuración que la columna File anterior.
Columnas Text y Note
Estos tipos de columnas comparten las mismas reglas de configuración.
Al igual que con todas las definiciones de columna, ‘field’ debe ser el nombre del campo interno. Como los campos de metadatos se pueden crear con espacios o caracteres acentuados en el nombre para mostrar, es posible que los nombres internos no sean idénticos. Una manera fácil de verificar el nombre interno de un campo es editar la configuración de la biblioteca y abrir el enlace al nombre de la columna. La URL que se abre tendrá el nombre del campo interno al final, como ‘&Field=internalname’
Aparte de cambiar el ‘fieldname’ para que sea algo diferente al nombre de visualización del campo, lo que también se puede hacer en todos los tipos de campos, el único otro atributo que puede cambiar es ‘filter’. Puede tomar los valores ‘none’ o ‘text’.
‘fieldtype’ debe ser ‘Text’ o ‘Note’ correspondientemente, ‘pipe’ y ‘transform’ solo pueden ser ‘none’.
Columnas Choice y MultiChoice
Nuevamente, estos tipos de columnas comparten las mismas reglas de configuración.
El atributo ‘fieldname’ se puede cambiar como de costumbre, pero el único otro atributo que puede tener valores diferentes es ‘filter’.
‘filter’ puede tomar los valores ‘none’, ‘text’ y ‘in’. El valor ‘in’ define un filtro desplegable que requiere una lista de valores.
Estas opciones de filtro desplegable se especifican en el atributo ‘dropdownlist’, que es una matriz de objetos con dos propiedades: ‘label’ y ‘value.’
El valor de ‘label’ representa lo que se mostrará al usuario, mientras que el atributo ‘value’ se utiliza para filtrar los datos.
De forma predeterminada, la herramienta de configuración utiliza el mismo valor para ambos atributos, pero si es necesario, puede especificar diferentes ‘label’ y textos de ‘value’.
Columna Number
La columna de number tiene tres opciones de ‘filter’: ‘none’, ‘number’ y ‘between’. Si se usa el filtro ‘between’, los atributos ‘minValue’ y ‘maxValue’ deben establecerse y deben ser números.
El atributo ‘pipe’ puede ser ‘none’, ‘decimal’, ‘percent’ o ‘currency’. ‘decimal’ mostrará el número con el separador de decimales y miles correspondiente al idioma activo. ‘percent’ multiplicará el valor por 100 y agregará ‘%’. ‘currency’ requiere que se defina el atributo ‘currencyCode’.
Columna Percent
La columna Percent puede tener valores de ‘filter’ de ‘none’, ‘number’ o ‘between’. Como antes, si se usa el filtro ‘between’, los atributos ‘minValue’ y ‘maxValue’ deben establecerse y deben ser números.
El atributo ‘pipe’ puede ser ‘none’, ‘decimal’ o ‘percent’ con los mismos resultados de visualización que la columna de número.
Columna Currency
La columna currency puede tomar ‘filter’ como ‘none’, ‘number’ o ‘between’. Al igual que con las otras columnas, si se selecciona el filtro ‘between’, se deben configurar los atributos ‘minValue’ y ‘maxValue’.
El atributo ‘pipe’ puede tomar los valores ‘none’, ‘decimal’ o ‘currency’. Con ‘currency’ seleccionado, el atributo ‘currencyCode’ también se establecerá.
Columna DateTime
La columna DateTime puede tomar los valores ‘none’ y ‘date’ para los tres atributos ‘filter’, ‘pipe’ y ‘transform’.
Para poder usar ‘pipe’ de ‘date’ para mostrar la fecha en un formato específico en lugar de los datos sin procesar enviados desde SharePoint, debe usar la transformación ‘date’ y se requiere el atributo ‘dateFormat’.
Los formatos de fecha predefinidos se pueden encontrar aquí y las opciones de formato personalizado aquí.
Columnas Lookup y LookupMulti
Las columnas Lookup y LookupMulti tienen el conjunto más complejo de configuraciones posibles, según el tipo de columna de búsqueda seleccionada de la lista o biblioteca principal. Ambos tipos de columnas tienen el mismo conjunto de reglas para su configuración.
Aplicando un poco de sentido común te permitirá usarlos sin problemas.
Los posibles filtros son ‘none’, ‘text’, ‘number’, ‘between’, ‘date’ y ‘in’.
Los valores posibles para ‘pipe’ son ‘none’, ‘date’, ‘decimal’, ‘currency’ o ‘percent’.
El atributo transform puede ser ‘none’ o ‘date’.
El ‘lookupfield’ es obligatorio y debe ser el nombre interno del campo en la columna de la lista o biblioteca principal.
Los demás atributos son necesarios según los valores de filter, pipe y transform:
- ‘minValue’ y ‘maxValue’ cuando filter es ‘between’.
- ‘dropdownlist’ cuando filter es ‘in’.
- ‘dateFormat’ cuando transform es ‘date’ y pipe es ‘date’.
- ‘currencyCode’ cuando pipe es ‘currency’.
Columna Boolean
La columna Boolean, por otro lado, es bastante simple. El único atributo aparte de ‘fieldname’ que puede cambiar es ‘filter’, que puede ser ‘none’ o ‘boolean’.
Columnas User y UserMulti
Las columnas User y UserMulti son similares a las columnas Lookup y LookupMulti ya que también requieren el atributo ‘lookupfield’, pero este atributo solo puede tener uno de una lista fija de valores:
Title, Name, EMail, MobilePhone, SipAddress, Department, JobTitle, FirstName, LastName, WorkPhone, UserName, Office, ID, Modified, Created.
Los atributos ‘filter’, ‘pipe’ y ‘transform’ de ‘date’ solo se permiten cuando el campo de búsqueda es ‘Modified’ o ‘Created’, ya que son los únicos valores de fecha/hora.
El atributo ‘dateFormat’ es necesario cuando ‘transform’ y ‘pipe’ son ‘date’ como anteriormente y cuando ‘filter’ está ‘in’, el atributo ‘dropdownlist’ debe completarse.
Columnas URL0 (Enlace) y URL1 (Imagen)
Si bien las columnas URL0 (Enlace) y URL1 (Imagen) provienen del mismo tipo de campo de SharePoint, tienen diferentes opciones de configuración.
Mientras que la columna URL0 (Enlace) se puede filtrar como ‘text’, la URL1 (Imagen) no.
Ambos tipos de columna tienen diferentes transformaciones disponibles: ‘link’ para la columna URL0 (Enlace) e ‘image’ para la columna URL1 (Imagen). Estos corresponden a cómo los datos sin procesar se convierten en etiquetas HTML a o img.
Cuando se establece cualquiera de estas dos transformaciones, el valor ‘pipe’ debe ser ‘html’.
Instrucciones de instalación
Complete el formulario de registro a continuación y haga clic en el botón para descargar un archivo zip que contiene el archivo de solución .sppkg SPFx.
Esta solución solo funcionará en SharePoint Online. Si está interesado en una versión para SharePoint 2016/2019/Subscription Edition, háganoslo saber.
Si desea implementar esta solución en todo su entorno de SharePoint Online, debe agregar esta solución a su catálogo de aplicaciones de inquilino.
Para hacer esto, debe ser un administrador de SharePoint o un administrador global.
Si aún no tiene un catálogo de aplicaciones de inquilino (generalmente creado en la URL https://tu-inquilino.sharepoint.com/sites/appcatalog) puedes crear uno fácilmente.
- Abra su sitio de administración de SharePoint (https://tu-inquilino-admin.sharepoint.com/)
- En la barra lateral izquierda, seleccione ‘Más características’
- Luego localiza la sección ‘Aplicaciones’ y seleccione ‘Abrir’.
Esto iniciará la creación automática del catálogo de aplicaciones de inquilinos si no existe.
También puede instalar esta solución en un catálogo de aplicaciones de nivel de sitio si solo desea que esté disponible en sitios específicos de SharePoint.
Para obtener más información sobre cómo crear catálogos de aplicaciones de colecciones de sitios y cómo usarlos, lea este artículo de Microsoft.
Cuando agregue el archivo .sppkg al catálogo de aplicaciones, verá un cuadro de diálogo de implementación. Para que el elemento web Jarmit Agregador de Bibliotecas esté disponible directamente para todos los sitios de SharePoint, puede marcar la configuración «Hacer que esta solución esté disponible para todos los sitios de la organización».
Si no marca la configuración «Hacer que esta solución esté disponible para todos los sitios de la organización» durante la implementación, puede agregar el elemento web a sitios individuales de SharePoint yendo a la página de contenido del sitio y seleccionando Nuevo -> Aplicación.
La nueva experiencia moderna mostrará una lista de soluciones que puede agregar al sitio. Haga clic en el botón ‘Agregar’ debajo de la solución Jarmit Library Aggregator.
SharePoint tardará unos segundos en agregar el elemento web al sitio. Una vez que aparece en la página de contenido del sitio, puede agregarlo a una página de SharePoint.
Mientras edita una página de SharePoint, puede encontrar el elemento web Jarmit Agregador de Bibliotecas en la caja de herramientas en la sección ‘Avanzado’.
Cuando agrega el elemento web a una página, comienza un período de prueba completamente funcional de 14 días. Después de 14 días, el elemento web dejará de funcionar y mostrará un mensaje de «prueba finalizada».
Después de comprar una licencia, puede editar la página, abrir el panel de propiedades del elemento web y copiar el código de licencia en el cuadro de texto para activar la licencia.
Precio
Formulario de registración
Para descargar el elemento web Jarmit Agregador de Bibliotecas, rellenar el siguiente formulario.
Usar tu email de Microsoft 365 para registrar y consigue 1 suscripción por vida gratis a 365Desk.io (limite 1 por inquilino de Microsoft 365)