Logo Docs
Logo Docs

Action @COPY

Copie le contenu qui suit cette action pour le réutiliser ailleurs dans le document avec @PASTE.

Doit être suivi par du contenu, puis une action @ENDCOPY pour marquer la fin du contenu copié.

Pensez au classique copier/coller. DocuMold fait essentiellement cela lors de la génération d’un document.

Utilisation

<# @COPY("nom") #>

Paramètres

nom

Le nom à utiliser pour se référer au contenu copié avec @PASTE. Doit être un texte (avec des guillemets \"). Ne peut pas être une variable.

Exemples

Exemple Avec ces variables Résultat

<# @COPY(“exemple”) #>
Du texte ici
Une ligne de plus
<# @ENDCOPY #>
Mais ensuite !
<# @PASTE(“exemple”) #>

 (Aucune)

Du texte ici
Une ligne de plus
Mais ensuite !
Du texte ici
Une ligne de plus

<# @COPY(“exemple”) #>
Du texte ici
<# @ENDCOPY #>

 (Aucune)

Du texte ici

<# @COPY(“exemple”) #>
Du texte ici
Une commande: <# UPPER(nom_client) #>
<# @ENDCOPY #>
Mais ensuite !
<# @PASTE(“exemple”) #>
nom_client est "Anna Logwatch"

Du texte ici
Une commande: ANNA LOGWATCH
Mais ensuite !
Du texte ici
Une commande: ANNA LOGWATCH

<# @IF(pays = “Canada”) #>
Pour les Canadiens :
<# @COPY(“première_partie”) #>
Du texte ici
Une ligne de plus
<# @ENDCOPY #>
<# @ELSE #>
Pour les non-Canadiens :
<# @PASTE(“première_partie”) #>
<# @ENDIF #>
pays est "Belgique"

Pour les non-Canadiens :
Du texte ici
Une ligne de plus

Avant : <# @PASTE(“ex”) #>
<# @COPY(“ex”) #>Du texte<# @ENDCOPY #>
Une fois : <# @PASTE(“ex”) #>
Encore : <# @PASTE(“ex”) #>

 (Aucune)

Avant : Du texte
Du texte
Une fois : Du texte
Encore : Du texte

Plus d'information

Les actions @COPY et @ENDCOPY seront supprimées du document, mais le contenu entre elles restera là où il était initialement.

@COPY est destiné à être utilisé avec l’action @PASTE, qui reçoit également un “nom”. L’action @PASTE sera remplacée par le contenu du @COPY (ou @CUT) qui porte le même nom. @PASTE peut être utilisé avant ou après le @COPY (ou @CUT).

Plusieurs actions @PASTE peuvent être utilisées pour le même nom de @COPY (ou @CUT).

L’utilisation principale de cette action est lorsque vous avez une section de contenu que vous utilisez à plusieurs endroits dans le document, comme dans plusieurs @IF. Placez le contenu normalement dans le premier emplacement souhaité, enveloppez-le avec les actions @COPY et @ENDCOPY, puis à tous les autres endroits, utilisez @PASTE pour réutiliser le contenu.

Le contenu d’une action @COPY est toujours copié pour être utilisé ailleurs dans le document (avec @PASTE), même lorsque le @COPY est supprimé par une action @IF.

Le nom du @COPY doit être unique dans le document, y compris avec les noms des actions @CUT.

Le choix entre utiliser @COPY et @CUT est surtout une question de préférence. Si vous voulez que le contenu soit à l’un des endroits où il est nécessaire, utilisez @COPY, si vous préférez qu’il soit plus facile à trouver en le plaçant à la fin du document, utilisez @CUT.

Voir aussi