Administration du Progiciel K

Modèle Conceptuel des Données

Vocabulaire utilisé

• Un Objet K est une entité. On peut également faire l'amalgame entre un objet et une table de données.
• Une instance correspond à un enregistrement dans une table physique.
• Une fiche s'appelle également un formulaire, un écran de saisie.

>


Depuis cette liste, vous devez créer vos objets et modifier leurs propriétés suivantes :

• Ico : Icone de Font Awesome représentant l'objet concerné.
• Nom objet : Nom court, simple et reconnaissable par les utilisateurs.
• Sans fiche : Si coché, la saisie se fera directement dans une liste (sans passer par une fiche/formulaire). Convient uniquement aux objets sans fils.
• IsVirtuel : L'objet est virtuel : un autre objet pourra ainsi hériter de l'ensemble de ses attributs
  Dans notre exemple l'objet ENTITE est virtuel tandis que les objets Fournisseurs et Etablissements héritent.
  Cela permet de partager des attributs communs tels que le nom, l'adrese, le téléphone, l'email, .... mais également des traitements.
  Afficher les données d'un objet virtuel revient à afficher toutes les instances des objets héritants.
• Hérite de : L'objet héritera de l'objet virtuel concerné. (informations, process, workflow ... )
• Père 1 : relation forte (1-1) par convention est le D1 dans les filtres/critères. Un objet virtuel peut avoir également des Pères pour ses objets héritants.
• Pos 1 : Position de l'onglet des données fils dans la fiche du Père 1.
• Statut ini : Premier état (ou statut) que prend une instance lorsque l'objet comporte un cycle de vie.
• Chrono : Dernier numéro de chrono utilisé
• Actif : Critère permettant de définir les instances qui ne seront plus proposées (dans une liste de chox) car devenues obsolètes.
• JSValid : Fonction Javascript (à mettre dans le fichier js/specifique.js) appelée pour valider une conformité spécifique de la saisie.
• Layer : Nom donné à une famille d'objets
• Duplicable : Précise à l'utilisateur qu'il peut dupliquer une fiche existante (génère un CLONE)
• Histo : Permet l'historique des modifications de chaque instance (Heure, Valeurs, Utilisateur).
• FilterUnicité : Impose un contrôle d'unicité (mono ou multi champs séparés par $).
  Exemples D2;D1|L|$D1|L| ou I|133|L|$I|134|L| ou I|191|egal ou I|391|egal $I|475|egal ou I|210|egal $D1|L|
• Axes : Définis des axes d'intérêts sur l'objet utilisés par certains outils comme la vue arborescente
• Filtercalculagrégat : Critère de condition portant sur l'instance pour effectuer le recalcul de ses aggrégats.
• Couleur : Chemin relatif vers une information de type couleur pour imposer la couleur de chaque ligne dans les listes
• Hauteur Variable : indique que la hauteur des lignes en mode liste varie en fonction du contenu
• NbCar : Nombre minimal de caractères à frapper pour commencer la recherche dans une liste déroulante
• Aide : lien URI de la page html d'aide proposée à l'utilisateur pour cet objet (=support formation)

Le click droit sur les lignes de cette liste ouvre un menu avec :

• Liste des données : Ouvrir la liste de toutes les instances de l'objet
• Importer des données : Importe des données au format excel (voir k-Import.pdf)
• Exporter des données : Exporte les données au format excel
• Administrer cet objet : Ouvre la fiche de paramétrage de l'objet
• Relation X : Permet de paramétrer la relation avec le Pere X
• Correction des données : Lance un contrôle et une correction automatique des données non viables structurellement
• Transformer en Classique : Isole les instances de cet objet dans une table physique optimisée. (à faire au délà de 10000 instances)

Dans la gestion des droits, chaque objet pourra être :

• visible ou non selon le profil de l'utilisateur
• modificable ou non selon le profil de l'utilisateur
• restreint (par un filtre) pour certains profil

Relations

Tableau de Bord > MCD -SI > Clic droit sur objet > Relation X

Chaque relation Père défini dans le MCD doit être paramétrée en utilisant un clic droit sur la ligne de l'objet Fils pour sélectionner la relation avec l'objet Père voulu.
Propriétés d'une relation forte entre deux objets :

Administration d'un objet

Tableau de Bord > MCD -SI > Clic droit sur objet > Administrer cet objet

Chaque objet sera administrable depuis cet écran :

