{"componentChunkName":"component---src-templates-blog-post-js","path":"/blog/dataverse-business-process-flows-stages-processos-longos/","result":{"data":{"markdownRemark":{"frontmatter":{"title":"Dataverse: business process flows e stages em processos longos","description":"Como modelar business process flows no Dataverse para processos de várias etapas sem travar a operação: stages, branching, a tabela de instância e os limites reais.","date":"21 de novembro de 2026","thumbnail":null},"html":"<p>Processos de negócio que atravessam várias etapas — onboarding de cliente, aprovação de crédito, abertura de chamado com SLA — costumam viver espalhados em campos soltos, status codes e lógica de fluxo duplicada. O <strong>business process flow (BPF)</strong> do Dataverse existe justamente para dar um esqueleto visual e um controle de estado a esses processos, mas é um recurso frequentemente mal compreendido: muita gente o trata como simples barra decorativa no topo do formulário e ignora que, por baixo, ele é uma tabela de verdade com dados, segurança e limites próprios.</p>\n<p><strong>O que um BPF realmente é por baixo</strong></p>\n<p>Quando você ativa um business process flow, o Dataverse cria uma tabela de instância dedicada para aquele processo (uma entidade própria, não uma coluna na tabela de negócio). Cada registro que entra no fluxo ganha uma linha nessa tabela de instância, que guarda o stage ativo, os timestamps de entrada em cada etapa e o vínculo com o registro principal. Isso tem consequências práticas:</p>\n<ul>\n<li>O stage atual <strong>não</strong> é uma coluna simples da sua tabela — consultá-lo exige ir à tabela de instância do BPF.</li>\n<li>A instância do BPF tem <strong>ownership e security role próprios</strong>. Um usuário pode ver o registro de negócio mas não a barra do processo se não tiver privilégio na entidade do BPF.</li>\n<li>Um mesmo registro pode ter <strong>mais de uma instância de BPF</strong> (processos concorrentes), e o usuário pode alternar entre eles — o que muda qual barra aparece no formulário.</li>\n</ul>\n<p><strong>Stages, steps e o que cada camada controla</strong></p>\n<p>Um BPF se organiza em <em>stages</em> (as bolinhas da barra) e, dentro de cada stage, <em>steps</em> (campos a preencher). A diferença crítica é:</p>\n<ul>\n<li><strong>Stage obrigatório</strong> só impede o avanço se você marcar os steps como <em>required</em>. Sem isso, a barra é puramente visual e não garante nada.</li>\n<li>Steps podem apontar para campos de <strong>tabelas diferentes</strong> dentro do mesmo fluxo — um BPF pode cruzar até cinco entidades conectadas por relacionamento, o que permite modelar um processo que vai de Lead para Opportunity, por exemplo.</li>\n<li>Avançar de stage é um evento: você pode disparar lógica no <code>OnStageChange</code>/<code>OnStageSelected</code> via client scripting, ou reagir à mudança do campo de stage ativo em um plugin/flow no servidor.</li>\n</ul>\n<p><strong>Branching: condição, não código</strong></p>\n<p>BPFs suportam <em>branching</em> condicional — o próximo stage depende do valor de um campo. Isso cobre bifurcações como \"se valor > X, passa por aprovação de diretoria\". Os limites valem conhecer antes de desenhar: o branching é avaliado por regras declarativas (até certa profundidade de condições), não é Turing-completo, e ramos que reconvergem precisam ser modelados com cuidado para não duplicar stages. Quando a lógica de decisão vira uma árvore complexa com muitos cruzamentos, isso é sinal de que a regra pertence a um plugin ou a um flow, e o BPF deve ficar com a representação macro do processo.</p>\n<p><strong>Os limites reais que mordem em produção</strong></p>\n<ul>\n<li><strong>Número de BPFs ativos por entidade e por organização</strong> é limitado — não saia criando um fluxo para cada variação; prefira branching dentro de um fluxo bem desenhado.</li>\n<li><strong>Stages por processo e steps por stage</strong> têm teto. Processos com dezenas de etapas são um indício de que você está tentando usar o BPF como motor de workflow, e não como mapa de estado.</li>\n<li>A tabela de instância <strong>cresce indefinidamente</strong> se você nunca limpa processos concluídos ou abandonados. Em volume alto, isso vira carga morta que afeta backup e consultas.</li>\n<li><strong>Segurança</strong>: esquecer de conceder privilégio na entidade do BPF faz a barra sumir silenciosamente para alguns perfis — um clássico de chamado difícil de diagnosticar.</li>\n<li>O BPF <strong>não substitui validação de servidor</strong>. Como os steps required só agem na UI, qualquer gravação via API, flow ou importação ignora a regra. Regras que não podem ser violadas têm que estar em plugin no servidor.</li>\n</ul>\n<p><strong>Quando usar BPF e quando não usar</strong></p>\n<p>Use business process flow quando o valor está em <strong>guiar pessoas</strong> por um processo padronizado em um model-driven app, dar visibilidade do estágio atual, medir tempo por etapa (os timestamps da instância alimentam relatórios de duração de ciclo) e orquestrar preenchimento progressivo de dados espalhados por entidades relacionadas.</p>\n<p>Não use BPF como motor de automação sem interação humana — para isso há Power Automate e plugins. Não use quando o processo é majoritariamente sistêmico (ingestão, integração, batch), nem quando a barra visual não agrega nada ao usuário final. E lembre: o estado canônico que outros sistemas vão consultar normalmente deve ser uma <strong>status reason/choice na sua própria tabela</strong>, mantida em sincronia com o stage por lógica de servidor — depender da tabela de instância do BPF como fonte de verdade para integração é frágil.</p>\n<p><strong>Roteiro curto de decisão</strong></p>\n<ol>\n<li>O processo tem etapas que uma pessoa percorre em um model-driven app? Se não, provavelmente é flow/plugin, não BPF.</li>\n<li>Você precisa medir tempo por etapa? BPF entrega isso de graça pelos timestamps.</li>\n<li>A regra de avanço pode ser violada por API/import? Então ela precisa estar em plugin, não só nos steps required.</li>\n<li>A lógica de decisão virou árvore complexa? Simplifique o BPF e empurre a decisão para o servidor.</li>\n<li>Vai crescer em volume? Planeje limpeza das instâncias concluídas.</li>\n</ol>\n<p>Modelar processos longos com clareza — separando o que é mapa visual, o que é regra inviolável e o que é automação de bastidor — é o tipo de decisão de arquitetura que evita retrabalho caro meses depois. Se a sua empresa está estruturando processos de negócio sobre Dataverse e Dynamics 365, os times de consultoria e os planos de suporte da Dynamic Soluções ajudam a desenhar esse equilíbrio desde o início, em vez de remendar depois.</p>\n<p>Business processes that span several steps — customer onboarding, credit approval, ticket handling with SLAs — tend to end up scattered across loose fields, status codes and duplicated flow logic. The Dataverse <strong>business process flow (BPF)</strong> exists precisely to give those processes a visual skeleton and state control, but it is a frequently misunderstood feature: many people treat it as a decorative bar at the top of the form and ignore that, underneath, it is a real table with its own data, security and limits.</p>\n<p><strong>What a BPF actually is under the hood</strong></p>\n<p>When you activate a business process flow, Dataverse creates a dedicated instance table for that process (its own entity, not a column on the business table). Each record that enters the flow gets a row in this instance table, which stores the active stage, the entry timestamps for each step and the link to the main record. This has practical consequences:</p>\n<ul>\n<li>The current stage is <strong>not</strong> a simple column on your table — querying it means going to the BPF instance table.</li>\n<li>The BPF instance has its <strong>own ownership and security role</strong>. A user may see the business record but not the process bar if they lack privilege on the BPF entity.</li>\n<li>A single record can have <strong>more than one BPF instance</strong> (concurrent processes), and the user can switch between them — which changes which bar appears on the form.</li>\n</ul>\n<p><strong>Stages, steps and what each layer controls</strong></p>\n<p>A BPF is organized into <em>stages</em> (the dots on the bar) and, within each stage, <em>steps</em> (fields to fill). The critical distinction is:</p>\n<ul>\n<li>A <strong>required stage</strong> only blocks advancement if you mark the steps as <em>required</em>. Without that, the bar is purely visual and guarantees nothing.</li>\n<li>Steps can point to fields on <strong>different tables</strong> within the same flow — a BPF can span up to five related entities, which lets you model a process that goes from Lead to Opportunity, for instance.</li>\n<li>Advancing a stage is an event: you can trigger logic on <code>OnStageChange</code>/<code>OnStageSelected</code> via client scripting, or react to the active-stage field change in a server-side plugin/flow.</li>\n</ul>\n<p><strong>Branching: condition, not code</strong></p>\n<p>BPFs support conditional <em>branching</em> — the next stage depends on a field value. This covers forks such as \"if value > X, route through director approval.\" The limits are worth knowing before you design: branching is evaluated by declarative rules (up to a certain condition depth), it is not Turing-complete, and branches that reconverge must be modeled carefully to avoid duplicating stages. When decision logic turns into a complex tree with many crossings, that's a signal the rule belongs in a plugin or a flow, and the BPF should keep only the macro representation of the process.</p>\n<p><strong>The real limits that bite in production</strong></p>\n<ul>\n<li><strong>The number of active BPFs per entity and per organization</strong> is limited — don't spin up a flow for every variation; prefer branching inside one well-designed flow.</li>\n<li><strong>Stages per process and steps per stage</strong> have ceilings. Processes with dozens of steps are a hint that you're trying to use the BPF as a workflow engine rather than a state map.</li>\n<li>The instance table <strong>grows indefinitely</strong> if you never clean up completed or abandoned processes. At high volume this becomes dead weight that affects backups and queries.</li>\n<li><strong>Security</strong>: forgetting to grant privilege on the BPF entity makes the bar silently disappear for some roles — a classic hard-to-diagnose ticket.</li>\n<li>The BPF <strong>does not replace server validation</strong>. Since required steps only act on the UI, any write via API, flow or import ignores the rule. Rules that cannot be violated have to live in a server-side plugin.</li>\n</ul>\n<p><strong>When to use a BPF and when not to</strong></p>\n<p>Use a business process flow when the value is in <strong>guiding people</strong> through a standardized process in a model-driven app, giving visibility of the current stage, measuring time per step (the instance timestamps feed cycle-duration reports) and orchestrating progressive data entry spread across related entities.</p>\n<p>Don't use a BPF as an automation engine without human interaction — Power Automate and plugins exist for that. Don't use it when the process is mostly systemic (ingestion, integration, batch), nor when the visual bar adds nothing for the end user. And remember: the canonical state that other systems will query should usually be a <strong>status reason/choice on your own table</strong>, kept in sync with the stage by server logic — relying on the BPF instance table as the source of truth for integration is fragile.</p>\n<p><strong>Short decision checklist</strong></p>\n<ol>\n<li>Does the process have steps a person walks through in a model-driven app? If not, it's probably a flow/plugin, not a BPF.</li>\n<li>Do you need to measure time per step? The BPF gives you that for free through the timestamps.</li>\n<li>Can the advancement rule be violated via API/import? Then it must live in a plugin, not only in required steps.</li>\n<li>Has the decision logic grown into a complex tree? Simplify the BPF and push the decision to the server.</li>\n<li>Will it grow in volume? Plan cleanup of completed instances.</li>\n</ol>\n<p>Modeling long processes clearly — separating what is a visual map, what is an unbreakable rule and what is backstage automation — is the kind of architecture decision that avoids costly rework months later. If your company is structuring business processes on Dataverse and Dynamics 365, Dynamic Soluções' consulting teams and support plans help design that balance from the start, instead of patching it afterward.</p>"}},"pageContext":{"slug":"/blog/dataverse-business-process-flows-stages-processos-longos/","previousPost":null,"nextPost":{"frontmatter":{"title":"Dataverse: hierarchy security e manager hierarchy na prática"},"fields":{"slug":"/blog/dataverse-hierarchy-security-manager-position/"}}}},"staticQueryHashes":["2269431855"]}