Disponibilité de la feuille
Point de terminaison de l'URL
HTTPS://api.adaptiveinsights.com/api/rest/modeling/<version>/<tenant>/sheet/availability
Version : v1
Catégorie | Modification des métadonnées |
Description | Récupérez ou mettez à jour la disponibilité de valeurs de dimension ou d'attribut pour une feuille et une colonne données. |
Autorisations requises pour appeler | |
Paramètres obligatoires dans la demande | sheetName, columnName |
VERB(S) HTTP pris en charge
Verbe HTTP | Ressource unique | Ressources de recouvrement | Description |
|---|---|---|---|
GET
| Non pris en charge | Prise en charge | Récupère la disponibilité de toutes les valeurs pour une feuille et une colonne données. |
POST
| Non pris en charge | Prise en charge | Mettez à jour la disponibilité des valeurs pour une feuille et une colonne données. |
OPTIONS
| Prise en charge | Prise en charge | Renvoie la liste des paramètres HTTP pris en charge pour cette ressource de collecte. |
GET :
- Demande :
- /sheet/availability:Récupère un ensemble de disponibilités de valeurs.Récupère la disponibilité de toutes les valeurs dans une dimension de feuille. Vous pouvez filtrer par instanceCode, sheetName et columnName.Exemple d'URI de demande :HTTPS://api.adaptiveinsights.com/api/rest/modeling/v1/globosales/sheet/availability?sheetName=ExpenseCube&columnName=Level&columnType=LevelExemple d'en-tête de demande :Accepter la langue : enExemple de corps de demandeParamètres de requêteNomDescriptionObligatoiresheetNameNom de la feuille à partir de laquelle récupérer les valeurs de disponibilité.OcolumnNameNom de la colonne de la feuille à partir de laquelle récupérer les valeurs de disponibilité. Obligatoire pour les feuilles cubes uniquement.Seules les colonnes où la disponibilité de la valeur peut être modifiée sont prises en charge.Pour les colonnes de compte et de périmètre de feuille cube, le nom de la colonne respecte les paramètres régionaux définis dans l'en-tête Accepter la langue.OcolumnCodeCode de la colonne de la feuille à partir de laquelle récupérer les valeurs de disponibilité. Obligatoire pour les feuilles modèles uniquement.Seules les colonnes où la disponibilité de la valeur peut être modifiée sont prises en charge.OcolumnTypeType de colonne pour columnName ou columnCode donné.Valeurs acceptées : compte, périmètre, dimension, attributOinstanceCodeinstanceCode à partir de laquelle extraire les valeurs. Par exemple, GLOBO. Si aucun code d'instance n'est spécifié, l'instance par défaut de l'utilisateur est utilisée.NlimitLe nombre maximum d'objets dans une même réponse.NoffsetIndex à base zéro du premier objet dans une collection de réponse. La valeur par défaut est 0.Utilisez le décalage avec le paramètre de limite pour contrôler la pagination d'un ensemble de réponses.N
- Exemple de réponse
- 200Réponse réussie.Exemple de réponse{ "data": [ { "code": "Corporate Plan", "name": "Corporate Plan", "available": true }, { "code": "Engineering", "name": "Engineering", "available": true }, { "code": "Development", "name": "Development", "available": true }, { "code": "Documentation", "name": "Documentation", "available": true }, { "code": "QA", "name": "QA", "available": true }, { "code": "2014-Development Organization", "name": "2014-Development Organization", "available": false }, { "code": "Development-India", "name": "Development-India", "available": false }, { "code": "QA-India", "name": "QA-India", "available": false }, { "code": "G & A", "name": "G & A", "available": false }, { "code": "Hosting", "name": "Hosting", "available": true }, { "code": "Professional Services", "name": "Professional Services", "available": true }, { "code": "Sales", "name": "Sales", "available": true }, { "code": "Marketing", "name": "Marketing", "available": true }, { "code": "US Sales", "name": "US Sales", "available": false }, { "code": "Worldwide Sales", "name": "Worldwide Sales", "available": true }, { "code": "Asia Sales", "name": "Asia Sales", "available": false }, { "code": "Europe Sales", "name": "Europe Sales", "available": true }, { "code": "Latin America Sales", "name": "Latin America Sales", "available": true } ], "total": 18 }
POST :
- Demande :
- /sheet/availability:Met à jour la disponibilité des valeurs pour un ensemble.Met à jour la disponibilité de toutes les valeurs dans une dimension de feuille.Exemple d'URI de demande :https://api.adaptiveplanning.com/api/rest/modeling/v1/globosales/sheet/availability?sheetName=ExpenseCube&columnName=Level&columnType=LevelExemple d'en-tête de demande :Accepter la langue : enCorps de la demande :Tableau JSON des objets de disponibilité, correspondant à la propriété "données" de l'export. Chaque objet JSON a la structure suivante :NomDescriptionObligatoirecodeCode de la valeur. Utilisé pour identifier de façon unique les valeurs.OnomNom de la valeur.OaccountGroupSi la valeur est un groupe de comptes. Obligatoire pour les comptes.NdisponibleLa valeur est disponible ou non. Si la case est absente, aucun changement n'est effectué.NdeleteIfDataIsPresentSi les données doivent être supprimées, si elles existent. Obligatoire lors de la désactivation d'une valeur de dimension personnalisée dans les feuilles cubes.NactionIfDataIsPresentAction à effectuer lorsqu'il existe des données. Obligatoire lors de la désactivation d'une valeur de dimension personnalisée dans les feuilles modèles.N
- Exemple de corps de demande
- Corps de la demande[ { "code": "SalesCube.DiscountPercent", "name": "Discount Percent", "accountGroup": false, "available": false } ]Paramètres de requêteNomDescriptionObligatoiresheetNameNom de la feuille d'où sont extraites les valeurs de disponibilité.OcolumnNameNom de la colonne de la feuille à partir de laquelle récupérer les valeurs de disponibilité. Obligatoire pour les feuilles cubes uniquement.Seules les colonnes où la disponibilité de la valeur peut être modifiée sont prises en charge.Pour les colonnes de compte et de périmètre de feuille cube, le nom de la colonne respecte les paramètres régionaux définis dans l'en-tête Accepter la langue.OcolumnCodeLe code de la colonne de la feuille dont vous souhaitez extraire la disponibilité. Obligatoire pour les feuilles modèles uniquement.Seules les colonnes où la disponibilité de la valeur peut être modifiée sont prises en charge.OcolumnTypeType de colonne pour columnName ou columnCode donné.Valeurs acceptables : compte, périmètre, dimension, attribut.OinstanceCodeinstanceCode à partir de laquelle extraire les valeurs. Par exemple, GLOBO. Si aucun code d'instance n'est spécifié, l'instance par défaut de l'utilisateur est utilisée.N
- Exemple de réponse :
- 204La réponse réussie est vide avec le code de statut 204.