Menu

Sections reproductibles

Mis à jour : 2022-06-13

L'éditeur de modèle de TaxCycle vous permet d'écrire un code de modèle, puis d'indiquer à TaxCycle de l'exécuter à plusieurs reprises pour l'appliquer à plusieurs contribuables. Par exemple, ce traitement est utilisé dans le modèle intégré LettreJ T1 pour répéter la section pour le contribuable principal et ensuite pour le conjoint. Cela signifie que vous n'avez besoin de maintenir qu'un seul ensemble de code.

Pour utiliser des sections reproductibles, vous devez d'abord comprendre comment ouvrir l'éditeur de modèles et tester votre code. (Pour en savoir plus, lisez la rubrique d’aide Éditeur de modèles.) Les sections reproductibles contiennent toujours des codes de champ et des conditions. Veuillez donc lire les rubriques d'aide sur les Codes de champ et les Conditions avant de continuer. 

Exemples de sections reproductibles

Vous pouvez trouver des sections reproductibles dans quelques modèles intégrés :

Modèle Utilisé
LettreJ Pour répéter la section qui décrit les crédits d'impôt appliqués au contribuable principal et au conjoint.
Facture Pour répéter des versements et des éléments.
FactureJ Pour répéter la facture du contribuable principal et du conjoint. Et, emboitées dans cette section reproductible, d'autres pour répéter des versements et des éléments.
Avant-saisonJ Pour répéter la liste de contrôle du contribuable principal ou celle du conjoint.
FeuilletsCJ Pour créer une liste de feuillets incomplets pour le contribuable principal et le conjoint.
FeuilletsIF Pour créer une liste de feuillets incomplets pour tous les contribuables dans le fichier. Cela signifie pour le contribuable principal, le conjoint et les personnes à charge qui ont des déclarations complètes.

Exemple A : section reproductible dans FeuilletsIF

{{! Repeat Section template }} {{< repeat }} 

{{ Info.ID.FirstName }}

