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

Criar carregadores de associações do Planning

O carregador de associação do Planning permite mapear metadados sobre associações de dimensão e nível de usuário da área de preparação para o
Adaptive Planning
. As associações conectam níveis e dimensões personalizadas a usuários. A propriedade de nível é um tipo de associação de usuário que conecta usuários a níveis. Ao contrário das associações comuns de nível, a propriedade de nível vem com outros privilégios. Consulte.
Depois de criar um carregador, você pode executá-lo manualmente ou programá-lo para ser executado como parte de uma tarefa de integração. Consulte Criar tarefas de integração.

Pré-requisitos

  • O carregador de associação do Planning requer dados de preparação da importação de uma fonte de dadosexistente.
  • Permissões obrigatórias: Modelo, Operador de integração, Designer de dados

Etapas básicas

  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

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 selecione as associações a serem carregadas.
  1. Selecione
    Criar novo carregador
    no painel
    Carregadores
     da Biblioteca de componentes.
  2. Selecione
    Carregador
    de associação 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 associações na guia
    Configurações de fonte de dados
    :
    • 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.
    • Perfil de mapeamento
      : você pode vincular um perfil de mapeamento como parte do processo de criação do carregador. Selecione o perfil de mapeamento na lista suspensa. Você tem acesso a todos os perfis de mapeamento mostrados na lista. Consulte a seção de perfil de mapeamento do carregador de dados do Planning. Esse perfil de mapeamento, juntamente com os mapeamentos carregados como parte dos carregadores de metadados, mapeiam os níveis e dimensões de planejamento. Consulte Criar carregadores de dados do Planning. Exemplo: se o carregador de associações tiver um valor de coluna de nível "999999" (ou, para o Workday, um WID), o perfil de mapeamento determinará a qual nível de planejamento se refere.
    • Nível ou dimensão
      : selecione o nível para a propriedade de nível ou associação de nível. Selecione uma dimensão para carregar as associações de dimensão.
    • Atributo:
       (opcional) selecione um atributo do Adaptive Planning para o nível ou a dimensão. Isso permite mapear e carregar associações para atributos de nível ou dimensão.
    • Modo
      : selecione
      Atualizar
       para modificar associações ou atribuições de propriedade em um subconjunto de níveis. Isso atualiza o nível, não o usuário. As atualizações no nível exigem que todos os usuários estejam associados a esse nível na carga. Selecione
      Substituir tudo
       para excluir todos os usuários nas associações mencionadas na carga e substituí-los.
      • Se você usa o Adaptive Planning com o Workday HCM ou o Workday Financials, o campo
        Modo
         é preenchido automaticamente com
        Atualizar
        .
      • Se você não usa o Adaptive Planning com o Workday HCM ou o Workday Financials, o campo
        Modo
         é preenchido automaticamente com
        Substituir tudo
        .
    • Prosseguir com avisos
      : marque esta opção para continuar executando o carregador mesmo com a emissão de avisos. Se você deixa a opção desmarcada, o carregador é interrompido quando um aviso for emitido. Se você habilita esta opção, o carregador ignora dimensões ou níveis não mapeados, cria um aviso nos registros e continua o processamento.
    • 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 as associações disponíveis em
Modelagem > Gerenciamento de modelos > Níveis
 ou
Modelagem > Gerenciamento de modelos > Dimensões
. Você deve mapear a coluna
Usuário
 e
Colunas do Planning
.
Se você é um cliente Workday que executa a sincronização de usuários neste ambiente, a coluna Usuário deve ser mapeada para a coluna de origem que contém WIDs. Se você não executou a sincronização de usuários ou não é um cliente Workday, a coluna Usuário precisa ser mapeada para a coluna de origem que contém nomes de usuário ou e-mails.
Se há várias
colunas do Planning
 para mapeamento, use o filtro
Mostrar
para selecionar:
  • Todos
    : mostra todos os usuários.
  • Obrigatório
    :
    mostra todas as colunas obrigatórias do Planning, como Usuário e Nível.
  • Não mapeado
    :
    mostra todas as colunas não mapeadas do Planning.
  • Mapeado
    :
    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 na guia
    Mapeamento de 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. As colunas obrigatórias do Planning são indicadas por texto em negrito com um asterisco.
    • 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.
Como mapear colunas para propriedade de nível
Se você quiser carregar somente a propriedade de nível, não mapeie um identificador para o código de associação de nível na
Coluna de origem
. Deixe o código de associação em branco para que a propriedade de nível em
Administração
 >
Associações
 seja preenchida de acordo.
Como mapear colunas para associação de nível e dimensão
Se você quiser carregar associações de nível e dimensão, mapeie um identificador como
ID de referência
 para o código de associação na
Coluna de origem.
Você não pode carregar a propriedade de nível e a associação de nível usando um único carregador. Crie um carregador para a propriedade de nível e um carregador separado para a associação de nível.
Mapeamento de colunas para associação de atributos
Se você quer carregar atributos de nível ou dimensão com associações, mapeie-os na
Coluna de origem
. Os atributos aparecem na parte inferior dos mapeamentos, abaixo do Nome da associação.
Cancelar mapeamento de colunas
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.
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.

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 em Editar filtro SQL. 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 antes de executar um carregamento completo para verificar se os mapeamentos funcionam como você deseja. Você também pode baixar a saída como um arquivo XML para verificar manualmente as associações de propriedade no nível do usuário de sua fonte de dados em relação aos requisitos antes de carregá-las.
Clique em
Pré-visualizar saída do carregador
 no painel Ações.
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 associação de usuário 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 associação e do tamanho do arquivo.
Corrigir erros de validação
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:
  • O valor da ID de origem para o usuário ou nível e dimensão está ausente (vazio) nos dados.
  • A ID de origem não está mapeada.

Executar o carregador

Depois de salvar um carregador de associaçõ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 associação 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 associaçõ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 tarefas de integração separadas 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.