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 traitement des erreurs
Vous pouvez utiliser cette fonction pour évaluer le type d'erreur lors de l'exécution de la mappe.
FAIL
Vous pouvez utiliser la fonction FAIL pour interrompre une mappe selon la logique spécifique de la mappe ou de l'application.

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.
    - CONTAINSERRORS
      La fonction CONTAINSERRORS teste un objet valide pour déterminer s'il contient des objets en erreur.
    - FAIL
      Vous pouvez utiliser la fonction FAIL pour interrompre une mappe selon la logique spécifique de la mappe ou de l'application.
    - GETXMLERRORMSG
      Utilisez cette fonction sur une carte en sortie pour renvoyer un message d'erreur de validation XML lorsqu'une mappe est exécutée sur une entrée XML non valide.
    - ISERROR
      La fonction ISERROR teste un objet pour vérifier s'il est en erreur.
    - ONERROR
      Utilisez ONERROR dans les règles de composant pour ajouter des messages d'erreur définis par l'utilisateur à la section données du journal d'audit.
    - REJETER
      La fonction REJECT renvoie le contenu d'un objet en erreur, en tant qu'élément texte.
    - QUIT
      Vous pouvez utiliser la fonction QUIT pour arrêter une mappe à un moment donné de son exécution.
    - VALID
      Vous pouvez utiliser la fonction VALID pour exécuter un traitement conditionnel si la fonction d'interface externe aboutit.
  - 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.
  - 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.

FAIL

Vous pouvez utiliser la fonction FAIL pour interrompre une mappe selon la logique spécifique de la mappe ou de l'application.

Syntaxe :: FAIL (expression-texte-unique)
Signification :: FAIL (message_à_renvoyer)
Renvoie :: "Aucun(e)"

La fonction FAIL renvoie "none" à la sortie à laquelle la fonction est attribuée, interrompt la mappe et renvoie message_to_return en tant que message d'erreur d'exécution de la mappe, y compris l'audit d'exécution. Le code retour de la mappe est "30", indiquant que la mappe a échoué via la fonction FAIL.

Exemples

ID_Cpte = EITHER (LOOKUP (ID_client:.:Référence_croisée, Clé:.:Référence_croisée = ID:.:Entrée ) , FAIL ( "Client inconnu (" + ID:.:Entrée + "). Traitement terminé." ) )
Dans cet exemple, la fonction FAIL est associée à la fonction EITHER pour faire échouer la mappe sous condition si un enregistrement dans le fichier de références croisées de client n'existe pas pour un ID_client donné.

Par exemple, l'ID dans Entrée est ABC123. Si la commande LOOKUP aboutit, le résultat ID_client est attribué à ID_Cpte et l'exécution de la mappe se poursuit.

Si la commande LOOKUP échoue, la valeur "none" est attribuée à AcctID, la mappe est interrompue et le message Client inconnu (ABC123). Traitement arrêté. est écrit dans le journal d'audit de l'exécution.
Message = VALID (RUN ("Map1Msg.mmc" , "-AE -OMMSMQ1B `-QN .\aqueue -CID 2001'" ), FAIL ( "Echec sur RUN (" + TEXT (LASTERRORCODE ( ) ) + "):" + LASTERRORMSG ( ) ) )
Dans cet exemple, la fonction FAIL est associée aux fonctions VALID, LASTERRORCODE et LASTERRORMSG pour faire échouer (interrompre) la mappe si la mappe exécutée par la fonction RUN (Map1Msg.mmc) échoue. Dans cet exemple, la mappe échoue et renvoie le code d'erreur et le message d'erreur retournés par la fonction RUN à l'aide des fonctions LASTERRORCODE et LASTERRORMSG.

Si la mappe Map1Msg échoue car une ou plusieurs de ses entrées ne sont pas valides, la valeur "none" est attribuée à Message. La mappe s'interrompt et le message suivant est renvoyé dans le journal d'audit de l'exécution :

"Echec sur RUN (8) : Une ou plusieurs entrées n'étaient pas valides."

Fonctions associées

LASTERRORCODE
LASTERRORMSG
QUIT
VALID

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.