Criar carregadores de contas 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 contas do Planning permite mapear metadados sobre contas do livro-razão da área de preparação para o
Adaptive Planning
Use o carregador de contas para importar contas em massa de um sistema externo e sincronizá-las, em vez de criar uma conta de cada vez no administrador de contas. 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:
1min36sEtapas 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
Pré-requisitos
O carregador de contas 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: Modelo, Operador de integração, Designer de dados
Navegação
No menu de navegação, acesse . 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 contas 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
. - SelecioneCriar novo carregadorna seção Carregadores da Biblioteca de componentes.
- SelecioneCarregador de contas Planningcomo o tipo de carregador. Insira um nome para o carregador.
- SelecioneCriar.
- Insira as informações de propriedades gerais do carregador de contas:
- 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.
- Conta do Planning: selecione a conta LR na qual deseja carregar as contas filho. Para carregar uma árvore inteira de contas LR, selecione Contas LR na lista suspensa Contas. O carregamento de toda a árvore de contas LR requer que a fonte de dados contenha todos os nós raiz de LR definidos emAdaptive Planning.
- Publicar alterações pendentes de publicação do administrador: se Conceito: publicação de administrador tem alterações pendentes no fluxo de trabalho, selecione a publicação dessas alterações quando executar o carregador.
- Criar conta, se não for encontrada no Planning: selecione esta opção para criar automaticamente novas contas encontradas no sistema de origem, mas não encontradas em Modelagem > Gerenciamento de modelos > Contas. Se você desmarca esta opção, atualiza somente as contas LR existentes no seu modelo.
- Manter ordem no Planning:selecione esta opção para manter a ordem atual de classificação de contas, já usada no Adaptive Planning.
- Prosseguir com avisos: selecione para redefinir as contas como pai e tornar os valores de atributo compatíveis com o atributo da conta pai. Quando esta opção não é selecionada, o carregador exibe um erro quando a carga contém valores de atributo da conta filho não compatíveis com o atributo da conta pai.
- 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 contas disponíveis em
Modelagem
> Gerenciamento de modelos
> Contas
. 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 Conta.
- 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 da conta:mostra colunas relacionadas aos detalhes da conta:
- Código da conta
- Nome curto
- Consolida em
- Descrição
- Tipo
- Ponderada por
- Texto de exibição
- Planejado por
- Valores reais por
- Sobreposição de valores reais
- Tipo de saldo
- No fluxo de trabalhoO valor de No fluxo de trabalho deve ser um valor booliano de 1 para verdadeiro ou 0 para falso.
- Todos: mostra todas as colunas. Você só pode visualizar oTipo de entrada de dadosna categoriaTodos:
- Os valores válidos paraTipo de entrada de dadossão STANDARD, CUBE ou 'blank'.
- Se deixado em branco, oTipo de entrada de dadosherda o tipo da conta pai.
- Se oTipo de entrada de dadospai é CUBE, a nova conta é CUBE por padrão. Caso contrário, o padrão das novas contas é STANDARD.
- As alterações doTipo de entrada de dadosem contas que não são folha são ignoradas. O sistema calcula automaticamente o novoTipo de entrada de dadospara todas as contas que não são folha.
- Tipo de dados: mostra colunas relacionadas às configurações de tipo de dados da conta, incluindo Estrato de tempo da conta, Exibir como, Fórmula por padrão, Conversão por média ponderada, Redefinir saldo, Transferir saldo ao redefinir, Casas decimais e Taxas cambiais.
- Planilhas: mostra colunas relacionadas à forma como as contas aparecem nas planilhas, incluindo Suprimir nas planilhas e Iniciar expandido.
- Atributos de conta: mostra colunas relacionadas aos atributos de conta, incluindo a lista de todos os atributos associados à conta.
- Privacidade de dados: mostra colunas relacionadas ao nível no qual os dados de uma conta são públicos ou privados, incluindo Contém detalhes de salário.
- Consolidação: mostra colunas relacionadas às configurações de consolidação, incluindo as configurações Intercompanhias, Parceiro comercial de eliminação e Subsidiária. Disponível somente para instâncias com consolidação habilitada.
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
- Clique emMapeamento de colunas.
- 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
para uma marca de seleção 
.
A guiaMapeamento de colunasmostra as colunas abaixo:- Status:a marca de seleção
indica uma coluna mapeada. Um ponto de exclamação 
indica uma coluna não mapeada. - Coluna do Planning: exibe todas as colunas do Planning disponíveis para mapeamento. 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 ID de origem: exibe as colunas na tabela de preparação escolhida nas configurações da fonte de dados.
- Coluna do código da conta de origem: indica a coluna do código da conta para simplificar o processo de mapeamento. Cada conta emAdaptive Planningrequer um código de conta.
Quando a opçãoA importação de dados cria automaticamente valores de dimensãoestá habilitada, você pode mapear os atributos por código. O nome do atributo se torna automaticamente o código.- Mapear pais de contas
- A coluna de ID pai indica a ID da conta principal. Para carregar na conta mais alta 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 uma conta filho abaixo do nível superior.
- Cancelar mapeamento de colunas
- Para cancelar o mapeamento de colunas, clique emCancelar mapeamentoe 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.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.
- Clique emBaixar mapeamentos de membrosno painelAções.
- Baixe o arquivo .XLSX. Você receberá um e-mail ou uma notificação do Workday com um link para baixar o arquivo de mapeamentos.
- 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 colunasCódigo do PlanningouNome do Planningindicam que este código não existe mais no Workday Adaptive Planning.
- Corrija os erros e clique emCarregar mapeamentos de membrospara carregar o arquivo. A colunaSomente leituranão é carregada.
- 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:
- Na guiaRegras de negócios, selecioneFiltro SQL. Clique emEditar.
- Insira uma expressão SQL.Você pode clicar em um item na listaColunas disponíveispara trazer essa coluna para a expressão SQL em vez de digitá-la.
- Clique emAplicarpara 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 emAjuda on-linena seção Observações de Editar filtro SQL. Consulte a Referência da expressão SQL para obter mais informações.
- Corrija os erros na sintaxe e clique emAplicar.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:
- Uma subconta é criada sem indicar a conta pai.
- Um atributo de conta é atribuído a um valor de atributo que não pode ser encontrado.
- O valor da ID de origem da conta está ausente (vazio) nos dados.
- Existem IDs de origem ou nomes de conta 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 subcontas, a raiz da subconta é mapeada para um nó existente noAdaptive Planning. A parentID não está nos dados de origem de um novo nó introduzido paraAdaptive Planning.
- Um nó existente foi movido sob um novo nó, e o indicador Criar novo está desabilitado. Uma conta existente está sendo movida para um novo nó e o carregador foi definido para não criar novas contas.
- 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 as contas de sua fonte de dados em relação aos requisitos antes de carregá-las.
- Clique emPré-visualizar saída do carregadorno painelAções.
- (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 contas do Planning. As alterações nas configurações feitas aqui levam à importação de novos dados nas tabelas e colunas de preparação.
- Clique emPré-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 contas 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 nenhuma conta for carregada, o arquivo compactado conterá uma mensagem indicando que nenhuma conta foi carregada.
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 contas e do tamanho do arquivo.
Este é um exemplo de arquivo XML de saída descompactado e baixado:
Executar o carregador
Depois de salvar o carregador de contas 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 contas 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 contas 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 contas do Planning em uma tarefa de integração
- Qualquer tarefa de integração pode ter um ou mais carregadores. Uma tarefa pode conter outras tarefas de integração, como um carregador de dados do Planning ou um carregador 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.