SX302-Safe X3 Language v6

Safe X3 Support de formation formation Language Versi Ve rsion on 6

Trusted by over 1 million members

Try Scribd FREE for 30 days to access over 125 million titles without ads or interruptions! Start Free Trial Cancel Anytime.



















SAFE X3 LANGUAGE



















SAFE X3 LANGUAGE

SOMMAIRE SOMMAIRE ................................................................................................................................................. 3 1.

LES VARIABLES ...................................................................................................................................... 4

2.

LES FONCTIONS ................................................................................................................................... 18

3.

LES VARIABLES SYSTEME ..................................................................................................................... 22

4.

ECLIPSE IDE ......................................................................................................................................... 25

5.

LES INSTRUCTIONS .............................................................................................................................. 29

6.

MESSAGE D’ERREUR OU D’AVERTISSEMENT........................................................................................ D’AVERTISSEMENT ........................................................................................ 57

7.

GESTION DES TRACES .......................................................................................................................... 59

8.

OPTIMISATION DES REQUETES ............................................................................................................ 61

9.

OUTILS / UTILITAIRES .......................................................................................................................... 63



















SAFE X3 LANGUAGE

1. L ES VARIABLES

Les variables DECLARATION DE VARIABLES Syntaxe Etendue Type Type int erne Global

Local

Nom de variable

Integer Shortint libelle Decimal Char Date Clbfile Blbfile

variable_name

Dimensio n (si nécessaire) (nb ) ou ( nb1..nb2 )

Local

File

Table_name

occurences possibles

Local

Mask

Masque_name

occurences possibles

LES VARIABLES DECLAREES SONT AUTOMATIQUEMENT INITIALISEES. L’INSTRUCTION RAZ RE-INITIALISE UNE VARIABLE. Copyright © Sage 2010

Sage X3 Language

3

Variables : nom de 12 caractères maximum constitué de lettres et/ou de chiffres le 1er caractère est obligatoirement une lettre Classes Classes globales : Les variables Globales sont Globales sont actives durant durant la session X3 de l’utilisateur. l’utilisateur. Une variable globale peut-être créée en cours de traitement. Elle ne sera pas supprimée automatiquement en fin de traitement. Pour la supprimer, il faudra faire un Kill de Kill de cette variable. Classes locales : Les variables Locales sont Locales sont actives le temps du traitement courant Connues uniquement du traitement courant ( ou sous-pro courant ) classes [F] et [M] : étendue sur traitement courant et sous-pro. sont connues de l’étiquette appelée par Gosub. Gosub. •

•

•

Dimension : Il peut y avoir jusqu’à 4 dimensions. Les tables et les masques sont mono-dimensionnés, avec d’éventuelle occurrences comme dans les tableaux déroulants.



















SAFE X3 LANGUAGE

Les variables DECLARATION DE VARIABLES Etendue des variables Etendue Type int erne

Pérennité

Global

Integer ...

toute la session

Local

Integer

traitement courant

. ..

et étiquettes (appelées par Gosub)

F i le Mask

traitement courant étiquettes (appelées par Gosub) sous-programmes (appelés par Call)

Local

Sage X3 Language

Copyright © Sage 2010

4

Les variables (Les classes) Syn t ax e Champ de table (classe [F] , File)

Champ d'écran (classe [M] , Mask)

Co m m en t ai r es

[F:ABR]CHAMP [ Ind ] ABR = Abréviation Ind = Indice pour

[M:ABR]CHAMP [ Ind ]

La table doit avoir été ouverte avec l'abréviation ABR.

champ dimensionné

( ex. [F:BPC]BPCNUM )

ABR = Abréviation Ind = Indice pour

Le masque masque doit avoir été ouvert avec l'abréviation ABR. ( ex. [M:BPC0]BPCNUM [M:BPC0]BPCNUM )

champ dimensionné

Variable locale (classe [L ] )

[L]VAR

VAR = Nom variable

Variables globales (classe [V] )

[V]VAR

VAR = Nom variable

Le nom commence généralement généralement par G (ex. GNBGAUCHE, GUSER).

Compteurs (classe [C] )

[ C ] C PT

CPT = Nom compteur

Stockés dans la table APLCO APLCOM.

ABR ABR = Abréviation

Champs techniques pour chaque tables ouvertes.

Champ technique de table (classe [G], File)

[G:AB G:ABR] R]CH CHAM AMP P



















SAFE X3 LANGUAGE

