DataWorks:Formats des paramètres de planification

Utilisation

Définissez la logique d'affectation d'un paramètre de planification en spécifiant un nom de paramètre et une valeur de paramètre dans la section Scheduling Parameter > scheduling configuration. Une fois le paramètre défini, vous pouvez y faire référence dans votre code à l'aide de la syntaxe ${nom du paramètre}. Pour obtenir des instructions détaillées, consultez la rubrique Configurer et utiliser les paramètres de planification.

• Utilisez les paramètres intégrés au système $bizdate et $cyctime pour représenter respectivement la date métier et l'heure planifiée. Ces paramètres se résolvent selon les valeurs suivantes :

  • $bizdate=${yyyymmdd}

  • $cyctime=$[yyyymmddhh24miss]

    Les exemples précédents illustrent les définitions des paramètres $bizdate (qui se résout en ${yyyymmdd} ) et $cyctime (qui se résout en $[yyyymmddhh24miss] ), ainsi que leurs résultats de prévisualisation lorsque la date métier est le 16/10/2025.

• Si les valeurs par défaut de l'heure de base ne répondent pas à vos besoins, utilisez la syntaxe ${...} et $[...] pour transformer les deux heures de base en paramètres temporels personnalisés.

Différences clés entre ${...} et $[...]

Les formats ${...} et $[...] diffèrent par leurs références temporelles et leurs capacités de calcul. Leur utilisation conjointe peut entraîner des erreurs de données.

Formatage temporel

Utilisez les formats ${...} ou $[...] pour générer des paramètres temporels. Combinez des codes de format tels que yyyy, yy, mm et dd pour générer des dates situées N années, mois ou jours avant ou après la date métier.

Calcul du décalage

Le calcul du décalage vous permet d'ajouter ou de soustraire une durée à une date métier ou à une heure de planification. Vous pouvez appliquer des décalages de N années, mois, jours, heures ou minutes par rapport à la référence temporelle. Les décalages en heures et en minutes sont pris en charge uniquement pour l'heure de planification. Les capacités de décalage de ${...} et $[...] diffèrent car elles prennent en charge différents niveaux de précision temporelle.

1. Calcul du décalage avec ${...}

   • Fonctionnalité principale : prend en charge les décalages entiers pour les années, les mois, les semaines et les jours.

     Important

     Les décalages en heures et en minutes ne sont pas pris en charge. Par exemple, ${yyyy-mm-dd-1/24} constitue une syntaxe invalide.

   • Syntaxe : ${<time_format><±N>}, où l'unité de N correspond à la plus petite unité du format, telle que yyyymm ou yyyymmdd.

     Exigence	Unité de décalage	Syntaxe	Exemple
     N années avant/après	Année	${yyyy±N} ou ${yy±N}	Obtenir l'année précédente : ${yyyy-1}
     N mois avant/après	Mois	${yyyymm±N}	Obtenir le mois précédent : ${yyyymm-1}
     N semaines avant/après	Semaine	${yyyymmdd±7*N}	Obtenir la semaine précédente : ${yyyymmdd-7*1}
     N jours avant/après	Jour	${yyyymmdd±N}	Obtenir le jour précédent : ${yyyymmdd-1}

