|
|
|
|
|
|
|
|
|
|
- Les valeurs copiées
- Utilisation des listes de rubriques
- Rubriques Tableau
- Erreurs n'entraînant pas de modification de l'enregistrement destination
- Versions précédentes
HCopieEnreg (Fonction) En anglais : HCopyRecord
 Non disponible avec ce type de connexion
HLitPremier(Client, Nom)
TANTQUE HEnDehors(Client) = Faux
HCopieEnreg(Client2, Client, hValDéfaut)
HAjoute(Client2)
HLitSuivant(Client, Nom)
FIN
Commande_2019 est une Source de Données
HAlias(Commande, Commande_2019)
HChangeNom(Commande_2019, "Commande_2019")
HCrée(Commande_2019)
POUR TOUT Commande AVEC DateCommande = "20190101" À "20191231"
HCopieEnreg(Commande_2019, Commande, hValDéfaut)
HAjoute(Commande_2019)
FIN
Syntaxe
Copier l'enregistrement en cours Masquer les détails
<Résultat> = HCopieEnreg(<Table destination> , <Table 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.
<Table destination> : Chaîne de caractères Nom de la table destination à manipuler. Les données seront copiées vers l'enregistrement en cours de cette table. <Table source> : Chaîne de caractères Nom de la table d'origine à manipuler. L'enregistrement en cours de cette table contient les informations à copier. <Rubrique destination> : Chaîne de caractères optionnelle Liste des rubriques de la table destination à affecter avec les valeurs lues dans l'enregistrement en cours de la table 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.
<Rubrique source> : Chaîne de caractères optionnelle Liste des rubriques de la table source devant être copiées dans l'enregistrement en cours de la table 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.
<Options> : Constante ou combinaison de constantes (optionnel) Paramètre la copie des informations: | | | hCopieIDAuto | Copie 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éfaut | Les 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 de schémas des données). |
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.
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 la table 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. 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 tables.
- la liste des rubriques d'une table contient un nom de rubrique inexistant dans cette table.
- 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.
Classification Métier / UI: Code métier
Documentation également disponible pour…
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|