PC SOFT

DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE


  • Les valeurs copiées
  • Utilisation des listes de rubriques
  • Rubriques Tableau
  • Erreurs n'entraînant pas de modification de l'enregistrement destination
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadWidget iOSApple WatchCatalystUniversal Windows 10 AppWindows Mobile
Autres
Procédures stockées
HCopieEnreg (Fonction)
En anglais : HCopyRecord
ODBCNon disponible avec ce type de connexion
Copie :
  • le contenu de l'enregistrement en cours (chargé en mémoire) dans l'enregistrement en cours d'un fichier de données.
  • Versions 19 et supérieures
    WINDEVWEBDEV - Code ServeurWindows Mobile le contenu d'une variable de type Enregistrement dans l'enregistrement en cours d'un fichier de données.
    Nouveauté 19
    WINDEVWEBDEV - Code ServeurWindows Mobile le contenu d'une variable de type Enregistrement dans l'enregistrement en cours d'un fichier de données.
    WINDEVWEBDEV - Code ServeurWindows Mobile le contenu d'une variable de type Enregistrement dans l'enregistrement en cours d'un fichier de données.
Le fichier de données d'origine et le fichier de données destination n'ont pas obligatoirement la même structure. Seules les données mémorisées du fichier de données destination sont modifiées. Le fichier de données destination ne sera modifié qu'à la sauvegarde de l'enregistrement en cours.
Versions 15 et supérieures
Android Cette fonction est désormais disponible pour les applications Android.
Nouveauté 15
Android Cette fonction est désormais disponible pour les applications Android.
Android Cette fonction est désormais disponible pour les applications Android.
Versions 17 et supérieures
iPhone/iPad Cette fonction est désormais disponible pour les applications iPhone/iPad.
Nouveauté 17
iPhone/iPad Cette fonction est désormais disponible pour les applications iPhone/iPad.
iPhone/iPad Cette fonction est désormais disponible pour les applications iPhone/iPad.
Versions 18 et supérieures
Widget Android Cette fonction est désormais disponible en mode Widget Android.
Universal Windows 10 App Cette fonction est désormais disponible en mode Windows Store apps.
Nouveauté 18
Widget Android Cette fonction est désormais disponible en mode Widget Android.
Universal Windows 10 App Cette fonction est désormais disponible en mode Windows Store apps.
Widget Android Cette fonction est désormais disponible en mode Widget Android.
Universal Windows 10 App Cette fonction est désormais disponible en mode Windows Store apps.
Versions 21 et supérieures
Universal Windows 10 App Cette fonction est désormais disponible en mode Universal Windows 10 App.
Nouveauté 21
Universal Windows 10 App Cette fonction est désormais disponible en mode Universal Windows 10 App.
Universal Windows 10 App Cette fonction est désormais disponible en mode Universal Windows 10 App.
Remarque : A partir de la version 19, HFSQL est le nouveau nom de HyperFileSQL.
HLitPremier(CLIENT, NOM)
TANTQUE HEnDehors(CLIENT) = Faux
// Ajoute l'enregistrement dans le fichier de données CLIENT2
HCopieEnreg(CLIENT2, CLIENT, hValDéfaut)
HAjoute(CLIENT2)
// Passe à l'enregistrement suivant
HLitSuivant(CLIENT, NOM)
FIN
// Copie des enregistrements du fichier de données COMMANDE dans un fichier d'archive
COMMANDE_2009 est une Source de Données
 
// Création du fichier d'archive
HAlias(COMMANDE, COMMANDE_2009)
HChangeNom(COMMANDE_2009, "COMMANDE_2009")
HCréation(COMMANDE_2009)
 
// Archivage des commandes
POUR TOUT COMMANDE AVEC DateCommande = "20090101" À "20091231"
// Ajoute l'enregistrement dans le fichier d'archive
HCopieEnreg(COMMANDE_2009, COMMANDE, hValDéfaut)
HAjoute(COMMANDE_2009)
FIN
Syntaxe

Copier l'enregistrement en cours Masquer les détails

