> For the complete documentation index, see [llms.txt](https://ksaar.gitbook.io/ksaar-documentation/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ksaar.gitbook.io/ksaar-documentation/le-multi-environnement/les-templates.md). # Les Templates {% hint style="success" %} Les **templates** sont un mécanisme de **partage d'applications** entre **makers**. Ils permettent à un maker de diffuser facilement une application accompagnée des données qu’il souhaite inclure. {% endhint %} {% hint style="danger" %} Sans toute votre vigilance, des données personnelles peuvent se trouver dans un template accessible à un large public, faites donc attention à qui vous partagez vos applications ! {% endhint %} {% hint style="info" %} La création d'un template est disponible à partir du plan [Enterprise](https://www.ksaar.com/pricing). {% endhint %} ## Qu'est-ce qu'un template ? Un template permet à un maker de transmettre facilement une application à d'autres makers ayant des besoins similaires. Cela évite de repartir de zéro en ré-utilisant un modèle déjà fonctionnel. L'avantage d'un template est donc d'**accélérer le temps de développement** d'une application en capitalisant sur un travail déjà fait. Un template se présente sous la forme : * d’une application non modifiable et non utilisable par son créateur, mais qu’il peut mettre à jour à partir d’un version de développement ou de production. Cette application est accessible depuis l’encart des environnements. * d'un lien d’importation auquel d’autres makers peuvent accéder pour dupliquer le template et ensuite utiliser comme point de départ d'une application.

Visualisation du template d'une application basique

### Pour un maker émetteur de template Un template est une version d'une application associée à un environnement distinct. Un template est indépendant du reste d'une application. C'est une photographie immuable d'une application. Comme une version de production, un template n'est pas modifiable depuis la vue "front". Il est par contre possible de modifier les données associées à un template directement depuis l'environnement template, celles-ci peuvent aussi être choisies à la création du template. La modification d'un template en front est possible uniquement via la mise à jour volontaire de celui-ci en suivant les étapes détaillées plus loin. Les paramètres d'accessibilité d’un template pour les autres makers sont entièrement contrôlables. ### **Pour un maker récepteur d'un template** Lorsqu’un maker ayant le droit d'accéder à un template clique sur le lien de partage, il peut déclencher la création d’une copie de ce template dans son espace maker. À partir de ce moment, cette copie est une application complètement indépendante du template initial et de l’application depuis laquelle le template a été généré. Pour importer un template il suffit d'être authentifié sur Ksaar, être autorisé à accéder au template et puis **de copier-coller le lien de partage directement dans la barre d’adresse de votre navigateur**. {% hint style="warning" %} Le clic direct sur un lien hypertexte (`href`) peut ne pas fonctionner pour l’instant. Il est donc nécessaire que la personne à qui vous envoyez le lien le copie-colle dans la barre d’adresse de son navigateur tout en étant connectée. {% endhint %} ### Pour un utilisateur final Il est impossible d'être utilisateur final d'un template. La vue utilisateurs est cachée. Il est évidemment possible d'être utilisateur final d'une application ayant été créée à partir d'un template. ## La création de template Un template peut être créé à partir d'une version de production comme de développement. Une fois généré, il est possible de modifier ses paramètres d'accès et de le mettre à jour. Si une app possède déjà un template, la procédure de génération est remplacée par une procédure de mise à jour. Le déroulement d'une mise à jour est le même que la génération. Lors de sa mise à jour, l'ancien template est écrasé par la nouvelle version du template. Un utilisateur accède toujours à la version courante d'un template. Dans un template, les automations ne sont pas actives. Leur statut affiché (activée ou non) reflète celui de l’application parent à des fins de visualisation. Cela permet de savoir quelles automations seront actives ou non une fois le template importé dans une application réelle. Afin de changer l'état d'une automation dans un template, il suffit de le faire dans la version parent puis de le mettre à jour. {% hint style="success" %} Une application n'a qu'un template actif à la fois. Son lien de partage est unique. {% endhint %} {% hint style="warning" %} Pour des raisons de sécurité certaines données de champs et configurations d'une application ne sont pas incluses dans un template : * Champs paiement one shot * Champs paiement récurrent * Liaisons utilisateur * Liaisons multi-utilisateurs * Configurations des SMTP * Configuration du SSO * Configurations des clés API Ksaar * Clés API Yousign * Clés Mistral AI * Certificats API {% endhint %} ### Accessibilité Un template peut être public ou privé. {% hint style="success" %} Le créateur de l'application peut toujours déclencher l'import de l'application même si son email n'est pas renseigné dans les emails autorisés. Ceci vous permettra de tester plus facilement la fonctionnalité. {% endhint %}

Paramétrage de l'accessibilité d'un template

S'il est public, toute personne ayant le lien peut copier le template sur leur compte Ksaar. S'il est privé, seuls les comptes associées aux adresses mail indiquées dans les paramètres de partage pourront copier l'application. Vous pouvez ajouter autant de comptes que nécessaire. {% hint style="warning" %} La validation de l'accès au template se fait lors du clic sur le lien, non pas lors de la génération ou mise à jour du template. {% endhint %} ### Lien de partage Un lien de partage peut être temporaire ou permanent.

Paramétrage de la date d'expiration du lien de partage

S'il est temporaire, les utilisateurs autorisés pourront copier l'application uniquement jusqu'à la date renseignée. Après cette date, même s'ils sont autorisés, ils ne pourront pas copier le template. S'il est permanent, les utilisateurs autorisés pourront copier le template sans restriction dans le temps. ### Données partagées De la même manière que pour le [multi-environnement](/ksaar-documentation/le-multi-environnement/le-multi-environnement/mettre-en-production.md#copier-des-tables), il est possible de copier des enregistrements afin de les inclure dans le template. L'utilisateur qui recevra le template aura accès aux données incluses dans le template. Vous pouvez choisir de copier vos données depuis l'environnement de développement, production ou depuis le template précédent. Vous pouvez choisir d'inclure toutes les tables ou seulement certaines. {% hint style="danger" %} Cette fonctionnalité est dédiée à la copie de données métier, c'est à dire, celles qui sont utiles au fonctionnement de l'application. Sans toute votre vigilance, des données personnelles peuvent se trouver dans un template accessible à un large public. {% endhint %}

Paramétrage des données associées

### 🚧 Tutoriel : Comment générer un template ? 1️⃣ Allez sur la version que vous voulez partager, choisissez "générer un template" (ou "mettre à jour le template" si l'application en possède déjà un) 2️⃣ Choisissez le nom et la description du template 3️⃣ Choisissez les paramètres d'accès : si le lien est public ou non et quels comptes maker sont autorisés si le lien est privé 4️⃣ Choisissez les paramètres d'expiration du lien : si le lien est permanent ou non et une date d'expiration s'il ne l'est pas 5️⃣ Choisissez les tables que vous allez inclure dans le template, il est aussi possible de choisir depuis quel environnement proviennent les enregistrements

Procédé de mise à jour ou génération d'un template

## Les paramètres de template ### Copie du lien de partage Le lien de partage est disponible dans la pastille d'environnement seulement lorsque vous êtes sur l'environnement de template.

Lien de partage dans la pastille d'environnement

### Modifier les paramètres

Barre des paramètres du template

Dans les paramètres, il est possible de modifier l'accessibilité ainsi que l'expiration du template. ## L'import de template {% hint style="info" %} Chaque import de template est une action indépendante. Importer plusieurs fois un template d’application entraînera la création de plusieurs applications indépendantes. {% endhint %} ### 🚧 Tutoriel : Comment importer un template ? 1️⃣ Authentifiez-vous sur Ksaar 2️⃣ Copiez-collez le lien de partage du template dans votre navigateur. 3️⃣ Choisissez le nom et le nom de domaine de votre nouvelle application 4️⃣ Vous recevrez un mail lorsque l'application est prête à être utilisée, la durée d'attente est proportionnelle à la taille de l'application

Procédé d'import d'une application

--- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://ksaar.gitbook.io/ksaar-documentation/le-multi-environnement/les-templates.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.