Web Service pour XCelsius (ws) - Historique des versions

Syfre le 22 août 2009 à 08:05

2009-08-22T08:05:01Z

← Version précédente		Version du 22 août 2009 à 08:05
Ligne 1 :		Ligne 1 :
	{{#customtitle:Un Web Service pour XCelsius}}		{{#customtitle:Un Web Service pour XCelsius}}

	==XCelsius==		===XCelsius===
	XCelsius est un logiciel de la suite Business Object permettant de construire des tableaux de bords graphiques et interactifs, XCelsius supporte différent type de connecteur de données dont un connecteur Service Web qui permet d'appeler des Web Services.		XCelsius est un logiciel de la suite Business Object permettant de construire des tableaux de bords graphiques et interactifs, XCelsius supporte différent type de connecteur de données dont un connecteur Service Web qui permet d'appeler des Web Services.

	Dans cet exemple nous allons implémenter un service ligne 1000 fournissant le total des engagement par nature pour un tableau de bord XCelsius.		Dans cet exemple nous allons implémenter un service ligne 1000 fournissant le total des engagement par nature pour un tableau de bord XCelsius.

	==Les différentes étapes==		===Les différentes étapes===

	'''Le développement du service :'''		'''Le développement du service :'''
Ligne 24 :		Ligne 24 :
	* Tester		* Tester

	==Développement du service==		===Développement du service===

	Nous créons un paquet de type service locaux pour héberger le service :		Nous créons un paquet de type service locaux pour héberger le service :
Ligne 31 :		Ligne 31 :

	nous ajoutons ensuite une classe non persistente qui contiendra les valeurs retournées à XCelsius :		nous ajoutons ensuite une classe non persistente qui contiendra les valeurs retournées à XCelsius :


	{{#images:image2.png\|WebServicesXCelsius}}		{{#images:image2.png\|WebServicesXCelsius}}

	{{#images:image3.png\|WebServicesXCelsius}}		{{#images:image3.png\|WebServicesXCelsius}}


	Cette classe contient deux attributs :		Cette classe contient deux attributs :
Ligne 44 :		Ligne 42 :

	Nous ajoutons ensuite une classe support pour le service, le rôle de cette classe est de supporter les opérations du service, elle ne contient donc aucun attribut :		Nous ajoutons ensuite une classe support pour le service, le rôle de cette classe est de supporter les opérations du service, elle ne contient donc aucun attribut :


	{{#images:image4.png\|WebServicesXCelsius}}		{{#images:image4.png\|WebServicesXCelsius}}


	puis l'opération du service :		puis l'opération du service :


	{{#images:image5.png\|WebServicesXCelsius}}		{{#images:image5.png\|WebServicesXCelsius}}


	Cette opération ne prend pas de paramètre en entrée et retourne une liste de nature d'engagement, la liste des nature engagement est retourné par un paramètre out de type WSX_NatureEngagementList :		Cette opération ne prend pas de paramètre en entrée et retourne une liste de nature d'engagement, la liste des nature engagement est retourné par un paramètre out de type WSX_NatureEngagementList :


	{{#images:image6.png\|WebServicesXCelsius}}		{{#images:image6.png\|WebServicesXCelsius}}


	nous modifions ensuite le code code l'opération pour obtenir cette liste :		nous modifions ensuite le code code l'opération pour obtenir cette liste :

	<~~pre~~>		<source lang='delphi'>
	var vCursor:TDetailEngagementCursor; inst:WSX_NatureEngagement;		var vCursor:TDetailEngagementCursor; inst:WSX_NatureEngagement;
	begin		begin
Ligne 82 :		Ligne 74 :
	end;		end;
	end;		end;
	</~~pre~~>		</source>

	notez qu'il n'est pas nécessaire d'instancier la liste reçue en paramètre.		notez qu'il n'est pas nécessaire d'instancier la liste reçue en paramètre.
Ligne 90 :		Ligne 82 :
	{{#images:image7.png\|WebServicesXCelsius}}		{{#images:image7.png\|WebServicesXCelsius}}

	==Utilisation dans XCelsius==		===Utilisation dans XCelsius===

	Démarrons XCelsius :		Démarrons XCelsius :
Ligne 109 :		Ligne 101 :

	{{#images:image11.png\|WebServicesXCelsius}}		{{#images:image11.png\|WebServicesXCelsius}}


	nous ajoutons ensuite un composant diagramme et nous relions ce composant aux cellules du tableau, le code de l'engagement sera une étiquette, la valeur engagée sera une donnée du diagramme :		nous ajoutons ensuite un composant diagramme et nous relions ce composant aux cellules du tableau, le code de l'engagement sera une étiquette, la valeur engagée sera une donnée du diagramme :


	{{#images:image12.png\|WebServicesXCelsius}}		{{#images:image12.png\|WebServicesXCelsius}}


	Exécutons :		Exécutons :


	{{#images:image13.png\|WebServicesXCelsius}}		{{#images:image13.png\|WebServicesXCelsius}}


	Et voila !		Et voila !


	{{~~PrecedentSuivant~~\|~~Developpement:WebServices\|Developpement:WebServices}}~~		{{Footer\|Web Services (ws)
	[[Category:~~WebServices\|E~~]]		[[Category:Web Services]]

Syfre : a renommé Developpement:WebServiceEx1 en Web Service pour XCelsius (ws)

2009-08-21T18:47:18Z

a renommé Developpement:WebServiceEx1 en Web Service pour XCelsius (ws)

← Version précédente	Version du 21 août 2009 à 18:47
(Aucune différence)

Syfre le 3 juin 2008 à 16:25

2008-06-03T16:25:49Z

← Version précédente		Version du 3 juin 2008 à 16:25
Ligne 24 :		Ligne 24 :
	* Tester		* Tester

	===Développement du service===		==Développement du service==

	Nous créons un paquet de type service locaux pour héberger le service :		Nous créons un paquet de type service locaux pour héberger le service :
Ligne 90 :		Ligne 90 :
	{{#images:image7.png\|WebServicesXCelsius}}		{{#images:image7.png\|WebServicesXCelsius}}

	===Utilisation dans XCelsius===		==Utilisation dans XCelsius==

	Démarrons XCelsius :		Démarrons XCelsius :

Syfre le 3 juin 2008 à 16:19

2008-06-03T16:19:30Z

← Version précédente		Version du 3 juin 2008 à 16:19
Ligne 124 :		Ligne 124 :

	Et voila !		Et voila !


			{{PrecedentSuivant\|Developpement:WebServices\|Developpement:WebServices}}
			[[Category:WebServices\|E]]

Syfre : Nouvelle page : {{#customtitle:Un Web Service pour XCelsius}} ==XCelsius== XCelsius est un logiciel de la suite Business Object permettant de construire des tableaux de bords graphiques et interact...

2008-06-03T16:16:25Z

Nouvelle page : {{#customtitle:Un Web Service pour XCelsius}} ==XCelsius== XCelsius est un logiciel de la suite Business Object permettant de construire des tableaux de bords graphiques et interact...

Nouvelle page

{{#customtitle:Un Web Service pour XCelsius}}

==XCelsius==
XCelsius est un logiciel de la suite Business Object permettant de construire des tableaux de bords graphiques et interactifs, XCelsius supporte différent type de connecteur de données dont un connecteur Service Web qui permet d'appeler des Web Services.

Dans cet exemple nous allons implémenter un service ligne 1000 fournissant le total des engagement par nature pour un tableau de bord XCelsius.

==Les différentes étapes==

'''Le développement du service :'''

* Ajout d'un paquet de service
* Ajout d'une classe résultat
* Ajout d'une classe support de service
* Ajout d'une opération de service

'''L'utilisation du service dans XCelsius :'''

* Créer un nouveau document XCelsius
* Définir la structures des données échangées
* Ajouter une source de données Web Service
* Mapper la source de données sur la structure des données
* Ajouter un diagramme par secteur
* Tester

===Développement du service===

Nous créons un paquet de type service locaux pour héberger le service :

{{#images:image1.png|WebServicesXCelsius}}

nous ajoutons ensuite une classe non persistente qui contiendra les valeurs retournées à XCelsius :

{{#images:image2.png|WebServicesXCelsius}}

{{#images:image3.png|WebServicesXCelsius}}

Cette classe contient deux attributs :

* Le code de la nature
* La valeur engagée sur cette nature

Nous ajoutons ensuite une classe support pour le service, le rôle de cette classe est de supporter les opérations du service, elle ne contient donc aucun attribut :

{{#images:image4.png|WebServicesXCelsius}}

puis l'opération du service :

{{#images:image5.png|WebServicesXCelsius}}

Cette opération ne prend pas de paramètre en entrée et retourne une liste de nature d'engagement, la liste des nature engagement est retourné par un paramètre out de type WSX_NatureEngagementList :

{{#images:image6.png|WebServicesXCelsius}}

nous modifions ensuite le code code l'opération pour obtenir cette liste :

<pre>
var vCursor:TDetailEngagementCursor; inst:WSX_NatureEngagement;
begin
vCursor := TDetailEngagement.CreateCursor;
vCursor.Descendants := True;
vCursor.AgregateCount := 1;
vCursor.Agregates[1] := 'montantValorisation';
vCursor.GroupBycount := 1;
vCursor.GroupBys[1] := 'NatureBudgetaire.code';
vCursor.Open;
while not vCursor.Eoi do
begin
inst := WSX_NatureEngagement.Create;
inst.Code := vCursor.Fields[0];
inst.Montant := vCursor.Fields[1];
rslt.AddRef(inst);
vCursor.Next;
end;
end;
</pre>

notez qu'il n'est pas nécessaire d'instancier la liste reçue en paramètre.

Après avoir relancer le Service ligne 1000 nous pouvons vérifier que notre Web Service est bien disponible en interrogeant son wsdl :

{{#images:image7.png|WebServicesXCelsius}}

===Utilisation dans XCelsius===

Démarrons XCelsius :

{{#images:image8.png|WebServicesXCelsius}}

Nous définissons d'abord une structure de données dans la feuille Excel pour recevoir nos données :

{{#images:image9.png|WebServicesXCelsius}}

Les valeurs saisies servent uniquement à matérialiser les données lors du développement, elles seront remplacées lors de l'exécution par les valeurs retournées par le Web service.

puis nous ajoutons une connexion Web Services :

{{#images:image10.png|WebServicesXCelsius}}

après importation du wsdl la connexion présente les différentes opérations disponibles sur le service, après avoir sélectionnée notre opération nous établissons ensuite la relation entre ses paramètres et les cellules du tableau Excel :

{{#images:image11.png|WebServicesXCelsius}}

nous ajoutons ensuite un composant diagramme et nous relions ce composant aux cellules du tableau, le code de l'engagement sera une étiquette, la valeur engagée sera une donnée du diagramme :

{{#images:image12.png|WebServicesXCelsius}}

Exécutons :

{{#images:image13.png|WebServicesXCelsius}}

Et voila !