Ir para o conteúdo principal
Documentação
Documentação
Adaptive Planning
Última atualização: 2023-06-23
Criar carregadores de dimensões do Planning

Criar carregadores de dimensões do Planning

Os carregadores de metadados sincronizam informações hierárquicas dos sistemas de origem com as hierarquias do modelo de planejamento. Antes de iniciar a sincronização, verifique se você já criou as hierarquias no seu sistema de origem.
As solicitações do carregador de dimensões do Planning atualizam no máximo 10 mil valores de dimensão em uma dimensão hierárquica ou 40 mil valores de dimensão em uma dimensão simples. Esses limites não se aplicam à criação de novos valores de dimensão em uma solicitação para o carregador.
O carregador de dimensões do Planning permite mapear metadados sobre valores de dimensão da área de preparação para o
Adaptive Planning
. A principal vantagem de usar o carregador de dimensões do Planning é que ele permite importar valores de dimensões em massa, em vez de criá-los um de cada vez em Modelagem > Gerenciamento de modelos > Dimensões. Depois de criar um carregador, você pode executá-lo manualmente ou programá-lo para ser executado como parte de uma tarefade integração.

Para criar um carregador de dimensões do Planning, siga este fluxo:
  1. Inserir as configurações de fonte de dados
  2. Configurar mapeamento de colunas
  3. Criar regras de negócios
  4. Pré-visualizar a saída do carregador
  5. Executar ou programar o carregador

Antes de começar

O carregador de dimensões do Planning requer dados de preparação da importação de uma fonte de dadosexistente.

Inserir as configurações de fonte de dados

As configurações de fonte de dados permitem que você escolha qual tabela de origem dos dados de preparação quer usar, selecione para qual dimensão do Planning os dados serão carregados e indique se os novos valores de dimensão devem ou não ser criados automaticamente.
  1. Navegue até
    Integração > Design de integrações
    .
  2. Clique em
    Criar novo carregador
    na área Carregadores da Biblioteca de componentes.
  3. Selecione
    Carregador de dimensões do Planning
     como o tipo de carregador. Insira um nome para o carregador.
  4. Clique em
    Criar
    .
Prática recomendada: clique em
Salvar
no painel Ações para salvar com frequência enquanto cria e edita o carregador. Você pode descartar as alterações não salvas clicando em
Fechar
 e em
Não
.
Insira as informações de propriedades gerais do carregador de dimensões do Planning:
  • Tabela de origem:
     selecione a tabela de origem na lista suspensa. A lista contém todas as tabelas de origem disponíveis na área de preparação às quais você tem acesso.
  • Dimensão do Planning:
     escolha a dimensão para a qual a origem será carregada. As dimensões listadas vêm de Modelagem > Gerenciamento de modelos > Dimensões.
  • Criar valor de dimensão se não for encontrado no Planning:
     marque a caixa para criar automaticamente novos valores de dimensão encontrados no sistema de origem, mas não encontrados em Modelagem > Gerenciamento de modelos > Dimensões. Se esta opção não é marcada, somente as atualizações nos valores de dimensão existentes são executadas e nenhuma nova dimensão é criada.
    • Se a dimensão na qual você carrega não tem a opção "A importação de dados cria automaticamente valores de dimensão" habilitada em Modelagem > Gerenciamento de modelos > Dimensões, o carregador avisa.
  • Nível de registro
    : escolha o tipo de detalhe a ser capturado ao executar o carregador.
    • Erro
      :
       registra somente erros graves.
    • Informações
      :
       registra informações básicas, como por exemplo, a data em que o carregador foi atualizado.
    • Detalhado
      :
       apresenta informações detalhadas sobre todas as fases e ações. Este nível é usado principalmente para depuração ou auditoria, pois pode produzir mais informações de registro do que as necessárias para o uso geral.

Configurar mapeamento de colunas