Champ table [F: AB AB R] Variable d’une table identifiée par son nom et l’abréviation de la table. Généralement l’abréviation du dictionnaire. Champ d’écran [M: AB AB R] Variable d’un écran identifiée par son nom et l’abréviation de l’écran. Visualisation du nom de la variable et de l’écran par la touche F6. Tableaux déroulants : Variable de bas de tableau, contient le nombre de lignes saisies. Visualisation de cette variable «bas de tableau » par F6, avec curseur sur le tableau sans être en saisie. Variables locales [L] Variables locales à un niveau de sous-programmes. Variables globales [V] Variables globales à la session. Chargées à l’ouverture de la session. [V]GUSER, [V]GLANGUE … utilisateur et langue de connexion [V]GFONCTION fonction courante Dictionnaire Dictionnai re des variables (Développement / Dictionnaire Dictionna ire données données / Ouverture au paramétrage / Variables globales) Remarque Bien que pouvant être omise, il est préférable d’indiquer la classe de la variable. Si la classe n’est pas renseignée, la variable est recherchée recherchée dans la liste des classes.

Les variables >

Présentation : Classe [C] : Les compteurs − Cette classe permet : > La déclaration de compteurs fonctionnelles f onctionnelles ou techniques dans un dictionnaire > Disponible sur toute la session > Stockage unique dans APLCOM > Maj variable dans une transaction > Lock pour éviter conflit > Rewrite pris en charge par le moteur Sage X3

− Le compteur est à renseigner dans le menu : Développement>Dictionnaire Développement> Dictionnaire données>Ouverture données>Ouverture au paramétrage>V paramétrage>Variables ariables de type compteur

− Exemple : > EXPORT, numéro de compteur incrémenté à chaque export depuis un modèle. Permet les exports différentiels.





















SAFE X3 LANGUAGE

Variables superviseur ou fonctionnelle. Elles sont disponibles à tout instant sans être obligé de les déclarer ni de les charger depuis/vers la table APLCOM. Mise à jour d’un compteur Dans une transaction, il faudra le verrouiller avant de le mettre à jour La fin de transaction le déverrouille Exemple Exemple d’ut ilisation : t raitement raitement L ECFI ECFIC C pour créer créer un fichier trace ###################################################################### Trbegin [ACM] Trbegin [ACM] Lock NUMIMP Lock NUMIMP If fstat=0 WNUMIMP = [C]NUMIMP [C]NUMIMP += 1 If fstat : Infbox « erreur sur compteur » : Endif Else Infbox « compteur verrouillé » Endif Commit ######################################################################

Les variables

> Présentation : Classe [G] : liée à une table − Cette classe permet : > D’obtenir les informations techniques d’une table > Cette classe est appelable pour toute table X3.

− Exemple : > Le champ adxfname contient les champ de la table appelée, [G:BPR]adxfname contient donc BPRNUM,BPRNAM…



















SAFE X3 LANGUAGE

Nbind Nbzon Tairec

nb de clés nb de champs taille enregistrement en nombre d’octets

Les variables DECLARATION DE VARIABLES Classe [L] & [V] : Variables dimensionnées •

Exemples :

# Décl écl arati on d’ une une vari vari abl abl e l ocal ocal e de de type type i nt eger eger de 8 él ément ent s ( numér ot é de 0 à 7) Loca Lo call Integer TA TABLN BLNG G( 8) # Décl arat i on d’ une une vari vari abl abl e l ocal ocal e de de type date de de 8 él ément ent s ( numér ot é de 0 à 7) 7) Loca Lo call Date TA TABLN BLNG( 8) # Décl écl arati on d’ une var var i abl abl e l ocal ocal e de t ype ype str i ng de 5 car car act act ères Loca Lo call Char LOC LOCCH CHAR( AR( 5) # Décl écl arati on d’ une var var i abl abl e l ocal ocal e de de t ype ype st r i ng de 8 él él ément ent s de 5 car car act act ères ( numér ot é de 0 à 7) Loca Lo call Char TA TABLI BLI B ( 5) ( 8) # Décl écl arati on d’ une var var i abl abl e l ocal ocal e de de t ype ype st r i ng de 8 él él ément ent s de 5 car car act act ères ( numér ot é de 1 à 8) Loca Lo call Char TA TABLI BLI B ( 5) ( 1. . 8) SI LA LONGUEUR EST NON SPECIFIE, LA LONGUEUR PAR PAR DEFAUT EST DE 30 CARACTERES. Copyright © Sage 2010

Sage X3 Language

