Subfluxo - Com escopo (descontinuado)

  • Versão de lançamento: Zurich
  • Atualizado 31 de jul. de 2025
  • 2 min. de leitura
  • . Subfluxo A API fornece métodos para executar publicados Workflow Studio subfluxos.

    Esta API foi descontinuada e substituída pelo FlowAPI - escopo, global.

    . Subfluxo A API só pode ser usada em scripts de servidor.

    Use sn_fd namespace para acessar Subfluxo API.

    Antes de interagir com um subfluxo usando Subfluxo , você deve primeiro criar e publicar o subfluxo no Workflow Studio interface. . Subfluxo A API interage somente com subfluxos pré-criados, não há construtor para a classe.

    Nota:
    Para otimizar o desempenho da instância, evite chamar esses métodos a partir de um script de regra de negócio assíncrono. Em vez disso, crie um registro de trabalho agendado no Workflow Studio IU.

    StartAsync(cadeia de caracteres scopeName.subflowName, mapear entradas)

    Executa um subfluxo publicado de forma assíncrona.

    As chamadas assíncronas não são bloqueadoras, permitindo que o cliente execute outro código no script sem precisar aguardar a conclusão do subfluxo.

    Tabela 1. Parâmetros
    Nome Tipo Descrição
    ScopeName.SubflowName Cadeia de caracteres O escopo da aplicação do subfluxo e o nome interno do subfluxo a ser executado. Se scopeName não estiver incluído, o escopo do usuário conectado no momento será usado. Recupere o nome interno do subfluxo usando Nome interno coluna no Workflow Studio página principal.
    entradas Mapa Pares nome-valor que definem entradas de subfluxo. Se um subfluxo incluir entradas obrigatórias, elas deverão ser incluídas. Para entradas de tipos de campo Referência ou ID do documento, use um objeto GlideRecord como o valor.
    Tabela 2. Retornos
    Tipo Descrição
    Objeto Objeto PlanResponse que contém as seguintes propriedades:
    • ContextId: Sys_id do registro de detalhes da execução do subfluxo executado. Acesse os detalhes da execução navegando até a guia Execuções de fluxo em Workflow Studio e filtrando por sys_id.
    Ocorre uma exceção quando o subfluxo:
    • Não existe no escopo da aplicação especificado ou o subfluxo ou o nome do escopo foi incorreto.
    • Não foi publicado.
    • Um objeto de entrada que não corresponde às entradas do subfluxo é passado.
    • Excede o limite de recursão definido pelo com.glide.hub.flow_engine.indirect_recursion_limitpropriedade do sistema. O valor padrão é três.
    //Run a subflow that takes two inputs: user, a sys_user record, and laptop_welcome_message, a string.
    (function startSubflowAsync() {
    
      try {
        var userToProvisionFor = new GlideRecord('sys_user');
        userToProvisionFor.get('62826bf03710200044e0bfc8bcbe5df1');
    
        var inputs = {};
        inputs['user'] = userToProvisionFor;
        inputs['laptop_welcome_message'] = 'Welcome Onboard!!';
    
        var result = sn_fd.Subflow.startAsync('sn_devstudio.provisionlaptop', inputs);
    
        //The Sys ID of a flow execution (contextId)
        var contextId = result.contextId;
    
      } catch (ex) {
        var message = ex.getMessage();
        gs.error(message);
      }
    
    })();