Información de la plantilla para importar registros en Apple School Manager
Apple te ofrece seis plantillas para añadir datos a tu sede:
Estudiantes: contiene información de las cuentas de estudiante.
Miembros del personal: contiene información de las cuentas de los miembros del personal, como los profesores.
Cursos: enumera los cursos.
Clases: contiene información de los cursos y profesores (miembros del personal).
Listas de estudiantes: contiene información de clases, estudiantes y sedes.
Sedes: contiene información de las sedes.
Plantillas e ID de Apple gestionados
Si el formato de tu ID de Apple gestionado 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 guión (-).
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 se desactivará y se eliminará automáticamente pasados 120 días, a no ser que la cuenta haya adquirido el contenido del volumen.
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.
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 de estudiantes | 256 |
sis_username | Estudiantes, Personal | 256 |
class_id | Clases, Listas de estudiantes | 256 |
class_number | Clases | 64 |
course_id | Cursos, Clases | 256 |
course_name | Cursos | 128 |
course_number | Cursos | 64 |
location_name | Sedes | 256 |
location_id | Estudiantes, Personal, Cursos, Clases, Sedes | 256 |