Ir para o conteúdo principal
Documentação
Documentação
Adaptive Planning
Última atualização: 2023-06-23
Criar carregadores de níveis do Planning

Criar carregadores de níveis 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.
O carregador de níveis do Planning permite mapear metadados sobre hierarquias organizacionais da área de preparação para o
Adaptive Planning
Use o carregador de níveis do Planning para importar níveis em massa, em vez de criá-los um de cada vez no administrador de níveis. Depois de criar um carregador, você pode executá-lo manualmente ou programá-lo para ser executado como parte de um
Integração
 tarefa.
Assista ao vídeo:
 1min36s

Etapas básicas

  • Inserir as configurações de fonte de dados
  • Configurar mapeamento de colunas
  • Criar regras de negócios
  • Pré-visualizar a saída do carregador
  • Executar ou programar o carregador

Pré-requisitos

O carregador de níveis do Planning requer dados de preparação da importação de uma fonte de dados existente. Anote qual fonte de dados você quer usar.
Permissões obrigatórias: Operador de integração, Designer de dados

Navegação

Compass.png No menu de navegação, acesse
Integração
Design de integrações
.

Inserir as configurações de fonte de dados

As configurações de fonte de dados permitem que você escolha a tabela de origem que quer usar dos dados de preparação da integração e indique se quer criar níveis automaticamente.
Prática recomendada: salve com frequência enquanto cria e edita o carregador. Clique em
Salvar
 no painel Ações. Para descartar as alterações não salvas, clique em
Fechar
 e depois em
Não
.
  1. Clique em
    Criar novo carregador
    na seção Carregadores da Biblioteca de componentes.
  2. Selecione
    Carregador de níveis do Planning
     como o tipo de carregador. Insira um nome para o carregador.
  3. Clique em
    Criar
    .
  4. Insira as informações de propriedades gerais do carregador de níveis 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.
    • Criar nível, se não encontrado no Planning
      : marque para criar automaticamente novos níveis encontrados no sistema de origem, mas não encontrados em
      Modelagem
      Gestão de modelos
      Níveis
      . No modelo, desmarque a opção de atualizar somente níveis existentes.
    • Propagar atualizações de nível que sejam aplicáveis aos filhos
      :
      marque para
      atualizar níveis filho se a alteração envolve uma propriedade em cascata. Se esta opção é desmarcada, somente o nível atualizado explicitamente é alterado.
    • Excluir itens do fluxo de trabalho quando desabilitá-lo
      :
      marque para excluir
      itens no fluxo de trabalho se você desabilitar fluxos de trabalho. Se esta opção é desmarcada, os itens do fluxo de trabalho não são excluídos quando o fluxo é desabilitado.
    • Excluir valores reais inacessíveis quando atualizar a disponibilidade do nível
      : se a data de início ou término dos valores reais em um nível é alterada para torná-los inacessíveis, exclui os dados reais que não podem ser acessados.
    • Publicar alterações pendentes de publicação do administrador
      : se Conceito: publicação de administrador tem alterações de fluxo de trabalho pendentes, marque para publicar as alterações.
    • Manter ordem no Planning
      : selecione para manter a ordem de classificação de nível existente já usada no Adaptive Planning.
    • Prosseguir com avisos
      : selecione essa opção para continuar o carregamento quando surgirem mensagens de aviso.
    • Nível de registro
      : escolha o tipo de detalhe a ser capturado ao executar o carregador.
      • Desativado
        : não registra erros.
      • Erro
        : registra somente erros graves.
      • Informações
        : registra informações básicas, como por exemplo, a data em que o carregador foi atualizado.
      • Detalhado
        : registra informações detalhadas sobre todas as fases e ações. Usado principalmente para depuração ou auditoria.

Configurar mapeamento de colunas

O mapeamento de colunas permite mapear colunas da fonte de dados para níveis disponíveis em
Modelagem
Gestão de modelos
Níveis
. Você pode cancelar o mapeamento de colunas para ignorar os dados de preparação que não quer carregar. Você também pode cancelar o mapeamento de colunas, uma de cada vez, após as execuções do carregador para saber quais colunas geraram os erros nos registros.
A única maneira de obter uma lista das IDs de nível existentes é usando a API exportLevels . A ID do nível não aparece em nenhum lugar da interface de usuário do aplicativo. A coluna ID de origem dos níveis torna-se ID do nível quando o carregamento é executado.
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, como ID pai e Nível.
  • Não mapeados
    : mostra todas as colunas não mapeadas do Planning.
  • Mapeados
    : mostra todas as colunas mapeadas do Planning.
Use
Categoria
para selecionar:
  • Detalhes do nível
    : mostra as colunas relacionadas aos detalhes do nível, incluindo Nome curto, Moeda e No fluxo de trabalho. O valor de No fluxo de trabalho deve ser um valor booliano de 1 para verdadeiro ou 0 para falso.
  • Configurações de eliminação
    : mostra as colunas relacionadas a configurações de eliminação, incluindo nível de eliminação e parceiro comercial de eliminação. Esses valores boolianos devem ser 1 para verdadeiro ou 0 para falso.
  • Configurações da versão
    : mostra as colunas relacionadas a configurações da versão, incluindo início e término dos valores reais. Esses valores devem estar nos formatos de data como 01/01/2010.
  • Atributos de nível
    : mostra as colunas relacionadas a atributos de nível.
  • Dimensões de nível
    : mostra as colunas relacionadas a dimensões de nível.
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
    .
  2. Selecione uma coluna não mapeada no menu suspenso. As colunas disponíveis para mapeamento são exibidas na lista. À medida que você mapeia as colunas, o indicador de status muda de um ponto de exclamação IntegrationMappingUnmapped.png para uma marca de seleção IntegrationMappingMapped.png.
