PDAutomationProvider - Com escopo, global

  • Versão de lançamento: Zurich
  • Atualizado 31 de jul. de 2025
  • 10 min. de leitura

    • . PDAutomationProvider A API permite a inserção de uma atividade opcional em um processo durante a execução.

    Esta API faz parte do Playbooks plug-in (com.glide.pad.core) e é executado no sn_pad namespace.

    Chamar scripts com esta API requer pelo menos um dos seguintes:
    • O solicitante deve estar no mesmo escopo em que o gatilho de atividade opcional foi criado.
    • Privilégios de administrador.

    Um processo é uma série de atividades ordenadas por raias. Uma atividade opcional é predefinida durante o design do processo. As atividades não estão programadas para serem executadas em um horário preciso. Uma atividade pode ser atribuída a uma raia e disponibilizada para execução durante a execução da raia. Uma atividade pode ser atribuída a um processo e disponibilizada para execução durante a execução da raia.

    Para criar uma atividade opcional, ela deve ter Regra de início definido como Manual Na tabela Atividades [sys_pd_activity]. Playbooks no momento, não é compatível com a criação de atividades manuais.

    Um agente adiciona a atividade opcional a uma raia ou atividade relativa a outra atividade. O processo deve estar em execução para inserir uma atividade opcional.

    Consulte também:

    PDAutomationProvider – activateProcess(cadeia de caracteres processDefinitionSysId)

    Ativa um playbook.

    Tabela 1. Parâmetros
    Nome Tipo Descrição
    ProcessDefinitionSysId Cadeia de caracteres Sys_id de um playbook.

    Tabela: Definições de processo [sys_pd_process_definition]
    Tabela 2. Retornos
    Propriedade Descrição
    Objeto Objeto que contém detalhes de ativação da definição do processo.
    {
  "errors": [Array]
  "process_definition": {Object},
  "state": "String"
}
    erros Lista de erros. Vazio se bem-sucedido.

    Tipo de dados: Matriz de cadeia(s) de caracteres
    process_definition Playbook ativado e suas propriedades.

    Tipo de dados: Objeto

    "process_definition":
{
  "active": Boolean,
  "snapshot": {Object},
  "status": "String"
}
    process_definition.active Sinalizador que indica se a definição do processo do playbook desativado está ativa. Encontre definições de processo na lista Definições de processo [sys_pd_process_definition].
    Valores válidos:
    • Verdadeiro: A definição do processo do playbook desativado está ativa.
    • Falso: A definição do processo do playbook desativado está inativa.

    Tipo de dados: Booliano
    process_definition.snapshot Contém detalhes sobre a definição do processo no momento da ativação.

    Tipo de dados: Objeto

    {
  "snapshot":
    {
      "created": "String",
      "processDefinitionSysId": "String"
    }
}
    process_definition. snapshot. criado A data em que o playbook foi criado.

    Tipo de dados: Cadeia de caracteres
    process_definition. snapshot. ProcessDefinitionSysId O sys_id do playbook ativado.

    Tipo de dados: Cadeia de caracteres
    process_definition.status Indica o status de publicação do playbook.
    Valores possíveis:
    • Rascunho: O playbook está no estado de rascunho.
    • Publicado: O playbook está no estado Publicado.

    Tipo de dados: Cadeia de caracteres
    estado Indica se sua solicitação para ativar foi bem-sucedida ou não.
    Valores possíveis:
    • Playbook foi ativado com SUCESSO.
    • ID do playbook não encontrado.

    Tipo de dados: Objeto

    O exemplo a seguir mostra como ativar um playbook.

    var myPlaybook = sn_pad.PDAutomationProvider.activateProcess('cdd1b85e43000210d96e29c28ab8f275');
