Chapter 9 Accès aux objets via VBScript


Manipulation du Référentiel à l'aide de VBScript

PowerAMC vous permet d'accéder aux fonctionnalités du Référentiel via VBScript en utilisant la propriété globale RepositoryConnection as BaseObject.

Elle vous permet de récupérer la connexion courante du référentiel qui est l'objet qui gère la connexion au serveur du référentiel et qui permet d'accéder aux documents et objets stockés sous le référentiel.

La propriété RepositoryConnection est équivalente au noeud racine dans l'explorateur du Référentiel.

Vous pouvez accéder aux documents du référentiel mais vous ne pouvez pas accéder aux objets d'administration du référentiel, tels que les utilisateurs, les groupes, les configurations, les branches, et les listes de verrous.

De plus, seule la dernière version d'un document de référentiel est accessible à l'aide de VBScript.

Les principales actions que vous pouvez effectuer sont les suivantes :

Connexion à la base du référentiel

Pour récupérer la connexion courante au référentiel :

Utiliser Description
RepositoryConnection As Object Propriété globale qui gère la connexion à la base du référentiel

Pour effectuer une connexion à la base du référentiel :

Utiliser Description
Open(ByVal RepDef As String = "", ByVal User As String = "", ByVal Pass As String = "", ByVal DBUser As String = "", ByVal DBPass As String = "") As Boolean Méthode sur la propriété RepositoryConnection qui permet d'établir une connexion au référentiel

Pour effectuer une déconnexion du référentiel :

Utiliser Description
Close() Méthode sur la propriété RepositoryConnection qui permet d'interrompre la connexion à la base du référentiel

Accès aux documents du référentiel

Pour parcourir un document :

Utiliser Description
ChildObjects As ObjectCol Collection sur la classe StoredObject qui gère l'accès aux documents du référentiel

Pour mettre à jour un document :

Utiliser Description
Refresh() Méthode sur la propriété RepositoryConnection qui permet de visualiser les nouveaux documents, mettre à jour les versions des documents existants ou de dissimuler les documents supprimés

Pour rechercher un document :

Utiliser Description
FindInRepository() As Object Méthode sur la classe BaseModel qui permet de vérifier si un modèle a déjà été consolidé

Extraction de documents de référentiel

Pour extraire tout type de document :

Utiliser Description
ExtractToFile(ByVal FileName As String, ByVal MergeMode As Long = 2, ByVal OpenMode As Boolean = -1, ByRef Actions As String = NULL, ByRef Conflicts As String = NULL) As Object Méthode sur la classe RepositoryModel qui permet d'extraire tout type de document

Pour extraire un document PowerAMC :

Utiliser Description
UpdateFromRepository(ByVal MergeMode As Integer = 2, ByRef actions As String = NULL, ByRef conflicts As String = NULL) As Boolean Méthode sur la classe BaseModel qui permet d'extraire des documents PowerAMC

Consolidation de documents de référentiel

Pour consolider tout type de document :

Utiliser Description
ConsolidateDocument(ByVal FileName As String, ByVal MergeMode As Long = 2, ByRef Actions As String = NULL, ByRef Conflicts As String = NULL) As Object Méthode sur la classe RepositoryFolder qui permet de consolider tout type de document

Pour consolider un document PowerAMC :

Utiliser Description
ConsolidateNew(ByVal RepositoryFolder As Object, ByRef actions As String = NULL, ByRef conflicts As String = NULL) As Object Méthode sur la classe BaseModel qui permet de consolider des documents PowerAMC
Consolidate(ByVal MergeMode As Integer = 2, ByRef actions As String = NULL, ByRef conflicts As String = NULL) As Object Méthode sur la classe BaseModel qui permet de consolider des versions de référentiel supplémentaires d'un document PowerAMC

Gestion de version de documents

Pour geler et dégeler une version de document :

Utiliser Description
Freeze(ByVal Comment As String = "") As Boolean Méthode sur la classe RepositoryDocumentBase qui permet de créer une version archivée d'un document
Unfreeze() As Boolean Méthode sur la classe RepositoryDocumentBase qui permet de modifier la version courante dans le référentiel pour refléter les changements effectués sur votre machine en local

Pour verrouiller et déverrouiller une version de document :

Utiliser Description
Lock(ByVal Comment As String = "") As Boolean Méthode sur la classe RepositoryDocumentBase qui permet d'empêcher d'autres utilisateurs de mettre à jour une version consolidée
Unlock() As Boolean Méthode sur la classe RepositoryDocumentBase qui permet à d'autres utilisateurs de mettre à jour une version consolidée

Pour supprimer un document :

Utiliser Description
DeleteVersion() As Boolean Méthode sur la classe RepositoryDocumentBase qui permet de supprimer une version de document

Gestion de l'explorateur du référentiel

Pour créer un dossier :

Utiliser Description
CreateFolder(ByVal FolderName As String) As Object Méthode sur la classe RepositoryFolder qui permet de créer un nouveau dossier dans l'explorateur du référentiel

Pour supprimer un dossier vide :

Utiliser Description
DeleteEmptyFolder() As Boolean Méthode sur la classe RepositoryFolder qui permet de supprimer un dossier vide dans l'explorateur du référentiel

Pour plus d'informations sur les documents, reportez-vous à la section "Accès aux documents du référentiel".

 


Copyright (C) 2005. Sybase Inc. All rights reserved.