Dimensionnement Dimensionnement : On précise le nombre d’éléments ou une borne début et fin Dans le 1er cas, les éléments sont numérotés de 0 à … n-1 4 dimensions maximum :: Local Integer COORD( COORD( I, J, K, L) Après une déclaration, déclaration, une une variable variable est toujours toujours initialisée Integer, shortint, decimal : 0 Date : [0/0/0] Char : " "

8



















SAFE X3 LANGUAGE

Les variables ALIMENTATION DE VARIABLES Opérations sur les numériques : # opérat opérat eur eur s di sponi sponi bl es pour pour champs num numéri ques ques + - * / ^

Opérations sur les chaînes : # opérateu opérateurr s di di spon sponii bl es pour our l es chaî chaî nes + •

Exemples :

# Concaténa oncaténatt i on de chaî chaî nes nes de car car actèr es Loca Lo call Char WCHAR, WCHAR1, WCHAR2 WCHAR1 = «E «Err r eu eurr sur l a t ab abll e» WCHAR CHAR2 2 = «BP «BPCUSTOM CUSTOMER» WCHAR = WCHAR1 – WCHAR2 

«Err eur sur l a t ab abll e BPC BPCUSTOMER ER» »


Sage X3 Language

Opération sur chaîne : Chaine+Chaine concatène deux chaînes. Chaine-Chaine concatène deux chaînes en ne laissant qu’un seul blanc. Opération Opération sur numérique : num1 += num2 ajout de num2 à num1 num1 -= num2 retrait de num2 à num1 num1 *= num2 num1 est multiplié par num2. le résultat est dans num1 num1 /= num2 num1 est divisé par num2. le résultat est dans num1

9



















SAFE X3 LANGUAGE

Les variables ALIMENTATION DE VARIABLES Opérations sur les dates : •

Exemples :

# Al i ment ent at i on d’ une une dat dat e à zér o et et d’ une une aut aut r e au au 31 31 décem décembr e 200 2005 5 Local Lo cal Date WDATE1 DATE1,, WDATE2 WDATE1 = [ 0/ 0/ 0] WDATE2 = [ 31/ 12 12// 20 2005 05]] # Di f f érence ent ent r e 2 ( ex : NBJ OUR = 30 ) Local Lo cal Date WDATE1 DATE1,, WDATE2 Local Lo cal Integer NBJ OUR WDATE1 = [ 01/ 12 12// 20 2005 05]] WDATE2 = [ 31/ 12 12// 20 2005 05]] NBJ OUR = WDATE2 – WDATE1 # Aj out out ou soust r act i on d’ un nom nombre de j our our s ( ex : WDATE2 TE2 = 15/ 15/ 01/ 01/ 2006 2006 ) Loca Lo call Date WDATE1 DATE1,, WDATE2 WDATE1 = [ 01/ 12 12// 20 2005 05]] WDATE2 = WDATE1 + 45


Opérations sur date Date – Date donne un nombre de jours Date +/- nombre donne une date

Sage X3 Language

10



















SAFE X3 LANGUAGE

Les variables PARTICULARITE DU TRANSCLASSE Le trans-classe permet l’alimentation de de chaque champ d'une classe des variables ([ F ] ou [ M ]) par ceux de même nom d'une autre classe ([ F ] ou [ M ])

[M:ABV1] = [F:TAB1 [ F:TAB1]] TABLE [F:TAB1]

MASK [M:ABV1] [F:TAB1] [F:T AB1] = [M:ABV1] [F:TAB2] = [F:TAB1]

TABLE1 [F:TAB1]

TABLE2 [F:TAB2] [F:TAB1] = [F:TAB2]

MASK1 [M:ABV1]

[M:ABV2] = [M:ABV1]

MASK2 [M:ABV2]

[M:ABV1] = [M:ABV2] Copyright © Sage 2010

Sage X3 Language

Trans-classe D’une classe [F] vers une classe [M] et inversement D’une classe [F] vers une autre classe [F] D’une classe [M] vers une autre classe [M] • • •

11





















SAFE X3 LANGUAGE

Les variables PARTICULARITE DU TRANSCLASSE •

Exemple :

Local Fi l e BPA BPAR RTN TNER ER [ BPR PR]]

# Ouver uver t ur e de de l a t abl abl e BPA BPAR RTNER

Rea ead d

# Lect Lect ure du du pr pr emi er enr enr egi egi st r ement ent de l a tabl e

If

[ F: BPR PR]] BPR PR0 0 f i r st [ S ] f s t at = 0

# Si l a l ec t u r e es es t b on onne

# Assi gner gner l es val val eur eur s de l a tabl e aux aux cham champs du du masque asque : 1er 1er e sol sol uti on [ M: BPR PR1] 1] BPR PRSH SHO O

= [ F: BPR PR]] BPR PRSH SHO O

[ M: BPR PR1] 1] BPR BPRN NAM( 0)

= [ F: BPR PR]] BPR PRN NAM( 0)

[ M: BPR BPR1] 1] BPR BPRN NAM( 1)

= [ F: BPR BPR]] BPR BPRN NAM( 1)

[ M: BPR PR1] 1] CRY

= [ F: BPR PR]] CRY

# Assi gner gner l es val val eur eur s de l a tabl e aux aux cham champs du du masque asque : 2nd 2nd sol sol uti on [ M: BPR PR1 1] = [ F: BPR PR]]


Sage X3 Language

12



















SAFE X3 LANGUAGE

Les variables PARTICULARITE DU TRANSCLASSE AVANTAGES AV ANTAGES : 

