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

Utilisez le point d'extension de l'adaptateur de l'interface utilisateur 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 de l'interface utilisateur 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 de l'interface utilisateur SCM pour définir des décorations et des propriétés pour les artefacts, déterminer les branches disponibles pour l'importation d'un actif et pour permettre aux utilisateurs de créer des connexions avec des référentiels de configuration des logiciels respectifs.

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.core.teamContributor. Pour plus d'informations sur l'utilisation du point d'extension com.ibm.ram.rich.core.teamContributor, reportez-vous à Utiliser le point d'extension de l'adaptateur du système de configuration des logiciels.

Informations sur l'API :

Vous pouvez utiliser le point d'extension de l'adaptateur de l'interface utilisateur SCM pour définir plusieurs contributeurs teamUIContributor. Chacun doit fournir une classe qui étend com.ibm.ram.rich.ui.scm.TeamUIContributor.

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. Un fournisseur de référentiel 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 (teamUIContributor+)>
<!ATTLIST extension  
 point CDATA #REQUIRED 
 id CDATA #IMPLIED
 name  CDATA#IMPLIED>

<!ELEMENT teamUIContributor (artifactReferenceKind+ ,teamRepositoryProviderID)>
<!ATTLIST extension
 point CDATA#REQUIRED
 id CDATA #IMPLIED
 name CDATA #REQUIRED>
Utilisez le point d'extension suivant pour contribuer à l'interface utilisateur en fournissant vos propres artefacts :
<!ELEMENT artifactReferenceKindEmpty>
<!ATTLIST artifactReferenceKind
kind CDATA #REQUIRED>
L'attribut suivant est attaché à chaque artefact pour identifier de quel système de configuration des logiciels il provient. Utilisez-le 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). 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.

Exemple

<extension id="com.ibm.ram.rich.ui.teamUIContributor" 
 name="Team UI Contributor" 
 point="com.ibm.ram.rich.ui.extension.teamUIContributor">

<teamUIContributor class="com.ibm.ram.internal.rich.ui.scm.CVSArtifactUIContributorWrapper"
 id="com.ibm.ram.rich.core.teamContributor.cvs"
 name="Team UI Contributor">

<artifactReferenceKind kind="CVS">

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

</teamRepositoryProviderID>
</teamUIContributor>
</extension>

Commentaires