ScriptableFlowRunner - com escopo

Crie um objeto de construtor usado para definir parâmetros de fluxo, subfluxo e execução de ação. Você pode especificar um fluxo para executar em um domínio específico. Inicie o fluxo, subfluxo ou execução de ação diretamente do construtor e exiba os resultados em um objeto ScriptableFlowRunnerResult.

Use esses métodos em seus scripts do lado do servidor com o identificador de namespace sn_fd.

Ordem de chamada de API

Crie e execute fluxos, subfluxos e ações usando essas APIs na seguinte ordem:

1. FlowAPI: cria um objeto de construtor

Use getRunner() para criar uma instância do objeto do construtor ScriptableFlowRunner.

2. ScriptableFlowRunner: especifique o conteúdo Flow Designer a ser executado

Use esses métodos na seguinte ordem para criar o padrão do construtor:

1. Use um dos métodos action(), datastream(), flow()ou subflow() para especificar que tipo de objeto Flow Designer criar.
2. Use um ou mais métodos, como addInput(), inDomain()ou quick() para especificar parâmetros de execução.
3. Use o método run() para executar a ação, o fluxo ou o subfluxo com os parâmetros fornecidos e retornar um objeto ScriptableFlowRunnerResult.

3. ScriptableFlowRunnerResult: recuperar Flow Designer detalhes de execução

Use um ou mais métodos, como getContextId(), getOutputs()e getDomainId() para exibir os detalhes da execução.

Exemplo

Este exemplo mostra como criar um objeto de construtor ScriptableFlowRunner e o usa para executar uma ação de aprovação em um registro específico. Um objeto ScriptableFlowRunnerResult captura os argumentos de execução e as saídas da ação.

(function() {
  try {

    var inputs = {}; 

    inputs['sys_id'] = '57af7aec73d423002728660c4cf6a71c';  // Pass the record's sys_id in as input.  

    var result = sn_fd.FlowAPI.getRunner()  // Create a ScriptableFlowRunner builder object.
      .action('global.markapproved')        // Run the global scope action named markapproved.
      .inForeground()
      .inDomain('TOP/ACME')                 // Run the action from the TOP/ACME domain.                               
      .withInputs(inputs)
      .run();                               // Run the action and return a FlowRunnerResult object.

    var contextId = result.getContextId();  // Retrieve the context ID from the result
    var dateRun = result.getDate();
    var domainUsed = result.getDomainId();  // Retrieve the Domain ID from the result.
    var flowName = result.getFlowObjectName();
    var flowObjectType = result.getFlowObjectType();

    var outputs = result.getOutputs();            // Retrieve any outputs from the action execution.
    var newApprovalStatus = outputs['approval'];  // Echo back the approval status for verification.
		
  } catch (ex) {
    var message = ex.getMessage();
    gs.error(message);
  }
	
})();
   

ScriptableFlowRunner - action(cadeia de caracteres scopedActionName)

Identifica o escopo e o nome da ação a ser executada.

Tabela 1. Parâmetros

Nome	Tipo	Descrição
scopedActionName	Cadeia de caracteres	Escopo e nome da ação a ser executada. Por exemplo, global.actionName.

Tabela 2. Retorna

Tipo	Descrição
ScriptableFlowRunner	Objeto de construtor usado para executar uma ação Flow Designer, fluxo ou subfluxo.

Este exemplo mostra como criar um objeto de construtor ScriptableFlowRunner e o usa para executar uma ação de aprovação em um registro específico. Um objeto ScriptableFlowRunnerResult captura os argumentos de execução e as saídas da ação.

