Skip to main content
Documentatie
Documentatie
Adaptive Planning
Laatst bijgewerkt: 2023-06-23
Machtigingensets

Machtigingensets

URL-eindpunt

https://api.adaptiveplanning.com/api/rest/security/<version>/<tenant>/users/permissionSets
Versie: v1
Categorie
Gegevens bijwerken
Omschrijving
Wijs machtigingensets toe aan Adaptive Planning-gebruikers.
Machtiging vereist voor aanroepen
Gebruikers
met beheerderstoegang
,
machtigingensets
Met de API voor toewijzing van machtigingensets kunt u gebruikersmachtigingensets ophalen en toewijzen.

Ondersteunde HTTPS-werkwoorden:

HTTP-werkwoord
Eén resource
Inningsresource
Omschrijving
GET
Niet ondersteund
Ondersteund
Hiermee worden alle gebruikers en hun toegewezen machtigingensets opgehaald.
POST
Ondersteund
Ondersteund
Hiermee voegt u een machtigingenset toe of werkt u een bestaande machtigingenset voor een gebruiker bij.

GET

Aanvraag:
/users/permissionSets
Hiermee wordt een verzameling machtigingensets opgehaald die aan gebruikers zijn toegewezen
Hiermee worden alle gebruikers en hun toegewezen machtigingensets opgehaald. U kunt filteren op instanceCode. Als de queryparameter instanceCode ontbreekt, haalt de API alle gebruikers en hun machtigingensets op in uw standaardinstance. Bij paginering worden de standaardwaarden voor limiet of verschuiving gebruikt als u deze queryparameters niet opgeeft.
Voorbeeldaanvraag-URI:
HTTPS://api.adaptiveinsights.com/api/rest/security/v1/default/users/
Queryparameters:
Naam
Omschrijving
Vereist
instanceCode
De unieke ID van een instance die de instancecontext definieert.
N
limiet
Het maximum aantal objecten in één antwoord. De standaardwaarde is 500. Het maximum is 500.
N
verschuiving
De op nul gebaseerde index van de eerste gebruiker in een antwoordverzameling. De standaardwaarde is 0.
Gebruik verschuiving met de parameter limiet om het paginering van een antwoordverzameling te beheren.
N
Voorbeeldantwoord:
Voorbeeldantwoord van een instance die door gebruiker is gesynchroniseerd met 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:

Aanvraag:
/users/permissionSets:
Hiermee worden machtigingensets voor gebruikers toegewezen of bijgewerkt.
Hiermee voegt u een machtigingenset toe of werkt u een bestaande machtigingenset voor een gebruiker bij. U kunt filteren op instanceCode. Als de queryparameter instanceCode ontbreekt, wijst de API de bijbehorende machtigingensets toe aan alle gebruikers in uw standaardinstance. Geef in de hoofdtekst van de aanvraag de volgende vereiste queryvelden op: <userIdentifier> en permissionSet. Als u een bulkaanvraag wilt verzenden voor het toewijzen van bijbehorende machtigingensets aan meerdere gebruikers, geeft u een matrix op met elke machtigingstoewijzing.
Queryparameters:
Naam
Omschrijving
Vereist
instanceCode
De unieke ID van een instance die de instancecontext definieert.
N
userIdentifier
De gebruikers-ID om de unieke Adaptive Planning-gebruikers-ID te bepalen. Mogelijke waarden: userName, wid, userGuid.
J
Voorbeeldaanvraag:
HTTPS://api.adaptiveinsights.com/api/rest/security/v1/default/users/permissionSets?userIdentifier=userName
Hoofdtekst voorbeeldaanvraag
Voorbeeld van hoofdtekst na aanvraag
 
[  
  {  
      "userName": "sampleuser1@company.com",
          "permissionSet": [
                  {
                      "name": "samplePermissionSet1"
                  }
      ]
  },
  {
      "userName": "sampleuser2@company.com",
          "permissionSet": [
                  {
                      "name": "samplePermissionSet2"
                  }
          ]
  },
  {
      "userName": "sampleuser3@company.com",
          "permissionSet": [
                  {
                      "name": "samplePermissionSet3"
                  }
          ]
  }
]
PayLoad Parameters
Naam
Omschrijving
Vereist
wid
De Workday-ID van een gebruiker.
N
gebruikersnaam
De gebruikersnaam (aanmeldingsnaam) van een gebruiker.
N
userGuid
De algemene unieke gebruikers-ID die door het systeem is toegewezen bij het maken.
N
Naam
ID
Naam van machtigingenset.
ID van machtigingenset.
Naam of ID van machtigingenset is vereist.
J