gs.info(JSON.stringify(myPlaybook));
    Saída: 
    {
  "process_definition": {
    "active": true,
    "snapshot": {
      "processDefinitionId": "cdd1b85e43000210d96e29c28ab8f275",
      "created": "2024-02-19 22:58:12"
    },
    "status": "published"
  },
  "state": "SUCCESS",
  "errors": []
}

    PDAutomationProvider – addOptionalActivityRelativeToActivityContext(cadeia de caracteres contextID, cadeia de caracteres activityId, cadeia de caracteres where, cadeia de caracteres relativeToId)

    Adiciona uma atividade opcional especificada a um processo a ser executado em relação a outra atividade durante a execução do processo.

    Um contexto de atividade é criado para cada atividade quando um processo é executado. O contexto também lida com como a atividade lida com a execução. Para obter informações, consulte Raias e atividades do Designer de automação de processos .

    Tabela 3. Parâmetros
    Nome Tipo Descrição
    contextID Cadeia de caracteres Sys_id da execução da atividade na qual a atividade opcional será adicionada. Para acessar, clique no processo listado na tabela Execuções de processo [sys_pd_context]. A execução selecionada deve estar em um estado de Em andamento .
    activityId Cadeia de caracteres Sys_id da atividade opcional listada na tabela Atividades [sys_pd_activity].
    Nota:
    Para criar uma atividade opcional, ela deve ter Regra de início definido como Manual Na tabela Atividades [sys_pd_activity].
    onde Cadeia de caracteres Indica onde colocar a atividade no processo.
    Valores válidos:
    • APÓS - Executa esta atividade após a atividade relativa contexto.
    • COM - Executa a atividade ao mesmo tempo que outra atividade relativa contexto.
    RelativoTo Id Cadeia de caracteres ID do contexto de atividade relativa em que a atividade opcional será executada após ou com. Listado na tabela Contexto de atividade [sys_pd_activity_context].
    Tabela 4. Retornos
    Tipo Descrição
    Booliano Sinalizador que indica se a atividade foi programada para ser executada com sucesso.
    Valores possíveis:
    • Verdadeiro: A atividade foi programada para ser executada com sucesso. A saída é uma cadeia de caracteres informando sucesso .
    • Falso: A atividade não está programada para ser executada com sucesso. A saída é uma matriz de uma ou mais mensagens de erro.

    Se houver erros, lista de uma ou mais mensagens de erro. Mensagem informando Matriz de 0 ou mais elementos caso contrário.

    Matriz Se houver erros, lista de uma ou mais mensagens de erro. Mensagem informando Matriz de 0 ou mais elementos caso contrário.
    Possíveis mensagens de erro:
    • ID de atividade opcional inválido O sys_id fornecido para activityIdo parâmetro é inválido.
    • ID de contexto de PD inválido O sys_id do Designer de processos (PD) fornecido no contextIDo parâmetro é inválido.
    • Tipo de posição inválido : O tipo de posição fornecido é inválido. Consulte a descrição do whereparâmetro para tipos válidos.
    • ID de relativo inválido O sys_id fornecido para relativeToIdo parâmetro é inválido.
    • Atividade opcional não encontrada O sys_id fornecido para activityIdo parâmetro não foi encontrado.
    • O processo ainda deve estar ativo : O processo que contém esta atividade deve estar ativo para executar a atividade opcional.
    • Contexto de atividade relativa não encontrado O sys_id fornecido para relativeToIdo parâmetro não foi encontrado.

    O exemplo a seguir mostra como executar uma atividade opcional simultaneamente com o contexto de atividade relativa.

    var contextId = '<context_id>';
var optionalActivityId = '<optional_activity_id>';
var where = 'WITH'; // options AFTER, WITH
var relativeToId = '<relative_activity_context_id>'; // relative activity context ID

var response = sn_pad.PDAutomationProvider.addOptionalActivityRelativeToActivityContext(contextId, optionalActivityId, where, relativeToId);

gs.info(JSUtil.describeObject(response));
    Saída (sucesso):
    success: boolean = true
