Antwortvorlagen-API

  • Freigeben Version: Zurich
  • Aktualisiert 31. Juli 2025
  • 4 Minuten Lesedauer

    • Die Antwortvorlagen Die API stellt Endpunkte zur Verarbeitung von Datensätzen in der Tabelle „Antwortvorlagen“ [sn_templates_snip_note_template] bereit.

    Diese Skripteinbindung erfordert das Plugin „Antworten mit Vorlagen“ (com.sn_templates_snip), das standardmäßig aktiviert ist und innerhalb von ausgeführt wird sn_templates_snip Namespace.

    Weitere Informationen zu Antwortvorlagen finden Sie unter Antwortvorlagen .

    Antwortvorlagen – POST /response_Templates/get_Templates

    Gibt Datensätze aus der Tabelle „Antwortvorlagen“ [sn_templates_snip_note_template] zurück.

    URL-Format

    Standard-URL: /api/sn_templates_snip/response_Templates/get_Templates

    Unterstützte Anforderungsparameter

    Tabelle : 1. Pfadparameter
    Name Beschreibung
    Keine
    Tabelle : 2. Abfrageparameter
    Name Beschreibung
    Keine
    Tabelle : 3. Anforderungstextparameter (XML oder JSON)
    Name Beschreibung
    Fehlerformat HTML-Formatierung, die für Fehler verwendet werden soll.

    Datentyp: Zeichenfolge

    Standard: „ <span style='color:#ff0000'>${%s} </span>„

    EingeschlosseneEvaluatedBody Kennzeichnung, die angibt, ob die Vorlagenvariablen gerendert werden sollen.

    Gültige Werte:

    • Falsch: Die Vorlagenvariablen nicht rendern. Die Antwort enthält die Nachrichtenvariablen.
      Zum Beispiel: 
      Beachten Sie, dass Ihr Fall ${number} an ${assignment_Group} eskaliert wurde.
    • Wahr: Rendert die Vorlagenvariablen und gibt zurück evaluated_responseIn den Rückgabeergebnissen.
      Zum Beispiel: 
      Beachten Sie, dass Ihr Fall INC100001 an Facilities eskaliert wurde.

    Datentyp: Boolesch

    Standardwert: false
    limit Maximale Anzahl zurückzugebender Antwortvorlagen.

    Datentyp: Zahl

    Standard: 50
    Offset Bei Paginierung der Index, bei dem die Suche gestartet werden soll.

    Datentyp: Zahl

    Standard: 0
    Optionen Parameter, die an den Erweiterungspunkt sn_templates_snip.response_template übergeben werden sollen. Format und Inhalt dieser Parameter hängen von der Implementierung des Erweiterungspunkts ab. Weitere Informationen zu Erweiterungspunkten finden Sie unter Erweiterungspunkte verwenden, um die Anwendungsfunktionalität zu erweitern .

    Datentyp: Objekt
    recordId Erforderlich. SYS_ID des Datensatzes, der zum Rendern der Variablen in der Antwortvorlage verwendet werden soll.

    Datentyp: Zeichenfolge
    searchTerm Text, der zum Filtern der Liste der übereinstimmenden Antwortvorlagen verwendet werden soll.

    Der Endpunkt führt eine ENTHÄLT-Suche nach diesem Text in den Feldern Name und Textkörper durch und BEGINNT MIT der Suche im Feld Kurzname. Wenn der Suchbegriff beispielsweise „Absturz“ lautet, gibt der Endpunkt eine Antwortvorlage zurück, die den Abfragekriterien entspricht und im Namen oder Textkörper einen Absturz aufweist, oder der Kurzname beginnt mit „Absturz“.

    Antwortvorlagen mit genauen Übereinstimmungen beim Kurznamen werden zuerst in den Rückgabeergebnissen angezeigt. Alle anderen zurückgegebenen Antwortvorlagen werden nach Namen sortiert.

    Datentyp: Zeichenfolge

    Standard: Alle übereinstimmenden Antwortvorlagen zurückgeben.
    tableName Erforderlich. Name der Tabelle, die zum Durchsuchen der Tabelle „Antwortvorlagen“ verwendet werden soll, um entsprechende Antwortvorlagen zu finden. Beispiel: „Incident“ oder „sn_HR_Core_Case“.

    Datentyp: Zeichenfolge

    Header

    Die folgenden Anforderungs- und Antwortkopfzeilen gelten nur für diese HTTP-Aktion oder für diese Aktion auf eine bestimmte Weise. Eine Liste der allgemeinen Header, die in der REST API verwendet werden, finden Sie unter Unterstützte REST-API-Header .

    Tabelle : 4. Anforderungskopfzeilen
    Kopfzeile Beschreibung
    Akzeptieren Datenformat des Antworttexts. Unterstützt nur application/json.
    Content-Type Datenformat des Anforderungstexts. Unterstützt nur application/json.
    Tabelle : 5. Antwortkopfzeilen
    Kopfzeile Beschreibung
    Keine

    Statuscodes

    Die folgenden Statuscodes gelten für diese HTTP-Aktion. Eine Liste der möglichen Statuscodes, die in der REST API verwendet werden, finden Sie unter REST API-HTTP-Antwortcodes .

    Tabelle : 6. Statuscodes
    Statuscode Beschreibung
    200 Erfolgreich. Die Anforderung wurde erfolgreich verarbeitet.
    401 Nicht autorisiert. Die Anmeldeinformationen sind falsch oder wurden nicht übergeben.
    500 Interner Serverfehler. Beim Verarbeiten der Anforderung ist ein unerwarteter Fehler aufgetreten. Der Antworttext enthält Informationen zum Fehler.

    Antworttext-Parameter (JSON oder XML)

    Name Beschreibung
    Ergebnis

    Array von Objekten, die alle Vorlagen auflisten, die den angegebenen Suchkriterien entsprechen.

    Datentyp: Array

    "result": [
  {Object}
]
    Ergebnis.<object>

    Antwortvorlagen mit genauen Übereinstimmungen beim Kurznamen werden zuerst in den Rückgabeergebnissen angezeigt. Alle anderen zurückgegebenen Antwortvorlagen werden nach Namen sortiert.

    Datentyp: Objekt

    {
  "evaluated_response": [Array],
  "name": "String",
  "short_name": "String",
  "short_name_match": Boolean,
  "sys_id": "String",
  "template_body": "String"
}
    Ergebnis. <object>.Evaluated_response

    Array, das die Ergebnisse der Vorlagenauswertung auflistet.

    Datentyp: Array

    "elevated_response":[
  "error": [Array],
  "evaluated_body": "String",
  "success": Boolean
]
    Ergebnis. <object>.Evaluated_response.error

    Liste der Einträge für jeden aufgetretenen Auswertungsfehler.

    Datentyp: Array

    "error":[
  "inAccessibleVariables": "String",
  "message": "String",
  "unEvaluatedVariables": "String"
]
    Ergebnis. <object>.evaluated_response.error.inAccessibleVariables Variablen im Antwortvorlagentext, die nicht aufgelöst werden konnten.

    Datentyp: Zeichenfolge
    Ergebnis. <object>.Evaluated_response.error.message Fehlermeldung.

    Datentyp: Zeichenfolge
    Ergebnis. <object>.Evaluated_response.error.unEvaluatedVariablen Variablen im Antwortvorlagentext, die nicht ausgewertet wurden.

    Datentyp: Zeichenfolge
    Ergebnis. <object>.Evaluated_response.Evaluated_body Ausgewerteter Antwortvorlagentext in HTML.

    Datentyp: Zeichenfolge
    Ergebnis. <object>.Evaluierte_Antwort.Erfolg

    Kennzeichnung, die angibt, ob alle Variablen ordnungsgemäß gerendert werden.

    Mögliche Werte:
    • Wahr: Alle Variablen ordnungsgemäß gerendert.
    • Falsch: Variablen wurden nicht ordnungsgemäß gerendert.

    Datentyp: Boolesch
    Ergebnis. <object>.Name Name der Antwortvorlage.

    Datentyp: Zeichenfolge
    Ergebnis. <object>.Short_Name Kurzname der Antwortvorlage.

    Datentyp: Zeichenfolge
    Ergebnis. <object>.Short_Name_match

    Kennzeichnung, die angibt, ob eine genaue Übereinstimmung mit dem Kurznamen der Antwortvorlage aufgetreten ist.

    Mögliche Werte:
    • Wahr: Suchbegriff ist eine genaue Übereinstimmung.
    • Falsch: Suchbegriff ist keine genaue Übereinstimmung.

    Datentyp: Boolesch
    Ergebnis. <object>.Sys_ID SYS_ID der Antwortvorlage.

    Datentyp: Zeichenfolge
    Ergebnis. <object>.Template_body Antwortvorlagentext in HTML.

    Datentyp: Zeichenfolge

    Beispiel für eine cURL-Anforderung

    curl "https://instance.service-now.com/api/sn_templated_snip/response_templates/get_templates" \
--request POST \
--header "Accept:application/json" \
--header "Content-Type:application/json" \
--data "{
  \"tableName\": \"sn_hr_core_case_total_rewards\",
  \"recordId\": \"2c9e43320b30220097432da0d5673a9c\"
}" \
--user "username":"password"
    {
   "result": [
      {
         "sys_id": "2552c4ec0b03320036e62c7885673a5a",
         "name": "Escalation Notes - Total Rewards",
         "short_name": "Escalation Notes - Total Rewards",
         "template_body": "<p>Dear ${subject_person},<\/p>\n<p>Please note that your case ${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>\n<p>Regards,<\/p>\n<p>${sys_updated_by}<\/p>"
      },
      {
         "sys_id": "698388ec0b03320036e62c7885673ab5",
         "name": "Resolution Notes - Phone Inquiry",
         "short_name": "Resolution Notes - Phone Inquiry",
         "template_body": "<p>Thank you ${subject_person} for reaching out to the Global HR Services Team for your inquiry. As discussed over the phone, we have resolved your case ${number}.<\/p>\n<p>We are happy to help if you have more questions for our team. Please reach out and mention the case number ${number} on the call.<\/p>\n<p>Regards,<\/p>\n<p>${assigned_to}<\/p>"
      }
   ]
}