Atualização do Conector de Autodesk Fusion Lifecycle¶

A função Fusion Lifecycle Update permite que você atualize um item existente no espaço de trabalho Fusion Lifecycle para uso em integrações Jitterbit.

Criar Nova Atualização 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 Fusion Lifecycle Update na lista.

• O Fusion Lifecycle Update Wizard exibe a tela Endpoint.

Assistente de Atualização do Fusion Lifecycle¶

O Fusion Lifecycle Update Wizard orienta você no processo de criação de uma nova função de atualização. A primeira etapa é selecionar um Fusion Lifecycle Endpoint.

• Selecione o Fusion Lifecycle Endpoint.

• Antes de poder 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 Fusion Lifecycle Endpoint, selecione Create New na lista suspensa Available Fusion Lifecycle Endpoints.

• Se você já criou um ou mais Endpoints do Fusion Lifecycle, selecione um endpoint na lista suspensa Endpoints do Fusion Lifecycle disponíveis.

  

• Clique no botão Testar Conexão.

• Se você ainda não fez login em seu servidor Jitterbit, Digite a Senha na janela pop-up Login do servidor Jitterbit e Clique no botão Login.

• Uma janela pop-up indica que os parâmetros foram enviados ao servidor e o teste está em andamento, seguida por uma janela pop-up indicando que a conexão foi bem-sucedida. Clique OK.

• Clique no botão Avançar para exibir a tela Espaço de trabalho e selecione um espaço de trabalho.

• Para retornar à tela anterior, Clique no botão Voltar.

• Clique no botão Cancelar para fechar o assistente sem salvar suas entradas.

Selecione um Espaço de Trabalho¶

A tela Workspace exibe a lista de todos os espaços de trabalho do Fusion Lifecycle disponíveis para o inquilino por meio do endpoint selecionado.

• Filtro: Digite as primeiras letras da descrição do espaço de trabalho ou o número do ID do espaço de trabalho na caixa Filtro na parte superior da tela para filtrar a lista.

• Atualizar: Clique no botão Atualizar no canto inferior direito da tela para restaurar toda a lista 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 Fusion Lifecycle Update.

• Clique no botão Concluir na parte inferior da tela para exibir a aba Atualização do Fusion Lifecycle, incluindo as estruturas XML de solicitação e resposta.

• Para retornar à tela anterior, Clique no botão Voltar.

• Clique no botão Cancelar 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 Fusion Lifecycle Update e a estrutura do espaço de trabalho específico selecionado como o objeto da função Update. A estrutura Request XML é representada por uma árvore de dados dos campos disponíveis para atualizar os itens existentes por meio da função Fusion Lifecycle Update. A estrutura XML de resposta é representada por uma árvore de dados de campos disponíveis nos itens atualizados para recuperar valores de dados.

