Metodi dei servizi Web › Metodi business › createTicket

Argomento precedente: createIssue

Argomento successivo: createQuickTicket

createTicket

I parametri seguenti sono validi per il metodo createTicket:

Parametro

Tipo

Descrizione

SID

Numero intero

Identifica la sessione recuperata dall'accesso.

Descrizione

Stringa

(Facoltativo) Identifica la descrizione del ticket.

problem_type

Stringa

Specifica il codice (non l'ID persistente) per un tipo di problema esistente per la policy, in base al quale viene eseguita un'applicazione dei servizi Web. Se questo parametro è vuoto o contiene un valore non valido, viene utilizzato il tipo di problema predefinito.

Userid

Stringa

(Facoltativo) Specifica l'ID utente dell'utente finale per il nuovo ticket. Se questo parametro è vuoto oppure se l'ID utente fornito non viene trovato, viene utilizzato il contatto proxy definito nella policy di accesso e il ticket viene creato comunque.

Asset

Stringa

(Facoltativo) Identifica l'handle di un asset da associare al ticket.

DuplicationID

Stringa

(Facoltativo) Consente ai chiamanti di partecipare alle routine di gestione dei duplicati utilizzate per classificare i ticket come univoci o differenti. Se la gestione dei duplicati è attiva, questa stringa viene verificata dopo aver controllato la corrispondenza degli altri criteri di gestione dei duplicati per determinare se si tratta di una chiamata univoca o duplicata a questo metodo. Per ulteriori informazioni sulla gestione dei ticket duplicati, consultare Gestione dei ticket duplicati.

newTicketHandle

String Holder

Identifica l'oggetto String Holder per la cattura dei dati restituiti. Per informazioni dettagliate, vedere l'elenco Restituzione degli oggetti in formato XML.

newTicketNumber

String Holder

Identifica l'oggetto String Holder per la cattura dei dati restituiti. Per informazioni dettagliate, vedere l'elenco Restituzione degli oggetti in formato XML.

returnUserData

String Holder

Identifica l'oggetto String Holder per la cattura dei dati restituiti. Per informazioni dettagliate, vedere l'elenco Restituzione degli oggetti in formato XML.

returnApplicationData

String Holder

Identifica l'oggetto String Holder per la cattura dei dati restituiti. Per informazioni dettagliate, vedere l'elenco Restituzione degli oggetti in formato XML.

Descrizione

Crea un ticket in base alle regole definite nella policy per il riconoscimento dei servizi e nel tipo di problema specificato. Il tipo di problema specifica il tipo di ticket creato da un modello di richiesta/cambiamento/questione. La descrizione fornita viene copiata nel modello e l'utente viene impostato dal contatto proxy della policy di accesso.

Se l'input relativo al tipo di problema non esiste, viene utilizzato il tipo di problema predefinito. Il tipo di problema definisce anche in che modo gestire la creazione dei ticket duplicati e gli ulteriori dati restituiti. Per informazioni dettagliate sulla configurazione delle policy di accesso e sui tipi di problemi, consultare la Guida all'implementazione.

Valore restituito

Restituisce l'handle del nuovo ticket, il numero del ticket e i dati di restituzione definiti nel tipo di problema, utilizzati per creare il ticket.

Elemento XML

Tipo

Descrizione

<UDSObject>

N/D

Restituisce l'elemento XML in modo che sia coerente con ciò che viene restituito dagli altri metodi seguenti:

  • createRequest()
  • createChange()
  • createIssue()

Il corpo di questo tag è vuoto.

<newTicketHandle>

Stringa

Identifica l'handle del nuovo ticket.

<newTicketNumber>

Stringa

Identifica il numero del nuovo ticket (attributo "ref_num" o "chg_ref_num").

<returnUserData>

Stringa

Identifica i dati specificati dall'utente per il tipo di problema. È destinato per la visualizzazione all'utente finale oppure per le voci del registro. È possibile impostare questo valore nel campo Restituzione dati utente nella scheda Dati restituzione della finestra Dettagli tipo problema.

<returnApplicationData>

Stringa

Identifica i dati specificati dall'utente per il tipo di problema. È destinato ad essere utilizzato con il codice dell'applicazione, in modo particolare per le azioni. È possibile impostare questo valore nel campo Restituzione dati applicazione nella scheda Dati restituzione della finestra Dettagli tipo problema.