O mapeamento de colunas permite mapear colunas da fonte de dados para valores de dimensão disponíveis em Modelagem > Gerenciamento de modelos > Dimensões.
Se houver várias colunas a serem mapeadas, use o filtro
Mostrar
para selecionar:
  • Todos
    : mostra todas as colunas do Planning.
  • Obrigatório
    : mostra todas as colunas obrigatórias do Planning.
  • Não mapeados
    : mostra todas as colunas não mapeadas do Planning.
  • Mapeados
    : mostra todas as colunas mapeadas do Planning.
Você pode usar o campo
Pesquisar
para localizar as colunas. Digite um nome completo ou parcial para pesquisar e clique na lupa. Todas as colunas de preparação que corresponderem à pesquisa aparecem nos resultados.
Mapear colunas
  1. Clique em
    Mapeamento de colunas
    .
    A guia Mapeamento de colunas contém:
    • Status
      : indica se uma coluna do Planning foi mapeada. A marca de seleção Coluna mapeada indica uma coluna mapeada. Um ponto de exclamação Coluna não mapeada indica uma coluna não mapeada.
    • Coluna do Planning
      : exibe todas as colunas do Planning disponíveis para mapeamento em uma planilha. A lista de colunas do Planning inclui um conjunto de colunas obrigatórias, seguidas por todas as outras colunas. As colunas obrigatórias do Planning são indicadas por texto em negrito, com um asterisco, e incluem uma coluna de valor. As colunas não obrigatórias incluem Nome curto e Descrição.
    • Coluna de origem
      : exibe as colunas na tabela de preparação escolhida nas configurações da fonte de dados.
  2. Selecione uma coluna não mapeada e clique no menu suspenso. Na lista suspensa, escolha a coluna para a qual você quer mapear. À medida que você mapeia as colunas, o indicador de status muda de vermelho IntegrationMappingUnmapped.png para verde IntegrationMappingMapped.png.
Quando a opção
A importação de dados cria automaticamente valores de dimensão
 está habilitada, você pode mapear os atributos por código. O nome do atributo se torna automaticamente o código.
Consulte Exemplo: carregar valores de dimensão de fontes de dados de planilha para obter um exemplo de como os valores de dimensão e seus pais são mapeados para o Planning.
Alterar nomes de valores de dimensão do Planning no carregamento
Para alterar o nome de um valor de dimensão do Planning no carregamento:
  1. Selecione a Coluna de origem que identifica de forma exclusiva o valor da dimensão na origem.
  2. Mapeie a coluna de ID para a ID do valor da dimensão.
  3. Mapeie o nome para o nome do valor da dimensão.
Cancelar mapeamento de colunas
Para cancelar o mapeamento de colunas, clique em
Cancelar mapeamento
e escolha:
  • Cancelar mapeamento de todos os itens
    :
     cancela o mapeamento de todas as colunas.
  • Cancelar mapeamento dos itens selecionados
    :
     cancela o mapeamento apenas das colunas selecionadas.
O cancelamento do mapeamento de uma coluna altera o ícone de status do mapa para vermelho IntegrationMappingUnmapped.png.
Mapear atributos associados a dimensões de listas
Você pode associar atributos a uma dimensão de uma lista mapeando colunas de uma importação de fonte de dados.
A associação de atributos a dimensões só é possível para dimensões de listas. Você não pode associar atributos a dimensões hierárquicas.
Em
Adaptive Planning
 Você pode acessar
Gerenciamento de modelos
 >
Dimensões
 e clicar em uma dimensão para visualizar os detalhes e descobrir se é uma dimensão de lista.
Em Configurações de fonte de dados, selecione uma dimensão de lista como
Dimensão do Planning
.
Os atributos ficam disponíveis como colunas no mapeamento de colunas porque é uma dimensão de lista.
Como as dimensões de lista não são hierárquicas, parentId não é uma opção para a coluna de origem.

Download e carregamento de mapeamentos

