PlaybookExperience - Com escopo

  • Versão de lançamento: Yokohama
  • Atualizado 30 de jan. de 2025
  • 13 min. de leitura

    • . PlaybookExperience A API fornece métodos para lidar com execuções de playbook.

    Esta API requer o plug-in do Playbook Experience Core (com.glide.playbook_experience.config) e é fornecida no sn_playbook namespace.

    Esta API requer pelo menos um playbook na tabela Definição de processo [sys_pd_process_definition]. Para usar esta API, você deve ter as funções necessárias para exibir e cancelar um processo em execução no Designer de automação de processos. Para obter mais informações, consulte Designer de automação de processos .

    PlaybookExperience - cancelPlaybooksByParentRecord(GlideRecord parentRecord, cadeia de caracteres cancelationReason, cadeia de caracteres scopedName, cadeia de caracteres playbookExperience Id)

    Cancela as execuções do playbook para um determinado registro primário.

    Tabela 1. Parâmetros
    Nome Tipo Descrição
    parentRecord GlideRecord O registro primário para o qual cancelar as execuções do playbook. O registro primário pode ser qualquer registro que tenha execuções de playbook, como um registro de interação ou um registro de caso de integração.
    CancelationReason Cadeia de caracteres O motivo para cancelar as execuções do playbook.
    scopedName Cadeia de caracteres Opcional. O nome com escopo do playbook a ser cancelado. O nome com escopo é da tabela Definição de processo [sys_pd_process_definition] no formato scope.name . Se fornecido, somente as execuções deste playbook serão canceladas para o registro primário fornecido. Se não fornecido, todas as execuções de todos os playbooks serão canceladas para o registro primário fornecido.
    playbookExperienceId Cadeia de caracteres Opcional. O sys_id do registro do playbook Experience na tabela do playbook Experience [sys_playbook_experience] a ser usado para o cancelamento. Use este parâmetro se você tiver definido mapeamentos de estado de atividade personalizados. Consulte Mapeamento do estado de atividade do playbook .

    Padrão: Sys_id do registro da Experiência global do playbook.
    Tabela 2. Retornos
    Tipo Descrição
    Objeto Objeto que contém as execuções canceladas do playbook e todas as execuções ignoradas do playbook que não puderam ser canceladas. 
    {
  "canceledPlaybookContext": [Array],
  "skippedPlaybookContext": [Array]
}
    <Object>Context .canceledPlaybookContext Lista de execuções canceladas do playbook. Cada execução do playbook é um objeto na matriz.

    Tipo de dados: Matriz

    "canceledPlaybookContext": [
    {
      "can_read": Boolean,
      "canceled_by": "String",
      "cancellation_reason": "String",
      "errors": [Array],
      "parent_record": "String",
      "parent_table": "String",
      "playbook_id": "String",
      "playbook_table": "String",
      "scoped_name": "String",
      "state": {Object},
      "sys_id": "String",
      "title": "String"   
    }
]
    <Object>.canceledPlaybookContext.can_read

    Sinalizador que indica se o usuário atual pode ler o registro de execução do playbook. O usuário atual deve ter acesso de leitura ao registro primário para poder ler o registro de execução do playbook.

    Valores válidos:
    • Verdadeiro: O usuário atual tem acesso de leitura ao registro de execução do playbook.
    • Falso: O usuário atual não tem acesso de leitura ao registro de execução do playbook.

    Tipo de dados: Booliano
    <Object>.canceledPlaybookContext.canceled_by . ID do usuário do usuário que cancelou a execução do playbook.

    Tipo de dados: Cadeia de caracteres
    <Object>.canceledPlaybookContext.cancelation_reason A entrada do motivo do cancelamento pelo usuário que cancelou a execução do playbook.

    Tipo de dados: Cadeia de caracteres
    <Object>.CanceledPlaybookContext.Erros Lista de erros de cancelamento. Cada erro é um objeto na matriz.

    Tipo de dados: Matriz

    "errors": [
    {      
      "message": "String",
      "type": "String"  
    }
]
    <Object>.CanceledPlaybookContext.errors.message A mensagem de erro.

    Tipo de dados: Cadeia de caracteres
    <Object>.CanceledPlaybookContext.errors.type O tipo de erro.

    Tipo de dados: Cadeia de caracteres
    <Object>.CanceledPlaybookContext.parent_record Sys_id do registro primário para o qual as execuções do playbook foram canceladas.

    Tipo de dados: Cadeia de caracteres
    <Object>.CanceledPlaybookContext.parent_table O nome da tabela de origem do registro primário.

    Tipo de dados: Cadeia de caracteres
    <Object>.canceledPlaybookContext.playbook_id Sys_id do playbook da tabela Definições de processo [sys_pd_process_definition].

    Tipo de dados: Cadeia de caracteres
    <Object>.canceledPlaybookContext.playbook_table O nome da tabela de origem do playbook, geralmente a tabela Definições de processo [sys_pd_process_definition].

    Tipo de dados: Cadeia de caracteres
    <Object>.CanceledPlaybookContext.Scoped_name O nome com escopo do playbook da tabela Definições de processo [sys_pd_process_definition] no formato scope.name .

    Tipo de dados: Cadeia de caracteres
    <Object>.CanceledPlaybookContext.state O estado da execução do playbook da tabela Execuções de processo [sys_pd_context].

    Tipo de dados: Objeto

    "state": {    
   "displayValue": "String",    
   "value": "String"
}
    <Object>.CanceledPlaybookContext.state.displayValue O valor de exibição do estado de execução do playbook.

    Tipo de dados: Cadeia de caracteres
    <Object>.CanceledPlaybookContext.state.value O valor do estado de execução do playbook.

    Tipo de dados: Cadeia de caracteres
    <Object>.CanceledPlaybookContext.sys_id Sys_id da execução do playbook da tabela Execuções de processo [sys_pd_context].

    Tipo de dados: Cadeia de caracteres
    <Object>.CanceledPlaybookContext.title O rótulo da execução do playbook da tabela Execuções de processo [sys_pd_context].

    Tipo de dados: Cadeia de caracteres
    <Object>.SkippedPlaybookContext Lista de execuções de playbook ignoradas. Cada execução do playbook é um objeto na matriz. Para obter descrições das propriedades do objeto, consulte canceledPlaybookContextmatriz.

    Tipo de dados: Matriz

    "skippedPlaybookContext": [
    {
      "can_read": Boolean,
      "canceled_by": "String",
      "cancellation_reason": "String",
      "errors": [Array],
      "parent_record": "String",
      "parent_table": "String",
      "playbook_id": "String",
      "playbook_table": "String",
      "scoped_name": "String",
      "state": {Object},
      "sys_id": "String",
      "title": "String"   
    }
]

    Este exemplo mostra como cancelar todas as execuções de um playbook específico (neste caso, a demonstração do Playbook Experience) para um determinado registro de interação. Para usar este método em uma ação de IU ou regra de negócios, passe em atual Em vez disso, o objeto é o parentRecord.

    var parentRecord = new GlideRecordUtil().getGR("interaction", "d91742531b343010a26c98a1b24bcbe0");

