SELECTOR mode HISTORICAL

Icône du lien vers le conceptVoir également Icône du lien vers le conceptExempleIcône du lien vers le conceptInfos complémentaires

Sélectionne les données affichées dans une animation contrôle grid. Cette rubrique ne traite que du mode HISTORICAL. Voir la rubrique SELECTOR pour les autres modes.

Support WebVue - Non. Renvoie un code d'erreur si exécuté dans ce contexte.

Si vous utilisez un projet en régions multiples, vous devez paramétrer la région avant d'exécuter les instructions qui interagissent avec l'IHM. Voir la rubrique REGION pour plus d'informations.

Mnémonique du sous-mode

Syntaxe

GETCOUNT 1
INSERTTREND 2
REMOVETREND 3
CLEARTRENDS 1
SETTREND 4
GETTRENDBYINDEX 5
GETINDEX 6
RESTOREDEFAULT 1
CANCEL 1
REQUEST 7
EXPORT 1

Arguments communs à tous les modes

Argument

Définition

Window

Nom de la fenêtre contenant le contrôle grid à utiliser. Type STR

Branch

Branche de la fenêtre (si nécessaire). L'utilisation d'un "*" signifie la branche courante du programme. Type STR.

Identity

Identifiant du contrôle grid dans la fenêtre spécifiée. Type STR

Syntaxe 1

IntVal = SELECTOR("HISTORICAL", Sub-mode, Window, Branch, Identity);

Type de retour : INTEGER.

Exécution

Sous-mode

Action

GETCOUNT

Renvoie le nombre de variables en tendance dans la liste.

CLEARTRENDS

Supprime toutes les variables en tendance dans la liste.
Renvoie le nombre de variables en tendance supprimées.

RESTOREDEFAULT

Restaure la liste des variables et des seuils en tendance comme la configuration d'origine du contrôle grid.
Renvoie le nombre de variables en tendance restaurées.

CANCEL

Annule la requête aux historiques courante.
Retour : 1 si OK.

EXPORT

Démarre l'assistant d'Export depuis le contrôle grid spécifié.
Retour : 1 si OK, -1 si Contrôle Grid pas en mode historique.

  Tous les modes renvoient 0 en cas d'erreur (paramètre erroné ou exécuté en contexte WebVue).

Syntaxe 2

IntVal = SELECTOR("HISTORICAL", Sub-mode, Window, Branch, Identity, VarName [, Index]);

Type de retour : INTEGER.

Argument

Définition

VarName

Nom d'une variable. Type STR.

Index

Index dans la liste. 1 = début de la liste. Type INTEGER

Exécution

Sous-mode

Action

INSERTTREND

Insère une nouvelle variable en tendance dans la liste des variables à la position Index. Si le paramètre Index est omis, la variable est insérée au début de la liste.
Renvoie la position de la variable dans la liste ou 0 en cas d'erreur (paramètre erroné ou exécution en contexte WebVue).

Syntaxe 3

IntVal = SELECTOR("HISTORICAL", Sub-mode, Window, Branch, Identity[, Index]);

Type de retour : INTEGER.

Argument

Définition

Index

Index dans la liste. 1 = début de la liste. Type INTEGER

Exécution

Sous-mode

Action

REMOVETREND

Supprime la variable en tendance, à la position Index, depuis la liste des variables. Si le paramètre Index est omis, la variable de la fin de la liste est supprimée.
Renvoie la position de la variable dans la liste ou 0 en cas d'erreur (paramètre erroné ou exécution en contexte WebVue).

Syntaxe 4

IntVal = SELECTOR("HISTORICAL", Sub-mode, Window, Branch, Identity, Index, VarName[, Thresholds]);

Type de retour : INTEGER.

Argument

Définition

VarName

Nom d'une variable. Type STR.

Index

Index dans la liste. 1 = début de la liste. Type INTEGER

Thresholds

Flag. Type INTEGER

