Paquets

Les Paquets vous permettent de déplacer manuellement un ou plusieurs fichiers individuels d’une Branche dans le RCV (Branche principale ou Branche secondaire) à travers le Cycle de Vie d’IKAN ALM. Pour chaque Branche dans un Projet de type "Paquets", un ou plusieurs Paquets peuvent être créés. Cela constitue la différence avec la procédure de travail originale dans une Branche d’un Projet de type "Éditions Versions", pour laquelle un processus automatisé et configurable définit quelles Révisions des fichiers doivent être extraites de la Branche principale (head) ou de la Branche secondaire (branch) du RCV et traitées durant le Cycle de Vie.

D’un point de vue logique, les Paquets sont des vues partielles ou ponctuelles d’une Branche, puisque le contenu (logique) d’un Paquet peut évoluer entre 2 constructions et peut être réutilisé plusieurs fois, dans le temps, à travers le Cycle de Vie de la Branche à laquelle il appartient.

Les Paquets sont reliés à une seule Branche et peuvent contenir de Un à Tous les fichiers de la Branche dès qu’ils ont une révision disponible dans le RCV. En outre, plusieurs Paquets d’une Branche peuvent contenir le même fichier, si possible avec une révision différente. Cependant, il n’y a pas de contrôle automatisé de développements concurrents sur un fichier entre les Paquets d’une Branche.

Tout le long du Cycle de Vie de la Branche, chaque Paquet dispose d’un numéro de Construction dédié et progresse de manière indépendante des autres Paquets.

Les paquets ne disposent pas de statuts particuliers pour gérer leur évolution. (Exemple: verrouillé). Ils peuvent seulement être cachés, si souhaité.

D’un point de vue physique, il s’agit de constituer un ensemble de fichiers à extraire du RCV pendant l’exécution d’une Requête de construction afin de les soumettre aux phases de Construction et de Balisage pour finalement réaliser le Déploiement de cet ensemble. Dans un projet de type «Édition de Versions», les règles d’extraction dans le RCV sont définies dans la Branche via le Type de Construction choisi et IKAN ALM assure automatiquement la sélection des objets. Tandis que dans un projet de type «Paquets», la sélection pour l’extraction dans le RCV, est réalisée manuellement par les utilisateurs du projet sous la forme d’un Paquet. (Voir la section Création d’un Projet de type Paquets Créer un paquet pour plus d’informations).

D’un point de vue technique, les Projets sont définis et séparés pour utiliser soit des Paquets, soit des Éditions de Versions pour leurs branches et ne peuvent pas être mixtes.

Pour des informations plus détaillées, se référer aux sections suivantes:

Créer un paquet

  1. Dans le Menu Principal, sélectionnez Paquets > Créer un Paquet.

    La fenêtre Sélectionner une Branche s’affiche.

    Desktop Packages SelectProjectStream
  2. Définissez les critères de recherche dans le panneau Rechercher des Branches.

    Si vous ne trouvez pas immédiatement la Branche dans laquelle vous voulez créer un Paquet, vous pouvez utiliser le panneau de recherche à gauche.

    Les critères de recherche suivants sont disponibles:

    Critère de recherche Description

    Nom de projet

    Sélectionnez le Projet duquel vous voulez afficher les Branches à partir d’une liste déroulante.

    Référentiel

    Sélectionnez le Référentiel de Contrôle de Version à partir d’une liste déroulante.

    Type de Projet

    Ce champ indique le Type de Projet Paquets.

    Type de Branche

    Sélectionnez le type de Branche: Branche principale ou Branche secondaire.

    Situation

    Spécifiez la situation de la Branche.

    • En construction

    • Planifié

    • En développement

    • En test

    • Stable

    • Généralement disponible

    • Figé

    • Fermé

    Verrouillée

    Indiquez si vous voulez afficher les Branches verrouillées ou non.

    Par défaut, les Branches verrouillées ainsi que les Branches non-verrouillées sont affichées.

    Montrer les Branches cachées

    Indiquez si vous voulez afficher les Branches cachées ou non.

    Par défaut, les Branches cachées ne sont pas affichées.

    La liste des éléments montrés dans la structure arborescente à gauche, sera limitée aux Branches correspondant à ces critères de recherche.

    Utilisez le bouton Réinitialiser pour nettoyer les champs de recherche.

  3. Sélectionnez la Branche requise

    Cliquez sur l’icône ExpandProjectStream pour ouvrir l’arborescence du Projet correspondant pour développer et afficher les Branches lui appartenant.

    Cochez la Branche que vous souhaitez utiliser et cliquez sur le bouton Sélectionner une Branche.

    L’écran Créer un Paquet s’affiche. Le nom de la Branche sélectionnée est automatiquement saisi. Si vous voulez sélectionner un autre Branche, cliquez sur le bouton icon SelectProjectStream à droite pour retourner à la fenêtre Sélectionner une Branche.

  4. Saisissez le nom et, optionnellement, une description pour le nouveau Paquet. Ensuite cliquez sur le bouton Créer pour confirmer la création du Paquet.

    L’écran Créer un Paquet s’affiche.

    Desktop Packages CreatePackage Create

    L’onglet Modification Fichiers de l’écran Détails du Paquet s’affiche.

    Un Paquet qui vient d’être créé est vide. Pour plus d’informations concernant l’ajout des Fichiers et des Révisions au Paquet que vous venez de créer, se référer à la section indiquée Détails du Paquet.

