Share via


Práticas recomendadas de desenvolvimento de fluxo de trabalho do SharePoint

Fornece uma coleção de práticas recomendadas para desenvolvedores que usam o Visual Studio para criar fluxos de trabalho no SharePoint.

Observação

Os fluxos de trabalho do Microsoft Office SharePoint Online 2010 foram desativados desde 1º de agosto de 2020 para novos locatários e removidos de locatários existentes em 1º de novembro de 2020. Se você estiver usando fluxos de trabalho do Microsoft Office SharePoint Online 2010, recomendamos a migração para o Power Automate ou outras soluções suportadas. Para mais informações, confira Retirada do fluxo de trabalho do Microsoft Office SharePoint Online 2010.

Práticas recomendadas de desenvolvimento de fluxos de trabalho

Para desenvolver sem erros fluxos de trabalho do SharePoint, é melhor seguir algumas diretrizes gerais, ou "práticas recomendadas". Esse é o caso, se você estiver usando SharePoint Designer 2013 ou Visual Studio 2012 para desenvolvimento de fluxo de trabalho.

Aplicativos do SharePoint que contêm os fluxos de trabalho integrados necessário editar uma marca no arquivo workflowmanifest.xml

Suplementos do SharePoint que contêm os fluxos de trabalho integrados (que podem ser associados a listas na web pai) são diferenciados de computadores de aplicativos de fluxo de trabalho normal, alterando a seguir marca para true no arquivo workflowmanifest.xml no pacote do app:


<SPIntegratedWorkflow xmlns="http://schemas.microsoft.com/sharepoint/2014/app/integratedworkflow">
    <IntegratedApp>true</IntegratedApp>
</SPIntegratedWorkflow>

Quando você usa a ação de Log à lista de histórico, as informações mais são melhores

A ação de Log à lista de histórico (ou classe LogToHistoryListActivity se você estiver usando Visual Studio ) permite que você registre informações sobre o que fez um fluxo de trabalho em um determinado ponto no ciclo de vida do fluxo de trabalho. Isso permite que uma das ferramentas de solução de problemas mais importantes que você tem. Mais informações sobre a você fornecer nos pontos importantes do fluxo de trabalho mais fácil é solucionar problemas de eventos inesperados.

Para saber mais, confira os seguintes tópicos:

Gravar o valor de cada string e uma variável que você construir a lista de histórico

Depuração de fluxos de trabalho que foram criados usando o SharePoint Designer é muito mais fácil se você escrever cadeias de caracteres e variáveis à lista de histórico usando a ação Log to History List.

Para saber mais, confira os seguintes tópicos:

Saída de um log de rastreamento antes e depois de cada etapa ou unidade importante de trabalho no fluxo de trabalho

Para auxiliar na depuração de fluxos de trabalho, é importante que você capture informações significativas antes e após cada unidade significativa de trabalho; Essas informações devem ser confirmadas logs de rastreamento. Para obter mais informações, consulte o seguinte:

Verifique se variáveis forem não-nulos e contêm valores esperados

Antes de usar variáveis em fluxos de trabalho, verifique se que houverem variáveis nulos. Além disso, certifique-se de que as variáveis contêm valores esperados e são do tipo de dado correto. Para obter mais informações, consulte Variáveis e argumentos.

Certifique-se de que as cadeias de caracteres em campos de texto de fluxo de trabalho não exceder 255 caracteres

O comprimento máximo permitido para cadeias de caracteres em campos de texto de fluxo de trabalho é 255 caracteres. Se você definir seu campo de texto exceder esse limite, seu conteúdo será truncado para 255 caracteres.

Usar permissões elevadas em uma conta neutra ao usar a representação

Quando usando a representação etapas em um fluxo de trabalho, você deve criar o fluxo de trabalho usando uma conta neutra (ou seja, uma conta que não está vinculada a um usuário específico). Isso impede que os fluxos de trabalho podem quebrar se a conta do autor torna-se obsoleto por qualquer motivo.

Para obter mais informações, consulte Criar um fluxo de trabalho com permissões elevadas usando a plataforma de fluxo de trabalho do SharePoint.

Em fluxos de trabalho reutilizáveis, use colunas de associação para garantir que os campos de lista sem erros

Se você criar um fluxo de trabalho reutilizável que depende de sua lista ter um campo específico, você poderá (1) restringir o fluxo de trabalho a um tipo de conteúdo que tenha o campo especificado ou (2) tornar o campo uma coluna de associação. A opção 2 é recomendada porque é possível que um tipo de conteúdo altere e faça com que o fluxo de trabalho seja interrompido.

Design de fluxo de trabalho: modelar um processo de negócios em um único fluxo de trabalho

Sempre que possível, é muito melhor modelar um processo de negócios em um único fluxo de trabalho do que dividir a lógica do fluxo de trabalho em vários fluxos de trabalho menores.

Design de fluxo de trabalho: usando a ação de aprovação com eficiência

Sempre que possível, em vez de criar várias ações de Aprovação , é mais eficaz usar o recurso Estágios dentro de uma ação aprovação .

Confira também