(function() {
  try {

    var inputs = {}; 

    inputs['sys_id'] = '57af7aec73d423002728660c4cf6a71c';  // Pass the record's sys_id in as input.  

    var result = sn_fd.FlowAPI.getRunner()  // Create a ScriptableFlowRunner builder object.
      .action('global.markapproved')        // Run the global scope action named markapproved.
      .inForeground()
      .inDomain('TOP/ACME')                 // Run the action from the TOP/ACME domain.                               
      .withInputs(inputs)
      .run();                               // Run the action and return a FlowRunnerResult object.

    var contextId = result.getContextId();  // Retrieve the context ID from the result
    var dateRun = result.getDate();
    var domainUsed = result.getDomainId();  // Retrieve the Domain ID from the result.
    var flowName = result.getFlowObjectName();
    var flowObjectType = result.getFlowObjectType();

    var outputs = result.getOutputs();            // Retrieve any outputs from the action execution.
    var newApprovalStatus = outputs['approval'];  // Echo back the approval status for verification.
		
  } catch (ex) {
    var message = ex.getMessage();
    gs.error(message);
  }
	
})();
   

ScriptableFlowRunner - flow(cadeia de caracteres scopedFlowName)

Identifica o escopo e o nome do fluxo a ser executado.

Tabela 3. Parâmetros

Nome	Tipo	Descrição
scopedFlowName	Cadeia de caracteres	Escopo e nome do fluxo a ser executado. Por exemplo, global.flowName.

Tabela 4. Retorna

Tipo	Descrição
ScriptableFlowRunner	Objeto de construtor usado para executar uma ação Flow Designer, fluxo ou subfluxo.

Este exemplo mostra como executar um fluxo que registra uma mensagem.

(function() {
  try {

    var result = sn_fd.FlowAPI.getRunner()
      .flow('global.test_flow')
      .inForeground()
      .run();

    gs.info(result.debug());

  } catch (ex) {
    var message = ex.getMessage();
    gs.error(message);
  }

})();

Saída:

*** Script: FlowRunnerResult
Flow Object Name: global.test_flow
Flow Object Type: flow
Domain: null
Result Time: 2020-06-08 16:41:13
ContextId: null
Output count: 0

ScriptableFlowRunner - subflow(cadeia de caracteres scopedSubflowName)

Identifica o escopo e o nome do subfluxo a ser executado.

Tabela 5. Parâmetros

Nome	Tipo	Descrição
scopedSubflowName	Cadeia de caracteres	Escopo e nome do subfluxo a ser executado. Por exemplo, global.subflowName.

Tabela 6. Retorna

Tipo	Descrição
ScriptableFlowRunner	Objeto de construtor usado para executar uma ação Flow Designer, fluxo ou subfluxo.

(function() {
  try {

    var result = sn_fd.FlowAPI.getRunner()
      .subflow('global.test_subflow')
      .inForeground()
      .run();

    gs.info(result);

  } catch (ex) {
    var message = ex.getMessage();
    gs.error(message);
  }

})();

Saída:

Flow Designer: Cloning a new session to run as as user id: [user_name] from original user session: [user_name]
Flow Designer: Message to log
Flow Designer: Reverting cloned session to original user session: [user_name]
*** Script: FlowRunnerResult
Flow Object Name: global.test_subflow
Flow Object Type: flow
Domain: null
Result Time: 2020-06-08 16:41:13
ContextId: null
Output count: 0

ScriptableFlowRunner - addInput(cadeia de caracteres name, Object value)

Adiciona uma única entrada. Se o nome passado como argumento já existir como uma entrada separada, o novo valor substituirá o valor preexistente.

Este método adiciona uma única entrada. Para criar um objeto e adicionar várias entradas, use o método withInputs().

Tabela 7. Parâmetros

Nome	Tipo	Descrição
nome	Cadeia de caracteres	O nome da entrada para o fluxo, subfluxo ou ação.
valor	Objeto	O valor da entrada para o fluxo, subfluxo ou ação.

Tabela 8. Retorna

Tipo	Descrição
ScriptableFlowRunner	Objeto de construtor usado para executar uma ação Flow Designer, fluxo ou subfluxo.

Este exemplo executa uma ação que usa uma única entrada chamada table_name.

