oslc-mappings.xml

El archivo de configuración oslc-mappings.xml controla la manera en que Rational ClearQuest rellena previamente los nuevos registros enlazados con OSLC 2.0.

Descripción

El archivo oslc-mappings.xml tiene dos secciones. Ambas secciones son necesarias para habilitar ClearQuest para rellenar previamente nuevos registros:
  • La sección oslcRecordConfig correlaciona los campos de registro de ClearQuest con propiedades OSLC.
  • La sección oslcProjectPrefillConfig controla las propiedades OSLC que se utilizan durante la creación de nuevos registros.

La sección oslcRecordConfig

La sección oslcRecordConfig correlaciona campos de registro de ClearQuest específicos con propiedades OSLC específicas. Incluya una sección oslcRecordConfig para cada tipo de registro de ClearQuest que utilice para rellenar previamente nuevos registros.

Por ejemplo, para rellenar previamente desde un tipo de registro Defect y un tipo de registro Customer en una base de datos 8.0.0/SAMPL, el archivo oslc-mappings.xml deberá tener dos secciones 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 sección oslcRecordConfig puede tener uno o más atributos oslcFieldMapping. Cada atributo oslcFieldMapping correlaciona un único campo de ClearQuest con una propiedad OSLC correspondiente. Las correlaciones pueden utilizarse para la correlación genérica de campos de ClearQuest con propiedades OSLC. No existe ningún límite en el número de propiedades OSLC que puede correlacionar. No obstante, las únicas propiedades OSLC que se utilizan actualmente para rellenar previamente un recuadro de diálogo de creación de registros de ClearQuest, son las propiedades dcterms:title y dcterms:description. En el ejemplo siguiente, la propiedad OSLC dcterms:title está correlacionada con el campo de ClearQuest Headline, y la propiedad OSLC dcterms:description está correlacionada con el campo de ClearQuest Descripción.

<oslcRecordConfig type="cq.record:Defect@8.0.0/SAMPL">

		<oslcFieldMapping name="dcterms:title" field="Headline"/>
		<oslcFieldMapping name="dcterms:description" field="Description"/>

</oslcRecordConfig>

Para correlacionar el mismo tipo de registro en distintos repositorios de esquemas o en distintas bases de datos de usuarios, debe disponer de secciones oslcRecordConfig para cada repositorio de esquemas o base de datos. El ejemplo siguiente muestra la configuración para distintos repositorios de esquemas y bases de datos de usuarios:

<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 sección oslcProjectPrefillConfig

La sección oslcProjectPrefillConfig controla las propiedades OSLC que se utilizan durante la creación de nuevos registros. Existe una sección oslcProjectPrefillConfig para cada proyecto relacionado para el que desee proporcionar información de rellenado previo. En cada sección oslcProjectPrefillConfig, existen una o más secciones para cada tipo de registro de ClearQuest para el cual desee proporcionar información de rellenado previo.

El ejemplo siguiente muestra la información de rellenado previo para un proyecto denominado RTC 4.0 Change Management (Gestión de cambios). Una sección oslcProjectPrefillConfig contiene dos secciones oslcRecordPrefill, una para la información de rellenado previo del tipo de registro Defect y otra para el tipo de registro Customer en la base de datos 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/&gt;"/>
	</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/&gt;"/>
	</oslcRecordPrefill>

</oslcProjectPrefillConfig>

Cada sección oslcRecordPrefill puede contener hasta dos líneas oslcPrefillProperty. Actualmente, sólo las propiedades dcterms:title y dcterms:description disponen de soporte para el rellenado previo.

El atributo supportsPrefillMarkup determina qué tipo de salto de línea se debe utilizar cuando se rellena previamente la información de ClearQuest al proyecto relacionado. Si el atributo supportsPrefillMarkup se establece en TRUE, pero el proyecto no admite texto enriquecido, es posible que detecte caracteres &ltbr/> en lugar de saltos de línea en los datos rellenados previamente. Si el atributo supportsPrefillMarkup se establece en FALSE y el proyecto admite texto rico, es posible que note que todos los datos multilínea rellenados previamente se muestran en una única línea.

Si el proyecto admite texto enriquecido, es posible que pueda utilizar códigos HTML con el prefijo. En el ejemplo siguiente, existen códigos de comienzo y de fin para negrita y cursiva, y dos saltos de línea:

<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&gt;<i&gt;ClearQuest Description:</b&gt;</i&gt;<br/&gt;<br/&gt;"/>
	
	</oslcRecordPrefill>

</oslcProjectPrefillConfig>

Cómo afectan las correlaciones OSLC de cqrest.properties a los atributos de rellenado previo

Si las correlaciones OSLC se establecen en el archivo cqrest.properties, únicamente se utilizan las correlaciones del archivo cqrest.properties, y no se utiliza ninguna de las propiedades de rellenado previo de la sección oslcProjectPrefillConfig.

Si necesita correlaciones genéricas de propiedades OSLC para llamadas GET/POST/PUT y es necesario rellenar previamente los formularios de registro, elimine los valores del archivo cqrest.properties y especifíquelos en la sección oslcRecordConfig del archivo oslc-mappings.xml. El número de propiedades OSLC que puede correlacionar en esta sección es ilimitado.


Comentarios