Esta guía ayuda a los administradores a preparar y enviar un archivo zip de las listas que sea compatible con la sincronización de listas en Turnitin Feedback Studio. Se explica la estructura de archivo requerida, los estándares de codificación y el comportamiento del protocolo SFTP para que puedas enviar datos de las listas que se procesen correctamente.
En esta guía:
Descripción general
Cuando los administradores configuran la sincronización de listas, deben enviar un archivo zip de las listas (a través de SFTP) que siga la especificación OneRoster v1.1. Turnitin no requiere todos los archivos o campos definidos en el estándar completo de OneRoster. Sin embargo, el archivo zip de las listas debe incluir los archivos CSV específicos y los valores de propiedad que la sincronización de listas utiliza durante el procesamiento.
Bloque vs. delta
La sincronización de listas utiliza el archivo manifest.csv para comprender cómo interpretar los datos que envías. En particular, se basa en los modos “bloque” y “delta” para determinar si cada archivo representa un panorama completo de tus datos o un conjunto de cambios.
-
Bloque significa “este archivo representa el conjunto completo actual de registros”.
Si omites clases, usuarios o inscripciones de una carga masiva, esos elementos pueden considerarse como eliminados. - Delta significa “este archivo incluye sólo los cambios realizados desde la última carga”.
La mayoría de los problemas ocurren cuando a las cargas masivas les faltan los registros esperados (por ejemplo, si una exportación SIS está incompleta). Antes de realizar el envío, confirma que tu exportación incluya el conjunto completo de registros que deseas mantener activos.
El archivo zip
El nombre del archivo zip de las listas puede ser cualquiera, pero los archivos que se encuentran dentro deben usar exactamente los nombres CSV requeridos. Cada archivo zip de las listas debe contener los archivos especificados que se enumeran en esta guía para que la sincronización de listas pueda procesar los datos correctamente.
Cada archivo zip de las listas debe incluir los siguientes archivos con los nombres de propiedades y formatos requeridos:
manifest.csv
Los valores variarán según el cliente, pero los nombres de las propiedades deben estar presentes y formateados correctamente.
propertyName,value manifest.version, 1.0 oneroster.version, 1.1 file.academicSessions,bulk file.categories,absent file.classes,bulk file.classResources,absent file.courses,bulk file.courseResources,absent file.demographics,bulk file.enrollments,bulk file.lineItems,absent file.orgs,bulk file.resources,absent file.results,absent file.users,bulk source.systemName, "OneRoster-Zipper" source.systemCode,OneRoster-ZipperSi alguna entrada file.[item] se establece en bulk, se espera que la carga esté completa para ese conjunto de datos. Los registros faltantes pueden provocar eliminaciones (por ejemplo, las inscripciones faltantes pueden excluir a estudiantes de las clases).
orgs.csv
sourcedId, status, dateLastModified, nameacademicSessions.csv
sourcedId, status, dateLastModified, title, startDate, endDate, schoolYearusers.csv
sourcedId, status, dateLastModified, enabledUser, orgSourcedIds, role, username, givenName, familyName, emailLa sincronización de listas no actualiza las direcciones de correo electrónico de los usuarios. Si el correo electrónico de un usuario cambia en tu SIS, es posible que ese cambio no se refleje en la sincronización de listas y que se requiera un flujo de trabajo diferente para actualizarlo.
classes.csv
sourcedId, status, dateLastModified, title, courseSourcedId, schoolSourcedId, termSourcedIdsenrollments.csv
sourcedId, status, dateLastModified, classSourcedId, schoolSourcedId, userSourcedId, role, primaryCodificación de archivos
Todos los archivos CSV en el zip de las listas deben estar codificados en UTF-8. UTF-16 (y otras codificaciones) puede provocar fallas de procesamiento incluso si los nombres de los archivos y los encabezados son correctos.
Carpetas SFTP
Cuando un cliente envía un archivo zip de las listas a través de SFTP, lo carga en la carpeta /transfer.
Una vez que se recibe el archivo, se notifica a la sincronización de listas para que comience a procesarlo. Como parte de ese proceso, el archivo zip de las listas se mueve de /transfer a la carpeta /archive. La carpeta /archive almacena cargas procesadas previamente durante hasta 30 días, por lo que si no ves un archivo en /transfer, verifica /archive.