Introduzione ai ticket

Il ticket system di SoftLayer è un mezzo di comunicazione fondamentale per i clienti che hanno così la possibilità di interagire con i gruppi di supporto SoftLayer. Il servizio SoftLayer_Ticket garantisce un punto di interazione per singoli ticket e tutti i ticket presenti su un account possono essere elaborati mediante SoftLayer_Account.

Elenco

Un elenco di tutti i ticket può essere raccolto dal servizio SoftLayer_Account con SoftLayer_Account::getTickets. Questo metodo esegue un array di oggetti del tipo di dati SoftLayer_Ticket.

import SoftLayer
client = SoftLayer.Client()
tickets = client['Account'].getTickets()

Inoltre è possibile richiamare solo ticket aperti o chiusi con SoftLayer_Account::getOpenTickets e SoftLayer_Account::getClosedTickets.

Dettagli

Per ottenere informazioni su un ticket in particolare, come ad esempio il suo ID, l'ultima data di modifica o lo stato, possiamo utilizzare SoftLayer_Ticket::getObject che restituisce un oggetto SoftLayer_Ticket. Le maschere oggetto possono essere utilizzate per includere le proprietà relazionali di SoftLayer_Ticket. Di seguito un esempio dell'uso di getObject sul servizio SoftLayer_Ticket con una maschera oggetto che fornisce il nome dell'utente assegnato e tutti gli aggiornamenti dei ticket.

mask = ('mask[id, title, assignedUser[firstName, lastName],'
                'createDate,lastEditDate,updates[entry],updateCount]')
return client[‘Ticket’].getObject(id=ticket_id, mask=mask)

Creazione

Elenco di soggetti

Quando si crea un ticket, è necessario un ID soggetto valido. Un elenco di tutti i possibili soggetti viene raccolto con SoftLayer_Ticket_Subject::getAllObjects:

subjects = client['Ticket_Subject'].getAllObjects()
ID SUBJECT
1001 'Accounting Request'
1002 'Sales Request'
1003 'Reboots and Console Access'
1041 'DNS Request'
1021 'Hardware Issue'
1022 'Public Network Question'
1061 'Private Network Question'
1201 'DOS/Abuse Issue'
1101 'Security Issue'
1121 'Hardware Firewall Question'
1122 'Hardware Load Balancer Question'
1004 'OS Reload Question'
1005 'Portal Information Question'
1081 'Licensing Question'
1141 'Mail Server Issue'
1161 'StorageLayer Question'
1181 'CDNLayer Question'
1221 'Transcoding Question'
1261 'Colocation Service Request'

Inoltro del ticket

La creazione di un nuovo ticket avviene con il metodo SoftLayer_Ticket::createStandardTicket. Per prima cosa, viene creato un oggetto modello SoftLayer_Ticket contenente i dettagli del ticket. Ogni oggetto modello del ticket necessiterà, come minimo, che siano definite le seguenti proprietà:
• subjectId: l'ID del soggetto da utilizzare come titolo per il ticket
• assignedUserId: un utente assegnato per il ticket, che generalmente viene impostato sul creatore del ticket.
SoftLayer_Ticket::createStandardTicket può essere chiamato con l'oggetto modello e il contenuto per il primo messaggio del ticket.

import SoftLayer
client = SoftLayer.Client()
currentUser = client[‘Account’].getCurrentUser()
new_ticket = {
       'subjectId': ID,
       'assignedUserId': currentUser['id']
}
created_ticket = client[‘Ticket’].createStandardTicket(new_ticket, “This is the content of the ticket xxxx”)

Aggiornamento

Un aggiornamento al ticket può essere effettuato con SoftLayer_Ticket::addUpdate. È necessario fornire un oggetto modello:

ticket_update = {
                 'entry': "This is a test update, please ignore",
                 }
tickets = client['Ticket'].addUpdate(ticket_update, id=8988302)