ScriptableFlowRunner - Com escopo

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

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

Ordem de chamada de API

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

1. FlowAPI Cria um objeto do construtor

Usar GetRunner() Para instanciar o objeto do construtor ScriptableFlowRunner.

2. ScriptableFlowRunner : Especificar Workflow Studio conteúdo a ser executado

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

1. Use um dos métodos ação () , fluxo de dados () , fluxo () ou subfluxo () para especificar que tipo de Workflow Studio objeto a ser criado.
2. Use um ou mais métodos, como AddInput() , InDomain() ou rápido() para especificar parâmetros de execução.
3. Use executar() Método para executar a ação, o fluxo ou o subfluxo com os parâmetros fornecidos e retornar um objeto ScriptableFlowRunnerResult.

3. ScriptableFlowRunnerResult Recuperar Workflow Studio detalhes da execução

Use um ou mais métodos, como GetContextId() , GetOutputs() e GetDomainId() para exibir detalhes da execução.

Exemplo

Este exemplo mostra como criar um objeto do 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 - ação (cadeia de caracteres scopedActionName)

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

Consulte também:

• ScriptableFlowRunner - fluxo (cadeia de caracteres scopedFlowName)
• ScriptableFlowRunner - subfluxo (cadeia de caracteres scopedSubflowName)

Tabela 1. Parâmetros

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

Tabela 2. Retornos

Tipo	Descrição
ScriptableFlowRunner	Objeto do construtor usado para executar um Workflow Studio ação, fluxo ou subfluxo.

Este exemplo mostra como criar um objeto do 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 - addInput (nome da cadeia de caracteres, valor do objeto)

Adiciona uma única entrada. Se o nome passado como um 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 WithInputs() método.

Tabela 3. Parâmetros

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

Tabela 4. Retornos

Tipo	Descrição
ScriptableFlowRunner	Objeto do construtor usado para executar um Workflow Studio ação, 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 rápido() junto com AsUser() usuário que acionou o fluxo é recuperado e usado para a execução do fluxo.

Tabela 5. Parâmetros

Nome	Tipo	Descrição
Nenhum

Tabela 6. Retorna

Tipo	Descrição
ScriptableFlowRunner - Com escopo	Objeto do construtor usado para executar um Workflow Studio ação, fluxo ou subfluxo.

Este exemplo mostra como criar um objeto do construtor ScriptableFlowRunner e o usa para executar uma ação de aprovação em um registro específico usando AsUser() e. rápido() métodos. 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. AsUser() método:

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

ScriptableFlowRunner - Fluxo de dados (cadeia de caracteres scopedDatastamName)

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 Paginação e ações de fluxo de dados .

Tabela 7. Parâmetros

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

Tabela 8. Retornos

Tipo	Descrição
ScriptableFlowRunner	Objeto do construtor usado para executar um Workflow Studio ação, 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 - fluxo (cadeia de caracteres scopedFlowName)

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

Consulte também:

• ScriptableFlowRunner - ação (cadeia de caracteres scopedActionName)
• ScriptableFlowRunner - subfluxo (cadeia de caracteres scopedSubflowName)

Tabela 9. Parâmetros

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

Tabela 10. Retornos

Tipo	Descrição
ScriptableFlowRunner	Objeto do construtor usado para executar um Workflow Studio ação, fluxo ou subfluxo.

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

