Azure (Gestionnaire de message)

De Wiki1000
(Différences entre les versions)
(Page créée avec « Ce type de gestionnaire permet d'utiliser une file d'attente Microsoft Azure du système de stockage. '''Paramétrage de TdbmQueue''' '''Paramétrage de l'... »)
 
Ligne 1 : Ligne 1 :
 
Ce type de gestionnaire permet d'utiliser une file d'attente Microsoft Azure du système de stockage.
 
Ce type de gestionnaire permet d'utiliser une file d'attente Microsoft Azure du système de stockage.
  
−
'''Paramétrage de [[TdbmQueue|TdbmQueue]]'''
+
===Paramétrage de [[TdbmQueue|TdbmQueue]]===
  
−
'''Paramétrage de l'URL'''
+
{|class="wikitable"
 +
|-
 +
|QueueName
 +
|Nom de la file d'attente (Nom interne<>nom Azure)
 +
|-
 +
|QueueConnectionInfos
 +
|url de paramétrage de la file d'attente
 +
|-
 +
|QueueTopic
 +
|Sujet de la file d'attente : nom de la file d'attente Azure
 +
|-
 +
|Credentials
 +
|Référence vers les informtations d'authentication
 +
|}
  
−
'''Message'''
+
===Paramétrage des informations d'authentification===
 +
Les paramètres d'authentification sont extraits, par ordre de priorité :
 +
 
 +
* De l'attribut Parameters de l'objet TdbmCredential contenant les informations d'authentification
 +
* De l'url paramétrant la file d'attente
 +
* De l'attribut UserName pour le nom du compte Azure
 +
 
 +
{|class="wikitable"
 +
|-
 +
!Paramètre
 +
!Usage
 +
!Défaut
 +
|-
 +
|AccountName
 +
|Nom du stockage Azure.
 +
|UserName des crédentials
 +
|-
 +
|AccountKey
 +
|Clé publique d'accès au stockage.
 +
|
 +
|-
 +
|Protocol
 +
|Nom du protocole http utilisé
 +
|https
 +
|-
 +
|BlobEndPoint
 +
|End point des urls de blob
 +
|valeur standard d'Azure
 +
|-
 +
|QueueEndPoint
 +
|End point des urls de queue
 +
|valeur standard d'Azure
 +
|-
 +
|TableEndPoint
 +
|End point des urls de Table
 +
|valeur standard d'Azure
 +
|-
 +
|RequestProxyHost
 +
|Nom du serveur proxy
 +
|Paramétrage par défaut du proxy du Service 1000
 +
|-
 +
|RequestProxyPort
 +
|Port du serveur proxy
 +
|Paramétrage par défaut du proxy du Service 1000
 +
|}
 +
 
 +
{{tip|La clé ne peut pas être stockée dans le mot de passe, utiliser l'attribut Parameters qui permet de stocker des attributs arbitraires.}}
 +
 
 +
En général il suffit de paramétrer l'objet TdbmCredential ainsi :
 +
 
 +
* UserName : Nom du compte Azure
 +
* Parameters : AccountKey : Clé publique d'accès au stockage
 +
 
 +
 
 +
===Paramétrage de l'URL===
 +
Outre les paramètres d'authentification l'url peut contenir les paramètres suivant qui configurent l'encodage des messages :
 +
 
 +
{|class="wikitable"
 +
|-
 +
!Paramètre
 +
!Type
 +
!Usage
 +
!Défault
 +
|-
 +
|xmlStorage
 +
|boolean
 +
|Le contenu du message est encapsulé dans un document xml
 +
|true
 +
|-
 +
|sndFileName
 +
|chaine
 +
|Nom du paramètre du message contenant le nom du blob Azure
 +
|FileName,AttachementName
 +
|-
 +
|sndContainerName
 +
|chaine
 +
|Nom du paramètre du message contenant le nom du containeur Azure 
 +
|ContainerName
 +
|-
 +
|sndAttachementContentType
 +
|chaine
 +
|Nom du paramètre du message contenant le type de contenu du binaire
 +
|AttachementContentType,msgAttachementContentType
 +
|-
 +
|sndContent
 +
|chaine
 +
|Nom du paramètre du message contenant le contenu du message à transmettre (xmlStorage=false)
 +
|Content,Subject
 +
|-
 +
|VisibilityTimeOut
 +
|Integer
 +
|Valeur d'invisiblité du message après un dépilement
 +
|0
 +
|}
 +
 
 +
*sndFileName
 +
:Si le nom du fichier n'est pas défini par le paramétrage, un nom unique de type GUID est utilisé.
 +
 
 +
*sndContainerName
 +
:Si le nom du containeur Azure n'est pas défini par le paramétrage, le nom du containeur est défini par le nom de la file Azure post-fixé par "-blob".
 +
 
 +
*VisibilityTimeOut
 +
:Si la valeur n'est pas défini ou vaut 0, la valeur par défaut d'Azure s'applique.
 +
 
 +
===Messages===
 +
Un message Azure est constitué d'une chaine de caractère. Il ni a pas de notion d'attribut ou de contenu binaire attaché.
 +
 
 +
Un objet [[TdbmQueueMessage]] contient des propriétés et éventuellement un contenu binaire.
 +
 
 +
Le message TdbmQueueMessage est encodé en un message Azure ainsi :
 +
 
 +
====Si xmlStorage vaut true (défaut)====
 +
* Les propriétés du message TdbmQueueMessage sont encapsulées dans un document xml, le contenu du message Azure est ce document.
 +
* Le contenu binaire du message est copié dans un blob du système de stockage. Une référence vers ce blob est contenu dans le document xml.
 +
 
 +
====Si xmlStorage vaut false====
 +
* Le contenu du message est déterminé par le paramètre sndContent de l'url de configuration de la file d'attente.
 +
* Le contenu binaire n'est pas transmis.
  
  

Version du 25 juillet 2013 à 09:52

Ce type de gestionnaire permet d'utiliser une file d'attente Microsoft Azure du système de stockage.

Sommaire

Paramétrage de TdbmQueue

QueueName Nom de la file d'attente (Nom interne<>nom Azure)
QueueConnectionInfos url de paramétrage de la file d'attente
QueueTopic Sujet de la file d'attente : nom de la file d'attente Azure
Credentials Référence vers les informtations d'authentication

Paramétrage des informations d'authentification

Les paramètres d'authentification sont extraits, par ordre de priorité :

  • De l'attribut Parameters de l'objet TdbmCredential contenant les informations d'authentification
  • De l'url paramétrant la file d'attente
  • De l'attribut UserName pour le nom du compte Azure
Paramètre Usage Défaut
AccountName Nom du stockage Azure. UserName des crédentials
AccountKey Clé publique d'accès au stockage.
Protocol Nom du protocole http utilisé https
BlobEndPoint End point des urls de blob valeur standard d'Azure
QueueEndPoint End point des urls de queue valeur standard d'Azure
TableEndPoint End point des urls de Table valeur standard d'Azure
RequestProxyHost Nom du serveur proxy Paramétrage par défaut du proxy du Service 1000
RequestProxyPort Port du serveur proxy Paramétrage par défaut du proxy du Service 1000
Tip-20px.png Tip : La clé ne peut pas être stockée dans le mot de passe, utiliser l'attribut Parameters qui permet de stocker des attributs arbitraires.

En général il suffit de paramétrer l'objet TdbmCredential ainsi :

  • UserName : Nom du compte Azure
  • Parameters : AccountKey : Clé publique d'accès au stockage


Paramétrage de l'URL

Outre les paramètres d'authentification l'url peut contenir les paramètres suivant qui configurent l'encodage des messages :

Paramètre Type Usage Défault
xmlStorage boolean Le contenu du message est encapsulé dans un document xml true
sndFileName chaine Nom du paramètre du message contenant le nom du blob Azure FileName,AttachementName
sndContainerName chaine Nom du paramètre du message contenant le nom du containeur Azure ContainerName
sndAttachementContentType chaine Nom du paramètre du message contenant le type de contenu du binaire AttachementContentType,msgAttachementContentType
sndContent chaine Nom du paramètre du message contenant le contenu du message à transmettre (xmlStorage=false) Content,Subject
VisibilityTimeOut Integer Valeur d'invisiblité du message après un dépilement 0
  • sndFileName
Si le nom du fichier n'est pas défini par le paramétrage, un nom unique de type GUID est utilisé.
  • sndContainerName
Si le nom du containeur Azure n'est pas défini par le paramétrage, le nom du containeur est défini par le nom de la file Azure post-fixé par "-blob".
  • VisibilityTimeOut
Si la valeur n'est pas défini ou vaut 0, la valeur par défaut d'Azure s'applique.

Messages

Un message Azure est constitué d'une chaine de caractère. Il ni a pas de notion d'attribut ou de contenu binaire attaché.

Un objet TdbmQueueMessage contient des propriétés et éventuellement un contenu binaire.

Le message TdbmQueueMessage est encodé en un message Azure ainsi :

Si xmlStorage vaut true (défaut)

  • Les propriétés du message TdbmQueueMessage sont encapsulées dans un document xml, le contenu du message Azure est ce document.
  • Le contenu binaire du message est copié dans un blob du système de stockage. Une référence vers ce blob est contenu dans le document xml.

Si xmlStorage vaut false

  • Le contenu du message est déterminé par le paramètre sndContent de l'url de configuration de la file d'attente.
  • Le contenu binaire n'est pas transmis.


Voir aussi :

How to use the queue storage service.

Récupérée de « https://frp.sage.fr/wiki1000/index.php?title=Azure_(Gestionnaire_de_message)&oldid=7442 »
Outils personnels