PreviousNext
Help > Développement > Fonctions W-Langage pour AS/400 > ASPropriete
ASPropriete

 Cette fonction donne permet de définir différentes propriétés sur un fichier ou une source de donnée :

·     activation et chemin du fichier d'alias (uniquement pour un fichier),

·     sélection du membre (uniquement pour un fichier).

·     options de curseur et de cache (fichier ou source de donnée),

 

Cette fonction permet également de continuer à travailler avec les fichiers d'alias, lors d'une migration d'un projet WinDev 5.5

 

Syntaxe

 

bResult = ASPropriete(NomFichier, Propriété, Valeur [, Connexion])

 

En anglais : ASProperty

 

 

Paramètres

 

bResult

Booléen. Vrai si la propriété a été affectée, Faux en cas d'erreur.

NomFichier

Chaîne.

Nom du fichier de l’analyse pour lequel on souhaite modifier une propriété ou chaîne vide pour l'ensemble des fichiers.

Propriété

Chaîne.

Une des valeurs du tableau ci-dessous :

 

Propriétés

 

Sous-Type

Valeurs

MEMBER

chaîne

Nom du membre du fichier à utiliser.

Le fichier doit être ouvert après le ASPropriete.

Le membre peut également être spécifié dans l'option MAIN des infos étendues du fichier :

MAIN=

ALIASPATH

 

chaîne

Chemin où se trouve le fichier d'alias : nom_fichier._as

ONLYALIAS

 

booléen

Ignore les infos étendues pour n'utiliser que les informations du fichier d'alias.

CACHESIZE

entier

Nombre d'enregistrement maximum dans le cache.

FORWARDONLY

booléen

Curseur le plus rapide et le moins gourmand en ressource : le fichier est lu du début vers la fin.

CACHEDINSERT

entier

Cache en écriture : un HAjoute ne va pas directement écrire l'enregistrement mais alimenter un tampon avec le nombre d'enregistrements spécifié.
Cette option doit être utilisée avec la plus grande prudence.

 

Valeur

Selon la propriété et le type du tableau.

 

Connexion (optionnel)

Connexion - Nom de la connexion

 

Nouvelles ASPROPRIETE "connexion" : Pour pouvoir changer les valeurs en cours de route.

 

FORCELIBL

TIMEOUT

CONNECTION TIMEOUT

COMMAND TIMEOUT

 

Fichier d'alias

 

Le fichier d'alias était utilisé en WinDev 5.5 pour identifier les fichiers AS/400. C'est un fichier texte qui se trouve dans le répertoire où devrait se trouver son équivalent HyperFile.

 

[NOM_DU_FICHIER]

$FILE=BIBLIO/FICHIER ou FICHIER

CLE1=

CLE2=

...

$JNAL=TRUE // si le fichier est journalisé

$READONLY=TRUE // ouverture en lecture seule

 

$FILE correspond désormais au MAIN des infos étendues du fichier.

Les logiques associés aux clé sont dans les infos étendues des rubriques (LFSYSNAME).

$JNAL correspond à l'option JOURNALED des infos étendues du fichier.

$READONLY correspond au mode d'ouverture de la connexion (HOuvreConnexion).

 

Exemples

 

Utiliser les fichiers d'alias

Résultat est un booléen

 

// Indique dans quel répertoire trouver tous les fichiers d'alias

Résultat=ASPropriete("", "ALIASPATH", "C:\Program Files\Projet")

 

// ignorer les infos étendues, avant l'ouverture du fichier

Résultat=ASPropriete("", "ONLYALIAS", "VRAI")

 

 

Cache et curseur

'Doper' les performances de lecture "brute" de données provenant d'un HExecuteRequeteSQL.

 

// Il faut exécuter la requête avant d'utiliser ASPROPRIETE

HExécuteRequête(MaRequete)

//Cache de 1000 enregistrements

ASPropriete(MaRequete, "CACHESIZE", "1000")

ASPropriete(MaRequete, "FORWARDONLY", "1")

 

Le gain de performance peut théoriquement atteindre 50% sur la partie "lecture" du résultat.