(function() {
  try {

    var result = sn_fd.FlowAPI.getRunner()
      .action('global.test_action')
      .addInput('table_name', 'incident')
      .inForeground()
      .run();

    gs.info(result.debug());

  } catch (ex) {
    var message = ex.getMessage();
    gs.error(message);
  }

})();

Saída:

Flow Designer: TableName
*** Script: FlowRunnerResult
Flow Object Name: global.test_action
Flow Object Type: action
Domain: null
Result Time: 2020-06-09 00:10:57
ContextId: null
Output count: 1

ScriptableFlowRunner - asUser()

Executa o fluxo como o usuário que o acionou, não o sistema, para execuções rápidas em segundo plano.

Quando um fluxo é acionado usando quick() junto com o método asUser(), o usuário que acionou o fluxo é recuperado e usado para a execução do fluxo.

Tabela 9. Parâmetros

Nome	Tipo	Descrição
Nenhum

Tabela 10. Retorna

Tipo	Descrição
ScriptableFlowRunner - com escopo	Objeto de construtor usado para executar uma ação Flow Designer, fluxo ou subfluxo.

Este exemplo mostra como criar um objeto de construtor ScriptableFlowRunner e usá-lo para executar uma ação de aprovação em um registro específico usando os métodos asUser() e quick(). Um objeto ScriptableFlowRunnerResult captura os argumentos de execução e as saídas da ação.

(function() {
    try {

        var outputs = sn_fd.FlowAPI.getRunner() // Create a ScriptableFlowRunner builder object.
        .flow('global.stry53225960_flow_asuser_test')
        .inForeground()
        .quick() //Run the flow from a server-side script.
        .asUser() //Run flow with the roles specified in the flow.
        .run(); // Run the action and return a FlowRunnerResult object.

    } catch (ex) {
        var message = ex.getMessage();
        gs.error(message);
    }  

})();

Erros

Esses erros podem ocorrer ao usar o método asUser() :

• O script retorna um erro quando asUser() não é usado junto com quick().
• O script retorna um erro quando asUser() é chamado em um fluxo que tem funções definidas.
• O script retorna um erro quando os métodos withRoles() e asUser() são chamados ao mesmo tempo.

ScriptableFlowRunner - datastream(cadeia de caracteres scopedDatastreamName)

Identifica o escopo e o nome da ação de fluxo de dados a ser executada.

Para saber mais sobre ações de fluxo de dados, consulte Ações de fluxo de dados e paginação.

Tabela 11. Parâmetros

Nome	Tipo	Descrição
scopedDatastreamName	Cadeia de caracteres	Escopo e nome da ação de fluxo de dados a ser executada. Por exemplo, global.dataStreamActionName.

Tabela 12. Retorna

Tipo	Descrição
ScriptableFlowRunner	Objeto de construtor usado para executar uma ação Flow Designer, fluxo ou subfluxo.

Este exemplo mostra como executar uma ação de Fluxo de dados.

(function() {
  try {

    var result = sn_fd.FlowAPI.getRunner()
      .datastream('global.test_dsa')
      .inForeground()
      .run();

    gs.info(result.debug());

  } catch (ex) {
    var message = ex.getMessage();
    gs.error(message);
  }

})();

Saída:

*** Script: FlowRunnerResult
Flow Object Name: global.test_dsa
Flow Object Type: datastream
Domain: null
Result Time: 2020-06-08 16:41:13
ContextId: null
Output count: 0

ScriptableFlowRunner - inBackground()

Executa o fluxo, subfluxo ou ação de forma assíncrona. Depois que o objeto de fluxo começa a ser executado, a execução do script é retomada imediatamente.

Tabela 13. Parâmetros

Nome	Tipo	Descrição
Nenhum

Tabela 14. Retorna

Tipo	Descrição
ScriptableFlowRunner	Objeto de construtor usado para executar uma ação Flow Designer, fluxo ou subfluxo.

Este exemplo mostra como executar um fluxo de forma assíncrona.

