ResponseTemplate - escopo, global

. ResponseTemplate a inclusão de script fornece métodos para gerenciar modelos de resposta.

Modelos de resposta são mensagens reutilizáveis que os agentes podem copiar para formulários de caso ou tarefa. Eles fornecem mensagens rápidas e consistentes para os usuários e exibem mensagens de resposta de bate-papo padrão para os solicitantes no Bate-papo do agente. Esta inclusão de script requer o plug-in Respostas de modelo (com.sn_templated_snip), que é ativado por padrão e é executado no sn_templated_snip namespace.

Para obter informações adicionais sobre modelos de resposta, consulte Modelos de resposta .

ResponseTemplate - ResponseTemplate()

Instancia um novo objeto ResponseTemplate.

Tabela 1. Parâmetros

Nome	Tipo	Descrição
Nenhum

new sn_templated_snip.ResponseTemplate().query("incident","ef4225a40a0a0b5700d0b8a790747812", "", 0, 0, true, ""); 

ResponseTemplate - query(cadeia de caracteres tablename, cadeia de caracteres recordId, cadeia de caracteres searchTerm, limite de número, deslocamento de número, booliano includeEvaluatedBody, cadeia de caracteres errorFormat, opções de objeto)

Retorna todos os modelos de resposta de uma tabela especificada que correspondem aos critérios de consulta aprovados.

Tabela 2. Parâmetros

Nome	Tipo	Descrição
tableName	Cadeia de caracteres	Nome da tabela a ser usada para pesquisar a tabela sn_templated_snip_note_template para localizar os modelos de resposta correspondentes. Por exemplo, incident ou sn_hr_core_case.
recordId	Cadeia de caracteres	SYS ID do registro a ser usado para renderizar as variáveis no modelo de resposta.
searchTerm	Cadeia de caracteres	Opcional. Texto a ser usado para filtrar a lista de modelos de resposta correspondentes. O método executa uma pesquisa CONTÉM este texto nos campos de nome e corpo e COMEÇA COM a pesquisa no campo de nome curto. Por exemplo, se o termo de pesquisa for "falha", o método retornará qualquer modelo de resposta que corresponda aos critérios de consulta e tenha falha no nome ou no corpo ou o nome curto comece com falha. Modelos de resposta com correspondências exatas no nome curto aparecem primeiro nos resultados de retorno. Todos os outros modelos de resposta retornados são classificados por nome. Padrão: Retorna todos os modelos de resposta correspondentes.
limite	Número	Opcional. Número máximo de modelos de resposta a serem retornados. Padrão: 50
deslocamento	Número	Opcional. Para paginação, o índice no qual a pesquisa será iniciada. Padrão: 0
IncludeEvaluatedBody	Booliano	Opcional. Sinalizador que indica se as variáveis de modelo devem ser renderizadas. Valores válidos: Falso: Não renderize as variáveis de modelo. A resposta contém as variáveis de mensagem. Por exemplo: Observe que o valor do seu caso (número) foi escalado para [assignment_group]. Verdadeiro: Renderiza as variáveis de modelo e retorna evaluated_response em retorna resultados. Por exemplo: Seu caso INC100001 foi escalado para Instalações. Padrão: falso
Formatoerro	Cadeia de caracteres	Opcional. Formatação HTML a ser usada para erros. Por exemplo: "<span style='color:#ffff00'>${%s}</span>" Padrão: " <span style='color:#ff0000'>%s </span>"
opta	Objeto	Opcional. Parâmetros a serem passados para o ponto de extensão sn_templated_snip.response_template. O formato e o conteúdo desses parâmetros dependem da implementação do ponto de extensão. Para obter informações adicionais sobre pontos de extensão, consulte Usando pontos de extensão para estender a funcionalidade da aplicação .

Tabela 3. Retornos

Tipo

Descrição

Objeto

Matriz de todos os modelos que correspondem aos critérios de pesquisa especificados. Modelos de resposta com correspondências exatas no nome curto aparecem primeiro nos resultados de retorno. Todos os outros modelos de resposta retornados são classificados por nome. Cada nó na matriz pode conter os seguintes parâmetros: sys_idCadeia de caracteres. Identificador exclusivo do modelo de resposta. nameCadeia de caracteres. Nome do modelo de resposta. short_nameCadeia de caracteres. Nome curto do modelo de resposta. bodyHTML. Modelo de resposta. short_name_match: Booliano. Sinalizador que indica se ocorreu uma correspondência exata no nome curto do modelo de resposta. evaluated_responseMatriz. Resultados da avaliação do modelo. success: Booliano. Sinalizador que indica se todas as variáveis foram renderizadas corretamente. evaluated_bodyHTML. Corpo do modelo de resposta renderizado. errorMatriz. Entrada para cada erro de avaliação que ocorreu. inAccessibleVariablesCadeia de caracteres. Variáveis no corpo do modelo de resposta que não puderam ser resolvidas. unEvaluatedVariablesCadeia de caracteres. Variáveis no corpo do modelo de resposta que não foram avaliadas. messageCadeia de caracteres. Mensagens de erro

Este exemplo mostra como consultar modelos de resposta associados à tabela de incidentes.

