Passer au contenu principal
Documentation
Documentation
Adaptive Planning
Dernière mise à jour : 2023-06-23
Temps

Temps

Point de terminaison de l'URL

HTTPS://api.adaptiveinsights.com/api/rest/modeling/{version}/{tenant}/updateTime
Version : v1
Catégorie
Modification des métadonnées
Description
Mettre à jour la structure temporelle dans la planification
Autorisations requises pour appeler
Configurer le calendrier
Paramètres obligatoires dans la demande
S/O

Événements HTTP pris en charge

Version HTTP
Description
POST
En fonction du paramètre d'opération, rechargez/mettez à jour/ajoutez la structure temporelle dans la planification. Si le paramètre d'opération n'est pas spécifié, définissez par défaut l'opération d'ajout.

POST

Demander
/updateTime : met à jour la structure temporelle
Met à jour la structure temporelle dans la planification en fonction de l'opération (recharger/mettre à jour/ajouter) indiquée comme paramètre de requête (ajouter par défaut si l'opération n'est pas indiquée) :
  • Recharger : rechargez l'ensemble de la structure temporelle. Toutes les données existantes seront effacées. Nous permettons également de définir la strate par défaut via les rechargements.
  • Mettre à jour : mettez à jour la structure temporelle existante, par exemple modifier les libellés des strates de temps existantes, ajouter de nouvelles strates, etc. Nous permettons également de définir la strate par défaut via des mises à jour.
  • Ajouter : ajoutez de nouvelles périodes à la structure temporelle. Vous ne pouvez pas modifier les périodes, ajouter un nouveau niveau de granularité pour les périodes ou supprimer des périodes lorsque vous les ajoutez.
