Subfluxo - com escopo (descontinuado)

  • Versão de lançamento: Washingtondc
  • Atualizado 1 de fev. de 2024
  • 2 min. de leitura
  • A API de subfluxo fornece métodos para executar subfluxos Flow Designer publicados.

    Esta API está obsoleta e foi substituída por FlowAPI - com escopo, global.

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

    Use o namespace sn_fd para acessar a API de subfluxo.

    Antes de interagir com um subfluxo usando a API de subfluxo, você deve primeiro criar e publicar o subfluxo na interface Flow Designer. Como a API de subfluxo 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 de um script de regra de negócio assíncrono. Em vez disso, crie um registro de trabalho programado na IU Flow Designer.

    Subfluxo com escopo - startAsync(cadeia de caracteres scopeName.subflowName, Mapear entradas)

    Executa um subfluxo publicado de forma assíncrona.

    As chamadas assíncronas não são bloqueadas, 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 para o 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 a coluna Nome interno na página principal Flow Designer.
    entradas Mapa Pares de 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 de referência ou ID de documento, use um objeto GlideRecord como o valor.
    Tabela 2. Retorna
    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 Flow Designer e filtrando por sys_id.
    Uma exceção ocorre quando o subfluxo:
    • Não existe no escopo da aplicação especificado ou o subfluxo ou o nome do escopo foi digitado incorretamente.
    • Não foi publicado.
    • É passado um objeto de entrada que não corresponde às entradas do subfluxo.
    • Excede o limite de recursão definido pela propriedade do sistema com.glide.hub.flow_engine.indirect_recursion_limit. 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);
      }
    
    })();