Pour se lier à une application d'inventaireIn order to link to external inventory applications, esup-helpdesk utilise des générateurs d'uses URL . Les URLs générées sont automatiquement ajoutées à l'interface web et permettent ainsi de naviguer depuis le suivi des demandes vers l'inventaire.

Propriétés de /properties/config.properties

generators. The URL generated are automatically added to the web interface and allow the managers to navigate from the helpdesk application to the inventory application.

URL generators are defined in the configuration file Les générateurs d'URL sont définis dans le fichier /properties/domain/computerUrl.xml. Par défaut, 3 générateurs sont proposés Three generators are available in the distribution:

• null : aucune no URL
• glpi : des URLs vers l'application GLPIURLs to the GLPI application
• glpiThroughCas : des URLs vers l'application GLPI après authentification au serveur CAS
  

Générateur d'URL par défaut 

• URLs to the GLPI application via a CAS authentication
  

Default URL generator

The URL generator is set for each department. The generator used for new departments is set by this porperty (set in properties/config.properties)Dans l'application, le générateur d'URL est défini par service. Le générateur utilisé pour les nouveaux services est donné par la propriété suivante :

#defaultComputerUrlBuilderName=null

Modèle des URLs GLPI

Links to the GLPI application

When one of the generators glpi or glpiThroughCas is used, they rely on this property to build the Lorsque les générateurs glpi ou glpiThroughCas sont utilisés, ils se basent sur cette propriété pour construire les URLs:

#computerUrl.glpiPattern=http://glpi.domain.edu/front/computer.php?contains[0]=%s&field[0]=1&sort=1&deleted=N&start=0

Serveur CAS

The URL of the CAS server, used when the property defaultComputerUrlBuilderName is set to L'URL du serveur CAS, utilisé par le générateur glpiThroughCas:

#computerUrl.casServiceUrl=https://cas.domain.edu?service=%s

...

Links to another application

The steps to add a new URL generator are:

• write a class that implements the interface org.esupportail.helpdesk.domain.computerUrl.ComputerUrlBuilder, for instance by inheriting of an existing class
• declarer a bean of this class in the configuration file /properties/domain/computerUrl.xml and add a reference to this bean in the attribute map of the bean computerUrlBuilderStore
• allow the automatic recovering of the new class and the configuration file /properties/domain/computerUrl.xml when upgrading (see Recovering previous configuration and customizations when upgrading).

Using several instances of GLPI

Let us assume here that a department named ENSSAT wants to use a new URL generator that will lead managers to their own GLPI instance.

Add two beans in /properties/domain/computerUrl.xml:

<bean id="computerUrlBuilderStore"
      class="org.esupportail.helpdesk.domain.computerUrl.ComputerUrlBuilderStoreImpl"
      lazy-init="true"
      >
    <description>A store for the computer URL builders.</description>
    <property name="map" >
      <map>
        <entry key="null" value-ref="nullComputerUrlBuilder" />
        <entry key="glpi" value-ref="glpiComputerUrlBuilder" />
        <entry key="glpiThroughCas" value-ref="glpiThroughCasComputerUrlBuilder" />
        <entry key="enssatGlpi" value-ref="enssatGlpiComputerUrlBuilder" />
        <entry key="enssatGlpiThroughCas" value-ref="enssatGlpiThroughCasComputerUrlBuilder" />
      </map>
    </property>
</bean>
...
<bean id="enssatGlpiComputerUrlBuilder"
      parent="abstractComputerUrlBuilder"
      class="org.esupportail.helpdesk.domain.computerUrl.PatternBasedComputerUrlBuilderImpl"
      lazy-init="true"
      >
    <property name="pattern" value="${computerUrl.enssatGlpiPattern}" />
    <property name="i18nDescriptionKey" value="DOMAIN.COMPUTER_URL_BUILDER.ENSSAT_GLPI" />
</bean>
<bean id="enssatGlpiThroughCasComputerUrlBuilder"
      parent="abstractComputerUrlBuilder"
      class="org.esupportail.helpdesk.domain.computerUrl.CasPatternBasedComputerUrlBuilderImpl"
      lazy-init="true"
      >
    <property name="pattern" value="${computerUrl.enssatGlpiPattern}" />
    <property name="casServiceUrl" value="${computerUrl.casServiceUrl}" />
    <property name="i18nDescriptionKey" value="DOMAIN.COMPUTER_URL_BUILDER.ENSSAT_GLPI_THROUGH_CAS" />
</bean>

Declare the property computerUrl.enssatGlpiPattern in /properties/config.properties:

computerUrl.enssatGlpiPattern=http://glpi.enssat.univ-rennes1.fr/front/computer.php?contains[0]=%s&field[0]=1&sort=1&deleted=N&start=0

Add the i18n keys to the bundles.
/properties/i18n/bundles/Custom_fr.properties:

DOMAIN.COMPUTER_URL_BUILDER.ENSSAT_GLPI = GLPI (ENSSAT)
DOMAIN.COMPUTER_URL_BUILDER.ENSSAT_GLPI_THROUGH_CAS = GLPI via CAS (ENSSAT)

/properties/i18n/bundles/Custom_en.properties:

DOMAIN.COMPUTER_URL_BUILDER.ENSSAT_GLPI = GLPI (ENSSAT)
DOMAIN.COMPUTER_URL_BUILDER.ENSSAT_GLPI_THROUGH_CAS = GLPI through CAS (ENSSAT)

Tell esup-helpdesk to automatically recover your modified configuration file at the next upgrade in /build.properties:

custom.recover.files= \
... \
/properties/domain/computerUrl.xml