Atualização do Patch do Conector Four51¶

A atividade de atualização do patch Four51 disponível no Conector Four51 permite atualizar dados existentes no Four51 por meio da API OrderCloud. Ao contrário da atividade de atualização Four51, a atividade de atualização de patch Four51 permite atualizar apenas os campos que você deseja atualizar, em vez de todos os campos do objeto associado.

A atualização parcial ou total dos campos de objeto é uma diferença importante entre as atividades de atualização do patch Four51 e de atualização do Four51. Se, em vez disso, você quiser substituir todos os campos ou criar um novo registro se não existir nenhum, consulte Atualização do conector Four51.

Esta página descreve como atualizar vários campos de objetos existentes no Four51 usando um exemplo de atualização parcial de um endereço de comprador existente usando Jitterbit. Este exemplo atualiza o mesmo endereço de comprador que foi criado como exemplo em Four51 Connector Create e substituído em Atualização do conector Four51.

As seções a seguir são divididas em iniciar a atividade de atualização de patch, definir os componentes da operação e implantar e executar a operação.

Criando uma Operação de Atualização de Patch Four51¶

1. Dentro do seu projeto no Jitterbit Studio, existem várias maneiras de iniciar uma nova atividade de atualização do patch Four51. Cada uma das opções a seguir iniciará o Assistente de atualização de patch Four51 para guiá-lo durante o processo.

   • Vá para Arquivo > Novo > Conectores > Nova atualização do patch Four51.
   • Na árvore à esquerda em Conectores, clique com o botão direito na categoria Four51 e selecione Nova atualização de patch Four51.
   • Na árvore à esquerda em Conectores, clique duas vezes na categoria Four51, depois clique com o botão direito em Atividades de atualização de patch Four51 e selecione Novo patch Four51 Atualizar.
   • Na barra de ferramentas superior, clique no ícone do conector (peça de quebra-cabeça laranja) . No pop-up, selecione Four51 e, em seguida, selecione Four51 Patch Update.

2. A tela Endpoint do Four51 Patch Update Wizard deve abrir na visualização principal do Studio. Esta tela pede para selecionar o endpoint no qual você gostaria de obter os dados de atualização do patch. Você já deve ter configurado seu endpoint em Four51 Connector Endpoint. Use o menu suspenso para selecionar o endpoint apropriado. Clique em Avançar quando terminar.

   

3. As próximas telas do Assistente de atualização de patch Four51 ajudam você a detalhar o objeto específico no qual deseja corrigir os dados de atualização. A primeira dessas telas, Seção, solicita que você selecione um dos listou categorias de nível superior em Four51: "Autenticação", "Comprador", "Pedidos", "Organização" ou "Perspectiva do usuário".

   Nota

   Você pode descobrir quais seleções fazer consultando a API OrderCloud. Por exemplo, essas cinco categorias de nível superior correspondem diretamente àquelas listadas no lado esquerdo do Console da API OrderCloud. As demais telas de seleção de objetos também seguem a organização da API OrderCloud.

   No exemplo, queremos atualizar parcialmente um endereço de comprador existente, então selecionamos a seção "Comprador" e clicamos em Avançar para continuar.

   

4. A próxima tela do Assistente de atualização de patch Four51, chamada Recurso, exibe os recursos disponíveis na seção selecionada. No exemplo, como queremos atualizar parcialmente um endereço existente, selecionamos "Endereços" e clicamos em Avançar para continuar.

   

5. A tela de seleção final no Four51 Patch Update Wizard, chamada Resource Endpoint, exibe os objetos finais disponíveis para o recurso selecionado. No exemplo, para atualizar parcialmente um endereço existente, selecionamos a opção “Atualizar endereço parcialmente”. Clique em Concluir para continuar.

   Nota

   Os endpoints de recursos disponíveis para cada recurso de seção dependem do tipo de atividade Four51 selecionada para a operação (ou seja, criação, leitura, atualização, atualização de patch ou atividade de exclusão).

   

