Logo Docs
Logo Docs

Action @CUT

Copie et supprime le contenu qui suit cette action pour l’utiliser ailleurs dans le document avec @PASTE.

Doit être suivi par du contenu, puis une action @ENDCUT pour marquer la fin du contenu coupé. Ce contenu sera retiré du document et n’apparaîtra que là où un @PASTE correspondant est utilisé.

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

Utilisation

<# @CUT("nom") #>

Paramètres

nom

Le nom à utiliser pour faire référence 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

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

 (Aucune)

Mais ensuite !
Du texte ici
Une ligne de plus

<# @CUT(“exemple”) #>
Du texte ici
<# @ENDCUT #>
Texte après la coupe

 (Aucune)

Texte après la coupe

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

Mais ensuite !
Du texte ici
Une commande : ANNA LOGWATCH

<# @IF(pays = “Canada”) #>
Pour les Canadiens :
<# @CUT(“première_partie”) #>
Du texte ici
Une ligne de plus
<# @ENDCUT #>
<# @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”) #>
<# @CUT(“ex”) #>Du texte<# @ENDCUT #>
Une fois : <# @PASTE(“ex”) #>
Encore : <# @PASTE(“ex”) #>

 (Aucune)

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

Plus d'information

Les actions @CUT et @ENDCUT et le contenu entre elles seront retirés du document.

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

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

L’utilisation principale de cette action est si vous avez une section de contenu que vous utilisez à plusieurs endroits dans le document, comme dans plusieurs @IF. Placez le contenu partagé à la fin du document, enveloppez-le avec les actions @CUT et @ENDCUT, puis à tous les autres endroits qui en ont besoin, utilisez @PASTE pour utiliser le contenu.

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

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

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