(function() {
  try {

    var result = sn_fd.FlowAPI.getRunner()
      .flow('global.test_flow')
      .inBackground()
      .run();

    gs.info(result.debug());

  } catch (ex) {
    var message = ex.getMessage();
    gs.error(message);
  }

})();

Saída:

Flow Designer: Cloning a new session to run as as user id: [user_name] from original user session: [user_name]
Flow Designer: Message to log
Flow Designer: Reverting cloned session to original user session: [user_name]
*** Script: FlowRunnerResult
Flow Object Name: global.test_flow
Flow Object Type: flow
Domain: null
Result Time: 2020-06-08 16:41:13
ContextId: null
Output count: 0

ScriptableFlowRunner - inDomain(cadeia de caracteres domainId)

Executa o fluxo, subfluxo ou ação no domínio especificado. Verifica se o domínio existe e está disponível.

Tabela 15. Parâmetros

Nome	Tipo	Descrição
domainId	Cadeia de caracteres	O sys_id ou o nome do domínio de execução do fluxo.

Tabela 16. Retorna

Tipo	Descrição
ScriptableFlowRunner	Objeto de construtor usado para executar uma ação Flow Designer, fluxo ou subfluxo.

Este exemplo mostra como criar um objeto de construtor ScriptableFlowRunner e o usa para executar uma ação de aprovação em um registro específico. Um objeto ScriptableFlowRunnerResult captura os argumentos de execução e as saídas da ação.

(function() {
  try {

    var inputs = {}; 

    inputs['sys_id'] = '57af7aec73d423002728660c4cf6a71c';  // Pass the record's sys_id in as input.  

    var result = sn_fd.FlowAPI.getRunner()  // Create a ScriptableFlowRunner builder object.
      .action('global.markapproved')        // Run the global scope action named markapproved.
      .inForeground()
      .inDomain('TOP/ACME')                 // Run the action from the TOP/ACME domain.                               
      .withInputs(inputs)
      .run();                               // Run the action and return a FlowRunnerResult object.

    var contextId = result.getContextId();  // Retrieve the context ID from the result
    var dateRun = result.getDate();
    var domainUsed = result.getDomainId();  // Retrieve the Domain ID from the result.
    var flowName = result.getFlowObjectName();
    var flowObjectType = result.getFlowObjectType();

    var outputs = result.getOutputs();            // Retrieve any outputs from the action execution.
    var newApprovalStatus = outputs['approval'];  // Echo back the approval status for verification.
		
  } catch (ex) {
    var message = ex.getMessage();
    gs.error(message);
  }
	
})();
   

ScriptableFlowRunner - emForeground()

Executa o fluxo, subfluxo ou ação de forma síncrona. A execução do script é pausada enquanto o objeto de fluxo está sendo executado.

Nota:

Este método não oferece suporte à pausa da ação para aguardar as condições. Não há suporte para etapas que pausam para condições de espera, como Solicitar aprovação ou Aguardar condição.

Tabela 17. Parâmetros

Nome	Tipo	Descrição
Nenhum

Tabela 18. Retorna

Tipo	Descrição
ScriptableFlowRunner	Objeto de construtor usado para executar uma ação Flow Designer, fluxo ou subfluxo.

Este exemplo mostra como criar um objeto de construtor ScriptableFlowRunner e o usa para executar uma ação de aprovação em um registro específico. Um objeto ScriptableFlowRunnerResult captura os argumentos de execução e as saídas da ação.

