Guide de design
Guide de design
Dans Ragic, vous pouvez exporter des entrées dans des formats personnalisés, notamment PDF, DOCX, PNG, XLSX, PPTX et ODS. Par exemple, vous pouvez exporter chaque entrée d'une feuille "Commandes clients" au format PDF couramment utilisé par votre entreprise.
Dans la page liste ou la page formulaire, sélectionnez Rapport d’impression personnalisé dans les outils.
Vous pouvez également choisir Impression personnalisée à partir du menu de création de rapports.
Vous serez redirigé vers cette page :
Suivez les étapes ci-dessous pour créer un modèle.
Remarque : seul un SYSAdmin peut créer et configurer des modèles de rapport d’impression personnalisé.
1. Vérifier la présence d’un modèle
Tout d’abord, le système vérifie si vous disposez déjà d’un fichier préconçu (Word, Excel, PowerPoint ou ODS) à utiliser comme modèle.
Si vous disposez d’un modèle, sélectionnez Oui, je souhaite importer mon propre modèle. Si vous n’en avez pas, sélectionnez Non, merci de me fournir un modèle par défaut à modifier.
2. Télécharger le modèle
Si vous sélectionnez "Non, merci de me fournir un modèle par défaut à modifier", vous serez redirigé vers cette page. Cliquez sur Télécharger pour télécharger le modèle par défaut. Remarque : actuellement, seul un modèle Word par défaut est fourni. Vous pouvez l’utiliser comme base pour le modifier et l’adapter à la mise en page ou au type de fichier de rapport de votre choix, par exemple Excel, PowerPoint ou ODS. Le modèle Word téléchargé sera automatiquement pris en compte dans l’aperçu en ligne du rapport d’impression personnalisé après que vous l’aurez modifié et enregistré sur votre ordinateur. Il n’est donc pas nécessaire de le réimporter manuellement. Si vous devez exporter un fichier Excel, PowerPoint ou ODS, veuillez importer séparément le modèle correspondant.
3. Modifier le modèle
Vous pouvez ensuite modifier le modèle selon la mise en page souhaitée, ajouter ou supprimer des champs selon vos besoins, ou le convertir au format Excel, PowerPoint ou ODS. Pour consulter les remarques concernant les modifications, reportez-vous à cette section.
Modèle Word
Modèle Excel
Modèle PowerPoint
Modèle ODS
Pour les paramètres généraux des champs, reportez-vous à la référence de syntaxe des valeurs de champ sur la page d’importation du modèle. Pour les paramètres spécifiques, les mises en forme spéciales ou les exemples associés, reportez-vous à cette section.
Cliquez sur la syntaxe d’un champ permet de copier le paramètre afin de le coller dans votre modèle, vous permettant ainsi de gagner du temps.
Remarque : la syntaxe des champs indépendants et celle des champs de sous-table sont différentes.
Champs indépendants :
Sous-table : reportez-vous à la syntaxe de la figure ci-dessous et ajoutez uniquement les lignes [i] et [i+1]. Dans la ligne [i+1], l’ajout de la syntaxe d’un seul champ représente l’intégralité de la ligne de données.
Lorsqu’une feuille contient plusieurs sous-tables faisant référence à la même feuille source, le système ajoute des positions de sous-table aux paramètres des champs afin de les distinguer. Si vous devez ajouter manuellement une position de sous-table dans le modèle, vous pouvez la trouver dans la référence de syntaxe des valeurs de champ ou dans les informations du champ.
4. Importer le modèle
Si vous sélectionnez Oui, je souhaite importer mon propre modèle ou cliquez sur Suivant après avoir téléchargé le modèle, vous accéderez à cette page, où vous pourrez importer le modèle modifié.
Vous pouvez l’apercevoir dans la fenêtre ci-dessous.
Nom du rapport : dans le coin supérieur, vous pouvez modifier le nom du rapport. Comme plusieurs versions de rapports d’impression personnalisés peuvent exister, utilisez un nom simple et clair afin de les identifier facilement.
Format de fichier : dans le coin supérieur droit de la fenêtre d’aperçu, choisissez le format de fichier à télécharger. Vous pouvez télécharger le rapport sous forme de PDF, d’image PNG ou de document Word.
La liste suivante indique les formats de fichier de sortie pris en charge pour chaque format de modèle :
| Format du modèle | Formats de sortie pris en charge |
|---|---|
| Modèle Word | DOCX、PDF、PNG |
| Modèle Excel | XLSX、PDF |
| Modèle PowerPoint | PPTX、PDF |
| Modèle ODS | ODS、XLSX、PDF |
Rapport hauteur/largeur et échelle de l’image : lors de l’exportation au format PNG, vous pouvez personnaliser le rapport hauteur/largeur et l’échelle de l’image afin d’ajuster la résolution de sortie et la qualité d’affichage. Des échelles plus élevées offrent une résolution supérieure et une qualité d’image plus nette.
Le contenu exporté sera ajusté en fonction du rapport sélectionné. Assurez-vous que le rapport de la mise en page du modèle correspond au rapport sélectionné afin d’éviter les problèmes d’affichage ou le rognage du contenu.
Une fois tous les paramètres configurés, cliquez sur "Sauvegarder le rapport".
Remarque : pour les paramètres avancés, veuillez consulter cette section.
Vous accéderez à la page suivante.
Cliquez sur "Terminer" en bas pour voir le bouton du rapport ajouté dans le coin inférieur droit, puis vous pourrez commencer à utiliser le rapport d’impression personnalisé.
Pour les paramètres généraux des champs, reportez-vous ici. La section suivante présente les paramètres spécifiques et les exemples associés.
Si un champ de téléversement d'image ne s’affiche pas correctement, vous pouvez télécharger à nouveau le modèle par défaut. Si le retéléchargement n’est pas pratique parce que vous utilisez un modèle personnalisé, vous pouvez à la place ajouter IMG:html après le paramètre du champ.
Remarque :
1. Les modèles aux formats Excel, PowerPoint et ODS ne prennent pas en charge ce paramètre. Pour exporter des images dans ces formats, veuillez consulter cet article. Cette méthode s’appliquant uniquement aux champs d’image unique, les champs contenant plusieurs images ne sont pas pris en charge.
2. La taille de l’image de sortie peut être ajustée à l’aide de "Hauteur maximale" et "Largeur maximale". Si nécessaire, vous pouvez également consulter cet article pour ajuster le modèle du champ d’image et contrôler la taille de sortie. Cette méthode s’appliquant uniquement aux champs d’image unique, les champs contenant plusieurs images ne sont pas pris en charge.
3. Si l’option Importation de plusieurs images est activée pour le champ d’image et qu’une seule image est importée, sa taille par défaut sera de 300 px × 300 px lorsque "Hauteur maximale" et "Largeur maximale" ne sont pas spécifiées. Si elles sont spécifiées, l’image sera affichée selon les paramètres configurés. Lorsque plusieurs images sont importées, le système ajuste la taille de chaque image en fonction du nombre total d’images afin d’éviter les problèmes de mise en page. Par conséquent, plus le nombre d’images importées est élevé, plus chaque image sera petite, et la taille de sortie peut ne pas correspondre exactement aux dimensions spécifiées.
Lorsque vous utilisez alt+enter pour ajouter des sauts de ligne dans un champ de typeTexte libre, vous devez ajuster manuellement la syntaxe du champ dans le modèle en ajoutant :convCRLF après la syntaxe du champ. Cela garantit que le contenu du champ s’affiche correctement avec les sauts de ligne dans le fichier téléchargé. (Les modèles Excel ne sont pas pris en charge.)
Si vous utilisez des BBCodes dans un champ Texte libre ou appliquez des styles dans l’éditeur de texte enrichi et que vous souhaitez conserver la mise en forme lors de l’exportation, vous devez ajuster les paramètres des champs en conséquence. (Les modèles Excel, PowerPoint et ODS ne sont pas pris en charge.)
Veuillez consulter le tableau ci-dessous pour découvrir les deux paramètres disponibles :
| Format du paramètre | Format html | Format html(inline) |
|---|---|---|
| Exemple | {d.1002578:html} | {d.1002581:html(inline)} |
| BBCodes pris en charge | br, b, i, u, s, li, ol, ul, img, url, color, sub, sup | b, i, u, s, color, sub, sup (Ne prend pas en charge les URL, les images ni les BBCodes qui créent des sauts de ligne) |
| Convient pour | Lorsque la mise en forme complète est nécessaire et que les valeurs des champs nécessitent des sauts de ligne (par exemple, des paragraphes, des listes) | Pour afficher uniquement une mise en forme de base et conserver la valeur du champ sur une seule ligne en raison d’exigences spécifiques de mise en page. |
Remarque : le texte en indice (sub) et le texte en exposant (sup) nécessitent actuellement l’ajout de {o.preReleaseFeatureIn=5011000} n’importe où dans le modèle pour être pris en compte.
Exemple :
Nous avons exporté l'entrée ci-dessous en utilisant deux formats de paramètres différents, nous permettant d'obtenir les résultats suivants :
Format html
Format html(inline)
Lorsque vous utilisez un champ de type Markdown et souhaitez conserver la mise en forme lors de l’exportation, ajoutez :html après la syntaxe du champ. (Les modèles Excel, PowerPoint et ODS ne sont pas pris en charge.)
Remarque :
1. Si vous utilisez la syntaxe des en-têtes (#), ajoutez {o.preReleaseFeatureIn=5002000} n’importe où dans le modèle.
2. La syntaxe des citations n’est actuellement pas prise en charge.
Si vous souhaitez que le fichier imprimé affiche la date et l’heure actuelles, ajoutez le paramètre suivant au modèle :
{c.now:formatD('YYYY-MM-DD HH:mm:ss')}
Remarque :
1. Pour connaître les options de mise en forme de la date et de l’heure disponibles dans formatD(), reportez-vous à cette page.
2. Utilisez des "apostrophes simples" dans le paramètre, et utilisez uniquement ', et non '.
3. L’heure sera affichée en fonction du fuseau horaire défini dans les paramètres de votre organisation.
En ajoutant des paramètres spécifiques à votre modèle, vous pouvez ajouter les fichiers PDF stockés dans les champs de téléversement de fichier désignés au document PDF final exporté. Vous pouvez choisir de placer les fichiers ajoutés au début ou à la fin de la sortie. Les exemples suivants supposent que le paramètre du champ d’importation de fichier est "d.1234567", dans votre cas, il vous faudra utiliser le paramètre du champ d'importation de votre feuille.
Ajouter à la fin
Ajoutez les paramètres suivants à n’importe quel emplacement du modèle :
{d.1234567FILE_URL[i]:appendFile}
{d.1234567FILE_URL[i+1]}
Ajouter au début
Ajoutez les paramètres suivants à n’importe quel emplacement du modèle :{d.1234567FILE_URL[i]:appendFile(start)}
{d.1234567FILE_URL[i+1]}
Après avoir importé le modèle avec ces paramètres, tous les fichiers PDF importés dans le champ spécifié seront ajoutés soit au début, soit à la fin du document final.
Si votre feuille contient plusieurs champs de téléversement de fichier, appliquez simplement le même format de paramètre à chaque champ selon vos besoins. Vous pouvez configurer certains champs pour que leurs fichiers soient ajoutés au début du document et d’autres à la fin, selon vos besoins.
Champs de téléversement de fichier dans une sous-table
Si le champ d’importation de fichiers se trouve dans une sous-table, utilisez plutôt le format de paramètre suivant (l’exemple ci-dessous suppose que le paramètre de la sous-table est "d.1000123" et que le paramètre du champ de téléversement de fichier est "1000123[i].1000456") :
{d.1000123[i].1000456FILE_URL[i]:appendFile}
{d.1000123[i].1000456FILE_URL[i+1]}
{d.1000123[i+1]}
Remarque : la taille maximale des fichiers après ajout est de 100 Mo.
Lorsqu’une sous-table ne contient aucune ligne dans une entrée, le PDF exporté affiche tout de même un tableau vide. Pour masquer automatiquement le tableau lorsque la sous-table ne contient aucune donnée, ajoutez le paramètre suivant au modèle :
{d.SubtableFieldParameter:ifEM:drop(table)}
Remarque : ce paramètre doit être placé dans le tableau Word que vous souhaitez masquer.
Par exemple, si le paramètre du champ de la sous-table est :
{d.1010314[i].1010299}
{d.1010314[i+1].1010299}
Vous pouvez ajouter ce paramètre dans le même tableau :
{d.1010314:ifEM:drop(table)}
Lorsque la sous-table "1010314" ne contient aucune ligne, l’intégralité du tableau est supprimée du rapport, tandis que si elle contient des lignes, le tableau est exporté normalement.
Remarque : cela s’applique uniquement lorsque la sous-table est complètement vide. Une ligne dont tous les champs sont vides est tout de même considérée comme une donnée et le paramètre ne s’appliquera donc pas dans ce cas.
Pour plus d’informations sur la syntaxe Carbone, consultez les pages Présentation des conditions et Conditions intelligentes de la documentation officielle.
Cliquez sur l’icône engrenage à côté du nom du rapport et sélectionnez Paramètres avancés pour configurer les options suivantes.
Droits d’accès : définissez les groupes qui peuvent utiliser ce rapport.
Champ utilisé pour le nom du fichier : indiquez quel champ de la feuille doit être utilisé pour nommer le fichier téléchargé. 
Remarque : si la valeur du champ contient l’un des caractères suivants : : / * ? < >, Ragic les remplacera par un trait de soulignement " _ " afin de garantir que le nom du fichier puisse être lu correctement par le système d’exploitation. Certains systèmes d’exploitation peuvent comporter des caractères supplémentaires interdits.
Masquer le bouton : vous pouvez choisir de masquer le bouton d’action sur la page liste ou la page formulaire.
Les options suivantes sont disponibles uniquement lorsque le format de fichier est défini sur PDF :
Définir un mot de passe pour ouvrir le PDF : après avoir activé cette option, vous pouvez définir un mot de passe. Le fichier PDF téléchargé nécessitera alors ce mot de passe pour être ouvert.
Utiliser la valeur d’un champ comme mot de passe du PDF : après avoir activé cette option, vous pouvez sélectionner une valeur de champ de la feuille comme mot de passe. Par exemple, pour une "Fiche de paie d’un employé", vous pouvez utiliser "Identifiant de l’employé" comme mot de passe. L’employé doit saisir son propre identifiant pour ouvrir son fichier PDF de fiche de paie.
Remarque :
1. Ce paramètre et l’option Définir un mot de passe fixe pour ouvrir le PDF ne peuvent pas être utilisés simultanément.
2. Si la valeur du champ spécifié est vide, le PDF téléchargé ne sera pas protégé par mot de passe.
3. Télécharger plusieurs entrées et les combiner en un seul PDF produira un PDF qui ne sera pas protégé par un mot de passe.
Utiliser l’aperçu avant impression au lieu du téléchargement direct : lorsque cette option est activée, cliquer sur le bouton du rapport ouvre une nouvelle fenêtre avec une page d’aperçu, vous permettant d’imprimer sans télécharger le fichier. Lorsque vous téléchargez plusieurs entrées, l’aperçu avant impression est pris en charge uniquement lors de l’enregistrement dans un seul fichier. L’enregistrement dans des fichiers séparés (compressés dans un fichier zip) ou le stockage dans un champ d’importation de fichiers n’est pas pris en charge.
Accéder à nouveau à la page Rapport d’impression personnalisé vous permet d’ajouter un nouveau rapport ou de modifier un rapport existant.
Vous pouvez également cliquer sur l’icône engrenage à côté du nom du rapport pour modifier le nom du rapport, configurer les paramètres avancés ou télécharger le modèle ou le rapport.
Cliquez sur le rapport que vous souhaitez modifier, puis vous pourrez importer à nouveau le modèle révisé.
Vous pouvez cliquer sur l’icône engrenage à côté du nom du rapport et sélectionner Télécharger cette version du modèle pour télécharger le modèle enregistré pour ce rapport afin de le modifier.
L’ajout, la modification et la suppression des modèles sont tous enregistrés dans les versions précédentes.
Cliquez sur le lien du modèle pour télécharger la version correspondante du fichier.
Vous pouvez faire glisser le côté gauche du rapport pour modifier l’ordre des rapports.
L’ordre mis à jour sera également reflété dans les boutons de rapport situés dans le coin inférieur droit de la feuille.
Vous pouvez cliquer sur le "X" à côté du rapport sur cette page pour supprimer le rapport enregistré.
Remarque : lorsqu’un rapport est enregistré, un bouton d’action correspondant est automatiquement généré. Ce bouton ne peut pas être supprimé à l’aide de la fonction Supprimer les boutons d’action, il peut uniquement être supprimé en supprimant le rapport correspondant depuis la page des paramètres du rapport d’impression personnalisé.
Après l’enregistrement, accédez à la page formulaire de l’entrée que vous souhaitez imprimer. Dans le coin inférieur droit, un bouton d’action correspondant au rapport d’impression personnalisé enregistré apparaîtra. Cliquez sur le bouton pour commencer à télécharger le fichier.
Le SYSAdmin peut également accéder à la page Rapport d’impression personnalisé, sélectionner un rapport, cliquer sur l’icône engrenage à côté du nom du rapport et choisir Télécharger le rapport.
Remarque : si certains champs ne sont pas téléchargés correctement, reportez-vous à cette section.
Tout d’abord, cliquez sur l’icône située dans le coin inférieur droit de la page liste pour ouvrir la barre de boutons.
Cliquez sur le bouton Rapport d’impression personnalisé pour sélectionner la plage d’entrées et l’option d’exportation. 
Deux options d’exportation sont disponibles :
(1) Stocker dans un champ de téléversement de fichier
Si votre feuille contient un champ Téléversement de fichier, vous pouvez choisir cette option pour importer le fichier exporté dans ce champ pour chaque entrée concernée. 
(2) Enregistrer comme fichier
Vous pouvez choisir d’enregistrer chaque entrée sous forme de fichiers séparés (compressés dans un fichier zip) ou de combiner toutes les entrées dans un seul fichier.
Remarque : le regroupement de plusieurs entrées dans un seul fichier est uniquement pris en charge aux formats PDF, XLSX et PPTX.
1. Actuellement, seul le format page formulaire est disponible. Pour télécharger au format page liste, reportez-vous à la fonction de publipostage.
2. Lorsqu’une feuille contient trop de champs et que la largeur est excessive, il est possible que le modèle téléchargé n’affiche pas les champs qui dépassent les limites de la page. Reportez-vous à la Référence de syntaxe des valeurs de champ pour ajouter des champs au modèle.
3. Le modèle téléchargé place automatiquement les champs de sous-table en bas. Si vous souhaitez modifier l’emplacement des sous-tables, vous devez les déplacer manuellement. Veillez à ce que différentes sous-tables ne soient pas placées sur la même ligne, car cela peut entraîner des problèmes lors de l’impression du rapport.
4. Actuellement, seuls les fichiers PDF des champs de téléversement de fichier peuvent être ajoutés au fichier PDF exporté. Reportez-vous à cette section pour savoir comment ajuster le modèle.
5. Actuellement, les champs utilisant certains BBCodes dans les modèles Word ne s’afficheront pas dans le fichier exporté. Pour connaître les BBCodes pris en charge et savoir comment ajuster le modèle, reportez-vous à cette section.
6. Si un champ de type Signature ou Code-barres ne s’affiche pas correctement, vous pouvez télécharger à nouveau le modèle par défaut. Si le retéléchargement du modèle par défaut n’est pas pratique parce que vous utilisez un modèle personnalisé, reportez-vous à cette documentation
7. Si le serveur privé sur site ne parvient pas à exporter correctement les champs téléversement d’image, veuillez consulter cet article.
8. Veuillez tenir compte des éléments suivants lorsque vous utilisez des champs de type Formule d’approbation qui renvoient des signatures :
(1) APPROVAL.STEP([stepIndex]).SIG([email]) : l’image de la signature peut être exportée. Le modèle téléchargé l’affiche à l’aide du texte alternatif. Si le retéléchargement du modèle n’est pas pratique, veuillez consulter cet article pour la configuration.
(2) APPROVAL.STEP([stepIndex]).SIGIMG([email], [width], [height]) : actuellement non pris en charge.
9. Limitations des modèles Excel et ODS :
(1) Les images ne peuvent pas être insérées dans les cellules (elles peuvent uniquement être placées au-dessus des cellules), et les champs d’image unique dans les sous-tables ne sont pas pris en charge.
(2) Les paramètres :html n'étant pas pris en charge, les BBCodes, Markdown et les champs contenant plusieurs images ne peuvent donc pas être exportés.
10. Limitations des modèles PowerPoint :
(1) Les champs d’image unique dans les sous-tables ne sont pas pris en charge.
(2) Les paramètres :html n'étant pas pris en charge, les BBCodes, Markdown et les champs contenant plusieurs images ne peuvent donc pas être exportés.
Merci pour votre précieux retour !
