Upload de usuarios

From MoodleDocs
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)

Enviando usuários via arquivo de texto

Existem muitas opções para enviar informações (campos associados a um usuário) com este método: desde a inscrição de usuários em vários cursos com papéis específicos do curso até a atualização das informações do usuário no Perfil do usuário e para a exclusão de usuários do site.

Dica: Normalmente não é necessário fazer upload de usuários em massa com o "Upload de usuários". Para manter o trabalho de manutenção baixo, você deve primeiro explorar as formas de autenticação que não requerem manutenção manual, como conectar-se a bancos de dados externos existentes ou permitir que os usuários criem suas próprias contas (Autoinscrição) . Veja Autenticação para mais informações.

https://youtu.be/s_CMgdbnxP8

Formatos de arquivo para upload de arquivo de usuários

O arquivo de upload de usuários possui campos separados por uma vírgula (ou outro delimitador) SOMENTE - sem espaço. A primeira linha contém os nomes de campo válidos. O resto das linhas (registros) contém informações sobre cada usuário.

Dica: Evite caracteres especiais nas informações do campo, como aspas ou outras vírgulas. Teste um arquivo com apenas um registro antes de um grande upload.

Dica: Você pode usar um programa de planilha para criar o arquivo com as colunas e campos necessários. Em seguida, salve o arquivo como "CSV (delimitado por vírgulas)". Esses arquivos podem ser abertos com editores de texto simples (por exemplo, https://notepad-plus-plus.org) para verificação.

Arquivo de upload válido para teste

  • Em Administração do site / Usuários / Carregar usuários, um exemplo de arquivo de texto (.csv) está disponível para download e pode ser adaptado às suas necessidades.

username,firstname,lastname,email

student1,Student,One,s1@example.com

student2,Student,Two,s2@example.com

student3,Student,Three,s3@example.com

  • Campos adicionais podem ser adicionados conforme abaixo. O curso e a coorte já devem ter sido criados manualmente.

username,firstname,lastname,email,course1,group1,cohort1

student1,Student,One,s1@example.com,math102,groupA,cohortZ

student2,Student,Two,s2@example.com,math102,groupB,cohort Y

student3,Student,Three,s3@example.com,math102,groupA,cohortZ

Campos do usuário que podem ser incluídos

Dica: Recomendamos fortemente que você teste um arquivo que contenha campos que você propôs usar com um usuário antes de tentar um upload de arquivo pela primeira vez.

Campos obrigatórios

Estes são os campos obrigatórios de identificação do usuário: username,firstname,lastname,email As verificações de validade são realizadas para:

  • username só pode conter letras alfabéticas minúsculas, números, hífen '-', sublinhado '_', ponto final '.' ou arroba '@'
  • e-mail deve estar no formato: nome@exemplo.com

Senhas

O campo "password" é opcional se a configuração 'Nova senha de usuário' na tela de upload estiver definida como "Criar senha se necessário e enviar por e-mail", mas é obrigatório se a configuração for "Campo obrigatório no arquivo".

Se incluídos, os valores devem atender aos requisitos da Política de senha do site.

Para forçar a mudança de senha para um usuário específico, defina o campo de senha como changeme. Se omitido, uma senha será gerada para cada usuário (durante a próxima execução do Cron) e e-mails de boas-vindas enviados. O texto do e-mail de boas-vindas está nas configurações de idioma em Administração do site> Idioma> Personalização de idioma com um identificador String de 'newusernewpasswordtext'.

Campos de usuário opcionais

Nota: As vírgulas dentro de um campo devem ser codificadas como &#44 - o script irá decodificá-las de volta para vírgulas.

Dica: Para campos booleanos com apenas dois valores, use 0 para falso e 1 para verdadeiro.

Para fornecer valores diferentes do padrão, você pode incluir um ou mais destes campos de usuário opcionais:

institution,department,city,country,lang,auth,timezone,idnumber,icq,phone1,phone2,address,url,description,mailformat,maildisplay,maildigest,htmleditor,autosubscribe,interests,theme

A maioria deles são campos de perfil do usuário ou campos de preferência do usuário que pertencem ao perfil do usuário e são preenchidos pelo usuário ou na criação manual. No entanto, alguns requerem formatos específicos:

Veja Campos de nomes adicionais para mais detalhes. Os principais pontos a serem observados são:

country - use o CÓDIGO DE DUAS LETRAS do país, em maiúsculas, por exemplo, AU, ES, GB, US. Estes são todos MAIÚSCULOS. Usar "au" ou "es" ou "USA" como um código de país resultará em um erro de banco de dados. Se você tiver problemas para descobrir o código de duas letras de um país, pode consultar a lista de nomes de países e elementos de código disponível no site da ISO. Um erro comum é usar o UK para o Reino Unido; deve ser GB.

lang - usar o código de duas letras (ou quatro letras estendidas) conforme definido nos pacotes de idiomas do Moodle, por exemplo, en, es, en_us, de, em Administração do site>Idioma>Pacotes de idiomas.

auth - O campo auth deve ser usado se o site usar um método de autenticação alternativo, como LDAP, caso contrário, o método de autenticação padrão será manual e os usuários que usam um método de autenticação diferente não conseguirão fazer login. Use os códigos de abreviação definidos em Plugins>Autenticação para os vários tipos, por exemplo, manual, nlogin, ldap, cas, mnet, db, nenhum. Se você não incluir uma coluna de autenticação, os usuários recém-criados serão criados com o tipo de conta manual.

Você pode definir "auth" como "nologin" em seu arquivo csv, o que significa que os usuários criados não podem fazer o login.

timezone - Deve estar no formato encontrado nas configurações de Localização em termos de Zona/Região, por exemplo. Austrália/Sydney, Ásia/Katmandu, Europa/Madrid, etc. A entrada diferencia maiúsculas de minúsculas, portanto, Europa/Londres funcionará, mas europa/londres não.

NOTA: Necessário: configurações para mailformat, maildisplay, htmleditor, autosubscribe

maildigest Para evitar que os usuários recebam um grande número de e-mails de cursos ou fóruns de inscrição forçada, use o maildigest. As opções para este campo são 0 = Sem resumo, 1 = Resumo completo e 2 = Resumo apenas com assuntos.

maildisplay permite que você defina a opção de exibição de e-mail para um usuário. As opções para este campo são 0 = Ocultar meu endereço de e-mail de usuários não privilegiados, 1 = Permitir que todos vejam meu endereço de e-mail e 2 = Permitir que apenas outros membros do curso vejam meu endereço de e-mail.

theme Os temas do usuário podem ser adicionados usando 'clássico', 'impulso' ou o nome de qualquer outro tema instalado. O valor deve ser o nome abreviado do tema, por exemplo, 'boost' e não 'Boost', 'fordson' e não 'Fordson'.

Nomes de campo de perfil personalizado

Eles são opcionais e dependem de você ter criado algum campo de perfil personalizado em seu site. O nome do cabeçalho no arquivo tem o formato 'profile_field_xxxxx', em que xxxx é o nome breve (shortname) exclusivo do nome do campo de perfil de usuário personalizado conforme você o criou.

O nome do campo deve corresponder ao caso do nome breve do campo de perfil. Então, por exemplo, se o nome breve do seu campo de perfil personalizado estiver todo em letras maiúsculas, por exemplo, DOB , use um cabeçalho de profile_field_DOB para corresponder ao caso, não profile_field_dob , que irá produz um erro "não é um nome de campo válido". Da mesma forma, um nome breve misto como Dob deve ter um cabeçalho de profile_field_Dob . (A exceção a isso é se o nome breve estiver todo em minúsculas, então qualquer caso funcionará no cabeçalho do campo, o que é uma peculiaridade histórica: mas a prática recomendada é combinar o caso e você evitará erros.)

profile_field_xxxxx

Exemplo: Para criar um campo personalizado "CPF", você deve escrever um nome breve "cpf" no novo campo e escrever "profile_field_cpf" no cabeçalho do arquivo .csv.

Para campos de perfil personalizados que são datas, use o formato padrão ISO AAAA-MM-DD, por exemplo: 2014-06-19, que será então devidamente localizado na interface. Por exemplo, um campo denominado dohire para data de contratação, os campos podem ser:

username,firstname,lastname,email,profile_field_dohire
blumbergh,Bill,Lumbergh,blumbergh@example.com,1990-02-19
pgibbons,Peter,BGibbons,pgibbons@example.com,1996-06-05
tsmykowski,Tom,Smykowski,tsmykowski@example.com,1970-01-01 

Para campos de perfil personalizados que são um menu, use o valor correspondente na lista de menu do campo conforme você o definiu. Por exemplo: um campo personalizado 'corporatedivision' com um dos três valores 'Management', 'Development' ou 'Training'. Basta inserir uma dessas três palavras (por exemplo, 'Training') como o valor desse campo. Por exemplo:

username,firstname,lastname,email,profile_field_corporatedivision
blumbergh,Bill,Lumbergh,blumbergh@example.com,Management
pgibbons,Peter,BGibbons,pgibbons@example.com,Development
tsmykowski,Tom,Smykowski,tsmykowski@example.com,Training 

Campos especiais de alteração do usuário

Três campos especiais são usados para gerenciar contas de usuário: oldusername, deleted e suspended. Veja abaixo para detalhes.

Campos de inscrição

Você pode opcionalmente inscrever usuários em cursos já existentes usando inscrição manual. Apenas a inscrição manual é feita desta forma; se o método de inscrição manual for desativado em um curso, nenhuma inscrição será feita.

Você usa campos no arquivo de upload deste tipo:

course1,type1,role1,group1,enroltimestart1,enrolperiod1,enrolstatus1,course2,type2,role2,group2,enroltimestart2,enrolperiod2,enrolstatus2

etc.

Os campos de cabeçalho devem ter um sufixo numérico tal que type1,role1,group1,enrolperiod1 and enrolstatus1 todos se aplicam ao curso1 para o curso 1 para o curso n. Mesmo se você estiver fazendo apenas uma inscrição em um curso, você ainda deve usar o número 1 no nome do título, ou seja, course1, role1, etc. Não use os títulos simples sem números, por exemplo: course, role, etc, pois isso irá gerar um erro.

course# é o nome breve do curso, se presente o usuário será inscrito naquele curso. Não use o nome completo do curso ou irá gerar um erro. Este campo é o ÚNICO campo obrigatório para uma inscrição bem-sucedida. Todos os outros são opcionais.

type# define o papel a ser usado para a inscrição. Um valor de 1 é o papel de curso padrão, 2 é o papel de Professor e 3 é o papel de Professor não editor.

role# pode ser usado para especificar papéis diretamente, usando o nome breve do papel ou o id do papel (nomes numéricos de papéis não são suportados). Normalmente, você usará o nome ddo papel, que é o nome breve do papel, conforme definido em Usuários>Permissões>Definir papéis, por exemplo: aluno, professor. Se a coluna de papel for deixada de fora, os usuários serão inscritos no curso com a função padrão, que normalmente é estudante.

group# pode ser usado para atribuir usuários a grupos em curso, usando nome ou id (nomes de grupos numéricos não são suportados). NOTA: se o grupo ainda não existir, ele será criado.

enroltimestart# pode ser usado para definir a hora de início da inscrição, para cada curso. Se não for definido explicitamente aqui, o horário de início da inscrição será a atual. Para definir uma data: "2021-02-15" e para definir uma data e hora "2021-02-15 15:30"

enrolperiod# pode ser usado para definir a duração da inscrição, em dias, para cada curso. Se não for definido explicitamente aqui, todos os usuários obterão a duração definida no método de inscrição manual do curso (que o padrão é 0, significando ilimitado).

enrolstatus# é opcional, pois por padrão todos os usuários recém-inscritos são definidos como ativos. Se o valor 1 for usado, ele suspenderá os usuários no curso e se um usuário for previamente definido como inativo/suspenso, o valor 0 irá retirá-lo da suspensão e torná-lo ativo novamente.

Atribuição de membros em coorte

Você pode atribuir usuários a qualquer coorte já existente usando apenas o "nome de usuário" e o "ID da coorte" com apenas dois campos no arquivo. Observe que esta é uma exceção ao caso usual em que o nome, o sobrenome e o endereço de e-mail do usuário são obrigatórios.

cohort# é a forma a ser usada e como na inscrição em cursos, você deve adicionar um número a cada cabeçalho, então coorte 1, coorte 2, etc.

Devem ser usados os IDs de coortes existentes; não use o nome completo, eles não são permitidos. (Observe que o ID do coorte é geralmente conhecido em outros lugares como "nome breve".)

Aqui está um exemplo de arquivo CSV:

username,cohort1,cohort2
student1,nursing,2016class
student2,nursing,2014class
student3,nursing,2014class

MNet

Os usuários MNet existentes podem ser adicionados a cursos, grupos ou coortes conforme abaixo usando o cabeçalho do campo mnethostid

  1. inscrevendo em curso: username+mnethostid+course obrigatório
  2. adicionando ao grupo: username+mnethostid+course+group obrigatório
  3. adicionando ao coorte: username+mnethostid+cohort obrigatório
  4. suspender/reativar conta: username+mnethostid+suspended obrigatório

Todas as outras operações são ignoradas. Você não pode adicionar usuários, excluí-los ou atualizá-los (como alterar nomes ou e-mail, campos de perfil, etc.)

Definir papéis do sistema

Os usuários também podem ser atribuídos a papéis de sistema já definidos, usando o nome breve do papel de sistema conforme definido em Administração do site>Usuários>Permissões>Definir papéis para papéis com um contexto de sistema definido.

sysrole1,sysrole2,sysrole3 etc

No arquivo de upload de usuários você pode atribuir um papel de sistema (geralmente Gerente ou Criador de curso) inserindo o nome breve do papel. Outros papéis só podem ser carregados se já tiverem sido atribuídos no contexto do sistema. Veja em Criando papéis personalizados. Múltiplos papéis podem ser atribuídos usando os campos sysrole2, sysrole3, etc. Observe que o sufixo de número de forma alguma está relacionado aos sufixos de número nos campos de inscrição. Os números devem subir em sequência começando em 1.

Cancelamento de atribuição de papéis do sistema Os usuários também podem ser removidos de um determinado papel do sistema inserindo o nome breve do papel prefixado com um símbolo de menos: '-'. Se o usuário estiver atualmente atribuído a esse papel, ele será removido dele. Se o usuário não estiver atualmente atribuído, o valor do campo será ignorado. No entanto, o valor do campo deve se referir a um fpapel do sistema que existe no sistema, caso contrário, ocorrerá um erro.

Exemplo de um arquivo de upload de usuários com papéis globais/do sistema

Processo de Upload de usuários

  1. Crie o arquivo de upload
  2. Vá para Administração do site>Usuários>Contas>Carregar lista de usuários
  3. Adicionar arquivo para upload
  4. Clicar no botão "Carregar lista de usuários" - verifique as configurações e valores padrões de perfil do usuário
  5. Fazer upload de visualização de usuários - clique em "Carregar lista de usuários"
  6. Upload de resultados de usuários - mostra a lista de usuários, as exceções feitas no upload e um resumo do número de usuários
  7. Faça upload dos resultados dos usuários - clique em "Continuar"
  8. Retorna para a tela de upload de usuários

Visualização de atualização de usuários

Existem várias configurações para controlar melhor o comportamento de upload desejado. Essas configurações são encontradas na página "Visualização de upload de usuários".

Aviso: erros ao atualizar contas existentes podem afetar gravemente seus usuários. Tenha cuidado ao usar as opções de atualização.

Tipo de upload

O tipo de upload especifica como lidar com contas existentes.

Adicionar apenas novos, pular usuários existentes
é o tipo de upload padrão do Moodle. Ele cria uma nova conta de usuário para cada novo registro no arquivo carregado. Se um nome de usuário (username) existente for encontrado no arquivo enviado corresponder a um nome de usuário existente, esse registro é ignorado. Ao ignorar a conta de usuário existente, os dados no registro existente não são tocados (em contraste com a opção "Adicionar novos e atualizar usuários existentes") e uma segunda nova conta de usuário não é criada (em contraste com a opção "Adicionar tudo, acrescentar número aos nomes de usuário, se necessário").
Adicionar tudo, acrescentar número aos nomes de usuário, se necessário
cria uma nova conta de usuário para cada registro no arquivo carregado. Se uma conta de usuário existente for encontrada, uma nova conta será criada com um número anexado ao nome de usuário (username). Por exemplo, se uma conta de usuário para o nome de usuário 'jsmith' já existe e um novo registro no arquivo carregado contém um registro para o nome de usuário 'jsmith', uma conta de usuário adicional é criada com um 1 anexado ao nome de usuário para produzir usuário 'jsmith1'.
Adicionar novos e atualizar usuários existentes
cria uma nova conta de usuário para cada novo usuário no arquivo de upload. Se uma conta de usuário existente com o mesmo nome de usuário (username) for encontrada, as informações da conta são atualizadas pelos dados no arquivo carregado.
Atualizar apenas usuários existentes
ignora quaisquer novos usuários encontrados no arquivo de upload e atualiza a conta do usuário se um registro de nome de usuário (username) correspondente for encontrado no arquivo de upload.

Nova senha de usuário

Ao criar uma nova conta de usuário, o Moodle pode criar uma nova senha (se não houver uma) ou solicitar uma senha no arquivo enviado.

Criar senha, se necessário, e enviar por e-mail
cria uma senha padrão aleatória para cada nova conta de usuário, caso não seja fornecida no arquivo carregado, e envia por e-mail ao usuário suas informações de usuário e a nova senha.
Campo obrigatório no arquivo
requer que uma senha seja fornecida no arquivo carregado em ordem. Se uma senha não for fornecida, um erro será gerado e a conta do usuário não será criada. Nenhuma notificação dessas informações de usuário ou senha é enviada ao usuário.

Detalhes de usuário existentes

As opções de detalhes do usuário existente estão disponíveis apenas quando o tipo de upload permite que contas de usuário existentes sejam atualizadas. Ele especifica como o Moodle deve processar informações de detalhes do usuário para usuários existentes.

Sem alterações
ignora os dados de detalhes do usuário no upload e deixa os dados existentes da conta do usuário inalterados.
Substituir com arquivo
substitui os dados na conta do usuário existente com os dados fornecidos no arquivo carregado.
Substituir com arquivo e padrões
substitui os dados na conta do usuário existente com os dados fornecidos no arquivo carregado e preenche os valores padrão para os detalhes do usuário existente quando nenhum dado é fornecido no arquivo carregado.
Preencher o que falta no arquivo e padrões
adiciona dados na conta do usuário existente com os dados fornecidos no arquivo carregado se o campo estiver vazio (ainda não contém dados) e preenche os valores padrão para os detalhes do usuário existente quando nenhum dado é fornecido no arquivo carregado.

Senha de usuário existente

A opção Senha de usuário existente aparece quando você define a configuração "Detalhes de usuário existentes" como "Substituir por arquivo". Ele especifica como lidar com dados de senha para contas de usuário existentes, para alterá-los ou deixá-los como estão. Isso é um pouco de segurança para garantir que você realmente deseja alterar as senhas dos usuários em massa.

Sem alterações
ignora o campo de senha no arquivo de usuário carregado e deixa a senha da conta de usuário existente intacta
Atualizar
sobrescreve a senha da conta do usuário existente com a senha fornecida no arquivo carregado

Forçar alteração de senha

A opção Forçar mudança de senha especifica quando marcar uma conta de usuário para que a próxima tentativa de login exija que o usuário altere a senha do usuário.

Usuários com senha fraca
Se a conta do usuário tiver uma senha fraca, conforme definido pela Política de senha do site, o usuário será forçado a alterar a senha durante a próxima tentativa de login. Esta opção não é mostrada se o site não tiver uma Política de senha.
Nenhum
Nenhum dos usuários no arquivo carregado será forçado a alterar a senha durante a próxima tentativa de login do usuário.
Todos
Todos os usuários no arquivo carregado serão forçados a alterar a senha durante a próxima tentativa de login do usuário.

Permitir renomeações

Se o arquivo enviado contiver o campo especial oldusername, é possível renomear um usuário de oldusername para um novo username. A configuração padrão é não permitir renomeações. Lembre-se de que renomear um usuário exigirá que o usuário use o novo nome de usuário (username) ao fazer login.

Não
ignora o campo oldusername e deixa o campo de nome de usuário (username) da conta de usuário existente inalterado.
Sim
permite que o nome de usuário (username) da conta de usuário existente seja alterado pelos dados fornecidos no campo de nome de usuário do arquivo enviado. O oldusername será pesquisado e então atualizado com os dados fornecidos na coluna nome de usuário (username).

Permitir exclusões (deletar)

Se o arquivo carregado contiver o campo especial deleted, é possível usar o arquivo carregado para excluir contas de usuário existentes. A configuração padrão é não permitir exclusões. Lembre-se de que a exclusão de uma conta de usuário impedirá que o usuário efetue login. Como proteção, as contas de usuário administrador do site não podem ser excluídas com este método.

Não
ignora o campo especial deleted no arquivo enviado e deixa a conta de usuário existente inalterada
Sim
permite que a conta de usuário existente seja excluída quando o valor do campo deleted for 1.

Permitir suspensão e ativação de contas

Se o arquivo carregado contiver o campo especial suspended, é possível usar o arquivo carregado para suspender ou tornar ativas (cancelar a suspensão) contas de usuário existentes. A configuração padrão é permitir a suspensão/ativação de contas de usuário existentes. Lembre-se de que suspender uma conta de usuário existente impedirá que o usuário faça login.

Sim
permite que a conta de usuário existente seja suspensa quando o valor do campo suspended for 1.
Não
ignora o campo especial suspended no arquivo enviado e deixa o status da conta do usuário existente inalterado.

Prevenir endereço de e-mail duplicado

É possível, mas não recomendado para enviar usuários com endereços de e-mail duplicados. Por padrão, o envio de usuários com endereços de e-mail duplicados é impedido. Para permitir endereços de e-mail duplicados, vá para Administração do site►Plugins► Autenticação►Gerenciar autenticação. Você pode marcar "Permitir contas com o mesmo e-mail". Em seguida, na tela de upload de usuários, você poderá alterar a configuração "Evitar duplicatas de endereço de e-mail".

No entanto, fazer isso não é recomendado para uploads de arquivos. Teste completamente todos os uploads do usuário antes de implementar.

Para obter mais informações, consulte a página de documentos Gerenciando autenticação

Sim
evita que contas de usuário sejam criadas a partir do upload se uma conta de usuário existente já tiver o mesmo endereço de e-mail encontrado na coluna email do arquivo enviado.
Não
permite que contas de usuário sejam criadas se uma conta de usuário existente já tiver o mesmo endereço de e-mail encontrado na coluna email do arquivo enviado.

Padronizar nomes de usuário

Padronizar nomes de usuário é usado por padrão para converter o nome de usuário em letras minúsculas e remover caracteres ilegais. É possível não padronizar os nomes de usuário; entretanto, fazer isso não é recomendado.

Sim
padroniza os nomes de usuário encontrados no arquivo carregado antes de atualizar as contas existentes ou criar novas contas de usuário, de forma que o nome de usuário contenha apenas letras minúsculas e números.
Não
ignora a padronização de nomes de usuário encontrados no arquivo enviado para que os nomes de usuário recém-criados ou atualizados sejam exatamente como estão no arquivo enviado (não recomendado).

Para aqueles que buscam uma explicação mais técnica, o processo de padronização dos nomes de usuário consiste em garantir que os caracteres sejam todos codificados em UTF-8 (fix_utf8), convertendo o nome de usuário para letras minúsculas e, em seguida, removendo os caracteres não-letras/não-numéricos (a menos que Administração do site>Segurança>Políticas do site>Permitir caracteres estendidos em nomes de usuário está ativado) com algo semelhante a:

$username = preg_replace('/[^-\.@_a-z0-9]/', , $username);

Selecione para ações em lote sobre usuários

Depois que o arquivo carregado terminar de ser processado (todas as novas contas foram criadas e as contas existentes atualizadas conforme especificado nas configurações anteriores), há uma opção para selecionar algumas dessas contas de usuário para executar ações em lote sobre usuário como

  • Confirme as contas de usuário criadas por meio de autorregistro baseado em email que ainda não foram confirmadas pelo usuário
  • Envie uma mensagem (requer que o Messaging esteja ativado)
  • Excluir contas de usuário
  • Exibir uma lista de usuários em uma página
  • Baixe os dados do usuário em texto, ODS ou formato de arquivo Excel
  • Forçar os usuários a alterar suas senhas
  • Adicionar usuários a um coorte

Por padrão, nenhum usuário é selecionado para ações em lote sobre usuários.

Não
Nenhum usuário foi selecionado para ações em lote sobre usuários
Novos usuários
somente usuários recém-criados são selecionados para ações em lote sobre usuários
Usuários atualizados
apenas contas de usuário atualizadas são selecionadas para ações em lote sobre usuários
Todos os usuários
Todos os usuários encontrados (usuários atualizados existentes e contas de usuário recém-criadas) no arquivo carregado são selecionados para ações em lote sobre usuários

Valores padrão

Você pode fornecer valores de usuário padrão para alguns campos não incluídos no arquivo carregado. Alguns campos incluem:

  • Email display
  • Forum auto-subscribe
  • City/town
  • ID number
  • Institution
  • Department

Ao clicar no link Mostrar mais ...., outros campos de perfil de usuário padrão serão exibidos. Você pode definir 17 campos diferentes aqui, incluindo o Método de autenticação (Authentication method), País (Country), Idioma (Language), fuso horário (Timezone), bem como a maioria dos outros campos de perfil de usuário padrão.

Outros campos

Se você criou algum campo de perfil personalizado para seus usuários, eles aparecerão aqui.

Resultado do upload de usuário

Após aceitar as configurações de visualização clicando em "Carregar lista de usuários", você deverá ver a tela de resultados de Upload de usuários.

A tela de resultados; tudo ocorreu bem!

Esta tela mostrará quaisquer exceções ou alterações feitas a cada usuário no processo de upload. Por exemplo, se você estava atualizando as informações do usuário, as informações atualizadas serão mostradas. Ou, se um usuário não foi adicionado, esse registro será destacado.

A tela resumirá quantos usuários foram carregados ou atualizados, indicará o número de senhas fracas e o número de erros.

Potenciais avançados do Upload de usuários

Templates

Nota: Esta seção precisa ser verificada e atualizada se necessário para o Moodle 2.0. Por favor, faça-o e remova esta nota quando terminar.

Os valores padrão são processados como modelos nos quais os seguintes códigos são permitidos:

  • %l - será substituído pelo lastname
  • %f - será substituído pelo firstname
  • %u - será substituído pelo username
  • %% - será substituído pelo%

Entre o sinal de porcentagem (%) e qualquer letra de código (l, f ou u), os seguintes modificadores são permitidos:

  • (-) sinal de menos - as informações especificadas pela letra do código serão convertidas em minúsculas
  • (+) sinal de mais - as informações especificadas pela letra do código serão convertidas em MAIÚSCULAS
  • (~) sinal de til - as informações especificadas pela letra do código serão convertidas para caixa do título
  • um número decimal - as informações especificadas pela letra do código serão truncadas para essa quantidade de caracteres

Por exemplo, se o nome for John e o sobrenome for Doe, os seguintes valores serão obtidos com os modelos especificados:

  • %l%f = DoeJohn
  • %l%1f = DoeJ
  • %-l%+f = doeJOHN
  • %-f_%-l = john_doe
  • http://www.example.com/~%u/resulta emhttp://www.example.com/~jdoe/(se o nome de usuário (username) for jdoe ou% -1f% -l)

O processamento do template é feito apenas nos valores padrão e não nos valores recuperados do arquivo CSV.

Para criar nomes de usuário corretos no Moodle, o nome de usuário é sempre convertido para minúsculas. Além disso, se a opção "Permitir caracteres estendidos em nomes de usuário" na página de políticas do site estiver desativada, os caracteres diferentes de letras, dígitos, traço (-) e ponto (.) Serão removidos. Por exemplo, se o nome for John Jr. e o sobrenome for Doe, o nome de usuário% -f _%-l produzirá john jr._doe quando permitir caracteres estendidos em nomes de usuário e estiver ativado, e johnjr.doe quando desativado.

Quando a configuração "Novo tratamento de duplicatas de nome de usuário" é definida como Contador de acréscimo, um contador de incremento automático será acrescentado aos nomes de usuário duplicados produzidos pelo modelo. Por exemplo, se o arquivo CSV contiver os usuários chamados John Doe, Jane Doe e Jenny Doe sem nomes de usuário explícitos, o nome de usuário padrão é %-1f%-l e o novo tratamento de duplicata de nome de usuário é definido como Append counter, então os nomes de usuário produzidos serão jdoe, jdoe2 e jdoe3.

Excluindo contas

Se o campo deleted estiver presente, os usuários com valor 1 para ele serão excluídos. Neste caso, todos os campos podem ser omitidos, exceto username. Depois de enviar o arquivo, certifique-se de alterar o "Tipo de upload" para "Atualizar somente usuários existentes" e a opção "Permitir exclusões" para "Sim".

Dica: Um campo semelhante está disponível para suspended. Isso permite que uma conta de usuário seja temporariamente desabilitada em vez de completamente removida.

A exclusão e o upload de contas podem ser feitos com um único arquivo .CSV. Por exemplo, o arquivo a seguir adicionará o usuário Tom Jones e excluirá o usuário reznort:

username,firstname,lastname,deleted
jonest,Tom,Jones,0
reznort,,,1

Formato de arquivo de codificação

Na tela inicial do usuário Upload, você pode selecionar o formato de codificação do arquivo em uma lista suspensa. Isso inclui UTF-8 (o padrão), ASCII, ISO-8859-1 a ISO-8859-11 ou qualquer um dos mais de 36 formatos.

Dicas

Planilha

Se você usar um programa de planilha como o Excel para criar seu arquivo .csv, verifique a saída resultante em um editor de texto antes de carregá-lo. É possível obter vírgulas finais em cada linha de um campo vazio se você tiver adicionado e excluído colunas de informações antes de salvar o arquivo final. Verifique também a codificação de caracteres. Um arquivo .csv é um arquivo de texto simples (ASCII ou Unicode) que pode ser usado para fazer upload de contas de usuário.

O Excel traduz as senhas que começam com - (menos) ou + (mais) como zero. Mesmo ao salvar como .csv e dizer "Sim" para "Mantenha este formato e exclua quaisquer recursos incompatíveis." Verifique isso antes de fazer upload, pois um zero interrompe o processo de upload.

Se você usar uma fórmula no Excel para criar campos (por exemplo, a função concatenar para criar um nome de usuário), lembre-se de copiar as células com a fórmula e usar a colagem especial com os valores marcados para torná-los dados aceitáveis para um arquivo .csv.

O upload também falhará se você tiver espaços à direita no final dos campos de dados. Frequentemente, isso não pode ser removido com um simples Localizar " " e Substituir por "". Se as informações foram copiadas de fontes da web, então é possível incluir espaços ininterruptos que impedirão que seu upload seja concluído corretamente. Para localizar esses espaços invisíveis, use a função Localizar e Substituir no Excel. No campo localizar, segure alt e digite 0160. Deixe o campo substituir em branco.

Limites de tamanho de campo

Alguns campos têm comprimento máximo de caracteres, conforme definido nos campos do banco de dados. Normalmente, o arquivo é importado para a tela de lista de visualização, mas não conclui o processo. Ative a depuração para ver os campos que são muito longos. O erro será "Usuário não adicionado - erro".

Os tamanhos de alguns campos comuns, em número de caracteres, são atualmente (3.2):

  • username - 100
  • password - 255
  • idnumber - 255
  • firstname - 100
  • lastname - 100
  • lastnamephonetic - 255
  • firstnamephonetic - 255
  • middlename - 255
  • alternatename - 255
  • institution - 255
  • department - 255
  • address - 255
  • city - 120
  • icq -15
  • skype - 50
  • yahoo - 50
  • aim - 50
  • msn - 50
  • phone1 - 20
  • phone2 - 20

Todos os campos de usuário listados aqui

Todos os campos do usuário que são válidos em um arquivo de upload estão listados abaixo, exceto para quaisquer campos personalizados que você possa ter criado (para os quais veja abaixo).
firstname,lastname,username,email,password,auth,idnumber,institution,department,city,country,timezone,lang,mailformat,maildisplay,maildigest,htmleditor,autosubscribe,skype,msn,aim,yahoo,icq,phone1,phone2,address,url,description,descriptionformat,interests,oldusername,deleted,suspended,alternatename,lastnamephonetic,firstnamephonetic,middlename

As informações sobre inscrições em cursos são

course1,type1,role1,group1,enrolperiod1,enrolstatus1

onde cada inscrição é agrupada por número.

Capacidades

Você pode desejar criar um papel limitado para permitir que alguns usuários acessem esta função. Crie um papel no nível do sistema/local com os seguintes recursos permitidos:

  • moodle/site:uploadusers
  • moodle/role:assign

E

  • Na guia 'Permitir atribuições de papéis' deste novo papel, permita que atribua os papéis necessários que podem estar carregando, especialmente Aluno, mas também Professor, Professor que não edita e quaisquer outros papéis personalizados que você possa ter criado, que irão ser usado nos uploads aos quais atribuir usuários.

Em particular, não se esqueça do recurso moodle/role:assign (mesmo se esses usuários o tiverem nos cursos em que irão inscrever usuários - não funcionará).

Upload de usuários via CLI

Nova funcionalidade
no Moodle 3.10!
No Moodle 3.10 em diante, um administrador pode enviar usuários por meio de um script CLI.

Para obter instruções sobre como usar o script, na linha de comando do diretório moodle execute

php admin/tool/uploaduser/cli/uploaduser.php --help

Veja também

Discussões do fórum: