Passa al contenuto principale
Documentazione
Documentazione
Adaptive Planning
Ultimo aggiornamento: 2023-06-23
Set di autorizzazioni

Set di autorizzazioni

URL Endpoint

https://api.adaptiveplanning.com/api/rest/security/<version>/<tenant>/users/permissionSets
Versione: v1
Categoria
Aggiornamento dati
Descrizione
Assegnare gli insiemi di autorizzazioni agli utenti di Adaptive Planning.
Autorizzazione richiesta per la chiamata
Utenti
con accesso amministratore
,
Set di autorizzazioni
L'API di assegnazione set di autorizzazioni consente di recuperare e assegnare insiemi di autorizzazioni utente.

Verbi HTTPS supportati:

Verbo HTTP
Risorsa singola
Risorsa raccolta
Descrizione
GET
Non supportato
Supportato
Recupera tutti gli utenti e gli insiemi di autorizzazioni assegnati.
POST
Supportato
Supportato
Aggiunge un insieme di autorizzazioni o aggiorna un insieme di autorizzazioni esistente per un utente.

GET

Richiesta
/users/permissionSets
Recupera una raccolta di insiemi di autorizzazioni assegnati agli utenti
Recupera tutti gli utenti e gli insiemi di autorizzazioni assegnati. È possibile filtrare per instanceCode. Se il parametro di query instanceCode è mancante, l'API recupera tutti gli utenti e i relativi set di autorizzazioni nell'istanza predefinita. L'impaginazione utilizza i valori predefiniti per il limite o lo scostamento se non si specificano questi parametri di query.
URI richiesta di esempio:
HTTPS://api.adaptiveinsights.com/api/rest/security/v1/default/users/
Parametri query:
Nome
Descrizione
Obbligatorio
instanceCode
Identificatore univoco di un'istanza che definisce il contesto dell'istanza.
N
limit
Il numero massimo di oggetti in una singola risposta. Il valore predefinito è 500. Il massimo è 500.
N
offset
Indice in base zero del primo utente in una raccolta di risposte. Il valore predefinito è 0.
Utilizzare l'offset con il parametro limit per controllare il paging di una raccolta di risposte.
N
Risposta di esempio
Risposta di esempio da un'istanza sincronizzata dall'utente con Workday
 


  "links": {
      "next": "https://api.adaptiveinsights.com/api/rest/security/v1/default/users/permissionSets?offset=10&limit=5",
      "previous": "https://api.adaptiveinsights.com/api/rest/security/v1/default/users/permissionSets?offset=0&limit=5"
  },{
  "total": 34,
  "users": [
      {
    "userGuid": "111SampleUserGuid",
    "wid": "14400000000000000000000000000samplewid",
    "userName": "sampleuser1@company.com",
    "permissionSet": [
      {
        "id": 1,
        "name": "samplePermissionSet1"
      }
    ]
  },
      {
    "userGuid": "112SampleUserGuid",
    "wid": "24400000000000000000000000000samplewid",
    "userName": "sampleuser3@company.com",
    "permissionSet": [
      {
        "id": 1,
        "name": "samplePermissionSet1"
      }
    ]
  },
      {
    "userGuid": "113SampleUserGuid",
    "wid": "34400000000000000000000000000samplewid",
    "userName": "sampleuser3@company.com",
    "permissionSet": [
      {
        "id": 2,
        "name": "samplePermissionSet2"
      }
    ]
  },
      {
    "userGuid": "114SampleUserGuid",
    "wid": "44400000000000000000000000000samplewid",
    "userName": "sampleuser4@company.com",
    "permissionSet": [
      {
        "id": 3,
        "name": "samplePermissionSet3"
      }
    ]
  },
      {
    "userGuid": "115SampleUserGuid",
    "wid": "54400000000000000000000000000samplewid",
    "userName": "sampleuser5@company.com",
    "permissionSet": [
      {
        "id": 4,
        "name": "samplePermissionSet4"
      }
    ]
  }
]
}

POST:

Richiesta:
/users/permissionSets:
Assegna o aggiorna gli insiemi di autorizzazioni per gli utenti.
Aggiunge un insieme di autorizzazioni o aggiorna un insieme di autorizzazioni esistente per un utente. È possibile filtrare per instanceCode. Se il parametro di query instanceCode è mancante, l'API assegna i set di autorizzazioni corrispondenti a tutti gli utenti nell'istanza predefinita. Nel corpo della richiesta, specificare i seguenti campi di query obbligatori: <userIdentifier> e permissionSet. Per inoltrare una richiesta in blocco per l'assegnazione degli insiemi di autorizzazioni corrispondenti a più utenti, specificare una matrice contenente ciascuna assegnazione di autorizzazioni.
Parametri query:
Nome
Descrizione
Obbligatorio
instanceCode
Identificatore univoco di un'istanza che definisce il contesto dell'istanza.
N
userIdentifier
L'ID utente per determinare l'ID utente univoco di Adaptive Planning. Valori possibili: userName, wid, userGuid.
S
Richiesta di esempio:
HTTPS://api.adaptiveinsights.com/api/rest/security/v1/default/users/permissionSets?userIdentifier=userName
Esempio di corpo richiesta
Esempio di corpo richiesta POST
 
[  
  {  
      "userName": "sampleuser1@company.com",
          "permissionSet": [
                  {
                      "name": "samplePermissionSet1"
                  }
      ]
  },
  {
      "userName": "sampleuser2@company.com",
          "permissionSet": [
                  {
                      "name": "samplePermissionSet2"
                  }
          ]
  },
  {
      "userName": "sampleuser3@company.com",
          "permissionSet": [
                  {
                      "name": "samplePermissionSet3"
                  }
          ]
  }
]
PayLoad Parameters
Nome
Descrizione
Obbligatorio
wid
L'ID Workday di un utente.
N
userName
Il nome utente (nome di accesso) di un utente.
N
userGuid
Identificatore utente univoco globale, assegnato dal sistema al momento della creazione.
N
nome
ID
Nome dell'insieme di autorizzazioni.
ID del set di autorizzazioni
Nome o ID del set di autorizzazioni obbligatori.
S