A guia Mapeamento de colunas mostra as colunas abaixo:
  • Status:
    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 Moeda.
  • Coluna de origem
    : exibe as colunas na tabela de preparação escolhida nas configurações da fonte de dados.
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.
Mapear pais de níveis
A coluna ParentId indica a ID do pai de um nível. Para carregar no nível mais alto em uma hierarquia, o valor da ID pai nos dados de origem deve estar vazio. A ID pai também deve estar vazia se você quiser criar um nível filho abaixo do nível superior.
Consulte Exemplo: carregar níveis de fontes de dados de planilha para obter um exemplo de como os níveis e seus pais são mapeados para o Planning.
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 para um ponto de exclamação IntegrationMappingUnmapped.png.
Prática recomendada: com as opções de ignorar colunas e cancelar mapeamento para solucionar erros, você pode usar a opção de cancelar mapeamento para ajudar no gerenciamento de alterações. Quando novas colunas são introduzidas em uma fonte de dados, você pode cancelar o mapeamento das colunas mais antigas para mapear as novas.

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 disponíveis para carregamento. Somente os registros que atendem aos seus critérios de filtro serão carregados.
A guia
Regras de negócios
 contém uma área de texto para inserir o SQL.
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. Consulte a Referência da expressão SQL para obter mais informações.
  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 para verificar os mapeamentos e corrigir os erros de validação antes de executar o carregador.
Quando a pré-visualização da saída do carregador ou o carregamento manual é executado, os dados de origem são validados quanto a erros. Exemplos de validações incluem verificações se:
  • Um subnível é criado sem indicar o nível pai.
  • Um atributo de nível é atribuído a um valor de atributo que não pode ser encontrado.
  • O valor da ID de origem do nível está ausente (vazio) nos dados.
  • Existem IDs de origem ou nomes de nível duplicados nos dados. As IDs de origem devem ser exclusivas.
  • A ParentId é igual à ID de origem nos dados. Nesse caso, a coluna está se referindo a si mesma como seu próprio pai.
  • Na importação de subníveis, a raiz do subnível é mapeada para um nó existente no
    Adaptive Planning
    . A parentID não está nos dados de origem de um novo nó introduzido para
    Adaptive Planning
    .
  • Um nó existente foi movido sob um novo nó, e o indicador Criar novo está desabilitado. Um nível existente está sendo movido para um novo nó e o carregador foi definido para não criar novos níveis.
  • Os dados têm uma referência cíclica na hierarquia. A ParentId está se referindo ao seu próprio filho como pai.
  • Um nível foi definido como um parceiro comercial de eliminação e um dos níveis filho foi definido como um nível de eliminação. Um nível definido como um parceiro comercial de eliminação não pode ter um filho que seja um nível de eliminação.
Você também pode baixar a saída de pré-visualização como um arquivo XML para verificar manualmente os níveis de sua fonte de dados em relação aos requisitos antes de carregá-los.
  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 níveis 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, incluindo todas as transformações e regras de negócios. Um pop-up de status exibe as etapas à medida que o carregador é executado. Se houver níveis disponíveis para carregamento, o carregador criará um arquivo XML e enviará uma notificação por e-mail com a saída como um anexo XML compactado. Se nenhum nível for carregado, o arquivo compactado conterá uma mensagem indicando que nenhum nível foi carregado.
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 níveis e do tamanho do arquivo.

Executar o carregador

Depois de salvar um carregador de níveis do Planning com as configurações obrigatórias, execute-o manualmente ou como tarefa de integração programada.
Aguarde cerca de 15 a 30 minutos entre cada execução do carregador de níveis do Planning para que
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.
Para executar o carregador manualmente, clique em
Executar manualmente
 no painel Ações.
Você pode carregar níveis diretamente do sistema de origem ou executar o carregador usando valores de preparação 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 níveis do Planning em uma tarefa de integração
Uma tarefa de integração pode ter um ou mais carregadores. Uma tarefa pode conter outras tarefas de integração, como carregadores de scripts.
Prática recomendada: tenha tarefas de integração separadas para cada carregador.
Se uma tarefa contém vários carregadores, os parâmetros de cada carregador são exibidos em uma lista de opções quando a tarefa é executada. Se há um parâmetro comum ou compartilhado nos carregadores de uma tarefa, a tarefa solicita o parâmetro somente uma vez. Você pode optar por substituir as listas de opções do parâmetro.
Nas execuções programadas da tarefa, são usados os valores por padrão dos parâmetros.
Como solucionar problemas de mensagens e avisos
Consulte Referência: mensagens de registro para carregadores de níveis do Planning para obter descrições das mensagens registradas durante um carregamento.