Fonctions préprogrammées de la métadonnée Menu

Karuta offre plusieurs fonctions préprogrammées qui peuvent être utilisées dans la métadonnée Menu.

Get_Multiple

Permet à l'utilisateur de sélectionner plusieurs éléments parmi une liste. Pour chaque élément sélectionné, une composante réutilisable est importée dans le portfolio. Un élément de cette composante est alors mis à jour avec le code et le libellé de l'élément sélectionné (en général un élément Page, Sous-section ou Get_Resource – dans le cas d'un Get-Resource, c'est la resource qui est mise à jour).

La liste d'éléments doit exister dans un portfolio référentiel. Tous les éléments affichés dans une liste doivent partager le même tag sémantique et chacun doit avoir un code unique.

Pour que l'utilisateur puisse exécuter cette opération, il doit avoir le droit de Modifier le nœud ou Modifier la ressource sur la composante mise à jour (nœud si la composante mise à jour est une Page ou une Sous-section, ressource si c'est un Get_Resource).

ASTUCE : Afin que l'utilisateur ne puisse pas modifier directement le nœud ou la ressource après l'import, cocher la métadonnée Nœud sans crayon ou Ressource sans crayon.

Format

function,get_multiple/recherche/code_portfolio.tag_sémantique/tag_sémantique,libellé@fr,rôles

  • function Mot réservé.
  • get_multiple Mot réservé.
  • recherche Recherche du Get_Resource équivalent (voir section MÉTADONNÉES pour plus de détails).
  • code_portfolio.tag_sémantique Composante réutilisable à importer.
  • tag_sémantique Tag sémantique de l'élément de la composante à mettre à jour avec le code et le libellé sélectionné.
  • libellé Libellé du bouton pour la boîte de choix. Suffixer de @fr pour français.
  • rôles Liste des rôles, séparés par un espace, ayant le bouton pour la boîte de choix.

Get_Get_Multiple

Équivalent à la fonction précédente, sauf que les choix aux utilisateurs sont restreints par la sélection dans un élément parent. Il s'agit du même principe que pour l'élément Get_Get_Resource (voir section RESSOURCES pour plus de détails).

Format

function,get_get_multiple/recherche/code_portfolio.tag_sémantique/tag_sémantique,libellé@fr,rôles

  • function Mot réservé.
  • get_get_multiple Mot réservé.
  • recherche Recherche du Get_Get_Resource équivalent (voir section MÉTADONNÉES pour plus de détails).
  • code_portfolio.tag_sémantique Composante réutilisable à importer.
  • tag_sémantique Tag sémantique de l'élément de la composante à mettre à jour avec le code et le libellé sélectionné.
  • libellé Libellé du bouton pour la boîte de choix. Suffixer de @fr pour français.
  • rôles Liste des rôles, séparés par un espace, ayant le bouton pour la boîte de choix.

Import_Multiple

Permet à l'utilisateur de sélectionner plusieurs éléments parmi une liste. Pour chaque élément sélectionné, un élément est importé dans le portfolio.

La liste d'éléments doit exister dans un portfolio référentiel et chaque élément doit avoir un code unique ; dans le cas d'éléments Items, il faut répéter le Code - Item dans le champ Code du nœud.

Les éléments importés peuvent être directement ceux du portfolio référentiel (éléments Items ou Sous-section) ou peuvent être copiés d'un portfolio tiers. Dans ce dernier cas, les éléments importés sont ceux qui ont le même code que ceux cochés dans la liste. Les éléments du portfolio tiers doivent donc avoir les mêmes codes que ceux du portfolio référentiel.

Format

function,import_multiple/recherche/code_portfolio,libellé@fr,rôles

  • function Mot réservé.
  • import_multiple Mot réservé.
  • recherche Recherche du Get_Resource équivalent (voir section MÉTADONNÉES pour plus de détails). Retourne une liste de codes.
  • code_portfolio Code du portfolio duquel on importe les noeuds qui ont les codes sélectionnés. Peut être ou pas le même que celui de la recherche.
  • libellé Libellé du bouton pour la boîte de choix. Suffixer de @fr pour français.
  • rôles Liste des rôles, séparés par un espace, ayant le bouton pour la boîte de choix.

Option ?.tag_sémantique
Peut remplacer code_portfolio. Dans ce cas le code du portfolio sera le code de l'élément coché et le tag sémantique de l'élément importé sera tag_sémantique. Ceci permet d'importer des éléments de plusieurs portfolios différents. Par exemple, l'utilisateur peut sélectionner plusieurs référentiels parmi une liste, puis importer les compétences de ces référentiels qui ont le tag sémantique dans son portfolio.

Import_GGMultiple

