Implémenter des systèmes de gestion de configuration de logiciels avec le point d'extension de l'adaptateur

Utilisez le point d'extension de l'adaptateur SCM (gestion de configuration des logiciels) pour implémenter l'un des systèmes de configuration des logiciels suivants : CVS, IBM® Rational ClearCase (Base et UCM ClearCase) et IBM Rational Team Concert.

Pourquoi et quand exécuter cette tâche

Vous pouvez utiliser le point d'extension SCM pour intégrer l'interface utilisateur du système de configuration des logiciels avec le client Eclipse de Rational Asset Manager. Lorsqu'un système de configuration des logiciels gère les artefacts d'un actif que vous soumettez, un contributeur est déterminé. d'après le teamRepositoryProviderID des artefacts et les informations artifactReferenceKind enregistrées sur chaque artefact. Avant qu'un actif puisse être soumis, le contributeur détermine quels fichiers sont sortis (extraits), puis il les archive tous. Les fichiers doivent être soumis au système de configuration des logiciels afin que leurs informations de gestion puissent être enregistrées pour les besoins de traçabilité. Le contributeur crée aussi des connexions au système de configuration des logiciels pour permettre aux fichiers d'être extraits de ce système à destination de l'espace de travail Eclipse. Des options sont fournies pour permettre à l'utilisateur de sélectionner la branche à partir de laquelle l'actif a été soumis, de sélectionner les autres branches appropriées ou de créer une nouvelle branche.

Vous pouvez utiliser le point d'extension de l'adaptateur SCM pour fournir des informations de référence à propos des artefacts placés sous contrôle du système de configuration des logiciels. Ces informations source sont situées dans la section de référence des artefacts. Elles permettent aux contributeurs d'archiver les ressources dans le système de configuration des logiciels, de déterminer quelles ressources doivent être archivées, d'importer des projets Eclipse depuis le système SCM approprié et de fournir le support de décomposition en branches. Pour fournir une intégration complète avec un système de configuration des logiciels, vous devez aussi utiliser le point d'extension com.ibm.ram.rich.ui.extension.teamUIContributor.

Informations sur l'API :

Vous pouvez utiliser le point d'extension de l'adaptateur SCM pour définir plusieurs contributeurs teamContributor. Chacun doit fournir une classe qui étend com.ibm.ram.rich.core.scm.TeamContributor

Chaque contributeur doit fournir un ou plusieurs éléments artifactReferenceKind. Cet élément est attaché à chaque artefact pour identifier de quel système de configuration des logiciels il provient. Vous devez utiliser l'actif pour déterminer le teamUIContributor à utiliser pour les artefacts de cet actif. Chaque contributeur doit sélectionner un nom qualifié globalement unique pour cet attribut (par exemple, org.organisation.produit.ram.monscm) afin de ne pas interférer avec les autres contributeurs.

Chaque contributeur doit fournir un élément teamRepositoryProviderID. Cet élément identifie de manière unique le système de configuration des logiciels de la ressource concernée dans l'espace de travail. Le fournisseur de référentiel de chaque ressource peut être obtenu par un appel à la méthode org.eclipse.team.core.RepositoryProvider.getProvider(IProject). L'ID d'un fournisseur de référentiel particulier peut être obtenu par un appel à la méthode org.eclipse.team.core.RepositoryProvider.getID(). Vous devez fournir cet ID dans l'attribut repositoryProviderID de l'élément teamRepositoryProviderID.

Marquage de configuration :

<!ELEMENT extension (teamContributor+)>
<!ATTLIST extension  
 point CDATA #REQUIRED 
 id CDATA #IMPLIED
 name  CDATA#IMPLIED>

<!ELEMENT teamContributor (artifactReferenceKind+ ,teamRepositoryProviderID)>
<!ATTLIST extension
 point CDATA#REQUIRED
 id CDATA #IMPLIED
 name CDATA #REQUIRED>
  • id : L'ID de chaque contribution.
  • name : Un nom lisible de personne, identifiant chaque contribution.
  • class : La classe qui fournit des contributions à l'interaction entre Rational Asset Manager et le système de configuration des logiciels. Elle doit étendre com.ibm.ram.rich.core.scm.TeamContributor.
<!ELEMENT artifactReferenceKindEmpty>
<!ATTLIST artifactReferenceKind
kind CDATA #REQUIRED>
Cet attribut est attaché à chaque artefact pour identifier de quel système de configuration des logiciels il provient. Il est utilisé lors de la consommation de l'actif afin de déterminer quel teamUIContributor ou teamContributor utiliser pour les artefacts. Chaque contributeur doit sélectionner un nom qualifié globalement unique pour cet attribut (par exemple, org.organisation.produit.ram.monscm) afin de ne pas interférer avec les autres contributeurs.
<!ELEMENT teamRepositoryProviderID EMPTY>
<!ATTLIST teamRepositoryProviderID
repositoryProviderID CDATA #REQUIRED>
Ce code identifie le système de configuration des logiciels de la ressource concernée dans l'espace de travail. Le fournisseur de référentiel de chaque ressource peut être obtenu par un appel à la méthode org.eclipse.team.core.RepositoryProvider.getProvider(IProject). Chaque fournisseur de référentiel est identifié par un ID qui peut être obtenu par un appel à la méthode org.eclipse.team.core.RepositoryProvider.getID(). Fournissez cet ID dans l'attribut repositoryProviderID de l'élément teamRepositoryProviderID.

Exemple

<extension id="com.ibm.ram.rich.core.artifactContributor" 
 name="Core Artifact Contributor" 
 point="com.ibm.ram.rich.core.teamContributor">

<teamContributor class="com.ibm.ram.internal.rich.core.scm.ccvs.CVSArtifactContributorWrapper"
 id="com.ibm.ram.rich.core.teamContributor.cvs"
 name="CVS Team Contributor">

<artifactReferenceKind kind="CVS">

<teamRepositoryProviderID repositoryProviderID="org.eclipse.team.cvs.core.cvsnature">

</teamRepositoryProviderID>
</teamContributor>
</extension>

Commentaires