Información de la plantilla para importar datos en Apple School Manager
Para añadir datos a Apple School Manager, puedes usar archivos .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:
Estructura
Los nombres de los archivos .csv deben ser exactamente iguales al nombre del archivo original.
No cambies el nombre de la fila de cabecera de ningún archivo.
No elimines ninguna columna, aunque esta esté vacía.
Puedes añadir columnas a las plantillas de estudiantes, miembros del personal y clases.
En las plantillas, cada fila debe representar un valor único. Por ejemplo, en el archivo students.csv, cada fila debe ser un estudiante.
En las plantillas students.csv y staff.csv, person_id debe ser único para todos las sedes.
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.
Algunos valores pueden estar vacíos. Por ejemplo, en el archivo students.csv, el segundo nombre puede estar vacío.
Sustituye los datos de ejemplo por los tuyos.
Formato
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 .csv 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.
Todas las referencias de clave externa a otros archivos .csv deben definirse en el archivo de referencia.
Carga
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
Todos los archivos .csv deben comprimirse en un único archivo comprimido (.zip) para poder cargarlos.
El archivo comprimido no puede contener ninguna carpeta con archivos.
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 |