query("incident","ef4225a40a0a0b5700d0b8a790747812", "", 0, 0, false, "");

Resposta bem-sucedida:

[
  {
    "sys_id": "5fc1d65993003300a9bc1d1e867ffb9c",
    "name": "Incident escalation",
    "short_name": "escalation",
    "template_body": "<p>Dear ${caller_id.first_name},</p>\r\n<p>Please note that your incident ${number} has been escalated to ${assignment_group}. An agent will be assigned on your case and will keep you updated. If you have more questions please reach out to our team.</p>\r\n<p>Regards,</p>\r\n<p>${sys_updated_by}</p>"
  }
]

Mesma consulta com uma resposta de erro.

query("incident","fe4225a40a0a0b5700d0b8a790747812", "", 0, 0, false, "");

Resposta de erro:

[
  {
    "sys_id": "5fc1d65993003300a9bc1d1e867ffb9c",
    "name": "Incident escalation",
    "short_name": "escalation",
    "template_body": "<p>Dear ${caller.first_name},</p>\r\n<p>Please note that your incident ${number} has been escalated to ${assignment_group}. An agent will be assigned on your case and will keep you updated. If you have more questions please reach out to our team.</p>\r\n<p>Regards,</p>\r\n<p>${sys_updated_by}</p>",
    "evaluated_response": {
      "success": false,
      "error": {
        "unEvaluatedVariables": "caller.first_name",
        "message": "Cannot evaluate following variables: caller.first_name"
      },
      "evaluated_body": "<p>Dear <span style='color:#ff0000'>${caller.first_name}</span>,</p>\r\n<p>Please note that your incident INC0000049 has been escalated to Hardware. An agent will be assigned on your case and will keep you updated. If you have more questions please reach out to our team.</p>\r\n<p>Regards,</p>\r\n<p>admin</p>"
    }
  }
]

ResponseTemplate - renderizar(cadeia de caracteres templateId, cadeia de caracteres tablename, cadeia de caracteres recordId, cadeia de caracteres errorFormat, opções de objeto)

Renderiza o corpo HTML de um modelo de resposta especificado.

Todas as variáveis são resolvidas usando as informações da tabela e do registro especificados. Se as variáveis não puderem ser resolvidas ou ocorrer qualquer outro problema durante a renderização, o método retornará uma mensagem de erro nos resultados.

Tabela 4. Parâmetros

Nome	Tipo	Descrição
templateId	Cadeia de caracteres	SYS ID do modelo de resposta a ser renderizado.
tableName	Cadeia de caracteres	Nome da tabela a ser usada ao renderizar as variáveis no modelo de resposta.
recordId	Cadeia de caracteres	SYS ID do registro a ser usado ao renderizar as variáveis no modelo de resposta. Este registro deve estar na tabela especificada por tableName.
Formatoerro	Cadeia de caracteres	Opcional. Formatação HTML a ser usada para erros. Por exemplo: "<span style='color:#ffff00'>${%s}</span>" Padrão: " <span style='color:#ff0000'>%s </span>"
opta	Objeto	Opcional. Parâmetros a serem passados para o ponto de extensão sn_templated_snip.response_template. O formato e o conteúdo desses parâmetros dependem da implementação do ponto de extensão. Para obter informações adicionais sobre pontos de extensão, consulte Usando pontos de extensão para estender a funcionalidade da aplicação .

Tabela 5. Retornos

Tipo

Descrição

Objeto

Resultados da renderização. successSinalizador que indica se a renderização foi bem-sucedida. evaluated_bodyCadeia de caracteres. Corpo do modelo de resposta renderizado para sucesso. Para erro, o corpo do modelo de resposta que inclui variáveis renderizadas e não renderizáveis. errorObjeto. Mensagem de erro se a renderização não tiver sido bem-sucedida. unEvaluatedVariablesVariáveis que não puderam ser renderizadas. messageMensagem de erro.

Este exemplo de código mostra como solicitar um modelo de resposta renderizado para a tabela de incidentes.

render("5fc1d65993003300a9bc1d1e867ffb9c","incident","ef4225a40a0a0b5700d0b8a790747812", "")

Resposta bem-sucedida:

{
  "success": true,
  "evaluated_body": "<p>Dear Beth,</p>\r\n<p>Please note that your incident INC0000049 has been escalated to Hardware. An agent will be assigned on your case and will keep you updated. If you have more questions please reach out to our team.</p>\r\n<p>Regards,</p>\r\n<p>admin</p>"
}

Mesma solicitação de renderização, mas retornando uma resposta de erro.

render("5fc1d65993003300a9bc1d1e867ffb9c","incident","ef4225a40a0a0b5700d0b8a790747812", "")

Resposta de erro:

{
  "success": false,
  "error": {
    "unEvaluatedVariables": "caller.first_name",
    "message": "Cannot evaluate following variables: caller.first_name"
  },
  "evaluated_body": "<p>Dear <span style='color:#ff0000'>${caller.first_name}</span>,</p>\r\n<p>Please note that your incident INC0000049 has been escalated to Hardware. An agent will be assigned on your case and will keep you updated. If you have more questions please reach out to our team.</p>\r\n<p>Regards,</p>\r\n<p>admin</p>"
}