Banco de dados central de participantes

Introdução

Para acessar este recurso: Configuração -> Banco de dados central de participantes:

Este recurso permite que o administrador armazene as informações dos participantes em uma tabela central, independente de qualquer tabela de participantes do inquérito. Suas principais vantagens são:

• A tabela central funciona como um backup. Se um usuário criar um novo inquérito, não precisará exportar os participantes para um arquivo CSV e depois importá-los novamente no novo inquérito.
• Os usuários precisam apenas adicionar os participantes à tabela central. Depois, os mesmos participantes podem ser adicionados a quantos inquéritos o usuário quiser.
• Caso vários usuários tenham acesso a uma instalação do LimeSurvey, o(s) proprietário(s) pode(m) optar por compartilhar seus participantes com outros usuários e também definir os direitos de acesso dos usuários com quem foram compartilhados.

Na sua instalação do LimeSurvey, você também encontra um controle avançado de atributos e vários outros recursos.

Ferramentas de gerenciamento do painel de participantes

As seguintes opções estão disponíveis:

• Mostrar participantes do CPDB (Banco de dados central de participantes)
• Informações
• Importar
• Configurações da lista negra
• Atributos
• Painel de compartilhamento
• Exportar todos os participantes

Mostrar participantes do CPDB

Este é o componente principal deste painel. A maioria das opções pode ser acessada a partir daqui, como adicionar, excluir e exportar participantes, adicionar participantes a inquéritos etc.

Cinco opções estão disponíveis na coluna Ação para cada participante listado na tabela:

• Editar este participante
• Remover este participante
• Compartilhar este participante
• Listar questionários ativos
• Incluir participante ao questionário

Antes de acessar as opções mencionadas acima, é necessário ter usuários listados no seu banco de dados. Para criá-los, clique no botão Adicionar novo participante, localizado na parte superior direita da janela.

Adicionar participante

Clique no botão Adicionar novo participante, localizado na parte superior direita da janela: .

Uma caixa de diálogo com os seguintes atributos básicos será exibida:

• Nome
• Sobrenome
• E-mail
• Usuário na lista negra
• Proprietário: Qualquer usuário do LimeSurvey definido na página de gerenciamento de usuários pode ser proprietário.

É possível adicionar Atributos personalizados. Para mais detalhes, consulte as seções atributos e exemplos.

Editar participante

Para editar os atributos básicos e/ou personalizados de um participante, clique no primeiro botão (da esquerda para a direita) localizado na coluna Ação (). Uma janela com todos os atributos disponíveis será exibida.

Excluir participante

Você pode excluir facilmente um ou vários participantes:

• Para excluir um participante, vá até a linha onde ele está localizado e clique no botão da lixeira vermelha: .
• Para excluir dois ou mais participantes, clique no botão Participante(s) selecionado(s)... (abaixo da última linha, sob a coluna Ação) depois de selecionar as entradas correspondentes: . Em seguida, clique na opção de exclusão.

Ao excluir o(s) participante(s), três opções estão disponíveis:

1) Excluir somente do painel central: A primeira opção exclui o participante apenas do banco de dados central de participantes. Se o participante estiver em alguma tabela de participantes de um inquérito, ele não será removido.

2) Excluir do painel central e questionários associados: A segunda opção exclui o participante do painel central e dos questionários aos quais ele foi adicionado, mas suas respostas não são excluídas.

3) Excluir do painel central, questionários associados e todas respostas associadas: A terceira opção exclui todos os vestígios desse participante do sistema, incluindo suas respostas.

  Observe que, nos três cenários, os vínculos criados com a finalidade de manter o histórico de um participante também são excluídos.

Compartilhar participante

Este é outro recurso importante do Banco de dados central de participantes. Você pode compartilhar seus participantes com outros usuários. Basta selecionar o(s) participante(s) que deseja compartilhar e clicar no ícone de seta verde para a direita () ou no botão Participante(s) selecionado(s)... localizado na parte inferior esquerda da tabela de participantes. Uma caixa modal será aberta, permitindo selecionar o usuário com quem deseja compartilhar o(s) respectivo(s) participante(s). Você também pode definir se o usuário que recebe o compartilhamento do seu participante pode editá-lo. Se você definir como Não, ele receberá um erro de acesso negado ao tentar editar os registros do participante compartilhado.

Listar questionários ativos

Se você clicar no próximo ícone (), serão listados todos os questionários ativos aos quais o respectivo participante foi adicionado.

Incluir participante ao questionário

Para adicionar um participante a um questionário, clique no último ícone () da coluna Ação. Se desejar adicionar mais de um participante a um questionário, marque-os e selecione a opção Compartilhar na caixa de diálogo Participante(s) selecionado(s)... (localizada na parte inferior esquerda da tabela central).

Observe que, para adicionar participantes do banco de dados central a um questionário, o respectivo questionário precisa conter uma tabela de participantes do questionário! Para mais detalhes, continue lendo a seguinte seção da wiki.

