A seção oslcRecordConfig mapeia campos de registro específicos do ClearQuest para propriedades específicas do OSLC. Inclua uma seção oslcRecordConfig para cada tipo de registro do ClearQuest que você usar para pré-preencher novos registros.
Por exemplo, para pré-preencher de um tipo de registro Defeito e um tipo de registro Cliente em um banco de dados 8.0.0/SAMPL, o arquivo oslc-mappings.xml deve ter duas seções 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>
Cada seção oslcRecordConfig pode ter um ou mais atributos oslcFieldMapping. Cada atributo oslcFieldMapping mapeia um único campo ClearQuest para uma propriedade do OSLC correspondente. Os mapeamentos podem ser usados para campo genérico do ClearQuest no mapeamento de propriedade do OSLC. Não há limite para o número de propriedades do OSLC que podem ser mapeadas. No entanto, as únicas propriedades do OSLC que atualmente são usadas para pré-preencher uma caixa de diálogo de criação de registro do ClearQuest são as propriedades dcterms:title e dcterms:description. No exemplo a seguir, a propriedade do OSLC dcterms:title é mapeada para o campo Título do ClearQuest, e a propriedade do OSLC dcterms:description é mapeada para o campo Descrição do ClearQuest.
<oslcRecordConfig type="cq.record:Defect@8.0.0/SAMPL">
<oslcFieldMapping name="dcterms:title" field="Headline"/>
<oslcFieldMapping name="dcterms:description" field="Description"/>
</oslcRecordConfig>
Para mapear o mesmo tipo de registro em repositórios de esquema ou em bancos de dados do usuário diferentes, você deve ter as seções oslcRecordConfig para cada repositório de esquema ou banco de dados. O exemplo a seguir mostra a configuração para diferentes repositórios de esquema e bancos de dados do usuário:
<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>
A seção oslcProjectPrefillConfig controla as propriedades do OSLC que são usadas durante a criação de novos registros. Há uma seção oslcProjectPrefillConfig para cada projeto relacionado ao qual você deseja fornecer informações pré-preenchidas. Em cada seção oslcProjectPrefillConfig, há uma ou mais seções para cada tipo de registro do ClearQuest ao qual você deseja fornecer informações pré-preenchidas.
O exemplo a seguir mostra informações pré-preenchidas para um projeto chamado RTC 4.0 Change Management. Uma seção oslcProjectPrefillConfig contém duas seções oslcRecordPrefill, uma para informações pré-preenchidas do tipo de registro Defeito e uma para o tipo de registro Cliente no banco de dados 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>
Cada seção oslcRecordPrefill pode conter até duas linhas oslcPrefillProperty. Atualmente, apenas as propriedades dcterms:title e dcterms:description são suportadas para pré-preenchimento.
O atributo supportsPrefillMarkup determina qual tipo de quebras de linha usar quando as informações são pré-preenchidas do ClearQuest para o projeto relacionado. Se o atributo supportsPrefillMarkup for configurado como TRUE, mas o projeto não suportar rich text, você poderá observar os caracteres <br/> e seus dados pré-preenchidos, em vez de quebras de linha. Se o atributo supportsPrefillMarkup for configurado como FALSE e o projeto suportar rich text, você poderá observar que todos os dados multilinhas pré-preenchidos serão exibidos em uma única linha.
Se o projeto suportar rich text, você poderá usar tags HTML com o prefixo. No exemplo a seguir, há tags inicial e final para negrito e itálico, e duas quebras de linha:
<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>
Se os mapeamentos OSLC forem configurados no arquivo cqrest.properties, apenas os mapeamentos no arquivo cqrest.properties serão usados, e nenhuma das propriedades pré-preenchidas na seção oslcProjectPrefillConfig serão usadas.
Se você precisar de mapeamentos de propriedade OSLC genéricos para chamadas GET/POST/PUT, e precisar pré-preencher formulários de registro, remova os valores do arquivo cqrest.properties e insira-os na seção oslcRecordConfig do arquivo oslc-mappings.xml. O número de propriedades do OSLC que você pode mapear nesta seção é ilimitado.