<Résultat> = HCopieEnreg(<Fichier de données destination> , <Fichier de données source> [, <Rubrique destination> [, <Rubrique source>]] [, <Options>])
<Résultat> : Booléen
  • Vrai si la copie a été effectuée,
  • Faux en cas d'erreur. La fonction HErreur permet d'identifier l'erreur.
<Fichier de données destination> : Chaîne de caractères (avec ou sans guillemets)
Nom du fichier de données destination à manipuler. Les données seront copiées vers l'enregistrement en cours de ce fichier de données.
<Fichier de données source> : Chaîne de caractères (avec ou sans guillemets)
Nom du fichier de données d'origine à manipuler. L'enregistrement en cours de ce fichier de données contient les informations à copier.
<Rubrique destination> : Chaîne de caractères optionnelle (avec guillemets)
Liste des rubriques du fichier de données destination à affecter avec les valeurs lues dans l'enregistrement en cours du fichier de données source. Les rubriques doivent être séparées soit par une virgule, soit par un retour chariot (RC).
Remarque : Les clés composées ne peuvent pas être des rubriques destination. Elles seront automatiquement affectées.
Hyper File 5.5 Ce paramètre n'est pas pris en compte.
<Rubrique source> : Chaîne de caractères optionnelle (avec guillemets)
Liste des rubriques du fichier de données source devant être copiées dans l'enregistrement en cours du fichier de données destination. Les rubriques doivent être séparées soit par une virgule, soit par un retour chariot (RC). Ces rubriques doivent être classées selon l'ordre de leur affectation dans les rubriques destination. Les clés composées doivent être exclues de cette liste.
Hyper File 5.5 Ce paramètre n'est pas pris en compte.
<Options> : Constante ou combinaison de constantes (optionnel)
Paramètre la copie des informations :
hCopieIdAutoCopie l'identifiant automatique en conservant sa valeur.
Remarque : L'utilisation de cette constante implique l'utilisation de la constante hFixeIdAuto dans la fonction HAjoute suivante.
hValDéfautLes rubriques de l'enregistrement destination non affectées par la copie sont initialisées avec leur valeur par défaut (définie sous l'éditeur d'analyses).

Si aucun paramètre n'est spécifié, l'identifiant automatique n'est pas copié et les rubriques de l'enregistrement destination non modifiées ne sont pas initialisées.
Hyper File 5.5 Ce paramètre n'est pas pris en compte.
Versions 19 et supérieures
WINDEVWEBDEV - Code ServeurWindows Mobile

Copier l'enregistrement présent dans une variable de type Enregistrement Masquer les détails

<Résultat> = HCopieEnreg(<Fichier de données destination> , <Enregistrement source> [, <Rubrique destination> [, <Rubrique source>]] [, <Options>])
<Résultat> : Booléen
  • Vrai si la copie a été effectuée,
  • Faux en cas d'erreur. La fonction HErreur permet d'identifier l'erreur.
<Fichier de données destination> : Chaîne de caractères (avec ou sans guillemets)
Nom du fichier de données destination à manipuler. Les données seront copiées vers l'enregistrement en cours de ce fichier de données.
<Enregistrement source> : Variable de type Enregistrement
Nom de la variable de type Enregistrement contenant les informations à copier.
<Rubrique destination> : Chaîne de caractères optionnelle (avec guillemets)
Liste des rubriques du fichier de données destination à affecter avec les valeurs lues dans l'enregistrement en cours du fichier de données source. Les rubriques doivent être séparées soit par une virgule, soit par un retour chariot (RC).
Remarque : Les clés composées ne peuvent pas être des rubriques destination. Elles seront automatiquement affectées.
Hyper File 5.5 Ce paramètre n'est pas pris en compte.
<Rubrique source> : Chaîne de caractères optionnelle (avec guillemets)
Liste des rubriques du fichier de données source devant être copiées dans l'enregistrement en cours du fichier de données destination. Les rubriques doivent être séparées soit par une virgule, soit par un retour chariot (RC). Ces rubriques doivent être classées selon l'ordre de leur affectation dans les rubriques destination. Les clés composées doivent être exclues de cette liste.
Hyper File 5.5 Ce paramètre n'est pas pris en compte.
<Options> : Constante ou combinaison de constantes (optionnel)
Paramètre la copie des informations :
hCopieIdAutoCopie l'identifiant automatique en conservant sa valeur.
Remarque : L'utilisation de cette constante implique l'utilisation de la constante hFixeIdAuto dans la fonction HAjoute suivante.
hValDéfautLes rubriques de l'enregistrement destination non affectées par la copie sont initialisées avec leur valeur par défaut (définie sous l'éditeur d'analyses).

