La section oslcRecordConfig mappe les zones d'enregistrement ClearQuest spécifiques vers les propriétés OSLC spécifiques. Insérez une section oslcRecordConfig pour chaque type d'enregistrement ClearQuest utilisé pour préremplir les nouveaux enregistrements.
Par exemple, pour effectuer un préremplissage à la fois à partir d'un type d'enregistrement Defect et d'un type d'enregistrement Customer dans une base de données 8.0.0/SAMPL, le fichier oslc-mappings.xml doit contenir deux sections oslcRecordConfig :
<oslcRecordConfig type="cq.record:Defect@8.0.0/SAMPL">
<oslcFieldMapping name="dcterms:title" field="Headline"/>
<oslcFieldMapping name="dcterms:description" field="Description"/>
</oslcRecordConfig>
<oslcRecordConfig type="cq.record:Customer@8.0.0/SAMPL">
<oslcFieldMapping name="dcterms:title" field="Name"/>
<oslcFieldMapping name="dcterms:description" field="Description"/>
</oslcRecordConfig>
Chaque section oslcRecordConfig peut contenir un ou plusieurs attributs oslcFieldMapping. Chaque attribut oslcFieldMapping mappe une zone ClearQuest unique vers une propriété OSLC correspondante. Les mappages peuvent être utilisés pour un mappage de zone ClearQuest générique vers une propriété OSLC. Il n'y a aucune limite appliquée au nombre de propriétés OSLC que vous pouvez mapper. En revanche, les seules propriétés OSLC actuellement utilisées pour préremplir une boîte de dialogue de création d'enregistrement ClearQuest sont les propriétés dcterms:title et dcterms:description. Dans l'exemple suivant, la propriété OSLC dcterms:title est mappée vers la zone ClearQuest Headline et la propriété OSLC dcterms:description est mappée vers la zone ClearQuest Description .
<oslcRecordConfig type="cq.record:Defect@8.0.0/SAMPL">
<oslcFieldMapping name="dcterms:title" field="Headline"/>
<oslcFieldMapping name="dcterms:description" field="Description"/>
</oslcRecordConfig>
Pour mapper le même type d'enregistrement dans différents référentiels de schémas ou dans différentes bases de données utilisateur, vous devez posséder les sections oslcRecordConfig pour chaque référentiel de schémas ou base de données. L'exemple suivant présente la configuration des différents référentiels de schémas et des différentes bases de données utilisateur :
<oslcRecordConfig type="cq.record:Defect@8.0.0/SAMPL">
<oslcFieldMapping name="dcterms:title" field="Headline"/>
<oslcFieldMapping name="dcterms:description" field="Description"/>
</oslcRecordConfig>
<oslcRecordConfig type="cq.record:Defect@7.0.0/TEST">
<oslcFieldMapping name="dcterms:title" field="id"/>
<oslcFieldMapping name="dcterms:description" field="Headline"/>
</oslcRecordConfig>
<oslcRecordConfig type="cq.record:Defect@7.0.0/PROD">
<oslcFieldMapping name="dcterms:title" field="id"/>
<oslcFieldMapping name="dcterms:description" field="Headline"/>
</oslcRecordConfig>
La section oslcProjectPrefillConfig contrôle les propriétés OSLC utilisées lors de la création de nouveaux enregistrements. Il existe une seule section oslcProjectPrefillConfig pour chaque projet associé pour lequel vous souhaitez fournir des informations de préremplissage. Dans chaque section oslcProjectPrefillConfig, il existe une ou plusieurs sections pour chaque type d'enregistrement ClearQuest pour lequel vous souhaitez fournir des informations de préremplissage.
L'exemple suivant présente les informations de préremplissage d'un projet appelé RTC 4.0 Change Management. Une seule section oslcProjectPrefillConfig comprend deux sections oslcRecordPrefill, une pour les informations de préremplissage provenant du type d'enregistrement Defect et l'autre pour le type d'enregistrement Customer de la base de données 8.0.0/SAMPL.
<oslcProjectPrefillConfig
projectName="RTC 4.0 (Change Management)" supportsPrefillMarkup="true">
<oslcRecordPrefill type="cq.record:Defect@8.0.0/SAMPL">
<oslcPrefillProperty name="dcterms:title" prefix="ClearQuest Headline: "/>
<oslcPrefillProperty name="dcterms:description" prefix="Problem Description:<br/>"/>
</oslcRecordPrefill>
<oslcRecordPrefill type="cq.record:Customer@8.0.0/SAMPL">
<oslcPrefillProperty name="dcterms:title" prefix="ClearQuest Customer Name: "/>
<oslcPrefillProperty name="dcterms:description" prefix="Customer Description:<br/>"/>
</oslcRecordPrefill>
</oslcProjectPrefillConfig>
Chaque section oslcRecordPrefill peut comprendre jusqu'à deux lignes oslcPrefillProperty. Actuellement, seules les propriétés dcterms:title et dcterms:description sont prises en charge pour un préremplissage.
L'attribut supportsPrefillMarkup détermine le type de retour à la ligne à utiliser lorsque des informations sont préremplies à partir de ClearQuest dans le projet associé. Si l'attribut supportsPrefillMarkup est paramétré sur TRUE, mais que le projet ne prend pas en charge le texte enrichi, vous remarquerez les caractères <br/> dans vos données préremplies à la place des retours à la ligne. Si l'attribut supportsPrefillMarkup est paramétré sur FALSE et que le projet ne prend pas en charge le texte enrichi, vous remarquerez que toutes les données multilignes préremplies s'affichent sur une seule ligne.
Si le projet prend en charge le texte enrichi, vous pouvez utiliser les balises HTML avec le préfixe. L'exemple suivant comprend des balises de début et de fin pour les caractères en gras et italique ainsi que deux retours à la ligne :
<oslcProjectPrefillConfig
projectName="RTC 4.0 (Change Management)" supportsPrefillMarkup="true">
<oslcRecordPrefill type="cq.record:Defect@8.0.0/SAMPL">
<oslcPrefillProperty name="dcterms:title" prefix="ClearQuest Headline: "/>
<oslcPrefillProperty name="dcterms:description" prefix="<b><i>ClearQuest Description:</b></i><br/><br/>"/>
</oslcRecordPrefill>
</oslcProjectPrefillConfig>
Si les mappages OSLC sont définis dans le fichier cqrest.properties, seuls les mappages du fichier cqrest.properties sont utilisés et aucune des propriétés de préremplissage de la section oslcProjectPrefillConfig n'est utilisée.
Si vous avez besoin de mappages de propriétés OSLC pour les appels GET/POST/PUT et que vous devez effectuer un préremplissage des formulaires d'enregistrement, supprimez les valeurs du fichier cqrest.properties et saisissez-les dans la section oslcRecordConfig du fichier oslc-mappings.xml. Le nombre de propriétés OSLC que vous pouvez mapper dans cette section est illimité.