Exemple d'URI de demande :
HTTPS://api.adaptiveinsights.com/api/rest/modeling/v1/TIMEREALM/updateTime?operation
En-tête de demande d'exemple
Autorisation : de base ou par jeton.
Type de contenu : application/json
Corps de la demande
Exemple de corps de demande 
{
   "calendars": [
       {
           "name": "DefaultHierarchy",
           "strata": [
               {
                   "code": "month",
                   "label": "Month",
                   "shortName": "Mon"
               },
               {
                   "code": "qtr",
                   "label": "Quarter",
                   "shortName": "Qtr"
               },
               {
                   "code": "year",
                   "label": "Year",
                   "shortName": "Yr"
               }
           ]
       },
       {
           "name": "AltHierarchy",
           "strata": [
               {
                   "code": "month"
               },
               {
                   "code": "altQtr",
                   "label": "AltQuarter",
                   "shortName": "AltQtr"
               },
               {
                   "code": "altYear",
                   "label": "AltYear",
                   "shortName": "AltYr"
               }
           ]
       }
   ],
   "periods": [
       {
           "startDate": "2022-01-01",
           "endDate": "2023-01-01",
           "code": "2022",
           "label": "FY2022",
           "shortName": "2022",
           "stratum": "year"
       },
       {
           "startDate": "2022-01-01",
           "endDate": "2022-04-01",
           "code": "Q1-2022",
           "label": "Q1-FY2022",
           "shortName": "Q1",
           "stratum": "qtr"
       },
       {
           "startDate": "2022-01-01",
           "endDate": "2022-02-01",
           "code": "01/2022",
           "label": "Jan-2022",
           "shortName": "Jan",
           "stratum": "month"
       },
       {
           "startDate": "2022-02-01",
           "endDate": "2022-03-01",
           "code": "02/2022",
           "label": "Feb-2022",
           "shortName": "Feb",
           "stratum": "month"
       },
       {
           "startDate": "2022-03-01",
           "endDate": "2022-04-01",
           "code": "03/2022",
           "label": "Mar-2022",
           "shortName": "Mar",
           "stratum": "month"
       },
       {
           "startDate": "2022-04-01",
           "endDate": "2022-07-01",
           "code": "Q2-2022",
           "label": "Q2-FY2022",
           "shortName": "Q2",
           "stratum": "qtr"
       },
       {
           "startDate": "2022-04-01",
           "endDate": "2022-05-01",
           "code": "04/2022",
           "label": "April-2022",
           "shortName": "April",
           "stratum": "month"
       },
       {
           "startDate": "2022-05-01",
           "endDate": "2022-06-01",
           "code": "05/2022",
           "label": "May-2022",
           "shortName": "May",
           "stratum": "month"
       },
       {
           "startDate": "2022-06-01",
           "endDate": "2022-07-01",
           "code": "06/2022",
           "label": "June-2022",
           "shortName": "June",
           "stratum": "month"
       },
       {
           "startDate": "2022-07-01",
           "endDate": "2022-10-01",
           "code": "Q3-2022",
           "label": "Q3-FY2022",
           "shortName": "Q3",
           "stratum": "qtr"
       },
       {
           "startDate": "2022-07-01",
           "endDate": "2022-08-01",
           "code": "07/2022",
           "label": "July-2022",
           "shortName": "July",
           "stratum": "month"
       },
       {
           "startDate": "2022-08-01",
           "endDate": "2022-09-01",
           "code": "08/2022",
           "label": "Aug-2022",
           "shortName": "Aug",
           "stratum": "month"
       },
       {
           "startDate": "2022-09-01",
           "endDate": "2022-10-01",
           "code": "09/2022",
           "label": "Sept-2022",
           "shortName": "Sept",
           "stratum": "month"
       },
       {
           "startDate": "2022-10-01",
           "endDate": "2023-01-01",
           "code": "Q4-2022",
           "label": "Q4-FY2022",
           "shortName": "Q4",
           "stratum": "qtr"
       },
       {
           "startDate": "2022-10-01",
           "endDate": "2022-11-01",
           "code": "10/2022",
           "label": "Oct-2022",
           "shortName": "Oct",
           "stratum": "month"
       },
       {
           "startDate": "2022-11-01",
           "endDate": "2022-12-01",
           "code": "11/2022",
           "label": "Nov-2022",
           "shortName": "Nov",
           "stratum": "month"
       },
       {
           "startDate": "2022-12-01",
           "endDate": "2023-01-01",
           "code": "12/2022",
           "label": "Dec-2022",
           "shortName": "Dec",
           "stratum": "month"
       },
       {
           "startDate": "2023-01-01",
           "endDate": "2024-01-01",
           "code": "2023",
           "label": "FY2023",
           "shortName": "2023",
           "stratum": "year"
       },
       {
           "startDate": "2023-01-01",
           "endDate": "2023-04-01",
           "code": "Q1-2023",
           "label": "Q1-FY2023",
           "shortName": "Q1",
           "stratum": "qtr"
       },
       {
           "startDate": "2023-01-01",
           "endDate": "2023-02-01",
           "code": "01/2023",
           "label": "Jan-2023",
           "shortName": "Jan",
           "stratum": "month"
       },
       {
           "startDate": "2023-02-01",
           "endDate": "2023-03-01",
           "code": "02/2023",
           "label": "Feb-2023",
           "shortName": "Feb",
           "stratum": "month"
       },
       {
           "startDate": "2023-03-01",
           "endDate": "2023-04-01",
           "code": "03/2023",
           "label": "Mar-2023",
           "shortName": "Mar",
           "stratum": "month"
       },
       {
           "startDate": "2023-04-01",
           "endDate": "2023-07-01",
           "code": "Q2-2023",
           "label": "Q2-FY2023",
           "shortName": "Q2",
           "stratum": "qtr"
       },
       {
           "startDate": "2023-04-01",
           "endDate": "2023-05-01",
           "code": "04/2023",
           "label": "April-2023",
           "shortName": "April",
           "stratum": "month"
       },
       {
           "startDate": "2023-05-01",
           "endDate": "2023-06-01",
           "code": "05/2023",
           "label": "May-2023",
           "shortName": "May",
           "stratum": "month"
       },
       {
           "startDate": "2023-06-01",
           "endDate": "2023-07-01",
           "code": "06/2023",
           "label": "June-2023",
           "shortName": "June",
           "stratum": "month"
       },
       {
           "startDate": "2023-07-01",
           "endDate": "2023-10-01",
           "code": "Q3-2023",
           "label": "Q3-FY2023",
           "shortName": "Q3",
           "stratum": "qtr"
       },
       {
           "startDate": "2023-07-01",
           "endDate": "2023-08-01",
           "code": "07/2023",
           "label": "July-2023",
           "shortName": "July",
           "stratum": "month"
       },
       {
           "startDate": "2023-08-01",
           "endDate": "2023-09-01",
           "code": "08/2023",
           "label": "Aug-2023",
           "shortName": "Aug",
           "stratum": "month"
       },
       {
           "startDate": "2023-09-01",
           "endDate": "2023-10-01",
           "code": "09/2023",
           "label": "Sept-2023",
           "shortName": "Sept",
           "stratum": "month"
       },
       {
           "startDate": "2023-10-01",
           "endDate": "2024-01-01",
           "code": "Q4-2023",
           "label": "Q4-FY2023",
           "shortName": "Q4",
           "stratum": "qtr"
       },
       {
           "startDate": "2023-10-01",
           "endDate": "2023-11-01",
           "code": "10/2023",
           "label": "Oct-2023",
           "shortName": "Oct",
           "stratum": "month"
       },
       {
           "startDate": "2023-11-01",
           "endDate": "2023-12-01",
           "code": "11/2023",
           "label": "Nov-2023",
           "shortName": "Nov",
           "stratum": "month"
       },
       {
           "startDate": "2023-12-01",
           "endDate": "2024-01-01",
           "code": "12/2023",
           "label": "Dec-2023",
           "shortName": "Dec",
           "stratum": "month"
       },
       {
           "startDate": "2022-01-01",
           "endDate": "2023-01-01",
           "code": "alt2022",
           "label": "Alt FY2022",
           "shortName": "Alt2022",
           "stratum": "altYear"    
       },
       {
           "startDate": "2022-01-01",
           "endDate": "2022-05-01",
           "code": "altQ1-2022",
           "label": "Alt Q1-FY2022",
           "shortName": "AltQ1",
           "stratum": "altQtr"
       },
       {
           "startDate": "2022-05-01",
           "endDate": "2022-07-01",
           "code": "altQ2-2022",
           "label": "Alt Q2-FY2022",
           "shortName": "AltQ2",
           "stratum": "altQtr"
       },
       {
           "startDate": "2022-07-01",
           "endDate": "2022-09-01",
           "code": "altQ3-2022",
           "label": "Alt Q3-FY2022",
           "shortName": "AltQ3",
           "stratum": "altQtr"
       },
       {
           "startDate": "2022-09-01",
           "endDate": "2023-01-01",
           "code": "altQ4-2022",
           "label": "Alt Q4-FY2022",
           "shortName": "AltQ4",
           "stratum": "altQtr"
       },
       {
           "startDate": "2023-01-01",
           "endDate": "2024-01-01",
           "code": "alt2023",
           "label": "Alt FY2023",
           "shortName": "Alt2023",
           "stratum": "altYear"    
       },
       {
           "startDate": "2023-01-01",
           "endDate": "2023-05-01",
           "code": "altQ1-2023",
           "label": "Alt Q1-FY2023",
           "shortName": "AltQ1",
           "stratum": "altQtr"
       },
       {
           "startDate": "2023-05-01",
           "endDate": "2023-07-01",
           "code": "altQ2-2023",
           "label": "Alt Q2-FY2023",
           "shortName": "AltQ2",
           "stratum": "altQtr"
       },
       {
           "startDate": "2023-07-01",
           "endDate": "2023-09-01",
           "code": "altQ3-2023",
           "label": "Alt Q3-FY2023",
           "shortName": "AltQ3",
           "stratum": "altQtr"
       },
       {
           "startDate": "2023-09-01",
           "endDate": "2024-01-01",
           "code": "altQ4-2023",
           "label": "Alt Q4-FY2023",
           "shortName": "AltQ4",
           "stratum": "altQtr"
       }
   ]
}
Paramètres de requête
Nom
Description
Obligatoire
opération
Opération d'importation de la structure de temps que vous souhaitez effectuer. Il doit s'agir d'un rechargement, d'une mise à jour ou d'un ajout. Si aucune opération n'est spécifiée, l'ajout par défaut sera effectué.
N
proceedWithWarnings
Paramètre de requête facultatif utilisé pour ignorer les messages d'avertissement. Si la valeur n'est pas activée, les avertissements potentiels seront renvoyés avant l'exécution de l'appel. Ignorez-les en spécifiant ce paramètre à true (vrai) dans l'URL.
N
skipAwaitCacheRefresh
Un paramètre de requête facultatif. Si la valeur est true (vrai), la réponse sera renvoyée dès qu'elle sera prête, sans attendre que le cache s'actualise.
N
Paramètres des données utiles
Objet de structure de temps
Nom
Description
Obligatoire
calendriers
Liste de tous les objets de calendrier à importer. Le calendrier par défaut doit s'afficher en premier. Pour la mise à jour et l'ajout, les utilisateurs doivent inclure tous les calendriers existants.
N
périodes
Liste de tous les objets de période dans les calendriers. Les périodes doivent être répertoriées dans l'ordre du parcours en profondeur pour chaque calendrier. Les périodes du calendrier par défaut doivent s'afficher en premier. Pour les calendriers secondaires, il est facultatif de répertorier les périodes dans la strate branche ou en dessous.
N
Objet de calendrier
Nom
Description
Obligatoire
nom
Nom du calendrier.
O
strata
La liste des objets de strate dans le calendrier doit être placée dans l'ordre croissant du périmètre, le niveau le plus bas étant la strate la plus précise. Pour les calendriers secondaires, il est facultatif de répertorier les strates sous la strate branche.
O
code
Code du calendrier. Prise en charge lorsque des codes de calendrier sont présents.
N
Objet de strate
Nom
Description
Obligatoire
code
Le code de la strate de temps doit être unique.
O
label
Le libellé de la strate de temps doit être unique. Non obligatoire pour les strates partagées qui sont reclassées sous un calendrier secondaire.
O
shortName
Le nom abrégé de la strate de temps doit être unique. Non obligatoire pour les strates partagées qui sont reclassées sous un calendrier secondaire.
N
isDefaultStratum
Si la strate de temps est la strate par défaut. Nous permettons uniquement de définir la strate par défaut dans les opérations de rechargement ou de mise à jour. Si isDefaultStratum n'est indiqué pour aucune strate, nous partirons du principe que la strate feuille est la strate par défaut de l'opération de rechargement et que la strate par défaut existante reste inchangée pour l'opération mise à jour.
N
Objet de la période
Nom
Description
Obligatoire
startDate
La date de début de la période doit être au format yyyy-MM-dd.
O
endDate
La date de fin de la période doit être au format yyyy-MM-dd.
O
code
Le code de la période doit être unique.
O
label
Libellé de la période.
O
shortName
Nom abrégé de la période.
N
stratum
Le code de la strate à laquelle appartient cette période.
O
instanceCode
instanceCode à 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

