Primeiro que tudo, repare que normalmente não é preciso importar listas de utilizadores. Para reduzir o seu trabalho de actualização, deveria explorar primeiro formas de autenticação que não exijam manutenção manual, tais como ligação a bases de dados externas, ou permitir que os utilizadores criem as suas próprias contas. Consulte a secção de autenticação nos menus de administração.
Se tiver a certeza que precisa importar uma lista de contas de utilizadores a partir dum ficheiro de texto, então terá que organizar o ficheiro na forma seguinte:
Campos necessários: os campos seguintes deverão ser incluidos no primeiro registo, e definidos para cada utilizador.
firstname, lastname
quando estiver a inserir, ouusername
quando estiver a actualizar.Campos opcionais: todos estes são completamente opcionais. Se existir um valor para esses campos no ficheiro, será usado; senão, serão usados os valores por omissão para esses campos.
institution, department, city, country, lang, auth, ajax, timezone, idnumber, icq, phone1, phone2, address, url, description, mailformat, maildisplay, htmleditor, autosubscribe, emailstop
Campos adicionados ao perfil dos utilizadores: opcionais; xxxxx será o nome real dado ao novo campo no perfil (um nome curto único)
profile_field_xxxxx
Nomes de campos especiais: usados para modificar nomes de utilizadores e eliminar utilizadores; veja abaixo.
deleted, oldusername
Nomes de campos de inscrição (opcionais): Os nomes das disciplinas serão os nomes curtos; se estiverem presentes, o utilizador será inscrito nessas disciplinas. "Type" significa o tipo de cargo que será dado ao utilizador na disciplina associada. 1 indica o cargo por omissão na disciplina, 2 é professor delegado e 3 professor não editor delegado. Alternativamente poderá usar campos role para especificar directamente os cargos. Use ou o nome curto do cargo ou o seu número de identificação (os nomes numéricos dos cargos não podem ser usados). Os utilizadores podem também ser incluidos num grupo numa disciplina (group1 na disciplina course1, group2 na disciplina course2, etc.). Os grupos também deverão ser identificados ou pelo nome curto do ou pelo número de identificação (os nomes numéricos dos grupos não podem ser usados).
course1, type1, role1, group1, course2, type2, role2, group2, etc.
A seguir vem um exemplo de um ficheiro válido:
username, password, firstname, lastname, email, lang, idnumber, maildisplay, course1, group1, type1
jramos, segredo, João, Ramos, jramos@algures.na.net, pt_utf8, 3663737, 1, Intro101, Turma 1, 1
fmagal, sabrosa, Fernão, de Magalhães, fernao@gmail.com, pt_utf8, 6736733, 0, Navegação202, Barco 3, 3
Os valores por omissão são processados como predefinições nas quais são permitidos os códigos seguintes:
%l
- será substituido pelo apelido%f
- será substituido pelo nome%u
- será substituido pelo nome de utilizador%%
- será substituido por %Entre o sinal de percentagem (%) e qualquer letra de código (l, f ou u) são permitidos os seguintes modificadores:
Por exemplo, se o nome for Maria e o apelido Sousa, os seguintes valores seriam obtidos com as predefinições apresentadas:
As predefinições são processadas apenas para os valores por omissão e não para os valores obtidos do ficheiro CSV.
Para construir nomes de utilizadores correctos no Moodle, o nome de utilizador deverá ser sempre convertido para minúsculas. Ainda, se a opção de "Permitir conjunto alargado de caracteres no nome de utilizador" estiver desactivada no sítio, os caracteres diferentes de letras, números, hífen e ponto serão eliminados. Por exemplo, se o nome for Mário Jr. e o apelido for Silva, o nome de utilizador %-f_%-l produzirá mário jr._silva, quando o conjunto alargado de caracteres for permitido, e mriojr.silva quando não for permitido.
Quando o "tratamento de nomes de utilizadores repetidos" estiver definido como acrescentar contador, um contador auto-incrementado será acrescentado no fim dos nomes de utilizadores repetidos produzidos pela predefinição. Por exemplo, se o ficheiro CSV contém os utilizadores João Silva, José Silva e Joana Silva, sem nomes de utilizador explícitos, o nome de utilizador por omissão for %-1f%-l e o tratamento de nomes de utilizador repetidos estiver definido como acrescentar contador, os nomes de utilizador produzidos seriam jsilva, jsilva2 e jsilva3.
Por omissão, o Moodle admite que vão ser criadas novas contas de utilizador, e ignora os registos dos utilizadores que já existem. No entanto, se permitir a actualização, as contas de utilizadores já existentes serão actualizadas.
Quando se actualizam contas já existentes, pode também alterar o
nome de utilizador. Defina "Permitir renomeações" como
Sim e inclua no seu ficheiro um campo designado
de oldusername
.
Atenção: qualquer erro na actualização de contas de utilizadores poderá ter efeitos nocivos nos seus utilizadores. Use cautela no uso das opções para actualizar.
Se o campo deleted
estiver presente, os utilizadores com um
valor 1 nesse campo serão eliminados da base de dados. Nesse caso, todos os
outros campos podem ser omitidos, excepto username
.
Eliminação e criação de contas podem ser feitas com um único ficheiro CSV. Por exemplo, o ficheiro seguinte adicionará o utilizador Pedro Pinto e eliminará o utilizador roberto:
username, firstname, lastname, deleted
pedro, Pinto, Pedro, 0
roberto, , , 1