5 Commits

Author SHA1 Message Date
Jason SECULA
5a464316f1 fixed misplace of +1 for fieldstodisplay
All checks were successful
Build python package / Build (push) Successful in 33s
2026-04-23 16:39:26 +02:00
Jason SECULA
8dec92b43a Adding profile selection methods
All checks were successful
Build python package / Build (push) Successful in 32s
2026-04-23 16:26:03 +02:00
Jason SECULA
9ac724ed4c Fixed error with id not shown in GetItems() 2026-04-23 16:07:31 +02:00
f7ab676b0d Updated Search methods to look for uid instead of name for searchOptions and new parameters (fieldsToDisplay, trashbin)
All checks were successful
Build python package / Build (push) Successful in 38s
2026-03-30 17:12:14 +02:00
b78a9512d8 Changed GetSearchOptions to use uid instead of name (immuable when changing language) 2026-03-30 17:10:32 +02:00
2 changed files with 72 additions and 23 deletions

View File

@@ -3,7 +3,7 @@ import json
from datetime import datetime from datetime import datetime
class GLPIAPI: class GLPIAPI:
def __init__(self, Server, AppToken, UserToken, UserAgent="GLPI API"): def __init__(self, Server, AppToken, UserToken, UserAgent="GLPI API", Profile=None):
self.Server = Server self.Server = Server
self.AppToken = AppToken self.AppToken = AppToken
self.UserToken = UserToken self.UserToken = UserToken
@@ -11,7 +11,14 @@ class GLPIAPI:
self.SessionToken = None self.SessionToken = None
self.StatusCode = None self.StatusCode = None
self.Headers = None self.Headers = None
self.ActiveProfile = None
self.InitConnection() self.InitConnection()
if(Profile == None):
self.ActiveProfile = self.GetActiveProfile()
else:
self.ActiveProfile = Profile
profileId = self.GetItems('Profile', 'Profile.name', Profile)[1]['2']
self.SetActiveProfile(profileId)
def InitConnection(self): def InitConnection(self):
initURI = '/apirest.php/initSession/' initURI = '/apirest.php/initSession/'
@@ -32,6 +39,9 @@ class GLPIAPI:
"Session-Token": self.SessionToken, "Session-Token": self.SessionToken,
"App-Token": self.AppToken "App-Token": self.AppToken
} }
if(self.GetActiveProfile() != self.ActiveProfile and self.ActiveProfile != None):
profileId = self.GetItems('Profile', 'Profile.name', self.ActiveProfile)[1]['2']
self.SetActiveProfile(profileId)
else: else:
raise Exception(f"{result.status_code} - {result.json()[0]}") raise Exception(f"{result.status_code} - {result.json()[0]}")
@@ -42,7 +52,34 @@ class GLPIAPI:
self.InitConnection() self.InitConnection()
return return
def GetComputers(self, deviceName=None, serialNumber=None, user=None, imei=None, airwatchDevice=None): def GetUserProfiles(self):
self.CheckConnection()
uri = f"{self.Server}/apirest.php/getMyProfiles"
req = requests.get(uri, headers=self.Headers)
if(req.status_code == 200):
return req.json()
else:
return req.status_code
def GetActiveProfile(self):
self.CheckConnection()
uri = f"{self.Server}/apirest.php/getActiveProfile"
req = requests.get(uri, headers=self.Headers)
if(req.status_code == 200):
return req.json()['active_profile']['name']
else:
return req.status_code
def SetActiveProfile(self, profileId):
self.CheckConnection()
body = {
"profiles_id" : profileId
}
uri = f"{self.Server}/apirest.php/changeActiveProfile"
return requests.post(uri, headers=self.Headers, json=body)
def GetComputers(self, deviceName=None, serialNumber=None, user=None, imei=None, airwatchDevice=None, fieldsToDisplay=[], trashbin=0):
''' '''
Search for computer items in GLPI based on one of the possibles parameters : Search for computer items in GLPI based on one of the possibles parameters :
- deviceName : name of the item - deviceName : name of the item
@@ -50,7 +87,10 @@ class GLPIAPI:
- user : user of the item - user : user of the item
- imei : custom field using field plugin (only for internal use) - imei : custom field using field plugin (only for internal use)
- airwatchDevice : an airwatchDevice object from airwatchAPI module - airwatchDevice : an airwatchDevice object from airwatchAPI module
If no parameters are set, it will search for all items If no parameters are set, it will search for all items.
fieldsToDisplay: set fields to forcefully add to the results of the search (must be a list [])
trashbin: set if the search is in the trashbin or not (0 not in the trash or 1 in the trash)
Return a tuple with item id, item data and item count. Return a tuple with item id, item data and item count.
''' '''
@@ -58,43 +98,47 @@ class GLPIAPI:
searchAll = False searchAll = False
if(deviceName != None): if(deviceName != None):
# Recherche en fonction du nom de l'appareil # Recherche en fonction du nom de l'appareil
search_parameter = f'is_deleted=0&criteria[0][field]=1&withindexes=true&criteria[0][searchtype]=contains&criteria[0][value]=^{deviceName}$' search_parameter = f'is_deleted={trashbin}&criteria[0][field]=1&withindexes=true&criteria[0][searchtype]=contains&criteria[0][value]=^{deviceName}$'
elif(user != None): elif(user != None):
# Recherche en fonction de l'utilisateur de l'appareil # Recherche en fonction de l'utilisateur de l'appareil
search_parameter = f'is_deleted=0&criteria[0][field]=70&withindexes=true&criteria[0][searchtype]=contains&criteria[0][value]=^{user}$' search_parameter = f'is_deleted={trashbin}&criteria[0][field]=70&withindexes=true&criteria[0][searchtype]=contains&criteria[0][value]=^{user}$'
elif(airwatchDevice != None): elif(airwatchDevice != None):
if(airwatchDevice.Imei != ''): if(airwatchDevice.Imei != ''):
# Recherche des appareils en fonction du numéro de série ou de l'imei # Recherche des appareils en fonction du numéro de série ou de l'imei
# l'imei pouvant être dans le champ numéro de série ou les champs imei custom (plugin field) # l'imei pouvant être dans le champ numéro de série ou les champs imei custom (plugin field)
search_parameter = f'is_deleted=0&criteria[0][field]=5&withindexes=true&criteria[0][searchtype]=contains&criteria[0][value]=^{airwatchDevice.SerialNumber}$'\ search_parameter = f'is_deleted={trashbin}&criteria[0][field]=5&withindexes=true&criteria[0][searchtype]=contains&criteria[0][value]=^{airwatchDevice.SerialNumber}$'\
f'&criteria[1][link]=OR&criteria[1][field]=5&criteria[1][searchtype]=contains&criteria[1][value]=^{airwatchDevice.Imei}$'\ f'&criteria[1][link]=OR&criteria[1][field]=5&criteria[1][searchtype]=contains&criteria[1][value]=^{airwatchDevice.Imei}$'\
f'&criteria[2][link]=OR&criteria[2][field]=76667&criteria[2][searchtype]=contains&criteria[2][value]=^{airwatchDevice.Imei}$'\ f'&criteria[2][link]=OR&criteria[2][field]=76667&criteria[2][searchtype]=contains&criteria[2][value]=^{airwatchDevice.Imei}$'\
f'&criteria[3][link]=OR&criteria[3][field]=76670&criteria[3][searchtype]=contains&criteria[3][value]=^{airwatchDevice.Imei}$' f'&criteria[3][link]=OR&criteria[3][field]=76670&criteria[3][searchtype]=contains&criteria[3][value]=^{airwatchDevice.Imei}$'
else: else:
# Recherche des appareils en fonction du numéro de série seulement # Recherche des appareils en fonction du numéro de série seulement
search_parameter = f'is_deleted=0&criteria[0][field]=5&withindexes=true&criteria[0][searchtype]=contains&criteria[0][value]=^{airwatchDevice.SerialNumber}$' search_parameter = f'is_deleted={trashbin}&criteria[0][field]=5&withindexes=true&criteria[0][searchtype]=contains&criteria[0][value]=^{airwatchDevice.SerialNumber}$'
elif(imei != None): elif(imei != None):
# Recherche des appareils en fonction du numéro de série ou de l'imei # Recherche des appareils en fonction du numéro de série ou de l'imei
# l'imei pouvant être dans le champ numéro de série ou les champs imei custom (plugin field) # l'imei pouvant être dans le champ numéro de série ou les champs imei custom (plugin field)
search_parameter = f'is_deleted=0&criteria[0][field]=5&withindexes=true&criteria[0][searchtype]=contains&criteria[0][value]=^{serialNumber}$'\ search_parameter = f'is_deleted={trashbin}&criteria[0][field]=5&withindexes=true&criteria[0][searchtype]=contains&criteria[0][value]=^{serialNumber}$'\
f'&criteria[1][link]=OR&criteria[1][field]=5&criteria[1][searchtype]=contains&criteria[1][value]=^{imei}$'\ f'&criteria[1][link]=OR&criteria[1][field]=5&criteria[1][searchtype]=contains&criteria[1][value]=^{imei}$'\
f'&criteria[2][link]=OR&criteria[2][field]=76667&criteria[2][searchtype]=contains&criteria[2][value]=^{imei}$'\ f'&criteria[2][link]=OR&criteria[2][field]=76667&criteria[2][searchtype]=contains&criteria[2][value]=^{imei}$'\
f'&criteria[3][link]=OR&criteria[3][field]=76670&criteria[3][searchtype]=contains&criteria[3][value]=^{imei}$' f'&criteria[3][link]=OR&criteria[3][field]=76670&criteria[3][searchtype]=contains&criteria[3][value]=^{imei}$'
elif(serialNumber != None): elif(serialNumber != None):
# Recherche des appareils en fonction du numéro de série seulement # Recherche des appareils en fonction du numéro de série seulement
search_parameter = f'is_deleted=0&criteria[0][field]=5&withindexes=true&criteria[0][searchtype]=contains&criteria[0][value]=^{serialNumber}$' search_parameter = f'is_deleted={trashbin}&criteria[0][field]=5&withindexes=true&criteria[0][searchtype]=contains&criteria[0][value]=^{serialNumber}$'
else: else:
# Recherche de l'ensemble des appareils si rien n'est renseigné # Recherche de l'ensemble des appareils si rien n'est renseigné
searchAll = True searchAll = True
search_parameter = f'is_deleted=0&criteria[0][link]=AND&criteria[0][field]=view&criteria[0][searchtype]=contains&criteria[0][value]='
if(searchAll): if(searchAll):
searchUri = f"{self.Server}/apirest.php/search/Computer/?range=0-9999999&is_deleted=0" searchUri = f"{self.Server}/apirest.php/search/Computer/?range=0-9999999&is_deleted={trashbin}"
else: else:
searchUri = f"{self.Server}/apirest.php/search/Computer?{search_parameter}" searchUri = f"{self.Server}/apirest.php/search/Computer?{search_parameter}"
if(fieldsToDisplay != []):
for i in range(len(fieldsToDisplay)):
searchUri += f"&forcedisplay[{i}]={fieldsToDisplay[i]}"
search = requests.get(searchUri, headers=self.Headers) search = requests.get(searchUri, headers=self.Headers)
if(search.status_code == 200): if(search.status_code == 200):
search = search.json() search = search.json()
@@ -115,7 +159,7 @@ class GLPIAPI:
return None, search, 0 return None, search, 0
def GetItems(self, itemType, fieldName=None, fieldValue=None): def GetItems(self, itemType, fieldName=None, fieldValue=None, fieldsToDisplay=[], trashbin=0):
''' '''
Search for items of a specific item type in GLPI. A filter can be set using fieldName and fieldValue : Search for items of a specific item type in GLPI. A filter can be set using fieldName and fieldValue :
fieldName: must be the name of the field as visible in GLPI fieldName: must be the name of the field as visible in GLPI
@@ -130,15 +174,22 @@ class GLPIAPI:
if(fieldName != None and fieldValue != None): if(fieldName != None and fieldValue != None):
fieldId = list(self.GetSearchOptions(itemType, fieldName))[0] fieldId = list(self.GetSearchOptions(itemType, fieldName))[0]
# Recherche en fonction de l'utilisateur de l'appareil # Recherche en fonction de l'utilisateur de l'appareil
search_parameter = f'is_deleted=0&criteria[0][field]={fieldId}&withindexes=true&criteria[0][searchtype]=contains&criteria[0][value]=^{fieldValue}$' search_parameter = f'is_deleted={trashbin}&criteria[0][field]={fieldId}&withindexes=true&criteria[0][searchtype]=contains&criteria[0][value]=^{fieldValue}$'
else: else:
searchAll = True searchAll = True
if(searchAll): if(searchAll):
searchUri = f"{self.Server}/apirest.php/search/{itemType}/?range=0-9999999&is_deleted=0" searchUri = f"{self.Server}/apirest.php/search/{itemType}/?range=0-9999999&is_deleted={trashbin}"
else: else:
searchUri = f"{self.Server}/apirest.php/search/{itemType}?{search_parameter}" searchUri = f"{self.Server}/apirest.php/search/{itemType}?{search_parameter}"
idFieldNumber = list(self.GetSearchOptions(itemType, f'{itemType}.id'))[0]
searchUri += f"&forcedisplay[0]={idFieldNumber}"
if(fieldsToDisplay != []):
for i in range(1, len(fieldsToDisplay)+1):
searchUri += f"&forcedisplay[{i}]={fieldsToDisplay[i-1]}"
search = requests.get(searchUri, headers=self.Headers) search = requests.get(searchUri, headers=self.Headers)
if(search.status_code == 200): if(search.status_code == 200):
@@ -150,7 +201,6 @@ class GLPIAPI:
return itemID, data, search["totalcount"] return itemID, data, search["totalcount"]
elif(search["totalcount"] > 1): elif(search["totalcount"] > 1):
if(searchAll): if(searchAll):
idFieldNumber = list(self.GetSearchOptions(itemType, 'id'))[0]
itemID = [i[idFieldNumber] for i in search["data"]] itemID = [i[idFieldNumber] for i in search["data"]]
else: else:
itemID = list(search["data"].keys()) itemID = list(search["data"].keys())
@@ -160,7 +210,7 @@ class GLPIAPI:
return None, search, 0 return None, search, 0
def GetUsers(self, username=None, email=None): def GetUsers(self, username=None, email=None, fieldsToDisplay=[], trashbin=0):
''' '''
Search for users in GLPI based on one of the possibles parameters : Search for users in GLPI based on one of the possibles parameters :
- username : username of the glpi user - username : username of the glpi user
@@ -172,13 +222,12 @@ class GLPIAPI:
fieldName = None fieldName = None
fieldValue = None fieldValue = None
if(username != None): if(username != None):
fieldName = 'login' fieldName = 'User.name'
fieldValue = username fieldValue = username
elif(email != None): elif(email != None):
fieldName = 'Emails' fieldName = 'User.UserEmail.email'
fieldValue = email fieldValue = email
return self.GetItems("User", fieldName, fieldValue, fieldsToDisplay, trashbin)
return self.GetItems("User", fieldName, fieldValue)
def GetSearchOptions(self, itemType, fieldName=None): def GetSearchOptions(self, itemType, fieldName=None):
self.CheckConnection() self.CheckConnection()
@@ -188,7 +237,7 @@ class GLPIAPI:
searchOptions = searchOptions.json() searchOptions = searchOptions.json()
if(fieldName != None): if(fieldName != None):
for k,v in searchOptions.items(): for k,v in searchOptions.items():
if(v['name'].lower() == fieldName.lower()): if('uid' in v.keys() and v['uid'].lower() == fieldName.lower()):
return {k : searchOptions[k]} return {k : searchOptions[k]}
return searchOptions return searchOptions
return searchOptions.status_code return searchOptions.status_code

View File

@@ -7,7 +7,7 @@ build-backend = "setuptools.build_meta"
[project] [project]
name = "GLPIAPI" name = "GLPIAPI"
version = "1.0.4" version = "1.0.5"
description = "A module python to make it easier to use GLPI API" description = "A module python to make it easier to use GLPI API"
readme = "README.md" readme = "README.md"
dependencies = [ dependencies = [