Menu

Codes de champ

Mis à jour : 2024-01-04

Les codes de champ et les constantes sont la base de toutes les expressions que vous créez dans l'éditeur de modèles ou le moniteur de données, d’où l’importance de comprendre comment les ajouter et les formater pour créer du contenu conditionnel. 

Les codes de champ vous permettent d’extraire des données d’une déclaration de revenus. Ils sont également utilisés pour construire des instructions conditionnelles. Utilisez les codes de champ dans les modèles, les moniteurs de données et dans les conditions de jeux d'impression. Les codes de champ utilisés dans les modèles, ainsi que les constantes et les conditions, sont entourées de parenthèses bouclées {{ }} (accolades).

Copier un code de champ

Cliquez avec le bouton droit dans le champ et sélectionnez une des options pour copier un code de champ :

  1. Copier le code de champ copie le code de champ dans le presse-papier sans parenthèses. Par exemple : CurrentClient.Engage.Preparer.ClientID. Utiliser cette option dans le moniteur de données, ainsi qu’avec les conditions de jeux d’impression et de modèles.
  2. Copier le code de champ avec les {{parenthèses bouclées}} copie le code de champ dans le presse-papier avec les parenthèses bouclées. Par exemple : {{CurrentClient.Engage.Preparer.OfficeID}}. Utiliser cette option dans les modèles.

Capture d'écran : Copier le code de champ

Cliquez sur la barre bleue

  1. Dans une déclaration de revenus ouverte, placez votre curseur dans le champ d'un formulaire que vous souhaitez insérer dans le modèle.
  2. Cliquez sur le lien du code de champ à gauche dans la barre bleue au bas de la fenêtre TaxCycle. Le code de champ sera copié dans le presse-papier, prêt à être collé dans le modèle.
  3. Maintenez la touche Ctrl enfoncée pendant que vous cliquez pour copier le code de champ sans le préfixe CurrentClient.
  4. Collez le code dans le modèle. Par exemple, {{CurrentClient.Info.ID.FirstName}} insère le prénom du client (pourvu qu’il y a un prénom dans le champ).

Capture d'écran : la barre bleue

Copier les identifiants du flux des travaux

Vous pouvez utiliser des éléments du flux des travaux dans des modèles. Pour copier les identifiants de l’écran flux des travaux :

  1. Ouvrez un fichier, accédez la barre latérale Suivre et recherchez l'élément de flux de travail dont vous avez besoin.
  2. Cliquez avec le bouton droit sur un élément du flux des travaux et sélectionnez Copier l’identifiant du modèle.
    Capture d'écran : Copier l'identifiant du modèle

Morcellement des codes de champ

Les codes de champ sont divisés en partie de sorte à réduire le contenu d’une déclaration de revenus. Vous pouvez les diviser pour déterminer le formulaire sur lequel ils apparaissent ou pour raccourcir votre déclaration si tout le contenu que vous extrayez provient du même formulaire. Examinons un exemple pour mieux comprendre.

Le code de champ du champ Prénom sur la grille de calcul Info dans TaxCycle T1. Voici comment il apparaîtrait si vous le copiez à partir du champ.

{{CurrentClient.Info.ID.FirstName}}

CurrentClient Cela indique à l'éditeur de modèles d'extraire les données du client visible ou actif. Par exemple, si vous imprimez une lettre à partir d'une déclaration de revenus pour le contribuable principal (pas le conjoint). Mais, si vous consultez la déclaration de revenus du conjoint, les données extraites seront celles du conjoint; CurrentClient se réfère au contribuable principal. En revanche, si vous regardez la lettre du contribuable principal, mais que vous voulez inclure les informations du conjoint, vous devez plutôt utiliser CurrentSpouse. Voir Spécifier la personne.
Info Grille de calcul Info.
ID Pointe vers la section Identifiant sur la grille de calcul Info.
FirstName Pointé vers le champ de nom spécifique pour le prénom du client, dans la grille de calcul Info, sous la section ID.