{{# IncompleteSlips }} 

· {{ . }}

{{# Items }} 

o {{ . }}

{{/ Items }} 

{{/ IncompleteSlips }} {{/ repeat }} {{# File.Clients }} {{> repeat }} {{/ File.Clients }}

Ajout d'un commentaire à des fins d'explication

Toutes les sections reproductibles des modèles intégrés commencent par un commentaire. Lier les codes de champ et les conditions, les commentaires sont insérés entre parenthèses bouclées {{ }}. Dans ces parenthèses, ils commencent par un point d'exclamation {{! }}. Les commentaires n'ont pas besoin d'être fermés. 

Dans l'exemple A ci-dessus, le commentaire pour le début de la section reproductible est {{! Repeat Section template }}.

Définir une section reproductible de code de modèle

Chaque section reproductible doit être entourée d'une balise d'ouverture et de fermeture. Dans l'exemple A ci-dessus, la balise d'ouverture est {{< REPEAT }} et la balise de fermeture est {{/ REPEAT }}.

En fait, peu importe que vous utilisiez le mot "REPEAT" dans ces balises, seulement que vous utilisiez le même mot dans la balise d'ouverture et de fermeture. Par exemple, le modèle LettreJ utilise "details" et FactureJ comporte deux sections, "outerRepeat" et "LineItems".

Indiquer à TaxCycle pour quoi ou qui le répéter

Une fois que vous avez défini une section de code reproductible, vous devez indiquer à TaxCycle le nom ou la personne à répéter. Cela se produit généralement juste après la balise de fermeture, soit sur la même ligne, soit sur la ligne suivante. 

Dans l'exemple A ci-dessus, le code se répète pour tous les clients du fichier : {{# File.clients }} {{> REPEAT }} {{/ File.clients }}

{{# File.clients }} Ouvre l'énoncé qui indique à TaxCycle de répéter pour tous les clients du fichier. Cela signifie le contribuable principal, le conjoint et les personnes à charge qui ont une déclaration de revenus complète.
{{> repeat }} Indique à TaxCycle ce qu'il faut répéter. Le mot « REPEAT » de ce code doit correspondre au mot utilisé pour définir la section reproductible.
{{/ File.Clients }} Ferme l'énoncé. Ceci correspond à l'énoncé d'ouverture, sauf qu'ile comporte la barre oblique / (vers l'avant) pour fermer l'énoncé.

Pour répéter cet énoncé seulement pour le contribuable principal et le conjoint, utilisez le code suivant :

{{# CurrentClient }} {{> repeat }} {{/ CurrentClient }} {{# CurrentSpouse }} {{> repeat }} {{/ CurrentSpouse }} 

Préciser la personne

La partie CurrentClient du code de champ indique à l'éditeur de modèles de regarder le client visible ou actif. Il existe des codes de champ similaires pour vous aider à spécifier la personne à laquelle vous souhaitez accéder au formulaire et au champ.

Code Description

CurrentClient

Regarder le client visible ou actif. Ce code est relatif à la déclaration dans le fichier que vous regardez. Si vous êtes dans la déclaration du conjoint/partenaire, vous pourrez consulter les renseignements sur le conjoint. De même pour les personnes à charge. C'est ce qui permet au modèle LettreC de travailler pour n'importe qui dans le fichier. 

CurrentSpouse

Regarder le conjoint du CurrentClient. Ce code est relatif à l'endroit où vous vous trouvez dans la déclaration. Si vous êtes dans la déclaration du conjoint/partenaire, vous verrez les renseignements du contribuable principal. De même pour les personnes à charge. C'est ce qui permet au modèle LettreJ de travailler pour n'importe qui dans le dossier.

File.Principal

Accéder au contribuable principal, même si vous êtes sur la déclaration d'une personne à charge ou d'un conjoint. Contrairement à CurrentClient, il n'est pas relatif à la déclaration dans le fichier que vous regardez. Vous pouvez également l'utiliser pour déclencher des sections reproductibles. 

Utile pour les propriétés de modèles pertinentes et utilisées pour vérifier si CurrentClient est également le contribuable principal dans le fichier. Par exemple :

CurrentClient = File.Principal

File.Partner Accéder au conjoint/partenaire, même si vous êtes sur la déclaration d'une personne à charge ou d'un contribuable principal. Contrairement à CurrentSpouse, il n'est pas relatif à la déclaration dans le fichier que vous regardez. Vous pouvez également l'utiliser pour déclencher des sections reproductibles. 

File.Dependants

Accéder aux informations pour toutes les personnes à charge du fichier.

Une façon simple d'utiliser ceci est de vérifier s'il y a des personnes à charge dans le fichier :

{{#File.Dependants}}
Ce texte s'affiche s'il y a des personnes à charge dans le fichier.{{/File.Dependants}}

Une autre façon de l'utiliser est de renvoyer une liste de la valeur dans un champ pour toutes les personnes à charge dans le fichier. Par exemple, s'il y a trois personnes à charge dans le fichier, cela donnera une liste de leurs prénoms :

{#File.Dependants}}{{Info.ID.FirstName}} {{/File.Dependants}}

Créer une liste de ces résultats : Joseph Jeanne Jérémie

File.Clients

Utilisé dans les sections reproductibles, pour répéter le code pour tous les clients du fichier. Cela comprend les déclarations du contribuable principal, du conjoint/partenaire et de toutes les personnes à charge.

{{ aggregate(File.Clients, "1") }}

Compter le nombre de clients dans un fichier. Cette opération utilise la fonction de regroupement. Lisez la rubrique d'aide Codes de champ pour en savoir plus.

{{ count(File.Dependants) }}

Compter le nombre de personnes à charge dans le fichier.

Utile pour les propriétés de modèle pertinentes et utilisées afin de vérifier s'il y a des personnes à charge dans le fichier. Par exemple :

count(File.Dependants) > 0

{{# File.Clients }}
{{# . = File.Principal}}
C'est le contribuable principal
{{/ . = File.Principal}}
{{# . != File.Principal}}
Ce n'est pas le contribuable principal
{{/ . != File.Principal}}
{{/ File.Clients}}
Pour traiter l'un des contribuables différemment, le . (point) renvoie la valeur de CurrentClient, afin que vous puissiez vérifier si elle correspond au contribuable principal.