Você pode baixar, modificar e carregar mapeamentos para que os carregadores resolvam rapidamente os erros de mapeamento. Os carregamentos executam uma ação do tipo tudo ou nada, substituir tudo. No carregamento, use apenas uma planilha de mapeamentos dos processos de arquivo. Se você usar planilhas de mapeamentos adicionais, ocorrerão erros e o carregamento será cancelado.
  1. Clique em
    Baixar mapeamentos de membros
     no painel
    Ações
    .
  2. Baixe o arquivo .XLSX. Você receberá um e-mail ou uma notificação do Workday com um link para baixar o arquivo de mapeamentos.
  3. Abra o arquivo e procure os valores da tabela de preparação na planilha de mapeamentos que está causando erros.
    Todas as células marcadas (INVÁLIDO) nas colunas
    Código do Planning
     ou
    Nome do Planning
     indicam que este código não existe mais no Workday Adaptive Planning.
  4. Corrija os erros e clique em
    Carregar mapeamentos de membros
     para carregar o arquivo. A coluna
    Somente leitura
     não é carregada.
  5. Execute o carregador novamente.
Não clique em
Limpar mapeamentos de membros
, a menos que seja instruído pelo parceiro de implementação ou pelo suporte do Workday Adaptive Planning.

Criar regras de negócios

Você pode usar
Regras de negócios
 para criar expressões SQL que limitam os dados de preparação estão disponíveis para carregamento. Somente os registros que atendem aos seus critérios de filtro serão carregados.
Para criar um filtro SQL:
  1. Na guia
    Regras de negócios
    , selecione
    Filtro SQL
    . Clique em
    Editar
    .
  2. Insira uma expressão SQL. Você pode clicar em um item na lista Colunas disponíveis para trazer essa coluna para a expressão SQL em vez de digitá-la.
  3. Clique em
    Aplicar
     para verificar a sintaxe SQL. Se houver erros na sua sintaxe, a borda ao redor da expressão se tornará vermelha. Posicione o cursor do mouse sobre o editor de SQL para ver as informações do erro de sintaxe.
    Para obter ajuda detalhada sobre sintaxe SQL, clique em
    Ajuda on-line
     na seção Observações de Editar filtro SQL. Você também pode visitar a Referência da expressão SQL.
  4. Corrija os erros na sintaxe e clique em
    Aplicar
    . Somente as linhas de preparação que correspondem à expressão SQL são importadas quando você executa o carregador.

Pré-visualizar a saída do carregador

Você pode pré-visualizar a saída do carregador antes de executar um carregamento completo para verificar se os mapeamentos estão corretos. Você também pode baixar a saída como um arquivo XML para verificar manualmente os valores de dimensão de sua fonte de dados em relação aos requisitos antes de carregá-las.
  1. Clique em
    Pré-visualizar saída do carregador
     no painel Ações
  2. (Opcional) Insira as configurações de Pré-visualizar saída do carregador. As informações que você pode inserir variam de acordo com a fonte de dados que você escolheu para esse carregador de dimensões do Planning. As alterações nas configurações feitas aqui levam à importação de novos dados nas tabelas e colunas de preparação.
  3. Clique em
    Pré-visualizar saída do carregador
    .
O carregador é executado, aplicando todas as transformações e regras de negócios. Um pop-up de status exibe as etapas que o carregador executou. Se houver valores de dimensão a serem carregados, o carregador criará um arquivo XML e enviará uma notificação por e-mail com a saída do carregador como um anexo XML compactado.
Um pop-up adicional permite baixar a pré-visualização da saída do carregador como um arquivo XML compactado depois que o carregamento é concluído com sucesso. O pop-up de download pode demorar para aparecer, dependendo do número de valores de dimensão e do tamanho do arquivo.
Corrigir erros de validação
Depois que os valores de dimensão são carregados, os dados de origem são validados quanto aos seguintes erros:
  • O valor de ID de origem para o valor da dimensão está ausente (vazio) nos dados.
  • Existem IDs de origem duplicadas nos dados. As IDs de origem devem ser exclusivas.
  • Um nome de valor de dimensão está ausente (vazio) nos dados.
  • Existem nomes de valor de dimensão duplicados nos dados.
  • A ParentId é igual à ID de origem nos dados. Nesse caso, a coluna está se referindo a si mesma como seu próprio pai.
  • Ao importar uma subárvore, a raiz da subárvore é mapeada para um nó existente no Planning. Nesse caso, a parentID não está nos dados de origem de um novo nó introduzido no Planning.
  • Um nó existente foi movido sob um novo nó, e o indicador Criar novo está desabilitado. Nesse caso, um valor de dimensão existente está sendo movido para um novo nó, mesmo que o carregador tenha sido informado explicitamente para não criar novos valores de dimensão.
  • Os dados têm uma referência cíclica na hierarquia. Nesse caso, uma ParentId está se referindo a seu próprio filho como pai.

