exportPermissionSets
Categoria
| Recupero dei metadati |
Descrizione
| Restituisce i metadati per l'elenco completo di tutti gli insiemi di autorizzazioni nell'istanza. |
Autorizzazioni necessarie per richiamare
| Nessuno (devono essere credenziali valide per l'istanza) |
Parametri obbligatori su richiesta
| Credenziali |
La richiesta di questo metodo contiene solo un tag di credenziali per identificare e autorizzare l'utente chiamante. Una volta verificato, il metodo restituisce un documento XML che descrive l'insieme di autorizzazioni completo trovato nell'istanza dell'utente.
Formato richiesta
<?xml version='1.0' encoding='UTF-8'?> <call method="exportPermissionSets" callerName="a string that identifies your client application"> <credentials login="sampleuser@company.com" password="my_pwd"/> </call>
elemento credenziali
| |||
Nome tag
| credenziali | ||
Descrizione
| Tutte le chiamate API devono contenere un singolo elemento di credenziali per identificare l'utente che richiama l'API. La chiamata API viene quindi eseguita come utente (qualsiasi audit trail o storico delle azioni nel sistema mostrerà che l'azione è stata eseguita dall'utente) e pertanto l'utente deve disporre delle autorizzazioni necessarie per eseguire l'azione affinché l'API chiamata per ottenere l'esito positivo. | ||
Attributi dell'elemento
| |||
Nome attributo
| Obbligatorio?
| Valore
| Esempio
|
accedere | S | Il nome di accesso dell'utente che richiama il metodo API. L'utente deve disporre delle autorizzazioni necessarie per richiamare il metodo | sampleuser@company.com |
password | S | La password dell'utente che richiama il metodo API. | my_password |
impostazioni internazionali | N | Specificare le impostazioni internazionali da utilizzare per interpretare i numeri e le date in entrata e per formattare i numeri e le date in uscita (utilizzando il separatore delle migliaia, i nomi dei mesi e la formattazione della data appropriati). Le impostazioni internazionali vengono utilizzate anche per specificare la lingua in cui devono essere visualizzati i messaggi di sistema nella risposta. Se non viene specificato, viene utilizzato en_US (inglese americano). | fr_FR |
instanceCode | N | Se l'utente specificato nelle credenziali ha accesso a più istanze di Adaptive Planning , questo attributo può essere utilizzato per specificare che l'utente intende accedere a un'istanza diversa da quella predefinita. Se non viene specificata, verrà utilizzata l'istanza predefinita dell'utente. Per determinare i codici di istanza disponibili, utilizzare l'API exportInstances. | MYINSTANCE1 |
Contenuto dell'elemento
| |||
(nessuno) | |||
Formato risposta
<?xml version='1.0' encoding='UTF-8'?> <response success="true"> <output> <permission_sets> <permission_set id="1" name="Standard" permissions="SHT,RPT,SCOREBOARD"/> <permission_set id="2" name="Administrative" permissions="SHT,RPT,SCOREBOARD,SAL,MOD,IMP,EXP"/> </permission_sets> </output> </response>
Gli insiemi di autorizzazioni e le autorizzazioni sono ordinati per nome.
elemento di risposta
| |||
Nome tag
| risposta | ||
Attributi dell'elemento
| |||
Nome attributo
| Obbligatorio?
| Valore
| Esempio
|
successo | S | Vero o falso, a indicare se la chiamata API è riuscita o meno. Anche le chiamate riuscite possono contenere messaggi di avviso nella risposta. | true |
obsoleto | N | Se presente nel tag di risposta e impostato su true, questo attributo indica che la versione del metodo o dell'API richiamata è diventata obsoleta ed è ufficialmente obsoleta da Adaptive Planning . Sebbene continui a funzionare in questo momento, potrebbe cessare di funzionare in breve tempo. In genere, questo attributo non è presente. | falso |
Contenuto dell'elemento
| |||
Un singolo elemento di messaggi facoltativo ed esattamente un elemento di output obbligatorio. | |||
elemento di output
| |
Nome tag
| output |
Attributi dell'elemento
| |
(nessuno) | |
Contenuto dell'elemento
| |
Un singolo elemento di conti. Questo wrapper di output è standard in tutte le risposte API e racchiude l'output valido di qualsiasi chiamata API riuscita. | |
permission_sets
element
| |
Nome tag
| permission_sets |
Descrizione
| Contenitore per uno o più elementi dell'insieme di autorizzazioni. |
Attributi dell'elemento
| |
(nessuno) | |
Contenuto dell'elemento
| |
Uno o più elementi dell'insieme di autorizzazioni. | |
permission_set
element
| |||
Nome tag
| permission_set | ||
Descrizione
| Descrive un singolo set di autorizzazioni disponibile nell'istanza. | ||
Attributi dell'elemento
| |||
Nome attributo
| Obbligatorio?
| Valore
| Esempio
|
ID | S | Il numero ID sistema interno per il set di autorizzazioni. Viene utilizzato per identificare il set di autorizzazioni assegnato a un utente nella chiamata API exportUsers. | 1 |
nome | S | Il nome dell'insieme di autorizzazioni, come illustrato in Amministrazione degli insiemi di autorizzazioni | Standard |
autorizzazioni | S | Un elenco di codici separati da virgole per le autorizzazioni assegnate a questo set di autorizzazioni. I codici sono abbreviazioni interne come "SHT" per Sheet Access e "RPT" per Report Access. | SHT,RPT,SCOREBOARD |
Contenuto dell'elemento
| |||
(nessuno) | |||