Aperçu des paquets

  1. Dans le Menu Principal, sélectionnez Paquets > Aperçu des Paquets.

    L’écran Aperçu des Paquets s’affiche.

    Desktop Packages PackagesOverview
  2. Utilisez les critères de recherche dans le panneau de recherche Paquets pour n’afficher que les Paquets qui vous intéressent.

    Desktop Packages PackagesOverview SearchPanel

    Les options suivantes sont disponibles:

    • Montrer/cacher les options avancées: utilisez cette option pour afficher ou masquer tous les critères de recherche disponibles.

    • Rechercher: en principe, il n’est pas nécessaire de cliquer sur l’option Rechercher. Les résultats dans l’aperçu seront automatiquement synchronisés en fonction des critères de recherche sélectionnés.

    • Réinitialiser la recherche: utilisez cette option pour supprimer tous les critères de recherche et pour afficher la liste de tous les éléments.

    • Sélectionnez un Filtre existant à partir de la liste déroulante.

    • Sauvegarder le Filtre: utilisez cette option pour sauvegarder les critères de recherche actuels pour une utilisation ultérieure.

      Pour plus d’informations concernant l’utilisation des panneaux de recherche et des Filtres, se référer aux sections Les panneaux de recherche et Définir des Filtres de recherche.

  3. En fonction de vos droits d’accès, les liens suivants peuvent être disponibles:

    view

    Afficher

    Cette option est disponible pour tous les Utilisateurs IKAN ALM. Elle permet d’afficher les informations du Paquet sélectionné et les Révisions qu’il contient.

    Afficher les paramètres d’un paquet

    edit

    Modifier

    Cette option est disponible pour les Utilisateurs IKAN ALM ayant des droits d’accès d’Utilisateur de Projet. Elle permet de modifier les informations du Paquet sélectionné et d’accéder aux Révisions de fichiers relatives au Paquets.

    Modifier la définition d’un paquet

    show / hide

    Montrer / Cacher

    Cette option est disponible pour les Utilisateurs IKAN ALM ayant des droits d’accès d’Utilisateur de Projet. Elle permet de cacher le Paquet sélectionné.

    Montrer/cacher un paquet

    history

    Historique

    Cette option est disponible pour tous les Utilisateurs IKAN ALM. Elle permet d’afficher l’historique de toutes les opérations de création, de modification ou de suppression relatives aux Fichiers d’un Paquet.

    Afficher l’historique d’un paquet

Les colonnes marquées de l’icône icon sort peuvent être rangées par ordre alphabétique (ascendant ou descendant).

Afficher les paramètres d’un paquet

  1. Dans le Menu Principal, sélectionnez Paquets > Aperçu des Paquets.

  2. Cliquez sur l’icône view Afficher dans le panneau Aperçu des Paquets.

    L’onglet Résumé s’affiche sur l’écran Détails du Paquet.

    Desktop Packages ViewPackage
  3. Vérifiez les Paramètres.

    L’écran Détails du Paquet contient 4 onglets:

    Résumé

    Cet onglet affiche l’information de base concernant le Paquet.

    Vue Fichiers

    Cet onglet affiche le contenu du Paquet.

    Modification Fichiers

    Cet onglet permet de modifier le contenu du Paquet.

    Actions du Cycle de vie

    Cet onglet affiche les actions exécutées dans le Cycle de vie.

    Ici vous pouvez également lancer les Requêtes de Niveau pour le Paquet sélectionné.

    Pour plus d’informations concernant les différents onglets, se référer à la section Détails du Paquet.

