Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Esta página fornece uma lista completa de todas as funções vivaglint exportadas agrupadas por tema, juntamente com tabelas de referência para a fórmula De classificação glint, limiares de favorecimento e nomes de coluna padrão.
Resumo da função
Importação e validação
| Função | Objetivo | Retorna | Suporte de desenho |
|---|---|---|---|
read_glint_survey() |
Importar e validar uma exportação de CSV Viva Glint |
glint_survey objeto |
Não |
extract_questions() |
Analisar nomes de colunas e devolver metadados de perguntas | Tibble | Não |
join_attributes() |
Associar dados de atributos de funcionários a um inquérito |
glint_survey ou moldura de dados |
Não |
Remodelar
| Função | Objetivo | Retorna | Suporte de desenho |
|---|---|---|---|
pivot_long() |
Remodelar o inquérito de formato largo para longo | Desativar ou lista com nome | Não |
split_survey_data() |
Separar as respostas numéricas dos dados de comentários | Lista com nome | Não |
Análise
| Função | Objetivo | Retorna | Suporte de desenho |
|---|---|---|---|
summarize_survey() |
Média por pergunta, SD, Pontuação Glint, favorabilidade | Tibble | Sim |
get_response_dist() |
Contagem e percentagem por valor de resposta por pergunta | Tibble | Sim |
compare_cycles() |
Métricas e classificações de alteração em vários ciclos de inquérito | Tibble | Sim |
get_correlations() |
Correlações inter-perguntas entre pares com valores p | Tibble ou matriz | Sim (formato longo) |
extract_survey_factors() |
Análise exploratória de fatores com o resumo de carregamento | Lista com nome | Sim |
analyze_attrition() |
Taxas de atrito por grupo de favorabilidade em janelas de tempo | Tibble | Sim |
analyze_by_attributes() |
Métricas de inquérito segmentadas por atributos de funcionários | Tibble | Sim |
search_comments() |
Pesquisa em texto completo em todas as colunas de comentários | Tibble | Não |
Hierarquia
| Função | Objetivo | Retorna | Suporte de desenho |
|---|---|---|---|
aggregate_by_manager() |
Métricas de inquérito agregadas ao nível da equipa de gestor | Tibble | Sim |
Detalhes da função
read_glint_survey
Importe e valide uma exportação CSV do inquérito Viva Glint. Veja Introdução para obter detalhes.
read_glint_survey(file_path, encoding = "UTF-8")
| Parâmetro | Tipo | Padrão | Descrição |
|---|---|---|---|
file_path |
caráter | (obrigatório) | Caminho para o ficheiro de exportação CSV |
encoding |
caráter | "UTF-8" |
Codificação de ficheiros; utilizar "latin1" se os carateres aparecerem ilegíveis |
Devolve:glint_survey objeto com $data (tibble) e $metadata (lista).
extract_questions
Analise os nomes das colunas e devolva um mapeamento de tibble que cada pergunta contém para as respetivas colunas relacionadas.
extract_questions(data)
| Parâmetro | Tipo | Padrão | Descrição |
|---|---|---|---|
data |
glint_survey ou moldura de dados | (obrigatório) | Dados de pesquisa |
Devolve: Descomenda com as colunas question, response_col, comment_col, topics_col, flag_col.
join_attributes
Associar dados de atributos de funcionários a um inquérito para análise demográfica. Veja Introdução dos dois fluxos de trabalho recomendados.
join_attributes(survey, attribute_source, emp_id_col)
| Parâmetro | Tipo | Padrão | Descrição |
|---|---|---|---|
survey |
glint_survey ou moldura de dados | (obrigatório) | Inquérito a enriquecer |
attribute_source |
caráter ou moldura de dados | (obrigatório) | Caminho do ficheiro CSV ou moldura de dados que contém atributos |
emp_id_col |
caráter | (obrigatório) | Coluna ID do Funcionário presente na origem do inquérito e do atributo |
Devolve:glint_survey Melhorado (se a entrada foi glint_survey) ou o pacote de dados associado.
pivot_long
Reformate os dados do inquérito do formato amplo (uma linha por participante) para o formato longo (uma linha por par de perguntas e respostas).
pivot_long(survey, data_type = "all", include_empty = FALSE, include_standard_cols = TRUE)
| Parâmetro | Tipo | Padrão | Descrição |
|---|---|---|---|
survey |
glint_survey ou moldura de dados | (obrigatório) | Dados de pesquisa |
data_type |
caráter | "all" |
"all", "comments" (apenas linhas com comentários) ou "both" (devolve uma lista com nome) |
include_empty |
lógica | FALSE |
Incluir linhas com texto de comentário vazio quando data_type = "comments" |
include_standard_cols |
lógica | TRUE |
Incluir colunas de inquirido padrão na saída |
Devolve: Tibble de formato longo com colunas: colunas padrão (se incluídas), question, response, comment, comment_topics, sensitive_flag. Quando data_type = "both", devolve uma lista com nome com $all e $comments.
split_survey_data
Separe um inquérito em componentes quantitativos (respostas numéricas) e qualitativos (comentários, tópicos, sinalizadores).
split_survey_data(survey, emp_id_col)
| Parâmetro | Tipo | Padrão | Descrição |
|---|---|---|---|
survey |
glint_survey ou moldura de dados | (obrigatório) | Dados de pesquisa |
emp_id_col |
caráter | (obrigatório) | Nome da coluna ID do Funcionário (utilizado como chave de associação na saída) |
Devolve: Lista com nome com $quantitative (colunas padrão + colunas de resposta numéricas) e $qualitative (ID do funcionário + comentário, tópicos e colunas de sinalizador).
summarize_survey
Calcule as métricas por pergunta, incluindo média, SD, Pontuação de Brilho, contagens de resposta e percentagens de favorabilidade. Veja Análise de Núcleos para obter detalhes completos.
summarize_survey(survey, scale_points, questions = "all", plot = FALSE)
| Parâmetro | Tipo | Padrão | Descrição |
|---|---|---|---|
survey |
glint_survey ou moldura de dados | (obrigatório) | Dados de pesquisa |
scale_points |
inteiro | (obrigatório) | Número de pontos de escala (2–11) |
questions |
vetor de carateres | "all" |
Texto(s) de pergunta a analisar ou "all" |
plot |
lógica | FALSE |
Imprimir gráfico de barras empilhadas de favorabilidade; requer ggplot2 |
Devolve: Tibble com as colunas question, mean, sd, glint_score, n_responses, n_skips, n_total, pct_favorable, , pct_neutral, . pct_unfavorable Quando plot = TRUE, devolve dados de forma invisivelmente.
get_response_dist
Calcule a contagem e percentagem dos inquiridos que selecionam cada valor de escala para cada pergunta.
get_response_dist(survey, questions = "all", plot = FALSE)
| Parâmetro | Tipo | Padrão | Descrição |
|---|---|---|---|
survey |
glint_survey ou moldura de dados | (obrigatório) | Dados de pesquisa |
questions |
vetor de carateres | "all" |
Texto(s) de pergunta a analisar ou "all" |
plot |
lógica | FALSE |
Imprimir gráfico de distribuição empilhada; requer ggplot2 |
Devolve: Grande tibble com colunas question, count_1, pct_1, count_2, pct_2, ... até ao valor máximo de resposta observado.
compare_cycles
Compare as métricas de perguntas em dois ou mais ciclos de inquérito, adicionando pontuações de alterações relativamente ao ciclo anterior. Veja Tendências, Segmentação e Hierarquia.
compare_cycles(..., scale_points, cycle_names = NULL, plot = FALSE)
| Parâmetro | Tipo | Padrão | Descrição |
|---|---|---|---|
... |
glint_survey ou moldura de dados | (obrigatório) | Dois ou mais objetos de pesquisa por ordem cronológica |
scale_points |
inteiro | (obrigatório) | Número de pontos de escala (2–11) |
cycle_names |
vetor de carateres | NULL |
Etiquetas para cada ciclo; predefinição é "Ciclo 1", "Ciclo 2", etc. |
plot |
lógica | FALSE |
Print Glint Score line chart; requer ggplot2 |
Devolve: Descomenda com todas as summarize_survey() colunas mais cycle, change_from_previous, pct_change_from_previous, glint_score_change_from_previous.
get_correlations
Calcular correlações em pares entre todas as colunas de resposta a perguntas do inquérito. Veja Correlações, Fatores e Atrito.
get_correlations(survey, method = "pearson", format = "long",
use = "pairwise.complete.obs", plot = FALSE)
| Parâmetro | Tipo | Padrão | Descrição |
|---|---|---|---|
survey |
glint_survey ou moldura de dados | (obrigatório) | Dados de pesquisa |
method |
caráter | "pearson" |
"pearson", "spearman" ou "kendall" |
format |
caráter | "long" |
"long" (uma linha por par) ou "matrix" |
use |
caráter | "pairwise.complete.obs" |
Transmitido para R's para processamento de cor() valores em falta |
plot |
lógica | FALSE |
Imprimir mapa térmico (apenas formato longo); requer ggplot2 |
Devolve: Tibble (question1, question2, correlation, p_value, n) quando format = "long", ou matriz numérica quando format = "matrix".
extract_survey_factors
Execute a análise exploratória de fatores nas respostas do inquérito para identificar construções latentes. Requer o psych pacote. Veja Correlações, Fatores e Atrito.
extract_survey_factors(survey, n_factors = NULL, rotation = "oblimin",
min_loading = 0.3, fm = "minres", plot = FALSE)
| Parâmetro | Tipo | Padrão | Descrição |
|---|---|---|---|
survey |
glint_survey ou moldura de dados | (obrigatório) | Dados de pesquisa |
n_factors |
número inteiro ou NULL |
NULL |
Fatores a extrair; NULL executa a análise paralela |
rotation |
caráter | "oblimin" |
"oblimin", , "varimax""promax", "quartimax", "equamax"ou"none" |
min_loading |
numérico | 0.3 |
Carregamento absoluto mínimo a incluir em $factor_summary |
fm |
caráter | "minres" |
"minres", , "ml""pa", "wls", "gls"ou"uls" |
plot |
lógica | FALSE |
Mapa térmico de carregamento do fator de impressão; requer ggplot2 |
Devolve: Lista com nome com $factor_summary (tibble: question, factor, loading, loading_label, communality, factor_variance_pct) e $fa_object (objeto original psych::fa ).
analyze_attrition
Ligue as respostas do inquérito aos registos de terminação e calcule as taxas de atrito por grupo de favorabilidade. Veja Correlações, Fatores e Atrito.
analyze_attrition(survey, attrition_file, emp_id_col, term_date_col,
scale_points, time_periods = c(90, 180, 365),
attribute_cols = NULL, min_group_size = 5, plot = FALSE)
| Parâmetro | Tipo | Padrão | Descrição |
|---|---|---|---|
survey |
glint_survey ou moldura de dados | (obrigatório) | Dados do inquérito (têm de conter Survey Cycle Completion Date) |
attrition_file |
caráter | (obrigatório) | Caminho para o CSV com IDs de funcionários e datas de cessação |
emp_id_col |
caráter | (obrigatório) | Coluna ID do Funcionário no ficheiro de inquérito e de atrito |
term_date_col |
caráter | (obrigatório) | Coluna de data de terminação no ficheiro de atrito |
scale_points |
inteiro | (obrigatório) | Número de pontos de escala (2–11) |
time_periods |
vetor de número inteiro | c(90, 180, 365) |
Dias após o inquérito para medir o atrito |
attribute_cols |
vetor de carateres | NULL |
Colunas de atributos pré-associadas para resultados segmentados |
min_group_size |
inteiro | 5 |
Funcionários mínimos por grupo de atributos |
plot |
lógica | FALSE |
Imprimir gráfico de barras de atrito; requer ggplot2 |
Devolve: Desarma com as colunas question, days, favorable_n, favorable_attrition, unfavorable_n, unfavorable_attrition, . attrition_ratio Quando attribute_cols é fornecido, as colunas de atributos e group_size são pré-anexadas.
analyze_by_attributes
Calcular métricas de inquérito segmentadas por grupos de atributos de funcionários. Veja Tendências, Segmentação e Hierarquia.
analyze_by_attributes(survey, attribute_file = NULL, scale_points,
attribute_cols, emp_id_col, min_group_size = 5, plot = FALSE)
| Parâmetro | Tipo | Padrão | Descrição |
|---|---|---|---|
survey |
glint_survey ou moldura de dados | (obrigatório) | Dados do inquérito (atributos pré-associados ou fornecidos via attribute_file) |
attribute_file |
caráter ou moldura de dados | NULL |
Caminho de ficheiro ou moldura de dados com atributos de funcionário; omitir se já estiver associado |
scale_points |
inteiro | (obrigatório) | Número de pontos de escala (2–11) |
attribute_cols |
vetor de carateres | (obrigatório) | Nomes de colunas a agrupar por |
emp_id_col |
caráter | (obrigatório) | Nome da coluna ID do Funcionário |
min_group_size |
inteiro | 5 |
Funcionários mínimos por grupo (salvaguarda de privacidade) |
plot |
lógica | FALSE |
Imprimir gráfico de pontos facetados; requer ggplot2 |
Devolve: Desarmate com colunas de atributos, group_sizee todas as summarize_survey() colunas.
search_comments
Pesquisa em texto completo em todas as colunas de comentários com correspondência exata ou difusa.
search_comments(survey, query, exact = FALSE, max_distance = 0.2)
| Parâmetro | Tipo | Padrão | Descrição |
|---|---|---|---|
survey |
glint_survey ou moldura de dados | (obrigatório) | Dados de pesquisa |
query |
caráter | (obrigatório) | Cadeia de pesquisa não vazia |
exact |
lógica | FALSE |
Correspondência de subcadeia literal sensível a maiúsculas e minúsculas |
max_distance |
numérico (0-1) | 0.2 |
Tolerância de correspondência difusa; ignorado quando exact = TRUE |
Devolve: Desarma com as colunas question, response, comment, topics. Devolve um tibble vazio (não é um erro) quando não são encontradas correspondências.
aggregate_by_manager
Agregar as métricas do inquérito ao nível do gestor. Veja Tendências, Segmentação e Hierarquia.
aggregate_by_manager(survey, scale_points, emp_id_col, manager_id_col,
full_tree = FALSE, plot = FALSE)
| Parâmetro | Tipo | Padrão | Descrição |
|---|---|---|---|
survey |
glint_survey ou moldura de dados | (obrigatório) | Dados de pesquisa |
scale_points |
inteiro | (obrigatório) | Número de pontos de escala (2–11) |
emp_id_col |
caráter | (obrigatório) | Nome da coluna ID do Funcionário |
manager_id_col |
caráter | (obrigatório) | Nome da coluna ID do Gestor |
full_tree |
lógica | FALSE |
Se TRUE, agregar todos os relatórios diretos e indiretos |
plot |
lógica | FALSE |
Imprimir gráfico de lollipop classificado; requer ggplot2 |
Devolve: Desarmate com as colunas manager_id, manager_name, question, team_sizee todas as summarize_survey() colunas.
Fórmula Glint Score
A Classificação Glint normaliza qualquer escala de resposta (2-11 pontos) para um intervalo de 0 a 100, correspondendo à classificação apresentada na IU Viva Glint. Todas as funções de análise que aceitam scale_points utilizam esta fórmula internamente.
Glint Score = round(((mean - 1) / (scale_points - 1)) * 100)
Exemplos:
- Média 4,2 numa escala de 5 pontos →
round(((4.2 - 1) / (5 - 1)) * 100)= 80 - Média de 3,0 numa escala de 5 pontos →
round(((3.0 - 1) / (5 - 1)) * 100)= 50 - Média de 6,5 numa escala de 7 pontos →
round(((6.5 - 1) / (7 - 1)) * 100)= 92
Limiares de favorabilidade
A classificação de favorabilidade segue as definições padrão da Viva Glint. O scale_points valor que transmite às funções de análise determina os valores de resposta que se enquadram em cada categoria.
| Pontos de dimensionamento | Favorável | Neutro | Desfavorável |
|---|---|---|---|
| 2 | 2 | — | 1 |
| 3 | 3 | 2 | 1 |
| 4 | 4 | 2, 3 | 1 |
| 5 | 4, 5 | 3 | 1, 2 |
| 6 | 4, 5, 6 | — | 1, 2, 3 |
| 7 | 6, 7 | 4, 5 | 1, 2, 3 |
| 8 | 6, 7, 8 | 4, 5 | 1, 2, 3 |
| 9 | 7, 8, 9 | 4, 5, 6 | 1, 2, 3 |
| 10 | 8, 9, 10 | 4, 5, 6, 7 | 1, 2, 3 |
| 11 | 10, 11 | 8, 9 | 1, 2, 3, 4, 5, 6, 7 |
Standard colunas
Cada exportação Viva Glint tem de conter estas oito colunas.
read_glint_survey() valida a sua presença no momento da importação e gera um erro se houver algum em falta.
| Nome da coluna | Descrição |
|---|---|
First Name |
Nome próprio do participante |
Last Name |
Apelido do participante |
Email |
Endereço de e-mail do inquirido |
Status |
Status de conclusão do inquérito |
EMP ID |
ID do Funcionário – chave de associação primária para dados de atributos e de atrito |
Manager ID |
ID do colaborador do gestor – utilizado por aggregate_by_manager() |
Survey Cycle Completion Date |
Data e hora em que o inquérito foi concluído (analisado até à data/hora) |
Survey Cycle Sent Date |
Data e hora em que o convite do inquérito foi enviado (analisado para data e hora) |