errors: Array of 0 elements

    PDAutomationProvider – addOptionalActivityRelativeToLaneContext(cadeia de caracteres contextID, cadeia de caracteres activityId, cadeia de caracteres where, cadeia de caracteres relativeToId)

    Atribui uma atividade opcional a uma raia para ser executada durante o contexto de execução dessa raia.

    Um contexto de raia é criado para cada raia quando um processo é executado. O contexto também lida com como a raia lida com a execução. Para obter informações, consulte Raias e atividades do Designer de automação de processos .

    Tabela 5. Parâmetros
    Nome Tipo Descrição
    contextID Cadeia de caracteres Sys_id da execução da atividade na qual a atividade opcional será adicionada. Para acessar, clique no processo listado na tabela Execuções de processo [sys_pd_context]. A execução selecionada deve estar em um estado de Em andamento .
    activityId Cadeia de caracteres Sys_id da atividade opcional listada na tabela Atividades [sys_pd_activity].
    Nota:
    Para criar uma atividade opcional, ela deve ter Regra de início definido como Manual Na tabela Atividades [sys_pd_activity].
    onde Cadeia de caracteres Indica onde colocar a atividade no processo.
    Valores válidos:
    • LAST - Executa como a atividade final em uma raia contexto.
    • PRÓXIMO - Executa a próxima atividade em uma raia contexto.
    RelativoTo Id Cadeia de caracteres ID do contexto da raia relativa no qual a atividade opcional será executada. Listado na tabela Contexto de raia [sys_pd_lane_context].
    Tabela 6. Retornos
    Tipo Descrição
    Booliano Sinalizador que indica se a atividade foi programada para ser executada com sucesso.
    Valores possíveis:
    • Verdadeiro: A atividade foi programada para ser executada com sucesso. A saída é uma cadeia de caracteres informando sucesso .
    • Falso: A atividade não está programada para ser executada com sucesso. A saída é uma matriz de uma ou mais mensagens de erro.
    Matriz Se houver erros, lista de uma ou mais mensagens de erro. Mensagem informando Matriz de 0 ou mais elementos caso contrário.
    Possíveis mensagens de erro:
    • ID de atividade opcional inválido O sys_id fornecido para activityIdo parâmetro é inválido.
    • ID de contexto de PD inválido O sys_id do Designer de processos (PD) fornecido no contextIDo parâmetro é inválido.
    • Tipo de posição inválido : O tipo de posição fornecido é inválido. Consulte a descrição do whereparâmetro para tipos válidos.
    • ID de relativo inválido O sys_id fornecido para relativeToIdo parâmetro é inválido.
    • A atividade opcional não pode ser adicionada à raia : A atividade opcional fornecida no activityIdo parâmetro não pode ser adicionado em relação à raia fornecida em relativeToIdparâmetro. Certifique-se de que Execução de atividade selecionado está em Em andamento estado.
    • Atividade opcional não encontrada O sys_id fornecido para activityIdo parâmetro não foi encontrado.
    • O processo ainda deve estar ativo : O processo que contém esta atividade deve estar ativo para executar a atividade opcional.
    • Contexto de raia relativa não encontrado O sys_id fornecido para relativeToIdo parâmetro não foi encontrado.

    O exemplo a seguir mostra como executar uma atividade opcional como a atividade final em um contexto de raia.

    var contextId = '<context_id>';
var optionalActivityId = '<optional_activity_id>';
var where = 'LAST'; // options LAST, NEXT
var relativeToId = '<relative_lane_context_id>'; // relative lane context ID

var response = sn_pad.PDAutomationProvider.addOptionalActivityRelativeToLaneContext(contextId, optionalActivityId, where, relativeToId);

gs.info(JSUtil.describeObject(response));
    Saída (sucesso):
    success: boolean = true