Modifier la définition d’un paquet

  1. Dans le Menu Principal, sélectionnez Paquets > Aperçu des Paquets.

  2. Pour y accéder, cliquez sur l’icône edit Modifier dans le panneau Aperçu des Paquets.

    L’onglet Modification Fichiers de l’écran Détails du Paquet s’affiche.

    Desktop Packages EditPackage

    Cet onglet permet de modifier les Révisions des Fichiers contenues dans le Paquet.

    Pour plus d’informations concernant cette procédure, se référer à la section Modification Fichiers

    Autres boutons disponibles:

    • Actualiser: pour actualiser les informations dans les panneaux d’information

    • Précédent: pour retourner à l’écran Aperçu des paquets

    Si l’option Actualisation automatique est activée, l’écran sera actualisé en fonction du délai de rafraîchissement défini dans les Paramètres Système. Actualisation automatique

  3. Cliquez sur le bouton Sauvegarder pour confirmer vos modifications.

    Autres boutons disponibles: * Supprimer: pour désélectionner toutes les Révisions des fichiers Dans le mode de recherche, tous les fichiers (et les répertoires) correspondants aux critères de recherche seront désélectionnés.

    + Notez qu’en sélectionnant en même temps le bouton Supprimer et la touche CTRL, tous les fichiers dans l’arborescence seront sélectionnés.

    • Actualiser: pour actualiser les informations dans les panneaux d’information

Montrer/cacher un paquet

En définissant un Paquet comme “caché”, par défaut, il ne sera plus affiché dans les panneaux d’aperçu. Par exemple, ses Requêtes de Niveau ne seront, par défaut, plus affichées dans les aperçus des Requêtes de Niveau.

Cela peut s’avérer très utile pour ne plus afficher d’anciens Paquets sans perdre les informations historiques (Requêtes de Niveau, …​) associées à ces Paquets.

  1. Dans le Menu Principal, sélectionnez Paquets > Aperçu des Paquets.

  2. Cliquez sur le lien hide Cacher devant le Paquet que vous voulez cacher.

    L’icône changera en show .

    Les Paquets cachés ne seront ni visibles dans les aperçus des Requêtes de Niveau, des Approbations, des Constructions et des Déploiements, ni dans l’écran Créer une Requête de niveau: Sélectionner un Niveau lors de la création d’une Requête de Niveau pour un Projet de type “Paquets”.

  3. Pour “montrer” un Paquet caché, cliquez sur le lien show Montrer.

    L’icône changera en hide .

    Un critère de sélection Montrer les Paquets cachés est disponible dans le panneau Rechercher un Paquet pour pouvoir spécifier si vous voulez afficher les Paquets cachés.

Afficher l’historique d’un paquet

  1. Dans le Menu Principal, sélectionnez Paquets > Aperçu des Paquets.

  2. Cliquez sur le lien history Historique dans le panneau _Aperçu des Paquets pour afficher l’écran Aperçu de l’Historique du Paquet_.

    Pour une description détaillée de l’Aperçu de l’Historique du Paquet, se référer à la section Enregistrement de l’historique et des événements.

    Cliquez sur le bouton Retour Aperçu des Paquets pour retourner à l’écran précédent.

Détails du Paquet

L’écran Détails du Paquet contient les informations détaillées concernant le Paquet sélectionné.

Cet écran est structuré comme suit:

  1. Indication du statut

    L’en-tête affiche le nom, l’OID et la description du Paquet sélectionné, l’indication si le Paquet est caché ou non, ainsi que les liens vers le Projet et la Branche dans lesquels le Paquet est utilisé.

  2. Des onglets contenant des informations plus détaillées

    En-dessous de l’indication du statut, plusieurs onglets sont disponibles. Chacun de ces onglets affiche des informations supplémentaires concernant les Requêtes de niveau. Par défaut, l’onglet Résumé s’affiche.

    Pour plus d’informations, consultez une des sections suivantes.

  3. Les liens "Précédent" et "Actualiser"

    • Utilisez le lien Précédent pour retourner à l’écran précédent.

    • Utilisez le lien Actualiser pour mettre à jour les informations affichées. Ce lien récupère l’onglet actuellement sélectionné, ainsi que l’information de l’en-tête.

  4. L’option Actualisation automatique

    L’option Actualisation automatique n’est utile que sur les onglets Résumé et Actions Cycle de vie.

    Pour plus d’informations concernant l’option Actualisation automatique, se référer à la section Actualisation automatique.