var cancellationReason = "Cancelling this playbook";

// demo playbook from Process Automation Experience Demo store app
var scopedName = "sn_pad_demo.playbook_experience_demo"; 

// demo playbook experience from Process Automation Experience Demo store app
var playbookExperienceId = "a56d8d93ff311010cc0853ea793bf1a6"; 
	
var cancelPlaybookReturn = sn_playbook.PlaybookExperience.cancelPlaybooksByParentRecord(parentRecord, cancellationReason, scopedName, playbookExperienceId);
	

gs.info(JSON.stringify(cancelPlaybookReturn, null, 2));

    Saída:

    {
  "canceledPlaybookContext": [
    {
      "can_read": true,
      "sys_id": "d02782533d343010ac50ee17e75d3466",
      "scoped_name": "sn_pad_demo.playbook_experience_demo",
      "canceled_by": "admin",
      "playbook_table": "sys_pd_process_definition",
      "state": {
        "displayValue": "Pending Cancel",
        "value": "PENDING_CANCEL"
      },
      "title": "Playbook Experience Demo",
      "parent_record": "d91742531b343010a26c98a1b24bcbe0",
      "playbook_id": "0d35ee1807301010cc08d9630ad3002a",
      "cancellation_reason": "Cancelling this playbook",
      "parent_table": "interaction",
      "errors": []
    }
  ],
  "skippedPlaybookContext": []
}

    PlaybookExperience - getPlaybooksForParentRecord(GlideRecord parentRecord)

    Obtém uma lista de execuções de playbook para um determinado registro primário.

    Tabela 3. Parâmetros
    Nome Tipo Descrição
    parentRecord GlideRecord O registro primário para o qual obter as execuções do playbook. O registro primário pode ser qualquer registro que possa ter execuções de playbook, como um registro de interação ou um registro de caso de integração.
    Tabela 4. Retornos
    Tipo Descrição
    Matriz Lista de execuções do playbook para o registro primário. Cada execução do playbook é um objeto na matriz.
    [
    {
      "can_read": Boolean,
      "canceled_by": "String",
      "cancellation_reason": "String",
      "errors": [Array],
      "parent_record": "String",
      "parent_table": "String",
      "playbook_id": "String",
      "playbook_table": "String",
      "scoped_name": "String",
      "state": {Object},
      "sys_id": "String",
      "title": "String"   
    }
]
    <Array>.can_read

    Sinalizador que indica se o usuário atual pode ler o registro de execução do playbook. O usuário atual deve ter acesso de leitura ao registro primário para poder ler o registro de execução do playbook.

    Valores válidos:
    • Verdadeiro: O usuário atual tem acesso de leitura ao registro de execução do playbook.
    • Falso: O usuário atual não tem acesso de leitura ao registro de execução do playbook.

    Tipo de dados: Booliano
    <Array>.Cancelled_by . ID do usuário do usuário que cancelou a execução do playbook. Vazio se o playbook não for cancelado.

    Tipo de dados: Cadeia de caracteres
    <Array>.cancelation_reason A entrada do motivo do cancelamento pelo usuário que cancelou a execução do playbook. Vazio se o playbook não for cancelado.

    Tipo de dados: Cadeia de caracteres
    <Array>.Erros Lista de erros. Cada erro é um objeto na matriz.

    Tipo de dados: Matriz

    "errors": [
    {      
      "message": "String",
      "type": "String"  
    }
]
    Mensagem.Erros.<Array> A mensagem de erro.

    Tipo de dados: Cadeia de caracteres
    Erros.tipo.<Array> O tipo de erro.

    Tipo de dados: Cadeia de caracteres
    <Array>.parent_record Sys_id do registro primário.

    Tipo de dados: Cadeia de caracteres
    <Array>.parent_table O nome da tabela de origem do registro primário.

    Tipo de dados: Cadeia de caracteres
    <Array>.playbook_id Sys_id do playbook da tabela Definições de processo [sys_pd_process_definition].

    Tipo de dados: Cadeia de caracteres
    <Array>.playbook_table O nome da tabela de origem do playbook, geralmente a tabela Definições de processo [sys_pd_process_definition].

    Tipo de dados: Cadeia de caracteres
    <Array>.Scoped_name O nome com escopo do playbook da tabela Definições de processo [sys_pd_process_definition] no formato scope.name .

    Tipo de dados: Cadeia de caracteres
    <Array>.state O estado da execução do playbook da tabela Execuções de processo [sys_pd_context].

    Tipo de dados: Objeto

    "state": {    
   "displayValue": "String",    
   "value": "String"
}
    <Array>.state.displayValue O valor de exibição do estado de execução do playbook.

    Tipo de dados: Cadeia de caracteres
    <Array>.state.value O valor do estado de execução do playbook.

    Tipo de dados: Cadeia de caracteres
    Sys_id do <Array>.sys_id Sys_id da execução do playbook da tabela Execuções de processo [sys_pd_context].

    Tipo de dados: Cadeia de caracteres
    <Array>.title O rótulo da execução do playbook da tabela Execuções de processo [sys_pd_context].

    Tipo de dados: Cadeia de caracteres

    Este exemplo mostra como obter execuções de playbook para um determinado registro de interação. Para usar este método em uma ação de IU ou regra de negócios, passe em atual Em vez disso, o objeto é o parentRecord.

    var parentRecord = new GlideRecordUtil().getGR("interaction", "148776e5818d7410f87701eb89fdc824");