(function() {
  try {

    var inputs = {}; 

    inputs['sys_id'] = '57af7aec73d423002728660c4cf6a71c';  // Pass the record's sys_id in as input.  

    var result = sn_fd.FlowAPI.getRunner()  // Create a ScriptableFlowRunner builder object.
      .action('global.markapproved')        // Run the global scope action named markapproved.
      .inForeground()
      .inDomain('TOP/ACME')                 // Run the action from the TOP/ACME domain.                               
      .withInputs(inputs)
      .run();                               // Run the action and return a FlowRunnerResult object.

    var contextId = result.getContextId();  // Retrieve the context ID from the result
    var dateRun = result.getDate();
    var domainUsed = result.getDomainId();  // Retrieve the Domain ID from the result.
    var flowName = result.getFlowObjectName();
    var flowObjectType = result.getFlowObjectType();

    var outputs = result.getOutputs();            // Retrieve any outputs from the action execution.
    var newApprovalStatus = outputs['approval'];  // Echo back the approval status for verification.
		
  } catch (ex) {
    var message = ex.getMessage();
    gs.error(message);
  }
	
})();
   

ScriptableFlowRunner - quick()

Executa um fluxo, subfluxo, ação ou ação de Fluxo de dados de um script do lado do servidor de forma síncrona ou assíncrona sem criar detalhes de execução ou outros registros relacionados. Melhora o desempenho ao eliminar a sobrecarga de manutenção de registros. Use esta API para aumentar a velocidade do processamento de alto volume, por exemplo, várias execuções por segundo, em um ambiente de produção.

Relatórios e registros gerados

Este método não cria detalhes de execução e registros de contexto, independentemente das configurações Flow Designer.

Suporte à condição de espera

Este método não oferece suporte à pausa de uma ação ou fluxo para aguardar as condições. Não há suporte para ações, lógica de fluxo e etapas que pausam para condições de espera, como Solicitar aprovação, Aguardar condição ou Aguardar uma duração.

Suporte para MID Server

Este método não oferece suporte à pausa de uma ação ou fluxo para executar a partir de um MID Server. Esta restrição inclui scripts de pré-processamento de ação de fluxo de dados que pausam uma ação para ser executada em um MID Server.

Suporte à ação de fluxo de dados

Este método não oferece suporte à pausa de uma ação de fluxo de dados para executar um script de pré-processamento de um MID Server.

Tabela 19. Parâmetros

Nome	Tipo	Descrição
Nenhum

Tabela 20. Retorna

Tipo	Descrição
ScriptableFlowRunner	Objeto de construtor usado para executar uma ação Flow Designer, fluxo ou subfluxo.

Este exemplo mostra como executar um fluxo sem criar registros relacionados.

(function() {
  try {

    var result = sn_fd.FlowAPI.getRunner()
      .flow('global.test_flow')
      .inForeground()
      .quick()
      .run();

    gs.info(result);

  } catch (ex) {
    var message = ex.getMessage();
    gs.error(message);
  }

})();

Saída:

Flow Designer: Message to log.
*** Script: [object FlowRunnerResult]

ScriptableFlowRunner - executar ()

Executa o fluxo, subfluxo ou ação com os parâmetros especificados.

Tabela 21. Parâmetros

Nome	Tipo	Descrição
Nenhum

Tabela 22. Retorna

Tipo	Descrição
ScriptableFlowRunnerResultsCoped	Objeto que contém os detalhes de execução de uma ação Flow Designer, fluxo ou subfluxo.

Este exemplo mostra como criar um objeto de construtor ScriptableFlowRunner e o usa para executar uma ação de aprovação em um registro específico. Um objeto ScriptableFlowRunnerResult captura os argumentos de execução e as saídas da ação.

(function() {
  try {

    var inputs = {}; 

    inputs['sys_id'] = '57af7aec73d423002728660c4cf6a71c';  // Pass the record's sys_id in as input.  

    var result = sn_fd.FlowAPI.getRunner()  // Create a ScriptableFlowRunner builder object.
      .action('global.markapproved')        // Run the global scope action named markapproved.
      .inForeground()
      .inDomain('TOP/ACME')                 // Run the action from the TOP/ACME domain.                               
      .withInputs(inputs)
      .run();                               // Run the action and return a FlowRunnerResult object.

    var contextId = result.getContextId();  // Retrieve the context ID from the result
    var dateRun = result.getDate();
    var domainUsed = result.getDomainId();  // Retrieve the Domain ID from the result.
    var flowName = result.getFlowObjectName();
    var flowObjectType = result.getFlowObjectType();

    var outputs = result.getOutputs();            // Retrieve any outputs from the action execution.
    var newApprovalStatus = outputs['approval'];  // Echo back the approval status for verification.
		
  } catch (ex) {
    var message = ex.getMessage();
    gs.error(message);
  }
	
})();
   

