Associer un rapport à une catégorie d'incident (drapeau de rapport)
Pour associer un rapport à une catégorie d'incident (drapeau de rapport), la liste des champs du modèle de rapport doit comporter un champ défini pour contenir les données de la catégorie d'incident. Ensuite, lorsque vous créez les données des champs de rapport d'un nouveau rapport, vous pouvez renseigner la valeur du champ catégorie d'incident avec le numéro d'identification de l'inscription /report-flags qui contient la définition de la catégorie d'incident.
Par exemple,
POST /report-template-fields
{
"parent": {
"type": "report-templates",
"object": 1212
},
"label": "incident category",
"type": "LIST_FLAG",
"required": false,
"adminOnly": false,
"displayOrder": 0,
"isDispatcherField": false,
"confidential": false
}Une fois que votre modèle de rapport a un champ pour contenir une catégorie d'incident, lorsque l'intégration crée un nouveau rapport, elle peut ajouter l'ID de la catégorie d'incident comme valeur pour ce champ.
Par exemple,
POST /reports
{
"reportTemplate": 1212,
"account": 688,
"reportFields": {
"402": "Main body of text",
"1211": 600
}
} 402 et 1211 sont les identifiants des enregistrements des champs de modèle de rapport, et 600 est la catégorie d'incident.
GET /report-flags/600
{
"id": 600,
"name": "A special event",
"details": "",
"showInDefaultGroup": true,
"severityLevel": "SEVERE",
"customId": "EventCode-01",
"category": 601,
"alias": null,
"isGlobal": true,
"isAvailableInSubRegion": true,
"region": 252,
"reportFlagTemplate": null,
"defaultLanguage": "",
"translatable": false
}Déplacement d'un rapport entre les catégories d'incidents
Les rapports qui contiennent un champ de rapport de type catégorie d'incident seront visibles en tant que rapport dans cette catégorie d'incident. Si vous l'associez par erreur et que vous devez le déplacer dans une nouvelle catégorie (drapeau de rapport), vous devez PATCHER le rapport et le système réécrira automatiquement le champ du rapport qui contient l'ID du drapeau de rapport.
Voici un exemple de mise à jour d'un rapport qui appartenait auparavant à la catégorie d'incident 25, pour qu'il devienne 24 :
[PATCH] /reports/4218
{
"reportFields": [
{"field": 1931, "value": "24"}
]
}24 = drapeau du rapport
1931 = champ du modèle de rapport (du modèle de rapport sur lequel le rapport est basé)