Schneider Electric PowerSQL, FactoryLink (6.5.0) Mode d'emploi

•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
FactoryLink 6.5.0
Guide de l’utilisateur de
PowerSQL
FactoryLink 6.5.0 / janvier / 1998
PS
•
•
•
•
©Copyright 1984 - 1998 United States Data Corporation. Tous droits réservés.
- NOTE Le présent manuel contient des informations confidentielles de la société United States Data Corporation, domiciliée dans
l’Etat du Delaware. Ces informations sont protégées par la réglementation des Etats-Unis et les traités internationaux en
matière de droit d’auteur et de secret commercial. Dans ce document, la société United States Data Corporation est parfois
appelée « USDATA ». Les informations contenues dans ce document sont susceptibles d’être modifiées sans préavis et ne
constituent en aucun cas un engagement de la part de United States Data Corporation (« USDATA »). Bien que les
programmes logiciels décrits dans ce document (les « programmes logiciels ») soient conçus pour fonctionner en substance
conformément aux indications données, USDATA ne prétend ni ne garantit en aucune façon que (a) les programmes logiciels
fonctionneront autrement que sur la base des instructions d’exploitation les plus récentes fournies par USDATA, (b) les
fonctions exécutées par les programmes logiciels répondront aux besoins de l’utilisateur ou fonctionneront dans les
combinaisons sélectionnées par l’utilisateur ou une tierce personne, (c) le fonctionnement des programmes logiciels sera
exempt de toute erreur en toutes circonstances, (d) tout défaut constaté dans un programme logiciel qui ne soit pas
directement lié au fonctionnement de celui-ci tel que l’expose ce document sera corrigé, (e) le fonctionnement d’un
programme logiciel ne sera pas interrompu pour de courtes périodes en raison d’un défaut de celui-ci ou à la suite d’une
erreur commise par USDATA, ou que (f) les programmes logiciels donneront les résultats escomptés par l’utilisateur ou une
tierce personne.
Les programmes logiciels sont fournis dans le cadre d’une licence ou de tout autre contrat et ne peuvent être utilisés ou
copiés que conformément aux termes du contrat applicable. Il est strictement interdit de copier un logiciel sur tout type de
support en dehors de ceux expressément autorisés dans le contrat applicable. Aucune partie de ce manuel ne peut être
reproduite ou transmise sous quelque forme ou par quelque moyen que ce soit, électronique ou mécanique, y compris par
photocopie et enregistrement, quel que soit le but poursuivi, sans l’autorisation expresse et écrite de USDATA.
Marques commerciales. USDATA et FactoryLink sont des marques déposées de United States Data Corporation. Open
Software Bus est une marque déposée sous licence concédée à United States Data Corporation.
Tous les autres noms de produits cités sont des marques ou des marques déposées de leurs détenteurs respectifs.
2 / FactoryLink 6.5.0 / Guide de l’utilisateur de PowerSQL
•
•
•
•
Table des matières
Guide de l’utilisateur de
PowerSQL
Objectif . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Public . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Structure du Guide de l’utilisateur de PowerSQL . . . . . . . . . . . . . . . . . . . . .
Comment utiliser ce manuel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Pour obtenir de l’aide . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
5
5
5
5
6
8
Aperçu de PowerSQL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
1
Principes d’opération PowerSQL . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
Principes d’opération . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
Utilisation des expressions logiques . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
Configuration des arguments de programme . . . . . . . . . . . . . . . . . . . . . . . . 17
2
Configuration de PowerSQL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
Panneau Contrôle PowerSQL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
Panneau Informations sur PowerSQL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36
3
Codes et messages d’état PowerSQL . . . . . . . . . . . . . . . . . . . . . . . . . 45
Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65
FactoryLink 6.5.0 / Guide de l’utilisateur de PowerSQL / 3
•
•
•
•
4 / FactoryLink 6.5.0 / Guide de l’utilisateur de PowerSQL
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
Avant-propos
O BJECTIF
PowerSQL (Structured Query Language) de FactoryLink 6.5.0 fonctionne en
liaison avec la tâche d’historique FactoryLink afin de permettre à une application
d’accéder à des données contenues dans une base de données relationnelle externe
grâce à une fenêtre de résultat. En outre, PowerSQL fournit des expressions SQL
qui sont entrées dans un tag de message FactoryLink.
Ce guide fournit les informations techniques nécessaires à l’installation, la
configuration et l’administration de PowerSQL.
P UBLIC
Ce manuel s’adresse en particulier aux développeurs d’applications,
programmeurs ou administrateurs impliqués dans la mise en œuvre de
PowerSQL.
S TRUCTURE
DU
G UIDE
DE L ’ UTILISATEUR DE
P OWER SQL
Le Guide de l’utilisateur de PowerSQL est l’un des manuels complémentaires de la
documentation FactoryLink. Pour connaître la structure de l’ensemble de la
documentation, reportez-vous à l’avant-propos du document Principes de base.
Ce manuel comprend trois chapitres :
• Principes d’opération PowerSQL
• Configuration de la tâche PowerSQL
• Codes et messages d’état PowerSQL
C OMMENT
UTILISER CE MANUEL
Les informations contenues dans ce manuel sont présentées de manière
séquentielle par ordre d’exécution. Nous vous conseillons de lire l’ensemble du
manuel afin de vous familiariser avec toute la procédure avant de développer
votre application.
FactoryLink 6.5.0 / Guide de l’utilisateur de PowerSQL / 5
•
•
Conventions
•
•
Aperçu
Au début de ce manuel se trouve une section intitulée « Aperçu ». Elle vous
indique rapidement où vous trouverez des informations nécessaires à l’exécution
des opérations détaillées dans chaque chapitre grâce à des liens hypertextes.
C ONVENTIONS
Les informations contenues dans la documentation sont conformes aux directives
publiées dans The Digital Technical Documentation Handbook de Schultz,
Darrow, Kavanagh et Morse, Developing International User Information de Jones,
Kennelly, Mueller, Sweezy, Thomas et Velez, ainsi qu’à des directives concernant
le style propre à ce type d’entreprise.
Ce manuel utilise les conventions suivantes :
Convention
Description
…
Les points de suspension horizontaux indiquent
l’omission d’un élément dans un exemple.
L’information a été omise car elle n’est pas
importante pour le sujet traité.
.
.
.
Les points de suspension verticaux indiquent
l’omission d’une information dans un format de
commande ou d’exemple. L’information a été omise
car elle n’est pas importante pour le sujet traité.
Caractères en italique
Les caractères en italique indiquent des variables
fournies par l’utilisateur dans les exemples de
commandes. Ils indiquent également des références
à des documents spécifiques.
2QNKEG ¯ GURCEGOGPV
HKZG
La police à espacement fixe indique les noms de
commandes, les exemples de codes ou une sortie.
2QNKEG ¯ GURCEGOGPV
HKZG GP ITCU
La police à espacement fixe en gras est utilisée
dans les exemples de commandes pour indiquer les
mots devant être tapés littéralement.
Caractères sans sérif
Les caractères sans sérif indiquent des noms de
champs, de boutons et les touches du clavier.
6 / FactoryLink 6.5.0 / Guide de l’utilisateur de PowerSQL
AVANT-PROPOS
Conventions
Convention
Description
Caractères en bleu
Les caractères en bleu sont utilisés dans les titres
ainsi que pour attirer l’attention sur des
informations contenues dans le texte.
Appuyer sur nnnnn
Cette commande indique une touche du clavier. Son
nom apparaît en caractères sans sérif.
Cliquer sur nnnnn
Cette commande indique un bouton sur l’écran.
Son nom apparaît en caractères sans sérif.
Maj+F1
Le signe + indique que les touches doivent être
enfoncées simultanément.
Maj+F1 vous indique de maintenir la touche Maj
enfoncée tout en appuyant sur une autre touche ou
sur le bouton de la souris (indiqué ici par F1).
Les autres combinaisons de touches sont
présentées de la même manière.
F1 F2 F3
L’espace entre les noms de touche indique qu’il faut
appuyer sur la touche, puis la relâcher.
La série de touches F1 F2 F3 vous indique
d’appuyer et de relâcher F1, puis F2, puis F3.
Les autres combinaisons de touches sont
présentées de la même manière.
Fichier>Ouvrir
Le signe > indique une progression dans la
séquence d’un menu.
Fichier>Ouvrir indique que vous devez choisir Ouvrir
dans le menu Fichier pour effectuer l’action requise.
Les autres séquences de menu sont présentées de
la même manière.
FactoryLink 6.5.0 / Guide de l’utilisateur de PowerSQL / 7
•
•
Pour obtenir de l’aide
•
•
Convention
Description
FLAPP\user\drw\mydrw.g
Le signe \ indique la structure du répertoire du
fichier.
FLAPP\user\drw\mydrw.g indique que le fichier de
dessin mydrw.g se trouve dans le sous-répertoire
drw du sous-répertoire user correspondant au
répertoire FLAPP.
Les autres structures de répertoire sont présentées
de la même manière.
[]
Les crochets indiquent un argument facultatif.
Vous pouvez choisir toutes les options, une ou
aucune.
{ } et |
Les accolades indiquent un choix. Vous devez
choisir l’un des éléments. La barre verticale sert à
séparer les choix à l’intérieur des accolades.
Exemple de syntaxe
Voici l’exemple d’une syntaxe utilisant ces conventions :
EQOOCPFG fichier_d’entrée [fichier_d’entrée…] {a|b} fichier_de sortie
où
EQOOCPFG
fichier_d’entrée
[fichier_d’entrée…]
{a|b}
fichier_de sortie
P OUR
est tapée telle qu’elle apparaît dans la syntaxe.
indique une variable fournie par l’utilisateur.
indique que l’utilisateur peut fournir optionnellement plusieurs
noms de fichiers d’entrée, chaque nom étant séparé par un
espace.
indique que le a ou le b doit être défini comme un argument.
indique que l’utilisateur doit spécifier un fichier de sortie.
OBTENIR DE L ’ AIDE
Contactez votre assistance technique en cas de problème.
En outre, des fichiers d’aide sont inclus dans chaque panneau de configuration.
Vous pouvez y accéder en cliquant sur Aide dans la barre de menus du panneau.
8 / FactoryLink 6.5.0 / Guide de l’utilisateur de PowerSQL
•
•
•
•
Aperçu de PowerSQL
Utilisation de PowerSQL
Pour plus d’informations sur les étapes suivantes...
Atteindre...
1. Consultez les principes d’opération généraux de
PowerSQL
Chapitre 1, « Principes
d’opération PowerSQL »
2. Consultez l’utilisation des expressions logiques
avec PowerSQL
Chapitre 1, « Principes
d’opération PowerSQL »
3. Consultez l’utilisation des arguments de
programme avec PowerSQL
Chapitre 1, « Principes
d’opération PowerSQL »
4. Configurez le panneau Contrôle PowerSQL
« Panneau Contrôle
PowerSQL » page 20
5. Configurez le panneau Informations sur
PowerSQL
« Panneau Informations
sur PowerSQL » page 36
6. Consultez les codes et les messages d’état
PowerSQL
Chapitre 3, « Codes et
messages d’état
PowerSQL »
FactoryLink 6.5.0 / Guide de l’utilisateur de PowerSQL / 9
•
•
•
•
10 / FactoryLink 6.5.0 / Guide de l’utilisateur de PowerSQL
•
•
•
•
Chapitre 1
Principes d’opération
PowerSQL
• Manipulation des données d’une base de données relationnelle externe à partir
de FactoryLink ;
• Possibilité pour une application d’envoyer et d’extraire des données à/depuis des
tables de base de données externes, y compris celles créées hors de
FactoryLink ;
• Possibilité pour l’utilisateur de définir des tags référencés par le PowerSQL
dans des tableaux collectifs ainsi qu’individuellement ;
• Possibilité pour l’utilisateur d’exécuter des expressions SQL générées dans
PowerVB ou Maths et Logique.
• Possibilité pour l’utilisateur d’exécuter des procédures stockées dans la base de
données pour les serveurs de base de données qui les prennent en charge.
P RINCIPES
D ’ OPÉRATION
Le présent chapitre introduit les concepts opérationnels qui sous-tendent les
Principes d’opération PowerSQL. Pour obtenir des informations sur les procédures
de configuration de cette tâche, reportez-vous au chapitre 2, « Configuration de
PowerSQL ».
PowerSQL est une tâche client historique qui communique avec la tâche
historique via des tags mailbox pour envoyer et recevoir à l’aide du SQL des
informations historisées stockées dans une base de données externe.
FactoryLink 6.5.0 / Guide de l’utilisateur de PowerSQL / 11
Principes d’opération
PowerSQL
La tâche PowerSQL FactoryLink s’exécute conjointement à la tâche historique
FactoryLink et permet à une application d’accéder aux données d’une base
relationnelle externe via une fenêtre de résultat. Par ailleurs, la tâche PowerSQL
traite des expressions SQL entrées dans un tag de message FactoryLink. Elle
fournit les fonctionnalités suivantes :
1
•
PRINCIPES D’OPÉRATION POWERSQL
•
Principes d’opération
•
•
Cette tâche extrait des données d’une base de données relationnelle en générant
une expression SQL SELECT sur des données spécifiées dans une table de
configuration FactoryLink, puis en plaçant les données obtenues dans une table
provisoire appelée table de résultat. L’application FactoryLink peut visualiser et
modifier les données de la table de résultat via une fenêtre de résultat. Ce type de
fenêtre correspond à une fenêtre à curseur qui met en correspondance les colonnes
de données dans une table de base de données relationnelle avec des tags
FactoryLink. La fenêtre de résultat affiche les portions sélectionnées de la table de
résultat.
Par exemple, lorsqu’un écran graphique est utilisé pour afficher la fenêtre de
résultat, il peut afficher autant de lignes de données de la table de résultat que de
tags dans le tableau de tags bidimensionnel. Si la table de résultat contient plus
de lignes que la fenêtre de résultat, l’opérateur peut visualiser toutes les lignes en
déroulant la table de résultat dans la fenêtre.
PowerSQL modifie les données dans une base de données relationnelle en
générant des expressions UPDATE, DELETE et INSERT sur les données
spécifiées dans une table de configuration FactoryLink. La tâche PowerSQL
exécute également des expressions SQL générées par l’utilisateur dans un tag de
message FactoryLink.
Les relations entre la base de données externe, la table de résultat, la fenêtre de
résultat, la base de données temps réel et l’affichage graphique sont présentées
ci-dessous.
#Auto Couleur
18 blanc
19 bleu
19 bleu
La tâche PowerSQL peut lire et écrire la totalité d’un tableau de tags en une seule
opération.
12 / FactoryLink 6.5.0 / Guide de l’utilisateur de PowerSQL
PRINCIPES D’OPÉRATION POWERSQL
Principes d’opération
Figure 1-1
Dans cet exemple, lorsque l’opérateur déroule la table de résultat, les lignes de
cette dernière sont placées dans le tampon interne pour être stockées en mémoire.
Dans le cas présent, la table de résultat contient 25 lignes et le tampon interne
peut en contenir 20 au maximum. Lorsque le tampon est plein, les lignes
excédentaires sont placées dans un tampon externe pour être stockées sur le
disque.
FactoryLink 6.5.0 / Guide de l’utilisateur de PowerSQL / 13
1
Principes d’opération
PowerSQL
Un tampon interne stocke les lignes de la table de résultat dans la mémoire RAM.
Un tampon externe stocke les lignes de débordement du tampon interne sur le
disque. Ainsi, l’opérateur peut dérouler la table de résultat vers l’arrière. Les
tampons sont illustrés à la figure ci-dessous.
•
PRINCIPES D’OPÉRATION POWERSQL
•
Utilisation des expressions logiques
•
•
U TILISATION
DES EXPRESSIONS LOGIQUES
Les expressions logiques vous permettent de spécifier les données d’une base
relationnelle à visualiser ou à modifier. Dans le cadre du PowerSQL, une
expression logique est une commande contenant une clause WHERE SQL
standard. Pour faciliter l’utilisation d’une expression logique au moment de
l’exécution, utilisez le nom d’un tag de message dont la valeur est une clause
WHERE. Si vous visualisez toutes les données d’une colonne dans une table de
base de données relationnelle, vous n’avez pas besoin de spécifier une expression
logique.
Vous devez savoir écrire une expression SQL standard pour configurer le
PowerSQL. Pour obtenir des informations sur l’écriture d’expressions SQL,
consultez tout manuel SQL tel que l’aide-mémoire de SQL et/ou le manuel
utilisateur relatif à la base de données utilisée.
Pour sélectionner des données dans une table de base de données, une expression
logique fonctionne conjointement avec le nom de colonne de la table et des
opérateurs logiques afin de former une clause WHERE SQL. Cette clause permet
de spécifier les lignes d’une table de base de données à placer dans la table de
résultat.
Le tableau suivant présente un extrait de la table de base de données exemple
AUTO.
Table 1-1
DATETRAN
CONVOYEUR
NBAUTO
COULEUR
19910126080000
1
9
jaune
19910126083000
1
10
rouge
19910126090000
1
11
rouge
19910126093000
1
12
rouge
19910126100000
1
13
argent
19910126103000
1
14
noir
19910126110000
1
15
noir
19910126113000
1
16
noir
14 / FactoryLink 6.5.0 / Guide de l’utilisateur de PowerSQL
PRINCIPES D’OPÉRATION POWERSQL
Utilisation des expressions logiques
Table 1-1
1
CONVOYEUR
NBAUTO
COULEUR
19910126120000
1
17
blanc
19910126123000
1
18
blanc
19910126130000
1
19
bleu
19910126133000
1
20
bleu
19910126140000
1
21
bleu
19910126143000
1
22
marron
19910126150000
1
23
bordeaux
19910126153000
1
24
bleu
19910126160000
1
25
bleu
19910126163000
1
26
marron
19910126170000
1
27
bordeaux
Exemple de clause WHERE référençant la table AUTO ci-dessus :
&#6'64#0
HI #0& &#6'64#0 HI #0&
%1081;'74 #0& 0$#761
#0& 0$#761 Dans cet exemple, la clause WHERE demande :
&G SWGNNG EQWNGWT QPV ¾V¾ RGKPVGU NGU CWVQU ¯ FW EQPXQ[GWT GPVTG GV NG LCPXKGT !
FactoryLink 6.5.0 / Guide de l’utilisateur de PowerSQL / 15
Principes d’opération
PowerSQL
DATETRAN
•
PRINCIPES D’OPÉRATION POWERSQL
•
Utilisation des expressions logiques
•
•
A partir de cette clause WHERE, la base de données relationnelle place les
valeurs suivantes dans une table de résultat :
Table 1-2
19910126110000
1
15
noir
19910126113000
1
16
noir
19910126120000
1
17
blanc
19910126123000
1
18
blanc
19910126130000
1
19
bleu
19910126133000
1
20
bleu
19910126140000
1
21
bleu
Si la taille d’affichage de la fenêtre de résultat est 2, les valeurs des tags sont
écrites sur deux lignes de la base de données temps réel. Lorsque les données
parviennent dans la base de données temps réel, les autres tâches FactoryLink
peuvent lire et écrire dans cette dernière ; un opérateur peut visualiser les
données sur un écran graphique.
Le PowerSQL effectue cinq types d’opérations :
Sélection
Mise à jour
Utilise une expression de sélection SQL pour sélectionner et
extraire des données d’une base de données relationnelle, à
afficher dans une table de résultat.
Met les données à jour dans la table de résultat et dans la base de
données externe. Le PowerSQL peut effectuer deux types
d’opérations de mise à jour :
Position—Met à jour la ligne courante de données (sur laquelle
pointe le curseur) affichée dans la table de résultat.
Logique—Met à jour les données décrites par l’expression logique.
Insertion
Insère une ligne de données dans une table de base de données.
Deux types d’opérations d’insertion sont possibles :
Indicateur de création automatique—Si cet indicateur est vrai
(TRUE), une opération d’insertion est exécutée lorsque la mise à
jour ne modifie aucune ligne dans la table de base de données.
Déclencheur d’insertion—Insère une ligne de données lorsque le
déclencheur est défini.
16 / FactoryLink 6.5.0 / Guide de l’utilisateur de PowerSQL
PRINCIPES D’OPÉRATION POWERSQL
Configuration des arguments de programme
Suppression
Supprime une ligne de la table de résultat et de la base de
données externe. Le PowerSQL peut exécuter deux types
d’opérations de suppression :
Logique—Supprime les données décrites par l’expression logique.
Autres
expressions SQL
C ONFIGURATION
Via un tag de message.
DES ARGUMENTS DE PROGRAMME
Configurez les arguments de programme suivants de la configuration système
afin de modifier les fonctionnalités de la tâche PowerSQL :
-L ou -l
Permet l’historisation des erreurs dans le fichier journal. Par
défaut, le PowerSQL n’effectue pas d’historisation des erreurs.
-N ou -n
Notifie lors de l’aboutissement d’un déclencheur de clause
SELECT (sélection) que la requête a entraîné une condition « End
of Fetch » (fin d’extraction), si le nombre de lignes retournées par
la requête n’est pas équivalent à celui défini dans le champ de la
taille de tableau de données. Par défaut, PowerSQL ne signale
cette condition pour une clause SELECT que lorsqu’une opération
de déplacement a déplacé la ligne courante après la dernière ligne
de la requête.
-S[4-160] ou
-s[4-160]
Définit le nombre maximal d’expressions SQL actives que le
PowerSQL peut traiter simultanément. Par défaut, ce nombre est
égal à 160. Pour des applications volumineuses, il peut être
nécessaire de régler ce commutateur de programme, si le serveur
de base de données ne parvient pas à allouer de ressource
permettant d’ouvrir un nouveau curseur SQL.
-V1 ou -v1
-W[5-300] ou
-w[5-300]
Ecrit les expressions SQL générées par le PowerSQL dans le
fichier journal. L’historisation doit être activée pour que ce
commutateur fonctionne. Par défaut, aucune expression SQL
n’est écrite dans le fichier journal.
Définit le time-out maximal en secondes pour l’attente par la
tâche PowerSQL d’une réponse de la tâche historique. Par défaut,
le time-out est de 30 secondes.
FactoryLink 6.5.0 / Guide de l’utilisateur de PowerSQL / 17
Principes d’opération
PowerSQL
Position—Supprime la ligne courante de données (sur laquelle
pointe le curseur) dans la fenêtre de résultat.
1
•
PRINCIPES D’OPÉRATION POWERSQL
•
Configuration des arguments de programme
•
•
18 / FactoryLink 6.5.0 / Guide de l’utilisateur de PowerSQL
•
•
•
•
Chapitre 2
Configuration de
PowerSQL
La présente section fournit une description champ par champ des panneaux de
configuration utilisés pour la configuration de la tâche PowerSQL. Cette dernière
fait appel à une table de configuration appelée table de configuration PowerSQL,
comprenant les deux panneaux suivants :
• Panneau Contrôle PowerSQL. Pour plus d’informations, reportez-vous à la
section « Panneau Contrôle PowerSQL » page 20.
• Panneau Informations sur PowerSQL. Pour plus d’informations, reportez-vous
à la section « Panneau Informations sur PowerSQL » page 36.
Ces panneaux sont configurés dans les domaines SHARED ou USER.
2
Configuration de
PowerSQL
FactoryLink 6.5.0 / Guide de l’utilisateur de PowerSQL / 19
•
CONFIGURATION DE POWERSQL
•
Panneau Contrôle PowerSQL
•
•
P ANNEAU C ONTRÔLE P OWER SQL
Exécutez les étapes suivantes pour configurer le panneau Contrôle PowerSQL :
1 Assurez-vous que le domaine approprié est sélectionné dans la boîte de sélection
du domaine du Gestionnaire de configuration. PowerSQL est généralement
configurée comme une tâche de domaine USER mais vous pouvez également la
configurer comme une tâche de domaine SHARED.
2 Choisissez PowerSQL dans le menu principal du Gestionnaire de configuration
pour afficher le panneau Contrôle PowerSQL.
3 Spécifiez les informations suivantes dans ce panneau :
Nom de
consultation
Chaîne alphanumérique de 1 à 15 caractères spécifiant le nom
attribué par le développeur à l’enregistrement de contrôle.
Entrée valide :
Déclencheur de
sélection
chaîne alphanumérique de 1 à 15
caractères
Nom d’un tag déclenchant une opération de sélection. Ce type
d’opération sélectionne des données spécifiques dans une table de
base de données relationnelle en fonction des informations
spécifiées dans le panneau Informations sur PowerSQL et les
place dans une table de résultat où vous pouvez les visualiser et
les manipuler.
Si le tag spécifié dans ce champ n’est pas déjà défini, une boîte de
dialogue Définition de tag s’affiche lorsque vous cliquez sur Entrée.
Sélectionnez le type de données approprié.
20 / FactoryLink 6.5.0 / Guide de l’utilisateur de PowerSQL
CONFIGURATION DE POWERSQL
Panneau Contrôle PowerSQL
Entrée valide :
Type de données valides :
Déclencheur de
mise à jour
nom de tag standard
digital (numérique), analog
(analogique), longana (entier double
longueur), float (virgule flottante),
message
Nom d’un tag déclenchant une opération de mise à jour.
PowerSQL exécute une mise à jour de position si vous avez défini
un déclencheur de sélection. Lorsque la valeur de ce tag change
au cours d’une mise à jour de position, PowerSQL lit les valeurs
de la ligne active (valeur du tag de la ligne en cours) et met à jour
ces dernières dans la table de résultat et dans la base de données
externe.
PowerSQL exécute une mise à jour logique si vous n’avez pas
défini de déclencheur de sélection permettant de sélectionner des
données spécifiques. Au cours d’une mise à jour logique,
PowerSQL construit l’expression SQL de mise à jour en fonction
des informations entrées dans le panneau Informations sur
PowerSQL. PowerSQL peut traiter une ou plusieurs lignes de
valeurs lors de l’exécution de l’expression SQL de mise à jour.
Pour exécuter une mise à jour sur des lignes de valeurs multiples,
les champs de tag de la ligne en cours et de la taille de tableau de
données (lignes) doivent être configurés ; les tags du panneau
Informations sur PowerSQL doivent correspondre à des tableaux
de tags suffisamment grands pour contenir les valeurs définies
par le champ de la taille de tableau de données. Avant de définir
le déclencheur de mise à jour, spécifiez pour le tag de la ligne en
cours le nombre de lignes de valeurs à traiter par l’expression de
mise à jour. Ce champ doit contenir un nombre entier compris
entre 1 et la taille du tableau de données.
FactoryLink 6.5.0 / Guide de l’utilisateur de PowerSQL / 21
2
Configuration de
PowerSQL
Pour qu’une mise à jour de position fonctionne, la table de base de
données doit disposer d’un seul index. Cette configuration peut
être définie dans Création structure base de données ou exécutée
hors de FactoryLink lors de la création de la table de base de
données. Pour plus d’informations sur la configuration du
panneau Création structure base de données, reportez-vous au
FactoryLink Configuration Guide Chapter 20, « Data Logging
Operations, ». Reportez-vous à la section « Working with Tables »
page 281 du manuel FactoryLink Configuration Guide pour créer
un index unique pour une table dBASE IV existante. Consultez le
manuel utilisateur du SGBDR approprié pour créer un index
unique pour une table non-dBASEIV existante.
•
CONFIGURATION DE POWERSQL
•
Panneau Contrôle PowerSQL
•
•
Pour exécuter une opération de mise à jour traitant une seule
ligne de valeurs, définissez la valeur 1 pour la taille de tableau de
données et laissez le champ de tag de la ligne en cours en blanc.
Cette configuration entraîne l’utilisation par PowerSQL d’une
seule ligne de valeurs lors de l’exécution de la mise à jour.
Si le tag spécifié dans ce champ n’est pas déjà défini, une boîte de
dialogue Définition de tag s’affiche lorsque vous cliquez sur Entrée.
Sélectionnez le type de données approprié.
Entrée valide :
Type de données valides :
Déclencheur de
suppression
nom de tag standard
digital (numérique), analog
(analogique), longana (entier double
longueur), float (virgule flottante),
message
Nom d’un tag déclenchant une opération de suppression.
PowerSQL exécute une suppression de position si vous avez défini
un déclencheur de sélection. PowerSQL supprime la ligne active
de la table de résultat et de la base de données externe lorsque la
valeur de ce tag change au cours d’une suppression de position.
Pour qu’une suppression de position fonctionne, la table de base
de données doit disposer d’un index unique. Cette configuration
peut être définie dans Création structure base de données ou
lorsque la table de base de données est créée. Pour plus
d’informations sur la configuration du panneau Création
structure base de données, reportez-vous à la section
« Indexation » au chapitre 5 du Guide des principes de base de
FactoryLink 6.5.0 si vous voulez créer un index unique pour une
table dBASE IV existante. Consultez le manuel utilisateur du
SGBDR approprié pour créer un index unique pour une table
non-dBASEIV existante.
PowerSQL exécute une suppression logique si vous n’avez pas
défini de déclencheur de sélection permettant de sélectionner des
données spécifiques. Au cours d’une suppression logique,
PowerSQL construit l’expression SQL de suppression en fonction
des informations entrées dans le panneau Informations sur
PowerSQL. PowerSQL peut traiter une ou plusieurs lignes de
valeurs lorsque l’expression SQL de suppression est exécutée.
22 / FactoryLink 6.5.0 / Guide de l’utilisateur de PowerSQL
CONFIGURATION DE POWERSQL
Panneau Contrôle PowerSQL
Pour exécuter une opération de suppression sur des lignes de
valeurs multiples, les champs de tag de la ligne en cours et de la
taille de tableau de données (lignes) doivent être configurés ; les
tags du panneau Informations sur PowerSQL doivent
correspondre à des tableaux de tags suffisamment grands pour
contenir les valeurs définies par le champ de la taille de tableau
de données. Avant de définir le déclencheur de suppression,
spécifiez pour le tag de la ligne en cours le nombre de lignes à
traiter par l’expression SQL de suppression. Ce champ doit
contenir un nombre entier compris entre 1 et la taille du tableau
de données.
Pour exécuter une opération de suppression traitant une seule
ligne de valeurs, définissez la valeur 1 pour la taille de tableau de
données et laissez le champ de tag de la ligne en cours en blanc.
Cette configuration entraîne l’utilisation par PowerSQL d’une
seule ligne de valeurs lors de l’exécution de la suppression.
Entrée valide :
Type de données valides :
*Déclencheur
d’insertion
Création
automatique
nom de tag standard
digital (numérique), analog
(analogique), longana (entier double
longueur), float (virgule flottante),
message
Ce champ peut être configuré comme un déclencheur d’insertion
ou comme un champ de création automatique qui entraîne
l’insertion par PowerSQL d’une ligne dans une table de base de
données lorsqu’une opération de mise à jour logique n’a modifié
aucune donnée.
Pour configurer ce champ comme commutateur de création
automatique, entrez :
OUI Insère une nouvelle ligne de données lorsqu’une
mise à jour logique ne modifie aucune donnée.
NON N’insère aucune nouvelle ligne. Valeur par défaut.
FactoryLink 6.5.0 / Guide de l’utilisateur de PowerSQL / 23
2
Configuration de
PowerSQL
Si le tag spécifié dans ce champ n’a pas été défini, une boîte de
dialogue Définition de tag s’affiche lorsque vous cliquez sur Entrée.
Sélectionnez le type de données approprié.
•
CONFIGURATION DE POWERSQL
•
Panneau Contrôle PowerSQL
•
•
Lorsqu’un tag est configuré dans ce champ, il joue le rôle de
déclencheur d’insertion. La configuration d’un déclencheur de
sélection avec un déclencheur d’insertion constitue une
configuration erronée, signalée au démarrage de tâche. Le
déclencheur d’insertion entraîne la construction par PowerSQL
d’une expression SQL d’insertion basée sur les informations
entrées dans le panneau Informations sur PowerSQL. PowerSQL
peut insérer une ou plusieurs lignes de données lors de
l’exécution de l’expression d’insertion.
Pour exécuter une opération d’insertion sur des lignes de valeurs
multiples, les champs de tag de la ligne en cours et de la taille de
tableau de données (lignes) doivent être configurés ; les tags du
panneau Informations sur PowerSQL doivent correspondre à des
tableaux de tags suffisamment grands pour contenir les valeurs
définies par le champ de la taille de tableau de données. Avant de
définir le déclencheur d’insertion, spécifiez pour le tag de la ligne
en cours le nombre de lignes de valeurs à traiter par l’expression
d’insertion. Ce champ doit contenir un nombre entier compris
entre 1 et la taille du tableau de données.
Pour exécuter une opération d’insertion traitant une seule ligne
de valeurs, définissez la valeur 1 pour la taille de tableau de
données et laissez le champ de tag de la ligne en cours en blanc.
Cette configuration entraîne l’utilisation par PowerSQL d’une
seule ligne de valeurs lors de l’exécution de l’insertion.
Si le tag spécifié dans ce champ n’a pas été défini, une boîte de
dialogue Définition de tag s’affiche lorsque vous cliquez sur Entrée.
Sélectionnez le type de données approprié.
Entrée valide :
Type de données valides :
Déclencheur de
déplacement
OUI ou NON ou nom de tag standard
digital (numérique), analog
(analogique), longana (entier double
longueur), float (virgule flottante),
message
(Requiert l’utilisation du déclencheur de sélection.) Nom d’un tag
analogique dont la valeur entraîne l’exécution par PowerSQL
d’un déplacement relatif basé sur la ligne active. Si le déclencheur
de déplacement contient un nombre négatif, la ligne active est
abaissée de cette valeur ; s’il contient un nombre positif, la ligne
active est remontée de cette valeur. Lorsque l’opération est
terminée, le tag de la ligne en cours reflète la position de la ligne
active dans la fenêtre de résultat. La tâche PowerSQL déroule les
lignes de données dans la fenêtre de résultat pour refléter la
nouvelle position de la ligne active.
24 / FactoryLink 6.5.0 / Guide de l’utilisateur de PowerSQL
CONFIGURATION DE POWERSQL
Panneau Contrôle PowerSQL
Par exemple, si la valeur du tag Déclencheur de déplacement est
égale à 3, que celle du tag de la ligne en cours est égale à 0 (la
ligne active est la première ligne de la fenêtre de résultat) et que
la taille de la fenêtre de résultat (taille de tableau de données) est
de cinq lignes, la valeur du tag de la ligne en cours devient 3 et les
données affichées dans la fenêtre de résultat ne sont pas
déroulées. Si la valeur du tag de déclencheur de déplacement est
8, celle du tag de la ligne en cours est de nouveau égale à 3, mais
les données sont déroulées car le nombre de lignes déplacées est
supérieur à la taille de la fenêtre de résultat.
Les opérations de déplacement peuvent être exécutées
uniquement sur des tables de résultat ; par conséquent, vous
devez avoir défini et exécuté auparavant un déclencheur de
sélection.
Si le tag spécifié dans ce champ n’a pas été défini, une boîte de
dialogue Définition de tag s’affiche lorsque vous cliquez sur Entrée.
Sélectionnez le type de données approprié.
Entrée valide :
Type de données valides :
nom de tag standard
analog (analogique)
FactoryLink 6.5.0 / Guide de l’utilisateur de PowerSQL / 25
2
Configuration de
PowerSQL
Le déroulement des données de la fenêtre de résultat est contrôlé
par le déclencheur de déplacement et par la taille du cache
interne. Si cette dernière n’est pas définie, la ligne active peut
être déroulée uniquement vers l’arrière (déclencheur de
déplacement négatif) jusqu’à la ligne située au début de la fenêtre
de résultat. Si l’utilisateur tente de dérouler vers l’arrière au-delà
de la fenêtre de résultat, PowerSQL génère une erreur et définit
la valeur 0 pour le tag de la ligne en cours. En effet, les données
précédemment déroulées dans la fenêtre de résultat n’ont pas été
placées en mémoire cache et ne sont plus accessibles par
PowerSQL. Cette configuration n’empêche pas le déroulement
vers l’avant (déclencheur de déplacement positif) jusqu’à la fin de
la table de résultat. Cette méthode de déroulement des données à
l’intérieur d’une fenêtre de résultat est la plus efficace car elle
utilise moins de mémoire et d’espace disque.
•
CONFIGURATION DE POWERSQL
•
Panneau Contrôle PowerSQL
•
•
Déclencheur de
position
(Requiert l’utilisation du champ Déclencheur de sélection.) Nom
d’un tag qui déplace la fenêtre de résultat à la ligne spécifiée dans
la table de résultat. Le tag de la ligne en cours reflète la position
de la ligne active dans la fenêtre de résultat. Par exemple, si la
valeur du tag est 42, la fenêtre de résultat affiche la ligne 42 de la
table de résultat et le tag de la ligne en cours reflète la position de
la ligne 42 dans la fenêtre de résultat.
Le champ Taille du cache interne (lignes) fonctionne également
conjointement au tag Déclencheur de position. Si ce champ n’est
pas configuré, le tag Déclencheur de position ne peut pas
positionner la ligne active sur des lignes dont la valeur est
inférieure à celle de la ligne de début de la fenêtre de résultat.
Une telle tentative entraîne la génération d’une erreur par
PowerSQL et le positionnement du tag de la ligne en cours à 0. En
effet, les données précédemment déroulées depuis la fenêtre de
résultat n’ont pas été placées en mémoire cache et ne sont plus
accessibles par PowerSQL. Cette configuration ne vous empêche
pas de définir le tag de déclencheur de position sur des lignes non
encore affichées dans la fenêtre de résultat. Cette méthode de
déroulement des données à l’intérieur d’une fenêtre de résultat
est la plus efficace car elle utilise moins de mémoire et d’espace
disque.
Les opérations de positionnement sont effectuées uniquement sur
des tables de résultat ; par conséquent, vous devez avoir défini et
exécuté auparavant un déclencheur de sélection.
26 / FactoryLink 6.5.0 / Guide de l’utilisateur de PowerSQL
CONFIGURATION DE POWERSQL
Panneau Contrôle PowerSQL
Si le tag spécifié dans ce champ n’a pas été défini, une boîte de
dialogue Définition de tag s’affiche lorsque vous cliquez sur Entrée.
Sélectionnez le type de données approprié.
Entrée valide :
Type de données valides :
Mailbox historique
nom de tag standard
analog (analogique)
Nom d’un tag mailbox utilisé pour la communication entre
PowerSQL et un historique. PowerSQL envoie des demandes
d’informations contenues dans la base de données relationnelle à
ce tag mailbox. La tâche historique lit le tag et transmet la
demande à la base de données externe.
Si le tag spécifié dans ce champ n’a pas été défini, une boîte de
dialogue Définition de tag s’affiche lorsque vous cliquez sur Entrée.
Sélectionnez le type de données approprié.
Entrée valide :
Type de données valides :
Ce champ peut être configuré comme un tag de base de données
temps réel ou comme une chaîne constante caractères. Si un tag
de message est configuré, l’utilisateur peut utiliser cet
enregistrement de contrôle pour accéder à des tables de base de
données multiples disposant de structures similaires. Pour
pouvoir utiliser cette fonctionnalité, le tag de message doit
contenir le nom alias de la base de données (défini dans la tâche
historique) ainsi que le nom de la table de base de données à
accéder. Placez un « . » entre le nom alias de la base de données et
le nom de table. Assurez-vous que ce tag contient une telle chaîne
avant de définir un déclencheur de sélection, de mise à jour,
d’insertion ou de suppression.
Si le champ Tag PowerSQL est configuré, PowerSQL n’utilise que
le nom alias de la base de données et ignore le reste de la chaîne
pour ce type d’opération. En effet, l’expression SQL dans le tag
PowerSQL fait référence à la table de base de données à accéder.
FactoryLink 6.5.0 / Guide de l’utilisateur de PowerSQL / 27
2
Configuration de
PowerSQL
*Nom de table
base de données
nom de tag standard
mailbox
•
CONFIGURATION DE POWERSQL
•
Panneau Contrôle PowerSQL
•
•
Si le champ Nom de table base de données fait référence à un tag,
PowerSQL vérifie si ce dernier à changé depuis la dernière
opération de sélection, de mise à jour logique, de suppression
logique ou d’insertion. Si tel est le cas, PowerSQL ferme toutes les
expressions SQL référencées par l’enregistrement de contrôle et
en crée de nouvelles basées sur le nom de table base de données
spécifié dans ce tag. Dans le cas d’une mise à jour de position et
d’une suppression de position, la vérification est ignorée puisque
ces deux opérations sont contrôlées par l’opération du
déclencheur de sélection.
L’utilisateur peut choisir d’entrer une constante chaîne
caractères. Si tel est le cas, la constante chaîne caractères doit
contenir une apostrophe (‘) comme premier caractère, puis le nom
alias de la base de données suivi du nom de table de base de
données. Placez un point ‘.’ entre le nom alias de la base de
données et le nom de table. Si le champ Tag PowerSQL est
configuré, seul le nom alias de la base de données est requis.
Pour qu’un nom de table de base de données soit complètement
qualifié, il peut contenir plus d’un point. Tout point
supplémentaire dans le nom de la table doit être précédé du
caractère de barre oblique inverse « \ » pour que PowerSQL
puisse analyser correctement ce nom.
Par exemple, analias.scott\.matable. Le nom de table scott\.matable
est complètement qualifié ; la barre oblique inverse doit précéder
le point séparant « scott » et « matable ». « analias » représente le
nom alias de la base de données configuré dans une tâche
historique.
Si le tag spécifié dans ce champ n’a pas été défini, une boîte de
dialogue Définition de tag s’affiche lorsque vous cliquez sur Entrée.
Sélectionnez le type de données approprié.
Entrée valide :
Type de données valides :
Tag PowerSQL
chaîne alphanumérique de 1 à 63
caractères ou nom de tag standard
message
Nom d’un tag de message utilisé par l’utilisateur pour fournir une
expression SQL exécutée par PowerSQL lorsqu’un déclencheur de
sélection ou un déclencheur de mise à jour est défini. PowerSQL
lit ce tag uniquement lorsqu’un déclencheur de sélection ou de
mise à jour est défini par l’application. La configuration d’un
déclencheur de suppression ou d’insertion n’est pas valide et
aboutit à la génération d’une erreur au démarrage de tâche.
28 / FactoryLink 6.5.0 / Guide de l’utilisateur de PowerSQL
CONFIGURATION DE POWERSQL
Panneau Contrôle PowerSQL
Seul un déclencheur de sélection ou de mise à jour peut être
configuré lors de la configuration d’un tag PowerSQL.
Configurez un déclencheur de mise à jour lorsque l’expression
SQL ou la procédure stockée modifie ou insère des lignes dans
une table de base de données, perd ou crée des objets de base de
données (tables, index, etc.) dans un serveur de base de données.
Utilisez un déclencheur de sélection lorsque l’expression SQL est
de type SELECT ou lorsqu’une procédure stockée renvoie une
table de résultat. Lorsqu’une table de résultat est générée,
l’utilisateur peut configurer un déclencheur de déplacement ou
un déclencheur de position. Ces déclencheurs permettent à
l’utilisateur de dérouler la table de résultat.
Pour que PowerSQL exécute une procédure stockée, vous devez
utiliser une syntaxe spéciale. Pour l’exécution d’une procédure
stockée base de données, le tag PowerSQL doit contenir une
séquence d’échappement standard ODBC permettant d’exécuter
les procédures stockées. La syntaxe de cette séquence est la
suivante :
{ [?=] call nom-proc [ ( [paramètre][,[paramètre]]… ) ] }
où
{ } (Requis) Accolades de début et de fin d’une
expression d’appel
?= (Facultatif) Si la procédure stockée renvoie une
valeur et que vous voulez la stocker dans un tag,
incluez ceci. Le ? représente une variable de
remplacement (marque de réservation) pour la
valeur de retour.
FactoryLink 6.5.0 / Guide de l’utilisateur de PowerSQL / 29
2
Configuration de
PowerSQL
Le tag PowerSQL peut contenir toute expression SQL correcte
également valide pour le serveur de base de données en
communication avec la tâche historique. Des variables d’entrée
peuvent être référencées par « ? » dans le corps d’une expression
SQL. Chaque variable d’entrée doit être associée à un
enregistrement dans le panneau Informations sur PowerSQL.
Cette expression peut également générer une table de résultat,
chaque colonne de données de résultat devant également être
associée à un enregistrement dans le panneau Informations sur
PowerSQL. Pour plus de détails, reportez-vous à la description du
champ Expression colonne dans ce panneau. Dans le cas des
expressions SQL ne nécessitant pas de variable d’entrée ou
générant une table de résultat, ce panneau peut être laissé en
blanc.
•
CONFIGURATION DE POWERSQL
•
Panneau Contrôle PowerSQL
•
•
call (Requis) Appel de mot clé
nom-proc (Requis) Nom de la procédure stockée à exécuter
( ) (Requis) Parenthèses de début et de fin de liste
de paramètres d’une procédure stockée.
paramètre Liste de paramètres séparés par une virgule. Un
paramètre représente une variable de
remplacement « ? », une constante numérique ou
une chaîne constante caractères SQL.
Si la clause est entourée de [ ], elle est facultative.
Par exemple,
{ ? = call add_employee(1001, ‘John’, ‘Doe’, ‘Engineer’) }
{ ? = call add_employee(?,?,?,?) }
Si le tag spécifié dans ce champ n’a pas été défini, une boîte de
dialogue Définition de tag s’affiche lorsque vous cliquez sur Entrée.
Sélectionnez le type de données approprié.
Entrée valide :
Type de données valides :
Tag ligne en cours
nom de tag standard
message
Nom d’un tag de base de données temps réel. Pour les opérations
de sélection, de déplacement ou de positionnement, cette valeur
de tag indique la position de la ligne de données active dans une
fenêtre de résultat. Lorsque PowerSQL exécute ce type
d’opération, il écrit la valeur indiquée par la position de la ligne
active dans ce tag. Dans ces cas, la valeur du tag de la ligne en
cours est comprise entre 0 et la taille de tableau de données – 1.
PowerSQL écrit le tag de la ligne en cours et l’application doit
considérer ce dernier comme défini en lecture seule.
Si un déclencheur de sélection a été défini, PowerSQL exécute
toutes les opérations de mise à jour de position et de suppression
de position sur la ligne indiquée par le tag de la ligne en cours.
Pour les opérations de mise à jour logique, de suppression logique
et d’insertion, la valeur du tag de la ligne en cours correspond au
nombre de lignes de valeurs à traiter. Elle doit être comprise
entre 1 et la taille de tableau de données. Les valeurs des tags de
tableaux définies dans le panneau Informations sur PowerSQL
doivent être contiguës : en effet, PowerSQL lit le tag spécifié dans
ce panneau et les tags de ligne en cours suivants dans le tableau
de tags lorsque l’opération de mise à jour logique, de suppression
logique ou d’insertion est exécutée.
30 / FactoryLink 6.5.0 / Guide de l’utilisateur de PowerSQL
CONFIGURATION DE POWERSQL
Panneau Contrôle PowerSQL
Si le tag spécifié dans ce champ n’a pas été défini, une boîte de
dialogue Définition de tag s’affiche lorsque vous cliquez sur Entrée.
Sélectionnez le type de données approprié.
Entrée valide :
Type de données valides :
nom de tag standard
analog (analogique)
2
Nombre compris entre 1 et 1000 spécifiant le nombre de lignes de
données contenues dans une fenêtre de résultat ou le nombre
maximal de lignes de valeurs qu’une opération de mise à jour
logique, de suppression logique ou d’insertion peut traiter. Les
tags spécifiés dans le champ Nom de tag du panneau
Informations PowerSQL doivent constituer un tableau de taille
suffisante pour pouvoir contenir les valeurs déterminées par le
champ de la taille de tableau de données (lignes). Ce champ
contrôle le nombre de lignes de données extraites par PowerSQL
lors de l’exécution d’une opération de sélection, de déplacement
ou de positionnement.
Si le champ de la taille de tableau de données (lignes) est
configuré avec un nombre dépassant la taille de message
maximale pouvant être traitée dans un tag mailbox, PowerSQL
éclate cette opération en plusieurs opérations jusqu’à ce que
toutes les lignes de données soient traitées.
FactoryLink 6.5.0 / Guide de l’utilisateur de PowerSQL / 31
Configuration de
PowerSQL
Taille de tableau
de données
(lignes)
•
CONFIGURATION DE POWERSQL
•
Panneau Contrôle PowerSQL
•
•
Par exemple, le nombre spécifié dans ce champ est 1. Entrez une
valeur positive élevée dans le champ Déclencheur de déplacement
ou Déclencheur de position pour dérouler directement jusqu’à la
fin de la fenêtre de résultat. Une seule ligne de données à la fois
étant demandée, l’opération dure plus longtemps lorsqu’elle est
effectuée sur une table de résultat volumineuse que lorsque vous
avez déjà spécifié une valeur élevée dans ce champ.
Entrée valide :
Taille du cache
interne (lignes)
nombre compris entre 1 et 1000
Nombre entre 0 et 9999 spécifiant le nombre de lignes de données
d’une table de résultat mises en mémoire cache. Ce champ se
justifie uniquement dans le cas des opérations de sélection pour
lesquelles un déclencheur de déplacement et/ou de
positionnement a été configuré. Ainsi, si l’enregistrement de
contrôle ne dispose pas d’un déclencheur de sélection ou dispose
d’un déclencheur de sélection mais non de déclencheur de
déplacement ou de positionnement, laissez ce champ en blanc.
Si un déclencheur de sélection est défini avec un déclencheur de
déplacement ou de positionnement, la valeur de ce champ affecte
les opérations de déplacement et de positionnement. Pour plus
d’informations, reportez-vous aux descriptions des champs
Déclencheur de déplacement et Déclencheur de position.
Le cache interne permet à l’utilisateur de dérouler vers l’avant et
vers l’arrière la table de résultat générée lorsqu’un déclencheur
de sélection est exécuté. Si cet enregistrement de contrôle est
utilisé pour charger simplement les tags avec des informations et
permet uniquement le déroulement avant, le champ Taille du
cache interne n’est pas nécessaire. Si cet enregistrement de
contrôle est utilisé comme une grille de table pour qu’un
opérateur effectue un déroulement vers l’avant et vers l’arrière,
configurez ce champ pour que toutes les lignes d’une table de
résultat soient accédées et affichées.
Respectez certaines directives pour la définition de la taille de
tableau de données et la taille du cache interne : si cet
enregistrement de contrôle est utilisé par un opérateur pour
visualiser une grille de table sur un écran graphique, il est
déconseillé de définir une taille de tableau de données supérieure
à 50. Visualiser plus de 50 lignes de données dans une grille de
table s’avère difficile. En revanche, une taille de tableau de
données égale ou inférieure à 50 et une taille de cache interne
égale à 100 fournit une performance acceptable d’affichage par
l’opérateur.
32 / FactoryLink 6.5.0 / Guide de l’utilisateur de PowerSQL
CONFIGURATION DE POWERSQL
Panneau Contrôle PowerSQL
Si cet enregistrement de contrôle est utilisé pour remplir
rapidement un tableau de tags permettant de télécharger des
informations depuis une table de base de données vers un
automate programmable (PLC), la définition d’une taille de
tableau de données supérieure à 50 prend tout son intérêt. Dans
une telle situation, la définition de la taille du cache interne
ralentit l’opération ; en effet, une copie des données en mémoire
est effectuée (deux fois) suivie d’une copie sur le disque.
Entrée valide :
Déclencheur sur
fin d’action
valeur numérique jusqu’à 9999
Nom d’un tag dont l’indicateur de changement d’état est défini
lorsque toute opération entreprise par cet enregistrement de
contrôle est terminée.
Si le tag spécifié dans ce champ n’a pas été défini, une boîte de
dialogue Définition de tag s’affiche lorsque vous cliquez sur Entrée.
Sélectionnez le type de données approprié.
Etat terminaison
nom de tag standard
digital (numérique), analog
(analogique), longana (entier double
longueur), float (virgule flottante),
message
Nom d’un tag dont la valeur indique l’état de la dernière
opération effectuée par cet enregistrement de contrôle. Ce tag est
mis à jour avec ses informations d’état par PowerSQL. Ces
messages ou ces codes d’état sont générés par PowerSQL ou par
la tâche historique, selon l’emplacement de l’échec. Pour
connaître les codes et les messages s’affichant dans ce tag,
reportez-vous à la section « Cliquez sur Quitter pour revenir au
menu principal. » page 44.
Le tag d’état terminaison peut fonctionner comme un code d’état
simple ou comme un tableau de codes d’états, selon l’opération
exécutée par PowerSQL. Si ce tag est de type message, PowerSQL
le met à jour avec un message textuel. S’il s’agit d’un tag
analogique, ce tag affiche des codes décrits au Chapitre 3, « Codes
et messages d’état PowerSQL. » S’il s’agit d’un tag entier double
longueur, il affiche des codes générés par le serveur de base de
données auquel accède la tâche historique. Ces codes d’état sont
donc dépendants du serveur de base de données connecté ; vous
devez le consulter pour connaître la définition des codes d’erreur.
FactoryLink 6.5.0 / Guide de l’utilisateur de PowerSQL / 33
2
Configuration de
PowerSQL
Entrée valide :
Type de données valides :
•
CONFIGURATION DE POWERSQL
•
Panneau Contrôle PowerSQL
•
•
Si une opération de mise à jour logique, de suppression logique,
d’insertion ou SQL accepte un tableau de valeurs d’entrée, le tag
d’état peut afficher un tableau de codes d’état (cela uniquement si
le tag d’état terminaison est de type analogique ou entier double
longueur). Si un tableau de codes d’état est attendu, le tag Etat
terminaison doit être un tableau de tags et doit pouvoir contenir
le nombre de valeurs déterminées par le champ de la taille de
tableau de données.
Vous pouvez configurer ce tableau pour qu’il fonctionne
conjointement à des objets de sortie dans la tâche Editeur
d’applications pour afficher des codes ou des messages sur tout
écran graphique. Pour plus d’informations sur la définition des
objets de sortie, reportez-vous au Chapitre 10, « Animation des
champs d’entrée/sortie » dans le Guide de l’Editeur d’applications
FactoryLink ECS.
Vous pouvez également configurer Maths & Logique pour
surveiller ce tag et traiter ou non les éventuelles erreurs.
Si le tag spécifié dans ce champ n’a pas été défini, une boîte de
dialogue Définition de tag s’affiche lorsque vous cliquez sur Entrée.
Sélectionnez le type de données approprié.
Entrée valide :
Type de données valides :
34 / FactoryLink 6.5.0 / Guide de l’utilisateur de PowerSQL
nom de tag standard
analog (analogique), longana (entier
double longueur), message
CONFIGURATION DE POWERSQL
Panneau Contrôle PowerSQL
Une fois toutes les informations nécessaires spécifiées, le panneau concerné
ressemble au panneau exemple suivant :
2
Configuration de
PowerSQL
Dans cet exemple, PowerSQL envoie une demande d’opérations de sélection, de
mise à jour, de suppression, de déplacement et de positionnement à la tâche
historique par l’intermédiaire du tag mailbox historique HISTMBX. PowerSQL
demande des données en provenance de la table TANK de la base de données
REFINERY.
PowerSQL met à jour la valeur de l’élément du tag de la ligne en cours
CROWTAG1 lorsque PowerSQL effectue une opération de sélection, de
déplacement ou de positionnement. L’élément du tag Etat terminaison STATTAG1
contient des informations d’état relatives à l’opération venant d’aboutir.
L’indicateur de changement d’état de l’élément numérique COMTRG1 est défini
lorsqu’une opération liée à cette fenêtre de résultat est terminée.
FactoryLink 6.5.0 / Guide de l’utilisateur de PowerSQL / 35
•
CONFIGURATION DE POWERSQL
•
Panneau Informations sur PowerSQL
•
•
Le champ Création d’enregistrement auto ? indiquant la valeur NON, PowerSQL ne
crée pas de nouvelle ligne ; l’opération de mise à jour n’est pas exécutée
lorsqu’aucune ligne n’est disponible.
La taille de tableau de données étant égale à 12, la fenêtre de résultat peut
afficher 12 lignes de données de la table de résultat à la fois. Le cache interne peut
contenir 100 lignes de données provenant de la table de résultat.
4 Cliquez sur Entrée pour enregistrer les informations.
5 Cliquez sur Suiv. pour atteindre le panneau Informations sur PowerSQL.
P ANNEAU I NFORMATIONS
SUR
P OWER SQL
Le panneau Informations sur PowerSQL permet de configurer les détails de
l’opération SQL définie dans le panneau Contrôle PowerSQL. Spécifiez les
informations suivantes :
Nom de tag
Nom d’un tag contenant les valeurs issues d’une colonne de table
de base de données relationnelle, les valeurs d’une expression
SQL ou les valeurs des variables d’entrée pour un appel de mise à
jour, de suppression, d’insertion ou de procédure stockée. Si la
valeur définie dans le champ de la taille de tableau de données du
panneau Contrôle PowerSQL est supérieure à 1, la taille du
tableau de tags doit être équivalente ou supérieure à celle du
tableau de données. Assurez-vous que tous les tags entrés dans le
champ Nom de tag peuvent contenir le nombre de valeurs
déterminé dans le champ de la taille de tableau de données.
36 / FactoryLink 6.5.0 / Guide de l’utilisateur de PowerSQL
CONFIGURATION DE POWERSQL
Panneau Informations sur PowerSQL
Si le tag spécifié dans ce champ n’a pas été défini, une boîte de
dialogue Définition de tag s’affiche lorsque vous cliquez sur Entrée.
Sélectionnez le type de données approprié.
Entrée valide :
Type de données valides :
Opérateur logique
nom de tag standard
digital (numérique), analog
(analogique), longana (entier double
longueur), float (virgule flottante),
message
Ce champ est ignoré dans le cas des enregistrements de contrôle
disposant d’un tag PowerSQL configuré. Il fait partie d’une clause
WHERE spécifiant l’expression conditionnelle limitant le nombre
de lignes sélectionnées, mises à jour ou supprimées d’une table de
base de données. Il fonctionne conjointement aux champs
Expression colonne et Expression logique (décrits plus loin) en
vue de la construction de la clause WHERE. Ce champ peut
prendre les valeurs suivantes :
2
AND Spécifie une combinaison de conditions dans une
OR Spécifie une liste de conditions de remplacement
dans une expression logique.
FactoryLink effectue une recherche séquentielle dans la base de
données, même si les colonnes sont indexées, si vous utilisez
l’opérateur logique OR dans une expression logique lors de
l’utilisation de la tâche historique pour dBASE IV. Ce type de
recherche entraîne un allongement du temps de réponse lorsque
la base de données est volumineuse ; par conséquent, il est
recommandé de ne pas utiliser l’opérateur OR dans des
expressions logiques afin que l’historique pour dBASE IV puisse
exploiter les index.
FactoryLink 6.5.0 / Guide de l’utilisateur de PowerSQL / 37
Configuration de
PowerSQL
expression logique.
•
CONFIGURATION DE POWERSQL
•
Panneau Informations sur PowerSQL
•
•
NOT Inverse une condition dans une expression logique.
AND_NOT Spécifie une combinaison de conditions et de
conditions inverses dans une expression logique.
OR_NOT Spécifie une liste de conditions inverses de
remplacement dans une expression logique. (Voir
les exemples du tableau ci-dessous.)
Clause WHERE
Expression
colonne
Description
Col2 = 3 AND Col4 > 4
PowerSQL sélectionne toutes
les lignes où Col2 est égal à 3
AND (et) Col4 est supérieur à
4.
Col3 < 6 OR Col2 >= 19
PowerSQL sélectionne toutes
les lignes où Col3 est inférieur
à 6 OR (ou) Col2 est supérieur
ou égal à 19.
Col4 > 7 AND_NOT Col4 = 20
PowerSQL sélectionne toutes
les lignes où Col4 est
supérieur à 7 AND_NOT (et
non) égal à 20.
Chaîne alphanumérique comprenant de 1 à 63 caractères,
indiquant :
(1) Une chaîne de caractères représentant le nom de colonne de
base de données relationnelle associé au tag Nom de tag. Le
champ Nom de colonne fonctionne conjointement aux champs
Opérateur logique et Expression logique pour spécifier les clauses
WHERE avec le format suivant :
([table.]colonne)
où
table
correspond au nom de table de la base de données
relationnelle. Indiquez la table si son nom est
différent du nom de table spécifié dans le champ
*Nom de table base de données du panneau Contrôle
PowerSQL.
38 / FactoryLink 6.5.0 / Guide de l’utilisateur de PowerSQL
CONFIGURATION DE POWERSQL
Panneau Informations sur PowerSQL
colonne correspond au nom de la colonne dans la table de
base de données relationnelle. Vous pouvez utiliser
le même nom de colonne dans deux lignes d’un
panneau.
OU
(2) Une fonction SQL, telle que MAX (nom_col) ou COUNT (*). Le
résultat de cette fonction est écrit dans le tag spécifié dans le
champ Nom de tag. Les fonctions SQL sont prises en charge
uniquement dans les expressions SELECT. Les fonctions SQL ne
sont pas prises en charge dans les expressions UPDATE ou par
l’historique pour dBASE IV.
OU
OU
(4) Les mots réservés $OUTPUT, $INPUT et $INOUT. Ces mots
réservés sont valides uniquement pour les enregistrements de
contrôle disposant d’un tag PowerSQL configuré. Ces mots
indiquent à PowerSQL le mode de traitement du tag référencé
par le champ Nom de tag et l’expression SQL associée dans le tag
de message du Tag PowerSQL.
Si le champ Expression colonne a la valeur $OUTPUT
($SORTIE), le tag spécifié dans le champ Nom de tag stocke les
valeurs d’une colonne dans une table de résultat générée par une
expression SELECT (SELECTION) ou par une procédure stockée.
Si la valeur de ce champ est $INPUT ($ENTREE), le tag spécifié
dans le champ Nom de tag contient la valeur d’une variable de
substitution « »’, intégrée dans le corps de l’expression SQL. Si la
valeur du champ est $INOUT, le tag spécifié dans le champ Nom
de tag contient la valeur d’une variable de substitution dans une
expression d’appel de procédure stockée ; le tag est également mis
à jour avec la valeur retournée par la procédure stockée dans
cette variable.
FactoryLink 6.5.0 / Guide de l’utilisateur de PowerSQL / 39
2
Configuration de
PowerSQL
(3) Une affectation SQL, telle que time_entered=SYSDATE, où
time_entered correspond au nom d’une colonne de la table de base
de données et SYSDATE une macro Oracle fournissant
l’horodatage en cours selon le serveur Oracle. Cette fonctionnalité
n’est valide que pour les expressions UPDATE et INSERT (MISE
A JOUR et INSERTION) et permet à l’utilisateur d’utiliser : les
macros de serveurs de base de données, les constantes
numériques ou les chaînes constantes caractères à entrer
directement dans les colonnes au lieu de passer par les tags
FactoryLink.
•
CONFIGURATION DE POWERSQL
•
Panneau Informations sur PowerSQL
•
•
Entrée valide :
Taille des
données caractère
maximale
Limite le nombre maximal d’octets que PowerSQL peut écrire
dans un tag de message. Ce champ est fourni car les expressions
SQL résultant en une chaîne de caractères peuvent prendre par
défaut une taille de données élevée, ce qui entraîne l’allocation et
le gaspillage d’une grande quantité de mémoire de la base de
données temps réel FactoryLink. Si ce champ est laissé en blanc,
PowerSQL écrit toujours dans le tag de message la taille par
défaut indiquée par le serveur de base de données pour
l’expression de colonne associée.
Entrée valide :
Expression logique
chaîne alphanumérique comprenant
entre 1 et 63 caractères
valeur numérique comprise entre 1et
256
Ce champ est ignoré dans le cas des enregistrements de contrôle
disposant d’un tag PowerSQL configuré. Il permet de générer une
expression conditionnelle limitant le nombre de lignes
sélectionnées, mises à jour ou supprimées de la table de base de
données. Ce champ fonctionne conjointement aux champs
Expression colonne et Opérateur logique pour générer la clause
WHERE utilisée dans l’expression SQL.
Remarque : une variable intégrée dans PowerSQL correspond
au nom d’un tag FactoryLink précédé de deux points. La
variable intégrée peut être utilisée uniquement dans le champ
Expression logique. Elle peut correspondre à tout type de tag
FactoryLink sauf ceux du type mailbox. Si le tag est un
tableau, spécifiez la dimension (par exemple, :tag_xyz[2]). Le
gestionnaire de configuration ne détecte pas le tag dans la
variable intégrée comme étant un tag ; l’utilisateur doit donc
définir ce tag dans l’application, par exemple dans Maths &
Logique.
40 / FactoryLink 6.5.0 / Guide de l’utilisateur de PowerSQL
CONFIGURATION DE POWERSQL
Panneau Informations sur PowerSQL
L’expression conditionnelle dans un champ Expression logique
peut consister en des opérateurs relationnels. Une liste des
opérateurs relationnels gérés par l’historique pour dBASE IV est
fourni ci-dessous.
=
est égal à
<
est inférieur à
>
est supérieur à
<>
est différent de
<=
est inférieur ou égal à
>=
est supérieur ou égal à
is not null
n’est pas une valeur nulle (pour
Historique dBASE IV TRUE lorsque la
colonne de base de données ne contient
pas uniquement des espaces)
définit une plage de valeurs où X
correspond à la limite inférieure et Y à
la limite supérieure. Egal à COLNAME
>= X et COLNAME <= Y
Si vous utilisez l’historique pour dBASE IV, limitez les
expressions logiques à cette liste d’opérateurs relationnels. Si
vous n’utilisez pas l’historique pour dBASE IV, consultez le
manuel utilisateur relatif au langage SQL du SGBDR.
La clause WHERE est générée par l’ajout des champs Opérateur
logique, Expression colonne et Expression logique dans l’ordre
affiché dans le panneau Informations sur PowerSQL. La
ponctuation est placée par PowerSQL pour garantir l’exactitude
de la syntaxe SQL. Toute variable intégrée dans le champ
Expression logique est remplacé par un « ? », que le SQL définit
comme une variable de substitution d’une valeur à fournir au
moment de l’exécution. Cette dernière correspond à la valeur de
tag définie par la variable intégrée.
La chaîne générée est une condition WHERE. Si le(s) premier(s)
mot(s) de cette chaîne ne sont pas des mots réservés SQL tels que
ORDER BY, le mot réservé WHERE est rattaché au début de
cette chaîne. L’ utilisateur doit s’assurer que le positionnement
des clauses SQL telles que ORDER BY et GROUP BY est
correctement effectué, comme défini par le langage SQL du
serveur de base de données cible.
FactoryLink 6.5.0 / Guide de l’utilisateur de PowerSQL / 41
Configuration de
PowerSQL
between X and Y
2
•
CONFIGURATION DE POWERSQL
•
Panneau Informations sur PowerSQL
•
•
La clause ORDER BY est gérée dans l’historique pour dBASE IV,
à la condition que les colonnes répertoriées dans cette clause
correspondent à un index créé pour la table de base de données.
L’historique pour dBASE IV ne construit aucune table provisoire
permettant de réorganiser les lignes ; vous devez donc vous
assurer que la clause ORDER BY corresponde bien à un index de
la table dBASE IV. Si ce n’est pas le cas, l’historique pour
dBASE IV retourne une erreur.
Si vous définissez un déclencheur de sélection dans le panneau
Contrôle PowerSQL, la clause WHERE est utilisée pour
l’expression de sélection. Sinon, elle est utilisée pour l’opération
de mise à jour logique ou pour l’opération de suppression logique,
ou pour les deux.
Une expression logique peut contenir l’un des éléments suivants :
1. Chaîne de caractères de 79 caractères au maximum, contenant
une expression SQL :
OUTLETTVAL = 30 et TANKID = ‘BLUE001’
ou une clause SQL :
ORDER BY TANKID
2. Chaîne de caractères de 79 caractères au maximum
représentant une expression SQL contenant des variables
intégrées. Si le tag est un tag de message, les données caractères
de ce tag ne doivent pas être entourées d’apostrophes. Si
l’enregistrement de contrôle PowerSQL ne dispose pas de
déclencheur de sélection configuré et que la taille de tableau de
données est supérieure à 1, les tags référencés par les variables
intégrées doivent être des tableaux de taille suffisante pour
contenir le nombre de valeurs déterminé dans le champ de la
taille de tableau de données.
Par exemple :
=:tagTANKID
où tagTANKID est un tag de message de valeur : BLUE001
3. Variable de message intégrée uniquement. Cette variable doit
être un tag de message. Ce dernier contient une clause ou une
expression SQL. L’expression SQL ne peut pas contenir de
variable intégrée et les chaînes constantes caractères doivent être
entourées d’apostrophes.
42 / FactoryLink 6.5.0 / Guide de l’utilisateur de PowerSQL
CONFIGURATION DE POWERSQL
Panneau Informations sur PowerSQL
Par exemple :
:tagSQLExpression
où
tagSQLExpression est un tag de type message
176.'68#. CPF 6#0-+& H$.7'I
Remarque : les options 1 et 3 sont différentes. Leur résultat
est identique, mais l’option 3 autorise l’utilisateur à modifier
le tag tagSQLExpression en une expression différente avant
de définir un déclencheur de sélection, de mise à jour ou de
suppression, ce qui modifie alors les lignes sélectionnées,
mises à jour ou supprimées. L’option 1 est toujours statique et
ne peut pas être modifiée lors de l’exécution. L’option 2
autorise l’utilisateur à modifier la valeur tagTANKID, mais
l’expression SQL demeure la même. Seul le critère de
recherche de la clause WHERE a été modifié.
Par exemple :
=:tagTANKID
génère la clause WHERE suivante :
où TANKID = ?
TANKID correspond à la valeur du champ Nom de colonne.
PowerSQL lit la valeur du tag tagTANKID dans la base de
données temps réel et la remplace par « ? » lorsqu’il exécute une
expression de sélection, de mise à jour ou de suppression.
FactoryLink 6.5.0 / Guide de l’utilisateur de PowerSQL / 43
Configuration de
PowerSQL
PowerSQL substitue à des variables intégrées la valeur du tag
défini dans la variable intégrée lors de l’exécution de l’expression
de sélection, de mise à jour ou de suppression.
2
•
CONFIGURATION DE POWERSQL
•
Panneau Informations sur PowerSQL
•
•
Une fois complété, ce panneau ressemble au panneau suivant :
Le tag déclencheur de sélection SELTAG1 (défini dans le panneau Contrôle) étant
de type numérique dans le présent exemple, l’historique retourne les valeurs
suivantes à PowerSQL lorsque l’indicateur de changement d’état pour SELTAG1
est défini :
• valeurs lorsque la colonne nommée TANKID est égale à BLUE001
• valeur de la colonne OUTLET supérieure ou égale à la valeur du tag
OUTLETVAL.
PowerSQL écrit ces valeurs dans les tags contenus dans les tableaux TANKID[3]
et OUTLET[3]. Elles sont ensuite affichées dans une fenêtre de résultat.
Chaque tag Nom de tag affiche une colonne de valeurs dans une fenêtre de
résultat.
Un tableau de tags Nom de tag ayant été défini pour TANKID et OUTLET, les
valeurs des colonnes pour lesquelles l’expression logique est vraie (« True ») sont
affichées dans la fenêtre de résultat.
6 Cliquez sur Entrée pour enregistrer les informations.
7 Cliquez sur Quitter pour revenir au menu principal.
44 / FactoryLink 6.5.0 / Guide de l’utilisateur de PowerSQL
•
•
•
•
Chapitre 3
Codes et messages
d’état PowerSQL
Lorsqu’une erreur survient au moment de l’exécution dans PowerSQL, l’historique
ou toute autre tâche client historique, FactoryLink envoie un code ou un message
d’état qui s’affiche dans l’écran du Gestionnaire d’exploitation et dans le tag d’état
terminaison. FactoryLink envoie également un message plus long et plus
descriptif dans le fichier journal, si vous avez créé ce dernier. La présente section
décrit les messages d’erreur relatifs à la tâche PowerSQL susceptibles de s’afficher
sur l’écran du Gestionnaire d’exploitation.
Les codes et messages s’affichent sur un écran graphique si vous avez défini un
objet texte de sortie dans ce but.
Le tableau ci-dessous répertorie les codes d’état écrits dans un tag numérique
d’état terminaison défini dans le panneau Contrôle PowerSQL. Le message
descriptif est écrit dans un tag de message d’état terminaison et éventuellement
dans le tag de message tâche du panneau Configuration système. Reportez-vous à
la section « Historian Messages » page 256 du Guide de référence de FactoryLink
pour connaître les codes d’état inférieurs à 100. L’historique génère ces codes,
lesquels sont ensuite retournés au PowerSQL lorsqu’une opération d’historisation
est exécutée.
Code
100
Erreur
Erreur
asynchrone de la
fonction
d’historique.
Cause
Echec d’une opération
SQL COMMIT dans la
tâche historique.
Action
FactoryLink 6.5.0 / Guide de l’utilisateur de PowerSQL / 45
3
Codes et messages
d’état PowerSQL
Consultez
l’administrateur de base
de données au sujet de la
base de données externe
utilisée.
•
CODES ET MESSAGES D’ÉTAT POWERSQL
•
•
•
101
Erreur de la
fonction
d’historique.
Erreur de syntaxe ou
champ de saisie
obligatoire non
renseigné dans une
table de configuration.
Corrigez l’erreur de
syntaxe dans l’expression
SQL en modifiant le
panneau Informations sur
PowerSQL pour la tâche
ayant reçu l’erreur. Si les
informations sont
correctes, assurez-vous
que la table de base de
données existe.
102
Pas de champs à
sélect.
La tâche essaie
d’exécuter une
opération de sélection
mais aucun nom de tag
n’a été défini en vue de
stocker les données
résultant de cette
opération.
Définissez des noms de
tag dans le champ Nom
de tag du panneau
Informations sur PowerSQL.
103
Pas de champs à
insérer.
La tâche essaie
d’exécuter une
opération d’insertion
mais aucun nom de tag
n’a été défini en vue de
stocker les données
résultant de cette
opération.
Définissez des noms de
tag dans le champ Nom
de tag du panneau
Informations sur PowerSQL.
104
Pas de champs à
mettre à jour.
La tâche essaie
d’exécuter une
opération de mise à jour
mais aucun nom de tag
n’a été défini en vue de
stocker les données
résultant de cette
opération.
Définissez des noms de
tag dans le champ Nom
de tag du panneau
Informations sur PowerSQL.
105
Opérations de
mise à jour et de
suppression non
gérées par
l’affichage
multi-table.
Les opérations de mise
à jour et de suppression
ne peuvent pas être
exécutées en affichage
multi-table.
N’exécutez pas
d’opération de mise à jour
ou de suppression en
affichage multi-table.
46 / FactoryLink 6.5.0 / Guide de l’utilisateur de PowerSQL
CODES ET MESSAGES D’ÉTAT POWERSQL
Impossible de
mettre à jour
avant d’effectuer
la sélection.
Un déclencheur de
sélection est défini
mais l’opération de
sélection n’a pas été
exécutée. Cette
opération doit être
exécutée avant
l’opération de mise à
jour.
Exécutez une opération
de sélection puis relancez
l’opération de mise à jour.
107
Impossible de
supprimer avant
d’effectuer la
sélection.
Un déclencheur de
sélection est défini
mais l’opération de
sélection n’a pas été
exécutée. Cette
opération doit être
exécutée avant
l’opération de
suppression.
Exécutez une opération
de sélection puis relancez
l’opération de
suppression.
108
Impossible de
déplacer avant
d’effectuer la
sélection.
Un déclencheur de
sélection est défini
mais l’opération de
sélection n’a pas été
exécutée. Cette
opération doit être
exécutée avant
l’opération de
déplacement.
Exécutez une opération
de sélection puis relancez
l’opération de
déplacement.
109
Cette ligne de
données a été
supprimée.
Tentative d’opération de Aucune action requise.
suppression sur une
ligne non existante.
110
Une fonction
FactoryLink a
renvoyé une
erreur.
Une fonction PAK
FactoryLink a détecté
une erreur inconnue ou
inattendue.
Contactez le service
d’assistance clientèle.
111
Une erreur de
fonction de fichier
est survenue.
Le système a détecté
une erreur inconnue
lors d’une tentative de
lecture ou d’écriture
dans le tampon externe.
En cas d’insuffisance de
l’espace disponible,
diminuez la taille du
tampon. Sinon, prenez
contact avec le service
d’assistance clientèle.
FactoryLink 6.5.0 / Guide de l’utilisateur de PowerSQL / 47
3
Codes et messages
d’état PowerSQL
106
•
CODES ET MESSAGES D’ÉTAT POWERSQL
•
•
•
112
Tag incorrect pour Une erreur
l’expression
typographique a été
logique.
commise ou un nom de
tag indéfini ou erroné a
été saisi comme tag de
variable intégrée dans
un champ Expression
logique.
Corrigez toute erreur
typographique éventuelle.
Sinon, définissez le tag
dans une tâche
FactoryLink autre que
PowerSQL.
113
Utilisation
incorrecte de tag
dans l’expression
logique.
L’expression logique ne
contient pas de nom de
tag valide.
Corrigez les erreurs
typographiques et
assurez-vous que le nom
de tag est correct.
114
Structure HSDA
trop petite.
Utilisation incorrecte
d’un tag dans une
expression logique.
Définissez le tag utilisé
dans l’expression logique
dans une tâche
FactoryLink autre que
PowerSQL.
115
Impossible
d’ouvrir le fichier
LOG.
Espace disque
insuffisant.
Si l’espace disque
disponible est réduit,
supprimez tout fichier ou
programme superflu sur
le disque. Sinon, prenez
contact avec le service
d’assistance clientèle.
116
Echec d’une
demande de
mémoire.
Erreur interne.
Prenez contact avec le
service d’assistance
clientèle.
117
Impossible de
Une mise à jour de
trouver l’index
position ou une
unique de la table. suppression a été
exécutée sur une table
ne disposant pas d’un
index unique.
48 / FactoryLink 6.5.0 / Guide de l’utilisateur de PowerSQL
Créez un index unique
pour la table et relancez
l’opération.
CODES ET MESSAGES D’ÉTAT POWERSQL
118
La configuration
de
l’enregistrement
d’informations sur
PowerSQL est
incorrecte.
L’enregistrement
Modifiez
d’informations dispose l’enregistrement
d’une expression
d’informations.
d’affectation et
l’opérateur logique et/ou
l’expression logique sont
configurés. L’expression
d’affectation référence
une constante
numérique ou une
chaîne constante
littérale et un tag est
configuré dans le champ
Nom de tag. Cette
expression dispose d’un
marqueur de
substitution sans tag
associé dans le champ
Nom de tag.
119
Tableau de tags
trop petit pour
l’opération
PowerSQL.
Un tag référencé dans le
panneau d’informations
n’est pas assez grand
pour contenir le
nombre de valeurs
déterminé dans le
champ de la taille de
tableau de données
(lignes).
Modifiez la dimension du
tag ou spécifiez un tag de
taille suffisante pour
contenir les valeurs
déterminées par le champ
de la taille de tableau de
données.
FactoryLink 6.5.0 / Guide de l’utilisateur de PowerSQL / 49
3
Codes et messages
d’état PowerSQL
Lorsqu’une erreur survient dans les tâches PowerSQL ou Historique au moment
de l’exécution, l’un des messages ci-dessous s’affiche à droite de SQLTASK sur
l’écran du Gestionnaire d’exploitation. Les trois premières lettres du message
représentent une variable indiquant l’origine du message (PowerSQL ou
Historique (HIS). Cette variable préfixe est insérée dans les messages ci-dessous
sous la forme nnn. Ouvrez le fichier .LOG pour afficher le message complet en cas
de troncature de ce dernier sur l’écran du Gestionnaire d’exploitation.
•
CODES ET MESSAGES D’ÉTAT POWERSQL
•
•
•
nnn-[BAD_SMBX] Mailbox d’envoi incorrecte. Nom de consultation : nom
Cause : vous avez entré un nom de tag mailbox incorrect.
Action : recherchez le nom de tag mailbox utilisé dans le champ Mailbox
historique dans le panneau Informations mailbox historique.
Entrez ce nom dans le champ Mailbox historique du panneau
Contrôle PowerSQL.
nnn-[BAD_WHERE_TAG] Tag incorrect pour l’expression logique. Nom de
consultation : nom
Cause : vous avez commis une erreur typographique ou entré un nom de
tag indéfini ou incorrect comme tag de message intégré dans une
expression logique.
Action : corrigez les éventuelles erreurs typographiques. Sinon,
définissez le tag dans une tâche FactoryLink autre que
PowerSQL.
nnn-[CT_HDR] Aucun déclencheur de sélection, de mise à jour ou de
suppression n’a été défini. Nom de consultation : nom
Cause : aucun des déclencheurs suivants n’a été défini :
- sélection
- suppression
- mise à jour
Action : définissez au moins l’un des déclencheurs répertoriés ci-dessus.
nnn-[DBTBL_SYNTAX] Il manque un « . » dans la valeur « Base de
données.Table » . Nom de consultation : nom
Cause : vous n’avez pas saisi le « . » dans le champ Nom de table base de
données (Base de données.Table) du panneau Contrôle
PowerSQL.
Action : saisissez un « . » entre le nom de base de données et le nom de
table dans le champ Nom de table base de données.
nnn-[FL_FUNC] Erreur code d’erreur renvoyée par la fonction « fonction ». Nom
de consultation : nom
Cause : la fonction PAK FactoryLink a détecté une erreur inconnue ou
inattendue.
Action : prenez contact avec le service d’assistance clientèle.
50 / FactoryLink 6.5.0 / Guide de l’utilisateur de PowerSQL
CODES ET MESSAGES D’ÉTAT POWERSQL
nnn-[FL_FUNC] Erreur 9 renvoyée par la fonction « FL_WRITE ». Nom de
consultation : nom
Cause : le type de colonne de la base de données que FactoryLink tente
de lire ne correspond pas au type de colonne défini dans la table
de création de la structure de la tâche Historisation base de
données.
Action : redéfinissez le type de colonne dans le champ Type de colonne de
la table de création de la structure pour qu’il soit identique à
celui de la base de données.
nnn-[HSCONNECT] Echec de connexion à l’historique
Cause : vous avez peut-être spécifié un nom de tag mailbox incorrect.
Action : spécifiez le nom de tag mailbox historique prédéfini dans le
champ Mailbox historique du panneau Contrôle PowerSQL.
nnn-[HSDA_TOO_SMALL] Structure HSDA trop petite. Nom de consultation :
nom
Cause : vous avez spécifié un tag incorrect dans une expression logique.
Action : définissez le tag utilisé dans l’expression logique dans une tâche
FactoryLink autre que PowerSQL. Le tag sera alors correct dans
l’expression logique.
nnn-[HSDBERROR] Erreur d’historique de base de données : message d’erreur
Cause : ce message s’accompagne de divers autres messages décrivant la
cause de l’erreur.
nnn-[HSDUPLICATE] Tentative d’insertion d’une ligne en double
Cause : vous avez tenté d’insérer une ligne en double dans une table de
résultat.
Action : aucune action requise.
FactoryLink 6.5.0 / Guide de l’utilisateur de PowerSQL / 51
3
Codes et messages
d’état PowerSQL
Action : lisez le message associé affiché sur l’écran du Gestionnaire
d’exploitation ou dans le fichier .LOG et tentez de résoudre le
problème en fonction des instructions fournies.
•
CODES ET MESSAGES D’ÉTAT POWERSQL
•
•
•
nnn-[HSENDOFETCH] Dernière ligne extraite ou ligne non trouvée
Cause : la tâche n’a pas pu trouver une ligne durant une opération de
mise à jour car la ligne n’existe pas ; ou bien, lors d’une opération
de déplacement ou de positionnement, vous avez spécifié une
ligne inexistante (par exemple, la ligne 100 alors que la table
n’en contient que 50). Vous avez tenté d’aller au-delà de la
dernière ligne ou en-deçà de la première ligne de la table de
résultat.
Action : aucune action requise.
nnn-[HSFLDEXISTS] Tentative d’ajout d’un champ qui existe déjà
Cause : vous avez tenté d’ajouter un champ existant.
Action : aucune action requise.
nnn-[HSMAXOPENS] Trop de sessions ouvertes
Cause : vous avez tenté d’ouvrir des données provenant de plus de 10
bases de données uniques.
Action : vous devez référencer moins de dix bases de données uniques
dans une table de configuration.
nnn-[HSMEMORY] Erreur mémoire ; échec de la fonction malloc
Cause : la mémoire allouée pour l’historique est insuffisante.
Action : allouez davantage de mémoire.
nnn-[HSNOFIELD] Tentative d’accès à un champ non existant
Cause : vous avez tenté d’ouvrir un champ non existant.
Action : aucune action requise.
nnn-[HSNOTABLE] Tentative d’accès à une table non existante
Cause : vous avez tenté d’ouvrir une table non existante.
Action : aucune action requise.
52 / FactoryLink 6.5.0 / Guide de l’utilisateur de PowerSQL
CODES ET MESSAGES D’ÉTAT POWERSQL
nnn-[HSPREPARE] Echec de préparation de stmtid
Cause : un nom de table non existant ou de fichier non existant a été
spécifié ou une erreur de syntaxe a été commise dans une
expression SQL.
Action : assurez-vous que toutes les entrées de la table PowerSQL sont
correctes, en particulier celles relatives à l’expression SQL.
nnn-[HSSTMTID] stmtid incorrect renvoyé par l’historique
Cause : l’historique s’est arrêté avant PowerSQL ou toute autre tâche
client historique.
Action : arrêtez PowerSQL ainsi que toutes les autres tâches client
historique en cours d’exécution sur le système. Arrêtez ensuite la
tâche historique et redémarrez-la, puis redémarrez PowerSQL et
toutes les autres tâches client historique.
Cause : une erreur s’est produite dans PowerSQL. Prenez contact avec le
service d’assistance clientèle.
nnn-[HSTBLEXISTS] Tentative de création d’une table qui existe déjà
Cause : vous avez tenté de créer une table existante.
Action : aucune action requise.
nnn-[HSUNKNOWN] Requête de fonction non identifiée envoyée à l’historique
Cause : une erreur est survenue dans PowerSQL.
Action : prenez contact avec le service d’assistance clientèle.
nnn-[INVUSE_WHERE_TAG] Utilisation incorrecte de tag dans l’expression
logique. Nom de consultation : nom
Action : corrigez les erreurs typographiques et assurez-vous que le nom
de tag est correct.
nnn-[MULTI-VIEW] Opérations de mise à jour et de suppression non gérées par
l’affichage multi-table. Nom de consultation : nom
Cause : vous avez tenté d’exécuter une opération de mise à jour ou de
suppression dans un affichage multi-table.
Action : ne tentez aucune mise à jour ou suppression.
FactoryLink 6.5.0 / Guide de l’utilisateur de PowerSQL / 53
Codes et messages
d’état PowerSQL
Cause : une expression logique contient un nom de tag incorrect.
3
•
CODES ET MESSAGES D’ÉTAT POWERSQL
•
•
•
nnn-[NO_FLDS_INS] Pas de champs à insérer. Nom de consultation : nom
Cause : la tâche tente d’exécuter une opération d’insertion mais aucun
nom de tag n’a été défini pour le stockage des données provenant
de l’insertion.
Action : définissez des noms de tag dans le champ Nom de tag du
panneau Contrôle PowerSQL.
nnn-[NO_FLDS_SEL] Pas de champs à sélect. Nom de consultation : nom
Cause : la tâche tente d’exécuter une opération de sélection mais aucun
nom de tag n’a été défini pour le stockage des données provenant
de la sélection.
Action : définissez des noms de tag dans le champ Nom de tag du
panneau Contrôle PowerSQL.
nnn-[NO_FLDS_UPD] Pas de champs à mettre à jour. Nom de consultation :
nom
Cause : la tâche tente d’exécuter une opération de mise à jour mais
aucun nom de tag n’a été défini pour le stockage des données
provenant de la mise à jour.
Action : définissez des noms de tag dans le champ Nom de tag du
panneau Contrôle PowerSQL.
nnn-[NO_LOGICAL_EXPR] Pas d’expression logique. Nom de consultation :
nom. Nom de colonne : nom
Cause : une opération logique a été définie mais l’expression logique n’a
pas été spécifiée.
Action : supprimez l’opération ou créez une expression logique.
nnn-[NO_MEMORY] Mémoire RAM saturée
Cause : la mémoire RAM disponible est insuffisante pour exécuter cette
tâche.
Action : allouez davantage de mémoire RAM pour la tâche PowerSQL.
nnn-[NOTASSOC] Colonne nom non associée avec le nom de tag ou
l’expression logique. Nom de consultation : nom
Cause : un nom de tag non existant ou incorrect a été spécifié. Un nom de
colonne est également spécifié mais pas d’expression logique.
54 / FactoryLink 6.5.0 / Guide de l’utilisateur de PowerSQL
CODES ET MESSAGES D’ÉTAT POWERSQL
Action : définissez un tag dans le champ Nom de tag du panneau
Informations sur PowerSQL et/ou spécifiez une expression
logique.
nnn-[NO_UNIQ_INDX] Impossible de trouver l’index unique de la table. Nom de
consultation : nom
Cause : vous avez tenté d’exécuter une mise à jour ou une suppression de
position sur une table sans index unique.
Action : créez un index unique pour la table et relancez l’opération.
nnn-[NULL_ROW] Cette ligne de données a été supprimée. Nom de
consultation : nom
Cause : vous avez tenté d’exécuter une suppression sur une ligne déjà
supprimée.
Action : aucune action requise.
nnn-[NULL_TABLE] Pas de données dans cette table. Nom de consultation :
nom
Cause : vous avez tenté d’exécuter une mise à jour, un déplacement ou
une suppression sur une table de résultat ne contenant aucune
ligne de données pour l’une des raisons suivantes : l’opération de
sélection n’a abouti à la sélection d’aucune ligne de données ou
vous avez supprimé toutes les lignes de données de la table.
Action : aucune action requise.
nnn-[OPEN_LOG] Impossible d’ouvrir le fichier .LOG.
Cause : il est possible que l’espace disque disponible soit épuisé.
nnn-[SEL_B4_DEL] Impossible de supprimer avant d’effectuer la sélection.
Nom de consultation : nom
Cause : un déclencheur de sélection a été défini mais l’opération de
sélection n’a pas été exécutée. Cette dernière doit être exécutée
pour que la suppression puisse être ensuite effectuée.
Action : exécutez une opération de sélection puis relancez la suppression.
FactoryLink 6.5.0 / Guide de l’utilisateur de PowerSQL / 55
Codes et messages
d’état PowerSQL
Action : supprimez tout fichier ou programme inutile. Prenez contact
avec le service d’assistance clientèle.
3
•
CODES ET MESSAGES D’ÉTAT POWERSQL
•
•
•
nnn-[SEL_B4_MOVE] Impossible de déplacer avant d’effectuer la sélection.
Nom de consultation : nom
Cause : un déclencheur de sélection a été défini mais l’opération de
sélection n’a pas été exécutée. Cette dernière doit être exécutée
pour que le déplacement puisse être ensuite effectué.
Action : exécutez une opération de sélection puis relancez le
déplacement.
nnn-[SEL_B4_UPD] Impossible de mettre à jour avant d’effectuer la sélection.
Nom de consultation : nom
Cause : un déclencheur de sélection a été défini mais l’opération de
sélection n’a pas été exécutée. Cette dernière doit être exécutée
pour que la mise à jour puisse être ensuite effectuée.
Action : exécutez une opération de sélection puis relancez la mise à jour.
nnn-[SQL_ASYNC] Echec asynchrone de nom. Erreur : message d’erreur.
Cause : une opération SQL COMMIT a échoué dans l’historique. Dans le
cas d’Oracle, l’échec peut être dû à l’insuffisance d’espace disque.
Action : consultez l’administrateur de la base de données concernant la
base de données externe utilisée.
nnn-[SQL_SYNC] Echec de la fonction d’historique fonction. Erreur : message
d’erreur. Nom de consultation : nom
Cause : il est possible qu’une erreur de syntaxe ait été commise ou un
champ de saisie obligatoire n’a pas été renseigné dans une table
de configuration.
Action : en cas d’erreur de syntaxe, modifiez les informations dans le
panneau Informations sur PowerSQL pour créer une expression
SQL correcte. Si les panneaux sont correctement renseignés,
assurez-vous que la table de base de données existe.
nnn-[UNSOL_MSG_RCVD] Message non sollicité reçu de numéro de tag
Cause : une autre tâche a écrit le tag mailbox de la tâche PowerSQL
(PowerSQL n’attend aucune intervention de cette tâche).
Action : déterminez quelle est la tâche écrivant le tag mailbox de
PowerSQL en consultant la liste de références croisées à partir
du menu principal du Gestionnaire de configuration. Vous
56 / FactoryLink 6.5.0 / Guide de l’utilisateur de PowerSQL
CODES ET MESSAGES D’ÉTAT POWERSQL
pouvez résoudre le problème en modifiant le nom du tag mailbox
de la tâche écrivant le tag mailbox de PowerSQL.
F_BAD_CT_SIZE Taille incorrecte pour CT # numéro CT.
Cause : une incohérence apparaît entre le fichier script PowerSQL et la
taille. Vous avez peut-être modifié le fichier .CTG PowerSQL.
Action : copiez le fichier .CTG depuis la disquette d’installation et
remplacez le fichier existant. Prenez contact avec le service
d’assistance clientèle si le problème persiste.
F_BAD_RMBX Tag mailbox global incorrect : nom de mailbox
Cause : le tag mailbox PowerSQL prédéfini n’existe pas dans le fichier
GLOBAL.CT.
Action : prenez contact avec le service d’assistance clientèle.
F_INIT Echec d’initialisation de la tâche
Cause : ce message est précédé d’un autre message d’erreur décrivant la
cause de l’erreur.
Action : consultez le message précédent pour déterminer la cause de
l’échec d’initialisation.
F_NO_CTS Aucune table correcte dans le fichier d’archives CT nom de fichier
Cause : la table PowerSQL est en cours de configuration.
Action : configurez la table.
F_NO-DOMAIN_NAME Aucun nom de domaine défini pour le répertoire
d’applications nom
Action : spécifiez un nom de domaine pour le répertoire d’applications.
F_OPEN_CT Impossible d’ouvrir le fichier d’archives CT nom de fichier
Cause : un fichier .CT a peut-être été supprimé.
Action : utilisez CTGEN pour recréer le fichier .CT.
FactoryLink 6.5.0 / Guide de l’utilisateur de PowerSQL / 57
Codes et messages
d’état PowerSQL
Cause : aucun nom de domaine n’a été spécifié pour le répertoire
d’applications.
3
•
CODES ET MESSAGES D’ÉTAT POWERSQL
•
•
•
F_READ_CT Impossible de lire le fichier CT # numéro de fichier CT dans le
fichier d’archives CT nom de fichier
Cause : un fichier .CT est altéré.
Action : recréez le fichier .CT altéré.
nnn-[HSENDOFETCH] Tentative de dépassement de la fin de la table de résultat
Cause : une opération de déplacement a tenté de placer la ligne en cours
sur une ligne située au-delà de la table de résultat.
Action : aucune action requise.
nnn-[HSENDOFETCH] Tentative de dépassement du début de la table de
résultat ou de la vue
Cause : une opération de déplacement a tenté de placer la ligne en cours
avant le début de la table de résultat.
Action : aucune action requise.
nnn-[HSENDOFETCH] Echec du déplacement car la table de résultat est vide
Cause : il est impossible d’exécuter un déplacement sur une table de
résultat vide.
Action : aucune action requise.
58 / FactoryLink 6.5.0 / Guide de l’utilisateur de PowerSQL
CODES ET MESSAGES D’ÉTAT POWERSQL
nnn-[HSENDOFETCH] Le déplacement absolu n’a pas atteint la ligne requise
car elle a été supprimée
Cause : le déplacement absolu ne peut pas considérer comme ligne active
une ligne supprimée.
Action : aucune action requise.
nnn-[HSENDOFETCH] Echec du déplacement car toutes les lignes concernées
ont été supprimées
Cause : il est impossible d’exécuter un déplacement dans la direction de
lignes supprimées.
Action : aucune action requise.
nnn-[INCORRECT_MODE] Le type de mode d’enregistrement numéro
d’enregistrement ne correspond pas à l’opération SQL. Nom de consultation :
nom
Cause : l’expression SQL dans le tag PowerSQL ne correspond pas au
type de mode défini pour l’enregistrement d’informations sur
PowerSQL. Le type doit être : $INPUT, $OUTPUT ou $INOUT.
Action : modifiez l’expression SQL dans le tag PowerSQL ou modifiez
l’enregistrement d’informations pour lui attribuer le mode
correct.
nnn-[INPUTROWS] Les lignes d’entrée doivent être comprises entre 1 et la taille
de tableau de données. Nom de consultation : nom
Cause : le tag de la ligne en cours doit être compris entre 1 et la valeur
spécifiée pour la taille de tableau de données.
FactoryLink 6.5.0 / Guide de l’utilisateur de PowerSQL / 59
3
Codes et messages
d’état PowerSQL
Action : définissez une valeur comprise entre 1 et la taille de tableau de
données pour le tag de la ligne en cours puis relancez l’opération.
•
CODES ET MESSAGES D’ÉTAT POWERSQL
•
•
•
nnn-[DYNAMIC_COLUMNS] Seules les expressions de colonne $OUTPUT,
$INPUT, $INOUT sont autorisées. Nom de consultation : nom
Cause : un champ Expression colonne d’un panneau d’informations doit
contenir les mots réservés $OUTPUT, $INPUT ou $INOUT pour
que l’expression SQL définie dans le tag PowerSQL soit
exécutée.
Action : modifiez la valeur du champ Expression colonne en $OUTPUT,
$INPUT ou $INOUT.
nnn-[SQLTRIGGER] Seuls les déclencheurs UPDATE et SELECT sont autorisés.
Nom de consultation : nom
Cause : seul un déclencheur SELECT ou UPDATE peut être configuré
pour l’exécution d’une expression contenue dans un tag
PowerSQL.
Action : configurez uniquement un déclencheur SELECT ou UPDATE.
nnn-[INSERT_TRIG] Les déclencheurs SELECT et DELETE ne sont pas
autorisés. Nom de consultation : nom
Cause : lorsqu’un déclencheur INSERT a été configuré, il est impossible
de configurer un déclencheur SELECT ou DELETE.
Action : supprimez le déclencheur SELECT et/ou DELETE dans
l’enregistrement de contrôle.
nnn-[SQLEMPTY] Le tag du message SQL est une chaîne vide. Nom de
consultation : nom
Cause : le tag PowerSQL est vide.
Action : définissez le tag PowerSQL par une expression SQL correcte.
60 / FactoryLink 6.5.0 / Guide de l’utilisateur de PowerSQL
CODES ET MESSAGES D’ÉTAT POWERSQL
nnn-[DESCRIBE] Un seul enregistrement de $OUTPUT est autorisé. Nom de
consultation : nom
Cause : pour utiliser l’expression d’une TABLE DE DESCRIPTION, un
seul enregistrement d’informations est autorisé ; l’expression de
colonne doit être $OUTPUT et le nom de tag doit référencer un
tag de message.
Action : modifiez le champ d’expression de colonne de l’enregistrement
d’informations par la valeur $OUTPUT et assurez-vous qu’un
tag de message est placé dans le champ Nom de tag.
nnn-[ARRAY_TOO_SMALL] Les TAGS de l’enregistrement numéro
d’enregistrement sont trop petits. Nom de consultation : nom
Cause : le tableau de tags est trop petit pour la valeur de la taille de
tableau de données définie.
Action : agrandissez le tableau de tags pour garantir le stockage du
nombre de valeurs déterminé par la taille de tableau de données.
nnn-[TAG_TOO_SMALL] La dimension du tag nom de tag est trop petite. Nom
de consultation : nom
Cause : les dimensions du tag référencé dans le champ Nom de tag ou
Expression logique d’un enregistrement d’informations ne sont
pas suffisantes pour permettre le stockage du nombre de valeurs
déterminé par le champ de la taille de tableau de données.
Action : modifiez les dimensions du tag de sorte que le tableau de tags
puisse contenir les valeurs déterminées par la taille de tableau
de données.
Cause : pour utiliser l’expression d’une TABLE DE DESCRIPTION, un
seul enregistrement d’informations est autorisé ; l’expression de
colonne doit être $OUTPUT et le nom de tag doit référencer un
tag de message.
Action : modifiez le champ d’expression de colonne de l’enregistrement
d’informations par la valeur $OUTPUT et assurez-vous qu’un
tag de message est placé dans le champ Nom de tag.
FactoryLink 6.5.0 / Guide de l’utilisateur de PowerSQL / 61
3
Codes et messages
d’état PowerSQL
nnn-[DESCRIBE_TAG] Tag de type message requis pour la sortie d’une
expression d’une TABLE DE DESCRIPTION. Nom de consultation : nom
•
CODES ET MESSAGES D’ÉTAT POWERSQL
•
•
•
nnn-[INVTAG_SYNTAX] Syntaxe de tag incorrecte : nom de tag
Cause : une syntaxe de nom de tag incorrecte a été saisie dans le champ
Expression logique d’un enregistrement d’informations.
Action : entrez un nom de tag correct et assurez-vous que le tag est défini
dans l’application.
nnn-[NO_OBJ_CT] Impossible d’accéder à CT OBJECT
Cause : erreur interne : il est impossible d’accéder à la base de données
du nom de tag.
Action : prenez contact avec le service d’assistance clientèle.
nnn-[NO_FIND_TAG] Impossible de trouver le tag : nom de tag
Cause : le nom de tag référencé dans le champ Expression logique d’un
enregistrement d’informations est introuvable. Le nom de tag est
mal orthographié ou le tag n’a pas été défini à un autre endroit
de l’application.
Action : vérifiez l’orthographe du nom de tag ou définissez le tag ailleurs
dans l’application.
nnn-[TAG_WRONG_DOMAIN] Le tag nom de tag ne peut pas être référencé par
le domaine type de domaine.
Cause : la tâche PowerSQL ne peut pas accéder au nom de tag référencé
dans le champ Expression logique de l’enregistrement
d’informations car le domaine spécifié est incorrect.
Action : éditez le tag pour qu’il soit accessible par PowerSQL ou entrez
un nouveau tag avec le domaine correct.
nnn-[INV_DIM_SPEC] Indicateurs de dim incorrects pour le tag : nom de tag
Cause : le nom de tag référencé dans le champ Expression logique de
l’enregistrement d’informations contient un indicateur de
dimension incorrect.
Action : assurez-vous que les dimensions du tag sont correctes en
fonction de la définition du tag.
62 / FactoryLink 6.5.0 / Guide de l’utilisateur de PowerSQL
CODES ET MESSAGES D’ÉTAT POWERSQL
nnn-[UPDCOL_EXPR] L’affectation de colonne expression colonne ne peut pas
posséder d’autres champs configurés. Nom de consultation : nom
Cause : affectation de colonne :
1) Les champs Opérateur logique ou Expression logique dans
l’enregistrement d’informations ne peuvent pas être configurés
ou
2) l’expression d’affectation de colonne référence une variable de
substitution « ? » et aucun champ Nom de tag n’est configuré ou
3) le champ Nom de tag est configuré mais l’expression
d’affectation de colonne dans le champ Expression colonne ne
contient pas de variable de substitution « ? ».
Action : assurez-vous que les champs Opérateur logique et Expression
logique sont vides et vérifiez que le champ Nom de tag est correct
pour l’expression d’affectation de colonne saisie dans le champ
Expression colonne.
nnn-[FL_FUNC] Erreur lors de la lecture du tag. Erreur = code d’erreur. Nom de
consultation : nom
Cause : l’appel de fonction PAK FactoryLink fl_read a détecté une erreur
inconnue ou inattendue.
Action : prenez contact avec le service d’assistance clientèle.
nnn-[FL_FUNC] Erreur lors de la lecture du tag. Erreur = code d’erreur. Nom de
consultation : nom
Cause : l’appel de fonction PAK FactoryLink fl_write a détecté une
erreur inconnue ou inattendue.
Action : prenez contact avec le service d’assistance clientèle.
Cause : le tag PowerSQL de l’enregistrement de contrôle référence
davantage de variables d’entrée que répertoriées dans le
panneau Informations sur PowerSQL.
Action : ajoutez des enregistrements d’entrée dans le panneau
Informations sur PowerSQL ou modifiez l’expression SQL dans
le tag PowerSQL.
FactoryLink 6.5.0 / Guide de l’utilisateur de PowerSQL / 63
Codes et messages
d’état PowerSQL
nnn-[INPUTS_TOO_SMALL] Pas assez d’enregistrements d’entrée configurés
pour l’opération SQL. Nom de consultation : nom
3
•
CODES ET MESSAGES D’ÉTAT POWERSQL
•
•
•
nnn-[OUTPUTS_TOO_SMALL] Pas assez d’enregistrements de sortie
configurés pour l’opération SQL. Nom de consultation : nom
Cause : le tag PowerSQL de l’enregistrement de contrôle référence
davantage de colonnes de sortie de résultat que configurées dans
le panneau Informations sur PowerSQL.
Action : ajoutez des enregistrements de sortie dans le panneau
Informations sur PowerSQL ou modifiez l’expression SQL dans
le tag PowerSQL.
nnn-[INPUTS_UNEQUAL] Le nombre d’enregistrements d’entrée ne correspond
pas aux exigences SQL. Nom de consultation : nom
Cause : l’expression SQL générée par PowerSQL ne correspond pas aux
données configurées dans le panneau Informations sur
PowerSQL.
Action : prenez contact avec le service d’assistance clientèle.
nnn-[OUTPUTS_UNEQUAL] Le nombre d’enregistrements de sortie ne
correspond pas aux exigences SQL. Nom de consultation : nom
Cause : l’expression SQL générée par PowerSQL ne correspond pas aux
données configurées dans le panneau Informations sur
PowerSQL.
Action : prenez contact avec le service d’assistance clientèle.
64 / FactoryLink 6.5.0 / Guide de l’utilisateur de PowerSQL
Index
Symboles
$INOUT 39
$INPUT 39
$OUTPUT 39
A
Accolades 29
AND 37
AND_NOT 38
Apostrophe 28, 42
B
Barre oblique inverse 28
Boîte de dialogue, Définition de tag 20, 22–25,
27–28, 30–31, 33–34, 37
C
Cache 25, 32
Chaîne constante caractères 27, 30, 39
Champ
*Déclencheur d’insertion Création
automatique 23
*Nom de table base de données 38
*Nom table base de données 27
Déclencheur de déplacement 24, 32
Déclencheur de mise à jour 21
Déclencheur de position 26, 32
Déclencheur de sélection 20, 26
Déclencheur de suppression 22
Déclencheur sur fin d’action 33
Etat terminaison 33
Expression colonne 29, 37–39, 41
Expression logique 37–38, 40
Mailbox historique 27
Nom de colonne 38
Nom de consultation 20
Nom de tag 31, 36, 39
Opérateur logique 37–38, 41
Tag de la ligne en cours 21, 23–24, 30
Tag PowerSQL 28, 39
Taille de tableau de données (lignes) 17,
21, 23–24, 31, 34, 36, 42
Taille du cache interne (lignes) 26, 32–33
Taille maximale des données caractère 40
Clause facultative 30
Clause WHERE 14–15, 37–38, 41–43
Codes d’erreur 33
Codes d’état 33–34, 45
Colonne 36
Conditions 37
de remplacement 37
inverses 38
inverses de remplacement 38
Constante
chaîne 27, 30, 39, 42
numérique 39
Copie 33
COUNT 39
Création structure base de données 21–22
Index I-65
Crochets 30
D
Débordement 13
Déclencheur
déplacement 24–25, 29, 32
insertion 23–24, 27–28
mise à jour 21, 27–28, 43
position 26, 29, 32
sélection 20, 22, 24–28, 30, 32, 42–43
suppression 22, 27–28, 43
Démarrage, tâche 24, 28
Déplacement relatif 24
Déroulement 25, 32
Deux points 40
Différent de 41
Dimension 40
Disque 33
Domaine
SHARED 19–20
USER 19–20
E
Echec 33
Ecran Gestionnaire d’exploitation 45
Ecran graphique 16, 32, 34, 45
Editeur d’applications 34
Enregistrement de contrôle 20, 27–28, 32–33,
37, 39–40, 42
Entrée 34, 39
Erreurs 34
Expression
conditionnelle 37, 41
logique 37, 41–42, 44
Expression colonne 40
Expression logique 14, 16
I-66 FactoryLink ECS
F
Fenêtre de résultat 11–12, 16, 24–26, 30–31, 44
Fichier journal 45
Fonction
COUNT 39
MAX 39
G
Gestionnaire de configuration, menu principal
20
Grille 32
Grille de table 32
GROUP BY 41
H
Heure courante 39
Historique 11, 17, 27–29, 33, 39, 44–45, 49
Historique, dBASE IV 22, 37, 39, 41–42
Horodatage 39
I
Index 21–22, 29, 37, 42
Indicateur de changement d’état 33, 44
Inférieur à 41
Inférieur ou égal à 41
L
Lecture seule 30
Ligne active 24
M
Macro 39
Marqueur de substitution 41
Maths & Logique 11, 34, 40
MAX 39
Mémoire 33
Messages 34
Messages d’état 33
Mise à jour
logique 16, 21, 23, 28, 30–31, 34, 42
position 16, 21, 28, 30
Mot réservé 39, 41
N
Nom alias de base de données 27–28
Nom de colonne 14
Nom de table 27–28
Nom de table de base de données 28
NOT 38
Nul 41
O
Objet texte de sortie 45
ODB 29
Opérateur
AND 37
AND_NOT 38
logique 14
NOT 38
OR 37
OR_NOT 38
relationnel 41
Opération
déplacement 30–32
relatif 24
insertion 12, 16, 28, 30–31, 34, 36, 39
ligne unique 24
lignes multiples 24
mise à jour 12, 16, 36, 39
ligne unique 22
lignes multiples 21
logique 16, 21, 23, 28, 30–31, 34, 42
position 16, 21, 28, 30
positionnement 30–32
sélection 12, 14, 16–17, 30–32, 37, 39
suppression 12, 17, 22, 36
ligne unique 23
lignes multiples 23
logique 17, 22, 28, 30–31, 34, 42
position 17, 22, 28, 30
OR 37
OR_NOT 38
ORDER BY 41
P
Panneau
Configuration système 45
Contrôle consultation base de données
exemple 35
Contrôle PowerSQL 20, 36, 38, 42
Informations sur PowerSQL 21–22, 24,
30–31, 34, 36–37, 44
Parenthèses 30
Plage de valeurs 41
PLC 33
Point 28
Point d’interrogation 29–30, 39, 41, 43
Ponctuation 41
apostrophe 28, 42
barre oblique inverse 28
crochets 30
accolades 29
deux points 40
différent de 41
inférieur à 41
inférieur ou égal à 41
Index I-67
parenthèses 30
point 28
point d’interrogation 29–30, 39, 41, 43
supérieur à 41
supérieur ou égal à 41
virgule 30
Power VB 11
Procédure stockée 29–30, 36, 39
base de données 29
R
Recherche 37
S
Schéma 21
Séquence d’échappement 29
Serveur 11, 17, 29, 33, 39–41
Sortie 34, 39
Structure 22
Supérieur à 41
Supérieur ou égal à 41
Suppression
logique 17, 22, 28, 30–31, 34, 42
position 17, 22, 28, 30
Syntaxe 29, 41
T
Table de base de données 42
Table de résultat 12–14, 16, 20–22, 25–26, 29,
32, 39
Tableau de tags 11–12, 21, 23–24, 30–34, 36, 40,
42, 44
Tag
analogique 33–34
entier double longueur 33–34
I-68 FactoryLink ECS
Etat terminaison 34, 45
message 45
numérique 45
ligne en cours 21, 25–26
mailbox 11, 27, 31, 40
message 11–12, 17, 28, 33, 39–40, 42
message tâche 45
Nom de tag 38, 44
PowerSQL 27, 29, 37, 39
tableau 11–12, 21, 23–24, 30–34, 36, 40, 42,
44
Taille de message 31
Taille de tableau de données 25, 30, 32, 42
Taille du cache interne 25, 32
Tampon 13
Téléchargement 33
V
Valeur de retour 29
Variable
entrée 29
intégrée 40–42
substitution 39
Virgule 30
">