ScriptableFlowRunner - timeout (tempo limite do número)

Define um tempo limite para um fluxo, subfluxo ou execução de ação.

Tabela 23. Parâmetros

Nome	Tipo	Descrição
tempo limite	Número	Tempo limite em milissegundos.

Tabela 24. Retorna

Tipo	Descrição
ScriptableFlowRunner	Objeto de construtor usado para executar uma ação Flow Designer, fluxo ou subfluxo.

Este exemplo mostra como executar um fluxo e define um tempo limite de dois minutos.

(function() {
  try {

    var result = sn_fd.FlowAPI.getRunner()
      .flow('global.test_flow')
      .inForeground()
      .timeout(120000)
      .run();

    gs.info(result.debug());

  } catch (ex) {
    var message = ex.getMessage();
    gs.error(message);
  }

})(); 

Saída:

Flow Designer: Cloning a new session to run as as user id: [user_name] from original user session: [user_name]
Flow Designer: Reverting cloned session to original user session: [user_name]
*** Script: FlowRunnerResult
Flow Object Name: global.test_flow
Flow Object Type: flow
Domain: null
Result Time: 2020-06-08 18:22:35
ContextId: null
Output count: 0

ScriptableFlowRunner - ValidationInputs(booliano identifyInputs)

Lança um erro e impede a execução da classe ScriptableFlowRunner quando qualquer entrada de método tem um valor inesperado. O padrão deste método é verdadeiro para qualquer chamada ScriptableFlowRunner.

Tabela 25. Parâmetros

Nome	Tipo	Descrição
validarEntradas	Booliano	Sinalizador que indica se as entradas do método ScriptableFlowRunner devem ser validadas. Há dois valores válidos. verdadeiro: emite um erro quando as entradas têm valores inesperados e interrompe a execução do script. falso: permite que o script seja executado com valores inesperados. Padrão: verdadeiro

Tabela 26. Retorna

Tipo	Descrição
Nenhum

Este exemplo mostra como executar um fluxo sem validar os valores de entrada do método.

(function() {
  try {

    var result = sn_fd.FlowAPI.getRunner()
      .flow('global.test_flow')
      .inForeground()
      .validateInputs(false)
      .run();

    gs.info(result.debug());

  } catch (ex) {
    var message = ex.getMessage();
    gs.error(message);
  }

})();

Saída:

*** Script: FlowRunnerResult
Flow Object Name: global.test_flow
Flow Object Type: flow
Domain: null
Result Time: 2020-06-08 16:41:13
ContextId: null
Output count: 0

ScriptableFlowRunner - withConnectionAliasOverride(cadeia de caracteres aliasName, cadeia de caracteres overrideName)

Substitui o alias Conexões e credenciais associado ao fluxo, ação ou subfluxo. Você pode substituir o alias primário padrão por qualquer um dos aliases secundários.

Para saber mais sobre como substituir um alias Conexões e credenciais, consulte Suporte a várias conexões.

Tabela 27. Parâmetros

Nome	Tipo	Descrição
parentAliasSysID	Cadeia de caracteres	O sys_id do alias primário, o alias que você deseja substituir.
overrideAliasSysID	Cadeia de caracteres	O sys_id do alias secundário, o alias que você deseja usar ao executar o fluxo, subfluxo ou ação.

Tabela 28. Retorna

Tipo	Descrição
ScriptableFlowRunner	Objeto de construtor usado para executar uma ação Flow Designer, fluxo ou subfluxo.