0 - Supprimer le système de seuils

1- Conserver le système de seuils

Exécution

Sous-mode

Action

SETTREND

Modifie la variable en tendance à la position Index et conserver ou supprimer le système de seuil en fonction du flag Thresholds.
Retour : 1 si OK ou 0 en cas d'erreur (paramètre erroné ou exécution en contexte WebVue).

Syntaxe 5

StrVal = SELECTOR("HISTORICAL", Sub-mode, Window, Branch, Identity, Index);

Type de retour : STR

Argument

Définition

Index

Index dans la liste. 1 = début de la liste. Type INTEGER

Exécution

Sous-mode

Action

GETTRENDBYINDEX

Retourne le nom de la variable en tendance à la position du paramètre Index.
Retour : Nom de la variable si OK, chaîne vide sinon (paramètre erroné ou exécution en contexte WebVue).

Syntaxe 6

IntVal = SELECTOR("HISTORICAL", Sub-mode, Window, Branch, Identity, VarName);

Type de retour : INTEGER

Argument

Définition

VarName

Nom d'une variable. Type STR.

Exécution

Sous-mode

Action

GETINDEX

Retourne l'index de la variable en tendance VarName.
Retour : Index du nom de la variable si OK, chaîne vide sinon (paramètre erroné ou exécution en contexte WebVue).

Syntaxe 7

IntVal = SELECTOR("HISTORICAL", Sub-mode, Window, Branch, Identity, StatusVariable [,StartTime, EndTime[, SamplingRateInterval[, SamplingRateValue[, SynchroSecondValue, SynchroMinuteValue, SynchroHourValue, SynchroDayValue]]]]));

Type de retour : INTEGER.

Argument

Définition

StatusVariable

Nom d'une variable mesure. Positionnée à 1 lorsque la requête est en cours d'exécution, 0 sinon. Type STR.

StartTime

Equivalent à la valeur fournie par la variable Heure de début dans l'onglet Historiques/Durée de la boîte de dialogue de configuration du contrôle grid. Type DOUBLE.

EndTime

Equivalent à la valeur fournie par la variable Heure de fin dans l'onglet Historiques/Durée de la boîte de dialogue de configuration du contrôle grid. Type DOUBLE.

SamplingRateInterval

Equivalent à l'unité du taux d'échantillonnage dans l'onglet Historiques/Echantillonnage de la boîte de dialogue de configuration du contrôle grid. Type INTEGER

0 = millisecondes
1 = secondes
2 = minutes
3 = heures
4 = jours
5 = semaines
6 = mois

SamplingRateValue

Equivalent à la propriété Taux d'échantillonnage de l'onglet Historiques/Echantillonnage de la boîte de dialogue de configuration du contrôle grid. Type INTEGER

SynchroSecondValue

Equivalent à la propriété Secondes de l'onglet Historiques/Echantillonnage de la boîte de dialogue de configuration du contrôle grid. Type INTEGER

SynchroMinuteValue

Equivalent à la propriété Minutes de l'onglet Historiques/Echantillonnage de la boîte de dialogue de configuration du contrôle grid. Type INTEGER

SynchroHourValue

Equivalent à la propriété Heures de l'onglet Historiques/Echantillonnage de la boîte de dialogue de configuration du contrôle grid. Type INTEGER

SynchroDayValue

Equivalent à la propriété Jours de l'onglet Historiques/Echantillonnage de la boîte de dialogue de configuration du contrôle grid. Type INTEGER

Exécution

Sous-mode

Action

REQUEST

Génère une nouvelle requête aux historiques pour le contrôle grid en utilisant les paramètres fournis. Pour une explication complète du fonctionnement des paramètres, voir l'aide du contrôle grid
Retour : 1 si OK, -1 si Contrôle Grid pas en mode historique, 0 sinon (paramètre erroné ou exécuté en contexte WebVue).

Exemple

Pour un exemple, sélectionnez le lien Exemple ci-dessus.