O título da caixa de diálogo mostrará o número de participantes que serão adicionados ao respectivo questionário. Além disso, há também uma caixa de seleção que, se marcada, levará você à tabela de participantes do questionário ao qual você está adicionando os participantes.

Depois de clicar em "Próximo", você será levado à página de mapeamento de atributos.

A página de mapeamento de atributos contém quatro tabelas e usa uma funcionalidade avançada de arrastar e soltar:

• A primeira tabela, Atributos não mapeados do participante, mostra todos os atributos presentes no banco de dados central de participantes. Eles estão atualmente não mapeados, ou seja, não estão presentes na tabela de participantes do questionário. Esses atributos não mapeados podem ser movidos para a tabela Atributos de código a criar, que cria novos atributos na tabela de participantes do questionário, ou podem ser mesclados com os atributos de código existentes, arrastando-os para a tabela Atributos de código existentes, ao lado do atributo de código existente com o qual você deseja mesclá-los.

• A segunda tabela, Atributos de código a criar, ajuda você a copiar atributos não mapeados do participante para a tabela de participantes do questionário, criando novas colunas. Arraste o(s) atributo(s) que deseja adicionar à tabela de participantes do questionário e solte-o(s) na segunda tabela. Dessa forma, novas colunas/atributos serão adicionados à tabela de participantes do questionário.

• A terceira tabela, Atributos de código existentes, exibe os atributos atuais existentes na tabela de participantes do questionário. Solte aqui os atributos não mapeados se desejar copiar os dados dos atributos não mapeados para um dos atributos de código existentes (veja a captura de tela abaixo).

• A quarta tabela, Campos de código padrão, exibe os campos de código padrão que podem ser mesclados com atributos não mapeados do participante. O único campo de código padrão de uma tabela de participantes do questionário que pode ser editado é o Código de acesso. Isso é importante quando você deseja, por exemplo, copiar facilmente códigos de acesso entre diferentes instalações do LimeSurvey.

Você também pode sobrescrever os valores dos atributos de código existentes na tabela de participantes do questionário caso um participante já exista. Use essa opção com cautela para não perder dados importantes sobre os respondentes do questionário.

Depois de mapear todos os atributos, você pode clicar em Continuar. Após o processamento dos participantes, será exibida uma página de resumo informando quantos participantes foram copiados com sucesso. Se você solicitou anteriormente o redirecionamento, será redirecionado para a tabela de participantes do questionário; caso contrário, será redirecionado para a página principal da CPDB.

Informações

Exibe estatísticas da CPDB:

1) Total de participantes na tabela central : O número total de participantes localizados no banco de dados central de participantes.

2) Participantes de sua propriedade : Mostra o número total de participantes que têm você como proprietário. Por padrão, os novos participantes inseridos no banco de dados central de participantes têm como proprietário o usuário que os adicionou primeiro.

3) Participantes compartilhados com você : O número de participantes que foram compartilhados com você por outros usuários.

4) Participantes que você compartilhou : O número de participantes que você compartilhou com outros usuários.

5) Participantes na lista negra : O número de participantes que estão na lista negra.

6) Total de atributos na tabela central : O número total de atributos que podem ser encontrados na tabela central.

Importar

Se você deseja adicionar participantes por meio da função de importação, clique no botão Importar, localizado na barra de ferramentas principal da página Banco de dados central de participantes:

As seguintes opções estão disponíveis:

Observe o texto da caixa sobre o Formato de entrada CSV:

O arquivo deve ser um arquivo CSV padrão (delimitado por vírgulas) com aspas duplas opcionais ao redor dos valores (padrão do OpenOffice e do Excel). A primeira linha deve conter os nomes dos campos. Os campos podem estar em qualquer ordem.

Campo obrigatório: email

Campos opcionais: firstname, lastname, blacklisted, language

Etapas para importar

1) Selecione um arquivo para importar e especifique as configurações associadas a ele.

2) Mapeie os atributos do arquivo CSV. Importe os dados do atributo para um atributo existente do banco de dados central de participantes ou para uma nova coluna, criando um novo atributo. O atributo recém-criado será do tipo caixa de texto - o formato pode ser alterado posteriormente.

Na captura de tela acima, será criado um novo atributo chamado "New Age". Os dados do atributo "Sex" foram mapeados e copiados para o atributo "Sex" existente no banco de dados central de participantes.

3) Clique em continuar e aguarde a conclusão do processo. Ao final, um breve resumo será exibido.

Ao clicar em OK, você será redirecionado para a tela de participantes, que mostrará os participantes recém-importados.

Configurações da lista negra

O botão Configurações da lista negra está disponível na barra de ferramentas principal da página Banco de dados central de participantes. Ao clicar nele, a seguinte página será exibida.

As seguintes opções Sim/Não estão disponíveis:

• Colocar todos os questionários atuais na lista negra para o participante quando o campo global for definido: Se definido como Sim, os participantes na lista negra não podem ser adicionados a nenhum questionário.
• Colocar o participante na lista negra para qualquer novo questionário adicionado quando o campo global for definido: Se novos questionários forem criados, os respectivos participantes não poderão ser adicionados a eles (se Sim for selecionado). No entanto, ainda poderão ser adicionados aos questionários criados anteriormente.
• Permitir que participantes na lista negra sejam adicionados a um questionário: Mesmo que um participante esteja na lista negra, ele ainda poderá ser adicionado a um questionário.
• Ocultar participantes na lista negra: Função útil quando você deseja ocultar participantes por um período específico e depois torná-los disponíveis para os demais usuários com quem esses participantes foram compartilhados.
• Excluir do banco de dados os participantes na lista negra global: Se Sim, os participantes na lista negra serão excluídos do banco de dados.
• Permitir que o participante se remova da lista negra por conta própria: Se Sim, os participantes podem se remover da lista negra sem a ajuda de um usuário do LimeSurvey.

Atributos

Para acessar o painel de Gerenciamento de atributos, clique no botão Atributos, localizado na barra de ferramentas principal da página principal do CPDB:

O gerenciamento de atributos permite adicionar três tipos de atributos: caixa de texto, data e lista suspensa. Para adicionar um novo atributo, clique em Adicionar novo atributo, localizado na parte superior direita da janela:

Ao adicionar um novo atributo, as seguintes opções estão disponíveis:

• Defaultname: Será usado pelo LimeSurvey para nomear o atributo caso nenhum outro nome em inglês seja informado.
• Tipo do atributo: Você pode escolher qualquer um dos tipos de atributo e a interface de usuário associada será apresentada durante a edição.
• Este atributo deve ser visível no painel?: Pode ser Sim ou Não. Esta função determina se o atributo é visível na tabela do CPDB ou não. Isso pode ser editado posteriormente na coluna Visível, localizada na tabela principal de atributos.
• Idiomas: Se você não quiser que o LimeSurvey use o defaultname como nome do atributo, digite aqui o nome desejado. Observe que o gerenciamento de atributos oferece suporte multilíngue. Clique no sinal de mais após selecionar o idioma. Um novo campo aparecerá abaixo do idioma inglês/padrão.

Depois de concluir as alterações, clique em Salvar.

Recomendamos que você escreva o nome do atributo na caixa do idioma correspondente, mesmo que use apenas um idioma (o idioma base). Isso porque, ao mapear atributos e adicioná-los a diferentes tabelas de participantes do questionário, o defaultname do atributo não é exibido no painel correspondente - apenas o nome informado na caixa do idioma correspondente é mostrado.

Na tabela de atributos, duas ações estão disponíveis (veja a coluna Ação):

Se você clicar no primeiro ícone, será exibida uma caixa de diálogo. Ela inclui as configurações básicas do atributo selecionado, que podem ser editadas de acordo com as suas necessidades.

Para excluir um atributo da tabela, clique no botão vermelho da lixeira, localizado ao lado do botão de edição. Ao clicar no botão de exclusão, você excluirá não apenas o atributo, mas também os valores associados no CPDB.

Painel de compartilhamento

O painel de compartilhamento mostra todas as informações relacionadas aos participantes compartilhados. Observe que este painel mostra apenas os participantes compartilhados pertencentes a esse usuário específico.

Este painel mostra valores como:

1) Sobrenome

2) Nome

3) E-mail

4) Compartilhado por

5) Proprietário

6) Data adicionada

7) Pode editar ?

Estas informações servem para visualização/ordenação. Somente o campo Pode editar ? pode ser editado pelo usuário. O campo Pode editar ? permite determinar se o participante em questão poderá ou não ser editado pelo usuário com quem ele foi compartilhado. Ao clicar na caixa de seleção, será feita uma chamada AJAX e as alterações serão salvas no servidor.

Exportar participantes

A função de exportação está localizada na barra de ferramentas principal da página Banco de dados central de participantes:

Ao exportar para CSV, é exibida uma caixa de diálogo que solicita que você marque os atributos que deseja exportar.

Você pode exportar:

• Nenhum dos atributos adicionais

• Todos os atributos adicionais

• Determinados atributos adicionais

O formato do arquivo exportado será CSV.

Exportar participantes filtrados

Para exportar participantes filtrados, primeiro use os filtros de pesquisa. Em seguida, clique na caixa de seleção localizada no lado esquerdo da coluna Ação (para selecionar todos os participantes filtrados). Depois, clique no botão Participante(s) selecionado(s)... localizado na parte inferior direita da tabela e selecione a função de exportação. Dessa forma, somente os participantes filtrados serão exportados.

Filtros de pesquisa

Se você deseja filtrar os usuários do seu banco de dados, use as caixas de pesquisa/lista suspensa localizadas abaixo do título de cada coluna:

Insira informações nos campos de pesquisa ou selecione nas listas suspensas (quando possível) os participantes que deseja que sejam listados após o processo de filtragem.

Informações adicionais

Informações adicionais (técnicas) estão disponíveis no wiki Desenvolvimento do BD central de participantes (painel do usuário).