Équivalent à la fonction précédente, sauf que les choix aux utilisateurs sont restreints par la sélection dans un élément parent. Il s'agit du même principe que pour l'élément Get_Get_Resource (voir section RESSOURCES.

Format

function,import_ggmultiple/recherche/code_portfolio,libellé@fr,rôles

  • function Mot réservé.
  • import_ggmultiple Mot réservé.
  • recherche Recherche du Get_Get_Resource équivalent (voir section MÉTADONNÉES pour plus de détails).
  • code_portfolio Code du portfolio duquel on importe les noeuds qui ont les codes sélectionnés. Peut être ou pas le même que celui de la recherche.
  • libellé Libellé du bouton pour la boîte de choix. Suffixer de @fr pour français.
  • rôles Liste des rôles, séparés par un espace, ayant le bouton pour la boîte de choix.

OPTION ? dans la recherche
Peut remplacer le code du portfolio dans la recherche. Dans ce cas le code du portfolio de recherche sera le code de l'élément parent.

OPTION ?
Peut remplacer code_portfolio. Dans ce cas le code du portfolio d'importation sera le code de l'élément parent trouvé.

Exemple d'utilisation

Un élément Get-Resource permet de sélectionner un référentiel parmi une liste de référentiels (le code de l'élément Item doit alors être le code du portfolio du référentiel correspondant). La fonction Import_GGMultiple permet d'importer des éléments du référentiel sélectionné dans l'élément Get_Resource.

Menu
function,import_ggmultiple/?.child.referentiel.skill$.label/?,Ajouter une compétence@fr,auteur

Remarque
Ce menu se trouve sur un élément Sous-section qui contient l'élément Get_Resource (d'où l'utiliation du mot résevé child). referentiel est à la fois le tag sémantique de l'élément Get_Resource et le tag sémantique des éléments Item de la liste de référentiels. Chaque élément Item a pour code le code du portfolio référentiel correspondant. Les deux ? font référence à ce code de portfolio référentiel.

Proxy_Multiple

Permet à l'utilisateur de sélectionner plusieurs éléments à partir d'une liste. Pour chaque sélection un élément Proxy est importé et sa cible est mise à jour avec la sélection. L'élément Proxy doit exister dans le portfolio de composantes réutilisables.

Cette fonction donne l'équivalent d'un Import_Multiple mais au lieu d'importer l'élément sélectionné dans le portfolio, c'est un élément Proxy qui est importé puis mis à jour pour pointer sur l'élément sélectionné.

Pour que l'utilisateur puisse exécuter cette opération, il doit avoir le droit de Modifier la ressource sur la composante mise à jour (l'élément Proxy).

Format

function,proxy_multiple/recherche/code_portfolio.tag_sémantique/tag_sémantique,libellé@fr,rôles

  • function Mot réservé.
  • proxy_multiple Mot réservé.
    • recherche Recherche du Get_Resource équivalent (voir section MÉTADONNÉES pour plus de détails). Retourne une liste de codes.
  • code_portfolio.tag_sémantique Élément Proxy à importer.
  • tag_sémantique Élément Proxy à mettre à jour.
  • libellé Libellé du bouton pour la boîte de choix. Suffixer de @fr pour français.
  • rôles Liste des rôles, séparés par un espace, ayant le bouton pour la boîte de choix.

ImportAndSetDateToday

Permet de dater le moment où un élément est ajouté au portfolio par l'utilisateur. Lorsque l'utilisateur clique sur le menu, une composante réutilisable est importée dans le portfolio et un élément Calendrier de cette composante est mis à jour avec la date courante du système.

Pour que l'utilisateur puisse exécuter cette opération, il doit avoir le droit de Modifier la ressource sur la composante mise à jour (l'élément Calendrier).

ASTUCE : Afin que l'utilisateur ne puisse pas modifier directement la ressource après l'import, cocher la métadonnée Ressource sans crayon.

Format

function,importAndSetDateToday/code_portfolio/tag_sémantique_composante/tag_sémantique_calendrier,libellé@fr,rôles

  • function Mot réservé.
  • importAndSetDateToday Mot réservé.
  • code_portfolio Code du portfolio de composantes réutilisables où se trouve la composante à importer.
  • tag_sémantique_composante Composante réutilisable à importer.
  • tag_sémantique_calendrier Élément Calendrier à mettre à jour avec la date courante.
  • libellé Libellé du bouton pour l'élément de menu. Suffixer de @fr pour français.
  • rôles Liste des rôles, séparés par un espace, ayant l'élément de menu.

MoveTO

Permet de créer un bouton pour que l'utilisateur bascule un élément de son portfolio entre deux endroits prédéterminés. À chaque exécution, la destination et le point de départ sont inversés.

Format

function,moveTO/destination/départ,libellé@fr,rôles

  • function Mot réservé.
  • moveTO Mot réservé.
  • destination Tag sémantique de la Section, Page ou Sous-section de destination.
  • départ Tag sémantique de la Section, Page ou Sous-section du point de départ.
  • libellé Libellé du bouton pour la bascule. Suffixer de @fr pour français.
  • rôles Liste des rôles, séparés par un espace, ayant le bouton.

ExecReport_BatchCSV

Exécute un script de rapport sur les données du portfolio courant, construit avec les données résultantes un fichier CSV temporaire, puis fournit ce fichier en entrée à un script de batch.

Cette fonction permet de créer un portfolio de gestion de cohorte pour un utilisateur qui doit effectuer certaines opérations d'administration bien déterminées sans avoir tous les droits d'un designer (par exemple créer des comptes utilisateur et des instances de portfolio).

Pour ce faire, le script de rapport, au lieu de faire de l'affichage à l'écran, doit écrire dans un fichier CSV. Ceci est permis par les éléments Ligne CSV et Valeur CSV (voir la section Commandes CSV de la section Rapport pour plus de détails.)

NOTE : Le fichier CSV n'est pas conservé.

Format

function,execReport_BatchCSV/code_rapport,libellé@fr,rôles

  • function Mot réservé.
  • execReport_BatchCSV Mot réservé.
  • code_rapport Code du portfolio script de rapport.
  • libellé Libellé du bouton pour lancer l'exécution. Suffixer de @fr pour français.
  • rôles Liste des rôles, séparés par un espace, ayant le bouton.