Une API Parser définit comment récupérer et analyser les données d'un système tiers. Avant de définir une API parser, vous devez comprendre quelles données doivent être extraites du système tiers et l'API correspondante pour interroger les données.

1.Cliquez dans la barre des tâches et sélectionnez Équipement Parser.

2.Dans le Type de périphérique liste, sélectionnez un type d'appareil que l'API parser s'applique à. Par défaut, le Tous les types d'appareils l'option est sélectionnée.

3.Dans le Parser Type Liste, sélectionnez API et sélectionnez ensuite l'adaptateur d'API prédéfini.

4.Définissez des fonctions pour récupérer les données brutes d'intégration. Dans ce cas, le système tire Numéro , Brève description, Ouvert et Région du tableau des incidents.

scénario

'' '
Commencer à déclarer les paramètres d'entrée
[
]
Fin déclarer
 
Comme échantillon
[
    {"name": "$param1"},
    {"name": "$param2"}
]
'' '
 
def BuildParameters (contexte, nom_appareil, paramètres) :
    rtn_params = {}
    rtn_params['api_params'] = {
        'api_uri':'/api/now/table/incident',
        'url_params' :{
            'sysparm_query':'cmdb_ci.name=' + nom_périphérique,
            'sysparm_fields':'number,short_description,sys_created_on,state',
            'sysparm_display_value' : Vrai
        }
    }
    retour (Vrai, rtn_params)
 
def Récupérer les données (rtn_params) :
    incident = get_data(rtn_params)
    incident de retour

5.(Facultatif) Récupérez d'autres champs de la table des incidents, tels que Ouvert par.

1)Ouvrez un incident et cliquez avec le bouton droit dans le champ que vous souhaitez extraire.

2)Affichez le nom du système et ajoutez-le après le sysparm_fields dans le script ci-dessus.

6.Cliquez sur Récupérer et sélectionnez un appareil pour récupérer les données.

7.Définissez des fonctions pour analyser les données brutes d'intégration.

scénario

# Déclarez la structure, le type et le nom de la variable.
'' '
Commencer à déclarer la variable
[
    {"name": "NumbIncidents", "type": "int"},
    {"name": "Incident_Detail", "type": "table", "columns": [
        {"name": "Numéro", "type": "chaîne"},
        {"name": "Short_Description", "type": "string"},
        {"name": "État", "type": "chaîne"},
        {"name": "Ouvert", "type": "chaîne"},
        {"name": "Ouvert_par", "type": "chaîne"}
    ]}
]
Fin déclarer
'' '
importer re
importer json
  
# Fonction intégrée, ne changez pas la fonction (ParseText) et le nom du paramètre (_original_result).
# La valeur de retour doit être un dictionnaire.
def ParseText(_original_result) :
    résultat = json.loads(_original_result)
    valeur = {}
    valeur["NumbIncidents"] = len(résultat)
      
    nombre = []
    short_description = []
    état = []
    ouvert = []
    ouvert_par = []
      
    pour i in gamme(len(résultat)):
        s_nombre = résultat[i]['numéro']
        s_short_description = résultat[i]['brève description']
        s_state = result[i]['Etat']
        s_opened = résultat[i]['ouvert_à']
        s_opened_by = résultat[i]['ouvert_par']
        nombre.append(s_nombre)
        short_description.append(s_short_description)
        état.append(s_state)
        ouvert.append(s_opened)
        ouvert_par.append(s_opened_by)
    valeur['Incident_Detail']= {'Nombre': Numéro, 'Brève description':brève description, 'État':Etat, 'Ouvert':ouvert, 'Ouvert_par':ouvert_par}
    retourner Plus-value

8.Cliquez sur Analyser le résultat.

9.Enregistrez le parser.

 

Voir aussi:

▪Filtre avancé