L’onglet "Résumé"

Les informations concernant le Paquet et les actions possibles sont réparties sur deux panneaux différents.

Desktop PackageDetails Tab Summary

Le panneau "Actions"

Desktop PackageDetails Panel Acttions

Le panneau Actions contient le lien Modifier un Paquet. Ce lien affichera une fenêtre permettant de modifier le nom et la description du Paquet.

Desktop PackageDetails Panel Acttions EditPackage

Le panneau "Info"

Desktop PackageDetails Panel Info

Ce panneau affiche les informations qui se trouvent dans l’en-tête ainsi que quelques Informations supplémentaires.

Champ Description

Branche

Ce champ contient l’identification de la Branche.

Ce nom est composé comme suit:

  • Nom du Projet

  • Type de la Branche: H (Head) pour une Branche principale ou B (Branch) pour une Branche secondaire

  • Préfixe de la Branche, optionnellement suivi du Suffixe dans le cas d’une Branche secondaire

Exemple: Webpad H_1-0

OID Paquet

Ce champ contient le numéro séquentiel d’identification du Paquet.

Nom

Ce champ contient la dénomination du Paquet.

Description

Ce champ contient la description du Paquet.

Caché

Ce champ indique si le Paquet est caché ou non.

Par défaut, un Paquet qui vient d’être créé n’est pas caché. Pour plus d’informations concernant: Cacher des Paquets, se référer à la section Montrer/cacher un paquet.

Groupe de Paquets de Construction

Si applicable, ce champ contient le Groupe de Paquets de Construction associé au Paquet. Pour plus d’informations, se référer à la section Groupes de Paquets de Construction.

Le panneau "Dernières Requêtes de niveau"

Desktop PackageDetails Panel LatestLR

Ce panneau affiche les dix dernières Requêtes de niveau exécutées pour le Paquet sélectionné. Dans cette liste, vous pouvez cliquer sur le lien OID d’une des Requêtes de niveau pour en afficher les détails. Si vous cliquez sur le Numéro de construction, l’Historique de Construction de cette Requête de niveau sera affichée.

Vue Fichiers

Desktop PackageDetails Tab ViewContents

L’onglet Vue Fichiers liste toutes les Révisions des Fichiers actuellement contenues dans le Paquet.

Les champs suivants sont disponibles:

Champ Description

Chemin

Ce champ contient le chemin du répertoire contenant le fichier.

Nom

Ce champ contient le nom de la Révision du fichier dans le Paquet.

Révision

Ce champ contient le numéro de Révision sélectionné dans le RCV pour ce fichier. Ce champ peut rester vide, signifiant que la dernière Révision du fichier est extraite au moment de la construction du Paquet.

Modification Fichiers

Desktop PackageDetails Tab EditContents

Dans cet onglet, vous pouvez modifier le contenu du Paquet sélectionné.

Les informations dans le panneau Infos des Révisions des fichiers affichent l’arborescence du Projet fournie par le RCV. Utilisez le bouton Réinitialiser pour afficher la dernière situation.

