Melhores práticas para hierarquias organizacionais (Studio)

Sobre hierarquias organizacionais no XM Descubra as melhores práticas

Esta página fornece exemplos de definição de níveis organizacionais, mapeamento de filtros de dados para níveis organizacionais, mapeamento de usuários para níveis organizacionais e mapeamento de parâmetros de enriquecimento para níveis organizacionais nos formatos MS Excel e CSV, juntamente com melhores práticas e dicas de solução de problemas ao definir hierarquias organizacionais no XM Discover.

Definição dos exemplos de níveis organizacionais

Você pode definir seus níveis organizacionais usando arquivos MS Excel ou CSV.

Exemplo de formato MS Excel

A Acme opera 4 hotéis, 2 em Chicago e 2 em Detroit. Este é um exemplo de como a estrutura Acme Hotels é definida usando o modelo MS Excel:

• As linhas 1 a 6 contêm instruções para a utilização do modelo MS Excel.

• Cada célula na Linha 7 indica um nível da hierarquia organizacional, do nível mais alto (A7) ao nível mais baixo (J7).
  Atenção: ao definir níveis de hierarquia, pelo menos uma coluna deve conter os nomes dos níveis de hierarquia.

  O número máximo de níveis hierárquicos é 10.

• Cada linha, começando a partir da Linha 8, indica um nível organizacional onde um ou mais filtros devem ser aplicados.
  Qdica: os itens do menu de personalização seguirão a ordem das linhas definidas neste arquivo.

  Qdica: o nível mais alto da hierarquia da sua organização deve refletir a organização geral que você está tentando capturar, em vez de qualquer uma de suas ramificações. Por exemplo, se você criar um nível organizacional ACME ou ALL no topo, isso permitirá que você atribua usuários que poderão ver todos os níveis inferiores.

Exemplo de formato CSV

Este é um exemplo de como a estrutura de amostra do Acme Hotels é definida em um arquivo CSV:

• Os nomes dos níveis na estrutura de relatórios da organização são mostrados na Linha 1, começando com o nível mais alto.
  Atenção: o número máximo de níveis hierárquicos é 10.

• Cada linha, começando a partir da Linha 2, indica um nível organizacional onde um ou mais filtros devem ser aplicados.

• As colunas são separadas por uma vírgula.

  Atenção: todas as linhas devem ter o mesmo número de colunas.

  Qdica: os itens do menu de personalização seguem a ordem das linhas definidas neste arquivo.

Exemplos de mapeamento de filtros de dados para níveis organizacionais

Você pode fornecer mapeamento de filtros de dados em 1 destes formatos: MS Excel ou CSV.

Exemplo de formato MS Excel

É assim que os filtros devem ser mapeados no MS Excel, com base no exemplo da Acme Hotels:

• A coluna A é gerada automaticamente com base em entradas para a estrutura organizacional.

• A coluna B contém o fornecedor de conteúdo (B7) e o projeto (B8) selecionados ao baixar o modelo.

• As restantes linhas na Coluna B são filtros definidos manualmente que correspondem a cada nível organizacional.

Exemplo de formato CSV

É assim que os filtros devem ser mapeados em um arquivo CSV, com base no exemplo do Acme Hotel:

• O arquivo deve conter 2 colunas, separadas por uma vírgula.
  Atenção: todas as linhas devem ter o mesmo número de colunas, na mesma ordem.

• A linha 1, coluna 1 deve conter a frase “Hierarquia de organização”.

• A linha 1, coluna 2 deve conter o nome do fornecedor de conteúdo.

• Linha 2, coluna 1 deve conter nomes de níveis hierárquicos separados pela seta “–>”.
  Exemplo: Empresa –> Cidade –> Hotel.

• A linha 2, coluna 2 deve conter o nome do projeto.
  Exemplo: Acme Hotels

• O resto das linhas a partir da Linha 3 é onde você mapeia um filtro para cada nível hierárquico.

• A linha 3, coluna 1 deve conter o caminho completo para um nível de hierarquia.
  Exemplo: Acme Hotels

• A coluna 2 deve conter a definição do filtro
  Exemplo: ALL

• Cada um dos caracteres entre aspas duplas incorporados deve estar entre aspas duplas.

Tipos de filtro

Você pode definir os seguintes filtros:

• Filtrar por atributos estruturados: 
  • Para definir um nível organizacional utilizando atributos estruturados, utilize a mesma sintaxe que faria nas linhas de regra de categoria do Designer.
    Exemplo: Use o seguinte filtro para filtrar dados por marca:
    BRAND_DESC:”hotéis acme”
  • Se você quiser definir várias condições de filtro (com uma relação OU), elas precisam ser separadas por vírgulas.
    Exemplo: BRAND_DESC:”acme hotels”, BRAND_DESC:”comfy hotels”
• Filtrar por uma consulta do Word: para definir um nível organizacional usando uma consulta de palavra, use a mesma sintaxe que faria nas seções de regra de categoria do Designer.
  Exemplo: Você pode usar qualquer um dos seguintes filtros:
  Acme
  acme, east
  ((“acme”) AND (“east”))
• Mostrar todos os dados: para mostrar todos os dados de um determinado nível, digite ALL em uma célula.
• Mostrar sem dados: para não mostrar dados de um determinado nível, digite NONE em uma célula ou deixe-a em branco. Todas as células de filtro vazias serão preenchidas automaticamente com o caractere de preenchimento “NENHUM” depois que você carregar um arquivo.

Exemplos de mapeamento de usuários para níveis organizacionais

Você pode fornecer mapeamentos de usuário em 1 destes formatos: MS Excel ou CSV.

Exemplo de formato MS Excel

