Conceito: códigos de nível, dimensão e atributo para nomes de exibição
A habilitação de nomes de exibição no Workday Adaptive Planning permite usar o mesmo rótulo para vários níveis, valores de dimensão personalizada ou valores de atributo. Este recurso:
- Simplifica o carregamento de estruturas do Workday Financials, Workday HCM ou outros sistemas externos.
- Remove a necessidade de concatenar rótulos e IDs de referência do Workday ou outras importações para tornar os rótulos exclusivos no Adaptive Planning.
- Oferece um processo de carregamento de metadados simplificado quando os rótulos correspondem.
Como habilitar nomes de exibição
Cada nível, valor de dimensão personalizada e valor de atributo recebe um código exclusivo.
O código funciona como uma chave.
Para fórmulas que incluíram nível, valor de dimensão ou valor de atributo,
code
substitui name
para evitar ambiguidade. Seus carregadores de integração funcionarão sem precisar de ajustes e usarão automaticamente o código para mapeamentos de colunas.A habilitação de nomes de exibição redefine os limites de detecção de anomalias como 40%.
Códigos de metadados
Os nomes em um nível, dimensão personalizada ou atributo, requeriam exclusividade antes da introdução de nomes de exibição.
Para instâncias preexistentes, geramos códigos automaticamente para você reutilizando os nomes já criados.
Os códigos sempre são exibidos no Workday Adaptive Planning entre colchetes, tornando-os fáceis de identificar. Exemplo: [westeu01].
Nome de exibição e formato do nome de exibição
Os nomes de exibição introduzem o campo
Nome de exibição
de somente leitura para níveis, valores de dimensão e valores de atributo. O nome de exibição funciona como o rótulo que os usuários veem nos elementos de metadados (anteriormente era o campo de nome) em todo o Workday Adaptive Planning. O nome de exibição do elemento de metadados aparece em qualquer parte quando é escolhido, selecionado ou visualizado.Para instâncias preexistentes do Workday Adaptive Planning, o
Nome
é preenchido automaticamente conforme o formato do nome de exibição. Você pode selecionar qualquer um destes formatos de nome de exibição nas páginas de administração de nível, dimensão e atributo:
- Nome
- Código
- Nome [Código]
- [Código] Nome
Você pode configurar o Formato de nome de exibição na raiz da dimensão, para cada dimensão. O código é exibido para cada valor.
Nome de exibição e Código podem conter, cada um, 2.048 caracteres ou 4.096 caracteres quando combinados.
Quando
Manter classificado
está habilitado, quaisquer alterações nos componentes de um nome de exibição podem alterar a ordem de classificação dos elementos na Administração de dimensão ou na Administração de atributos.Nomes de exibição em importações de estruturas
A importação de estruturas de nível, dimensão personalizada e atributo oferece suporte a código ao requerer as colunas Formato de nome de exibição, Código do valor e Nome do valor nos modelos de importação. A coluna Nome foi substituída pelas colunas Código do valor e Nome do valor.
Sempre baixe os novos modelos de importação e siga as instruções na primeira planilha. A introdução de nomes de exibição altera as colunas obrigatórias e os nomes das colunas nos modelos. Não reutilize modelos antigos ou de instâncias que não usam nomes de exibição.
Não use importações para alterar nomes ou códigos de níveis. Você deve fazer essas alterações manualmente no aplicativo.
Para hierarquias, indique os valores pai fazendo referência ao código pai.
Importações de estrutura requerem estas colunas para oferecer suporte a nomes de exibição:
Importação de nível
- Formato do nome de exibição do nível
- Código do nível
- Código do valor do atributo
- Nome do valor do atributo
Importação de dimensão
- Formato de nome de exibição da dimensão
- Código do valor de dimensão
- Nome do valor da dimensão
- Código do valor do atributo
- Nome do valor do atributo
Importação de atributo
- Formato de nome de exibição do atributo
- Código do valor do atributo
- Nome do valor do atributo
Importação de conta
- Código do valor do atributo
- Nome do valor do atributo
Visualizações para impressão de níveis, dimensões e atributos contêm as colunas Nome de exibição, Código do valor e Nome do valor.
Elementos de nome de exibição na integração
A introdução de códigos de metadados nas integrações do Workday Adaptive Planning auxiliam:
- No mapeamento ao ajudar os usuários a fazer associações entre elementos externos de metadados e elementos internos do Workday Adaptive Planning.
- Na exibição de informações ao ajudar os usuários da integração a diferenciar rótulos duplicados.
- Na pesquisa ao ajudar os usuários a localizar elementos específicos com base no código de metadados.
O mapeamento, a exibição e a pesquisa ocorrem durante a criação e manutenção de fontes de dados, carregadores de dados e carregadores de metadados.
Elementos de nome de exibição na fonte de dados do Planning
Quando você cria parâmetros compartilhados em uma fonte de dados do Planning, pode:
- Ver o nome de exibição e o código para níveis, valores de dimensão e valores de atributo.
- Pesquisar parâmetros compartilhados por nome de exibição ou código.
Incluir códigos em fontes gerenciadas
Com a introdução de nomes de exibição em uma instância, você pode clicar em
Gerenciar fontes
e selecionar Incluir códigos
para essas fontes, que podem conter ou filtrar por níveis, dimensões e atributos:
- Personalizadas
- Planilhas de cubo
- Planilhas de modelo
Incluir códigos
, você não pode mais desmarcá-la.As novas fontes gerenciadas que você criar após a introdução de nomes de exibição selecionam automaticamente
Incluir códigos
por padrão.Elementos de nome de exibição em carregadores da integração
Com a introdução de nomes de exibição, os carregadores de dimensão, atributo e nível mapeiam automaticamente o código nos mapeamentos de colunas. Quando você precisa mapear automaticamente as colunas, selecione Mapear automaticamente por código ou nome.
Mapeamento de colunas do carregador de dados do Planning
Quando você envia dados, eles são carregados por código em vez de por nome. Quando você mapeia colunas na guia
Mapeamento de colunas
, mapeie a Coluna de ID de origem para Código. Mapeie a coluna Nome de exibição de origem para Nome.Mapeamento de dados do carregador de dados do Planning
Quando você clica na guia
Mapeamento de dados
, pode mapear automaticamente todas as colunas ou as colunas selecionadas por:
- Coluna de ID da origem.
- Coluna de nome de exibição da origem.
Quando você baixa os mapeamentos usando a guia
Mapeamento de dados
, o modelo usa o código na coluna ID da origem. Quando você carrega mapeamentos, o modelo espera o código na coluna ID da origem.Configurações de fonte de dados do carregador de dados do Planning
A guia Configurações de fonte de dados do carregador de dados do Planning contém uma seção de mapeamento automático. Essa seção permite, como opção, mapear automaticamente quaisquer contas, níveis ou valores de dimensão novos, em tempo de execução do carregador. Mapear automaticamente os níveis e Mapear automaticamente as dimensões oferecem suporte a código com opções para:
- Mapear automaticamente a ID de origem para Código.
- Mapear automaticamente o nome de exibição de origem para Código.
Elementos de nome de exibição em APIs
Com a introdução de nomes de exibição, suas APIs podem oferecer suporte a metadados
code
se:
- Usa a API v30 ou superior na chamada.
- Você inclui odisplayNameEnabled=1parâmetro nodimensionselemento,attributeselemento elevelselemento.
displayNameEnabled=0
para um elemento desabilita os nomes de exibição para esse elemento, impedindo o uso de code
e usos name
em vez disso.Essas APIs em massa suportam
code
quando você habilita os nomes de exibição, mas todos usam a ID como chave:
- updateAttributes
- updateDimensions
- updateLevels
- importDimensionMapping
Essas APIs de dados oferecem suporte
code
com a introdução de nomes de exibição:
- eraseData
- exportConfigurableModelData
- exportData
- importConfigurableModeleData
- importStandardData
- importCubeData
- importTransactions
Para obter mais detalhes sobre o uso de elementos de nome de exibição em solicitações e respostas, consulte a página de documentação de cada API.
Etiquetagem de atributo de API de metadados em massa nas APIs v32 e v33
Essas APIs em massa suportam
valueCode
e valueName
para API v32 e API v33 com a introdução de nomes de exibição e uso displayNameEnabled=1
:
- updateLevelssuportevalueCodeevalueNamenadimensioneattributeelementos.
- updateAccountssuportevalueCodeevalueNamenaattributeelemento.
- updateDimensionssuportevalueCodeevalueNamenaattributeelemento.
- exportLevelssuportevalueCodeevalueNamenadimensioneattributeelementos.
- exportAccountssuportevalueCodeevalueNamenaattributeelemento.
- exportDimensionssuportevalueCodeevalueNamenaattributeelemento.
name
no elemento atributo.APIs de metadados únicos
Estas APIs de metadados únicos não oferecem suporte a nomes de exibição:
- updateDimension
- updateDimensionValue
- updateLevel
- createDimension
- createDimensionValue
- createLevel
Elementos de nome de exibição em fórmulas
Com a introdução de nomes de exibição, você deve usar código quando faz referência a um nível, valor de dimensão personalizada ou valor de atributo em uma fórmula. O nome de exibição é exibido em qualquer lugar em que o nome era mostrado anteriormente no assistente de fórmulas.
O seletor de elemento do assistente de fórmula gera resultados da pesquisa com base no nome de exibição e no código. Somente o código de um elemento se torna parte da fórmula.
Elementos de nome de exibição e fórmula com notação de ponto para propriedades
A introdução de nomes de exibição aciona o uso de
code
na fórmula, notação de ponto para propriedades. Quando você constrói fórmulas usando notação de ponto para propriedades, pode fazer referência a níveis, valores de dimensão personalizada e valores de atributo por code
.Para notação de ponto, você deve alterar manualmente qualquer
.name
referências a .code
com a introdução de nomes de exibição.Você não pode usar o nome de exibição em notação de ponto porque isso não garante exclusividade durante o cálculo.
Se você altera o formato do nome de exibição após o uso de fórmulas para cálculos personalizados em relatórios, reveja essas fórmulas para garantir a exatidão.
Elementos de nome de exibição em planilhas
Com a introdução de nomes de exibição, você tem duas opções para baixar dados de planilha modelada:
- Baixar: exporta os códigos de níveis, valores de dimensão e valores de atributo na planilha. Use essa opção se você planeja importar os dados de volta para a planilha modelada.
- Visualização para impressão: exporta o nome de exibição configurado de níveis, valores de dimensão e valores de atributo. Use essa opção se quiser que a planilha corresponda àsOpções de exibiçãoatuais. Você não pode importar essa versão da planilha.
Para selecionar uma destas opções:
- Quando você abre planilhas modeladas em Visão geral de planilhas, clique na seta ao lado do botãoBaixar.
- Quando você abre planilhas modeladas em um painel, clique no íconeMais.
Para planilhas padrão e de cubo, a opção
Baixar
continua a exportar os nomes de exibição de níveis, valores de dimensão e valores de atributo. Também continua a fazer a correspondência com as Opções de exibição
definidas na planilha.Elementos de nome de exibição em relatórios
Os construtores de relatórios apresentam elementos de metadados por nome de exibição usando o formato de nome de exibição selecionado em:
- Relatórios de matriz
- Relatórios modelo
Quando você visualiza os relatórios, os elementos são carregados usando os nomes de exibição. Quando você constrói relatórios arrastando elementos para um construtor, apenas o nome de exibição é exibido.
O assistente de fórmula do relatório de matriz exibe elementos no seletor por nome de exibição. As fórmulas em cálculos personalizados sempre usam o código para os elementos selecionados.
Os filtros de relatório modelo usam o nome de exibição.
Elementos de nome de exibição em atualizações de nível vinculado
Com a introdução de nomes de exibição em instâncias pai e filho em um ambiente com várias instâncias, as atualizações de nível vinculado substituem os nomes por nomes de exibição.
Nomes de exibição no OfficeConnect
Para todos os elementos do relatório do OfficeConnect, fornecemos o valor do tipo de rótulo do Nome de exibição nas definições de rótulo. Esse valor de tipo de rótulo oferece suporte a nomes de metadados duplicados no Adaptive Planning.
Modelos de importação
Os formatos de modelo de importação e as instruções em indicam a necessidade de códigos como identificadores exclusivos em importações para:
- Importação de dados padrão
- Importação de dados de planilha modelada
- Importação de dados de planilha de cubo
- Importação de dados de transação
Quaisquer colunas de dimensão divididas em duas colunas:
- Código da dimensão
- Nome da dimensão
A coluna Nome da dimensão é opcional. Se essa coluna não existe, o Código da dimensão se torna o Nome da dimensão. Podem existir valores duplicados de Nome da dimensão se os códigos da dimensão variarem.
Os cabeçalhos de coluna de níveis indicam:
- Código do nível
Os cabeçalhos de coluna de contas oferecem suporte a qualquer um dos seguintes como rótulo:
- Código da conta
- Conta
You can select
Import without Code and Name columns for display names
to import templates without columns for Code and Name fields. This option also allows importing from older templates created before the introduction of display names. When you turn on Enable Single Column Data Import/Export for Display Name
in General Setup
, we apply Import without Code and Name columns for display names
across the application and hide the option in the Import page.