• Informations K : Ensemble des informations de l'objet ( donnée saisie, calculée, affichée,.. )
• Process : Ensemble des actions utilisateurs possibles depuis cet objet
  
• Workflow : Liste des états/statuts possibles pour chaque instance de l'objet
• Kchart : Liste des données étudiées graphiquement
• Embed : Ensemble des améliorations visuelles à porter sur la fiche
• Sélection : Liste des pré-sélections partagées ou non par tous les utilisateurs.
• IA : Actions (javascript) à déclencher sur évènement (Sauvegarde, fermeture,création,impression...)
• IA : Comportements applicables entre cet objet et les autres

Information K

Une information K représente une zone de saisie ou de calcul qui est généralement affichée dans une fiche et/ou une liste. Elle peut être utilisée lors des recherches, des regroupements, dans un rapport, une statistique, un calcul, etc...
Chaque information est paramétrée selon les éléments suivants :

• Objet : Objet K contenant l'information.
• Libellé info : Nom court, simple et non ambigüe de l'information. c'est l'étiquette dans une fiche et le titre de la colonne dans une liste.
• Type : Type de donnée à saisir ou afficher, dans le doute utilisez Texte.
• Nature : Uniquement en complément du Type Texte, la nature permet d'influencer le mode de saisie et/ou l'affichage de l'information:
  • Compteur : zone numérique dont la valeur évolue dans le temps avec RAZ possible. Les évolutions sont préservées.
  • Relevé : zone numérique dont la valeur évolue dans le temps. Les évolutions sont préservées.
  • Couleur : La saisie attendue est une couleur conforme html
  • Combo Fixe : La saisie est un choix limité de valeurs préfixées
  • Sans Etiquette : N'affichera pas d'étiquette de ce texte
  • Régime : Permet la saisie d''un cycle de temps hebdomadaire
  • Editeur html : Zone de saisie au format HTML
  • Base de connaissance : Assistant de saisie par utilisation d'une base de connaissance (jeux de questions réponses)
  • Liste Instances : liste d'instances (stockée sous la forme id1;id2;id3) modifiable via un panier
  • Icone : Choix d'un Icone FA pour
  • Tel : Permet d'utiliser un CallTo sur cette zone en double cliquant (Voice IP)
  • Instance : Donnée stockée sous la forme IdObjet-IdInstance, permettant une liaison vers n'importe quoi (anciennement géniteur)
