Por que coluna obrigatória bloqueia atualizações do Power Automate
🔍 WiseChecker

Por que coluna obrigatória bloqueia atualizações do Power Automate

Ao executar um fluxo do Power Automate que atualiza um item de lista do SharePoint, o fluxo pode falhar com uma mensagem de erro genérica como “Bad Gateway” ou “Item does not exist”. Uma causa oculta comum é uma coluna obrigatória que o fluxo não fornece. O SharePoint impõe a obrigatoriedade de colunas durante atualizações assim como durante a criação de novos itens. Este artigo explica por que colunas obrigatórias bloqueiam atualizações do Power Automate e mostra como identificar e corrigir o problema.

Principais conclusões: Coluna obrigatória bloqueia Power Automate

  • Ação Update item do Power Automate: Falha se alguma coluna obrigatória estiver ausente na entrada da ação, mesmo que a coluna já tenha um valor na lista.
  • Configurações da lista do SharePoint > Validação de coluna: Colunas obrigatórias impõem a mesma regra durante atualizações e durante a criação; o Power Automate deve incluir a coluna.
  • Solução alternativa — Usar a ação Send an HTTP request to SharePoint: Ignora a validação de coluna obrigatória ao enviar uma solicitação PATCH com apenas os campos que você deseja alterar.

ADVERTISEMENT

Por que colunas obrigatórias bloqueiam atualizações do Power Automate

Colunas de lista do SharePoint marcadas como Exigir que esta coluna contenha informações impõem uma regra de validação no nível do servidor. Quando o Power Automate usa a ação Update item, ele envia uma solicitação POST ou MERGE que o SharePoint interpreta como uma tentativa de atualização completa. Se o corpo da solicitação não incluir a coluna obrigatória, o SharePoint retorna um erro HTTP 400 ou 403, e o fluxo falha.

Esse comportamento é proposital. O SharePoint não distingue entre um item novo e um existente ao validar colunas obrigatórias — ele verifica toda operação de gravação. A ação Update item do Power Automate não inclui automaticamente todos os valores de coluna existentes. Ela envia apenas as colunas que você mapeia explicitamente na ação. Se você omitir uma coluna obrigatória, o servidor rejeita a atualização.

O problema é mais comum quando:

  • Um administrador de lista adiciona uma nova coluna obrigatória depois que os fluxos já estão em execução.
  • Um fluxo atualiza um subconjunto de colunas e o designer esquece de incluir uma coluna obrigatória existente.
  • Uma coluna de pesquisa ou escolha é definida como obrigatória e o fluxo usa um valor dinâmico que resolve para nulo.

Etapas para identificar e corrigir o problema de coluna obrigatória

Siga estas etapas para encontrar a coluna bloqueadora e atualizar seu fluxo.

  1. Verifique o histórico de execução do fluxo
    No Power Automate, abra seu fluxo e selecione Run history. Encontre a execução com falha e clique nela. Em Action outputs, procure a ação Update item. A mensagem de erro geralmente lista o nome da coluna que causou a falha. Textos de erro comuns incluem “Required field” ou “The specified column is required”.
  2. Abra as configurações da lista do SharePoint
    Vá para o site do SharePoint que hospeda a lista. Abra a lista, clique no ícone de engrenagem e selecione List settings. Em Columns, procure colunas com uma marca de seleção na coluna Required. Anote cada nome de coluna obrigatória.
  3. Compare colunas obrigatórias com as entradas da ação do fluxo
    Volte ao Power Automate. Abra o fluxo no modo de edição. Clique na ação Update item. Revise cada campo na seção Advanced parameters. Compare a lista de colunas mapeadas com as colunas obrigatórias da etapa 2. Qualquer coluna obrigatória ausente na ação bloqueará a atualização.
  4. Adicione a coluna obrigatória ausente ao fluxo
    Na ação Update item, clique em Show advanced options se estiver recolhido. Encontre a coluna ausente na lista de parâmetros. Se a coluna não estiver listada, clique em Add new parameter e selecione o nome da coluna. Forneça um valor. Para um item existente, você pode usar a ação Get item antes da atualização para recuperar o valor atual e passá-lo adiante.
  5. Adicione uma ação Get item antes da atualização
    Insira uma ação Get item acima da ação Update item. Configure-a com a mesma lista e ID do item. Em seguida, na ação Update item, defina a coluna obrigatória ausente com o valor de Get item. Isso garante que o valor existente seja preservado enquanto você atualiza outros campos.
  6. Teste o fluxo
    Salve o fluxo e execute-o em um item de teste. Verifique o histórico de execução para confirmar se a atualização foi bem-sucedida. Se o fluxo ainda falhar, repita as etapas 1 a 5 — pode haver mais de uma coluna obrigatória ausente.

ADVERTISEMENT

Se o Power Automate ainda falhar após adicionar colunas obrigatórias

Erro “Bad Gateway” persiste

Um erro Bad Gateway geralmente indica um problema de tempo limite ou conectividade, não um problema de validação de coluna. Verifique a carga do servidor do SharePoint e tente novamente o fluxo. Se o erro continuar, use a ação Send an HTTP request to SharePoint como alternativa.

O fluxo atualiza o item errado ou nenhum item

A ação Update item requer um ID de item válido. Se o ID for dinâmico, verifique se a ação anterior retorna o ID correto. Use uma ação Compose para exibir o ID e verifique-o no histórico de execução.

O valor da coluna é um campo de pesquisa ou pessoa

Colunas de pesquisa e pessoa exigem o ID interno do item referenciado, não o nome de exibição. Se você passar um nome de exibição, o fluxo pode falhar mesmo que a coluna não seja obrigatória. Use a ação Get item para recuperar o ID correto para a atualização.

Ação Update Item vs Send an HTTP Request to SharePoint

Item Ação Update Item Send an HTTP Request to SharePoint
Método usado POST ou MERGE PATCH (normalmente)
Validação de coluna obrigatória Imposta — todas as colunas obrigatórias devem ser fornecidas Não imposta — forneça apenas as colunas que deseja alterar
Tratamento de erros Falha com 400/403 se coluna obrigatória estiver ausente Atualiza com sucesso mesmo se a coluna obrigatória for omitida
Caso de uso Atualizações simples onde todas as colunas obrigatórias são conhecidas Atualizações parciais ou quando colunas obrigatórias mudam com frequência

A ação Send an HTTP request to SharePoint usa a API REST do SharePoint diretamente. Uma solicitação PATCH atualiza apenas os campos que você inclui no corpo JSON. O SharePoint não impõe validação de coluna obrigatória em solicitações PATCH. Essa ação é uma solução alternativa confiável quando você não pode modificar a configuração de coluna obrigatória ou quando deseja minimizar a complexidade do fluxo.

Para usar esta ação, configure o Site Address e o Method como PATCH. No campo Uri, insira _api/web/lists/getbytitle('Your List Name')/items(Item ID). Nos Headers, adicione IF-MATCH com valor e Content-Type com valor application/json;odata=verbose. No Body, forneça um objeto JSON com apenas os campos que deseja alterar, por exemplo: { "Title": "New Value" }.

Agora você sabe por que uma coluna obrigatória bloqueia atualizações do Power Automate e como corrigir. Comece verificando o histórico de execução do fluxo e comparando as entradas da ação com as colunas obrigatórias da lista. Se precisar atualizar apenas alguns campos sem fornecer todas as colunas obrigatórias, mude para a ação Send an HTTP request to SharePoint com o método PATCH. Essa abordagem economiza tempo e evita falhas futuras quando colunas obrigatórias mudam.

ADVERTISEMENT