6. A Jitterbit prosseguirá com a criação de uma estrutura de solicitação e resposta de API que permitirá a atualização dos dados por meio da API OrderCloud. Uma nova aba deve aparecer no Studio chamada Atividades de atualização de patch Four51. Você pode renomear sua atividade de atualização de patch aqui, se desejar; no exemplo, o nosso é chamado de "Atualização do patch Four51 - Comprador > Endereços > Atualizar endereço parcialmente." Você também pode usar os botões + - ou setas para expandir todos os elementos dentro de cada estrutura.

   Nota

   O "xp" na estrutura acima significa "Propriedades Estendidas" e faz parte da API OrderCloud. Esta propriedade permite adicionar campos personalizados à maioria dos objetos. Para saber mais sobre como usar a propriedade XP, consulte Four51 Connector Advanced.

7. Em seguida, na mesma tela, clique no botão Criar Operação localizado em Usar em uma Integração no canto superior direito. Isso criará a operação Jitterbit que atualizará parcialmente um endereço de comprador existente no Four51. Os campos especificados para atualização serão definidos durante a parte de transformação da operação descrita na próxima seção abaixo.

8. Uma nova aba deverá abrir no Studio chamada Operações, contendo uma representação gráfica da atividade de atualização do patch.

   

   Nota

   Os ícones de Origem, Solicitação, Resposta e Destino na imagem acima são espaços reservados para os componentes da operação, que definiremos na próxima seção.

   Salve sua operação clicando no ícone de disco único para salvar apenas esta operação ou no ícone de vários discos para salvar todas as alterações em seu projeto de integração. Você deverá ver o asterisco na aba Operações e o título da operação desaparecer à medida que sua nova atividade de atualização de patch for criada e salva em seu projeto.

Definindo os Componentes da Operação¶

Em seguida, precisamos definir os outros componentes da operação que aparecem na representação gráfica, incluindo Origem, Solicitação, Resposta e Destino.

Você pode retornar à representação gráfica da operação que criou e clicar duas vezes em cada ícone para configurar cada componente ou pode criar Origem, Solicitação, Resposta e Almeje separadamente e depois arraste e solte-os da árvore à esquerda diretamente nos ícones na representação visual de sua operação.

Muitos tipos diferentes de dados podem ser usados para cada componente da operação. Para saber mais sobre opções adicionais de personalização, consulte o Design Studio seção de nossa documentação.

• Fonte: Para simplificar este exemplo, a fonte será codificada. Portanto, removeremos a fonte clicando com o botão direito no ícone da fonte no gráfico de operação e selecionando Remover do gráfico.

  Nota

  Uma variedade de tipos de fontes estão disponíveis no Jitterbit. Veja Fontes para mais.

• Alvo: clique duas vezes no ícone Alvo. No exemplo, registraremos a resposta da API OrderCloud em um arquivo de texto temporário para fornecer informações sobre sucesso/falha. Clique no botão Criar novo alvo e dê um Nome ao seu alvo (por exemplo, 'Alvo de atualização de patch'). A seguir, para este exemplo, queremos gravar no local de armazenamento temporário padrão em nosso Agente Privado, então selecionamos um Type de "Temporary Storage" e inserimos um Filename de 'Patch_File.txt' para o exemplo.

  Nota

  Você também pode enviar para uma variedade de tipos de destino diferentes. O tipo não precisa ser igual ao tipo de origem. Consulte Metas para opções.

• Solicitação: Clique duas vezes no ícone Solicitação e selecione Criar Nova Transformação. Isso abrirá o Assistente de Transformação que orientará você na criação da solicitação.

  Nota

  Informações adicionais sobre estruturas de solicitação são fornecidas em Transformações.

  1. Na primeira tela, Nome, forneça um Nome para sua transformação ou deixe como padrão. Em seguida, use o menu suspenso Fonte para selecionar a origem da transformação. No exemplo, nossa fonte está codificada, então selecionaremos "Nenhum". Clique em Concluir para continuar.

  2. A aba Transformações deve abrir onde você pode completar seu mapeamento. Use o + para expandir os itens na árvore de destino à direita. Em uma transformação padrão, você arrastaria e soltaria cada campo que gostaria de mapear de uma árvore para outra. Para este exemplo, para codificar a origem, clique duas vezes em cada campo no lado do destino e digite os seguintes valores usados no exemplo no script:

     ALVO: INPUT > PartiallyUpdateAddress > Parâmetros	Script
     ID do comprador	<trans> "TestBuyerID0001" </trans>
     endereçoID	<trans> "TestAddressID0000" </trans>

     Nota

     O buyerID acima é o ID existente da organização compradora na qual o endereço está, e o addressID acima é o ID existente do novo endereço que foi criado durante o Four51 Connector Create exemplo.

     ALVO: INPUT > PartiallyUpdateAddress > RequestParameters	Script
     Nome	<trans> "Updated First" </trans>
     Sobrenome	<trans> "Updated Last" </trans>

     Nota

     Os campos listados acima, criados originalmente durante a Criação do Conector Four51 exemplo e substituído durante a Atualização do Conector Four51, por exemplo, será atualizado com os novos valores fornecidos. Os campos restantes do objeto não serão atualizados.

     Depois de codificar a fonte, seu mapeamento de transformação deve ser semelhante ao mostrado abaixo.

