Primeiro, note que geralmente não é necessário importar usuários em massa - para continuar o processo de manutenção você deveria tentar explorar formas de autenticação que não requerem trabalho manual, como conectar a bancos de dados externos ou permitir que os usuários criem suas próprias contas. Veja a seção Autenticação, na aba de Usuários do menu de administração.
Se você quiser importar contas múltiplas de um arquivo de texto, então você precisa obedecer o seguinte formato:
Campos Obrigatórios: esses campos precisam ser incluídos na primeira linha, e definidos para cada usuário
firstname, lastname
quando for inserir ouusername
quando for atualizarNomes de campos opcionai: todos esses são completamente opcionais. Se um valor estiver presente para o campo no arquivo, ele será utilizado; senão, o valor tido como padrão tomará o seu lugar.
institution, department, city, country, lang, auth, ajax, timezone, idnumber, icq, phone1, phone2, address, url, description, mailformat, maildisplay, htmleditor, autosubscribe, emailstop
Nomes de campos customizados para perfis: opcional, com xxxxx como o nome real do usuário a ser atualizado (o nome breve, que é único)
profile_field_xxxxx
Nomes de campos especiais: usados para alterar nomes de usuário e apagar contas, veja abaixo
deleted, oldusername
Nomes de campos para inscrição (opcional): Os nomes dos cursos são os nomes breves dos mesmos - se presentes, o usuário será inscrito neles. "Type" define o tipo de função associada à inscrição. O valor 1 é o papel de aluno normal, 2 é o de professor que edita e 3 é o de professor que não pode editar. Você pode usar o campo de funções, em vez de especificá-las diretamente - use o nome breve da função ou o id (os nomes numéricos não são suportados). Usuários também podem ser atríbuidos a grupos nos cursos(group1 no course1, group2 no course2, etc.). Grupos, como os outros, são identificados pelos nomes ou ids (nomes númericos não funcionam).
course1, type1, role1, group1, course2, type2, role2, group2, etc.
Eis um exemplo de arquivo de importação válido:
username, password, firstname, lastname, email, lang, idnumber, maildisplay, course1, group1, type1
jonest, verysecret, Tom, Jones, jonest@someplace.edu, en, 3663737, 1, Intro101, Section 1, 1
reznort, somesecret, Trent, Reznor, reznort@someplace.edu, en_us, 6736733, 0, Advanced202, Section 3, 3
Os valores padrão são processados como modelos, nos quais são permitidos os seguintes códigos:
%l
- será substituído por lastname%f
- será substituído por firstname%u
- será substituído por username%%
- será substituído por %Entre o sinal de porcentagem (%) e qualquer letra de código (l, f or u) são permitidos os seguintes modificadores:
Por exemplo, se o primeiro nome for John e o último nome for Doe, os valores podem ser obtidos a partir dos seguintes modelos:
O processamento de modelos é feito apenas para valores padrão, mas não em valores vindos de um arquivo CSV.
Para criar nomes de usuário corretos no Moodle, o nome é sempre convertido para minúsculas. Além disso, se a opção "Permitir caracteres extendidos nos nomes de usuário" na seção Políticas do Site estiver desligada, caracteres diferentes de letras, dígitos, hífen (-) e ponto (.) são removidos. Por exemplo se o primeiro nome é John Jr. e o último nome é Doe, o username %-f_%-l irá produzir john jr._doe quando "Permitir caracteres extendidos nos nomes de usuário" estiver ligada, e johnjr.doe quando desligada.
Quando a opção "Novo tratamento de nomes duplicados" estiver marcada como "Anexar contador", um contador com incremento automático será aplicado a usuários duplicados produzidos pelo modelo. Por exemplo, se um arquivo CSV contém usuários chamados John Doe, Jane Doe e Jenny Doe sem nomes de usuário explícitos, o padrão %-1f%-l, e a opção "Novo tratamento de nomes duplicados" estiver habilitada, os nomes produzidos serão jdoe, jdoe2 and jdoe3.
Por padrão o Moodle assume que você criará novas contas de usuário, e salta registros que correspondem a contas já existentes. Entretanto, se você marcar "Atualizar contas existentes" como Sim, a conta será atualizada.
Ao atualizar contas existente você pode também mudar os nomes de usuário. Marque "Permitir renomeação" como Sim e inclua em seu arquivo um campo chamado oldusername
.
Aviso: qualquer erro nas atualizações de contas existentes pode produzir efeitos muito ruins nas contas dos usuários. Tenha cuidado ao utilizar essas opções.
Se o código deleted
estiver presente nas colunas, usuários com o valor 1 serão apagados. Nesse caso, todos os campos podem ser omitidos, exceto username
.
O apagamento e o envio de contas podem ser feitos com um arquivo CSV único. Por exemplo, o arquivo a seguir criaria um usuário Tom Jones e apagaria o usuário reznort:
username, firstname, lastname, deleted
jonest, Tom, Jones, 0
reznort, , , 1