Información de la plantilla para importar datos en Apple School Manager
Para añadir datos a Apple School Manager, puedes usar archivos de plantilla .csv con formato para Apple o para OneRoster.
Nombres de plantillas .csv con formato para Apple: Students (estudiantes), Staff (personal), Courses (cursos), Classes (clases), Rosters (listas de estudiantes), Locations (sedes)
Nombres de plantillas .csv con formato para OneRoster: Users (usuarios), Courses (cursos), Classes (clases), Enrollments (inscripciones), Orgs (organizaciones)
Nombre de archivo de Apple | Nombre de archivo de OneRoster | Contenido | |||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
Apple: Contiene información sobre las cuentas de estudiantes. OneRoster: Contiene información sobre las cuentas de estudiantes, profesores y personal. | |||||||||||
No aplicable | Contiene información sobre las cuentas de los miembros del personal, como los profesores. | ||||||||||
Contiene información sobre cursos. | |||||||||||
Contiene información sobre las clases y los profesores (miembros del personal). | |||||||||||
Contiene información de clases, estudiantes y sedes (listas de estudiantes). | |||||||||||
Contiene información sobre sedes (centros educativos o departamentos). | |||||||||||
Plantillas y Cuentas de Apple gestionadas
Si el formato de tu Cuenta de Apple gestionada contiene un campo opcional, como person_number o sis_username, este se convierte en un campo obligatorio. Si lo dejas en blanco, no se podrá realizar la carga de SFTP y aparecerá el error MANAGED_ID_GENERATION_FAILED.
Preparar plantillas
Cuando prepares una plantilla, debes cumplir estos requisitos:
En las plantillas students.csv y staff.csv, person_id debe ser único para todos los centros.
Importante: Si usas SFTP para cargar un nuevo usuario y el person_id que asignas ya está asignado a otro usuario, el nuevo usuario reemplaza al usuario actual de Apple School Manager. Una vez reemplazado, solo podrás actualizar ese usuario mediante SFTP.
Si modificas las plantillas, sustituye los datos de ejemplo por los tuyos. No cambies el contenido de la fila de cabecera de cada archivo. No crees columnas duplicadas en ningún archivo. Puedes añadir columnas a plantillas específicas.
En las plantillas, cada fila debe representar un valor único. Por ejemplo, en el archivo students.csv, cada fila debe representar un estudiante. Algunos valores asociados a los estudiantes pueden estar en blanco. Los valores literales (como un salto de línea o comillas que formen parte del nombre) deben escaparse con una barra invertida (\). Por ejemplo: \". Todos los identificadores que se utilicen deben ser alfanuméricos y pueden incluir un guion (-).
Si el valor contiene un espacio ( ) o una coma (,), usa las comillas rectas(") delante y detrás de dichos caracteres. Si tu valor no contiene ninguno de estos caracteres especiales, no utilices comillas. Si no las usas cuando son necesarias o usas las comillas tipográficas, se producirán errores en el proceso de carga.
Los valores de los archivos deben estar separados por comas (,) o puntos y coma (;), independientemente de cómo hayas creado el archivo. No uses espacios ni tabulaciones entre la coma (o el punto y coma) y el valor siguiente. Todos los archivos deben tener la codificación UTF-8. Para indicar el final de línea, usa el código de nueva línea de UNIX: \n.
Si falta alguna entrada de una carga anterior, la cuenta de usuario se desactivará y se eliminará automáticamente transcurridos 120 días, salvo en las siguientes situaciones:
El usuario tiene una función asociada con la compra de apps o libros por volumen
El usuario se elimina de forma manual antes de que transcurran los 120 días
Los nombres de los archivos .csv deben ser idénticos al nombre del archivo original.
Todos los archivos deben comprimirse en un único archivo comprimido (.zip) para poder cargarlos.
El archivo comprimido no puede contener ninguna carpeta con archivos.
Todas las referencias de clave externa a otros archivos .csv deben definirse en el archivo de referencia.
Límites de caracteres en plantillas .csv
Algunos campos de las plantillas .csv tienen límites de caracteres.
Nombre del 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: Clases | 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 |