• Resposta: Clique duas vezes no ícone Resposta e selecione Criar nova Transformação. Isso abrirá o Assistente de Transformação que orientará você na criação da resposta.

  Nota

  Informações adicionais sobre estruturas de resposta são fornecidas em Transformações.

  1. Na primeira tela, Nome, forneça um Nome para sua transformação ou deixe como padrão. Em seguida, use o menu suspenso Target para selecionar o destino da transformação. No exemplo, queremos usar a resposta da API OrderCloud, então selecionamos "Four51 Function Response". Clique em próximo para continuar.

  2. Na próxima tela, Target, selecione o botão de opção para o tipo de atividade da qual você deseja usar a resposta. Nesse caso, queremos usar a resposta da atividade de atualização de patch que acabamos de configurar, então escolha “Patch_update”. Clique em próximo para continuar.

  3. A tela Target agora exibirá um menu suspenso para selecionar a atividade. Escolha a atividade de atualização de patch que você acabou de configurar. As estruturas de solicitação e resposta associadas à atividade de atualização de patch selecionada devem aparecer agora. Clique em Concluir para continuar.

  4. A aba Transformações deve abrir onde você pode completar seu mapeamento. Use o + para expandir os lados de origem e de destino. Clique e arraste a pasta "OUTPUT" do lado esquerdo (lado de origem) para a pasta "OUTPUT" do lado direito (lado de destino). Sua tela de mapeamento agora deve ser semelhante à mostrada abaixo.

     

Sua operação configurada deve ser semelhante ao exemplo mostrado abaixo.

Implantando e Executando a Operação¶

Com a atividade de atualização do patch Four51 totalmente configurada, estamos prontos para implantar e executar a operação.

1. Na aba Operações, clique em implantar ícone.

2. Em seguida, clique em executar ícone para colocar a operação na fila para execução.

3. Na parte inferior da tela, o Monitor de operação deverá indicar que sua operação foi executada com sucesso. Caso contrário, você pode clicar duas vezes no ícone Status para visualizar quaisquer mensagens de registro.

   

4. Agora você também deve ver a resposta de saída que foi mapeada para seu arquivo de destino 'Patch_File.txt'. No exemplo, o arquivo agora é criado no armazenamento temporário no Agente Privado (ou seja, padrão '/tmp/jitterbit/TemporaryStorage' para Linux ou 'C:\ Windows\Temp\Jitterbit\' para Windows). O status '1' indica que a operação foi bem-sucedida.

   <?xml version="1.0" encoding="UTF-8"?>
   <ns:OUTPUT xmlns:ns="urn:F51oln-res:document:F51oln:oln:entities">
       <PartiallyUpdateAddress>
           <Status>1</Status>
           <Items>
               <Item>
                   <ID>TestAddressID0000</ID>
                   <CompanyName>Test 2 Company</CompanyName>
                   <FirstName>Updated First</FirstName>
                   <LastName>Updated Last</LastName>
                   <Street1>1234 Main Street</Street1>
                   <City>Los Angeles</City>
                   <State>CA</State>
                   <Zip>654321</Zip>
                   <Country>US</Country>
                   <Phone>987654321</Phone>
                   <AddressName>Test_2_Address</AddressName>
               </Item>
           </Items>
       </PartiallyUpdateAddress>
   </ns:OUTPUT>
   

5. Além disso, ao verificar o Console da API OrderCloud em Comprador > Endereços, você deverá encontrar o endereço do comprador atualizado com as novas informações.