Accueil
Reference
This documentation provides HCL Link reference information.
Fonctions et expressions
Utilisez les fonctions et expressions HCL Link pour créer des règles de composant et des règles de mappe.
Fonctions de recherche et de référence
Cette recherche de fonction effectue un balayage séquentiel de l'ensemble de données spécifié et tente de trouver une correspondance avec la condition logique.
GETFILENAME
La fonction GETFILENAME renvoie le nom de fichier d'une source ou d'une cible d'adaptateur de fichier d'un objet carte indiqué. Si aucun argument n'est spécifié, il renvoie la commande cible associée à la source ou à la destination active.

Reference
This documentation provides HCL Link reference information.
- Fonctions et expressions
  Utilisez les fonctions et expressions HCL Link pour créer des règles de composant et des règles de mappe.
  - Expressions et évaluations
    La présente documentation décrit les fonctions et expressions HCL Link. Les fonctions et expressions sont utilisées pour créer des règles de composant et des règles de mappe.
  - Utilisation de fonctions
    Une fonction est une expression qui crée une sortie en effectuant une opération donnée sur une ou plusieurs entrées.
  - Syntaxe d'une fonction
    Voici un exemple d'appel de fonction :
  - Syntaxe d'argument de fonction
    Généralement, les arguments imposent des restrictions sur l'expression qu'ils utilisent.
  - Fonctions de codage de jeu de caractères
    Les fonctions qui utilisent l'architecture Lien HCL de EXIT convertissent les données en jeu de caractères natif de la plateforme lors de l'appel de fonction.
  - Fonctions générales
    Il existe plusieurs fonctions générales que vous pouvez appeler à partir d'une règle de mappe pour traiter l'entrée.
  - Fonctions bidirectionnelles
    Les langues bidirectionnelles, telles que l'arabe et l'hébreu, sont des langues dans lesquelles le texte est présenté à l'utilisateur dans un ordre allant de droite à gauche, mais les nombres et les chaînes alphabétiques latines du le texte sont présentés de gauche à droite.
  - Fonctions de manipulation et de test de bits
    Vous pouvez utiliser cette fonction pour manipuler et tester un bit dans un nombre binaire.
  - Fonctions de cache
    A l'aide des fonctions de flux, vous pouvez spécifier une valeur pour chacune des variables de flux définies pour un flux, mais aussi modifier une valeur déjà spécifiée pour une variable de flux, si nécessaire.
  - Fonctions de conversion
    Vous pouvez utiliser cette fonction pour convertir une expression d'un type de données vers un autre type de données.
  - Fonctions de date/heure
    Vous pouvez utiliser cette fonction pour effectuer diverses opérations sur la date et l'heure.
  - Fonctions de traitement des erreurs
    Vous pouvez utiliser cette fonction pour évaluer le type d'erreur lors de l'exécution de la mappe.
  - Fonctions d'interface externe
    Vous pouvez utiliser cette fonction pour extraire des données d'une base de données à partir de dans une règle de mappe.
  - Fonctions de flux
    A l'aide des fonctions de flux, vous pouvez spécifier une valeur pour chacune des variables de flux définies pour un flux, mais aussi modifier une valeur déjà spécifiée pour une variable de flux, si nécessaire.
  - Fonctions d'inspection
    Vous pouvez utiliser cette fonction pour tester et inspecter l'objet.
  - Fonctions logiques
    Les fonctions logiques permettent d'utiliser des conditions logiques pour afficher l'une des diverses valeurs.
  - Fonctions de recherche et de référence
    Cette recherche de fonction effectue un balayage séquentiel de l'ensemble de données spécifié et tente de trouver une correspondance avec la condition logique.
    - CHOOSE
      La fonction CHOOSE renvoie l'objet dans une série dont la position dans la série correspond à un nombre spécifié.
    - DBLOOKUP
      La fonction DBLOOKUP exécute une instruction SQL sur une base de données.
    - DBQUERY
      La fonction DBQUERY exécute une instruction SQL sur une base de données.
    - DDEQUERY
      La fonction DDEQUERY vous permet de communiquer avec d'autres applications Windows telles que Trading Partner PC, Excel, etc. si certains critères sont respectés.
    - EXTRACT
      Utilisez la fonction EXTRACT lorsque seuls des membres spécifiques d'une série remplissant une condition donnée doivent être renvoyés. Par exemple, il peut s'agir uniquement de bons de commande contenant des articles de commande en amont.
    - GETANDSET
      Vous pouvez utiliser GETANDSET lorsque vous disposez d'un fichier en entrée qui assure le suivi des informations de contrôle jouant le rôle d'entrée pour votre mappe et que les informations de contrôle dans le fichier doivent être mises à jour en fonction du traitement ayant lieu sur votre mappe.
    - GETDIRECTORY
      La fonction GETDIRECTORY renvoie le chemin d'accès complet (répertoire) du fichier de mappe compilée ou encore la source ou la destination associée à un objet de carte spécifié.
    - GETITXUID
      La fonction GETITXUID renvoie un identificateur unique universel (UUID).
    - GETLOCALE
      La fonction GETLOCALE renvoie les paramètres d'environnement local de l'ordinateur.
    - GETFILENAME
      La fonction GETFILENAME renvoie le nom de fichier d'une source ou d'une cible d'adaptateur de fichier d'un objet carte indiqué. Si aucun argument n'est spécifié, il renvoie la commande cible associée à la source ou à la destination active.
    - GETPARTITIONNAME
      Vous pouvez utiliser GETPARTITIONNAME pour connaître le nom de la partition à laquelle appartiennent les données de l'objet indiqué.
    - GETRESOURCEALIAS
      La fonction GETRESOURCEALIAS renvoie la valeur d'alias de ressource spécifiée dans un fichier de nom de ressource du registre des ressources (.mrn).
    - GETRESOURCENAME
      La fonction GETRESOURCENAME renvoie la commande de source ou de cible d'adaptateur d'un objet carte indiqué. Si aucun argument n'est spécifié, il renvoie la commande cible associée à la source ou à la destination active.
    - GETTXINSTALLDIRECTORY
      La fonction GETTXINSTALLDIRECTORY renvoie le répertoire d'installation du produit Lien HCL.
    - INDEX
      Vous pouvez utiliser la fonction INDEX lorsque vous devez sélectionner ou tester des objets spécifiques en fonction de leur occurrence ou ajouter un numéro de séquence à des objets en sortie.
    - INDEXABS
      Vous pouvez utiliser INDEXABS pour connaître l'occurrence absolue d'un objet spécifique dans toutes les occurrences, plutôt qu'uniquement sur les occurrences valides.
    - LASTERRORCODE
      La fonction LASTERRORCODE renvoie un élément texte dont la valeur est le dernier code d'erreur renvoyé par l'un des ensembles de fonctions spécifiés pendant l'exécution de la mappe.
    - LASTERRORMSG
      La fonction LASTERRORMSG renvoie un élément texte dont la valeur est le message correspondant au dernier code d'erreur renvoyé par l'un des ensembles de fonctions spécifiés pendant l'exécution de la mappe.
    - LOOKDOWN
      La fonction LOOKDOWN effectue une recherche séquentielle dans une série, en commençant par la fin de la série, et renvoie le premier membre de la série qui remplit une condition spécifiée.
    - LOOKUP
      La fonction LOOKUP effectue une recherche séquentielle dans une série et renvoie le premier membre de la série qui remplit une condition spécifiée.
    - MEMBER
      Utilisez MEMBER pour déterminer si un objet se trouve dans une série.
    - SEARCHDOWN
      Utilisez la fonction SEARCHDOWN pour rechercher des données dans une série de données triées par ordre d'octets de page de codes décroissant.
    - SEARCHUP
      Utilisez la fonction SEARCHUP pour rechercher des données dans une série de données triées par ordre d'octets de page de codes croissant.
    - SORTDOWN
      Utilisez la fonction SORTDOWN pour trier les objets d'une série par ordre décroissant.
    - SORTDOWNBY
      Utilisez la fonction SORTDOWNBY pour trier les objets d'une série en fonction d'un composant que contiennent les objets.
    - SORTUP
      Utilisez SORTUP pour trier les objets d'une série selon une séquence croissante.
    - SORTUPBY
      Utilisez la fonction SORTUPBY pour trier les objets d'une série en fonction d'un composant que contiennent les objets.
    - UNIQUE
      La fonction UNIQUE renvoie une série contenant tous les membres "uniques" d'une série.
    - GETENV
      La fonction GETENV renvoie la valeur d'une variable d'environnement. S'il n'existe aucune variable, une chaîne vide est renvoyée.
    - GETOSNAME
      La fonction GETOSNAME renvoie le nom du système d'exploitation.
  - Fonctions mathématiques et statistiques
    Faire précéder chaque fonction MATHLIB de mathlib->
  - Fonctions de texte
    Ces fonctions sont utilisées pour convertir l'élément texte dans une règle de mappe.
  - Fonctions XML
    Il existe plusieurs fonctions XML que vous pouvez appeler à partir de règles de composant et de règles de mappe pour traiter les données XML d'entrée.
  - Les fonctions personnalisées
    A partir de Type Designer ou de Map Designer, vous pouvez créer des fonctions personnalisées pour appeler des bibliothèques externes.
  - Chaînes de format de date et heure
    Vous pouvez utiliser les chaînes de format répertoriées pour les nombres, les dates et les heures dans des fonctions telles que CURRENTDATETIME, FROMNUMBER, TONUMBER, FROMDATETIME et TODATETIME.
  - Chaînes de format numérique
    Vous pouvez créer des formats numériques personnalisés à l'aide de chaînes de format données.
  - Codes retour de la fonction RUN
    Les codes retour et les messages de la fonction RUN peuvent apparaître lors de l'utilisation de la fonction RUN.
  - Codes de jeu de caractères pour CPACKAGE, CSERIESTOTEXT et CTEXT
    Le second argument des fonctions CPACKAGE, CSERIESTOTEXT et CTEXT spécifie le jeu de caractères de la sortie de la fonction. La valeur du second argument (le jeu de caractères du contenu de l'objet) doit être un code de jeu de caractères valide.

GETFILENAME

La fonction GETFILENAME renvoie le nom de fichier d'une source ou d'une cible d'adaptateur de fichier d'un objet carte indiqué. Si aucun argument n'est spécifié, il renvoie la commande cible associée à la source ou à la destination active.

Vous pouvez utiliser GETFILENAME dans une règle de mappe ou une règle de composant lorsque vous devez connaître le nom du fichier de données.

Syntaxe :: GETFILENAME ( [ nom-objet-simple-unique ] )
Signification :: GETFILENAME ( [ carte_pour_laquelle_des_informations_de_ressource_sont_requises ] )
Renvoie :: Un élément texte unique

Lorsqu'un argument est indiqué, GETFILENAME renvoie le nom de fichier d'une source ou d'une cible de fichier d'un objet carte indiqué. Si aucun argument n'est spécifié, la fonction renvoie le nom source ou cible associé à la source ou à la destination active.

Exemples

GETFILENAME (Fichier_commande)
Si la carte Fichier_commande est associée au fichier de données, rép_install\order.txt, GETFILENAME renvoie install_dir\rép_install\.

Supposons que vous souhaitiez exécuter la mappe Mappe à partir d'une règle de composant sur Enregistrement dans l'entrée afin de déterminer si les noms de client en entrée sont valides. Mappe contient deux entrées et une sortie. La première entrée est le nom du client à rechercher. La seconde entrée est un fichier de consultation. La sortie est un élément texte dont la valeur est "valid" ou "error".

Le nom du fichier de consultation peut varier. Il doit correspondre au nom du fichier de données utilisé en tant que source que vous tentez de vérifier. Par exemple, si le nom du fichier de données est c:\DATA.AAA, le nom du fichier de consultation est c:\LOOKUP.AAA. Si le nom du fichier de données est c:\DATA.XYZ, le nom du fichier de consultation est c:\LOOKUP.XYZ, etc.

Vous pouvez utiliser cette règle de composant sur Enregistrement afin de déterminer si le nom de client est valide :

RUN ("MyMap.mmc" , "-IE1S10" + CustomerName:$ + " -IF2 LOOKUP." + RIGHT ( GETFILENAME ( ) , 3 ) + " -OE1" ) = "VALID"

Fonctions associées

GETDIRECTORY
GETRESOURCENAME

Rate this topic

5 stars 4 stars 3 stars 2 stars 1 star

Comment on this topic.

By clicking this box, you acknowledge that you are NOT a U.S. Federal Government employee or agency, nor are you submitting information with respect to or on behalf of one. HCL provides software and services to U.S. Federal Government customers through its partners immixGroup, Inc. Contact this team at https://hcltechsw.com/resources/us-government-contact. Do not include any personal data in this Comment box. Note: To report a problem or question about the product software, do not use this form. Instead, go to the HCL Software Support site.