GetEntityByDbId

Description

Renvoie l'enregistrement requis (Entity) à l'aide de l'ID unique de l'enregistrement.

Utilisez cette méthode pour obtenir un enregistrement dont vous connaissez l'ID base de données. Vous pouvez obtenir l'ID base de données d'un enregistrement en appelant la méthode GetDbId de l'objet Entity correspondant.

Pour effectuer une requête sur l'enregistrement à l'aide de son ID visible au lieu de son ID base de données, utilisez la méthode GetEntity.

Remarque : Les IDBD sont propres à chaque classe d'enregistrements, uniques au sein des enregistrements avec état et uniques au sein des enregistrements sans état. In version 7.0 the limit on the number of records that can be stored increased so the range of DBIDs also increased. However, Rational ClearQuest clients earlier than version 7.0 cannot display records with database identifiers (DBIDs) higher than the former limit. Pour plus d'informations sur les ID base de données, voir Utilisation d'enregistrements.

Syntaxe

VBScript

session.GetEntityByDbId(nom_défentité, ID_bdd)

Perl

$session->GetEntityByDbId(nom_défentité, ID_bdd);
Identificateur
Description
session
Objet Session représentant la session en cours d'accès à la base de données.
nom_défentité
Chaîne qui identifie le nom du type d'enregistrement auquel l'enregistrement de votre choix appartient.
db_id
Valeur de type Long correspondant au nombre utilisé par la base de données pour identifier l'enregistrement.

ID unique de l'enregistrement (Entity).

Valeur renvoyée
Renvoie un Objet Entity correspondant à l'enregistrement requis.

Exemples

VBScript

' Sauvegardez cet ID enregistrement pour une utilisation ultérieure.
set sessionObj = GetSession
set record1 = sessionObj.GetEntity("defect", "DEF00013323")

id = record1.GetDbId

' ...
' Obtenez de nouveau l'enregistrement
set record1 = sessionObj.GetEntityByDbId("defect", id)

Perl

#Vous disposez de $entityObj, un objet Entity
#Sauvegardez la session et l'ID enregistrement pour utilisation ultérieure :
$sessionObj = $entityObj->GetSession();

$dbid = $entityObj->GetDbId();

# ...
#Plus tard, pour obtenir de nouveau l'enregistrement :
$entityObj = $sessionObj->GetEntityByDbId("defect",$dbid);

Feedback