O Canvas permite importar arquivos CSV para criar manualmente, em massa, usuários, contas, períodos letivos, cursos, turmas, matrículas e logins por meio da interface de administração.
Este documento faz referência à página da API de Importação de Formato CSV do SIS , onde se encontra a maior parte das informações sobre o formato CSV. Cada arquivo CSV interage com os demais e informa ao Canvas como gerenciar as informações da conta. Veja o diagrama de relacionamento do SIS .
Arquivos de exemplo
Cada etapa desta lição fornece detalhes sobre os arquivos CSV e descrições de cada campo obrigatório e opcional. Cada etapa também inclui um link para baixar um arquivo CSV de exemplo. Os arquivos de exemplo contêm todos os campos obrigatórios e podem também conter campos opcionais. Além disso, você pode baixar um pacote compactado com todos os arquivos de exemplo . Se os links para os arquivos CSV não abrirem, tente abri-los em uma nova aba.
Você deve praticar a importação de dados em seu ambiente de teste do Canvas antes de importar qualquer conteúdo para seu ambiente de produção.
Formato de arquivo CSV
Para fazer o upload em massa de dados para o Canvas, você precisa criar um ou mais arquivos de texto CSV. Arquivos CSV podem ser gerados por diversos programas. Os Sistemas de Informação Acadêmica (SIS) geralmente possuem um método para gerar relatórios em formato CSV que pode ser modificado para se adequar ao formato exigido pelo Canvas. Se você não sabe como salvar um arquivo no formato CSV, consulte a documentação do programa que você está usando para criar seu arquivo CSV (por exemplo, Excel).
Ao usar o formato Instructure para importar arquivos na página de Importação do SIS , você pode importar um arquivo de texto CSV individual ou compactar vários arquivos em um único arquivo ZIP para importar dados em lote. Se você estiver carregando arquivos individualmente, eles devem ser carregados na ordem mostrada nesta lição.
Formatação de campos CSV
A primeira linha do seu arquivo CSV (cabeçalho) deve incluir o nome completo de cada campo. A ordem das colunas não importa, mas ter as linhas ordenadas corretamente é crucial para arquivos como o accounts.csv.
Campos pegajosos
Por padrão, certas alterações feitas na interface do usuário não são sobrescritas por importações futuras do SIS e são especificadas como persistentes. Todos os campos persistentes estão identificados neste documento. Você pode sobrescrever esses campos definindo `override_sis_stickiness` na API ou marcando a caixa de seleção "Sobrescrever alterações da interface do usuário" na página de importação do SIS .
Documentação da API
Os arquivos CSV incluem apenas um conjunto específico de campos. O Canvas contém valores adicionais que estão disponíveis por meio de cada API individual. Após gerar os arquivos CSV para sua instituição, a prática padrão da maioria das instituições é fazer o upload de todos os arquivos CSV do SIS e, em seguida, usar a API do Canvas para atualizar todos os atributos de conta e curso. Para obter mais informações, consulte a documentação da API do Canvas para Usuários, Contas, Períodos, Cursos, Turmas, Matrículas e Grupos. As importações do SIS também podem ser gerenciadas usando a API de Importações do SIS .
Observação: A linha de cabeçalho em seus arquivos CSV define quais campos de dados o Canvas processará. Embora os guias de importação do SIS listem todos os campos compatíveis, seu arquivo CSV precisa incluir apenas as colunas que você está atualizando. Se um campo compatível estiver faltando em seu arquivo, você pode adicionar o cabeçalho manualmente à primeira linha.
usuários.csv
Usuários são as pessoas que possuem contas de usuário dentro de uma instituição. O arquivo users.csv adiciona pessoas ao sistema como usuários genéricos. O arquivo enrollments.csv atribui uma função (professor, aluno, etc.) a esses usuários. Quando uma conta de usuário é excluída , todas as suas matrículas também serão excluídas e ele não poderá mais acessar sua conta do Canvas. Se você ainda deseja que o usuário possa acessar o sistema, mas não participar de cursos, ou se deseja excluí-lo apenas de um curso específico, você deve manter a conta de usuário ativa e alterar a matrícula (no arquivo enrollments.csv) para concluída ou excluída , respectivamente.
Baixe um arquivo users.csv de exemplo com 10 contas de usuário do Canvas.
Campo obrigatório*| Campo pegajoso^
- ID do usuário*Este é um valor único usado para identificar qualquer pessoa com uma conta no Canvas. Esse valor não deve mudar para o usuário e deve ser único para todos os usuários. Na interface do usuário, ele é chamado de ID SIS e pode ser composto por qualquer combinação de caracteres. Você pode encontrar esse ID SIS acessando qualquer conta de usuário e visualizando suas Informações de Login.
- integration_id: Este é um identificador único secundário útil para integrações SIS mais complexas. Este identificador não deve mudar para o usuário e deve ser globalmente único.
- login_id*^:
- Senha: Se a conta estiver configurada para usar LDAP ou um protocolo SSO, esta senha não é necessária. Caso contrário, esta é a senha do 'login_id' acima. Esta senha deve ter pelo menos 8 caracteres.
- ssha_password: Em vez de uma senha em texto simples, você pode fornecer uma senha pré-criptografada usando o esquema de geração de senha SSHA neste campo. Embora seja melhor do que fornecer uma senha em texto simples, você ainda deve incentivar os usuários a alterarem suas senhas após o primeiro login.
- authentication_provider_id: Este é o provedor de autenticação ao qual o login está associado. Logins associados a um provedor específico só podem ser usados com esse provedor. Provedores legados (LDAP, CAS, SAML) buscarão logins associados a eles ou logins não associados. Novos provedores buscarão apenas logins explicitamente associados a eles. Este pode ser o ID inteiro do provedor ou o tipo do provedor (nesse caso, encontrará o primeiro provedor correspondente).
- first_name^: Este é o nome (primeiro nome) do usuário. Se presente, é usado para construir full_name e/ou sortable_name.
- last_name^: Este é o sobrenome (último nome) do usuário. Se presente, é usado para construir full_name e/ou sortable_name.
- full_name^: Este é o nome e sobrenome do usuário. Omita first_name e last_name se estes forem fornecidos.
- sortable_name^ : Esta é a opção de nome classificável no Canvas, geralmente inferida a partir do nome do usuário, mas pode ser personalizada.
- short_name^: Este é o nome de exibição do usuário, geralmente inferido do nome do usuário, mas pode ser personalizado.
- E-mail: Este é o endereço de e-mail atribuído pela instituição e também será definido como o endereço de e-mail padrão para esta conta de usuário. Este endereço de e-mail deve ser fornecido mesmo que seja o mesmo que o login_id do usuário.
- pronomes^: Se os pronomes pessoais estiverem ativados, estes serão os pronomes pessoais exibidos após o nome do usuário no Canvas. O campo de pronomes aceita todos os pronomes, mesmo que não tenham sido criados na página Configurações da conta.
- declared_user_type: Este tipo de usuário declarado pode ser administrativo, observador, funcionário, aluno, aluno_outro ou professor. Pode-se passar "<delete>" para remover o tipo de usuário declarado do usuário.
- canvas_password_notification: O valor padrão é falso. Quando definido como verdadeiro, o usuário é notificado para configurar a senha se o authentication_provider_id for canvas. Se sua instituição não possui integração com o Canvas SIS, este campo é obrigatório para notificar novos usuários sobre suas contas criadas.
- home_account: Definir home_account como verdadeiro criará um novo usuário na conta de destino para a importação do SIS e mesclará outro usuário existente de outra conta dentro do consórcio com um integration_id correspondente. Será ignorado, a menos que a conta de destino esteja associada a um consórcio de mesclagem automática.
- status*^:Aqui você pode adicionar ou remover um usuário do Canvas. Marque como ativo para adicionar um usuário, suspenso para suspender um usuário ou excluído para remover um usuário existente.
Observação: Não é necessário que os arquivos CSV contenham todos os campos possíveis. Para garantir uma importação bem-sucedida, seu arquivo deve incluir todos os cabeçalhos obrigatórios , mas os cabeçalhos opcionais (como integration_id ou authentication_provider_id) só precisam ser incluídos se você estiver fornecendo dados para esses campos específicos.
Conflitos de endereço de e-mail
O Canvas identifica os usuários pelo endereço de e-mail. Quando os alunos são adicionados a um curso, o Canvas tenta resolver quaisquer conflitos de endereço de e-mail quando o usuário acessa o curso pela primeira vez.
Normalmente, os endereços de e-mail são exclusivos para cada aluno. Às vezes, vários alunos podem compartilhar um único endereço de e-mail. Ao adicionar alunos a cursos por meio da importação do SIS, o Canvas reconhece quando um endereço de e-mail é atribuído a mais de um aluno.
- Se um novo ID SIS for associado a um endereço de e-mail já atribuído a um ID SIS existente, o Canvas enviará um e-mail para esse endereço.
- Quando usuários são adicionados a uma conta por meio da importação do SIS, eles não receberão uma notificação por e-mail, a menos que o sistema detecte um usuário duplicado. No entanto, se um usuário for adicionado ou matriculado manualmente, ele receberá um e-mail notificando-o de que foi adicionado ou matriculado em um novo curso. O aluno que compartilha o endereço de e-mail receberá uma notificação informando que o endereço de e-mail já está em uso e será convidado a criar uma nova conta no Canvas. Esse processo também pode ser aplicado ao adicionar um usuário à matrícula em um curso.
contas.csv
Uma conta é uma unidade organizacional dentro do Canvas (por exemplo, a conta principal de uma instituição). Cada conta pode conter uma hierarquia de subcontas, como a criação de contas para faculdades individuais dentro de uma instituição ou para escolas individuais dentro de um distrito. As subcontas também podem conter múltiplas subcontas, como quando uma faculdade se subdivide em departamentos ou programas, ou uma escola que se subdivide em séries ou disciplinas.
Baixe um arquivo accounts.csv de exemplo com as seguintes subcontas:
- 3 subcontas dentro da sua conta principal/raiz. (Artes e Humanidades, Negócios, Matemática e Ciências)
- 4 subcontas dentro da sua subconta comercial. (Contabilidade, Ciência da Computação, Economia e Marketing)
- 3 subcontas dentro da sua subconta de Matemática e Ciências. (Biologia, Física e Estatística)
- 1 subconta dentro da sua subconta de Artes e Humanidades. (Artes Visuais)
- 2 subcontas dentro da sua subconta de Artes Visuais (Fotografia e Mídia Digital).
Campo obrigatório*| Campo pegajoso^
- account_id*:Este é um identificador único usado para criar uma subconta. O arquivo courses.csv permite atribuir cursos a um ID de conta específico. Este identificador único não deve ser alterado para a conta e deve ser globalmente único em todas as contas. Na interface do Canvas, ele é chamado de ID SIS e pode ser modificado acessando as Configurações de cada subconta.
- parent_account_id*^: Este identificador indica que uma subconta deve ser aninhada abaixo desta conta principal. Se este campo estiver em branco, a subconta será aninhada abaixo da sua conta raiz ou principal. Observe que, mesmo que todos os valores estejam em branco, a coluna deve ser incluída para diferenciar o arquivo de uma importação em grupo.
- nome*^ : Este é o nome da subconta.
- status*:Veja como criar ou remover uma subconta. Marque como ativa para adicionar uma subconta ou como excluída para remover uma subconta existente.
- integration_id: Este é um identificador único secundário útil para integrações SIS mais complexas. Este identificador não deve ser alterado para a conta e deve ser globalmente único.
termos.csv
Um período letivo define um conjunto padrão de datas de início e término para qualquer disciplina atribuída a ele. As datas do período letivo podem ser gerenciadas manualmente no nível da disciplina, sem a necessidade de importar um arquivo. No entanto, associar um `term_id` a várias disciplinas diferentes garante que todas as disciplinas daquele período comecem e terminem no mesmo horário. As datas do período letivo também ajudam a classificar e organizar as disciplinas ao visualizar dados e relatórios na interface administrativa.
Baixe um arquivo terms.csv de exemplo com 10 termos.
Campo obrigatório*| Campo pegajoso^
- term_id*: Este é um identificador único para o período letivo. O arquivo courses.csv permitirá que você referencie este term_id para que seus cursos saibam quando começar e quando terminar. Este identificador não deve mudar durante o período letivo e deve ser globalmente único em todos os períodos. Na interface do usuário, ele é chamado de ID do SIS.
- nome*^: Este é o nome do seu termo. Crie uma boa convenção de nomenclatura que facilite a referência aos seus termos. Existem muitas ferramentas administrativas que permitem pesquisar ou consultar dados pelo nome do termo.
- status*: Veja como criar ou remover um termo. Marque como ativo para adicionar um termo ou como excluído para remover um termo existente.
- start_date^: Esta é a data de início do período letivo. O formato deve ser ISO 8601 : AAAA-MM-DDTHH:MM:SSZ (O T pode ser substituído por um espaço, como mostrado na captura de tela de exemplo). Por exemplo, 26 de agosto de 2013 às 17h00 EST seria escrito como 2013-08-26T17:00-5:00.
- data_fim^: Esta é a data de término do período letivo. O formato deve ser ISO 8601 : AAAA-MM-DDTHH:MM:SSZ (O T pode ser substituído por um espaço, como mostrado na captura de tela de exemplo). Por padrão, o acesso do usuário é encerrado à meia-noite da data de término indicada, o que significa que o dia anterior é o último dia completo em que os usuários têm acesso ao período letivo. A melhor prática é definir a data de término para o dia seguinte ao término do período letivo.
- integration_id: Este é um identificador único secundário útil para integrações SIS mais complexas. Este identificador não deve mudar durante o período e deve ser globalmente único.
- date_override_enrollment_type: Esta opção permite definir ou remover datas de início e término para um tipo de matrícula específico dentro de um período letivo existente. Quando definida, todas as colunas, exceto term_id, status, start_date e end_date, serão ignoradas para a linha. Se o status for definido como ativo, as datas do período letivo serão aplicadas somente às matrículas do tipo especificado. Se o status for definido como excluído, as datas definidas atualmente serão removidas para o tipo de matrícula especificado. O tipo de matrícula pode ser definido como StudentEnrollment, TeacherEnrollment, TaEnrollment ou DesignerEnrollment.
cursos.csv
Um curso é uma apresentação organizada sobre um assunto específico. Às vezes, um curso pode incluir uma série de módulos. Os cursos são organizados em períodos letivos para definir datas de início e término padrão. No entanto, se um curso incluir datas específicas, essas datas substituirão as datas de acesso dos alunos ao período letivo, identificadas pelo `term_id` (se houver). A vantagem de atribuir um `term_id` é que você poderá classificar e organizar os cursos ao visualizar dados e relatórios na interface administrativa. Um `term_id` pode ser facilmente associado a vários cursos diferentes que começam e terminam no mesmo período. Se você não vincular um curso a um período letivo, ele será vinculado ao período letivo denominado "Período Padrão".
Se a sua instituição tiver habilitado os Cursos Modelo, você pode usar um arquivo courses.csv para adicionar cursos associados a um curso modelo. Observe que o curso modelo deve ser criado e habilitado como tal antes que os cursos associados possam ser adicionados.
Baixe um arquivo de exemplo courses.csv com 10 cursos; eles estão localizados em suas respectivas subcontas em um período específico.
Campo obrigatório*| Campo pegajoso^
- id_do_curso*:Este é um identificador único usado para diferenciar os cursos no Canvas. Este identificador não deve mudar para o curso e deve ser globalmente único em todos os cursos . Na interface do usuário, ele é chamado de ID SIS.
- nome_curto*^: Este é o nome abreviado do curso. Na interface do Canvas, ele também é chamado de Código do Curso ou Código de Referência .
- nome_longo*^: Este é o nome completo do curso. (Pode ser o mesmo que o nome abreviado, mas se ambos estiverem disponíveis, proporcionará uma melhor experiência ao usuário.)
- account_id^: Este é o identificador único da conta SIS (do arquivo accounts.csv) que indica em qual subconta o curso estará vinculado. Se um account_id não for especificado para um novo curso, ele será vinculado à sua conta principal/raiz. O ID SIS pode ser encontrado nas Configurações da subconta.
- term_id^: Este é o identificador único do período (do arquivo terms.csv) que indica ao curso quando ele deve começar e quando deve terminar. Ao associar um term_id a um curso, não é necessário inserir uma start_date ou end_date.
- status*^: Este é o status do curso, também conhecido como workflow_state. Este campo permite criar, remover, concluir ou publicar um curso. Marque como ativo para adicionar um curso, excluído para remover um curso existente, concluído para finalizar um curso existente ou publicado para publicar um curso novo ou existente.
- integration_id: Este é um identificador único secundário útil para integrações SIS mais complexas. Este identificador não deve mudar ao longo do curso e deve ser globalmente único.
- start_date^: Esta é a data de início do curso. O formato deve ser ISO 8601 : AAAA-MM-DDTHH:MM:SSZ (O T pode ser substituído por um espaço).
- data_final^: Esta é a data de término do curso. O formato deve ser ISO 8601 : AAAA-MM-DDTHH:MM:SSZ (o T pode ser substituído por um espaço). Por padrão, o acesso do usuário é encerrado à meia-noite da data final indicada, o que significa que o dia anterior é o último dia completo em que os usuários têm acesso ao curso. A melhor prática é definir a data final para o dia seguinte ao término do curso.
- course_format : Este é o formato do curso. O formato pode ser online , presencial ou híbrido .
- blueprint_course_id : Este é o ID do curso modelo ao qual você deseja adicionar um curso associado. Para remover o vínculo do curso modelo, você pode usar 'dissociate' no lugar do ID. Na interface do usuário, este é o ID SIS do curso modelo.
- homeroom_course: Este parâmetro é usado para designar as turmas principais em contas do Canvas para o Ensino Fundamental. Requer que a configuração do Canvas para o Ensino Fundamental esteja ativada.
seções.csv
Uma turma subdivide os alunos dentro de um curso. Várias turmas podem ser incluídas em um mesmo curso, especialmente se todos os alunos de cada turma estiverem estudando o mesmo conteúdo. É possível que várias turmas estejam em um mesmo curso, mas uma turma não pode conter outras turmas. As turmas herdam as datas do curso definidas pelo período letivo. No entanto, se uma turma incluir datas específicas, essas datas terão prioridade sobre as datas de acesso dos alunos ao curso e sobre as datas de início e/ou término do período letivo.
Se você estiver tentando excluir um curso e os usuários estiverem associados a turmas, será necessário incluir o parâmetro section_id na importação do arquivo CSV, bem como os IDs SIS das turmas.
Baixe um arquivo sections.csv de exemplo com as seguintes seções:
- O curso ACCT300 - Contabilidade de Custos é composto por 4 seções.
- O curso ACCT310 - Contabilidade Gerencial é composto por 4 seções.
- 2 seções no curso BIO101 - Introdução à Biologia
Este arquivo pressupõe que você possa ter várias turmas dentro de um mesmo curso. Muitas instituições importam turmas como cursos separados. Isso pode ser feito (1) criando um curso no Canvas para cada turma em seu arquivo courses.csv e, em seguida, (2) criando uma única turma em cada um desses cursos. Você pode usar essencialmente os mesmos dados para o curso e a turma, incluindo o ID do SIS, que será o mesmo tanto para o course_id quanto para o section_id.
Campo obrigatório*| Campo pegajoso^
- section_id*:Este é um identificador único usado para criar seções dentro de um curso. Este identificador não deve mudar para a seção e deve ser globalmente único. Na interface do usuário, ele é chamado de ID SIS.
- id_do_curso*^: Este é o identificador único do curso onde a seção será adicionada ou excluída (adicionado em courses.csv).
- nome*^: Este é o nome da seção. As seções estão ordenadas alfabeticamente por nome.
- status*:Veja como criar ou remover uma seção dentro de um curso. Marque como ativa para criar uma seção ou como excluída para remover uma seção existente.
- integration_id: Este é um identificador único secundário útil para integrações SIS mais complexas. Este identificador não deve mudar para a seção e deve ser globalmente único.
- start_date^: Esta é a data de início da seção. O formato deve ser ISO 8601 : AAAA-MM-DDTHH:MM:SSZ (o T pode ser substituído por um espaço).
- data_final^: Esta é a data de término da seção. O formato deve ser ISO 8601 : AAAA-MM-DDTHH:MM:SSZ (o T pode ser substituído por um espaço). Por padrão, o acesso do usuário é encerrado à meia-noite da data final indicada, o que significa que o dia anterior é o último dia completo em que os usuários têm acesso à seção. A melhor prática é definir a data final para o dia seguinte ao término da seção.
Observação: ao importar arquivos CSV de seção, os valores existentes integration_id agora são mantidos se a coluna integration_id não estiver incluída no arquivo de importação. Para remover um integration_id , ele deve ser explicitamente desativado usando o arquivo ` change_sis_id.csv .
matrículas.csv
Uma matrícula é um usuário que foi inscrito em um curso com uma função específica. Um arquivo enrollments.csv permite atribuir funções aos usuários e alocá-los nos cursos apropriados. Quando o status de matrícula de um usuário for marcado como concluído , o acesso dele ao curso será limitado a somente leitura.
Observação: Os arquivos CSV de matrícula do SIS que incluem os valores start_date e end_date substituem as datas do período letivo, do curso e da turma.
Baixe um arquivo de exemplo enrollments.csv com as seguintes matrículas:
- 1 usuário como professor no curso ACCT300 - Contabilidade de Custos
- 1 usuário como assistente de ensino no curso ACCT300 - Contabilidade de Custos
- 1 usuário como designer no curso ACCT300 - Contabilidade de Custos
- 3 usuários como alunos na seção 1 do curso ACCT300 - Contabilidade de Custos
- 3 usuários como alunos na seção 2 do curso ACCT300 - Contabilidade de Custos
- 1 usuário como observador de um aluno na seção 1 do curso ACCT300 - Contabilidade de Custos
Campo obrigatório*| Campo pegajoso^
- course_id*: (Obrigatório se o section_id estiver ausente) Este é um identificador único para o curso no qual o usuário será matriculado (adicionado em courses.csv). Se estiver matriculando alunos no curso em vez de em uma turma específica, insira o course_id neste campo. Caso contrário, deixe em branco.
- root_account : Este é o domínio da conta onde o usuário será procurado.
- start_date^: Esta é a data de início da inscrição. Para que start_date entre em vigor, end_date também precisa ser preenchido. O formato deve ser ISO 8601 : AAAA-MM-DDTHH:MM:SSZ.
- end_date^: Esta é a data de término da inscrição. Para que end_date entre em vigor, start_date também precisa ser preenchida. O formato deve ser ISO 8601 : AAAA-MM-DDTHH:MM:SSZ.
- ID do usuário*:Este é o identificador único do usuário que será matriculado nos cursos designados (adicionado em users.csv). Se o user_integration_id estiver presente, este campo será ignorado.
- user_integration_id*: (Obrigatório se o user_id estiver ausente)Este é o identificador único secundário do usuário (adicionado em users.csv como integration_id).
- papel*:Esta é a função que será atribuída a um usuário para o curso específico. Você pode matricular um usuário com qualquer uma das seguintes funções: professor, designer, monitor, aluno, observador ou uma função personalizada que você definir. Cada função possui um conjunto de permissões que os administradores podem personalizar no nível da conta principal/raiz ou de uma subconta.
- role_id*: (Obrigatório se a função estiver ausente)Este é o identificador único da função na qual o usuário será adicionado como parte de uma inscrição.
- section_id*:(Obrigatório se o course_id estiver ausente) Este é o identificador único da seção na qual o usuário será matriculado (adicionado em sections.csv). Se estiver matriculando alunos em uma seção específica de um curso, insira o section_id da seção aqui. Caso contrário, deixe este campo em branco. Se nenhum section_id for especificado, a seção padrão do curso será utilizada. Se uma seção padrão não existir, uma será criada automaticamente sem um ID SIS.
- status*: Veja como inscrever, concluir, desativar (tornar inativo) ou remover uma inscrição em um curso. Marque como ativa para inscrever um usuário em um curso, como concluída para finalizar a inscrição de um usuário em um curso, como inativa para desativar o usuário no curso e como excluída para remover um usuário de um curso. Quando estiver no estado "inativo", o aluno aparecerá na lista de alunos do curso para os instrutores, mas não poderá visualizar ou participar do curso até que a inscrição seja ativada.
- associated_user_id: (Apenas para a função de observador) Este é o identificador único do usuário cujas informações (incluindo notas) o observador poderá visualizar. O observador deve estar matriculado no mesmo curso/turma que o usuário que você deseja que ele observe. Este campo será ignorado para qualquer função que não seja a de observador.
- limit_section_privileges: Esta opção define que o usuário só poderá visualizar e interagir com outros usuários matriculados na seção especificada por course_section_id. O valor padrão deste campo é false. Limitar a interação dos alunos apenas por seção afeta Colaborações, Chat, Pessoas e Conversas. Ao matricular instrutores e monitores, as limitações de seção permitem que esses usuários avaliem os alunos de suas respectivas seções. Tópicos de discussão e Páginas não são afetados pelas limitações de seção e podem ser visualizados por qualquer aluno. Essas áreas podem ser restringidas criando conteúdo em grupos do curso.
- Notificar: Esta é a forma que você escolhe para enviar uma notificação aos usuários inscritos quando eles se matricularem em um curso.
Nota: O campo root_account é recomendado ao identificar usuários em uma conta confiável .
group_categories.csv
As categorias de grupo permitem organizar grupos no Canvas. Um arquivo group_categories.csv permite criar categorias de grupo no nível da conta ou do curso. Na interface do usuário, as categorias de grupo são chamadas de conjuntos de grupos.
Baixe um arquivo de exemplo group_categories.csv com as seguintes categorias de grupo:
- Grupos de administradores
- Grupos de Designers
- Grupos de Projetos de História
Campo obrigatório*| Campo pegajoso^
- group_category_id:Este é o identificador usado para referenciar a categoria do grupo. O identificador não deve mudar para a categoria do grupo e deve ser globalmente único.
- account_id: Este é o identificador que associa a categoria do grupo a uma conta (adicionado no arquivo accounts.csv). Se nenhuma conta ou curso for especificado, o grupo será associado à conta raiz.
- course_id: Este é o identificador que associa a categoria do grupo a um curso (adicionado em courses.csv). Se nenhum curso ou conta for especificado, o grupo será associado à conta raiz.
- nome_da_categoria*^ : Este é o nome da categoria do grupo.
- status*:Este é o status da categoria de grupo. Marque como ativa para criar a categoria de grupo ou como excluída para excluí-la.
grupos.csv
Um grupo pode ser usado para proporcionar oportunidades de colaboração para alunos, instrutores, administradores ou outros usuários. Um arquivo groups.csv permite criar grupos em nível de curso e em nível de conta . Grupos carregados via SIS só podem ser atualizados ou excluídos via SIS.
Baixe um arquivo groups.csv de exemplo com os seguintes grupos:
- Administradores
- Professores de Matemática
- Designers
Campo obrigatório*| Campo pegajoso^
- group_id*:Este é o identificador único usado para referenciar seu grupo. Ele não deve mudar para o grupo e deve ser globalmente único.
- group_category_id: Este é o identificador da categoria de grupo (adicionada em group_categories.csv) na qual você está adicionando um grupo. Se nenhuma categoria de grupo for especificada, o grupo será colocado na categoria de grupo padrão da conta ou curso definido. Se nenhuma conta ou curso for especificado, o grupo será colocado na categoria de grupo padrão da conta raiz.
- account_id: Este é o identificador que associa o grupo a uma conta (adicionado em accounts.csv). Se nenhum for especificado, o grupo será associado à conta raiz.
- course_id: Este é o identificador que associa o grupo a um curso (adicionado em courses.csv). Se nenhum curso ou conta for especificado, o grupo será associado à conta raiz.
- nome*^: Este é o nome do grupo.
- status*:Este é o status do grupo. Marque como disponível para abrir o grupo para novos membros ou como excluído para excluir o grupo.
grupos_associação.csv
A participação em um grupo permite que os usuários colaborem em atividades no Canvas. Um arquivo groups_membership.csv permite adicionar ou remover pessoas em massa de um grupo que você criou por meio do arquivo groups.csv.
Baixe um arquivo de exemplo groups_membership.csv com as seguintes associações de grupo:
- 1 usuário aceito no grupo de administradores
- 1 usuário aceito no grupo de Professores de Matemática
- 1 usuário excluído no grupo de Professores de Matemática
Campo obrigatório*
- group_id*:Este é o identificador único usado para referenciar seu grupo (adicionado em groups.csv).
- ID do usuário*:Este é o identificador único do usuário que você deseja adicionar ao grupo (adicionado em users.csv).
- status*:Este é o status dos usuários no grupo. Marque como aceito para adicionar um usuário a um grupo ou como excluído para remover um usuário de um grupo.
xlists.csv
A inclusão cruzada permite mover turmas para outro curso. Um arquivo xlist.csv permite incluir turmas em cursos existentes e criar uma hierarquia de turmas.
Espera-se que os IDs das seções já existam e façam referência a outros IDs de cursos. Se um ID de seção for fornecido neste arquivo, ele será movido do ID de curso existente para um novo ID de curso, de forma que, se esse novo curso for removido ou a listagem cruzada for desfeita, a seção retornará ao seu ID de curso anterior. Se `xlist_course_id` não fizer referência a um curso existente, ele será criado. Se você quiser fornecer mais informações sobre o curso com listagem cruzada, faça-o no arquivo `courses.csv`.
Baixe um arquivo xlists.csv de exemplo com os seguintes cursos e turmas:
- Quatro turmas ativas do curso ACCT300 - Contabilidade de Custos são oferecidas também no curso ACCT310 - Contabilidade Gerencial.
Campo obrigatório*
- xlist_course_id*:Este é o identificador do novo curso (adicionado em courses.csv).
- section_id*:Este é o identificador da seção (adicionado em sections.csv).
- status*:Este é o estado da seção. Marque como ativa para torná-la ativa ou como excluída para removê-la.
user_observers.csv
A função de observador pode ser usada para cadastrar pais e vinculá-los a um aluno, permitindo que visualizem as notas e as interações do aluno no curso. Um arquivo user_observers.csv permite cadastrar e vincular observadores a cada uma das matrículas do aluno designado.
Baixe um arquivo user_observers.csv de exemplo com as seguintes inscrições:
- 2 observadores ativos
- 1 observador excluído
Campo obrigatório*
- observer_id*:Este é o identificador único do observador (adicionado como user_id no arquivo users.csv).
- student_id*:Este é o identificador único do aluno (adicionado como user_id no arquivo users.csv).
- status*:Este é o status do observador. Marque como ativo para inscrever o observador em todas as matrículas do aluno ou como excluído para remover todas as matrículas do observador.
logins.csv
O arquivo logins.csv permite criar ou atualizar credenciais de login para usuários. Logins só podem ser adicionados a usuários existentes. Logins podem ser removidos usando o arquivo users.csv.
Baixe um arquivo logins.csv de exemplo com três logins de usuário.
Campo obrigatório*| Campo pegajoso^
- ID do usuário*:Este é o identificador único do usuário (referenciado no arquivo enrollments.csv). Este valor não deve mudar para o usuário e deve ser único para todos os usuários. É chamado de ID SIS na interface do usuário do Canvas.
- integration_id: Este é um identificador único secundário útil para integrações complexas de SIS. Este valor não deve mudar para o usuário e deve ser único para todos os usuários. Este campo deve ser deixado em branco ao mesclar usuários com IDs de integração correspondentes.
- login_id*:Este é o nome que o usuário usará para fazer login no Canvas. Para serviços de autenticação configurados, como LDAP, este será o nome de usuário do sistema remoto.
- Senha: Esta é a senha que o usuário usará para fazer login no Canvas. Este campo não deve ser preenchido para contas configuradas com LDAP ou SSO.
- ssha_password: Esta é uma senha gerada com um esquema de geração SSHA pré-hash.
- authentication_provider_id: Este é o provedor de autenticação ao qual o login está associado.
- existing_user_id^: Este é o ID SIS do usuário, conforme encontrado no arquivo users.csv.
- existing_integration_id^: Este é o ID de integração do usuário, conforme encontrado no arquivo users.csv.
- existing_canvas_user_id^: Este é o ID do usuário no Canvas.
- root_account: Esta é a conta de domínio do usuário.
- E-mail: Este é o endereço de e-mail do usuário.
Notas:
- existing_user_id, existing_integration_id ou existing_canvas_user_id*: (necessário para uma importação bem-sucedida de logins.csv)
- root_account*: (obrigatório ao identificar usuários em umconta confiável(por exemplo, ao listar usuários em várias contas dentro de uma conta confiável).
- status*: (obrigatório ao realizar uma importação SIS usando logins.csv)
admins.csv
Os administradores gerenciam as configurações de uma conta inteira ou de uma subconta. Um arquivo admins.csv permite designar usuários no Canvas como administradores da conta ou para outras funções personalizadas da conta ou da subconta.
Baixe um arquivo admins.csv de exemplo com os seguintes administradores:
- 2 administradores de conta ativos
- 1 administrador de conta excluído
- 2 funções de conta personalizadas ativas
Campo obrigatório*
- ID do usuário*: Este é o ID exclusivo do usuário que você deseja designar como administrador (adicionado em users.csv).
- account_id*: Este é o identificador único da conta na qual você deseja que o administrador resida (adicionado em accounts.csv). Se esta coluna for deixada em branco, o usuário residirá na conta raiz. Esta coluna é sempre obrigatória, mesmo que o valor esteja em branco.
- role_id*: (obrigatório se a função estiver ausente)Este é o ID da função, seja o ID padrão ou um ID personalizado definido pela conta.
- função*: (obrigatório se role_id estiver ausente)Este é o nome da função, seja a função padrão de Administrador da Conta ou uma função personalizada definida pela conta. Se você estiver adicionando um administrador da conta, formate o campo para exibir 'AccountAdmin'. Se estiver adicionando uma função personalizada, formate o campo exatamente como aparece na interface do usuário do Canvas.
- status*: Este é o status do administrador. Marque como ativo para criar um administrador ativo ou como excluído para remover um administrador.
- root_account: Este é o domínio da conta onde o usuário será procurado.
change_sis_id.csv
Um ID SIS é um identificador único para um objeto no Canvas. O arquivo change_sis_id.csv permite alterar em massa os IDs SIS de contas, períodos, cursos, turmas, grupos ou usuários existentes.
Baixe um arquivo de exemplo change_sis_id.csv com as seguintes alterações de ID SIS:
- 1 alteração de ID SIS do usuário
- 1 alteração de ID SIS do curso
- Alteração de ID SIS por 1 período
Campo obrigatório*
- id_antigo*: Este é o ID SIS atual do objeto.
- novo_id*: Este é o ID SIS desejado para o objeto. O novo ID SIS deve ser atualmente exclusivo para o tipo de objeto e para a conta raiz.
- tipo*: Este é o tipo de objeto. O tipo pode ser conta, período letivo, curso, turma, grupo ou usuário.