Executar o carregador

Depois de salvar um carregador de dimensões do Planning com todas as definições de configuração obrigatórias, o carregador pode ser executado manualmente ou como uma tarefa de integração programada.
Aguarde cerca de 15 a 30 minutos entre cada execução do carregador de dimensões do Planning para que o
Adaptive Planning
 tem tempo para sincronizar com a importação. Importações maiores demoram mais para sincronizar. O tempo de espera depende do tamanho do modelo e de outros fatores.
Você pode importar diretamente do sistema de origem ou pode executar o carregador usando valores de preparação que já foram importados. Quando o carregador for executado, selecione qual comportamento você quer. Escolha
Ignorar importação de dados
para usar a tabela de preparação existente para carregamento. A opção Ignorar importação de dados não está disponível quando você usa planilhas como fontes de dados.
Como parte do processo de execução, o carregador verifica se os dados na tabela de preparação foram mapeados corretamente. Várias validações são aplicadas durante o carregamento. Todos os erros que ocorrem durante o carregamento indicam o que precisa ser resolvido para obter uma importação bem-sucedida.
Incluir o carregador de dimensões do Planning em uma tarefa de integração
Qualquer tarefa de integração pode conter um ou mais carregadores. Uma tarefa também pode conter outras tarefas de integração, bem como carregadores de métricas do Discovery e carregadores de scripts.
Prática recomendada: tenha uma tarefa de integração separada para cada carregador.
Se uma tarefa contém vários carregadores, os parâmetros de cada carregador são apresentados quando a tarefa é executada. Se um parâmetro comum/compartilhado é usado nos carregadores de uma tarefa, ela solicita o parâmetro somente uma vez. Você pode optar por substituir as listas de opções do parâmetro.
Para execuções programadas da tarefa, são usados os valores padrão dos parâmetros armazenados quando os carregadores foram criados.
Como solucionar problemas de mensagens e avisos
Para obter uma explicação das mensagens registradas durante um carregamento, consulte Referência: mensagens de registro para carregadores de dimensões do Planning.

Carregar alterações em um valor da dimensão de origem

O carregador de dimensões do Planning pode renomear um valor de dimensão no carregamento se encontrar um mapeamento estabelecido para o valor da dimensão de origem.
A tabela abaixo ilustra os mapeamentos que o carregador já estabeleceu. O valor da dimensão de origem "EUA" está mapeado para a coluna ID da origem "1001".
Valor de dimensão do Planning
Coluna ID da origem
Valor da dimensão de origem
EUA
1001
EUA
Canadá
1002
Canadá
No sistema de origem, se "EUA" é alterado para "Estados Unidos", o carregador de dimensões do Planning pode aplicar essa alteração no carregamento porque o carregador mantém o mapeamento entre a coluna ID da origem "1001" e a ID interna do Planning para o valor da dimensão "EUA".
Valor de dimensão do Planning
Coluna ID da origem
Valor da dimensão de origem
EUA
1001
Estados Unidos
Canadá
1002
Canadá
A execução do carregador altera o valor de dimensão no Planning de "EUA" para "Estados Unidos".