PlaybookExperience - Com escopo

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

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

    Esta API requer o plug-in 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 - cancelPlaybook(cadeia de caracteres playbookContext, cadeia de caracteres cancelationReason, cadeia de caracteres scopedName, cadeia de caracteres playbookExperienceId)

    Cancelar um playbook individual.

    Tabela 1. Parâmetros
    Nome Tipo Descrição
    PlaybookContext GlideRecord O registro [sys_pd_context] que você deseja cancelar.
    CancelationMotivo Cadeia de caracteres O motivo para cancelar a execução do playbook. Também aparece na IU para usuários de tempo de execução.
    playbookExperienceId Cadeia de caracteres Opcional. Sys_id do registro do Playbook Experience na tabela 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 de estado de atividade do Playbook .

    Padrão: Sys_id do registro do Playbook Experience global.
    forçar Booliano Opcional. Se definido como verdadeiro, cancela os fluxos subjacentes das atividades que estão em andamento. . CancelationMotivo o parâmetro não é usado quando este parâmetro é definido como verdadeiro. Você só pode forçar o cancelamento de atividades depois que o playbook é cancelado e o sys_pd_context está em um estado de cancelamento pendente.
    Nota:
    O mecanismo de fluxo tenta cancelar todos os fluxos subjacentes sem criar problemas quando um playbook é cancelado, mas não podemos garantir que nenhum problema ocorra.
    Tabela 2. Retornos
    Tipo Descrição
    <Object>.CanceledPlaybookContext Os dados associados à execução cancelada do playbook, como o motivo pelo qual ele foi cancelado.

    Tipo de dados: Matriz

    "canceledPlaybookContext": [
    {
      "can_read": Boolean,
      "canceled_by": "String",
      "can_add_activity": Boolean,
      "snapshot_id": "string",
      "can_restart": Boolean,
      "can_cancel": Boolean,
      "cancellation_reason": "String",
      "errors": [Array],
      "parent_record": "String",
      "parent_table": "String",
      "playbook_id": "String",
      "playbook_table": "String",
      "scoped_name": "String",
      "variant_id": "String",
      "is_archived": Boolean,
      "state": {Object},
      "sys_id": "String",
      "title": "String"   
    }
]
    <Object>.canceledPlaybookContext.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
    <Object>.canceledPlaybookContext.can_cancel Sinalizador que indica se um usuário pode cancelar um playbook.
    • 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
    <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.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, a fase ou a atividade.

    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>Context.canceledPlaybookContext.Errors Lista de erros de cancelamento. Cada erro é um objeto na matriz.

    Tipo de dados: Matriz

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

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

    Tipo de dados: Cadeia de caracteres
    <Object>PlaybookContext.is_arquived Sinalizador que indica se os registros de contexto do playbook estão arquivados. Defina como verdadeiro. Este valor não pode ser modificado.
    Valores possíveis:
    • Verdadeiro: Os registros de contexto do Playbook são arquivados.
    • Falso: Os registros de contexto do Playbook não são arquivados.

    Tipo de dados: Booliano
    <Object>PlaybookContext.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>PlaybookContext.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 da qual o playbook pertence, geralmente a tabela Definições de processo [sys_pd_process_definition].

    Tipo de dados: Cadeia de caracteres
    <Object>PlaybookContext.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>PlaybookContext.snapshot_id Sys_id do snapshot da execução do playbook na tabela [sys_pd_snapshot].

    Tipo de dados: Cadeia de caracteres
    <Object>PlaybookContext.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>PlaybookContext.state.displayValue O valor de exibição do estado de execução do playbook.

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

    Tipo de dados: Cadeia de caracteres
    <Object>PlaybookContext.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>PlaybookContext.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>PlaybookContext.variant_id Sys_id da execução da variante do playbook da tabela Execuções de processo [sys_pd_context].

    Este exemplo mostra como cancelar uma única execução de um playbook específico que está sendo executado por muito tempo.

    var process = new GlideRecord('sys_pd_context');

process.get("SYS_ID");

var cancelPlaybookReturn = sn_playbook.PlaybookExperience.cancelPlaybook(process, "This playbook ran for too long");

gs.info(JSON.stringify(cancelPlaybookReturn));

    Saída:

    {
 "scoped_name": "global.test_user_form",
 "canceled_by": "maint",
 "can_add_activity": true,
 "snapshot_id": "28ec63425459e250f87766647bf35e7e",
 "playbook_table": "sys_pd_process_definition",
 "can_restart": false,
 "can_cancel": true,
 "title": "Test User Form",
 "cancellation_reason": "This process ran for too long",
 "parent_table": "incident",
 "can_read": true,
 "sys_id": "418b1e7ea722435bb4facac50fc9b4f3",
 "variant_id": null,
 "is_archived": false,
 "state": {
   "displayValue": "Pending Cancel",
   "value": "PENDING_CANCEL"
 },
 "parent_record": "8cdc23425459e250f87766647bf35ea1",
 "playbook_id": "d589efca5419e250f87766647bf35e29",
 "errors": []
}

    Forçar o cancelamento de uma única execução de um playbook específico.

    var forceCancelPlaybookReturn = sn_playbook.PlaybookExperience.cancelPlaybook(process, "This playbook did not cancel", undefined, true);

