Cuando carga un archivo en una biblioteca de documentos de SharePoint que tiene columnas de metadatos obligatorias, el proceso de carga puede detenerse o fallar sin previo aviso. Esto ocurre porque SharePoint aplica las reglas de metadatos antes de guardar el archivo. Si los campos de metadatos obligatorios faltan o no se completan correctamente, la carga del archivo se bloquea por completo. Este artículo explica por qué la aplicación de metadatos bloquea las cargas y proporciona métodos paso a paso para solucionar el problema.
Puntos clave: Solucionar los metadatos obligatorios que bloquean la carga de archivos
- Configuración de la biblioteca de SharePoint > Validación de columnas: Las columnas obligatorias deben tener valores predeterminados o la carga fallará.
- PowerShell Set-PnPListItem: Use este cmdlet para actualizar en masa los archivos existentes que están atascados debido a metadatos faltantes.
- Administración de tipos de contenido: Desactive los metadatos obligatorios en tipos de contenido específicos si la biblioteca usa varias plantillas.
Por qué SharePoint bloquea la carga de archivos cuando los metadatos son obligatorios
Las bibliotecas de documentos de SharePoint aplican la validación a nivel de columna en el momento en que se carga un archivo. Cuando una biblioteca contiene columnas marcadas como “Obligatorio”, SharePoint espera que esas columnas tengan un valor antes de que el archivo se confirme en la base de datos. Si el método de carga (arrastrar y soltar, carga desde el navegador o cliente de sincronización) no ofrece una forma de completar los metadatos obligatorios, la carga se rechaza o queda en estado pendiente.
La causa raíz técnica es el esquema de lista de la biblioteca. Cada columna tiene un atributo <Required> establecido en TRUE. El receptor de eventos de creación de elementos de SharePoint comprueba este atributo antes de guardar el archivo. Si el atributo es TRUE y el campo está vacío, el sistema genera un error de validación. Los usuarios ven mensajes como “Debe especificar un valor para este campo obligatorio” o la carga simplemente se detiene sin un error claro.
Otra causa común es la herencia de tipos de contenido. Si una biblioteca tiene varios tipos de contenido, cada uno puede definir sus propias columnas obligatorias. Cuando se carga un archivo con un tipo de contenido específico, SharePoint solo comprueba las columnas obligatorias de ese tipo de contenido. Si la columna es obligatoria en el tipo de contenido pero no en la biblioteca, la carga aún puede bloquearse.
Pasos para solucionar los metadatos obligatorios que bloquean la carga de archivos
Existen tres métodos fiables para resolver este problema. Elija el método que mejor se adapte a su entorno y a la cantidad de archivos afectados.
Método 1: Establecer valores predeterminados para las columnas obligatorias en la biblioteca
- Vaya a la configuración de la biblioteca
Vaya a la biblioteca de documentos donde se bloquean las cargas. Haga clic en el icono de engranaje y seleccione Configuración de la biblioteca. - Abra la configuración de la columna
En Columnas, haga clic en el nombre de la columna obligatoria que está bloqueando las cargas. - Cambie la opción Obligatorio a No
En la página de configuración de la columna, establezca Requerir que esta columna contenga información en No. Haga clic en Aceptar. - Pruebe la carga
Arrastre un archivo a la biblioteca. La carga debería realizarse correctamente sin solicitar metadatos. - Agregue un valor predeterminado (opcional)
Si aún desea que la columna aparezca pero sin bloquear las cargas, establezca un Valor predeterminado en la configuración de la columna. Mantenga Obligatorio establecido en No.
Método 2: Usar PowerShell para actualizar archivos atascados con metadatos
Si los archivos ya están atascados en la biblioteca debido a metadatos obligatorios faltantes, use SharePoint Online Management Shell o PnP PowerShell para actualizarlos.
- Conéctese a SharePoint Online
Abra PowerShell como administrador. EjecuteConnect-PnPOnline -Url "https://yourtenant.sharepoint.com/sites/yoursite" -Interactive - Obtenga la lista de archivos atascados
Ejecute$items = Get-PnPListItem -List "Documents" -PageSize 500 | Where-Object { $_.FieldValues["RequiredColumnName"] -eq $null } - Actualice cada elemento con un valor
EjecuteSet-PnPListItem -List "Documents" -Identity $item.Id -Values @{"RequiredColumnName" = "Default Value"} - Verifique que los archivos se hayan actualizado
Actualice la biblioteca en el navegador. Los archivos ahora deberían aparecer con los metadatos completados.
Método 3: Quitar el requisito de tipo de contenido para columnas específicas
- Vaya a la configuración de Tipos de contenido
En Configuración de la biblioteca, en Tipos de contenido, haga clic en el tipo de contenido que está bloqueando las cargas. - Abra la columna
Haga clic en el nombre de la columna obligatoria en Columnas. - Cambie la opción Obligatorio
Establezca Requerir que esta columna contenga información en No. Haga clic en Aceptar. - Repita el proceso para cada tipo de contenido
Si la biblioteca usa varios tipos de contenido, repita los pasos para cada uno que tenga la columna obligatoria.
Si los metadatos siguen bloqueando la carga después de la solución principal
La carga de archivos se detiene sin mensaje de error
Esto suele ocurrir cuando una columna obligatoria usa un campo de búsqueda o de metadatos administrados. El cargador del navegador no puede mostrar el selector de búsqueda durante la operación de arrastrar y soltar. En su lugar, use el botón Cargar > Agregar un archivo, que abre el panel de metadatos. Como alternativa, desactive la configuración de obligatorio en las columnas de búsqueda.
La carga funciona para algunos usuarios pero no para otros
Compruebe los permisos de los usuarios. Los usuarios con permiso Colaborar o Editar pueden cargar archivos, pero es posible que no tengan permiso para completar ciertos campos de metadatos si esos campos están restringidos por la configuración de permisos a nivel de elemento. Conceda acceso de Lectura o Edición a la columna específica en la configuración de permisos de la biblioteca.
Los archivos cargados mediante el cliente de sincronización de Microsoft fallan
El cliente de sincronización de OneDrive no admite campos de metadatos obligatorios. Los archivos sincronizados desde una carpeta local no se podrán cargar si la biblioteca tiene columnas obligatorias. Desactive la configuración de obligatorio en todas las columnas que los usuarios de sincronización deban completar. Como alternativa, indique a los usuarios que carguen a través del navegador y completen los metadatos manualmente.
Comparación de la configuración de la biblioteca: Métodos de aplicación de metadatos
| Elemento | Columna obligatoria (sin valor predeterminado) | Columna obligatoria (con valor predeterminado) | Columna no obligatoria |
|---|---|---|---|
| Carga mediante arrastrar y soltar | Bloqueada | Permitida | Permitida |
| Carga mediante el botón Agregar del navegador | Solicita metadatos | Permitida con relleno automático | Permitida |
| Carga mediante el cliente de sincronización | Falla con error de sincronización | Permitida si se establece un valor predeterminado | Permitida |
| Actualización masiva con PowerShell | Funciona si se proporciona un valor | Funciona | Funciona |
Después de aplicar uno de los tres métodos, los usuarios pueden cargar archivos en la biblioteca de SharePoint sin que los metadatos lo bloqueen. Para la administración continua, revise todas las columnas obligatorias en la configuración de la biblioteca y establezca valores predeterminados siempre que sea posible. Un consejo avanzado: use fórmulas de validación de columnas de SharePoint para permitir valores vacíos solo durante la carga y, luego, aplique los metadatos mediante flujos de Power Automate después de que se confirme el archivo.