Utilisez le bouton Supprimer pour désélectionner tous les éléments dans le Paquet. Si vous cliquez sur le bouton Supprimer tout en appuyant la touche CTRL, tous les éléments dans le Paquet seront sélectionnés.

  1. Utilisez le champ Rechercher pour sélectionner des Révisions des fichiers spécifiques.

    Vous pouvez utiliser le champ de recherche pour sélectionner des Révisions de fichiers spécifiques. Vous pouvez utiliser les caractères génériques '*' and ‘?’ à toute position. Exemples de valeurs de recherche: foo.*, ou ?oo.txt ou combinés f??.*

    Desktop Packages EditPackage Search

    Pour sortir du mode de recherche et réafficher tous les fichiers et répertoires dans l’arborescence, cliquez sur l’icône delete Sortie recherche.

  2. Sélectionnez les Révisions des fichiers que vous voulez ajouter au Paquet et cliquez sur le bouton Sauvegarder.

    Les informations dans le panneau Infos des Révisions des fichiers affichent l’arborescence du Projet fournie par le RCV. Utilisez le bouton Réinitialiser pour afficher la dernière situation.

    Utilisez le bouton Supprimer pour désélectionner tous les éléments dans le Paquet. Si vous cliquez sur le bouton Supprimer tout en appuyant la touche CTRL, tous les éléments dans le Paquet seront sélectionnés.

    Des fichiers qui ont été supprimés dans le RCV sont affichés barrés dans l’arborescence.

    Au niveau des répertoires, un point d’exclamation rouge est affiché après le nom.

    Les actions suivantes sont possibles:

    • Ajouter un fichier ou un répertoire à un Paquet

      Pour sélectionner un fichier ou un répertoire, ouvrez l’arborescence du Projet correspondant en cliquant sur l’icône icon SelectRevision pour développer et afficher tous les répertoires et les fichiers lui appartenant. Cochez le(s) répertoire(s) ou le(s) fichier(s) que vous souhaitez intégrer dans le Paquet.

      Desktop Packages SelectProjectStream AddFile
    • Ajouter une Révision spécifique d’un fichier sélectionné à un Paquet

      Pour sélectionner une Révision spécifique d’un fichier, cliquez sur la flèche icon SelectRevision à droite du nom de fichier sélectionné. La fenêtre Sélectionner une Révision s’affiche. Sélectionnez la Révision requise dans la liste déroulante et cliquez sur le bouton Sélectionner. Le numéro de la Révision sera affiché à côté du fichier sélectionné.

      Desktop Packages SelectProjectStream AddRevision

      Note: Si vous ne sélectionnez pas de Révision spécifique, la dernière Révision sera utilisée au moment de la construction du Paquet.

    • Supprimer un fichier ou un répertoire d’un Paquet

      Pour supprimer un fichier ou un répertoire d’un Paquet, désélectionnez-le dans l’arborescence. Le nom sera affiché en rouge.

      Pour désélectionner tous les fichiers du Paquet en cours de création, utilisez le bouton Supprimer.

      Desktop Packages SelectProjectStream DeleteFile

      Note: Si un fichier ou un répertoire a été supprimé dans le RCV, un point d’exclamation rouge est affiché derrière le nom du fichier ou du répertoire. Le fichier supprimé est barré. Il est conseillé de supprimer le fichier ou le répertoire du Paquet afin de le synchroniser avec la situation dans le RCV.

      Desktop Packages SelectProjectStream DeletedVCRFile
    • Remplacer une Révision spécifique d’un fichier du Paquet par la dernière Révision de ce fichier

      Pour remplacer une Révision spécifique d’un fichier par la dernière Révision de ce fichier, cliquez sur la flèche icon SelectRevision à droite du numéro de Révision. La fenêtre Sélectionner une Révision s’affiche. Désélectionnez la Révision en sélectionnant la valeur vide en haut de la liste déroulante et cliquez sur le bouton Sélectionner. Le numéro de la Révision disparaîtra et le fichier sera suivi d’une flèche rouge icon deselectRevision .

      Desktop Packages SelectProjectStream DeleteRevision
    • Modifier la Révision d’un fichier du Paquet

      Pour modifier la Révision d’un fichier par une autre Révision spécifique, cliquez sur la flèche icon SelectRevision à droite du numéro de révision. La fenêtre Sélectionner une Révision s’affiche. Sélectionnez la Révision requise dans la liste déroulante et cliquez sur le bouton Sélectionner. Le nouveau numéro de révision sera affiché à côté du fichier sélectionné.

      Desktop Packages SelectProjectStream ModifyRevision

Actions du Cycle de vie

Desktop PackageDetails Tab LifecycleActions

Ce panneau affiche les dernières Requêtes de niveau pour chacun des Niveaux définis dans le Cycle de vie.

Utilisez les icônes dans la colonne "Action" pour démarrer une Requête de niveau pour un des Niveaux. Si vous cliquez sur une icône d’action, l’écran "Créer des Requêtes de niveau" s’affichera.

Pour plus d’informations concernant la création de Requêtes de niveau, se référer à la section Création de requêtes de niveau.