Importer des ressources

Kentika permet simplement d'importer des ressources. En grande partie, cela fonctionne comme les imports au format Kentika. Une particularité concerne les ressources "personnalisables". Cette page a pour vocation d'expliquer ceci.

Ressources personnalisables

La société Kentika fournit un ensemble de ressources dites "génériques", qui ne doivent pas être modifiées afin de permettre les mises-à-jour simples de ces ressources. Lorsque le besoin de dériver une ressource se présente, dans la plupart des cas, il faut passer par des composants.

Il existe également des ressources qui doivent régulièrement être personnalisées et qui sont donc présentes dans les nouvelles bases, mais qui ne sont pas écrasées lors des mises-à-jour.

Pour ce qui est décrit sur cette page, une ressource personnalisable est donc soit une ressource générique personnalisable, soit un composant dérivé.

Une ressource personnalisable se reconnaît parce-qu'elle contient le texte "[custom]" dans son commentaire :

Le commentaire du script "InitPage"

Le commentaire de l'AWEB "PrintRecord_Content"

Pour simplifier, on peut dire qu'une ressource personnalisable vous appartient (vous pouvez ne faire ce que vous voulez), tandis qu'une ressource non personnalisable appartient à la société Kentika (nous ne garantissons pas que vous conserverez vos changements en cas de mise-à-jour).

À l'import

Lors de l'import de ces ressources, les ressources personnalisables qui sont dans le fichier importé ont un comportement spécial au clic sur "Annule et Remplace" : Elle ne s'importeront pas.

J'ai beau cliquer sur Annule et Remplace, on voit que seule la ressource File (qui n'est pas personnalisable) sera remplacée. L'autre sera ignorée, et ne sera donc pas écrasée.

Ceci ne concerne que le bouton "Annule et Remplace". Si la ressource n'existe pas dans votre base, elle sera créée si vous cliquez sur "Créer".

Si vous souhaitez écraser votre ressource personnalisable (parce-que vous souhaitez revenir à la ressource par défaut, ou parce-que Kentika vous a envoyé une nouvelle version d'un de vos composants dérivés, par exemple), il faut maintenir la touche MAJ lorsque vous cliquez sur "Annule et Remplace" :

Avec MAJ, j'arrive cette fois à faire remplacer ma ressource. Je n'ai plus qu'à valider pour écraser définitivement les deux ressources qui étaient dans ma base avec celles qui se trouve dans le fichier importé.

Attention : Il s'agit bien de la touche MAJUSCULE (ou SHIFT, en anglais), et non de la touche VERROU MAJ (qui se trouve juste au dessus).

Du coup, MAJ ou pas MAJ ?

Il est difficile de définir des règles précises. Posez-vous la question : "Est-ce-que ce que j'importe est une mise-à-jour de mes ressources personnalisées ?" (Auquel cas il faut maintenir MAJ.) "Ou est-ce-que j'importe un fichier dans lequel se trouvent des ressources qui ne contiendront pas mes personnalisations ?" (Auquel cas il ne faut pas maintenir MAJ, ou alors le faire ressource par ressource si vous voulez n'en récupérer que certaines.)

Normalement, si c'est l'équipe Kentika qui vous envoie des ressources, elle vous précisera l'action à effectuer. En cas de doute, il est préférable de ne pas maintenir MAJ. Ainsi, vous n'écraserez pas les ressources personnalisables, et vous pourrez ré-importer le fichier en maintenant MAJ s'il s'avère que c'était le bon choix.

Lorsque vous importez un kit Atomic (dans le cadre d'une mise-à-jour en autonomie, par exemple), il est alors très important de ne surtout pas maintenir MAJ.

Évidemment, si votre fichier ne contient pas de ressources personnalisables, pas la peine d'appuyer sur MAJ ! De même si votre fichier ne contient que des ressources nouvelles, non encore présentes dans votre base, puisque MAJ ne s'applique qu'au bouton "Annule et Remplace" et non au bouton "Créer"