Si aucun paramètre n'est spécifié, l'identifiant automatique n'est pas copié et les rubriques de l'enregistrement destination non modifiées ne sont pas initialisées.
Hyper File 5.5 Ce paramètre n'est pas pris en compte.
Nouveauté 19
WINDEVWEBDEV - Code ServeurWindows Mobile

Copier l'enregistrement présent dans une variable de type Enregistrement Masquer les détails

<Résultat> = HCopieEnreg(<Fichier de données destination> , <Enregistrement source> [, <Rubrique destination> [, <Rubrique source>]] [, <Options>])
<Résultat> : Booléen
  • Vrai si la copie a été effectuée,
  • Faux en cas d'erreur. La fonction HErreur permet d'identifier l'erreur.
<Fichier de données destination> : Chaîne de caractères (avec ou sans guillemets)
Nom du fichier de données destination à manipuler. Les données seront copiées vers l'enregistrement en cours de ce fichier de données.
<Enregistrement source> : Variable de type Enregistrement
Nom de la variable de type Enregistrement contenant les informations à copier.
<Rubrique destination> : Chaîne de caractères optionnelle (avec guillemets)
Liste des rubriques du fichier de données destination à affecter avec les valeurs lues dans l'enregistrement en cours du fichier de données source. Les rubriques doivent être séparées soit par une virgule, soit par un retour chariot (RC).
Remarque : Les clés composées ne peuvent pas être des rubriques destination. Elles seront automatiquement affectées.
Hyper File 5.5 Ce paramètre n'est pas pris en compte.
<Rubrique source> : Chaîne de caractères optionnelle (avec guillemets)
Liste des rubriques du fichier de données source devant être copiées dans l'enregistrement en cours du fichier de données destination. Les rubriques doivent être séparées soit par une virgule, soit par un retour chariot (RC). Ces rubriques doivent être classées selon l'ordre de leur affectation dans les rubriques destination. Les clés composées doivent être exclues de cette liste.
Hyper File 5.5 Ce paramètre n'est pas pris en compte.
<Options> : Constante ou combinaison de constantes (optionnel)
Paramètre la copie des informations :
hCopieIdAutoCopie l'identifiant automatique en conservant sa valeur.
Remarque : L'utilisation de cette constante implique l'utilisation de la constante hFixeIdAuto dans la fonction HAjoute suivante.
hValDéfautLes rubriques de l'enregistrement destination non affectées par la copie sont initialisées avec leur valeur par défaut (définie sous l'éditeur d'analyses).

Si aucun paramètre n'est spécifié, l'identifiant automatique n'est pas copié et les rubriques de l'enregistrement destination non modifiées ne sont pas initialisées.
Hyper File 5.5 Ce paramètre n'est pas pris en compte.
WINDEVWEBDEV - Code ServeurWindows Mobile

Copier l'enregistrement présent dans une variable de type Enregistrement Masquer les détails

<Résultat> = HCopieEnreg(<Fichier de données destination> , <Enregistrement source> [, <Rubrique destination> [, <Rubrique source>]] [, <Options>])
<Résultat> : Booléen
  • Vrai si la copie a été effectuée,
  • Faux en cas d'erreur. La fonction HErreur permet d'identifier l'erreur.