2. Calcul du décalage avec $[...]

   • Fonctionnalité principale : prend en charge les décalages fractionnaires pour les jours, les heures et les minutes.

     Important

     Le format $[...] ne peut pas utiliser d'expressions telles que $[yyyy-N] ou $[mm-N] pour récupérer des dates datant de N années ou mois. Pour effectuer des décalages en années ou en mois, vous devez utiliser la fonction add_months.

   • Syntaxe : $[<time_format><±N>] , où N représente une fraction d'un jour : utilisez N/24 pour un décalage de N heures et N/24/60 pour un décalage de N minutes.

     Exigence	Unité de décalage	Syntaxe	Exemple
     N années avant/après	Année	Dans N années : $[add_months(yyyymmdd,12N)] Il y a N années : $[add_months(yyyymmdd,-12N)]	Obtenir l'année précédente : $[add_months(yyyymmdd,-12)]
     N mois avant/après	Mois	Dans N mois : $[add_months(yyyymmdd,N)] Il y a N mois : $[add_months(yyyymmdd,-N)]	Obtenir le mois précédent : $[add_months(yyyymmdd,-1)] Obtenir le mois suivant : $[add_months(yyyy_mm,1)]
     N semaines avant/après	Semaine	$[yyyymmdd±7*N]	Obtenir la semaine précédente : $[yyyymmdd-7*1]
     N jours avant/après	Jour	$[yyyymmdd±N]	Obtenir le jour précédent (hier) : $[yyyymmdd-1]
     N heures avant/après	Heure	Formats disponibles : $[hh24miss±N/24], $[hh24±N/24] $[<custom_time_format>±N/24]	Obtenir l'heure précédente dans différents formats : Mois : $[mm-1/24] Année : $[yyyy-1/24] Année et mois : $[yyyymm-1/24] Année, mois et jour : $[yyyymmdd-1/24] Jour précédent et heure précédente : $[yyyymmdd-1-1/24]
     N minutes avant/après	Minute	Formats disponibles : $[hh24miss±N/24/60] $[yyyymmddhh24miss±N/24/60] $[mi±N/24/60] $[<custom_time_format>±N/24/60]	Obtenir l'heure située 15 minutes avant l'heure de planification dans différents formats : $[yyyy-15/24/60] $[yyyymm-15/24/60] $[yyyymmdd-15/24/60] $[hh24-15/24/60] $[mi-15/24/60]
     Décalage combiné	Jour + Heure	$[yyyymmdd±N±M/24], où N est le décalage en jours et M le décalage en heures.	Exemple : Obtenir l'heure du jour précédent et de l'heure précédente → $[yyyymmdd-1-1/24]

     Remarque

     • Gestion du passage à la journée suivante : les décalages en heures et en minutes peuvent entraîner un dépassement de la limite journalière. Pour plus de détails sur la gestion de ce cas, consultez Comment gérer le remplacement des paramètres lors d'un décalage d'une heure franchissant la limite journalière.

     • Calibration de fin de mois : lorsque vous appliquez un décalage mensuel à une date de fin de mois, si le mois cible comporte moins de jours, le résultat est automatiquement ajusté au dernier jour de ce mois. Par exemple, soustraire un mois au 31 mars 2025 renvoie le 28 février 2025, car février ne compte pas 31 jours.

Transformation secondaire à l'aide des fonctions du moteur

Si les capacités intégrées de mise en forme et de décalage ne permettent pas d'obtenir la valeur exacte souhaitée (par exemple, le dernier jour du mois précédent), appliquez une transformation secondaire en utilisant les fonctions du moteur du nœud ou un nœud d'affectation.

Voir : Scénarios typiques de traitement secondaire des valeurs de retour des paramètres de planification .

Concaténation de chaînes

Utilisez la concaténation de chaînes pour construire des chaînes de dates structurées non prises en charge par la syntaxe intégrée. Cette méthode combine une partie de date générée par un paramètre de planification avec une chaîne constante.

Exemples de remplacement de paramètres

La valeur de remplacement d'un paramètre de planification est déterminée lors de la création d'une instance et n'est pas influencée par l'heure réelle de démarrage.

Scénario 1 : planification normale

Dans le cadre d'une planification normale, le remplacement des paramètres s'appuie sur deux repères temporels : la date métier et l'heure de planification.

• ${...} (date métier) : la valeur est dérivée de la date métier de l'instance.

• $[...] (heure de planification) : la valeur est dérivée de l'heure de planification de l'instance.

Prenons l'exemple d'une tâche quotidienne nommée A, planifiée pour s'exécuter à 00:00 avec les paramètres suivants :

• yesterday=${yyyymmdd}

• today=$[yyyymmddhh24miss]

Le tableau ci-dessous illustre le remplacement de ces paramètres pour une instance spécifique :

Scheduling time	Business date	yesterday=${yyyymmdd}	today=$[yyyymmddhh24miss]
2025-3-15 00:00:00	2025-3-14	20250314	20250315000000

Scénario 2 : rétroalimentation de données

Lors d'une rétroalimentation de données, la logique de remplacement des paramètres varie selon la date métier sélectionnée. Cette variation impacte particulièrement les paramètres dépendant de l'heure de planification.

• ${...} (date métier) : le repère correspond à la date métier sélectionnée manuellement.

• $[...] (heure de planification) : le repère correspond à la date métier sélectionnée manuellement + 1 jour.

Par exemple, si vous effectuez une rétroalimentation de la tâche A avec 2025-03-15 comme date métier :

Selected business date	yesterday=${yyyymmdd}	today=$[yyyymmddhh24miss]
2025-03-15	20250315	20250316000000 (Le repère est 2025-03-15 + 1 day)