Versão de assinatura do evento

Última atualização: 22 de abril de 2025
  • Tópicos:

Criado para:

  • Desenvolvedor

O Workfront tem duas versões de assinaturas de evento. Este artigo descreve as diferenças entre elas.

A nova versão não é uma alteração na API do Workfront, mas uma alteração na funcionalidade de assinatura do evento.

A capacidade de atualizar ou fazer downgrade de assinaturas de eventos garante que, quando alterações forem feitas na estrutura dos eventos, as assinaturas existentes não sejam interrompidas, permitindo testar e atualizar para a nova versão sem uma lacuna na assinatura do evento.

Ao atualizar ou fazer downgrade da assinatura de evento para outra versão, você recebe eventos duplicados para cada entrega de evento por uma janela de cinco minutos após a alteração da versão. As duplicatas incluem uma de cada versão de assinatura de evento 1 e versão 2. Isso garante que você não perca nenhum evento devido à alteração da versão de assinatura do evento.

Para obter informações sobre os pontos de extremidade usados para atualizar ou rebaixar assinaturas de eventos, consulte Versão de assinatura de eventos no artigo API de assinatura de eventos.

IMPORTANT
As seguintes versões afetarão o controle de versão de assinaturas de eventos:
  • 25.2 Versão (10 de abril de 2025): todas as novas assinaturas criadas após a versão 25.2 são criadas como Versão 2.
  • 25.3 Versão (17 de julho de 2025): não é mais possível fazer downgrade das assinaturas para a Versão 1 após a versão 25.3.
  • 1º de setembro de 2025: todas as assinaturas restantes da versão 1 são migradas para a versão 2.

Alterações entre a versão 1 e a versão 2

As seguintes alterações foram feitas para assinaturas de evento Versão 2:

Alterações gerais

Campos afetados
Versão 1 (comportamento anterior)
Versão 2 (Alterar)
Ação de remediação
Valores de parâmetro calculados
Qualquer objeto criado a partir de um modelo que incluísse um formulário personalizado com valores de parâmetro calculados, um evento CREATE seria enviado e um UPDATE seria enviado com os valores de parâmetro (incluindo campos calculados e seus valores).
Quando um objeto é criado a partir de um modelo que inclui um formulário personalizado com valores de parâmetro calculados, somente um evento CREATE será enviado e conterá valores de parâmetro, incluindo campos calculados.
Se você tiver uma assinatura para UPDATE eventos e estiver esperando receber um evento UPDATE depois que um objeto for criado com valores de parâmetro calculados, você não receberá mais esse evento UPDATE. Se quiser ver valores de parâmetros calculados na criação de objetos, você deve criar uma assinatura CREATE adicional.
Campos do tipo Seleção múltipla

Para qualquer tipo de evento que contenha uma alteração em um campo de tipo de seleção múltipla, se o campo contivesse apenas um valor, ele seria convertido em e enviado como uma string. Caso contrário, ele será enviado como uma matriz.

Exemplos:

  • myMultiSelectField: ["oneValue"] é convertido e enviado como myMultiSelectField: "oneValue".
  • myMultiSelectField: ["first", "second"] é enviado como myMultiSelectField: ["first", "second"].

Independentemente de quantos valores existam na matriz, ela será enviada como uma matriz.

Exemplos:

  • myMultiSelectField: ["oneValue"] é enviado como myMultiSelectField: ["oneValue"].
  • myMultiSelectField: ["first", "second"] é enviado como myMultiSelectField: ["first", "second"].
Se você tiver uma assinatura com um filtro em um campo de seleção múltipla e o valor como uma cadeia de caracteres, deverá criar uma nova assinatura com o mesmo filtro que tem o valor como uma matriz.