MACOEV.Glpi.Client

Client .NET per le API REST di GLPI 10+, condiviso fra il portale di ticketing ASL Roma 1 / PTV e il modulo Inventario Semplificato.

Target: net8.0 e net10.0.

Perche' esiste

L'integrazione GLPI viveva dentro l'applicazione Blazor di ticketing, in un unico file da 1188 righe non riusabile da fuori. Questa libreria la estrae e ne sana i difetti strutturali:

Uso

builder.Services.AddGlpiClient(builder.Configuration);

{
  "Glpi": {
    "BaseUri": "https://glpi.aslroma1.it",
    "AppToken": "...",
    "UserToken": "...",
    "SessionLifetime": "00:20:00"
  }
}

Oppure in codice:

builder.Services.AddGlpiClient(options =>
{
    options.BaseUri = "https://glpi.aslroma1.it";
    options.AppToken = appToken;
    options.UserToken = userToken;
});

BaseUri e' la radice dell'istanza GLPI senza /apirest.php.

Nota sulla sessione

Le credenziali sono quelle di un service account: la sessione aperta dal client non e' quella dell'utente finale. Di conseguenza glpiactiveprofile restituito da initSession descrive il service account e non e' utilizzabile per autorizzare l'utente applicativo. Per i ruoli vanno interrogati Group_User / Profile_User sull'utente autenticato.

Modelli

I DTO vivono tutti nel namespace unico Macoev.Glpi.Client.Models, organizzati in cartelle (Common, Session, Users, Tickets, Dropdowns, Assets, Documents, Knowbase): un solo using per il consumatore.

I nomi JSON sono il contratto con GLPI e sono coperti da test di contratto (ModelContractTests): un refuso in un JsonPropertyName non produce errori di compilazione, quindi la verifica non puo' che essere automatica.

Cosa resta fuori, di proposito

Sviluppo

dotnet test

Servizi

Coprono l'intera superficie del precedente IGLPIHelper (27 metodi). Alcune scelte sono volutamente conservative, perche' il portale di ticketing in produzione ci si appoggia:

• Tutte e tre le ricerche a catalogo interrogano ConsumableItem, anche dove il nome del metodo suggerirebbe altri itemtype. E' il comportamento in produzione.
• CreateTicketAsync non solleva se GLPI rifiuta: restituisce Id = -1 con il motivo in Message, come si aspetta l'interfaccia utente.
• GetUserAsync filtra per nome esatto dopo la chiamata: searchText di GLPI e' una LIKE, quindi "mrossi" restituisce anche "mrossini".
• SearchUserByUsernameAsync e' mantenuto ma non funziona: su GLPI il criterio field=1 con equals restituisce sempre 0 risultati. Vedi il commento sull'interfaccia.

Modulo inventario

IGlpiInventoryService copre censimento singolo e massivo, ricerca per seriale o numero di inventario, cambio di stato e associazione Item_Ticket. IGlpiPluginFieldsService legge e scrive i campi dei container del plugin Fields.

Gli id delle searchoption non sono mai costanti in questi due servizi: vengono risolti a runtime dal catalogo, perche' il plugin Fields li rinumera a ogni campo aggiunto a un container e serial non ha lo stesso id su tutti gli itemtype.

Verificare la configurazione GLPI

export GLPI_URL=https://glpi-test.aslroma1.it
export GLPI_APP_TOKEN=...
export GLPI_USER_TOKEN=...
python3 tools/verifica-glpi.py

Controlla diritti sugli itemtype, anagrafiche popolate, presenza dei campi Fields attesi e dei gruppi dei ruoli. Con --write esegue anche creazione asset, scrittura dei campi e Item_Ticket. Non cancella nulla: gli elementi di prova creati vengono elencati a fine esecuzione. Esce con codice diverso da zero se qualche controllo fallisce, quindi e' utilizzabile come gate prima dell'avvio dello sviluppo.

Rilascio

La pubblicazione e' automatica su GitHub Actions ed e' legata al tag, non al branch:

git tag v26.8.1 && git push origin v26.8.1

Il workflow publish.yml ricava la versione dal tag (v26.8.1 -> 26.8.1), la inietta con -p:Version=, esegue i test, impacchetta e pubblica sul feed. Richiede il secret di repository NUGET_FEED_API_KEY. In alternativa si puo' lanciare a mano da Actions > Publish NuGet > Run workflow indicando la versione.

Versionamento YY.M.patch.build, coerente con gli altri pacchetti MACOEV.

Attenzione alla normalizzazione NuGet: una quarta cifra a zero viene rimossa, quindi 26.8.1.0 viene pubblicato come 26.8.1. Conviene taggare direttamente nella forma normalizzata, per non avere tag e pacchetto con nomi diversi.

Directory.Build.targets allinea AssemblyVersion e FileVersion alla Version finale, qualunque sia la sua provenienza.