Section TranslatorCollection

Manuel d'implémentation › Spécifications de la configuration d'adaptateur › Section TranslatorCollection

Section TranslatorCollection

La section TranslatorCollection décrit la méthode de conversion de l'enregistrement de la source de données analysée et manipulée, extrait dans la section précédente vers un événement CA Business Service Insight.

Lorsque le mode d'interface est "en ligne", l'événement CA Business Service Insight a une structure unifiée qui contient les champs suivants :

Timestamp : moment de l'occurrence d'événement.
ResourceId : ID de ressource de CA Business Service Insight associée à l'événement (la ressource qui a été mesurée, etc.).
EventTypeId : type d'événement CA Business Service Insight associé à l'événement, décrit le type de l'événement (type de mesure sur la ressource, type d'action de ticket, etc.) .
DataSourceId : (facultatif) le nom de la source de données d'entrée (nom de fichier/nom de table, etc.).
Value : la valeur de l'événement (résultat de mesure, numéro de ticket, etc.). Ce champ peut apparaître plusieurs fois.

Lorsque le mode d'interface est "hors ligne", le nombre de champs ou leur nom ne sont soumis à aucune restriction.

Structure XML :

<TranslatorCollection>
   <Translator TranslatorName="events" OnDuplication = "ignore">
	<TranslatorFields>
		<TranslatorField Name="ResourceId" SourceType="table"
		    SourceName="ResourcesTranslateTable" Iskey="yes"/>
		<TranslatorField Name="EventTypeId"	SourceType="constant"
		    ConstantValue="1002" Iskey="yes"/>
		<TranslatorField Name="Timestamp"  	SourceType="field"
                SourceName="timestamp" Iskey="yes"/>
		<TranslatorField Name="Value" 	SourceType="table"
                SourceName="valueUpDownTranslateTable" Iskey="yes"/>
		< TranslatorField Name="Value"  SourceType ="field"
                SourceName ="nodeName" Iskey="yes"/>
		< TranslatorField Name="Value" SourceType ="constant"
                Type="integer" ConstantValue="1000" Iskey="yes"/>
		< TranslatorField Name="Value"  SourceType ="field"
                SourceName ="timestamp" TimeShift="-3600"
                TimeShiftFieldName="createDate"	Iskey="yes"/>
		< TranslatorField Name="Value" SourceType ="lookup"
                SourceName ="ServiceTable" LookupValue="word"
                Iskey="yes"/>
      </TranslatorFields>
   </Translator>
</TranslatorCollection>

Translator : décrit la méthode de conversion de l'ensemble de champs qu'il reçoit dans un événement de sortie.
- TranslatorName : nom utilisé par InputFormat pour envoyer des définitions de champ à ce convertisseur.
- OnDuplication : membre qui détient la valeur "ignore","add", "update" ou "updateAlways" pour déterminer comment traiter un événement de duplication. Consultez la section Singularité d'événement.
- TranslatorFields : contient la liste des éléments TranslatorField, chacun d'eux renfermant les attributs suivants :
- Name : Nom de champ. Dans l'interface en ligne, ce doit être Timestamp, ResourceId, EventTypeId, Value ou DataSourceId.
- SourceType :
  field : la valeur du champ provient du champ de format d'entrée. L'attribut SourceName contient le nom de champ.
  
  table : la valeur du champ provient de la table de conversion. L'attribut SourceName contient le nom de la table.
  
  lookup : la valeur du champ provient de la table de conversion. L'attribut SourceName contient le nom de la table. La valeur à convertir est prise à partir de l'attribut LookupValue et non du format d'entrée.
  
  constant : la valeur du champ est constante et se trouve dans l'attribut ConstantValue.
- SourceName : contient le nom de champ pour le nom de la table de conversion.
- Type : [integer/real/string/time] requis uniquement lorsque le type du champ n'est pas prédéfini (par nom de champ ou par SourceType). Dans l'interface en ligne, requis uniquement pour le champ Value lorsque SourceType=constant. Dans l'interface hors ligne, requis pour chaque champ lorsque SourceType=constant.
- IsKey : représente la clé unique de l'événement. Cette clé est assemblée à partir de plusieurs champs qui ont été marqués TranslatorFields?IsKey = "yes".
  Consultez la section Singularité d'événement.
- LookupValue : Contient la valeur de l'élément de recherche lorsque SourceType="lookup".
- ConstantValue : Contient la valeur constant lorsque SourceType=constant. Dans le cas d'un champ horaire, la valeur constant est formatée selon le format d'heure TimeFormat, Now ou NowUtc, Now correspondant à l'heure actuelle dans l'environnement linguistique de la source de données et NowUtc correspondant à l'heure en temps universel.
- TimeFormat : contient le TimeFormat, requis uniquement pour des champs lorsque SourceType=constant et Type=time.
- TimeShift : définit le nombre d'heures de différence en secondes, uniquement pour les champs d'heure.
- TimeShiftFieldName : (facultatif) contient le nom de champ du format d'entrée qui indique le nombre d'heures de différence en secondes. TimeShift et TimeShiftFieldName peuvent être ensemble.