Base de dados central de participantes
From LimeSurvey Manual
Introdução
Para aceder a esta funcionalidade: Configuração -> Base de dados central de participantes:
Esta funcionalidade permite ao administrador guardar a informação dos participantes numa tabela central, independente de qualquer tabela de participantes no inquérito. As suas principais vantagens são:
- A tabela central funciona como cópia de segurança. Se um utilizador criar um novo inquérito, não necessita de exportar os respetivos participantes para um ficheiro CSV e depois importá-los para o novo inquérito.
- Os utilizadores só precisam de adicionar os participantes à tabela central. Depois, os mesmos participantes podem ser adicionados a tantos inquéritos quantos o utilizador pretender.
- Caso vários utilizadores tenham acesso a uma instalação do LimeSurvey, o(s) seu(s) proprietário(s) podem optar por partilhar os seus participantes com outros utilizadores e definir também os direitos de acesso dos utilizadores com quem partilham.
Na sua instalação do LimeSurvey poderá ainda pesquisar um controlo avançado de atributos e várias outras funcionalidades.
Ferramentas de gestão do painel de participantes
Estão disponíveis as seguintes opções:
- Mostrar participantes da BD central de participantes
- Informação
- Importar
- Definições da lista negra
- Atributos
- Painel de partilha
- Exportar todos os participantes
Mostrar participantes da BD central de participantes
Este é o componente principal deste painel. A maioria das opções pode ser acedida a partir daqui, como adicionar, eliminar, exportar, adicionar participantes a inquéritos, etc.
Estão disponíveis cinco opções na coluna Acção para cada participante listado na tabela:
- Editar este participante
- Eliminar este participante
- Partilhar este participante
- Listar inquéritos ativos
- Adicionar participante ao inquérito
Adicionar participante
Clique no botão Adicionar novo participante localizado na parte superior direita da janela: 
.
Será apresentada uma caixa de diálogo com os seguintes atributos básicos:
- Primeiro nome
- Último nome
- Colocar utilizador na lista negra
- Dono: Qualquer utilizador do LimeSurvey definido na página de gestão de utilizadores pode ser dono.
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 Acção (
). Será apresentada uma janela com todos os atributos disponíveis.
Remover participante
Pode remover facilmente um ou vários participantes:
- Se pretender remover um participante, vá à linha onde o respetivo participante se encontra e clique no botão vermelho do caixote do lixo:
. - Se pretender remover dois ou mais participantes, clique no botão Com o(s) participant(es) selecionados... (abaixo da última linha, por baixo da coluna Acção) depois de selecionar as entradas correspondentes:
. Em seguida, clique na opção de remover.
Quando remove o(s) participante(s), tem à sua disposição três opções:
1) Remover apenas do painel central: A primeira opção remove o participante apenas da base de dados central de participantes. Se o participante estiver em alguma tabela de participantes de um inquérito, não será removido dessa tabela.
2) Remover do painel central e dos inquéritos associados: A segunda opção remove o participante do painel central e dos inquéritos aos quais foi adicionado, mas as respetivas respostas não são removidas.
3) Remover do painel central, inquéritos associados e todas as respostas associadas: A terceira opção remove todos os vestígios desse participante do sistema, incluindo as respetivas respostas.
Atenção : Tenha em atenção que, nos três cenários, as ligações criadas para manter o histórico de um participante também são removidas.
Partilhar participante
Esta é outra funcionalidade importante da Base de dados central de participantes. Pode partilhar os seus participantes com outros utilizadores. Basta selecionar o(s) participante(s) que pretende partilhar e clicar no ícone verde de seta para a direita (
) ou no botão Com o(s) participant(es) selecionados..., localizado na parte inferior esquerda da tabela de participantes. Será aberta uma janela modal que lhe permite selecionar o utilizador com quem pretende partilhar o(s) respetivo(s) participante(s). Pode também definir se o utilizador com quem partilha o participante pode editar esses participantes. Se definir como Não, esse utilizador receberá um erro de acesso negado ao tentar editar as entradas do participante partilhado.
Listar inquéritos ativos
Se clicar no ícone seguinte (
), serão listados todos os inquéritos ativos aos quais o respetivo participante foi adicionado.
Adicionar participante ao inquérito
Pode adicionar um participante a um inquérito clicando no último ícone (
) da coluna Acção. Se pretender adicionar mais do que um participante a um inquérito, marque-os e selecione a opção Partilhar na caixa de diálogo Com o(s) participant(es) selecionados... (localizada na parte inferior esquerda da tabela central).
Tenha em atenção que, se pretender adicionar participantes da base de dados central a um inquérito, o respetivo inquérito tem de conter uma tabela de participantes no inquérito! Para mais detalhes, continue a ler a seguinte secção da wiki.O título da caixa de diálogo mostra o número de participantes que vão ser adicionados ao respetivo inquérito. Além disso, existe também uma caixa de seleção que, se estiver marcada, o levará à tabela de participantes do inquérito ao qual está a adicionar os participantes.
Depois de clicar em "Seguinte", será direcionado para a página de mapeamento de atributos.
A página de mapeamento de atributos contém quatro tabelas e utiliza uma funcionalidade avançada de arrastar e largar:
- A primeira tabela, Atributos do participante não mapeados, mostra todos os atributos presentes na base de dados central de participantes. Atualmente não estão mapeados, ou seja, não estão presentes na tabela de participantes do inquérito. Estes 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 inquérito, ou podem ser associados aos atributos de código existentes, arrastando os atributos não mapeados para a tabela Atributos de código existentes, junto ao atributo de código existente com o qual pretende associá-los.
- A segunda tabela, Atributos de código a criar, ajuda a copiar atributos de participante não mapeados para a tabela de participantes do inquérito, criando novas colunas. Arraste o(s) atributo(s) que pretende adicionar à tabela de participantes do inquérito e largue-o(s) na segunda tabela. Desta forma, serão adicionadas novas colunas/atributos à tabela de participantes do inquérito.
- A terceira tabela, Atributos de código existentes, apresenta os atributos atualmente existentes na tabela de participantes do inquérito. Largue aqui os atributos não mapeados se pretender copiar os dados dos atributos não mapeados para um dos atributos de código existentes (veja a captura de ecrã abaixo).
- A quarta tabela, Campos de código padrão, apresenta os campos de código padrão que podem ser associados a atributos de participante não mapeados. O único campo de código padrão de uma tabela de participantes do inquérito que pode ser editado é o Código. Isto é importante quando pretende, por exemplo, copiar facilmente códigos entre diferentes instalações do LimeSurvey.
Também pode substituir os valores dos atributos de código existentes na tabela de participantes do inquérito se o participante já existir. Utilize esta opção com cuidado para não perder dados importantes sobre os inquiridos.
Depois de mapear todos os atributos, clique em Continuar. Após o processamento dos participantes, será apresentada uma página de resumo que indica quantos participantes foram copiados com sucesso. Se tiver solicitado previamente o redirecionamento, será redirecionado para a tabela de participantes do inquérito; caso contrário, será redirecionado para a página principal da CPDB.
Info
Apresenta as estatísticas da CPDB:
1) Total de participantes na tabela principal : O número total de participantes existentes na base de dados central de participantes.
2) Participantes pertencentes a si : Mostra o número total de participantes que têm você como proprietário. Por predefinição, os novos participantes introduzidos na base de dados central de participantes têm como proprietário o utilizador que os adicionou em primeiro lugar.
3) Participantes partilhados consigo : O número de participantes que foram partilhados consigo por outros utilizadores.
4) Participantes que partilhou : O número de participantes que partilhou com outros utilizadores.
5) Participantes na lista negra : O número de participantes que se encontram na lista negra.
6) Total de atributos na tabela principal : O número total de atributos existentes na tabela central.
Importar
Se pretender adicionar participantes através da função de importação, clique no botão Importar, localizado na barra de ferramentas principal da página Base de dados central de participantes: 
Estão disponíveis as seguintes opções:
Tenha em atenção o texto da caixa Formato de entrada do CSV:
Campo obrigatório: email
Campos opcionais: firstname, lastname, blacklisted, language
Passos para importar
1) Selecione um ficheiro para importar e especifique as definições associadas.
2) Mapeie os atributos do ficheiro CSV. Importe os dados do atributo para um atributo existente da base 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 imagem anterior, será criado um novo atributo denominado "New Age". Os dados do atributo "Sex" foram mapeados e copiados para o atributo "Sex" existente na base de dados central de participantes.
3) Clique em continuar e aguarde a conclusão do processo. No final, será apresentado um breve resumo.
Ao clicar em Correcto, será redirecionado para o ecrã de participantes, onde poderá ver os participantes acabados de importar.
Definições da lista negra
O botão Definições da lista negra está disponível na barra de ferramentas principal da página Base de dados central de participantes. Ao clicar nele, será apresentada a página seguinte.
Estão disponíveis as seguintes opções Sim/Não:
- Blacklist all current surveys for participant once the global field is set: Se definido como Sim, os participantes na lista negra não podem ser adicionados a nenhum inquérito.
- Blacklist participant for any new added survey once the global field is set: Se forem criados novos inquéritos, os respetivos participantes não poderão ser adicionados a eles (se for escolhido Sim). No entanto, continuam a poder ser adicionados aos inquéritos criados anteriormente.
- Allow blacklisted participants to be added to a survey: Mesmo que um participante esteja na lista negra, pode ainda assim ser adicionado a um inquérito.
- Hide blacklisted participants: Função útil quando pretende ocultar participantes durante um determinado período de tempo e depois disponibilizá-los aos restantes utilizadores com quem esses participantes da lista negra foram partilhados.
- Delete globally blacklisted participants from the database: Se Sim, os participantes na lista negra serão eliminados da base de dados.
- Allow participant to un-blacklist himself/herself: Se Sim, os participantes podem retirar-se a si próprios da lista negra sem a ajuda de um utilizador do LimeSurvey.
Atributos
Para aceder ao painel Gestão de atributos, clique no botão Atributos localizado na barra de ferramentas principal da página principal da CPDB: 
A gestão de atributos permite adicionar três tipos de atributos: caixa de texto, data e lista de seleção (Drop-down). Para adicionar um novo atributo, clique em Adicionar novo atributo, localizado na parte superior direita da janela:
Ao adicionar um novo atributo, estão disponíveis as seguintes opções:
- Defaultname: Será utilizado pelo LimeSurvey para dar nome ao atributo caso não seja indicado outro nome em inglês.
- Tipo do atributo: Pode escolher qualquer um dos tipos de atributo e a respetiva interface será apresentada durante a edição.
- Mostrar este atributo no painel?: Pode ser Sim ou Não. Esta função determina se o atributo é visível ou não na tabela da CPDB. Pode ser alterado posteriormente na coluna Visível, localizada na tabela principal de atributos.
- Idiomas: Se não pretender que o LimeSurvey utilize o defaultname como nome do atributo, escreva aqui o nome desejado. Tenha em atenção que a gestão de atributos tem suporte multilingue. Clique no sinal de mais depois de selecionar o idioma. Será apresentado um novo campo por baixo do idioma inglês/por omissão.
Depois de efetuar as alterações, clique em Gravar.
Recomendamos que escreva o nome do atributo na caixa do idioma correspondente, mesmo que utilize apenas um idioma (o idioma base). Isto deve-se ao facto de, quando mapeia atributos e pretende adicioná-los a diferentes tabelas de participantes no inquérito, o defaultname do atributo não ser apresentado no respetivo painel - apenas é apresentado o nome que indicou na caixa do idioma correspondente.Na tabela de atributos, estão disponíveis duas ações (consulte a coluna Acção):
Se clicar no primeiro ícone, será apresentada uma caixa de diálogo. Esta inclui as configurações básicas do atributo selecionado, que podem ser editadas de acordo com as suas necessidades.
Para eliminar um atributo da tabela, clique no botão vermelho do caixote do lixo, localizado junto ao botão de edição. Ao clicar no botão de eliminar, será eliminado não só o atributo, mas também os valores associados na CPDB.
Painel de partilha
O painel de partilha mostra toda a informação relacionada com os participantes partilhados. Tenha em atenção que este painel mostra apenas os participantes partilhados que pertencem a esse utilizador em particular.
Este painel mostra valores como:
1) Último nome
2) Primeiro nome
3) Endereço de email
4) Partilhado por
5) Dono
6) Adicionado em
7) Pode editar?
Esta informação destina-se a visualização/ordenação. Apenas o campo Pode editar? é editável pelo utilizador. O campo Pode editar? permite determinar se o respetivo participante pode ou não ser editado pelo utilizador com quem foi partilhado. Ao clicar na caixa de seleção, será feita uma chamada AJAX e as alterações serão guardadas no servidor.
Exportar participantes
A função de exportação encontra-se na barra de ferramentas principal da página Base de dados central de participantes: 
Ao exportar para CSV, é apresentada uma caixa de diálogo que lhe pede para marcar os atributos que pretende exportar.
Pode exportar:
- Nenhum dos atributos adicionais
- Todos os atributos adicionais
- Alguns atributos adicionais
O formato do ficheiro exportado será CSV.
Exportar participantes filtrados
Para exportar participantes filtrados, utilize primeiro os filtros de pesquisa. Depois, clique na caixa de seleção localizada no lado esquerdo da coluna Acção (para selecionar todos os participantes filtrados). Em seguida, clique no botão Com o(s) participant(es) selecionados localizado na parte inferior direita da tabela e selecione a função de exportação. Desta forma, apenas os participantes filtrados serão exportados.
Filtros de pesquisa
Se pretender filtrar os utilizadores da sua base de dados, utilize as caixas de pesquisa/listas pendentes localizadas abaixo do título de cada coluna:
Introduza informação nos campos de pesquisa ou selecione nas listas pendentes (quando possível) os participantes que pretende que sejam listados após o processo de filtragem.
Informações adicionais
Estão disponíveis informações adicionais (técnicas) no wiki Desenvolvimento da base de dados central de participantes (painel do utilizador).