Este exemplo mostra como executar um fluxo usando um alias diferente do padrão associado ao fluxo.

(function() {
  try {

    var result = sn_fd.FlowAPI.getRunner()
      .flow('global.test_flow')
      .withConnectionAliasOverride('sn_original_alias.spoke', 'x_new_alias.spoke')
      .inForeground()
      .run();

    gs.info(result.debug());

  } catch (ex) {
    var message = ex.getMessage();
    gs.error(message);
  }

})();

ScriptableFlowRunner - withInputs(Map inputs)

Adiciona uma coleção de entradas. Se um nome em um dos pares de nome-valor já existir, o novo valor substituirá o valor preexistente.

Tabela 29. Parâmetros

Nome	Tipo	Descrição
entradas	Objeto	Objeto de mapa que contém os pares de nome-valor que definem entradas para o fluxo, subfluxo ou ação.

Tabela 30. Retorna

Tipo	Descrição
ScriptableFlowRunner	Objeto de construtor usado para executar uma ação Flow Designer, fluxo ou subfluxo.

Cria um objeto de entrada e passa o valor para o método withInputs().

(function() {
  try {

    var inputs = {}; 

    inputs['sys_id'] = '57af7aec73d423002728660c4cf6a71c';  // Pass the record's sys_id in as input.  

    var result = sn_fd.FlowAPI.getRunner()  // Create a ScriptableFlowRunner builder object.
      .action('global.markapproved')        // Run the global scope action named markapproved.
      .inForeground()
      .inDomain('TOP/ACME')                 // Run the action from the TOP/ACME domain.                               
      .withInputs(inputs)
      .run();                               // Run the action and return a FlowRunnerResult object.

    var contextId = result.getContextId();  // Retrieve the context ID from the result
    var dateRun = result.getDate();
    var domainUsed = result.getDomainId();  // Retrieve the Domain ID from the result.
    var flowName = result.getFlowObjectName();
    var flowObjectType = result.getFlowObjectType();

    var outputs = result.getOutputs();            // Retrieve any outputs from the action execution.
    var newApprovalStatus = outputs['approval'];  // Echo back the approval status for verification.
		
  } catch (ex) {
    var message = ex.getMessage();
    gs.error(message);
  }
	
})();
   

ScriptableFlowRunner - withRoles()

Executa o fluxo como o usuário que acionou o fluxo ou executa o fluxo com funções que foram adicionadas em Flow Designer.

Quando um fluxo é acionado usando quick() junto com o método withRoles(), as funções definidas nas propriedades do fluxo são recuperadas, passadas durante a execução do fluxo e o fluxo é executado com as funções.

Tabela 31. Parâmetros

Nome	Tipo	Descrição
Nenhum

Tabela 32. Retorna

Tipo	Descrição
ScriptableFlowRunner - com escopo	Objeto de construtor usado para executar uma ação Flow Designer, fluxo ou subfluxo.

Este exemplo mostra como criar um objeto de construtor ScriptableFlowRunner e usá-lo para executar uma ação de aprovação em um registro específico usando os métodos withRoles() e quick(). Um objeto ScriptableFlowRunnerResult captura os argumentos de execução e as saídas da ação.

(function() {
    try {

        var outputs = sn_fd.FlowAPI.getRunner() // Create a ScriptableFlowRunner builder object.
        .flow('global.stry53225960_flow')
        .inForeground()
        .quick() //Run the flow from a server-side script.
        .withRoles() //Run the flow as the user who triggered the flow.
        .run(); // Run the action and return a FlowRunnerResult object.

    } catch (ex) {
        var message = ex.getMessage();
        gs.error(message);

    }  

})();

Erros

Esses erros podem ocorrer ao usar o método withRoles() :

• withRoles() não executará nenhuma operação se não for usado junto com quick().
• O script retorna um erro quando withRoles() é chamado em um fluxo que não tem funções.
• O script retorna um erro quando os métodos withRoles() e asUser() são chamados ao mesmo tempo.