• Combo sur : Liste déroulante à un choix unique d'un autre objet K.
• Relation D : précise qu'il s'agit d'un Pere à afficher et potentiellement à saisir/modifier. Choisir le type Texte.
• Filtre : Filtre à appliquer sur les instances du Combo ou de la Relation D (dans le cas d'un combo Fixe c'est l'event onupdate à appeler).
  On peut mettre des variables sous la forme @chemin (ou @@chemin si ce critère n'est pas obligatoire) ex : D1|L|@D1 ou I|503|HAS|@102
• Formule : chemin relatif ou calcul, ce dernier commence par le signe =
• Validation : Expression régulière qui permet de valider la saisie.
  Dans le cas d'un numérique on peut contrôler une valeur mini ou maxi : ///@>50 si vide non autorisé ou //@<11 si vide autorisé
• PosX - PosY : Coordonnées de la position X Y en pixel de la zone
• Largeur : Largeur en Pixel de la zone
• Hauteur : Hauteur en Pixel de la zone : chaque multiple de 15 represente une ligne de saisie
• Focus : Numéro d'ordre de la tabulation (passage d'une zone à une autre avec le clavier en mode Fiche)
• Titre : L'information fait partie du Titre. En général, cette information a une Validation de saisie obligatoire.
• Pos Liste : Position de la colonne dans la liste. Laissez vide pour ne pas afficher cette information dans la liste.
• Vue : une lettre par vue, cumulable : * affichage normal, C pour Combo , P pour Panier. La vue peut être imposée en fonction du rôle (registre gridvue)
• Section : Numéro de section dans la page (uniquement si la fiche utilise l'affichage par sections ).
• Op. Pied Liste : Calcul affiché en pied de colonne : SUM AVG MIN MAX
• RGPD : La donnée est une donnée à caractère personnel soumis aux règles RGPD
• Pos. Virtuel : La donnée est affichée dans l'onglet correspondant d'un Sous Formulaire .
• Info Bulle : Texte explicatif affiché au passage de la souris
• Etiq Up : La zone de saisie est située sous l'étiquette.
• Crypté : la donnée est stockée cryptée dans la base
• Calcul stocké : Impose de stocker le résultat de la Formule pour éviter un recalcul à chaque affichage, filtrage, traitement.
• Attributs : si nature Fixe : précise les choix fixes possibles séparés par un point virgule : Libellé 1|Valeur 1;Libellé 2|Valeur2;...
  si nature Liste Instance : précise l'objet source des instances et (en option) le filtre à appliquer séparés par un double point : Objet:Filtre
  sinon précise des évenements ou style à appliquer sur la zone (séparés par [|]) : onchange,alert('Bravo !')[|]style.color,red[|]style.font-size,15px
• Format : Format spécifique d'affichage de l'information.
  Dans le cas d'un type URI, il peut contenir un sous répertoire spécifique de stockage composé d'une partie fixe et d'un chemin exemple : Client:D1#ID
• Couleur : Couleur de fond de la colonne dans les listes.
• Valeur Auto : Valeur automatique (généralement non modifiable).
  • Pour la date d'échéance à partir d'un objet Conditions (NbJours+finDeMois+LeJour) : EDATE;IdInfoDateDépart;IdComboObjetConditions;IdInfoNbJours;IdInfoFinDeMois;IdInfoLeJour;FormatDate ex:EDATE;301;882;1211;1212;1213;dd/MM/yyy
  • Pour une valeur aléatoire fait de paquets de NbCar séparés par un tiret :RANDOM;NbPaquet;NbCarInPaquet ex:RANDOM;2;3
  • Pour une date à X jours de la date du jour :NOW ex:NOW;+30
  • Dernière date de consultation :LASTSEE
  • Dernière date de modification :LASTCHANGE
  • Dernier utilisateur ayant modifié:USERCHANGE
  • Utilisateur créateur de l'instance :USER
  • Date de création de l'instance :DATE
  • Pour le prochain chrono de l'objet :CHRONO
  • Pour le prochain chrono mensuel de l'objet :CHRONORAZMM
  • Pour une clef composée du type F2002-1234 : F;YY;MM;-;CHRONO
  • Jour de création de l'instance :DD
  • Mois de création de l'instance :MM
  • Année de création de l'instance :YY
  • Année complète de création de l'instance :YYYY
• Par défaut : Valeur par défaut de la donnée lors de sa création. Pour initialisez un combo ou une relation D, utilisez l'ID de l'instance.
  • Pour la valeur d'une clef du fichier web.config : config;clef
  • Pour la valeur du Père (depuis onglet fils) : peredata
  • Pour la valeur à partir d'un chemin dépendant du Père : *IdObjetPere#CheminAsuivre*autreIdObjetPere#autreCheminAsuivre
  • Pour une valeur imposée : asit;Valeur
  • Pour obtenir une valeur réservée par mot clef: eval;MotClef avec comme MotClef possibles : now,time,year,lastyear,month,user,moi,ressource
  • Pour une valeur d'un Combo FixeValeur|Libellé
• Recalcul père : Précise les objets pères dont les agrégats stockés doivent être recalculés en cas de modification
• Champ : Nom du champ physique dans la table de stockage (si Objet classique)

Dans la gestion des Droits, chaque information peut, en fonction du profil de l'utilisateur, être

• visible ou non avec ou sans critère
• modificable ou non avec ou sans critère
• obligatoire ou non
• filtrée (pour un combo) en fonction d'une autre information

Les process

Fiche Objet > Onglet Process

Les process sont liés à un objet (virtuel ou non). Il servent à lancer un traitement ou une fonction javascript. C'est généralement le cas d'une impression.

Les chemins relatifs

La métabase descriptive du MCD permet d'utiliser des chemins relatifs dans les requêtes, recherches, exports, calculs, dons,...
Un chemin relatif permet d'accéder aux pères Durables (relation 1-1) ainsi qu'aux données Combo (relation 0-1).
Par convention pour atteindre la valeur d'une information relative on utilise DX#IdInfo (X est le numéro du Père) pour l'un et R#IdInfo pour l'autre Dans la programmation, la méthode GetView utilise un chemin relatif par colonne à retourner séparés par [ET].
.GetView("ID[ET]I|984[ET]I|978[ET]I|979[ET]D2#ID[ET]D3#763[ET]D3#532[ET]D2;D1#490[ET]D2;D1;D1#637"

Les Filtres - Critères

Pour définir un filtre (ou un critère), il faut un chemin, un comparateur et une valeur séparés par un pipe |.
Les comparateurs possibles sont : [inf ],[infe],[sup ],[supe],[diff],[egal],[like].
Le comparateur L est utilisé pour une appartenance à une liste d'ID tandis que NOTL sera utilisé pour obtenir ceux qui ne sont pas dans la liste d'ID
Le comparateur HAS est utilisé pour tester si une donnée de type listeinst contient un code donné (HASN autorise les null) et NHAS est son inverse.
Une recherche portant sur un fils est également possible :
FILSIN|CHEMINVERSPERE$OBJET$FILTRE* // si plusieurs arguments dans le filtre, les séparer par le signe [+]

Vous pouvez utiliser l'écran de recherche pour générer et obtenir la syntaxe d'un Filtre :

Les données calculées

Une donnée calculée est une formule qui peut utiliser un chemin relatif, des données propres ou de ses fils ou encore des fonctions SQL
Par convention on place entre crochet les chemins, les Fonctions F: (SUM, COUNT, MIN, MAX), les valeurs d'Historique H:
Le double signe == signifie que la formule ne contient que des membres physiquement sur le même objet (sans chemin ni groupement... )

Cycle de vie = Workflow

Lorsque les instances d'un objet suivent un cycle de vie déterminé par les modes opératoires en place au sein de l'entreprise ou bien si les instances ont un statut/état qui détermine leur couleur et comportement, on utilisera le workflow.

• Libellé : libellé du statut/état
• Visible : indique si les instances ayant ce statut sont visibles ou non.
• Modifiable : indique si les instances ayant ce statut sont modifiables ou non.
• Supprimable : indique si les instances ayant ce statut sont supprimables ou non.
• Couleur : couleur de la ligne dans les listes
• OnEnter : Mot clef pour exécuter du code spécifique coté serveur
• Ordre : Ordre d'affichage dans la liste de choix

Il est possible de préciser les transitions autorisées entre les différents statuts/états.
Chaque transition peut faire l'objet d'une condition (commencant par *), d'un message spécfique si la condition n'est pas remplie.
On peut paramétrer le passage automatique (condition ne commencant pas par *) d'une transition selon un délai en jours.

Les analyses graphiques

Consultez le document Kchart.pdf

Embed : Les éléments additionnels

Dans un écran, on peut intégrer des éléments pour des raisons visuelles, pratiques, rapides pour traiter certaines informations de l'objet.
L'embed s'active majoritairement lorsque que la fiche est enregistrée.

• Titre : Titre de l'élément.
• Objet : Objet K à impacter.
• Type : voir tableau ci dessous
• Vue : Seules les fiches/listes ayant cette vue seront concernées.
• Critères : Seules les instances répondant à ce critère seront impactées.
• Langue : Seuls les utilisateurs utilisant cette langue seront concernés.
• Rôles : Seuls les utilisateurs connectés avec ce profil seront concernés.

Chaque type d'embed utilise ou non les 5 paramètres possibles.

Pré-sélections

L'administrateur peut définir des pré-sélections pour l'ensemble des utilisateurs dans le but de faciliter leurs recherches récurrentes.

IA: Comportement entre objets

Trigger: déclencheur (de javascript) sur évènement

Nom : libellé libre
Concerne : Objet (ou objet hérité) sur lequel le trigger est déclenché
Condition : Filtre optionnel (sur l'objet concerné) de déclenchement
Actions : appel javascript (sauf exception ci dessous*), IDFICHE est remplacé par l'ID de l'instance modifiée.
exemple: Wait('qc_closeservice&IdService=IDFICHE')

Rapports, états, PDF, email,

Outil Kmails, client messagerie

L'outil Kmail permet la création, la prévisualisation, l'envoi et l'historisation d'emails (ou de courriers) échangés.
Le message est un rapport et peut donc contenir des champs de fusion, sous rapport, etc...
L'emetteur From est un email
Le destinataire To est de type multi-instance dont l'objet contient une info de type email (paramétrer Attribut)
Le destinataire en Copie Carbone CC est de type multi-instance dont l'objet contient une info de type email (paramétrer Attribut)
Les Pièces jointes PJ est de type multi-instance dont l'objet contient une info de type uri (généralement l'objet Document Ged) (paramétrer Attribut)
Chaque instance de Kmail est liée à une instance souvent le Client (paramétrer D1)
Les info de l'objet Kmail ne sont pas modifiés par les mises à jour Kupdate

Registre

Role : si non vide, ce registre ne concerne que ce role. Utilisateur : Si non vide, ce registre ne concerne que cet utilisateur.