EXPORT

Icône du lien vers le conceptVoir également Icône du lien vers le conceptExemple

Exécute un export configuré précédemment (Application Explorer).

Support WebVue - Oui.

L'utilisation des verbes EXPORT, EXPORT_LOG et EXPORT_TREND est préférée à celle des verbes SVLOG et SVTREND. Ces derniers ne sont conservés que pour compatibilité.

L’Export de données est protégé par une option de licence dans la clé de protection du logiciel PcVue. Si vous ne possédez pas cette option, l’Export de données ne s’effectuera qu’en mode démonstration.

Mode

Mnémonique

Syntaxe

1 GENERATE 1
2 GENERATE_DATES 2
3 GENERATE_PERIOD 3

Arguments communs

Argument

Définition

ExportName Nom de l'export à exécuter (tel que configuré dans l'Application Explorer). Type STR
ExportPageName Nom de la page à exporter. Si non spécifié, toutes les pages seront exportées. Type STR.
OutputName Nom de la destination de l'export à générer. Si le format de sortie est Csv, alors il s'agit du nom absolu du dossier dans lequel les fichiers Csv de sortie seront stockés. Si le format de sortie est Excel, alors il s'agit du nom absolu du classeur Excel. Si non spécifié, le nom de sortie par défaut configuré dans l'Application Explorer sera utilisé. Le nom du fichier dans lequel le résultat de l'export sera envoyé. Si non spécifié, le nom de fichier par défaut configuré dans l'Application Explorer sera utilisé. Type STR.
Si exécutée dans le contexte d'une session WebVue, cette instruction est traitée par le back end web, en conséquence de quoi le fichier ou dossier sera créé sur la machine back end web.
ReferenceTime Horodate utilisée comme date de référence pour calculer les dates de début et de fin. Si non spécifié, c'est la date actuelle d'exécution de la fonction qui sera utilisée. Type DOUBLE (format DateTimeValue)
StatusVariable Nom d'une variable mesure dans laquelle le status de l'export est reporté. Si non spécifié, c'est la variable de status, telle que configurée dans l'Application Explorer, qui sera utilisée. Si spécifié, la variable de status configurée dans l'Application Explorer, ne sera pas utilisé. Type STR.

Syntaxe 1

IntVal = EXPORT (Mode, ExportName, [ExportPageName], [OutputName], [ReferenceTime], [StatusVariable]);

Type de retour : INTEGER.

Exécution

Mode

Mnémonique

Action

1 GENERATE

Génère l'export.
Retour : 1 si OK, sinon 0 ou une variable négative (ExportName ne correspond pas à l'export configuré, ExportPageName ne correspond pas à la page configurée, OutputName invalide, ne peut pas créer le fichier de sortie, horodates invalides ou configuration d'export invalide).

Syntaxe 2

IntVal = EXPORT (Mode, ExportName, [ExportPageName], [OutputName], [StartTime], [EndTime], [StatusVariable]);

Type de retour : INTEGER.

Argument

Définition

StartTime Horodate à utiliser comme date de début. Type DOUBLE (format DateTimeValue)
EndTime Horodate à utiliser comme date de fin. Type DOUBLE (format DateTimeValue)

Exécution

Mode

Mnémonique

Action

2 GENERATE_DATES

Génère l'export en utilisant l'horodate de début et une période.
Retour : 1 si OK, sinon 0 ou une variable négative (ExportName ne correspond pas à l'export configuré ExportPageName ne correspond pas à la page configurée, OutputName invalide, ne peut pas créer le fichier de sortie, horodates invalides ou configuration d'export invalide).

Syntaxe 3

IntVal = EXPORT (Mode, ExportName, [ExportPageName], [OutputName], [ReferenceTime], [PeriodType], [PeriodValue], [PeriodInterval], [StatusVariable]);

Type de retour : INTEGER.

Argument

Définition

PeriodType Type de période. Complète ou courante. Type INTEGER.
0 = Courante
1 = Complète
-1 = Ignore l'argument.
PeriodValue Valeur de la période. Type INTEGER.
1 à 65535.
-1 = Ignore l'argument.
PeriodInterval Type de période Année, mois, jour... Type INTEGER.
0 = Minutes
1 = Heures
2 = Jours
3 = Semaines
4 = Mois
5 = Années
-1 = Ignore l'argument.

Exécution

Mode

Mnémonique

Action

3 GENERATE_PERIOD

Générer l'exportation en utilisant l'horodatage de début donné et la période.
Retour : 1 si OK, sinon 0 ou valeur négative. ExportName ne correspond pas à l'export configuré, ExportPage ne correspond pas à la page configurée, invalide OutputName, ne peut pas créer de fichier de sortie, d'horodatage invalide ou de configuration invalide dans l'exportation.