Processo di pubblicazione e caricamento in Servigistics InService > Utilizzo del processo di pubblicazione e caricamento > Configurazione delle operazioni TAL > Configurazione della mappatura delle equivalenze (tipi di informazioni)
  
Configurazione della mappatura delle equivalenze (tipi di informazioni)
I tipi di pubblicazione e di informazioni di tipi di oggetto quali elenco parti, IE-XML e PDF sono gestiti tramite un file di mappatura delle equivalenze. Il file viene denominato equivalence-mapping.xml e si trova nel percorso INSERVICE_HOME\InS_SW\Config\Applications\DataProcess\Config\Common\Templates\EquivalenceMapping.
In questo file, è necessario mappare il tipo SIM di un oggetto al rispettivo tipo di informazioni o di pubblicazione nell'interfaccia di Servigistics InService.
In base alla mappatura, la mappatura delle equivalenze inserisce il tipo di informazioni e il tipo di pubblicazione corretti nell'output XMD (DCTM_Output) nella fase di trasformazione dell'elaborazione PxTAL. Si tratta di una mappatura facoltativa.
* 
Questo file di configurazione influisce sul tipo di informazioni che viene scritto nei file .XMD associati durante il processo di trasformazione. Ciò significa che la mappatura deve essere eseguita prima di eseguire il processo TAL per il bundle completo e non può essere modificata in un secondo momento per la pubblicazione e il caricamento di un bundle incrementale. In questo caso, le modifiche al file non interesseranno i bundle che sono già stati elaborati.
La tabella seguente descrive gli elementi XML definiti nel file equivalence-mapping.xml.
Elemento
Descrizione
<Mappings>
Elemento radice contenente più elementi di mappatura.
<mapping>
Contiene una singola voce di mappatura per un tipo SIM.
Per qualsiasi nuovo tipo supportato deve essere definito un nuovo elemento mappatura in questo file.
• Attributo type - Contiene il tipo SIM (come si presenta nel bundle)
• Attributo informationType - Contiene il valore del tipo di informazioni da visualizzare nell'interfaccia di Servigistics InService
• Attributo publicationType - Contiene il valore del tipo di pubblicazione
Questo attributo è obbligatorio solo se informationType è di tipo Publication.
<type>
Contiene il nome del tipo di origine presente nel file XML del bundle per cui deve essere recuperato il rispettivo tipo di informazioni o di pubblicazione.
<informationType>
Contiene il valore del tipo di informazioni a cui viene mappato il tipo di origine.
<publicationType>
Contiene il valore del tipo di pubblicazione a cui viene mappato il tipo di origine. Questo attributo è obbligatorio solo se informationType è un tipo di pubblicazione.
Questo elemento definisce la mappatura specifica del tipo di pubblicazione
• Attributo target - Contiene le informazioni attributo SIM dal bundle
• Attributo logicalPublicationType - Contiene il valore del tipo di pubblicazione che viene visualizzato nell'interfaccia di Servigistics InService.
<criteria>
Definisce il nome di attributo il cui valore nel file di input di origine deve corrispondere al valore specificato. Possono essere presenti zero o più elementi criteri. Per individuare il rispettivo tipo di informazioni o di pubblicazione è necessaria la corrispondenza di tutti i criteri.
Se non viene trovato alcun elemento criteri, viene immediatamente mappato il tipo di informazioni/pubblicazione corrispondente.
<tokens>
Contiene più elementi token.
<token>
Contiene il nome di attributo per il cui valore deve essere trovata una corrispondenza nel file di input di origine. L'utilizzo di più elementi token ha lo scopo di supportare la presenza di più nomi di attributo possibili noti. Il criterio è considerato soddisfatto se uno dei nomi di token specificati è presente nel file di origine e corrisponde al valore specificato.
<value>
Contiene il valore del nome di token per cui deve essere trovata una corrispondenza nel file di input di origine.
È necessario attenersi al meccanismo indicato di seguito per attivare la mappatura delle equivalenze.
• Esiste una mappatura per il tipo o il sottotipo di oggetto nel file di mappatura delle equivalenze.
◦ Il valore per il tipo di informazioni di Servigistics InService deriva dalla mappatura.
• Non esiste alcuna mappatura per un tipo o un sottotipo di oggetto nella mappatura delle equivalenze.
◦ Il valore per il tipo di informazioni di Servigistics InService è per default un valore codificato predefinito.
• Attualmente, il valore del tipo di informazioni proveniente da Windchill Service Information Manager viene ignorato.
* 
Il valore da utilizzare in informationType e publicationType deve essere correlato a quanto specificato per il tipo di oggetto nel file facets.xml, in modo che venga riportato correttamente nell'interfaccia utente.
Relativamente agli scenari sopra descritti, poiché l'output della mappatura delle equivalenze influisce sul valore generato per il file XMD, i valori del tipo di informazioni e di pubblicazione originali nel bundle sono comunque disponibili come qualsiasi altro attributo del bundle. Potenzialmente, potrebbe anche essere opportuno indicizzare o utilizzare tali informazioni.
La mappatura qui fornita per i tipi di pubblicazione o di informazioni ha la precedenza su quanto è stato definito nel bundle di pubblicazione. L'interfaccia utente utilizza il risultato di questa mappatura durante la consultazione del file di configurazione facets.xml dell'interfaccia utente.
Di seguito sono indicate voci di esempio del file di mappatura.
<Mappings>
<!-- Information Type Mapping -->
<mapping informationType="partsList" type="com.ptc.arbortext.windchill.partlist.PartList"/>
<mapping informationType="Information" type="wt.epm.EPMDocument|com.ptc.ptcnet.DynamicDocument"/>
<mapping informationType="kit" type="com.ptc.arbortext.windchill.partlist.PartList">
<criteria>
<tokens>
<token>servicekit</token>
</tokens>
<value>true</value>
</criteria>
</mapping>
<!-- Publication Type Mapping -->
<publication-mapping target=" wt.part.WTPart|com.ptc.sis.Base|com.ptc.sis.BaseDiv|
com.ptc.sis.PsSection|com.ptc.sis.PsRoot|com.ptc.OwnerManual" logicalPublicationType="OwnersManual"/>
Se, ad esempio, si desidera impostare il tipo di informazioni di un partsList SIM con il valore com.ptc.arbortext.windchill.partlist.PartList, è possibile dichiarare il valore nel file di mappatura delle equivalenze.
<mapping informationType="partsList"
type="com.ptc.arbortext.windchill.partlist.PartList"/>
Inoltre, se si desidera applicare il tipo di informazioni in base ad alcuni criteri di filtraggio, è possibile utilizzare gli elementi <criteria> e <token>. A tale scopo, è necessario propagare il nome del token e il relativo valore per i quali impostare la corrispondenza nel file di input.
<mapping informationType="kit"
type="com.ptc.arbortext.windchill.partlist.PartList">
<criteria>
<tokens>
<token>servicekit</token>
</tokens>
<value>true</value>
</criteria>
</mapping>
Analogamente per la mappatura del tipo di pubblicazione, se si desidera impostare il tipo di pubblicazione publication per il tipo di oggetto SIM wt.part.WTPart|com.ptc.sis.PsRoot, è possibile utilizzare la mappatura indicata di seguito.
<publication-mapping target="wt.part.WTPart|com.ptc.sis.PsRoot"
logicalPublicationType="publication"/>
Il valore di destinazione viene letto dal file DMPMap specifico della PS. Se la mappatura non viene individuata, il tipo di pubblicazione viene determinato attraverso un'operazione di stringa secondaria. Il valore del tipo è quello che si trova dopo l'ultimo carattere barra verticale ( | ).
Per default, se non esiste un tipo corrispondente, Servigistics InService visualizza Information per IE XML e PDF e partslist per gli elenchi parti. Ciò vale anche per il tipo di pubblicazione.