Conector Autodesk Fusion Lifecycle Upsert no Jitterbit Design Studio
A função Upsert do Fusion Lifecycle permite atualizar um item existente no espaço de trabalho do Fusion Lifecycle para uso em integrações Jitterbit. Além disso, se o item não existir, um novo item é criado.
Nota
Todas as operações do Conector Fusion Lifecycle residem dentro de um projeto. Você precisará criar um projeto antes de poder criar uma operação. Veja Começar para mais informações.
Criar novo Upsert do Fusion Lifecycle
-
Clique na seta à direita do ícone Conector na barra de ferramentas superior.
-
O menu pop-up exibe todos os conectores disponíveis.
-
Clique na função Upsert do Fusion Lifecycle na lista.
-
O Assistente Upsert do Fusion Lifecycle exibe a tela de Endpoint.
Assistente Upsert do Fusion Lifecycle
O Assistente Upsert do Fusion Lifecycle orienta você no processo de criação de uma nova função Upsert. O primeiro passo é selecionar um Endpoint do Fusion Lifecycle.
-
Selecione o Endpoint do Fusion Lifecycle.
-
Antes de criar funções do Fusion Lifecycle no Jitterbit, você deve criar pelo menos um endpoint do Fusion Lifecycle.
-
Se você ainda não criou pelo menos um Endpoint do Fusion Lifecycle, selecione Criar Novo na lista suspensa Endpoints do Fusion Lifecycle Disponíveis. Veja Criando um endpoint do Fusion Lifecycle para instruções sobre como criar um novo endpoint.
-
Se você já criou um ou mais Endpoints do Fusion Lifecycle, Selecione um Endpoint na lista suspensa Available Fusion Lifecycle Endpoints.
-
Clique no botão TestConnection.
-
Se você ainda não fez login no seu servidor Jitterbit, Digite a Senha na janela pop-up de Login do Servidor Jitterbit e Clique no botão Login.
-
Uma janela pop-up indica que os parâmetros foram enviados ao servidor e que o teste está em andamento, seguida por uma janela pop-up indicando que a conexão foi bem-sucedida. Clique em OK.
-
Clique no botão Next para exibir a tela Workspace e selecionar um espaço de trabalho.
-
Para retornar à tela anterior, Clique no botão Back.
-
Clique no botão Cancel para fechar o assistente sem salvar suas entradas.
Selecione um espaço de trabalho
A tela de Workspace exibe a lista de todos os espaços de trabalho do Fusion Lifecycle disponíveis para o inquilino via o endpoint selecionado.
-
Filtrar: Digite as primeiras letras da descrição do espaço de trabalho ou o número de ID do espaço de trabalho na caixa Filter na parte superior da tela para filtrar a lista.
-
Atualizar: Clique no botão Refresh no canto inferior direito da tela para restaurar a lista completa de espaços de trabalho.
-
Clique no Nome do espaço de trabalho específico para acessar. O espaço de trabalho selecionado é o Objeto para a função Upsert do Fusion Lifecycle.
-
Clique no botão Finish na parte inferior da tela para exibir a aba Fusion Lifecycle Upsert, incluindo as estruturas XML de Request e Response.
-
Para retornar à tela anterior, Clique no botão Back.
-
Clique no botão Cancel para fechar o assistente sem salvar suas entradas.
Estruturas XML de solicitação e resposta
As estruturas XML de Solicitação e Resposta são definidas pela função Upsert do Fusion Lifecycle e pela estrutura do espaço de trabalho específico selecionado como o Objeto da função Upsert. A estrutura XML de Solicitação é representada por uma árvore de dados dos campos disponíveis para criar novos itens ou atualizar itens existentes via a função Upsert do Fusion Lifecycle. A estrutura XML de Resposta é representada por uma árvore de dados de campos disponíveis dentro dos itens novos ou atualizados para recuperar valores de dados.
-
Nome: O nome da função Upsert padrão é "Fusion Lifecycle Upsert" mais o nome do espaço de trabalho selecionado como o Objeto (Categorias de Itens(id:12) neste exemplo). Para renomear a função, Digite o Nome no campo Nome no canto superior esquerdo da tela.
-
Clique no ícone Salvar
no canto superior direito da tela.
-
Clique nas Setas Cinzas à esquerda de cada pasta ou Clique Duplo na Pasta para expandir e visualizar os campos disponíveis em cada estrutura.
-
Para completar a função Fusion Lifecycle Upsert, Clique em um dos botões na seção "Usar em uma Integração" no canto superior direito da tela.
-
Criar Operação: Exibe a representação gráfica do fluxo de trabalho da função Upsert e permite acesso aos assistentes de Criar Solicitação e Criar Resposta a partir do gráfico de fluxo de trabalho.
-
Criar Solicitação: Inicia o assistente de transformação de solicitação de criação.
-
Criar Resposta: Inicia o assistente de transformação de resposta de criação.
Assistente de transformação de solicitação de criação
-
Clique no botão Criar Solicitação no canto superior direito da aba.
-
O diálogo do Assistente de Transformação é exibido.
-
Nome: O nome da Solicitação de Transformação padrão é "Fusion Lifecycle Upsert", mais o nome do objeto de espaço de trabalho selecionado (Categorias de Itens(id:12) neste exemplo).
-
Digite o nome apropriado no campo Nome no canto superior esquerdo da tela.
-
Fonte: Selecione a fonte dos dados para a Solicitação na lista suspensa.
-
Para atualizar ou criar um item diretamente do Jitterbit Studio, Selecione Nenhum. Selecionar Nenhum ativa o botão Concluir.
-
Selecionar um tipo de fonte diferente ativa o botão Avançar para continuar definindo a estrutura da fonte.
-
Destino: O destino automaticamente padrão para a função do conector Upsert do Fusion Lifecycle e o objeto do espaço de trabalho (ou seja, Categorias de Itens(id:12)) selecionado nas etapas anteriores.
-
Neste exemplo, estamos atualizando ou criando o item diretamente do Jitterbit Studio e selecionamos Nenhum para a fonte.
-
Clique no botão Concluir na parte inferior da tela para continuar.
-
Para retornar à tela anterior, Clique no botão Voltar.
-
Clique no botão Cancelar para fechar o assistente sem salvar suas entradas.
-
Veja Visão geral dos dados de transformação para informações adicionais.
-
Os campos de dados da fonte são exibidos na metade esquerda da tela. Neste exemplo, uma fonte não foi selecionada.
-
Os campos de dados de destino disponíveis no espaço de trabalho selecionado (ou seja, Categorias de Itens(id:12)) são exibidos na metade direita da tela.
-
Clique duas vezes no campo de dados Destino específico a ser usado para o Upsert.
-
Para este exemplo, o campo Category_Code foi selecionado.
-
O Construtor de Fórmulas é exibido na metade esquerda da tela.
-
Digite a fórmula ou valor de dados no Construtor de Fórmulas para atualizar ou criar um item específico no espaço de trabalho do Fusion Lifecycle. Veja Usando o construtor de fórmulas e Scripting para informações adicionais.
-
Neste exemplo, a função Upsert do Fusion Lifecycle atualizará ou criará uma categoria de item na qual o campo CATEGORY_CODE é definido com um valor de 996.
-
Clique no botão Testar no canto inferior esquerdo para validar o script.
-
Clique em OK para concluir a Transformação de Solicitação.
-
Neste exemplo, também definimos valores na categoria de item atualizada ou nova para o alias, versionID e CATEGORIA.
-
Uma solicitação válida para o campo de dados específico é indicada pela presença de uma linha verde e um quadrado azul ao lado do nome do campo.
-
Clique no ícone Salvar
na barra de ferramentas no canto superior direito da tela para salvar a Transformação de Solicitação.
-
A Transformação de Solicitação não está ativa para uso até que seja implantada no servidor Jitterbit. Clique no ícone Implantar
na barra de ferramentas no canto superior direito da tela para implantar a Transformação de Solicitação no Servidor Jitterbit.
-
Clique no ícone Testar Transformação
no canto inferior esquerdo da tela para testar a Transformação de Solicitação.
Nota
Esta função de teste se aplica apenas à Solicitação, não à Operação inteira. Esta função de teste é útil quando uma Fonte faz parte da Solicitação e o teste identifica e exibe os dados disponíveis na Fonte. Neste exemplo, uma Fonte não é utilizada, e o teste exibe apenas os valores inseridos no Construtor de Fórmulas.
-
Se a Transformação de Solicitação não tiver sido salva e implantada antes do teste, a seguinte mensagem será exibida:
-
Clique no botão Continuar na parte inferior da mensagem pop-up para implantar a função Upsert e a Transformação de Solicitação.
-
Uma mensagem exibe o progresso da implantação da transformação no servidor Jitterbit e do teste da transformação.
-
Os valores de dados que serão usados para atualizar ou criar a categoria do item são exibidos à direita dos campos de Destino na árvore de dados.
-
Neste exemplo, uma Fonte não é utilizada, e o teste exibirá apenas o 1 conjunto de valores inseridos no Construtor de Fórmulas. Nos casos em que um arquivo Fonte faz parte da operação, é possível alternar entre os valores de um item de múltiplas entradas clicando no controle "1 de N" da pasta apropriada. Você pode clicar com a tecla Shift para voltar a uma instância anterior ou clicar com o botão direito para ir a uma instância arbitrária.
-
Veja Testando dados de origem para informações adicionais.
Assistente de transformação de resposta de criação
-
Clique na aba Fusion Lifecycle Upsert.
-
Clique no botão Criar Resposta no canto superior direito da aba.
-
O Assistente de Transformação é exibido.
-
Nome: O nome da Transformação de Resposta é automaticamente definido como "Fusion Lifecycle Upsert", mais o nome do objeto de espaço de trabalho selecionado nas etapas anteriores (Categorias de Itens(id:12) neste exemplo).
-
Digite o nome apropriado no campo Nome no canto superior esquerdo da tela.
-
Fonte: A fonte é automaticamente definida como a função do Conector Fusion Lifecycle Upsert e o objeto de espaço de trabalho selecionado nas etapas anteriores (Categorias de Itens(id:12) neste exemplo).
-
Destino: Selecione o Destino para os dados de resposta na lista suspensa. Isso ativa o botão Avançar.
-
Neste exemplo, estamos enviando os dados para um arquivo Texto.
-
Clique no botão Avançar na parte inferior da tela para exibir a tela Destino e definir o formato do arquivo.
-
Para retornar à tela anterior, Clique no botão Voltar.
-
Clique no botão Cancelar para fechar o assistente sem salvar suas entradas.
-
Veja Alvos e Transformações para tipos adicionais de formatos de arquivo de destino.
-
Definições de Formato de Arquivo Disponíveis: Selecione um formato de arquivo na lista suspensa.
-
Selecione Novo Formato de Arquivo para criar um novo formato. Neste exemplo, estamos criando um novo formato de arquivo.
-
Se você selecionar um formato de arquivo existente na lista suspensa:
- A definição do arquivo é exibida e o botão Concluir é ativado.
- Revise a estrutura existente e edite os segmentos/campos do arquivo conforme necessário.
- Clique em Concluir para finalizar a definição do arquivo e continuar criando a Transformação de Resposta.
- Nome: Digite um nome para a nova definição de formato de arquivo no campo Nome. Neste exemplo, a definição de formato de arquivo é chamada de Test Upsert Category.
-
Se você estiver usando um arquivo existente como modelo para o novo formato de arquivo:
- Clique no botão Criar a Partir do Arquivo no canto inferior esquerdo da tela.
- Uma janela pop-up exibe o diálogo para criar um novo formato de arquivo a partir de um arquivo modelo existente.
- Veja Criando uma definição de documento de texto a partir de um arquivo modelo para informações adicionais.
-
Criar Manualmente: Neste exemplo, estamos criando o novo formato de arquivo manualmente.
-
Clique no botão de opção apropriado para selecionar Simples ou Complexo arquivo de texto.
-
Clique no botão de opção apropriado para selecionar Delimitado por Caracteres ou Larguras de Campo Fixas.
-
Clique no botão Criar Manualmente para Definir Propriedades do Segmento.
-
Clique no botão Novo no lado esquerdo da tela para começar a adicionar campos ao formato do arquivo.
-
Nome do Campo: Digite o Nome do campo na caixa Nome do Campo.
-
Tipo: O tipo de campo padrão é String. Selecione o Tipo apropriado na lista suspensa.
-
Validação do Campo: A validação do campo é opcional para cada campo. Clique no botão Validação
à direita do campo para exibir a janela pop-up de validação.
-
Clique no botão Novo para adicionar o próximo campo e repita os passos de Nome do Campo e Tipo acima para adicionar todos os campos desejados.
-
Clique no botão Revisar Estrutura no canto inferior esquerdo para revisar o formato do arquivo.
-
Clique em OK para fechar a janela pop-up.
-
Clique no botão Concluir na parte inferior da guia do Assistente de Transformação para salvar a nova definição de arquivo e exibir a tela de Transformação de Resposta.
-
Para retornar à tela anterior, Clique no botão Voltar.
-
Clique no botão Cancelar para fechar o assistente sem salvar suas entradas.
-
Veja Formatos de arquivo e Habilitando alvos de arquivo locais para informações adicionais sobre arquivos de texto.
-
Veja Assistente de transformação e Visão geral das transformações para informações adicionais.
-
A estrutura XML de Upsert do Fusion Lifecycle é exibida na metade esquerda da tela como a Fonte de dados e o formato do arquivo de Resposta é exibido na metade direita da tela como o Alvo.
-
Clique duas vezes (ou clique no sinal de +) para expandir a árvore de dados jbresponse no lado esquerdo da tela.
-
Aprofunde-se na árvore de dados e Selecione os campos de Fonte a serem mapeados para o Destino.
-
Clique no Campo de dados desejado na Fonte (coluna da esquerda).
-
Arraste e solte o campo selecionado no Campo apropriado no Destino (coluna da direita).
-
Neste exemplo, o Valor do campo Ação da Fonte é mapeado para o campo Ação no arquivo de texto do Destino.
-
O mapeamento válido é indicado por linhas verdes entre os itens nas colunas de Fonte e Destino e, além disso, pela presença de um quadrado azul ao lado de cada nome de campo mapeado corretamente.
-
Uma linha vermelha indica mapeamento inválido.
-
Uma linha amarela indica que o Jitterbit não tem certeza se o mapeamento é válido, mas tentará a transformação com esse mapeamento.
-
Complete o mapeamento na aba de Transformações arrastando e soltando da Fonte à esquerda para o Destino à direita. Ao fazer isso, uma linha verde conectará cada item da Fonte e do Destino, e um quadrado azul aparecerá à esquerda de ambos, o item da Fonte e o item do Destino. Veja mapeamento de transformação para informações adicionais.
-
Para sair desta tela, Clique no X no canto superior direito da aba.
-
Clique no ícone Salvar
na barra de ferramentas no canto superior direito da tela para salvar a Transformação de Resposta.
-
A Resposta não está ativa para uso até que seja implantada no servidor Jitterbit. Clique no ícone Implantar
na barra de ferramentas no canto superior direito da tela para implantar a Transformação de Resposta no Servidor Jitterbit.
-
Clique no ícone Testar Transformação
no canto inferior esquerdo da tela para testar a função de Resposta.
Nota
Esta função de teste se aplica apenas à Resposta, não à Operação inteira. Esta função de teste pode exigir que você carregue dados de teste para concluir o processo.
-
Se a Transformação de Resposta não tiver sido salva e implantada antes do teste, a seguinte mensagem será exibida:
-
Clique no botão Continuar na parte inferior da mensagem pop-up para implantar a Transformação de Resposta e o formato de arquivo Test Upsert Category.
-
Uma mensagem exibe o progresso da implantação da transformação no servidor Jitterbit e do teste da transformação.
Criar operação
As operações são usadas para definir o que seu processo de integração fará e quando será feito. As operações podem chamar umas às outras com base em eventos como Em Sucesso ou Em Falha, com base em condições definidas ou com base em um cronograma.
-
Clique na aba Fusion Lifecycle Upserts.
-
Clique no botão Criar Operação no canto superior direito da tela.
-
A aba Operações exibe o gráfico de fluxo de trabalho representando a função Fusion Lifecycle Upsert.
Solicitação
-
Clique duas vezes na caixa Solicitação no gráfico de fluxo de trabalho.
-
A janela pop-up Selecionar Transformação exibe uma lista de Transformações de Solicitação existentes.
-
Para selecionar uma Solicitação existente, Clique no Nome de uma Solicitação na lista.
-
Neste exemplo, a Minha Categoria de Itens de Upsert do Fusion Lifecycle (id:12) – Solicitação é selecionada.
-
Clique no botão OK na parte inferior da janela pop-up para continuar criando a operação.
-
Clique no botão Cancelar na parte inferior da janela pop-up para fechar a janela.
-
Para criar uma nova Solicitação, Clique no botão Criar Nova Transformação para abrir a aba do Assistente de Transformação de Solicitação. Veja Assistente de transformação de solicitação para instruções sobre como criar uma nova Solicitação.
-
O nome da Solicitação selecionada é exibido na caixa de fluxo de trabalho da Solicitação.
-
Neste exemplo, a Minha Categoria de Itens Upsert do Fusion Lifecycle(id:12) – Solicitação foi selecionada. Esta Solicitação foi criada sem uma Fonte (Nenhuma foi selecionada como Fonte). Como resultado, a caixa de Fonte é automaticamente removida do gráfico de fluxo de trabalho da Operação.
Resposta
-
Clique duas vezes na caixa Resposta no gráfico de fluxo de trabalho.
-
A janela pop-up Selecionar Transformação exibe uma lista de Transformações de Resposta existentes.
-
Para selecionar uma Resposta existente, Clique no Nome de uma Resposta na lista.
-
Neste exemplo, a Minha Categoria de Itens Upsert do Fusion Lifecycle(id:12) – Resposta é selecionada.
-
Clique no botão OK na parte inferior da janela pop-up para continuar criando a operação.
-
Clique no botão Cancelar na parte inferior da janela pop-up para fechar a janela.
-
Para criar uma nova Resposta, Clique no botão Criar Nova Transformação para abrir a guia do Assistente de Criação de Transformação de Resposta. Veja Assistente de transformação de solicitação de criação para instruções sobre como criar uma nova Resposta.
-
O nome da Resposta selecionada, Minha Categoria de Itens Upsert do Fusion Lifecycle(id:12) – Resposta, é exibido na caixa de fluxo de trabalho da Resposta.
Destino
-
Clique duas vezes na caixa Destino no gráfico de fluxo de trabalho.
-
A janela pop-up Selecionar Destino exibe uma lista de Arquivos existentes.
-
Para selecionar um Arquivo existente, Clique no Nome de um Arquivo na lista.
-
Clique no botão OK na parte inferior da janela para continuar criando a operação.
-
Clique no botão Cancelar na parte inferior da janela para fechar a janela.
-
Para criar um novo Arquivo, Clique no botão Criar Novo Alvo para abrir a aba de Alvos.
-
Nome: Digite um nome para o novo Alvo no campo Nome. Neste exemplo, o Alvo é nomeado Test Upsert Category.
-
Tipo: Selecione o tipo de arquivo na lista suspensa. Neste exemplo, o formato de arquivo criado para a operação é um arquivo de texto e o tipo é Arquivo Local.
-
Pasta: Clique no botão Procurar. Navegue até e selecione a pasta apropriada.
-
Nome do(s) Arquivo(s): Digite o Nome do arquivo alvo na caixa Nome do Arquivo. Neste exemplo, o nome do arquivo é Test Upsert Category.txt.
-
O nome do Alvo, Test Upsert Category.txt, é exibido na caixa de fluxo de trabalho do Alvo.
-
Veja Alvos para informações adicionais.
-
Clique na aba Operações.
-
O nome da função associada é exibido em cada componente do gráfico de fluxo de trabalho:
- Solicitação: My Fusion Lifecycle Upsert Item Categories(id:12) - Solicitação
- Resposta: My Fusion Lifecycle Upsert Item Categories(id:12) - Resposta
- Alvo: Test Upsert Category
-
Clique no ícone Salvar
na barra de ferramentas no canto superior direito da tela para salvar a Operação. A Operação não está ativa para uso até ser implantada no servidor Jitterbit.
-
Clique no ícone Implantar
na barra de ferramentas no canto superior direito da tela para implantar a Operação no Servidor Jitterbit.
Testar a transformação de resposta
-
·Clique na aba Transformações.
-
Uma tela pop-up exibe cada uma das transformações associadas.
-
Clique na janela pop-up Transformação de Resposta para exibir a janela em tamanho completo.
-
Clique no ícone Test Operation that uses Transformation
no canto inferior esquerdo da tela.
-
Todo o fluxo de trabalho da operação é processado e os resultados são exibidos na coluna Target na tela de Resposta.
-
Os valores dos dados de resposta são exibidos à direita dos campos Target na árvore de dados. Neste exemplo, a Ação realizada = Atualizar e Sucesso = Verdadeiro. A operação atualizou com sucesso a Descrição da Categoria do Código da Categoria 996 de BOM 8 para BOM 10.
-
Neste exemplo, uma Fonte não é utilizada, e o teste exibirá apenas 1 conjunto de valores. Nos casos em que um arquivo de Fonte faz parte da operação, você pode alternar pela lista de múltiplos valores de resultado clicando no controle "1 de N" da pasta apropriada. Você pode clicar com a tecla Shift para voltar a uma instância anterior ou clicar com o botão direito para ir a uma instância arbitrária.
-
A operação também criou Test Upsert Category.txt que contém os mesmos resultados que são exibidos na tela de Resposta da Transformação.
Test from operation
-
Clique na aba Operations.
-
Clique no ícone Lightning Bolt
no canto superior direito da tela para colocar a Operação na fila para execução.
-
O monitor de Operação é exibido na parte inferior da tela.
-
Uma barra de progresso é exibida no canto direito enquanto a Operação está em execução.
-
As estatísticas de execução também são exibidas no monitor de Operação: Status, Hora Recebida, Hora Iniciada, Hora Concluída e Duração.
-
Abra um editor de texto e abra o Test Upsert Category.txt para visualizar os resultados da operação.