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 "Gestion 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.

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 «Gestion de 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
Aperçu des Paquets
Afficher les paramètres d’un Paquet
Modifier la définition d’un Paquet
Montrer/cacher un Paquet
Afficher l’historique d’un Paquet
Vue des Fichiers
Modification des Fichiers

Créer un Paquet

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

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

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 Gestion 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.
Montrer les Projets accessibles	Indiquez si vous voulez afficher les Projets pour lesquels vous avez accès ou non. Par défaut, seuls les Projets pour lesquels vous avez accès sont montrés.

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 Gestion 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.

Montrer les Projets accessibles

Indiquez si vous voulez afficher les Projets pour lesquels vous avez accès ou non.

Par défaut, seuls les Projets pour lesquels vous avez accès sont montrés.

La liste des éléments montrés dans la structure arborescente de droite se limitera aux Branches correspondant aux critères de recherche définis.

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

Sélectionnez la Branche requise

Cliquez sur l’icône 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 rempli automatiquement. Si vous voulez sélectionner une autre Branche, cliquez sur le bouton à droite pour retourner à la fenêtre Sélectionner une Branche.
Saisissez le Nom et, optionnellement, une Description, un Propriétaire et une Date de livraison cible pour le nouveau Paquet. Ensuite cliquez sur le bouton Créer pour confirmer la création du Paquet. 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

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

L’écran Aperçu des Paquets s’affiche.
Utilisez les critères de recherche dans le panneau de recherche Paquets pour n’afficher que les Paquets qui vous intéressent.

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 Panneaux de recherche et Définir des Filtres de recherche.

En fonction de vos droits d’accès, les liens/icônes suivants peuvent être disponibles:

Icône	Description
Afficher	Cette option est disponible pour les Utilisateurs IKAN ALM avec des droits d’accès d’Administrateur de Projet. Elle permet d’afficher les informations du Paquet sélectionné et les Révisions qu’il contient. Afficher les paramètres d’un Paquet
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 Paquet. Modifier la définition d’un Paquet
Montrer Cacher	Cette option est disponible pour les Utilisateurs IKAN ALM ayant des droits d’accès d’Utilisateur de Projet. Elle permet de montrer ou cacher le Paquet sélectionné. Montrer/cacher un Paquet
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

Icône

Description

Afficher

Cette option est disponible pour les Utilisateurs IKAN ALM avec des droits d’accès d’Administrateur de Projet. Elle permet d’afficher les informations du Paquet sélectionné et les Révisions qu’il contient.

Afficher les paramètres d’un Paquet

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 Paquet.

Modifier la définition d’un Paquet

Montrer

Cacher

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

Montrer/cacher un Paquet

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 peuvent être rangées par ordre alphabétique (ascendant ou descendant).

Afficher les paramètres d’un Paquet

Dans le Menu Principal, sélectionnez Paquets > Aperçu des Paquets.
Cliquez sur l’icône Afficher dans le panneau Aperçu des Paquets.

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

Vérifiez les Paramètres.

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

Onglet	Description
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 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é.

Onglet

Description

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 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

Dans le Menu Principal, sélectionnez Paquets > Aperçu des Paquets.
Pour y accéder, cliquez sur l’icône Modifier dans le panneau Aperçu des Paquets.

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

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 des 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
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 cliquant en même temps sur 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.

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

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

L’icône changera en .

Les Paquets cachés ne seront plus 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”.

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

L’icône changera en .

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

Dans le Menu Principal, sélectionnez Paquets > Aperçu des Paquets.
Cliquez sur le lien 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 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:

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é.
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.
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.
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.

Le panneau "Actions"

Le panneau Actions contient le lien Modifier un Paquet. Ce lien affichera une fenêtre permettant de modifier le Nom, la Description, le Statut, le Propriétaire et la Date de livraison cible du Paquet.

Desktop PackageDetails Panel Acttions EditPackage

Le panneau "Info"

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

Champ Description

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.
Statut	Ce champ contient le statut du Paquet. Les Status possibles sont: Actif, Gelé et Archivé. Actif: le Paquet peut être construit et délivré et son contenu (fichiers) peut être modifié. Gelé: le Paquet ne peut pas être construit et son contenu ne peut pas être modifié. Il peut encore être délivré. Archivé: le Paquet ne peut pas être construit ni délivré et son contenu ne peut pas être modifié.
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.
Propriétaire	Ce champ contient le propriétaire du Paquet.
Date de livraison cible	Ce champ contient la Date de livraison cible prévue pour le Paquet.

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.

Statut

Ce champ contient le statut du Paquet. Les Status possibles sont: Actif, Gelé et Archivé.

Actif: le Paquet peut être construit et délivré et son contenu (fichiers) peut être modifié.
Gelé: le Paquet ne peut pas être construit et son contenu ne peut pas être modifié. Il peut encore être délivré.
Archivé: le Paquet ne peut pas être construit ni délivré et son contenu ne peut pas être modifié.

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.

Propriétaire

Ce champ contient le propriétaire du Paquet.

Date de livraison cible

Ce champ contient la Date de livraison cible prévue pour le Paquet.

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

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 des Fichiers

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.

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 des Fichiers

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.

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 '*' et ‘?’ à toute position. Exemples de valeurs de recherche: foo.*, ou ?oo.txt ou combinés f??.*

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

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

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 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.

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 à 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

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

Les fichiers qui ont été supprimés du RCV, mais qui sont encore liés au Paquet, sont affichés en rouge et rayés. Les répertoires qui contiennent ces fichiers sont affichés avec un point d’exclamation rouge après leur nom. Dans ce cas, il est conseillé de retirer ces fichiers du Paquet.

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 à 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 .
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 à 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é.

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.