<Fichier de données destination> : Chaîne de caractères (avec ou sans guillemets)
Nom du fichier de données destination à manipuler. Les données seront copiées vers l'enregistrement en cours de ce fichier de données.
<Enregistrement source> : Variable de type Enregistrement
Nom de la variable de type Enregistrement contenant les informations à copier.
<Rubrique destination> : Chaîne de caractères optionnelle (avec guillemets)
Liste des rubriques du fichier de données destination à affecter avec les valeurs lues dans l'enregistrement en cours du fichier de données source. Les rubriques doivent être séparées soit par une virgule, soit par un retour chariot (RC).
Remarque : Les clés composées ne peuvent pas être des rubriques destination. Elles seront automatiquement affectées.
Hyper File 5.5 Ce paramètre n'est pas pris en compte.
<Rubrique source> : Chaîne de caractères optionnelle (avec guillemets)
Liste des rubriques du fichier de données source devant être copiées dans l'enregistrement en cours du fichier de données destination. Les rubriques doivent être séparées soit par une virgule, soit par un retour chariot (RC). Ces rubriques doivent être classées selon l'ordre de leur affectation dans les rubriques destination. Les clés composées doivent être exclues de cette liste.
Hyper File 5.5 Ce paramètre n'est pas pris en compte.
<Options> : Constante ou combinaison de constantes (optionnel)
Paramètre la copie des informations :
hCopieIdAutoCopie l'identifiant automatique en conservant sa valeur.
Remarque : L'utilisation de cette constante implique l'utilisation de la constante hFixeIdAuto dans la fonction HAjoute suivante.
hValDéfautLes rubriques de l'enregistrement destination non affectées par la copie sont initialisées avec leur valeur par défaut (définie sous l'éditeur d'analyses).

Si aucun paramètre n'est spécifié, l'identifiant automatique n'est pas copié et les rubriques de l'enregistrement destination non modifiées ne sont pas initialisées.
Hyper File 5.5 Ce paramètre n'est pas pris en compte.
Remarques

Les valeurs copiées

Les rubriques dont le nom est commun aux deux enregistrements sont copiées (et converties si nécessaire).
Les rubriques de l'enregistrement source n'existant pas dans l'enregistrement destination ne sont pas copiées.
Les rubriques de l'enregistrement destination n'existant pas dans l'enregistrement source ne sont pas modifiées (sauf si la constante hValDéfaut est spécifié).
Lors de la copie d'une rubrique ayant pour valeur NULL, si le fichier de données destination ne supporte pas la valeur NULL, la rubrique copiée est simplement initialisée à vide (chaîne vide ("") pour les chaînes, et 0 pour les numériques).
Remarque : Lorsque les affectations se font entre rubriques de types différents, les conversions de type sont conformes à celles du WLangage.

Utilisation des listes de rubriques

La spécification de deux listes de rubriques permet d'affecter des rubriques de noms différents. Les affectations sont effectuées dans l'ordre d'apparition des rubriques dans les listes.
Si aucune des deux listes de rubriques n'est fournie, seules les rubriques dont le nom est commun aux deux enregistrements sont copiées.
Si seule la liste de rubriques cible (<Rubrique destination>) est fournie, seules les rubriques spécifiées seront copiées.
WINDEVWEBDEV - Code ServeurEtats et RequêtesiPhone/iPadUniversal Windows 10 AppWindows MobileJavaCode Utilisateur (MCU)HFSQLHFSQL Client/ServeurProcédures stockéesHyper File 5.5OLE DBConnecteurs Natifs (Accès Natifs)

Rubriques Tableau

Lors de la manipulation de rubriques tableaux, la fonction HCopieEnreg copie le maximum d'éléments en commençant par le premier élément.
Si le tableau de l'enregistrement "source" contient plus d'éléments que le tableau de l'enregistrement "cible", les éléments supplémentaires de l'enregistrement "source" ne sont pas copiés.
Si le tableau de l'enregistrement "source" contient moins d'éléments que le tableau de l'enregistrement "cible", les éléments supplémentaires de l'enregistrement "cible" ne sont pas modifiés, sauf si la constante hValDefaut est spécifiée.

Erreurs n'entraînant pas de modification de l'enregistrement destination

Les erreurs n'entraînant pas de modification de l'enregistrement destination sont les suivantes :
  • aucune liste n'est fournie et aucun nom de rubrique n'est commun aux deux fichiers de données.
  • la liste des rubriques d'un fichier de données contient un nom de rubrique inexistant dans ce fichier de données.
  • la liste des rubriques cible contient un nom de rubrique de type "clé composée".
  • la liste des rubriques cible contient un nom de rubrique de type "identifiant automatique" alors que la constante hCopieIdAuto n'est pas précisée.
  • deux listes de tailles différentes sont fournies.
Composante : wd250hf.dll
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire