Información de plantilla para importar registros a Apple School Manager
Apple ofrece seis plantillas para utilizar al agregar datos a tu ubicación:
Estudiantes: contiene información de las cuentas de estudiantes.
Personal: contiene información de las cuentas del personal, como profesores.
Cursos: define cursos.
Clases: contiene información de cursos, profesores (personal).
Listas: contiene información de clases, estudiantes y ubicaciones.
Ubicaciones: contiene información de ubicaciones.
Plantillas y Apple ID administrados
Si un campo opcional, como person_number o sis_username, es parte del formato de tu Apple ID administrado, 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 csv de estudiantes y personal, 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 sobrescritura, solo puedes actualizar ese usuario a través de SFTP.
Si editas las plantillas, remplaza 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 se desactivará y se eliminará automáticamente después de 120 días, a menos que la cuenta haya comprado contenido por volumen.
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.
Campo | Plantillas | Límite de caracteres |
|---|---|---|
first_name | Estudiantes, Personal | 32 |
middle_name | Estudiantes, Personal | 32 |
last_name | Estudiantes, Personal | 64 |
grade_level | Estudiantes | 64 |
email_address | Estudiantes | 256 |
person_number | Estudiantes, Personal | 64 |
person_id | Estudiantes, Personal, Clases, Listas | 256 |
sis_username | Estudiantes, Personal | 256 |
class_id | Clases, Listas | 256 |
class_number | Clases | 64 |
course_id | Cursos, Clases | 256 |
course_name | Cursos | 128 |
course_number | Cursos | 64 |
location_name | Ubicaciones | 256 |
location_id | Estudiantes, Personal, Cursos, Clases, Ubicaciones | 256 |