var playbook = sn_playbook.PlaybookExperience.getPlaybooksForParentRecord(parentRecord);
gs.info(JSON.stringify(playbook, null, 2));

    Saída:

    [
  {
    "can_read": true,
    "sys_id": "bd87bae50b8d7410807a8ffed6d0909e",
    "scoped_name": "sn_pad_demo.playbook_experience_demo",
    "canceled_by": "",
    "playbook_table": "sys_pd_process_definition",
    "state": {
      "displayValue": "In Progress",
      "value": "IN_PROGRESS"
    },
    "title": "Playbook Experience Demo",
    "parent_record": "148776e5818d7410f87701eb89fdc824",
    "playbook_id": "0d35ee1807301010cc08d9630ad3002a",
    "cancellation_reason": "",
    "parent_table": "interaction",
    "errors": []
  }
]

    PlaybookExperience - parentRecordContainsplaybook(GlideRecord parentRecord, cadeia de caracteres scopedName)

    Verifica se um registro primário tem execuções de playbook.

    Tabela 5. Parâmetros
    Nome Tipo Descrição
    parentRecord GlideRecord O registro primário para verificar se há execuções do playbook. O registro primário pode ser qualquer registro que possa ter execuções de playbook, como um registro de interação ou um registro de caso de integração.
    scopedName Cadeia de caracteres Opcional. O nome com escopo do playbook a ser verificado. O nome com escopo é da tabela Definição de processo [sys_pd_process_definition] no formato scope.name . Se fornecido, somente as execuções deste playbook serão verificadas. Se não fornecido, as execuções de todos os playbooks serão verificadas.
    Tabela 6. Retornos
    Tipo Descrição
    Booliano

    Sinalizador que indica se o registro primário tem execuções de playbook.

    Valores válidos:
    • Verdadeiro: O registro primário tem execuções de playbook.
    • Falso: O registro primário não tem execuções de playbook.

    Este exemplo mostra como verificar se um determinado registro de interação tem execuções de um playbook específico (neste caso, a demonstração do Playbook Experience). Para usar este método em uma ação de IU ou regra de negócios, passe em atual Em vez disso, o objeto é o parentRecord.

    var parentRecord = new GlideRecordUtil().getGR("interaction", "148776e5818d7410f87701eb89fdc824");

