Manuel d'intégration

Intégration

Affichage des prochains RDV et du nombres de mail non lus dans un cadre avec le nom de l'utilisateur

Suivez ce chapitre si vous voulez insérer dans votre charte un cadre avec le nom de l'utilisateur connecté, ses prochains RDV et le nombre de mails non lus.

Dans votre charte graphique, il faut :

  • importer la XSL du plugin Messaging connector
    <xsl:import href="plugin:messaging-connector://stylesheets/messaging-connector.xsl" />
  • faire appel au template "script-js-messaging-connector" qui charge le JS

    Exemple

    <xsl:template name="additionnal-script">  
       ...  
       <xsl:call-template name="script-js-messaging-connector">  
            <xsl:with-param name="css-class-prefix">exchange</xsl:with-param>  
       </xsl:call-template>  
    </xsl:template> 
  • faire appel au template de rendu "messaging-connector-card" là où vous voulez insérer les informations récupérées du serveur de messagerie

    <xsl:call-template name="messaging-connector-card">  
            <xsl:with-param name="css-class-prefix">exchange</xsl:with-param>  
    </xsl:call-template>  
                

Les templates XSL sont configurables.

Pour "script-js-messaging-connector" :

  • css-class-prefix : prefix pour les classes CSS qui sont appliquées aux éléments de rendu, "messaging" par défaut
  • max-days : période de recherche des événements à venir, 7 jours par défaut
  • max-events: nombre maxiumn d'événements à afficher, 1 par defaut
  • email-none: clé i18n lorsqu'il y a aucun mail non lus, par défaut "Aucun message non lu(s)"
  • email-single: clé i18n lorsqu'il y a 1 mail non lu, par défaut "1 message non lu(s)"
  • email-several: clé i18n lorsqu'il y a plusieurs mail non lus, par défaut "X messages non lu(s)"

Pour "messaging-connector-card" :

  • css-class-prefix : prefix pour les classes CSS qui sont appliquées aux éléments de rendu, "messaging" par défaut
  • tous les messages utilisés dans le rendu sont configurables : email-title, email-waiting, email-error, agenda-title, ... Voir la XSL "messaging-connector-card.xsl".

Par défaut, ce helper affiche le Nom Prénom de la personne, puis le nombre de message non lus, puis les RDV à venir. Les RDV comprennent le sujet - la date - le lieu.
Si vous ne voulez pas afficher le lieu (par exemple) vous devrez surcharger le template "messaging-event-location" et le laissez vide.

Attention
Si vous surchargez le préfix CSS "messaging" dans un des templates, vous devez également le surcharger pour l'autre.

Le HTML produit par défaut est le suivant :

<ul class="user-infos exchange-user-infos">  
  <li class="user-infos-person messaging-user-infos-person">  
    <span class="user-infos-person-title messaging-user-infos-person-title">Michel Durand</span>  
  </li>  
  <li class="user-infos-mail messaging-user-infos-mail">  
    <span class="user-infos-mail-title messaging-user-infos-mail-title">Messagerie :</span>  
    <span class="user-infos-waiting messaging-user-infos-waiting" style="display: none;">Chargement en cours...</span>  
    <span style="display:none;" class="user-infos-error messaging-user-infos-error">Une erreur est survenue. Impossible de retrouver les informations.</span>  
    <span style="" class="user-infos-info messaging-user-infos-info">  
      <span id="messaging-nb-msg">5 messages</span>non lu(s)</span>  
  </li>  
  <li class="user-infos-agenda messaging-user-infos-agenda">  
    <span class="user-infos-agenda-title messaging-user-infos-agenda-title">Prochain(s) RDV :</span>  
    <span class="user-infos-waiting messaging-user-infos-waiting" style="display: none;">Chargement en cours...</span>  
    <span style="display:none;" class="user-infos-error messaging-user-infos-error">Une erreur est survenue. Impossible de retrouver les informations.</span>  
    <ul style="" class="user-infos-events messaging-user-infos-events">  
      <li class="user-infos-event messaging-user-infos-event">  
        <span class="user-infos-event-title messaging-user-infos-event-title">Copil Abcd</span>  
        <span class="user-infos-event-separator messaging-user-infos-event-separator" style="display: none;"></span>  
        <span class="user-infos-event-date messaging-user-infos-event-date">lun. 10 juil. 15h00</span>  
        <span class="user-infos-event-separator messaging-user-infos-event-separator" style="display: none;"></span>  
        <span class="user-infos-event-location messaging-user-infos-event-location">Salle Royans-Vercors</span>  
      </li>  
    </ul>  
    <span style="display:none;" class="user-infos-noevent messaging-user-infos-noevent">  
      <span>Aucun évènement</span>d'ici  
      <span class="user-infos-maxdays messaging-user-infos-maxdays"></span>jour(s).</span>  
  </li>  
</ul>  

Utilisation des liens de l'annuaire avec un input data

Pour pouvez utiliser l'annuaire de liens et l'affichage d'information dynamique pour afficher les prochains RDV et mail non lus.

Pour cela, reportez-vous à la documentation de l'annuaire de liens :