Información de plantilla para importar datos a Apple School Manager
Para agregar datos a Apple School Manager, puedes usar archivos de plantilla .csv con formato de Apple o OneRoster.
Nombres de plantillas .csv de Apple: Students, Staff, Courses, Classes, Rosters, Locations
Nombres de plantillas .csv de OneRoster: Users, Courses, Classes, Enrollments, Orgs
Nombre de archivo de Apple | Nombre de archivo de OneRoster | Contenido | |||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
Apple: contiene información de las cuentas de estudiantes. OneRoster: contiene información de las cuentas de estudiantes, profesores y personal. | |||||||||||
No aplica | Contiene información de las cuentas del personal, como docentes. | ||||||||||
Contiene información del curso. | |||||||||||
Contiene información de las clases y los docentes (personal). | |||||||||||
Contiene información de las clases, los estudiantes y las ubicaciones (listas). | |||||||||||
Contiene información de la ubicación (escuela o departamento). | |||||||||||
Plantillas y cuentas administradas de Apple
Si un campo opcional, como person_number o sis_username, es parte del formato de tu cuenta de Apple administrada, se convierte en un campo requerido. Si lo dejas en blanco, la carga de SFTP arrojará el error MANAGED_ID_GENERATION_FAILED.
Preparar plantillas
Cuando prepares una plantilla, se deben cumplir los siguientes criterios:
Para las plantillas de estudiantes.csv y personal.csv, el ID personal debe ser único para todas las ubicaciones.
Importante: Si usas SFTP para cargar un nuevo usuario y el ID personal que asignas ya está asignado a otro usuario, el nuevo usuario sobrescribe al usuario existente en Apple School Manager. Una vez que se completa la sobreescritura, sólo puedes actualizar ese usuario a través de SFTP.
Si editas las plantillas, reemplaza los datos suministrados como ejemplo por los tuyos. No modifiques el contenido de las filas de encabezado en ningún archivo. No crees columnas duplicadas en ningún archivo. Puedes agregar columnas a plantillas específicas.
En todas las plantillas, cada fila debe representar un valor único. Por ejemplo, en el archivo estudiantes.csv, cada fila debe tener un sólo estudiante. Algunos valores para ese estudiante pueden permanecer vacíos. Los valores literales, como un salto de línea o comillas dentro de un nombre, deben tener antepuesta una barra invertida (\). Por ejemplo: \". Los identificadores que ingreses deben ser alfanuméricos y pueden incluir un guion (-).
Si el valor contiene un espacio ( ) o una coma (,), usa comillas rectas (") para delimitarlo. Si el valor no tiene ninguno de estos caracteres especiales, no uses las comillas. Si no usas comillas donde sean necesarias, o si usas comillas inglesas (“ ”), se producirán errores durante el proceso de carga.
Los valores en los archivos deben estar separados por una coma (,) o un punto y coma (;), sin importar cómo se creó el archivo. No debe haber espacios ni tabulaciones entre una coma o punto y coma y el siguiente valor. Cada archivo se debe codificar como UTF-8. Para representar el final de línea, usa la codificación de nueva línea \n de UNIX.
Si falta una entrada de una carga anterior, la cuenta de usuario se desactiva y se elimina automáticamente después de 120 días, excepto en los siguientes casos:
El usuario tiene una función que tiene apps y libros comprados por volumen
El usuario se elimina manualmente antes del límite de 120 días
El nombre del archivo .csv debe coincidir completamente con el nombre original del archivo.
Todos los archivos se deben comprimir en un archivo .zip para ser cargados.
No se debe colocar ningún archivo en una carpeta ubicada dentro del archivo .zip.
Todas las referencias de clave foránea para otros archivos .csv se deben definir en el archivo de referencia.
Límites de caracteres en plantillas .csv
Algunos campos en las plantillas .csv tienen límites en el número de caracteres permitidos.
Nombre de atributo | Plantillas | Límite de caracteres |
|---|---|---|
Apple: first_name OneRoster: givenName | Apple: Students, Staff OneRoster: Users | 32 |
Apple: middle_name OneRoster: middleName | Apple: Students, Staff OneRoster: Users | 32 |
Apple: last_name OneRoster: familyName | Apple: Students, Staff OneRoster: Users | 64 |
Apple: grade_level OneRoster: grades | Apple: Students OneRoster: Users | 64 |
Apple: email_address OneRoster: email | Apple: Students OneRoster: Users | 256 |
Apple: person_number OneRoster: identifier | Apple: Students, Staff OneRoster: Users | 64 |
Apple: person_id OneRoster: sourcedId | Apple: Students, Staff, Classes, Rosters OneRoster: Users, Classes, Enrollments | 256 |
Apple: sis_username OneRoster: username | Apple: Students, Staff OneRoster: Users | 256 |
Apple: class_id OneRoster: sourcedID | Apple: Classes, Rosters OneRoster: Classes, Enrollments | 256 |
Apple: class_number OneRoster: classCode | Apple: Students, Classes OneRoster: Classes | 64 |
Apple: course_id OneRoster: sourcedID | Apple: Courses, Classes OneRoster: Courses, Classes | 256 |
Apple: course_name OneRoster: title | Apple: Courses OneRoster: Courses | 128 |
Apple: course_number OneRoster: courseCode | Apple: Courses OneRoster: Courses | 64 |
Apple: location_name OneRoster: name | Apple: Locations OneRoster: Orgs | 256 |
Apple: location_id OneRoster: sourcedID | Apple: Students, Staff, Courses, Classes, Locations OneRoster: Users, Courses, Classes, Orgs | 256 |