HAjouteTâche (Fonction)

Compatibilité version 12 : Pour compatibilité avec la version 12, il est également possible de définir une tâche grâce à la structure HTâchePlanifiée. Cette tâche exécutera la procédure stockée indiquée (ou réalisera une sauvegarde de la base de données).

Remarque : A partir de la version 19, HFSQL est le nouveau nom de HyperFileSQL.

Versions 22 et supérieures

Cette fonction est désormais disponible en mode Universal Windows 10 App.

Nouveauté 22

Cette fonction est désormais disponible en mode Universal Windows 10 App.

Versions 24 et supérieures

Cette fonction est désormais disponible pour les applications iPhone/iPad.

Nouveauté 24

Cette fonction est désormais disponible pour les applications iPhone/iPad.

Exemple

MaTâche est une hTâchePlanifiée
MaTâche..Description = "Sauvegarde planifiée " + RC + ...
DateVersChaîne(DateSys(), maskDateSystème) + ...
" à " + HeureVersChaîne(HeureSys(), "HH:MM:SS")
MaTâche..Mois = "*"
MaTâche..JourDeLaSemaine = "*"
MaTâche..JourDuMois = "*"
MaTâche..Heure = SAI_Heure..Heure
MaTâche..Minute = SAI_Heure..Minute
MaTâche..NombreExécution = 1
MaTâche..Procédure = "HBackup"
Ajoute(MaTâche..Paramètre, gsNomBaseCS + "/LOG_TACHES.FIC")
Ajoute(MaTâche..Paramètre, gsNomBaseCS + ".SauvegardePlanifiée")
Ajoute(MaTâche..Paramètre, Vrai)
Ajoute(MaTâche..Paramètre, MaTâche..Description)
nID est un entier = HAjouteTâche(gsConnexionCS, MaTâche)

Syntaxe

Création d'une tâche à partir d'une variable hTâchePlanifiée Masquer les détails

<Résultat> = HAjouteTâche(<Connexion> , <Tâche planifiée>)

<Résultat> : Entier

Identifiant de la tâche planifiée,
-1 en cas d'erreur. La fonction HErreurInfo permet d'identifier l'erreur.

<Connexion> : Chaîne de caractères (avec ou sans guillemets) ou variable de type Connexion

Connexion pour laquelle une tâche doit être ajoutée. Cette connexion correspond :
soit au nom de la connexion définie sous l'éditeur d'analyses ou grâce aux fonctions HDécritConnexion ou HOuvreConnexion.
soit au nom d'une variable de type Connexion.

<Tâche planifiée> : Variable de type hTâchePlanifiée

Nom de la variable de type hTâchePlanifiée manipulée.

Création d'une tâche à partir de la structure HTâchePlanifiée (compatibilité version 12) Masquer les détails

<Résultat> = HAjouteTâche(<Connexion> , <Procédure stockée> [, <Paramètre 1> [... [, <Paramètre N>]]])

<Résultat> : Chaîne de caractères

Identifiant de la tâche planifiée,
-1 en cas d'erreur. La fonction HErreurInfo permet d'identifier l'erreur.

<Connexion> : Chaîne de caractères (avec ou sans guillemets) ou variable de type Connexion

Connexion pour laquelle une tâche doit être ajoutée. Cette connexion correspond :
soit au nom de la connexion définie sous l'éditeur d'analyses ou grâce aux fonctions HDécritConnexion ou HOuvreConnexion.
soit au nom d'une variable de type Connexion.

<Procédure stockée> : Procédure WLangage

Nom de la procédure stockée WLangage qui sera exécutée lors du déclenchement de la tâche. Ce paramètre est de la forme "<Nom de la base>\<Nom de la procédure stockée>". Si ce nom correspond à "HSauvegarde" (ou "HBackup"), la tâche planifiée déclenchera une sauvegarde.

<Paramètre 1> : Type du paramètre optionnel

Paramètre à passer à la procédure stockée. Dans le cas d'une sauvegarde, les paramètres à passer sont ceux de la fonction HSauvegarde, mis à part la connexion.

<Paramètre N> : Type du paramètre optionnel

Paramètre à passer à la procédure stockée. Dans le cas d'une sauvegarde, les paramètres à passer sont ceux de la fonction HSauvegarde, mis à part la connexion.

Remarques

Droits nécessaires

Pour ajouter une tâche, il est nécessaire de posséder :

le droit correspondant (constante hDroitGèreTâche) sur le serveur,
Versions 23 et supérieures
pour chaque base concernée, le droit de connexion (constante hDroitConnexion ou hDroitConnexionCryptée),
Nouveauté 23
pour chaque base concernée, le droit de connexion (constante hDroitConnexion ou hDroitConnexionCryptée),
pour chaque base concernée, le droit de connexion (constante hDroitConnexion ou hDroitConnexionCryptée),
le droit d'exécuter la commande liée à la tâche planifiée.

La tâche sera exécutée avec le compte de l'utilisateur qui a créé la tâche.

Attention : Si le serveur est éteint, la tâche planifiée ne sera pas réalisée. La tâche planifiée sera réalisée à la prochaine date disponible lorsque le serveur sera allumé.

Composante : wd250hf.dll

Voir Aussi

Version minimum requise

Version 12

Documentation également disponible pour…

Commentaires

Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 20/11/2019

Signaler une erreur ou faire une suggestion | Aide en ligne locale