(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 - inBackground()

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

Tabela 11. Parâmetros

Nome	Tipo	Descrição
Nenhum

Tabela 12. Retorna

Tipo	Descrição
ScriptableFlowRunner	Objeto do construtor usado para executar um Workflow Studio ação, fluxo ou subfluxo.

Nota:

A partir de Xanadu Executar uma ação, fluxo ou subfluxo em segundo plano usando o método quick() retorna um ID de execução como o valor ContextId. O ID de execução não é um registro de contexto real, pois nenhum registro foi inserido na tabela Contexto de fluxo [sys_flow_context]. Em vez disso, o ID de execução é usado para rastrear a chamada assíncrona.

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

(function() {
    try {
  
      var result = sn_fd.FlowAPI.getRunner()
        .flow('global.change__unauthorized__review')
        .inBackground()
        .run();
  
      gs.info(result.debug());
  
    } catch (ex) {
      var message = ex.getMessage();
      gs.error(message);
    }
  
  })();

Saída:

[0:00:01.015] Script completed in scope global: script
––––––––––––––––––––––––––––––––––––––––––––––––––––--
Script execution history and recovery available here
Operation       Table                               Row Count
insert          sys_flow_context_inputs_chunk       1
insert          sys_flow_context                    1
––––––––––––––––––––––––––––––––––––––––––––––––––––--
Complex type redefined: FlowDesigner:FDCollection
Queued flow.fire event in NowMQ for sys_flow_context.sys_id: e0cd6e30b8b602104a8752ad4a9167c8,
sysevent.sys_id: 34cd6e30dbb60210497c1a48139619c9, with priority 5
*** Script: FlowRunnerResult
Flow Object Name: global.change__unauthorized__review
Flow Object Type: flow
Domain: null
Result Time: 2024-06-12 17:54:58
ContextId: e0cd6e30b8b602104a8752ad4a9167c8
Output count: 0

ScriptableFlowRunner - inDomain(cadeia de caracteres domainId)

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

Tabela 13. Parâmetros

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

Tabela 14. Retornos

Tipo	Descrição
ScriptableFlowRunner	Objeto do construtor usado para executar um Workflow Studio ação, fluxo ou subfluxo.

Este exemplo mostra como criar um objeto do 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 - inForeground()

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

Nota:

Este método não oferece suporte à pausa da ação para aguardar condições. Etapas que pausam para condições de espera, como Solicitar aprovação ou Aguardar condição, não são compatíveis.

Tabela 15. Parâmetros

Nome	Tipo	Descrição
Nenhum

Tabela 16. Retorna

Tipo	Descrição
ScriptableFlowRunner	Objeto do construtor usado para executar um Workflow Studio ação, fluxo ou subfluxo.

Este exemplo mostra como criar um objeto do 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

Independentemente de. Este método não cria detalhes de execução e registros de contexto Workflow Studio configurações.

Suporte à condição de espera

Este método não oferece suporte à pausa de uma ação ou fluxo para aguardar condições. Ações, lógica de fluxo e etapas que pausam para condições de espera, como Solicitar aprovação, aguardar condição ou aguardar por uma duração, não são compatíveis.

Suporte ao MID Server

Este método não é compatível com a 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 a partir de um MID Server.

Suporte à ação de fluxo de dados

Este método não é compatível com a pausa de uma ação de fluxo de dados para executar um script de pré-processamento de um MID Server.

Suporte à prioridade de fluxo

Este método oferece suporte a configurações de prioridade de fluxo. O fluxo é executado na prioridade de fluxo especificada.

Tabela 17. Parâmetros

Nome	Tipo	Descrição
Nenhum

Tabela 18. Retorna

Tipo	Descrição
ScriptableFlowRunner	Objeto do construtor usado para executar um Workflow Studio ação, fluxo ou subfluxo.

Nota:

A partir de Xanadu Executar uma ação, fluxo ou subfluxo em segundo plano usando o método quick() retorna um ID de execução como o valor ContextId. O ID de execução não é um registro de contexto real, pois nenhum registro foi inserido na tabela Contexto de fluxo [sys_flow_context]. Em vez disso, o ID de execução é usado para rastrear a chamada assíncrona.

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

(function() {
  try {

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

    gs.info(result.debug());

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

})();

Saída:

Complex type redefined: FlowDesigner:FDCollection
Queued flow.run.quick event in NowMQ for sys_flow_context.sys_id: d81781ec57801110403e8f90ac94f90e,
sysevent.sys_id: 48abe270dbf20210497c1a4813961908, with priority 5
*** Script: FlowRunnerResult
Flow Object Name: global.change__unauthorized__review
Flow Object Type: flow
Domain: null
Result Time: 2024-06-12 17:45:37
ContextId: 08abe2706cf202107b7d3b283f7ee108
Output count: 0

ScriptableFlowRunner - run()

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

Tabela 19. Parâmetros

Nome	Tipo	Descrição
Nenhum

Tabela 20. Retorna

Tipo	Descrição
ScriptableFlowRunnerResultsScoped	Objeto que contém os detalhes de execução de um Workflow Studio ação, fluxo ou subfluxo.

Este exemplo mostra como criar um objeto do 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 - subfluxo (cadeia de caracteres scopedSubflowName)

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

Consulte também:

• ScriptableFlowRunner - ação (cadeia de caracteres scopedActionName)
• ScriptableFlowRunner - fluxo (cadeia de caracteres scopedFlowName)

Tabela 21. Parâmetros

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

Tabela 22. Retornos

Tipo	Descrição
ScriptableFlowRunner	Objeto do construtor usado para executar um Workflow Studio ação, fluxo ou subfluxo.

Este exemplo mostra como executar um subfluxo que registra uma mensagem em log.

(function() {
  try {

    var result = sn_fd.FlowAPI.getRunner()
      .subflow('global.output_test')
      .inForeground()
      .run();
   
    gs.info(result.debug());

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

})();

Saída:

record-watcher asynchronous tracking complete - time: 1 ms. Executed responders: 1 
record-watcher asynchronous tracking complete - time: 1 ms. Executed responders: 1 
*** Script: FlowRunnerResult
Flow Object Name: global.output_test
Flow Object Type: subflow
Domain: null
Result Time: 2024-08-02 22:52:08
ContextId: b2dxx659bebf01101d72200x503x19pr
Output count: 2

ScriptableFlowRunner - tempo limite (tempo limite de número)

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

Tabela 23. Parâmetros

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

Tabela 24. Retornos

Tipo	Descrição
ScriptableFlowRunner	Objeto do construtor usado para executar um Workflow Studio ação, fluxo ou subfluxo.

Este exemplo mostra como executar um fluxo e define um tempo limite para 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 - validateInputs (booliano validateInputs)

Lance um erro e impeça que a classe ScriptableFlowRunner seja executada quando qualquer entrada de método tiver um valor inesperado. O padrão deste método é verdadeiro para qualquer chamada ScriptableFlowRunner.

Tabela 25. Parâmetros

Nome	Tipo	Descrição
ValidateInputs	Booliano	Sinalizador que indica se as entradas do método ScriptableFlowRunner devem ser validadas. Há dois valores válidos. Verdadeiro: Gera um erro quando as entradas têm valores inesperados e param de executar o script. Falso: Permite que o script seja executado com valores inesperados. Padrão: Verdadeiro

Tabela 26. Retornos

Tipo	Descrição
Nenhum(a)

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 Conexões e credenciais alias associado ao fluxo, ação ou subfluxo. Você pode substituir o alias primário padrão por qualquer um de seus aliases secundários.

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

Tabela 27. Parâmetros

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

Tabela 28. Retornos

Tipo	Descrição
ScriptableFlowRunner	Objeto do construtor usado para executar um Workflow Studio ação, 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 (mapear entradas)

Adiciona uma coleção de entradas. Se um nome em um dos pares 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 nome-valor que definem entradas para o fluxo, subfluxo ou ação.

Tabela 30. Retornos

Tipo	Descrição
ScriptableFlowRunner	Objeto do construtor usado para executar um Workflow Studio ação, fluxo ou subfluxo.

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

(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 Workflow Studio.

Quando um fluxo é acionado usando rápido() junto com ComRoles() , as funções definidas nas propriedades de 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 do construtor usado para executar um Workflow Studio ação, fluxo ou subfluxo.

Este exemplo mostra como criar um objeto do construtor ScriptableFlowRunner e o usa para executar uma ação de aprovação em um registro específico usando ComRoles() e. rápido() métodos. 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. ComRoles() método:

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