Utilisation de l'interface de configuration XML pour administrer les balises d'analyse

Vous pouvez utiliser l'interface de configuration XML pour gérer les balises d'analyse et les promotions de site dans le portail.

La ressource XML liée aux balises d'analyse est tag. Les attributs sont répertoriés ci-après.

Notes :

Lorsque vous créez des balises, vous devez spécifier tous les attributs, à l'exception de l'attribut locale marqué comme facultatif dans la liste des attributs.
Lorsque vous exportez des balises, le fichier de résultat de l'exportation contient toutes les balises qui existent dans votre système de portail et notamment les balises créées pour le balisage et l'évaluation.
Les noms des balises d'analyse doivent commencer par com.ibm.portal.asa. et respecter le modèle suivant : com.ibm.portal.asa.tag_name#tag_value .
Le nom de balise des promotions de site doit être com.ibm.portal.asa.SitePromotion.
Vous devez placer un caractère d'échappement devant tous les caractères spéciaux. Ces derniers incluent l'espace.

étiquette

Balise de ressource XML des balises d'analyse. Utilisez les attributs suivants avec cette balise :

resourceref = "object_ID": Cet attribut permet de spécifier la référence à la ressource en cours de balisage.
domain = "comm": Pour les balises d'analyse, spécifiez la valeur "comm" pour cet attribut. Pour le balisage et l'évaluation, cet attribut permet de spécifier le domaine de base de données de la ressource balisée. La seule valeur acceptée pour les balises d'analyse est "comm".
propriétaire = "user": Cet attribut permet de spécifier le propriétaire de la balise.
environnement local = "locale": Cet attribut permet de spécifier l'environnement local de la balise. Cet attribut est facultatif. Si vous ne spécifiez pas cet attribut, la valeur null est utilisée par défaut.

Pour des exemples, reportez-vous aux exemples de code suivants :

Exemple : Exportation d'étiquettes d'analyse

<?xml version="1.0" encoding="UTF-8"?>
<request    
   xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"    
   xsi:noNamespaceSchemaLocation="PortalConfig_8.5.0.xsd"    
   type="export">    
   <!-- This sample exports all tags.         
        In addition to all analytics tags (starting with 'com.ibm.portal.asa.'),
        all tags (see tagging and rating) are exported.             
   -->    
   <portal action="locate">            
      <tag action="export" objectid="*"/>        
      <!-- Export all tags with a specific locale in the system -->        
      <!-- <tag action="export" objectid="*" locale="SPECIFIC_LOCALE"/> -->    
   </portal>
</request>

Exemple : Création d'étiquettes d'analyse

<?xml version="1.0" encoding="UTF-8"?>
<request    
   xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"    
   xsi:noNamespaceSchemaLocation="PortalConfig_8.5.0.xsd"    
   type="update">    
   <!-- This sample creates analytics tags and site compositions.             
        NOTE: This sample file needs to be modified before execution.      
        Update the value of the 'owner' attributes of the 'access-control', 
        and 'tag' tags, and specify an existing user.     
   -->      
   <portal action="locate">   
      <!-- Locate the page. -->        
      <content-node action="locate" objectid="gettingStartedPage" 
                    uniquename="ibm.portal.Home.Getting Started"/>                              
      <!--  NOTE:
            Pattern:  <tag-name>#<tag-value>   
            Special characters (including 'blank space') must be escaped!
            All tag names must start with 'com.ibm.portal.asa.'          
            Tag name for site promotions must be 'com.ibm.portal.asa.SitePromotion'         
      -->       
      <!-- Assignment of the site promotion "Christmas 2011" to the gettingStartedPage -->  
      <tag action="update" objectid="ZCI_B1L68B1A00DO80IG7PCV0I6000" 
           resourceref="gettingStartedPage" domain="comm" 
           owner="uid=wpsadmin,o=defaultwimfilebasedrealm" 
           locale="en">com.ibm.portal.asa.SitePromotion#Christmas%202011</tag>              
      <!-- Assignment of the analytics tag 'Target Audience#Young Professionals' 
           to the gettingStartedPage -->   
      <tag action="update" objectid="ZCI_B1L68B1A00DO80IG7PCV0I7000" 
           resourceref="gettingStartedPage" domain="comm" 
           owner="uid=wpsadmin,o=defaultwimfilebasedrealm" 
           locale="en">com.ibm.portal.asa.Target%20Audience#Young%20Professionals</tag>                   
   </portal>
</request>

Exemple : Suppression d'étiquettes d'analyse

<?xml version="1.0" encoding="UTF-8"?>
<request    
   xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"    
   xsi:noNamespaceSchemaLocation="PortalConfig_8.5.0.xsd"    
   type="update"> 
   <!-- This sample deletes analytics tags.   
        NOTE: This sample assumes that the CreateAnalyticsTags.xml 
        sample was executed before.       
   -->    
   <portal action="locate">        
      <!-- Delete the analytics tags created by sample CreateAnalyticsTags.xml -->        
      <tag action="delete" objectid="ZCI_B1L68B1A00DO80IG7PCV0I6000"/>        
      <tag action="delete" objectid="ZCI_B1L68B1A00DO80IG7PCV0I7000"/>        
      <!-- Delete all tags with a specific locale in the system -->        
      <!-- <tag action="delete" objectid="*" locale="SPECIFIC_LOCALE"/> -->
  </portal>
</request>