exportPermissionSets
Catégorie
| Metadata retrieval |
Description
| Renvoie les métadonnées de la liste complète de tous les ensembles d'autorisations de l'instance. |
Autorisations requises pour appeler
| Aucun (doit être des identifiants valides pour l'instance) |
Paramètres obligatoires à la demande
| Identifiants |
La demande de ce mode contient uniquement un marqueur d'identifiant pour identifier et autoriser l'utilisateur appelant. Une fois vérifiée, la méthode renvoie un document XML décrivant l'ensemble d'autorisations complet trouvé dans l'instance de l'utilisateur.
Format de demande
<?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>
élément identifiants
| |||
Nom du marqueur
| identifiants | ||
Description
| Tous les appels d'API doivent contenir un seul élément identifiants pour identifier l'utilisateur qui a appelé l'API. L'appel d'API est ensuite effectué en tant qu'utilisateur (toute la piste d'audit ou l'historique des actions dans le système indique que cet utilisateur a effectué l'action) et par conséquent l'utilisateur doit avoir les autorisations requises pour effectuer l'action dans l'ordre pour l'API appelez pour réussir. | ||
Attributs de l'élément
| |||
Nom de l'attribut
| Obligatoire ?
| Valeur
| Exemple
|
se connecter | O | Le nom de connexion de l'utilisateur appelant la méthode API. Cet utilisateur doit avoir les autorisations requises pour appeler la méthode | sampleuser@company.com |
mot de passe | O | Mot de passe de l'utilisateur appelant la méthode API. | my_password |
paramètres régionaux | N | Indiquez les paramètres régionaux à utiliser pour interpréter les chiffres et les dates entrants, et pour formater les chiffres et les dates sortants (en utilisant le séparateur des milliers, les noms de mois et la mise en forme de date appropriés). Les paramètres régionaux sont également utilisés pour indiquer la langue dans laquelle doivent s'afficher les messages système figurant dans la réponse. Si aucune option n'est indiquée, l'expression en_US (anglais américain) est utilisée. | fr_FR |
instanceCode | N | Si l'utilisateur spécifié dans les identifiants a accès à plusieurs instances de : Adaptive Planning , cet attribut peut être utilisé pour indiquer que l'utilisateur a l'intention d'accéder à une instance autre que son instance par défaut. Si aucune option n'est indiquée, l'instance par défaut de l'utilisateur sera utilisée. Pour déterminer les codes d'instance disponibles, utilisez l'API exportInstances. | MYINSTANCE1 |
Contenu de l'élément
| |||
(aucun) | |||
Format de la réponse
<?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>
Les ensembles d'autorisations et les autorisations sont classés par nom.
élément de réponse
| |||
Nom du marqueur
| réponse | ||
Attributs de l'élément
| |||
Nom de l'attribut
| Obligatoire ?
| Valeur
| Exemple
|
réussite | O | Vrai ou faux, indiquant si l'appel d'API a réussi ou non. Même les appels traités avec succès peuvent contenir des messages d'avertissement dans leur réponse. | vrai |
obsolète | N | S'il figure sur le marqueur de réponse et qu'il est défini sur true (vrai), cet attribut indique que la version de la méthode ou de l'API en cours d'appel est obsolète et qu'elle est actuellement dépréciée. Adaptive Planning . Même si elle continue de fonctionner à ce moment, elle peut cesser de fonctionner prochainement. En général, cet attribut n'est pas présent. | false |
Contenu de l'élément
| |||
Un seul élément de messages facultatifs et exactement un élément de sortie obligatoire. | |||
élément de sortie
| |
Nom du marqueur
| sortie |
Attributs de l'élément
| |
(aucun) | |
Contenu de l'élément
| |
Un seul élément comptes. Ce filtre de sortie est standard sur toutes les réponses d'API et contient la sortie valide de tout appel d'API réussi. | |
élément
permission_sets
| |
Nom du marqueur
| permission_sets |
Description
| Conteneur pour un ou plusieurs éléments d'ensemble d'autorisations. |
Attributs de l'élément
| |
(aucun) | |
Contenu de l'élément
| |
Un ou plusieurs éléments d'ensemble d'autorisations. | |
élément
permission_set
| |||
Nom du marqueur
| permission_set | ||
Description
| Décrit un seul ensemble d'autorisations disponible dans l'instance. | ||
Attributs de l'élément
| |||
Nom de l'attribut
| Obligatoire ?
| Valeur
| Exemple
|
id | O | Numéro d'identifiant système interne de l'ensemble d'autorisations. Elle permet d'identifier l'ensemble d'autorisations attribué à un utilisateur dans l'appel d'API exportUsers. | 1 |
nom | O | Le nom de l'ensemble d'autorisations, tel qu'il apparaît dans Administration des ensembles d'autorisations | Standard |
autorisations | O | Liste des codes, séparés par des virgules, pour les autorisations affectées à cet ensemble d'autorisations. Les codes sont des abréviations internes telles que "SSH" pour Accès aux feuilles et "RPT" pour Accès aux rapports. | SSH,RPT,SCORESWEMPLOI |
Contenu de l'élément
| |||
(aucun) | |||