errors: Array of 0 elements

    PDAutomationProvider – deactivateProcess(cadeia de caracteres processDefinitionSysId)

    Desativa um playbook.

    Tabela 7. Parâmetros
    Nome Tipo Descrição
    ProcessDefinitionSysId Cadeia de caracteres Sys_id de um playbook.

    Tabela: Definições de processo [sys_pd_process_definition]
    Tabela 8. Retornos
    Propriedade Descrição
    Objeto Objeto que contém detalhes de desativação da definição do processo.
    {
  "errors": [Array]
  "process_definition": {Object},
  "state": "String"
}
    erros Lista de erros. Vazio se bem-sucedido.

    Tipo de dados: Matriz de cadeia(s) de caracteres
    process_definition Playbook desativado e suas propriedades.

    Tipo de dados: Objeto

    "process_definition":
{
  "active": Boolean,
  "snapshot": {Object},
  "status": "String"
}
    process_definition.active Indica se a definição do processo do playbook desativado está ativa. Encontre definições de processo na lista Definições de processo [sys_pd_process_definition].
    Valores possíveis:
    • Verdadeiro: A definição do processo do playbook desativado está ativa.
    • Falso: A definição do processo do playbook desativado está inativa.

    Tipo de dados: Booliano
    process_definition.description Detalhes sobre seu playbook desativado.

    Tipo de dados: Cadeia de caracteres
    process_definition.label O nome do playbook desativado que os usuários veem na interface.

    Tipo de dados: Cadeia de caracteres
    process_definition.name O nome do playbook desativado no código. Usado somente como parâmetro de solicitação em script.

    Tipo de dados: Cadeia de caracteres
    process_definition.scope O sys_id do escopo da aplicação para o qual seu playbook está desativado.

    Tipo de dados: Cadeia de caracteres
    process_definition.status Se o playbook for publicado, ele voltará para um rascunho.

    Tipo de dados: Cadeia de caracteres
    estado Indica se a desativação foi bem-sucedida.
    Valores possíveis:
    • Playbook foi desativado com SUCESSO.
    • ID do playbook não encontrado.

    Tipo de dados: Cadeia de caracteres

    Desative o playbook.

    sn_pad.PDAutomationProvider.deactivateProcess('cdd1b85e43000210d96e29c28ab8f275')

    Saídas:

    {"process_definition":{"scope":"global","name":"test","active":true,"description":"","label":"test","status":"draft"},"state":"SUCCESS"}

    PDAutomationProvider – duplicateProcess(cadeia de caracteres processDefinitionSysId, rótulo de cadeia de caracteres, descrição de cadeia de caracteres, cadeia de caracteres scopeId, cadeia de caracteres triggerTypeId)

    Duplica um playbook.

    Tabela 9. Parâmetros
    Nome Tipo Descrição
    ProcessDefinitionSysId Cadeia de caracteres Sys_id de um playbook.

    Tabela: Definições de processo [sys_pd_process_definition]
    rótulo Cadeia de caracteres O nome do playbook duplicado.
    descrição Cadeia de caracteres Opcional. Adicione detalhes sobre seu playbook.
    scopeId Cadeia de caracteres O sys_id do escopo da aplicação em que você deseja que o playbook seja executado. O nome com escopo é da tabela Definição de processo [sys_pd_process_definition] no formato scope.name . Inserir o sys_id para o escopo global permite que o playbook seja executado em qualquer escopo da aplicação.
    TriggerTypeId Cadeia de caracteres O sys_id do gatilho a partir do qual iniciar as execuções do playbook. Encontre o tipo de gatilho na tabela Tipo de gatilho [sys_pd_trigger_type] e copie seu sys_id.
    Tabela 10. Retornos
    Propriedade Descrição
    Objeto Objeto que contém detalhes de duplicação de definição de processo.
    {
  "errors": [Array]
  "processDefinitionSysId": "String",
  "state": "String"
}
    erros Lista de erros. Vazio se bem-sucedido.

    Tipo de dados: Matriz de cadeia(s) de caracteres

    Possíveis mensagens de erro:
    • Escopo não encontrado para scopeId: xyz
    • Definição de processo não encontrada para o ID: xyz
    • Tipo de gatilho não encontrado para triggerTypeId: xyz
    ProcessDefinitionSysId O sys_id do novo playbook na tabela Definições de processo [sys_pd_process_definition].

    Tipo de dados: Cadeia de caracteres
    estado Indica se a duplicação do playbook foi bem-sucedida.
    Valores possíveis:
    • Playbook foi duplicado com sucesso - O playbook foi duplicado com sucesso.
    • ID do playbook, escopo da aplicação ou gatilho não foi encontrado.

    Tipo de dados: Objeto

    Este exemplo mostra como duplicar um playbook com o sys_id f8ca6192ec210f875cbd595eab20 . O novo playbook é nomeado Playbook 2,0 tem um escopo de aplicação de Global e é acionado quando um registro é criado. . Criação de registro o tipo de gatilho tem um sys_id de ab6951170f1200108c87f4f0ff767e4f .

    sn_pad.PDAutomationProvider.duplicateProcess('f8ca6192ec210210f8772cbd595eab20', 'Playbook 2.0', '', 'global', 'ab6951170f1200108c87f4f0ff767e4f');

    Saída:

    {"processDefinitionSysId":"6e4f0b8fece9c210f8772cbd595eabda","state":"SUCCESS"}