Updated Search methods to look for uid instead of name for searchOptions and new parameters (fieldsToDisplay, trashbin)

.gitea/workflows/build.yaml

@@ -4,16 +4,25 @@ on: [push]
 
 jobs:
   Build:
-    runs-on: windows
+    runs-on: ubuntu-latest
+    container:
+      image: python
     steps:
+      - name: Act Workaround # https://github.com/nektos/act/issues/973
+        if: ${{ env.ACT }}
+        run: curl -fsSL https://deb.nodesource.com/setup_22.x | bash && apt install -y nodejs 
       - name: Check out repository code
         uses: actions/checkout@main
+      - name: Setting up python modules to build package
+        run: |
+          python -m pip install build twine
       - name: Building the package
         run: |
-          powershell mv ${{ gitea.workspace }}\GLPIAPI.py ${{ gitea.workspace }}\build\src\GLPIAPI\
+          mkdir ${{ gitea.workspace }}/build/src/GLPIAPI/
-          cd ${{ gitea.workspace }}\build
+          mv ${{ gitea.workspace }}/GLPIAPI.py ${{ gitea.workspace }}/build/src/GLPIAPI/GLPIAPI.py
+          cd ${{ gitea.workspace }}/build
           python -m build
       - name: Publish package
         run: |
-          python -m twine upload -u ${{ secrets.repo_user }} -p ${{ secrets.repo_pass }} --repository-url ${{ secrets.repo_url }} ${{ gitea.workspace }}\build\dist\*
+          python -m twine upload -u ${{ secrets.repo_user }} -p ${{ secrets.repo_pass }} --repository-url ${{ secrets.repo_url }} ${{ gitea.workspace }}/build/dist/*
         if: github.ref_type == 'tag'

GLPIAPI.py

@@ -32,68 +32,179 @@ class GLPIAPI:
                 "Session-Token": self.SessionToken,
                 "App-Token": self.AppToken
             }
+        else:
+            raise Exception(f"{result.status_code} - {result.json()[0]}")
+            
+    def CheckConnection(self):
+        sessionUri = f"{self.Server}/apirest.php/getFullSession/"
+        result = requests.get(sessionUri, headers=self.Headers)
+        if(result.status_code != 200 and result.json()[0] == 'ERROR_SESSION_TOKEN_INVALID'):
+            self.InitConnection()
+        return
     
-    def GetDevice(self, airwatchDevice=None, serialNumber=None, imei=None):
+    def GetComputers(self, deviceName=None, serialNumber=None, user=None, imei=None, airwatchDevice=None, fieldsToDisplay=[], trashbin=0):
-        if(airwatchDevice != None):
+        '''
+        Search for computer items in GLPI based on one of the possibles parameters :
+          - deviceName : name of the item
+          - serialNumber : serial number of the item
+          - user : user of the item
+          - imei : custom field using field plugin (only for internal use)
+          - airwatchDevice : an airwatchDevice object from airwatchAPI module
+        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.
+        '''
+        self.CheckConnection()
+        searchAll = False
+        if(deviceName != None):
+            # Recherche en fonction du nom de l'appareil
+            search_parameter = f'is_deleted={trashbin}&criteria[0][field]=1&withindexes=true&criteria[0][searchtype]=contains&criteria[0][value]=^{deviceName}$'
+        elif(user != None):
+            # Recherche en fonction de l'utilisateur de l'appareil
+            search_parameter = f'is_deleted={trashbin}&criteria[0][field]=70&withindexes=true&criteria[0][searchtype]=contains&criteria[0][value]=^{user}$'    
+        elif(airwatchDevice != None):
             if(airwatchDevice.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)
-                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[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}$'
             else:
                 # 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}$'
-        else:
+
-            if(imei != None):
+        elif(imei != None):
                 # 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)
-                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[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}$'
+                
+        elif(serialNumber != None):
+            # Recherche des appareils en fonction du numéro de série seulement
+            search_parameter = f'is_deleted={trashbin}&criteria[0][field]=5&withindexes=true&criteria[0][searchtype]=contains&criteria[0][value]=^{serialNumber}$'
+            
+        else:
+            # Recherche de l'ensemble des appareils si rien n'est renseigné
+            searchAll = True
+            
+        if(searchAll):
+            searchUri = f"{self.Server}/apirest.php/search/Computer/?range=0-9999999&is_deleted={trashbin}"
+        else:
+            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)
+        if(search.status_code == 200):
+            search = search.json()
+            if(search["totalcount"] == 1):
+                itemID = list(search["data"].keys())[0]
+                data = search["data"][itemID]
+                
+                return itemID, data, search["totalcount"]
+            elif(search["totalcount"] > 1):
+                if(searchAll):
+                    # requires id to be in the display preferences of the api user
+                    itemID = [i["2"] for i in search["data"]]
+                else:
+                    itemID = list(search["data"].keys())
+                return itemID, search["data"], search["totalcount"]
             else:
-                # Recherche des appareils en fonction du numéro de série seulement
+                return None, None, 0
-                search_parameter = f'is_deleted=0&criteria[0][field]=5&withindexes=true&criteria[0][searchtype]=contains&criteria[0][value]=^{serialNumber}$'
-
-        searchUri = f"{self.Server}/apirest.php/search/Computer?{search_parameter}"
-        search = requests.get(searchUri, headers=self.Headers)
-        if(search.status_code == 200):
-            search = search.json()
-            if(search["totalcount"] == 1):
-                deviceID = list(search["data"].keys())[0]
-                data = search["data"][deviceID]
                 
-                return deviceID, data, search["totalcount"]
+        return None, search, 0
-            elif(search["totalcount"] > 1):
-                deviceID = list(search["data"].keys())
-                return deviceID, search["data"], search["totalcount"]
-                
-        return None, None, 0
-        
-    def GetUser(self, username=None, email=None):
-        
-        if(username != None):
-            search_parameter = f'is_deleted=0&criteria[0][field]=1&withindexes=true&criteria[0][searchtype]=contains&criteria[0][value]=^{username}$'
-        elif(email != None):
-            search_parameter = f'is_deleted=0&criteria[0][field]=5&withindexes=true&criteria[0][searchtype]=contains&criteria[0][value]=^{email}$'
-        searchUri = f"{self.Server}/apirest.php/search/user?{search_parameter}"
-        search = requests.get(searchUri, headers=self.Headers)
-        if(search.status_code == 200):
-            search = search.json()
-            if(search["totalcount"] == 1):
-                userID = list(search["data"].keys())[0]
-                data = search["data"][userID]
-                
-                return userID, data, search["totalcount"]
-            elif(search["totalcount"] > 1):
-                userID = list(search["data"].keys())
-                return userID, search["data"], search["totalcount"]
-        
-        return None, None, 0
     
+    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 :
+        fieldName: must be the name of the field as visible in GLPI
+        fieldValue: a string
+        If only itemType is set, it will search for all items
+        
+        Return a tuple with item id (in a list if there are more than 1), item data (in a list of dict items) and item count (int).
+        If the query does not succeed it will return a tuple with the http status code instead of item data (e.g. None, 400, 0).
+        '''
+        self.CheckConnection()
+        searchAll = False
+        if(fieldName != None and fieldValue != None):
+            fieldId = list(self.GetSearchOptions(itemType, fieldName))[0]
+            # Recherche en fonction de l'utilisateur de l'appareil
+            search_parameter = f'is_deleted={trashbin}&criteria[0][field]={fieldId}&withindexes=true&criteria[0][searchtype]=contains&criteria[0][value]=^{fieldValue}$'
+        else:
+            searchAll = True
+        
+        if(searchAll):
+            searchUri = f"{self.Server}/apirest.php/search/{itemType}/?range=0-9999999&is_deleted={trashbin}"
+        else:
+            searchUri = f"{self.Server}/apirest.php/search/{itemType}?{search_parameter}"
+        
+        if(fieldsToDisplay != []):
+            for i in range(len(fieldsToDisplay)):
+                searchUri += f"&forcedisplay[{i}]={fieldsToDisplay[i]}"
+                
+        search = requests.get(searchUri, headers=self.Headers)
+        
+        if(search.status_code == 200):
+            search = search.json()
+            if(search["totalcount"] == 1):
+                itemID = list(search["data"].keys())[0]
+                data = search["data"][itemID]
+                
+                return itemID, data, search["totalcount"]
+            elif(search["totalcount"] > 1):
+                if(searchAll):
+                    idFieldNumber = list(self.GetSearchOptions(itemType, f'{itemType}.id'))[0]
+                    itemID = [i[idFieldNumber] for i in search["data"]]
+                else:
+                    itemID = list(search["data"].keys())
+                return itemID, search["data"], search["totalcount"]
+            else:
+                return None, None, 0
+                
+        return None, search, 0
+    
+    def GetUsers(self, username=None, email=None, fieldsToDisplay=[], trashbin=0):
+        '''
+        Search for users in GLPI based on one of the possibles parameters :
+          - username : username of the glpi user
+          - email : email of the glpi user
+        If no parameters are set, it will search for all users
+        
+        Returns a tuple with user id, user data and user count
+        '''
+        fieldName = None
+        fieldValue = None
+        if(username != None):
+            fieldName = 'User.name'
+            fieldValue = username
+        elif(email != None):
+            fieldName = 'User.UserEmail.email'
+            fieldValue = email
+        return self.GetItems("User", fieldName, fieldValue, fieldsToDisplay, trashbin)
+        
+    def GetSearchOptions(self, itemType, fieldName=None):
+        self.CheckConnection()
+        queryUri = f"{self.Server}/apirest.php/listSearchOptions/{itemType}"
+        searchOptions = requests.get(queryUri, headers=self.Headers)
+        if(searchOptions.status_code == 200):
+            searchOptions = searchOptions.json()
+            if(fieldName != None):
+                for k,v in searchOptions.items():
+                    if('uid' in v.keys() and v['uid'].lower() == fieldName.lower()):
+                        return {k : searchOptions[k]}
+            return searchOptions
+        return searchOptions.status_code
+        
     def UploadFile(self, file, path):
+        self.CheckConnection()
         manifest = {
             "input": {
                 "name": file,
@@ -111,25 +222,47 @@ class GLPIAPI:
         files = {file: fileData}
         return requests.post(self.Server+"/apirest.php/Document/", headers=headers, data=data, files=files)
     
-    def SetDocumentToDevice(self, deviceID, documentID):
+    def SetDocumentToItem(self, itemID, itemType, documentID):
+        self.CheckConnection()
         body = { 
             "input": {
                 "documents_id": documentID,
-                "items_id": deviceID,
+                "items_id": itemID,
-                "itemtype": "Computer"
+                "itemtype": itemType
             }
         }
         return requests.post(self.Server+"/apirest.php/Document/"+str(documentID)+"/Document_Item", headers=self.Headers, json=body)
 
     def UpdateInventory(self, inventory):
+        self.CheckConnection()
         headers = {
             "Content-Type":"Application/x-compress",
             "user-agent":self.UserAgent
         }
         return requests.post(self.Server, headers=headers, data=inventory)
-        
-    def UpdateSerialNumber(self, deviceid, serialnumber):
     
+    def SetField(self, itemType, itemId, data):
+        '''Modify fields of a GLPI item.
+           Input must be a dict formatted like this :
+           {
+            "fieldName1": "fieldValue1",
+            "fieldName2": "fieldValue2",
+            ...
+           }
+        '''
+        self.CheckConnection()
+        body = {
+            "input" : {
+                "id" : itemId,
+            }
+        }
+        body["input"] = {**body["input"], **data}
+        
+        uri = f"{self.Server}/apirest.php/{itemType}/"
+        return requests.put(uri, headers=self.Headers, json=body)
+    
+    def UpdateSerialNumber(self, deviceid, serialnumber):
+        self.CheckConnection()
         body = {
             "input" : {
                 "id" : deviceid,
@@ -139,22 +272,23 @@ class GLPIAPI:
         uri = f"{self.Server}/apirest.php/Computer/"
         return requests.put(uri, headers=self.Headers, json=body)
     
-    def UpdateUser(self, deviceid, username):
+    def UpdateItemUser(self, itemID, itemType, username):
-    
+        self.CheckConnection()
         body = {
             "input" : {
-                "id" : deviceid,
+                "id" : itemID,
                 "users_id" : username
             }
         }
-        uri = f"{self.Server}/apirest.php/Computer/"
+        uri = f"{self.Server}/apirest.php/{itemType}/"
         return requests.put(uri, headers=self.Headers, json=body)
 
-    def SetField(self, itemType, containerName, containerID, itemId, fieldName, data):
+    def SetCustomField(self, itemType, containerName, containerID, itemId, fieldName, data):
         '''Requires fields plugin on GLPI server
            - containerName is block label name
            - containerID is block id
         '''
+        self.CheckConnection()
         uri = f"{self.Server}/apirest.php/PluginFields{itemType}{containerName}"
         searchURI = f"{self.Server}/apirest.php/PluginFields{itemType}{containerName}?range=0-999999999"
         result = requests.get(searchURI, headers=self.Headers)

build/pyproject.toml

@@ -7,9 +7,12 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "GLPIAPI"
-version = "1.0.1"
+version = "1.0.4"
 description = "A module python to make it easier to use GLPI API"
 readme = "README.md"
+dependencies = [
+	"requests >= 2.32.5"
+]
 requires-python = ">=3.7"
 classifiers = [
 	"Programming Language :: Python :: 3"

build/src/GLPIAPI/__init__.py

@@ -1 +0,0 @@
-__all__ = ["GLPIAPI"]