• Nome: O nome padrão da função de atualização é "Fusion Lifecycle Update" mais o nome do espaço de trabalho selecionado como o Objeto (Item Categories(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 duas vezes na Pasta para expandir e visualizar os campos disponíveis em cada estrutura.

• Para concluir a função Fusion Lifecycle Update, Clique em um dos botões na seção "Usar em uma integração" no canto superior direito da tela.

• Create Operation: Exibe a representação gráfica do workflow da função Update e permite o acesso aos assistentes Create Request e Create Response a partir do gráfico do workflow.

• Create Request: Inicia o assistente de criação de Transformação de solicitação.

• Create Response: Inicia o Assistente de Transformação Create Response.

Criar Assistente de Transformação de Solicitação¶

• Clique no botão Criar solicitação no canto superior direito da aba.

• A caixa de diálogo Assistente de Transformação é exibida.

  

• Nome: O nome da Transformação de Solicitação assume automaticamente o padrão "Fusion Lifecycle Update", mais o nome do objeto da área de trabalho selecionado (Item Categories(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 um item diretamente do Jitterbit Studio, Selecione Nenhum. Selecionar Nenhum ativa o botão Concluir.

• A seleção de um tipo de fonte diferente ativa o botão Avançar para continuar definindo a estrutura da fonte.

• Destino: O destino é padronizado automaticamente para a função do conector Fusion Lifecycle Update e o objeto da área de trabalho (ou seja, Categorias de item (id:12)) selecionado nas etapas anteriores.

• Neste exemplo, estamos atualizando ou criando o item diretamente do Jitterbit Studio e selecionamos None 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.

  

• Os campos de dados de origem 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 item (id:12)) são exibidos na metade direita da tela.

• Clique duas vezes no campo de dados Target específico **** a ser usado para a atualização.

• Para este exemplo, o campo Category_Code foi selecionado.

• O Formula Builder é exibido na metade esquerda da tela.

  

• Digite a fórmula ou valor dos dados no Formula Builder para atualizar itens específicos do espaço de trabalho Fusion Lifecycle.

• Neste exemplo, a função Fusion Lifecycle Update atualizará o item no qual o campo Category_Code está definido para 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 para o alias, versionID e CATEGORY.

• 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 em 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 em Implantar ícone na barra de ferramentas no canto superior direito da tela para implantar a Transformação de solicitação no servidor Jitterbit.

• Clique em Transformação de teste ícone 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 um Source faz parte do Request e o teste identifica e exibe os dados disponíveis no Source. Neste exemplo não é utilizada uma Source, e o teste exibe apenas os valores inseridos no Formula Builder.

• 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 Atualizar e Solicitar Transformação.

  

Uma mensagem exibe o progresso da implantação da transformação no servidor Jitterbit e o teste da transformação.

• Os valores de dados que serão usados para atualizar a categoria do item são exibidos à direita dos campos Destino na árvore de dados.

• Neste exemplo não é utilizada uma Fonte, e o teste exibirá apenas 1 conjunto de valores inseridos no Construtor de Fórmulas. Nos casos em que um arquivo de origem faz parte da operação, você pode alternar entre os valores de um item de várias entradas clicando no controle "1 de N" da pasta apropriada. Você pode clicar com a tecla Shift pressionada para ir para uma instância anterior ou clicar com o botão direito do mouse para ir para uma instância arbitrária.

Criar Assistente de Transformação de Resposta¶

• Clique na aba Fusion Lifecycle Update.

• 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 assume automaticamente o padrão "Fusion Lifecycle Update", mais o nome do objeto do espaço de trabalho selecionado nas etapas anteriores (Item Categories(id:12) neste exemplo).

• Digite o nome apropriado no campo Nome no canto superior esquerdo da tela.

• Fonte: A fonte é automaticamente padronizada para a função Fusion Lifecycle Update Connector e o objeto de espaço de trabalho selecionado nas etapas anteriores (categorias de item (id:12) neste exemplo).

• Alvo: Selecione o Alvo para os dados de resposta na lista suspensa. Isso ativa o botão Avançar.

• Neste exemplo estamos enviando os dados para um arquivo Text.

• 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.

  

• Definições de formatos 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 Concluir para concluir 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 do formato de arquivo é denominada Test Update Category.

• Se você estiver usando um arquivo existente como modelo para o novo formato de arquivo:

  • Clique no botão Create From File no canto inferior esquerdo da tela.
  • Uma janela pop-up exibe a caixa de diálogo para criar um novo formato de arquivo a partir de um arquivo de modelo existente.

• Create Manually: Neste exemplo, estamos criando o novo formato de arquivo manualmente.

  • Clique no botão apropriado para selecionar o arquivo de texto Simples ou Complexo.
  • Clique no botão de opção apropriado para selecionar Delimitado por caracteres ou Largura de campo fixa.
  • Clique no botão Criar manualmente para Definir as 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 de Campo: A validação de campo é opcional para cada campo. Clique em 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 as etapas 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 Finish na parte inferior da aba Transformação Wizard para salvar a nova definição de arquivo e exibir a tela Response Transformação.

• Para retornar à tela anterior, Clique no botão Voltar.

• Clique no botão Cancelar para fechar o assistente sem salvar suas entradas.

  

• A estrutura XML de atualização 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 destino.

• Clique duas vezes (ou clique no sinal +) para expandir a árvore de dados jbresponse no lado esquerdo da tela.

• Drill na árvore de dados e Selecione os campos de Origem a serem mapeados para o Destino.

  

• Clique no Campo dos dados desejados 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 Origem é mapeado para o campo Ação no arquivo de texto Destino.

  

• O mapeamento válido é indicado por linhas verdes entre os itens nas colunas Origem e Destino e, além disso, pela presença de um quadrado azul ao lado de cada nome de campo mapeado de forma válida.

• 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 este mapeamento.

  

• Conclua o mapeamento na aba Transformações arrastando e soltando da Origem à esquerda para o Destino à direita. Ao fazer isso, uma linha verde conectará cada item de origem e de destino, e um quadrado azul aparecerá à esquerda de ambos os itens de origem e destino.

• Para sair desta tela, Clique no X no canto superior direito da aba.

• Clique em Salvar ícone 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 em Implantar ícone na barra de ferramentas no canto superior direito da tela para implantar a Transformação de Resposta no Servidor Jitterbit.

• Clique em Transformação de teste no canto inferior esquerdo da tela para testar a função Response.

  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 de categoria de atualização de teste.

  

• Uma mensagem exibe o progresso da implantação da transformação no servidor Jitterbit e o 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 On Success ou On Failure, com base em condições definidas ou com base em um cronograma.

• Clique na aba Fusion Lifecycle Updates.

  

• Clique no botão Criar Operação no canto superior direito da tela.

• A aba Operações exibe o gráfico do workflow que representa a função Fusion Lifecycle Update.

  

Solicitar¶

• Clique duas vezes na caixa Solicitar no gráfico de workflow.

  

• A janela pop-up Select Transformação exibe uma lista de Request Transformações existentes.

• Para selecionar uma Solicitação existente, Clique no Nome de uma Solicitação na lista.

• Neste exemplo, My Fusion Lifecycle Update Item Categories(id:12) – Request está selecionado.

• 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 iniciar a aba Criar Assistente de Transformação de Solicitação.

• O nome da solicitação selecionada é exibido na caixa de workflow da solicitação.

• Neste exemplo, My Fusion Lifecycle Update Item Categories(id:12) – Request foi selecionado. Esta solicitação foi criada sem uma origem (Nenhuma foi selecionada como origem). Como resultado, a caixa Origem é removida automaticamente do gráfico de workflow da Operação.

Resposta¶

• Clique duas vezes na caixa Resposta no gráfico de workflow.

  

• 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, My Fusion Lifecycle Update Items Categories(id:12) – Response está selecionado.

• 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 aba Criar assistente de Transformação de resposta.

• O nome da resposta selecionada, Minhas categorias de itens de atualização do Fusion Lifecycle (id:12) – Resposta, é exibido na caixa de workflow da resposta.

Alvo¶

• Clique duas vezes na caixa Destino no gráfico de workflow.

  

• A janela pop-up Selecionar destino exibe uma lista de arquivos de destino 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 fechá-la.

• Para criar um novo arquivo, Clique no botão Criar Novo Alvo para abrir a aba Alvos.

  

• Nome: Digite um nome para o novo Alvo no campo Nome. Neste exemplo, o destino é denominado Categoria de atualização de teste.

• Tipo: Selecione o tipo de arquivo na lista drop-down. 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. Procure e selecione a pasta apropriada.

• Nome do(s) arquivo(s): Digite o Nome do arquivo de destino na caixa Nome do arquivo. Neste exemplo, o nome do arquivo é Test Update Category.txt.

• O nome do Destino, Test Update Category.txt, é exibido na caixa Destino do workflow.

  

• O nome da função associada é exibido em cada componente do gráfico de workflow:

  • Solicitação: Minhas categorias de itens de atualização do Fusion Lifecycle (id:12) - Solicitação
  • Resposta: My Fusion Lifecycle Update Item Categories(id:12) - Response
  • Alvo: Test Update Category

• Clique em 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é que seja implantada no servidor Jitterbit.

• Clique em Implantar ícone na barra de ferramentas no canto superior direito da tela para implantar a operação no servidor Jitterbit.

Teste da 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 Response Transformação para exibir a janela em tamanho real.

• Clique no ícone Operação de Teste que usa Transformação no canto inferior esquerdo da tela.

  

Todo o workflow da operação é processado e os resultados são exibidos na coluna Alvo na tela Resposta.

• Os valores dos dados de resposta são exibidos à direita dos campos Alvo na árvore de dados. Neste exemplo, a Ação executada = Atualizar e Sucesso = Verdadeiro. A operação atualizou com sucesso a Descrição de categoria do Código de categoria 996 de BOM 7 para BOM 8.

• Neste exemplo não é usada uma Fonte, e o teste exibirá apenas 1 conjunto de valores. Nos casos em que um arquivo de origem faz parte da operação, você pode alternar entre a lista de vários valores de resultado clicando no controle "1 de N" da pasta apropriada. Você pode clicar com a tecla Shift pressionada para ir para uma instância anterior ou clicar com o botão direito do mouse para ir para uma instância arbitrária.

• A operação também criou Test Update Category.txt que contém os mesmos resultados exibidos na tela Transformação Response.

Teste da Operação¶

• Clique na aba Operações.

  

• Clique no Raio no canto superior direito da tela para colocar a Operação na fila de 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á sendo executada.

• 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.

• Inicie um editor de texto e Abra o Test Update Category.txt para visualizar os resultados da operação.