En modifiant un e table ou une structure de masque, il n'y a aucun besoin de modifi er les programmes. ( intéressant intéressant pour le spécifique ) Champ Cha mp di mensionné automatiquement automatiquement alimenté pour tou s l es postes.





Champ sou mis à c ode activité automatiquement alimenté sans Champ sans t est préalable de présence du ch amp.

COMPLEMENT :  En

plus du t rans-classe rans-classe,, faire une alimentation alimentation champ par c hamp, pour les cas suivants : érent nt  nom de champ diff ére absent de la cl asse d’origine  champ absent


Sage X3 Language

13



















SAFE X3 LANGUAGE

Les variables

> Bloc tableau d’un écran − Les lignes présents sur le bloc tableaux sont indicé de 1 à NBLIG, NBLIG étant la variable de bas de tableaux et contenant le nombre de lignes affichées. Nolign permet d’avoir le numéro de ligne courante. indices commencent à 0, mais les lignes commencent − Attention : Les indices à 1. On utilise la variable [s]nolign-1

− Exemple : > Factures de vente, l’information [M:SIH3]QTY(0), correspond à la quantité saisie sur la première ligne du tableau, nolign=1.


Sage X3 Language

Nolign-1 s’emploie Nolign-1 s’emploie pour indicer un champ d’un bloc tableau. Indice s’emploie pour indicer un champ dimensionné dans un bloc liste.

14



















SAFE X3 LANGUAGE

Les variables Bloc tableau d’un écran •

Exemple :

#- - - Lecture Lecture de des cl i ent ent s l i vrés vrés et cha chargem rgement de l ’ écran r az [ M: BPC PC4] 4] [ S]no S]noll i gn=0 For [ BPD] BPD0 Wher e [ F] BPCNUM=[ M: BPC BPC0] 0] BPC BPCN NUM [ S] nol i gn += 1 [ M: BPC PC4] 4]

trans-classe ligne par ligne

= [ F: BPD]

[ M: BPC PC4] 4] BPD PDN NAM0( nol i gngn- 1) = [ F: BPD PD]] BPDNAM( 0) [ M: BPC PC4] 4] BPD PDN NAM1( nol i gn gn-- 1) = [ F: BPD PD]] BPDNAM( 1)

complément de mise à jour