Vous pouvez utiliser ces composantes pour simplifier votre code. Par exemple, voir le code suivant pour insérer l’adresse du contribuable dans une lettre. En transformant les parties communes de ce groupe de codes de champ en une condition (en créant une instruction d'ouverture de {{# CurrentClient.Info }} et une instruction de fermeture de {{/ CurrentClient.Info }}. Elles font tous les deux la même chose, mais celle de gauche est beaucoup plus facile à lire et à utiliser.

{{# CurrentClient.Info }}

{{ ID.FirstName }} {{ ID.LastName }}

{{/ CurrentClient.Info }}

{{ CurrentClient.Info.ID.FirstName }} {{ CurrentClient.Info.ID.LastName }}

L’importance du code Non seulement cela vous aide à lire le code plus facilement, mais au fur et à mesure que vous créez vos propres conditions, vous verrez des modèles intégrés dans lesquels nous avons simplifié le code de cette manière. Si vous copiez et collez du code existant de là vers un nouveau modèle, il est utile de savoir que vous pouvez avoir besoin de la balise parent {{# CurrentClient }}{{# CurrentClient}} balise parent ou du préfixe CurrentClient (ou autres) pour faire fonctionner le code.

Formulaires et Feuillets à Copies Multiples

Les codes de champ de formulaires et feuillets à copies multiples contiennent un chiffre pour désigner la copie spécifique. Par exemple :

Feuillet 1 :

{{T4Slips.T4[0].CurrentYear.M[2]}}

Feuillet 2 :

{{T4Slips.T4[1].CurrentYear.M[2]}}

Feuillet 3 :

{{T4Slips.T4[2].CurrentYear.M[2]}}

Les [0], [1] et [2] indiquent des copies différentes du même type de feuillet, en l’occurence ici du feuillet T4.

La numérotation d’un formulaire ou d’un feuillet commence toujours à zéro. Si vous voyez un [-1], cela fait référence à un feuillet vierge. Cela change lorsque vous commencez à taper sur le formulaire ou le feuillet.

Tableaux extensibles

Les codes de champ des tableaux extensibles contiennent un chiffre pour désigner la rangée spécifique. Par exemple :

Rangée 1 :

{{MedicalExpenses.ExpensesDetails[0].Amount}}

Rangée 2 :

{{MedicalExpenses.ExpensesDetails[1].Amount}}

Rangée 3 :

{{MedicalExpenses.ExpensesDetails[2].Amount}}

La numérotation d’une rangée commence toujours à zéro. Si vous voyez un [-1], cela fait référence à une rangée vierge. Cela change lorsque vous commencez à taper dans une rangée.

Cases à cocher

Pour afficher la valeur d’une case à cocher, ajoutez la case au moniteur de données :

  1. Cochez l'une des cases de la liste et ne vous déplacez pas vers un autre champ, afin que l'une des cases de la liste demeure active.
  2. Cliquez sur le signe plus à l'extrême droite du moniteur de données pour ajouter le champ au moniteur de données.
  3. Le nom du champ ou le numéro de ligne s'affiche sur le côté gauche du moniteur de données.
  4. La valeur de la case actuellement cochée se trouve sur le côté droit. Il s'agit de la valeur exacte à utiliser lors de la création d'une condition avec cette case à cocher. Cochez chaque case une par une pour voir sa valeur.

Capture d'écran : valeur d’une case à cocher

La plupart des cases à cocher de TaxCycle vous permettent de sélectionner une seule réponse dans la liste, comme la question sur la résidence principale sur l'annexe 3 de la T1. Ces types de cases à cocher ont un nom unique dans la partie gauche du moniteur de données et différentes valeurs associées à chaque case.

Les autres cases à cocher vous permettent de sélectionner toutes les réponses qui s'appliquent à une question. Comme les questions de la partie A du T1135. En coulisses, ce sont des choses différentes. Chaque zone a un nom et une valeur différents. Vous devez donc ajouter chaque zone au moniteur de données pour voir la valeur, plutôt que d'en ajouter une seule et de passer d'une zone à l'autre.