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

Criar carregadores de atributos 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 atributos do Planning permite mapear metadados sobre atributos da área de preparação para o
Adaptive Planning
. Use o carregador de atributos para importar atributos em massa de um sistema externo e sincronizá-los, em vez de criar um atributo de cada vez no administrador de atributos. Depois de criar um carregador, você pode executá-lo manualmente ou programá-lo para ser executado como parte de uma tarefa de integração.
Assista ao vídeo:
 1min32s

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 atributos 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 e Modelo

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 atributos automaticamente.
Prática recomendada: salve com frequência enquanto cria e atualiza 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. Selecione
    Criar novo carregador
    na seção Carregadores da Biblioteca de componentes.
  2. Selecione
    Carregador de atributos do Planning
     como o tipo de carregador. Insira um nome para o carregador.
  3. Selecione
    Criar
    .
  4. Insira as informações de propriedades gerais do carregador de atributos:
    • Tabela de origem
      : selecione a tabela de origem na lista suspensa. A lista contém todas as tabelas disponíveis na área de preparação que você pode acessar.
    • Atributo do Planning
      : selecione o atributo em
      Adaptive Planning
       para carregar no.
    • Criar valor de atributo se não for encontrado no Planning
      : selecione esta opção para criar automaticamente novos valores de atributo encontrados no sistema de origem, mas não encontrados em Modelagem > Gerenciamento de modelos > Atributos. Se você desmarca esta opção, atualiza somente os valores de atributos existentes no seu modelo.
    • Publicar alterações pendentes de publicação do administrador
      : se Conceito: publicação de administrador tem alterações de fluxo de trabalho pendentes, selecione essa opção para publicar as alterações.
    • 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 propriedades de atributo disponíveis em
Modelagem
 >
Gerenciamento de modelos
 >
Atributos
. 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.
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 Atributo.
  • Não mapeados
    : mostra todas as colunas não mapeadas do Planning.
  • Mapeados
    : mostra todas as colunas mapeadas do Planning.
Use
Categoria
para selecionar.
  • Todos
    : mostra todas as colunas. Atributos não usam categorias.
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
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 Descrição.
  • Coluna de origem
    : exibe as colunas na tabela de preparação escolhida nas configurações da fonte de dados.
  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.
Mapear pais de atributos
A coluna ID pai indica a ID da conta principal. Para carregar no atributo 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 valores de atributos filho abaixo do nível superior.
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. Para obter mais informações, consulte Referência: expressões 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 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 valor de atributo é criado sem indicar o atributo pai.
  • Um valor de atributo é atribuído a um atributo que não pode ser encontrado.
  • O valor da ID de origem do atributo está ausente (vazio) nos dados.
  • Existem IDs de origem ou nomes de atributo 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.
  • Um nó existente movido sob um novo nó e
    a opção Criar valor do atributo se não encontrado no Planning
     está desabilitada. Um atributo existente está sendo movido para um novo nó e o carregador foi definido para não criar novos valores de atributo.
  • Os dados têm uma referência cíclica na hierarquia. A ParentId está se referindo ao seu próprio filho como pai.
Você também pode baixar a saída de pré-visualização como um arquivo XML para verificar manualmente os atributos 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 atributos 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 atributos 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 atributo for carregado, o arquivo compactado conterá uma mensagem indicando que nada 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 atributos e do tamanho do arquivo.

Executar o carregador

Depois de salvar o carregador de atributos do Planning com as configurações obrigatórias, execute-o manualmente ou como uma tarefa de integração programada.
Aguarde cerca de 15 a 30 minutos entre cada execução do carregador de atributos 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 atributos 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 atributos 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
Painéis
 carregadores de métricas e 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.