Este é um exemplo de como os e-mails de usuário são mapeados no MS Excel:

• A coluna A é gerada automaticamente com base em entradas para a estrutura organizacional.
• Forneça endereços de e-mail de usuário do Studio para o nível de hierarquia correspondente na coluna B. Você pode digitar vários e-mails separados por vírgula em uma célula.

Exemplo de formato CSV

​​Este é um exemplo de como os e-mails de usuário são mapeados em um arquivo CSV:

• O arquivo deve conter 2 colunas, separadas por uma vírgula.

• Linha 1, coluna 1 deve conter nomes de níveis hierárquicos separados pela seta “–>”.
  Exemplo: Empresa –> Cidade –> Hotel.

• A linha 1, coluna 2 deve conter a frase “Endereços de e-mail do Studio”.

• O resto das linhas, começando pela linha 2, é onde você mapeia e-mails de usuário do Studio para cada nível de hierarquia.

Como funciona o mapeamento de usuários

• Somente usuários registrados do Studio podem ser mapeados.
• O mapeamento de um usuário para um nível superior automaticamente dá acesso a todos os níveis inferiores.
  Qdica: Adicione analistas e outros usuários avançados ao nível superior para acesso total.
• Se um usuário não for identificado na hierarquia, ele não verá dados em um dashboard personalizado e encontrará uma mensagem de erro.
• Você pode atribuir o mesmo usuário a vários níveis diferentes e, nesse caso, o usuário poderá alternar entre os níveis usando os botões para cima e para baixo no painel de controle da hierarquia organizacional.
• Ao abrir um dashboard personalizado pela primeira vez, os usuários atribuídos a vários níveis diferentes na hierarquia verão inicialmente o primeiro nível ao qual estão atribuídos (indo de cima para baixo no arquivo do Excel).
• Nas visões subsequentes, os usuários verão o nível que visualizaram por último para essa hierarquia da organização.

Mapeando parâmetros de enriquecimento para exemplos de níveis organizacionais

Você tem a opção de fornecer o mapeamento de enriquecimentos em 1 destes formatos: MS Excel ou CSV.

Exemplo de formato MS Excel

Forneça parâmetros de aprimoramento para cada nível organizacional usando o seguinte formato:

• Forneça o nome do seu primeiro parâmetro de enriquecimento na linha 5, coluna B.

• Forneça os valores do seu primeiro parâmetro de enriquecimento começando com a linha 6, coluna B, de modo que cada valor corresponda a um nível organizacional correspondente na coluna A.
  Qdica: você pode mapear até 6 colunas com enriquecimentos para o nível de hierarquia correspondente.
  Qdica: se necessário, forneça mais parâmetros de enriquecimento usando

  Colunas C, D, E, F e G.

  Qdica: somente parâmetros numéricos estarão disponíveis para relatório.

Exemplo de formato CSV

• Linha 1, coluna 1 deve conter nomes de nível hierárquico separados pela seta “–>”.
  
  Qdica: as colunas de 2 a 7 devem conter os nomes dos parâmetros de enriquecimento.
  Qdica: o número máximo de parâmetros de enriquecimento é 6.

• O resto das linhas, começando pela Linha 2, é onde você fornece valores de parâmetro de enriquecimento para cada nível de hierarquia.

• Linha 2, Coluna 1 deve conter o caminho completo para um nível de hierarquia. Qdica: separe as colunas por vírgula.

Solução de problemas de definição de hierarquias de organização

Solução de problemas na definição da estrutura organizacional

• O arquivo contém linhas duplicadas: remover linhas duplicadas.
• Cabeçalho incorreto especificado no arquivo de estrutura: remova os cabeçalhos que não têm valores. Certifique-se de que a estrutura segue o formato correto.
• A organização não pode ter mais de 10 níveis de profundidade: certifique-se de que sua hierarquia não contenha mais de 10 níveis.

Mapeamento de filtros de dados

• O caminho especificado na coluna esquerda não existe na hierarquia: remova o caminho que não está presente na hierarquia ou adicione o caminho ao definir a estrutura organizacional.
• Por favor, feche todas as aspas: Use aspas fechadas.
• As declarações de campo (:) devem ser precedidas por pelo menos um alfabeto ou número e seguidas por pelo menos um alfabeto ou número: Certifique-se de que as definições de filtro sigam o formato correto.
• Os parênteses devem ser fechados: use um parêntese de abertura e um de fechamento.
  Exemplo: (:).
• Os caracteres permitidos para as regras do filtro são a-z A-Z 0-9. _ + – : () ” & * ? | ! {} [ ] ^ ~ @ = # % $ ‘ . : Remova os filtros que utilizam caracteres especiais ou substitua-os por um curinga de um caractere único (?).
• As cotações devem conter pelo menos um caractere: remova os filtros que contêm aspas vazias.

Mapeamento de usuários

• O caminho especificado na coluna esquerda não existe na hierarquia: remova o caminho que não está presente na hierarquia ou adicione o caminho ao definir a estrutura organizacional.
• Erro de sintaxe no endereço de e-mail: certifique-se de que os e-mails que você forneceu são válidos.
• O caminho de hierarquia está presente mais de uma vez: certifique-se de que cada caminho de hierarquia esteja presente apenas uma vez.

Parâmetros de enriquecimento de mapeamento

• O caminho especificado na coluna da esquerda não existe na hierarquia: remova o caminho que não está presente na hierarquia ou adicione-o ao definir a estrutura organizacional.
• Excede o número de parâmetros permitidos: certifique-se de que sua hierarquia não contenha mais de 6 parâmetros de enriquecimento.
• Nomes de parâmetros repetidos: certifique-se de que os nomes dos parâmetros de aprimoramento são exclusivos.