GetEntity

Description

Renvoie l'enregistrement spécifié.

Lors d'une demande d'un type d'enregistrement basé sur l'état, le paramètre display_name doit contenir l'ID visible de l'enregistrement (par exemple, "DEF00013323"). Pour les types d'enregistrement sans état, ce paramètre doit contenir la valeur de la zone de clé unique de l'enregistrement.

Pour effectuer une requête sur un enregistrement à l'aide de son ID base de données au lieu de son ID visible, voir GetEntityByDbId.

Remarque : Pour optimiser les performances, si vous souhaitez uniquement extraire certaines valeurs de zone pour un enregistrement, utilisez des requêtes au lieu d'appeler EditEntity. Vous pouvez générer une requête sur la zone State pour éviter d'obtenir l'enregistrement entier.

Syntaxe

VBScript

session.GetEntity(nom_déf_entité, nom_affiché) 

Perl

$session->GetEntity(nom_déf_entité, nom_affiché); 
Identificateur
Description
session
Objet Session représentant la session en cours d'accès à la base de données.
nom_déf_entité
Chaîne qui identifie le nom du type d'enregistrement auquel l'enregistrement appartient.
display_name
Chaîne identifiant le nom affiché de l'enregistrement. Le nom affiché doit être soit l'ID visible pour les entités de requête, soit les zones de clé unique pour les entités auxiliaires.
Return value
Renvoie un Objet Entity correspondant à l'enregistrement requis.

Exemples

VBScript

set sessionObj = GetSession 
sessionObj.UserLogon "admin", "", "SAMPL", AD_PRIVATE_SESSION, ""
set record1 = sessionObj.GetEntity("defect", "DEF00013323") 

Perl

$sessionObj = $entity->GetSession();
$sessionObj->UserLogon("admin","","SAMPL","");

#Obtenez l'enregistrement DEF00013323
$record1 = $sessionObj->GetEntity( "defect", "DEF00013323" ); 

Commentaires