// demo playbook from Process Automation Experience Demo store app
var scopedName = "sn_pad_demo.playbook_experience_demo"; 

var hasPlaybooks = sn_playbook.PlaybookExperience.parentRecordContainsPlaybook(parentRecord, scopedName);
gs.info(hasPlaybooks);

    Saída:

    true

    PlaybookExperience - restartPlaybook(cadeia de caracteres playbookContextId, cadeia de caracteres laneContextId, cadeia de caracteres activityContextId, cadeia de caracteres playbookExperience)

    Reinicia uma execução do início (todo o playbook) ou de uma fase ou atividade específica de um playbook.

    Nota:
    Somente playbooks que estão no estado Em andamento, Em fila ou em cancelamento pendente podem ser reiniciados.
    Tabela 7. Parâmetros
    Nome Tipo Descrição
    playbookContextId Cadeia de caracteres Sys_id do registro de contexto do playbook para a execução ou execução do playbook que você deseja reiniciar.

    Tabela: Execução do processo [sys_pd_context]
    laneContextId Cadeia de caracteres Opcional. O sys_id do registro de contexto da fase para a execução ou execução da fase a partir da qual você deseja reiniciar.
    Nota:
    Somente fases concluídas podem ser reiniciadas.

    Tabela: Execuções de raia [sys_pd_lane_context]
    activityContextId Cadeia de caracteres Opcional. O sys_id do registro de contexto de atividade da execução ou execução da atividade da qual você deseja reiniciar.
    Nota:
    Somente atividades concluídas podem ser reiniciadas.

    Tabela: Execuções de atividades [sys_pd_activity_context]
    playbookExperienceId Cadeia de caracteres Opcional. O sys_id da experiência do playbook que você deseja usar para a execução reiniciada. Use este parâmetro se você tiver definido mapeamentos de estado de atividade personalizados. Consulte Mapeamento do estado de atividade do playbook .

    Padrão: Experiência global do playbook

    Tabela: Experiência do playbook [sys_playbook_experience]
    Tabela 8. Retornos
    Propriedade Descrição
    Objeto Objeto que contém os detalhes da execução do playbook reiniciado.
    {
 "can_add_activity": Boolean,
 "can_cancel": Boolean,
 "can_read": Boolean
 "can_restart": Boolean,
 "canceled_by": "String",
 "cancellation_reason": "String",
 "errors": [Array]
 "is_archived": Boolean
 "parent_record": "String",
 "parent_table": "String",
 "playbook_id": "String",
 "playbook_table": "String",
 "scoped_name": "String",
 "state": {Object},
 "sys_id": "String",
 "title": "String",
}
    can_add_activity Sinalizador que indica se um usuário pode adicionar uma atividade opcional ao playbook.
    Valores válidos:
    • Verdadeiro: O usuário atual pode adicionar uma atividade opcional ao playbook.
    • Falso: O usuário atual não pode adicionar uma atividade opcional ao playbook.

    Tipo de dados: Booliano
    can_cancel Sinalizador que indica se um usuário pode cancelar um playbook.
    • Verdadeiro: A definição de processo do playbook desativado está ativa.
    • Falso: A definição de processo do playbook desativado está inativa.

    Tipo de dados: Booliano
    can_read Sinalizador que indica se o usuário atual pode ler o registro de execução do playbook. O usuário atual deve ter acesso de leitura ao registro primário para poder ler o registro de execução do playbook.
    • Verdadeiro: O usuário atual tem acesso de leitura ao registro de execução do playbook.
    • Falso: O usuário atual não tem acesso de leitura ao registro de execução do playbook.

    Tipo de dados: Booliano
    can_restart Sinalizador que indica se um usuário pode reiniciar um playbook, fase ou atividade.
    • Verdadeiro: O usuário atual pode reiniciar o playbook, a fase ou a atividade.
    • Falso: O usuário atual não pode reiniciar o playbook, fase ou atividade.

    Tipo de dados: Booliano
    cancelled_by ID do usuário do usuário que cancelou a execução do playbook.

    Tipo de dados: Cadeia de caracteres
    cancelation_reason Motivo do cancelamento inserido pelo usuário que cancelou a execução do playbook.

    Tipo de dados: Cadeia de caracteres
    erros Lista de erros de reinicialização. Cada erro é um objeto na matriz.

    Tipo de dados: Matriz

    "errors": [
 {      
  "message": "String",
  "type": "String"  
 }
]
    _arquivado Sinalizador que indica se os registros de contexto do playbook estão arquivados.
    Valores possíveis:
    • Verdadeiro: Os registros de contexto do playbook estão arquivados.
    • Falso: Os registros de contexto do playbook não estão arquivados.

    Tipo de dados: Booliano
    parent_record Sys_id do registro primário para o qual as execuções do playbook foram reiniciadas.

    Tipo de dados: Cadeia de caracteres
    parent_table Nome da tabela de origem do registro primário.

    Tipo de dados: Cadeia de caracteres
    playbook_id Sys_id do playbook.

    Tipo de dados: Cadeia de caracteres

    Tabela: Definições de processo [sys_pd_process_definition]
    playbook_table Nome da tabela de origem do playbook, geralmente a tabela Definições de processo [sys_pd_process_definition].

    Tipo de dados: Cadeia de caracteres
    scoped_name Opcional. O nome com escopo do playbook a ser reiniciado. O nome com escopo é da tabela Definição de processo [sys_pd_process_definition] no formato scope.name . Se fornecido, somente as execuções deste playbook serão reiniciadas para o registro primário fornecido. Se não for fornecido, todas as execuções de todos os playbooks serão reiniciadas para o registro primário fornecido.

    Tipo de dados: Cadeia de caracteres
    estado Indica se sua solicitação para ativar foi bem-sucedida.

    Tipo de dados: Objeto

    Valores possíveis:
    • SUCESSO: O playbook foi ativado com sucesso.
    • FALHA: O ID do playbook não foi encontrado.
    "state": [
    {      
      "displayValue": "String",
      "value": "String"  
    }
]
    Valor.displayValue Valor de exibição do estado de execução do playbook.

    Tipo de dados: Cadeia de caracteres
    valor.estado Valor do estado de execução do playbook.

    Tipo de dados: Cadeia de caracteres
    sys_id Sys_id da execução do playbook.

    Tipo de dados: Cadeia de caracteres

    Tabela: Execuções de processos [sys_pd_context]
    título Rótulo da execução do playbook.

    Tipo de dados: Cadeia de caracteres

    Tabela: Execuções de processos [sys_pd_context]

    Este exemplo mostra como reiniciar uma execução inteira do playbook com as execuções de processo [sys_pd_context] ID de registro 98e4fe04591b4caca59583f7b8e30b0a.

    var gr = new GlideRecord('sys_pd_context');