I f di m( [ M: BPC PC4 4] REP EP0 0) >0 [ M: BPC PC4 4] REP EP0 0( no noll i gn- 1) = [ F: BPD] REP EP(( 0) end endi f I f di m( [ M: BPC PC4 4] REP EP1 1) >0 [ M: BPC PC4 4] REP EP1 1( no noll i gn- 1) = [ F: BPD] REP EP(( 1) en end di f test présence des champs désactivables variable de bas de tableau

Next [ M: BPC BPC4] 4] NBDLV =nol i gn


Sage X3 Language

15



















SAFE X3 LANGUAGE

Les variables Affecter une variable dont on construit le nom Assign e x p _ n o m With e x p _ v a l e u r Assign permet d'affecter une variable dont construit l e nom

•

Exemple :

#- - - chargement ent des des 2 cham champs repr ésent ésent ant ant [ M: BPC PC4]R 4]RE EP0 P0(( nol i gn- 1) = [ F: BPD] REP(0) [ M: BPC PC4]R 4]RE EP1 P1(( nol i gn- 1) = [ F: BPD] REP(1) #- - - ou ut i l i s at at i on as si si gn F or or I = 0 t o 10 10 PC4] 4] REP EP”+ ”+nu num m$(I ) +”( no noll i gn gn-- 1)” Wi t h [ F: BPD] REP EP(( I ) Assign “[ M: BPC Next


Les variables

Sage X3 Language

16





















SAFE X3 LANGUAGE

Les variables BLOB & CLOB •

Exemple :

# Décl arat i on d' une var var i abl abl e cl ob avec avec l ong ongueu ueur par déf déf aut aut Local Cl bf i l e WWCLO LOB B # Déc l ar a r at at i on on d' un une var i ab abl e L oc al Cl bf i l e WWCL OB( 3 )

c l ob ob

de

l on o ngueur

3

(

4094

c ar ac ac t èr èr es es

maxi mum )

# Décl arat i on d' un tabl tabl eau eau de de 2 cl obs obs de l ong ongueur eur 3 Locall Cl bf i l e WWCLO Loca LOB B( 3 ) ( 2 ) # Décl arat i on d' un tabl tabl eau eau de de 2 cl obs obs de l ong ongueur eur 3 Local Loc al Cl bf i l e WWCLOB( 3 ) ( 0. . 1) # Af f ectati on d’ d’ un cl cl ob par par un aut aut re cl obc obc l ob [ M: XXX XX]] CLOB = [ F: XXX] CLOB [ M: XXX] = [ F: XXX] # Af f ectat i on d’ un cl ob par une une vari abl abl e char char di mensi ensi onn onnée Locall Cha Loca harr TE TEX XTE ( 25 250)( 0)( 1. . 10 100) 0) For I =1 t o 100 100 [ M: XXX] CLO LOB B += += TEX TEXTE(I TE(I )

trans-classe fonctionne pour les Clobs & Blobs





















SAFE X3 LANGUAGE

2. L ES FONCTIONS

Les fonctions LES CHAINES DE CARACTERES left$ ( chaîne, inb ) right$ ( chaîne, ipos ) mid$ ( chaîne, ipos, inb ) seg$ ( chaîne, ideb, ifin ) len ( chaîne ) val ( chaîne ) num$ ( nombre ) tolower ( chaîne ) toupper ( chaîne ) ctrans ( chaîne [, ci, co ] ) vireblc ( chaîne, ioption ) format$ ( cfmt, chaîne ) pat ( chaîne, cmodèle ) instr ( ipos, chaîne, cssch ) space$ ( inb )

Extrait les inb premiers caractères de chaîne Extrait les caractères de chaîne à partir de ipos Extrait les inb caractères de chaîne à partir de ipos Extrait la sous-chaîne comprise entre ideb et ifin Longueur de la chaîne Conversion d’une chaîne en numérique Convertit un nombre en chaîne Convertit une chaîne en minuscules Convertit une chaîne en majuscules Filtre les caractères de chaîne Supprime les blancs dans une chaîne Formatage de chaîne avec cfmt « Matc Matchin hing g » de chaîne avec le modèle cmodèle Recherche cssch dans chaîne à partir de ipos Génère une chaîne constituée de inb blancs





















SAFE X3 LANGUAGE

Les fonctions LES DATES date$ time$ time day ( date ) day$ ( date ) month ( date ) month$ ( date ) year ( date ) gdat$ ( ijour, imois, iannée ) nday ( date ) nday$ ( inbjour ) dayn ( date ) week ( date ) aweek ( isemaine, iannée ) eomonth ( date ) addmonth ( date, inb )

Retourne la date du jour (Serveur) Retourne l’heure courante courante sous la forme HH:MM :SS Heure courante en secondes Extrait le jour d’une date Retourne le nom du jour d’une date Extrait le mois d’une date Retourne le nom du mois d’une date Extrait l’année d’une date Retourne la date correspondant à [ijour [ ijour /imois /imois /iannée /iannée]] Retourne le nombre de jours depuis le 1/1/1600 de date Convertit un nbre de jours depuis l e 1/1/1600 en date Retourne le numéro de jour dans la semaine de date Retourne le numéro de semaine d’une date Date du début de l a semaine numéro isemaine de iannée Retourne la date de la fin du mois d’une date Ajoute inb mois à une date

format$

Mise en forme d’une date





















SAFE X3 LANGUAGE

Les fonctions LES EXPRESSIONS NUMERIQUES abs ( nombre ) mod ( ientier, idiv ) rnd ( nombre ) sgn ( nombre ) sqr ( nombre ) ar2 ( nombre ) arr ( nombre, nprec ) fix ( nombre ) int ( nombre ) fac ( ientier ) anp ( in, ip ) cnp ( in, ip )

Valeur absolue Modulo Nombre aléatoire entre 0 et nombre (exclus) [-1,0,1] Retourne le signe d’un nombre [N] Racine carrée Arrondi de nombre à 2 décimales Arrondi de nombre à nprec près Troncature d’un nombre Partie entière d’un nombre Factorielle Arrangements Arrangements de ip dans in Combinaisons de ip dans in

Format$

Mise en forme d’un nombre





















SAFE X3 LANGUAGE

Fonctions fréquemment fréquemment utili sées sées find, min, max, sum Sum : Sum ( Sum (nomvar ) pour une variable dimensionnée, somme de tous les postes























SAFE X3 LANGUAGE

SYSTÈME 3. L ES VARIABL ES SYSTÈME

Les Variables Variables système TABLE























SAFE X3 LANGUAGE

Les Variables Variables système s ystème EN SAISIE pcolor

couleur d’affichage du texte dans une zone au format ‘c’

currbox

liste gauche courante























SAFE X3 LANGUAGE

Les Variables Variables système s ystème APPLICATION nomap

application courante

adxmother

application mère























SAFE X3 LANGUAGE

4. ECLIPSE IDE 4.1. DEFINITION Eclipse est un environnement de développement intégré libre, permettant de créer des projets de développement mettant en œuvre n'importe quel langage de programmation dont le langage L4G X3 par l’ajout d’un plugin. CONFIGURATION 4.2. INSTALLA TION ET CONFIGURATION























SAFE X3 LANGUAGE

   

Cliquez sur « Next > », « Next > » Acceptez les termes de la licence Cliquez sur« Finish » Redémarrez lorsque vous y êtes invité

Une fois le site de mise à jour référencé et le plugin installé, il est possible d’aller recherché directement les mises à jour du plugin SAGE depuis le Menu « Help | Check for updates ».  Interroge tous les sites sites référencés référencés pour vérifier si des des mises à jour sont disponibles. disponibles.  Revoir la sélection si vous le souhaitez. Installez puis redémarrer. redémarrer. 

























SAFE X3 LANGUAGE

























SAFE X3 LANGUAGE

























SAFE X3 LANGUAGE

























SAFE X3 LANGUAGE

























SAFE X3 LANGUAGE

































































































































































































































































































































































































































SAFE X3 LANGUAGE

Optimisation des requêtes REGLES DE BASE 4

Privilégier le filtrage le plus efficace possible dans la base ( clause Where ) : • Privilégier les fonctions et opérateurs opérateurs traduits en SQL : len, ascii, chr$, toupper, tolower, or, and, not, left$, right$, mid$, seg$, >,>=,<,<=,<>,=,+,-,*,/ • Le cas particulie particulierr du Find : For [XXX] Where Fi nd(CHAMP,3,5,9) nd(CHAMP,3,5,9) <>0 est traduit en Select ... Where CHAMP in (3,5,9) For [XXX] Where Fi nd(CHAMP,3,5,9) nd(CHAMP,3,5,9) =0 est traduit en Select ... Where CHAMP not i n (3,5,9) • Le cas particulie particulierr du pat : For For [XXX] [XXX] Wher Where e pat(CHA pat(CHAMP MP,,

»*MODEL »*MODELE* E* ») <>0 est traduit en

Select ... Where CHAMP like ‘% MODELE%’ For For [XXX] [XXX] Wher Where e pat(CHA pat(CHAMP MP,,

»*MODEL »*MODELE* E* ») =0 est traduit en

Select ... Where CHAMP not like ‘% MODELE%’


Sage X3 Language

68

Find : Attention ! À la limite limite dans la clause clause Where avec avec cette syntaxe (<>0 (<>0 ou =0) ( 60 champs alpha ou 60X128 champs numériques) En dehors de la clause Where, Find renvoie le rang Et permet de rechercher une valeur particulière dans une série de variables ou expressions numériques, alphanumériques ou dates. Pat : permet de vérifier la conformité d'une chaîne à un modèle (pattern). Cette conformité se fait avec les conventions suivantes suivantes pour les modèles : • le caractère '*' représente un nombre quelconque, éventuellement nul, de caractères, • le caractère '?' représente exactement un caractère, • le caractère '#' représente un chiffre, • le caractère '!' représente une lettre. En dehors de la clause Where, Pat renvoie 1 si correspondance au modèle.



















SAFE X3 LANGUAGE

9. OUTILS / UTILITAIRES

Outils / Utilitaires Editeur Lancement Lancement de l ’éditeur Par la fonction ADOTRT ADOTRT Par click droit droit sur un champ « nom de traitement traitement » (type de donnée donnée ADC) Dans le dictionnaire dictionnaire des écrans, click droit droit sur action champs « saisie étiquette étiquette »

Ecran d’ouverture de traitement : nom fichier : racine* + TAB permet de visualiser l’ensemble des traitements commençant par cette racine. lecture seule : permet de visualiser un source sans le verrouiller verrouiller

Verrouillage d’un so urce : Dès que l’on ouvre un traitement traitement sans sans cocher la case « lecture seule », création d’un fichier de même nom que le traitement t raitement et d’extension LCK.src

Utilitaire de déverrouillage des traitements : Développement Développement / Utilitaires / Vérifications / Verrou/T Verrou/Traitements raitements verrouillés verrouillés


Sage X3 Language

70

Organisation Organisation du traitement traitement : si traitement unique pour action champ et action objet alors placez les actions sur champs en fin de traitement.



















SAFE X3 LANGUAGE

Outils / Utilitaires Editeur Les fichiers Fichier Fichier source : Fichier Fichier compilé compilé : Fichier Fichier archive archive :

*.sr c dans dossier /TRT /TRT *.adx dans dossier /TRT /TRT archive.atx , atx.ind (index) dans

dossier

La compilation Génère l'ensemble des exécutables exécutables dans le fi chier archive unique et les *. adx.

Les Utilitaires Utilitaire de Génération archive traitements précédée d’une re-génération éventuelle *.adx à partir des sources Utilitaire Archive traitements : Extraction, intégration ou suppression d’un traitement de l’archive Niveaux de localité : fichier dans dossier courant ou dans dossier de niveau niveau supérieur Présence ou ou pas d’un source : tous les sources ne sont pas pas livrés.

Aut om ati sm e in st ru ct ion io n l angage ang age Tokenisation = Aide au langage (curseur sur mot clé + F1) Copyright © Sage 2010

Sage X3 Language

Attention, n’est plus plus utilisé en V6, les .adx sont les les exécutables exécutables

71



















SAFE X3 LANGUAGE

Outils / Utilitaires Editeur Barre d’outils Créer / Modifier Couper / Copier / Coller Sauvegarder Compiler : sauvegarde sauvegarde + compilation Exécuter : sauvegarde sauvegarde + compilation + exécution Calculatrice Aide au langage langage (curseur (curseur sur mot clé) Sommaire de l’aide

Menus En plus des possibilités possibilités de de la barre d’outils d’outils : Ouvrir Ouvrir : plusieurs plusieurs sources Supprimer : suppression source et et exécutable (*.adx et dans l’archive) l’archive) Imprimer Rechercher / Remplacer Suivant / Précédent Aller à la ligne ligne Copyright © Sage 2010

Sage X3 Language

Source complet : Sauvegarder Sauvegarder : Ctrl+S Compiler : sauvegarde du source + compilation ( F7 ) Exécuter : sauvegarde + compilation + exécution ( F5 ) Supprimer un traitement : Fichier / Supprimer Sélectionner tout : Ctrl+A Aller à la ligne ligne : Ctrl+G ( Outil Outil / Aller à la ligne ligne ) Saisie étiquette : Enregistrer : sauvegarde + compilation Fin : sortir avec abandon des modifications modificati ons Exécuter : pour exécuter un traitement objet écrire en début de traitement : Call OBJET ("XXX",GBIDC1,GBIDC2) From GOBJET End XXX étant le code objet

72



















SAFE X3 LANGUAGE

Outils / Utilitaires Editeur $ étiquette appelée par Gosub # commentaires ! not ex : ! clalev([F:BPC]) identique à clalev([F:BPC])=0

: concaténer plusieurs instructions sur une même ligne & continuation instruction sur plusieurs lignes

Mot clé du langage Sage X3 tokenisé. L’aide est disponible par F1


Sage X3 Language

73





















SAFE X3 LANGUAGE

Outils / Utilitaires >

Menu Menu « Outils>Opti Outils>Options… ons… » de la page de de démarrage. démarrage. − Paramétrage des sauvegardes automatique des traitements − Modification du nombre d’espace pour la tabulation. − Modification de la couleur des lignes des tableaux X3. − Modification Polices et styles d’écritures. − Paramétrage pour le lancement d’Eclipse à partir de X3.


Sage X3 Language

Prise en compte de ces paramètres : déconnexion et re-connexion Sauvegarde Sauvegarde automatiq ue : Traitement sauvegardé dans le répertoire temporaire associé à l’utilisateur windows connecté (c:\documents (c:\documents and settings\ ...), ceci toutes les n secondes. Indentation Indentation : Largeur de la marge gauche de l’éditeur de traitement 100 par défaut correspond à 1 caractère Nombre de fichiers li stés : Nombre de fichiers listés dans la fenêtre de choix d’un traitement

74



















SAFE X3 LANGUAGE


Debugger : lancement − Dans une fonction > menu ? / Aide au diagnostic / Debugger + saisie > menu ? / Aide au diagnostic / Dbg On > instruction dans un traitement Dbgaff

− Paramètre utilisateur DBG : > « Paramétrage>Utilisateurs>U Paramétrage>Utilisateurs>Utilisateurs tilisateurs » Onglet Paramètres click droit droit sur ligne « superviseur développement développement » option « déta étail » > autorise ou pas l’accès au debugger par le menu Outils.

Sage X3 Language



Debugger : Utilisation > bouton ligne ligne : pas à pas pas > bouton continuer continuer : évite d’entrer dans les Call, Call, Subprog et Func > bouton fin : arrête le debugger et continue le traitement

−

Tableau des variables : > interrogation de variables ( 20 max. )

75



















SAFE X3 LANGUAGE


Debugger : Détail −

Il s’agit d’une vu de toutes les variables et classe accessible à un instant t de l’exécution du traitement.

− −

Modification Modification des variables par click droit sur une variable. Affichages des des variables accessibles pour une classe donnée, donnée, des écrans, des tables, des traitements et des fichiers ouverts.


Sage X3 Language

77

Le débuggeur est développé avec l'outillage de la plateforme Safe X3. Cet adhérence à l'outil lui apporte certaines limites et il faut éviter de l'utiliser pour pour observer observer : • • • •

Les valeurs valeurs des des variables variables systèmes (nolign, indice, etc.), etc.), globales globales (GMESSAGE,...), (GMESSAGE,...), locale (VALEUR) qui peuvent être faussées. les traitements lancés en batch les import/export import/exp ort (à cause de l'instruction l'instruct ion Setmode qui détourne les instructions instructi ons d'affichage) les web services

Pour pallier à ces ces limi tes : •

Il faut passer par une trace ou par l'instruction l'instruc tion infbox selon les cas.



















SAFE X3 LANGUAGE


Calculatrice − accès via dans une fonction : > menu ? / Aide au diagnostic / calculatrice

− ce qu’elle permet : > évaluer des formules de calcul conformes au langage des expressions sage sage X3. > ex 1 : 3.14159+2.71828 > ex 2 : [BPC]BPCNUM valeur du champ > ex 3 : len([BPC] len([BPC]BPCNUM BPCNUM)) longueur longueur du champ champ

− Fonction du menu contextuel : > historiques: affichage des dernières formules f rappées rappées > HISTCALC paramètre paramètre utilisateur définissant le nombre de formules à garder dans l’historique > décimales: nombre de décimales à utiliser > éditeur formules : aide pour la construction des formules > classes de variables : équivalent du bouton détail en debug Copyright © Sage 2010

Sage X3 Language


Maintenance en lignes

Développement>Utilitaires>Maintenances>En lignes

− Permet la consultation, la modification, la création et la suppression d’un enregistrement d’une table.

− les champs de clé primaire sont en en-tête d’administrateur ( paramètre − accessible aux utilisateurs ayant le profil d’administrateur ADMUSR chap. SUP )

78



















SAFE X3 LANGUAGE

Trace : Un enregistrement est créé dans la table AESPION AESPION est visualisable visualisable par la maintenance, maintenance, ou par une requête requête Trace sur table, clé, nature intervention, intervention, utilisateur, date, heure, fonction d’origine (GMAINT) Trace également dans le fichier espion.tra sous le répertoire tmp

Outils / Utilitaires

>

Transaction Transaction système − Permet de paramétrer la mise à jour d’une ou plusieurs tables. − La MAJ peut être une création, une modification ou une suppression. concernés par la transaction. − Possibilité de filtrer les enregistrement concernés − Renseignement de la table principale et de t able liées à celle-ci. Renseignement des paramètres. − Renseignement − Les paramètres seront à renseigner à l’exécution de la transaction. ent io n !! − Att entio > pas de contrôle de cohérence des données > pas de contrôle de la valeur pour un champ de type menu local

Développement>Dictionnaire Développement>D ictionnaire traitements>Transaction traitements>Transaction de mise à jours Copyright © Sage 2010

Sage X3 Language

Transaction Transaction s ystème : paramétrage reste permanent création, modification ou suppression mise à jour d’un ou plusieurs champs d’une ou plusieurs tables possibilité de saisir des paramètres paramètres possibilité de filtrer des enregistrements

80





















SAFE X3 LANGUAGE

Cas de création d’enregistrement a manipuler avec précaution c’est en fait une duplication d’un enregistrement mise à jour : une ligne de création sur le champ clé, par enregistrement à créer on ne peut pas modifier certains champs dans cette même transaction sélection : pour sélectionner l’enregistrement à dupliquer variables : si utilisée pour alimenter la clé, elle ne doit pas être un type de donnée lié à l’objet

Outils / Utilitaires TRACE ORACLE ou SQL-SERVEUR accès via : menu ? / Aide au diagnostic / activation trace oracle menu ? / Aide au diagnostic / désactivation trace oracle menu ? / Aide au diagnostic / activation t race sql-serveur menu ? / Aide au diagnostic / désactivation trace sqlserveur

Acti Ac ti vati on tr ace : Lance le processus d’analyse



















SAFE X3 LANGUAGE


>

Timer − Permet l’affichage d’une trace d’exécution d’exécution d’un traitement avec le nombre d’appels des routines, le temps d’exécution d’exécution pour tous les appels et la pourcentage par rapport au temps total.

− Accès dans une fonction fonction via : > menu ? / Aide au diagnostic / activation timing > menu ? / Aide au diagnostic / lecture timing

− activation timing : > ouvre la trace > possibilité de de choisir l’emplacement et le nom de la trace > possibilité de de tracer ou pas les Gosub

− lecture timing : > arrête la trace et l’affiche à l’écran



Sage X3 Language

82



















SAFE X3 LANGUAGE

Outils / Utilitaires Eclipse IDE Installation: Télécharger Télécharger Eclipse Eclipse sur le site de sun : http://www.eclipse.org/downloads/ Téléchargez la JVM : http://java.sun.com/javase/downloads/index.jsp Téléchargez le plugin X3 : http://pluginx3.sage.fr/safex3/studio/update/ Puis installez installez le plugin plugin : menu « help>Install help>Install new software… software… »

Création d’un projet Paramétrage : – Fold Folder er (ex (ex:: DEMO) – Hostname (ex: myserver) – Port (ex: 16000) – X3 User et X3 Password – Langua Language ge (ex: FRA, ENG, ENG, ...) – User et Password Password (authentifica (authentification tion OS)

Insertion Insertion de traitement traitement par la fonction fonction « File>Open File>Open SAFE X3 Source Source file »



















SAFE X3 LANGUAGE

SX302-Safe X3 Language v6

Recommend Documents