gs.info(JSON.stringify(forceCancelPlaybookReturn));

    Saída:

    {
 "scoped_name": "global.test_user_form",
 "canceled_by": "maint",
 "can_add_activity": true,
 "snapshot_id": "28ec63425459e250f87766647bf35e7e",
 "playbook_table": "sys_pd_process_definition",
 "can_restart": false,
 "can_cancel": true,
 "title": "Test User Form",
 "cancellation_reason": "This process ran for too long",
 "parent_table": "incident",
 "can_read": true,
 "sys_id": "418b1e7ea722435bb4facac50fc9b4f3",
 "variant_id": null,
 "is_archived": false,
 "state": {
   "displayValue": "Cancelled",
   "value": "CANCELLED"
 },
 "parent_record": "8cdc23425459e250f87766647bf35ea1",
 "playbook_id": "d589efca5419e250f87766647bf35e29",
 "errors": []
}

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

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

    Tabela 3. 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.
    CancelationMotivo 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 for fornecido, todas as execuções de todos os playbooks serão canceladas para o registro primário fornecido.
    playbookExperienceId Cadeia de caracteres Opcional. Sys_id do registro do Playbook Experience na tabela 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 Playbook activity state mapping.

    Padrão: Sys_id do registro do Playbook Experience global.
    Tabela 4. Retornos
    Tipo Descrição
    Objeto Objeto que contém as execuções do playbook canceladas e todas as execuções do playbook ignoradas que não puderam ser canceladas. 
    {
  "canceledPlaybookContext": [Array],
  "skippedPlaybookContext": [Array]
}
    <Object>.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_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
    <Object>.canceledPlaybookContext.can_cancel Sinalizador que indica se um usuário pode cancelar um playbook.
    • 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
    <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.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, a fase ou a atividade.

    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>Context.canceledPlaybookContext.Errors Lista de erros de cancelamento. Cada erro é um objeto na matriz.

    Tipo de dados: Matriz

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

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

    Tipo de dados: Cadeia de caracteres
    <Object>PlaybookContext.is_arquived Sinalizador que indica se os registros de contexto do playbook estão arquivados. Defina como verdadeiro. Este valor não pode ser modificado.
    Valores possíveis:
    • Verdadeiro: Os registros de contexto do Playbook são arquivados.
    • Falso: Os registros de contexto do Playbook não são arquivados.

    Tipo de dados: Booliano
    <Object>PlaybookContext.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>PlaybookContext.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 da qual o playbook pertence, geralmente a tabela Definições de processo [sys_pd_process_definition].

    Tipo de dados: Cadeia de caracteres
    <Object>PlaybookContext.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>PlaybookContext.snapshot_id Sys_id do snapshot da execução do playbook na tabela [sys_pd_snapshot].

    Tipo de dados: Cadeia de caracteres
    <Object>PlaybookContext.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>PlaybookContext.state.displayValue O valor de exibição do estado de execução do playbook.

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

    Tipo de dados: Cadeia de caracteres
    <Object>PlaybookContext.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>PlaybookContext.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 do 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"   
    }
]
    <Object>PlaybookContext.variant_id Sys_id da execução da variante do playbook da tabela Execuções de processo [sys_pd_context].

    Este exemplo mostra como cancelar todas as execuções de um playbook específico (nesse 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 atual Objeto como 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 do playbook para um determinado registro primário.

    Tabela 5. Parâmetros
    Nome Tipo Descrição
    parentRecord GlideRecord O registro primário para o qual obter 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 6. 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"   
    }
]
    CAN_read.can_read <Array>

    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
    CANCELED_BY <Array> . 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
    Erros.<Array> Lista de erros. Cada erro é um objeto na matriz.

    Tipo de dados: Matriz

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

    Tipo de dados: Cadeia de caracteres
    Errors.type <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
    Playbook_id.playbook_id <Array> Sys_id do playbook da tabela Definições de processo [sys_pd_process_definition].

    Tipo de dados: Cadeia de caracteres
    Playbook_table <Array> O nome da tabela da qual o playbook pertence, geralmente a tabela Definições de processo [sys_pd_process_definition].

    Tipo de dados: Cadeia de caracteres
    SCOPED_NAME <Array> 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
    Estado.<Array> 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.sys_id <Array> 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 atual Objeto como 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 7. 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 for fornecida, as execuções de todos os playbooks serão verificadas.
    Tabela 8. 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 (nesse caso, a demonstração do Playbook Experience). Para usar este método em uma ação de IU ou regra de negócios, passe atual Objeto como 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 playbookExperienceId)

    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 9. 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 da qual você deseja reiniciar.
    Nota:
    Somente fases concluídas podem ser reiniciadas.

    Tabela: Execuções de raia [sys_pd_lane_context]
    IdContextoAtividade 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 Playbook activity state mapping.

    Playbook Experience global

    Playbook Experience [sys_playbook_experience]
    Tabela 10. 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 do processo do playbook desativado está ativa.
    • Falso: A definição do 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, a fase ou a 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 são arquivados.
    • Falso: Os registros de contexto do Playbook não sã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 da qual o playbook pertence, 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:
    • Playbook foi ativado com SUCESSO.
    • FALHA: O ID do playbook não foi encontrado.
    "state": [
    {      
      "displayValue": "String",
      "value": "String"  
    }
]
    state.displayValue Valor de exibição do estado de execução do playbook.

    Tipo de dados: Cadeia de caracteres
    state.value 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 processo [sys_pd_context]
    título Rótulo da execução do playbook.

    Tipo de dados: Cadeia de caracteres

    Tabela: Execuções de processo [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(String scopedName, GlideRecord parentRecord)

    Inicia um playbook para um registro primário.

    Tabela 11. 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 12. 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 do playbook não tiver sido 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 atual Objeto como 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