var found = gr.get('98e4fe04591b4caca59583f7b8e30b0a'); 
if (found) {
    var result = sn_playbook.PlaybookExperience.restartPlaybook(gr);
    gs.info(JSON.stringify(result));
}
else
    gs.info('invalid pd context');

    Saída:

    {
 "scoped_name": "global.restart_scriptable_demo",
 "canceled_by": "",
 "can_add_activity": true,
 "playbook_table": "sys_pd_process_definition",
 "can_restart": true,
 "can_cancel": true,
 "title": "Restart scriptable demo",
 "cancellation_reason": "",
 "parent_table": "interaction",
 "can_read": true,
 "sys_id": "98e4fe04591b4caca59583f7b8e30b0a",
 "is_archived": false,
 "state": {
   "displayValue": "In Progress",
   "value": "IN_PROGRESS"
 },
 "parent_record": "b88623beb5e10210f877d783f6f83a46",
 "playbook_id": "12d5a7fab5e10210f877d783f6f83aff",
 "errors": []
}

    PlaybookExperience - triggerPlaybook (cadeia de caracteres scopedName, GlideRecord parentRecord)

    Inicia um playbook para um registro primário.

    Tabela 9. Parâmetros
    Nome Tipo Descrição
    scopedName Cadeia de caracteres O nome com escopo do playbook a ser iniciado. O nome com escopo é da tabela Definição de processo [sys_pd_process_definition] no formato scope.name .
    parentRecord GlideRecord O registro primário para o qual iniciar um playbook. O registro primário pode ser qualquer registro que possa ter execuções de playbook, como um registro de interação ou um registro de caso de integração.
    Tabela 10. Retornos
    Tipo Descrição
    Cadeia de caracteres Sys_id da execução do playbook da tabela Execuções de processo [sys_pd_context] que foi criada para o registro primário. Nulo se uma execução de playbook não foi criada com sucesso.

    Este exemplo mostra como iniciar um playbook para um determinado registro de interação. Para usar este método em uma ação de IU ou regra de negócios, passe em atual Em vez disso, o objeto é o parentRecord.

    var parentRecord = new GlideRecordUtil().getGR("interaction", "148776e5818d7410f87701eb89fdc824");

// demo playbook from Process Automation Experience Demo store app
var scopedName = "sn_pad_demo.playbook_experience_demo"; 

var playbookExecution = sn_playbook.PlaybookExperience.triggerPlaybook(scopedName, parentRecord);
gs.info(playbookExecution);

    Saída:

    f059958267cdb410952864f0fed358cc