Réponse

204 Aucun contenu
La réponse réussie est vide avec le code de statut 204.
400 Demande incorrecte
La demande n'a pas pu être comprise par le serveur.
Exemple : 
{
   "message": "Include only one of these valid operation parameters in the request: reload, update, or append.",
   "status": 400
}
{
   "error": "Errors occurred while processing the request.",
   "errors": [
       {
           "error": "Stratum code is required. Specify a code.",
           "field": "calendars[0].strata[2].code",
           "code": "PLN310002"
       }
   ]
}
{
   "error": "Errors occurred while processing the request",
   "errors": [
       {
           "error": "Last descendant period (12/2022) end date (2023-01-02) doesn't match the ancestor period (Q4-2022) end date (2023-01-01).",
           "field": "periods[16]",
           "code": "PLN310002"
       },
       {
           "error": "Last descendant period (12/2022) end date (2023-01-02) doesn't match the ancestor period (2022) end date (2023-01-01).",
           "field": "periods[16]",
           "code": "PLN310002"
       }
   ]
}
401 Non autorisé
L'utilisateur n'est pas autorisé.
Exemple : 
{
   "message": "Invalid credential",
   "status": 401
}
401 interdit
L'utilisateur ne dispose pas des autorisations requises.
Exemple : 
{
   "message": "This resource is only available when the JSON based time API feature and the alternate time roll-up feature are enabled.",
   "status": 403
}
500 Erreur interne du serveur
Erreur interne du serveur.