Ir para o conteúdo

Conector de Autodesk Fusion Lifecycle Criar

A função Fusion Lifecycle Create permite criar novos itens em um espaço de trabalho Fusion Lifecycle para uso em integrações Jitterbit.

Nota

Todas as operações do Fusion Lifecycle Connector residem em um projeto. Você precisará criar um projeto antes de criar uma operação.

Criação do Novo Fusion Lifecycle

  • Clique na Seta à direita do ícone Conector na barra de ferramentas superior. anexo

    anexo

  • O menu pop-up exibe todos os conectores disponíveis.

  • Clique na função Fusion Lifecycle Create na lista.

  • O Fusion Lifecycle Create Wizard exibe a tela Endpoint.

Assistente de Criação do Fusion Lifecycle

O Fusion Lifecycle Create Wizard guia você pelo processo de criação de uma nova função Create. A primeira etapa é selecionar um Fusion Lifecycle Endpoint.

imagem5006

  • 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 Criar Novo na lista suspensa Fusion Lifecycle Endpoints Disponíveis.

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

    imagem5008

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

imagem5010

  • Para arquivar, 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.

  • Para atualizar, Clique no botão Atualizar no canto inferior direito da tela para restaurar toda a lista de áreas 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 Create.

  • Clique no botão Finish na parte inferior da tela para exibir a aba Fusion Lifecycle Create, incluindo as estruturas XML Request e Response.

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

imagem5012

  • O nome da função Create é padronizado como "Fusion Lifecycle Create" 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 image5014 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 Create, 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 Create e permite o acesso aos assistentes Create Request e Create Response a partir do gráfico do workflow.

    • Create Request: Inicia o assistente Create Request Transformaçã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.

    imagem5016

  • O nome da Transformação de solicitação é padronizado automaticamente como "Fusion Lifecycle Create", 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.
  • Selecione a Fonte dos dados para a Solicitação na lista suspensa.

    • Para 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 é padronizado automaticamente para a função do conector Fusion Lifecycle Create e o objeto do espaço de trabalho (ou seja, Categorias de item (id:12)) selecionado nas etapas anteriores.

  • Neste exemplo, estamos 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.

    image5018

  • 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 solicitação.

  • Para este exemplo, o campo Category_Code foi selecionado.

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

    imagem5020

  • Digite a fórmula ou valor dos dados no Formula Builder para criar um item específico no espaço de trabalho Fusion Lifecycle.

  • Neste exemplo, a função Fusion Lifecycle Create criará uma categoria de item na qual o campo CATEGORY_CODE é definido com um valor de 955.

  • Clique no botão Testar no canto inferior esquerdo para validar o script.

  • Clique OK para concluir a Transformação de solicitação.

    imagem5022

  • Neste exemplo, também definimos valores na nova categoria de item 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 image5014 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 image5024 ícone na barra de ferramentas no canto superior direito da tela para implantar a Transformação de solicitação no servidor Jitterbit.

  • Clique em Testar Transformação image5026 í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:

    imagem5028

  • Clique no botão Continuar na parte inferior da mensagem pop-up para implantar a função Criar e Solicitar Transformação.

    image5030

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

    imagem5032

  • Os valores de dados que serão usados para criar a nova categoria de 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 Creates.

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

    imagem5034

  • O Assistente de Transformação é exibido.

    imagem5036

  • O nome da Transformação de Resposta assume automaticamente o padrão "Fusion Lifecycle Create", mais o nome do objeto da área 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.
  • A origem é padronizada automaticamente para a função Fusion Lifecycle Create Connector e o objeto de espaço de trabalho selecionado nas etapas anteriores (Item Categories(id:12) neste exemplo).

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

    image5038

  • 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 em Concluir para concluir a definição do arquivo e continuar criando a Transformação de resposta.

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

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

    image5040

  • Clique no botão Novo no lado esquerdo da tela para começar a adicionar campos ao formato do arquivo.

  • Digite o Nome do campo na caixa Nome do campo.

  • O tipo de campo é padronizado como String.

    • Selecione o Tipo apropriado na lista suspensa**.
  • A validação de campo é opcional para cada campo.

  • Clique em Validação image5042 à 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.

    imagem5044

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

    imagem5046

  • A estrutura XML do Fusion Lifecycle Create é 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.

  • Faça uma busca detalhada na árvore de dados e selecione os campos de Origem a serem mapeados para o Destino.

    image5048

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

    image5050

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

    image5052

  • 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 image5014 í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 image5024 í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 image5026 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:

    image5054

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

    image5055

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

    imagem5057

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

    imagem5059

Solicitar

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

    imagem5061

  • 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 Create 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 fechá-la.
  • 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 Create 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.

    image5063

  • 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 Create 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 fechá-la.
  • Para criar uma nova resposta, Clique no botão CreateNew Transformação para iniciar a aba Create Response Transformação Wizard.

  • O nome da resposta selecionada, My Fusion Lifecycle Create Items Categories(id:12) – Response, é exibido na caixa de workflow de resposta.

Alvo

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

    image5065

  • A janela pop-up Select Target 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 fechá-la.
  • Para criar um novo arquivo, Clique no botão CreateNew Target para abrir a aba Targets.

    image5067

  • Nome: Digite um nome para o novo Alvo no campo Nome. Neste exemplo, o destino é denominado Categoria de criaçã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 Create Category.txt.

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

    image5069

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

    • Solicitação: My Fusion Lifecycle Create Item Categories (id:12) - Request
    • Resposta: My Fusion Lifecycle Create Item Categories(id:12) - Response
    • Alvo: Testar Criar Categoria
  • Clique em Salvar image5014 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 image5024 í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.

    imagem5071

  • 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 image5073 no canto inferior esquerdo da tela.

    imagem5075

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

    imagem5077

  • Os valores dos dados de resposta são exibidos à direita dos campos Alvo na árvore de dados. Neste exemplo, a Ação executada = Criar e Sucesso = Verdadeiro. A operação criou com sucesso o Código de categoria 955.

  • 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 Create New Item.txt que contém os mesmos resultados exibidos na tela Transformação Response.

Teste da Operação

  • Clique na aba Operações.

    imagem5079

  • Clique no Raio image5081 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 Create Category.txt para visualizar os resultados da operação.