Consommer un Web Service Sage1000(ws) - Historique des versions

Flfay le 30 janvier 2015 à 09:37

2015-01-30T09:37:08Z

@@ Ligne 1 : / Ligne 1 : @@
-{{#customtitle:Exemple de création d'un dashboard simple}}
+{{#customtitle:Consommer un Web Service Sage 1000}}
-Nous allons créer un dashboard. L'ouverture de ce dashboard effectuera une requête d'initialisation, et le dashboard pourra invoquer une méthode.
+Nous allons créer un paquet de service local et l'utiliser avec .NET.
-{{tip|La création d'un dashboard créé un paquet métier, le créateur du dashboard doit avoir le droit correspondant.}}
+===Création du paquet de service local===
-===Création du dashboard===
+Les étapes sont :
-[[image:dashboard_1.png]]
+<source lang='delphi'>
-[[image:dashboard_2.png]]
+//Function monOperationDeService(aParamIn:maClassParamIn):maClassParamOut;
-[[image:dashboard_3.png]]
+begin
-[[image:dashboard_4.png]]
+ result := maClassParamOut.Create;
-[[image:dashboard_5.png]]
+ result.monAttribut := 'echo ' + aParamIn.monAttribut;
-[[image:dashboard_6.png]]
+end;
-[[image:dashboard_7.png]]
+</source>
-===Implémentation===
+[[image:ConsommerWS 1.png]]
-===Utilisation===
+[[image:ConsommerWS 2.png]]
-{{footer}}
+[[image:ConsommerWS 4.png]]
-[[Category:Portail]]

Flfay le 30 janvier 2015 à 09:35

2015-01-30T09:35:24Z

@@ Ligne 1 : / Ligne 1 : @@
-{{#customtitle:Consommer un Web Service Sage 1000}}
+{{#customtitle:Exemple de création d'un dashboard simple}}
-Nous allons créer un paquet de service local et l'utiliser avec .NET.
+Nous allons créer un dashboard. L'ouverture de ce dashboard effectuera une requête d'initialisation, et le dashboard pourra invoquer une méthode.
-===Création du paquet de service local===
+{{tip|La création d'un dashboard créé un paquet métier, le créateur du dashboard doit avoir le droit correspondant.}}
-Les étapes sont :
+===Création du dashboard===
-<source lang='delphi'>
+[[image:dashboard_1.png]]
-//Function monOperationDeService(aParamIn:maClassParamIn):maClassParamOut;
+[[image:dashboard_2.png]]
-begin
+[[image:dashboard_3.png]]
- result := maClassParamOut.Create;
+[[image:dashboard_4.png]]
- result.monAttribut := 'echo ' + aParamIn.monAttribut;
+[[image:dashboard_5.png]]
-end;
+[[image:dashboard_6.png]]
-</source>
+[[image:dashboard_7.png]]
-[[image:ConsommerWS 1.png]]
+===Implémentation===
-[[image:ConsommerWS 2.png]]
+===Utilisation===
-[[image:ConsommerWS 4.png]]
+{{footer}}
+[[Category:Portail]]

Flfay le 23 janvier 2015 à 13:11

2015-01-23T13:11:28Z

← Version précédente		Version du 23 janvier 2015 à 13:11
Ligne 8 :		Ligne 8 :
	*Création du paquet de stéréotype "Service Local"		*Création du paquet de stéréotype "Service Local"
	*Occuper le paquet,		*Occuper le paquet,
	*Ajouter deux classes de stéréotype "Classe non persistantes" maClassParamIn et maClassParamOut (cette étape n'est pas obligatoire, on peut utiliser des types simples)		*Ajouter deux classes de stéréotype "Classe non persistantes" maClassParamIn et maClassParamOut (cette étape n'est pas obligatoire, on peut utiliser des types simples)
	*Ajouter une classe de stéréotype "Classe support de service local"		*Ajouter une classe de stéréotype "Classe support de service local"
	*Sur cette classe ajouter une opération de service Function monOperationDeService(aParamIn:maClassParamIn):maClassParamOut;		*Sur cette classe ajouter une opération de service '''Function monOperationDeService(aParamIn:maClassParamIn):maClassParamOut;'''

	<source lang='delphi'>		<source lang='delphi'>
	//Function monOperationDeService(aParamIn:maClassParamIn):maClassParamOut;		//Function monOperationDeService(aParamIn:maClassParamIn):maClassParamOut;
	begin		begin
	result := maClassParamOut.Create;		result := maClassParamOut.Create;
	result.monAttribut := 'echo' + aParamIn.monAttribut;		result.monAttribut := 'echo ' + aParamIn.monAttribut;
	end;		end;
	</source>		</source>

	*Libérer le paquet et le publier dans le référentiel		*Libérer le paquet et le publier dans le référentiel
	*redémarrer le service, on constate à l'adresse '''http://[hôte]/[service]/server/soap.l1000?wsdl''' que le web service est disponible		*redémarrer le service, on constate à l'adresse '''http://[hôte]/[service]/server/soap.l1000?wsdl''' que le web service est disponible

Flfay le 23 janvier 2015 à 13:08

2015-01-23T13:08:26Z

← Version précédente		Version du 23 janvier 2015 à 13:08
Ligne 24 :		Ligne 24 :

	[[image:ConsommerWS 1.png]]		[[image:ConsommerWS 1.png]]

	[[image:ConsommerWS 2.png]]		[[image:ConsommerWS 2.png]]

	[[image:ConsommerWS 3.png]]		[[image:ConsommerWS 3.png]]

	[[image:ConsommerWS 4.png]]		[[image:ConsommerWS 4.png]]

Ligne 42 :		Ligne 45 :

	[[image:ConsommerWS 6.png]]		[[image:ConsommerWS 6.png]]

	[[image:ConsommerWS 7.png]]		[[image:ConsommerWS 7.png]]

	[[image:ConsommerWS 8.png]]		[[image:ConsommerWS 8.png]]

	[[image:ConsommerWS 9.png]]		[[image:ConsommerWS 9.png]]

Flfay le 23 janvier 2015 à 13:07

2015-01-23T13:07:27Z

← Version précédente		Version du 23 janvier 2015 à 13:07
Ligne 49 :		Ligne 49 :

	<source lang='csharp'>		<source lang='csharp'>
	//obtention de la session		//obtention de la session grâce au token
	Sage1000Auth.TdbmLocalServiceAuthenticationPortTypeClient auth = new Sage1000Auth.TdbmLocalServiceAuthenticationPortTypeClient();		Sage1000Auth.TdbmLocalServiceAuthenticationPortTypeClient auth = new Sage1000Auth.TdbmLocalServiceAuthenticationPortTypeClient();
	String session = auth.LocalServiceLoginToken("2E235A772C0D0105F4D1670CD60000005562BD0A1D2A13345A4A84A7D98DC9B7B736B0396E60E957ED499DD29EA3D2F86B832C7B571228B5BC612741A3EA7F17D9162C1E7122DD8DD3F88A8BEC2D6A337D2054DFDEE5331AD760D0C475FA3EBEA4D4A61C72D8ED99BE9006A0BB6BD7D67C8241E12AABEBC31E80D71EA0F7EC96F12731010E9520797256AF74C58AE37E31A5A5C6F83859DCA442DCD36DA814C53F3A66D52F7EC02A53A512D1E077FBEB6F5B85905CA9CA0E479250AE1C514AD12D138A80630AB84D12293CB7D63F7999C88AB211FDCDF29D1635CD1D2290BE1E5FEF7894B8D493BB");		String session = auth.LocalServiceLoginToken("2E235A772C0D0105F4D1670CD60000005562BD0A1D2A13345A4A84A7D98DC9B7B736B0396E60E957ED499DD29EA3D2F86B832C7B571228B5BC612741A3EA7F17D9162C1E7122DD8DD3F88A8BEC2D6A337D2054DFDEE5331AD760D0C475FA3EBEA4D4A61C72D8ED99BE9006A0BB6BD7D67C8241E12AABEBC31E80D71EA0F7EC96F12731010E9520797256AF74C58AE37E31A5A5C6F83859DCA442DCD36DA814C53F3A66D52F7EC02A53A512D1E077FBEB6F5B85905CA9CA0E479250AE1C514AD12D138A80630AB84D12293CB7D63F7999C88AB211FDCDF29D1635CD1D2290BE1E5FEF7894B8D493BB");
	try		try
	{		{
			//Cet objet permet de passer la session lors de l'appel
	ServiceTest.SessionHeader sessionHeader = new ServiceTest.SessionHeader();		ServiceTest.SessionHeader sessionHeader = new ServiceTest.SessionHeader();
	sessionHeader.sessionId = session;		sessionHeader.sessionId = session;
Ligne 68 :		Ligne 69 :
	finally		finally
	{		{
	auth.LocalServiceLogout(session);//ne pas oublier de se déconnecter à l'issue		auth.LocalServiceLogout(session);//ne pas oublier de se déconnecter à l'issue, sinon on risque la pénurie de licence
	}		}
	</source>		</source>

Flfay le 23 janvier 2015 à 12:53

2015-01-23T12:53:08Z

← Version précédente		Version du 23 janvier 2015 à 12:53
Ligne 24 :		Ligne 24 :

	[[image:ConsommerWS 1.png]]		[[image:ConsommerWS 1.png]]
			[[image:ConsommerWS 2.png]]
			[[image:ConsommerWS 3.png]]
			[[image:ConsommerWS 4.png]]

	===Création du token d'authentification===		===Création du token d'authentification===
Ligne 30 :		Ligne 33 :
	Cette méthode est préférable, elle évite la divulgation du mot de passe et permet la révocation d'un token sans révoquer l'utilisateur.		Cette méthode est préférable, elle évite la divulgation du mot de passe et permet la révocation d'un token sans révoquer l'utilisateur.

			[[image:ConsommerWS 5.png]]


Ligne 35 :		Ligne 39 :

	Le web service d'authentification est disponible à l'adresse '''http://[hôte]/[service]/server/soap.l1000?wsdl=Sage1000Authentication'''		Le web service d'authentification est disponible à l'adresse '''http://[hôte]/[service]/server/soap.l1000?wsdl=Sage1000Authentication'''


			[[image:ConsommerWS 6.png]]
			[[image:ConsommerWS 7.png]]
			[[image:ConsommerWS 8.png]]
			[[image:ConsommerWS 9.png]]

Flfay le 23 janvier 2015 à 12:51

2015-01-23T12:51:54Z

← Version précédente		Version du 23 janvier 2015 à 12:51
Ligne 22 :		Ligne 22 :
	*le wsdl est visible à l'adresse '''http://[hôte]/[service]/server/soap.l1000?wsdl=TestServiceLocal'''		*le wsdl est visible à l'adresse '''http://[hôte]/[service]/server/soap.l1000?wsdl=TestServiceLocal'''
	*on remarque en bas du wsdl la ligne <soap:address location=... qui représente le endpoint soap.		*on remarque en bas du wsdl la ligne <soap:address location=... qui représente le endpoint soap.

			[[image:ConsommerWS 1.png]]

	===Création du token d'authentification===		===Création du token d'authentification===

Flfay le 23 janvier 2015 à 12:48

2015-01-23T12:48:40Z

← Version précédente		Version du 23 janvier 2015 à 12:48
Ligne 33 :		Ligne 33 :

	Le web service d'authentification est disponible à l'adresse '''http://[hôte]/[service]/server/soap.l1000?wsdl=Sage1000Authentication'''		Le web service d'authentification est disponible à l'adresse '''http://[hôte]/[service]/server/soap.l1000?wsdl=Sage1000Authentication'''


			<source lang='csharp'>
			//obtention de la session
			Sage1000Auth.TdbmLocalServiceAuthenticationPortTypeClient auth = new Sage1000Auth.TdbmLocalServiceAuthenticationPortTypeClient();
			String session = auth.LocalServiceLoginToken("2E235A772C0D0105F4D1670CD60000005562BD0A1D2A13345A4A84A7D98DC9B7B736B0396E60E957ED499DD29EA3D2F86B832C7B571228B5BC612741A3EA7F17D9162C1E7122DD8DD3F88A8BEC2D6A337D2054DFDEE5331AD760D0C475FA3EBEA4D4A61C72D8ED99BE9006A0BB6BD7D67C8241E12AABEBC31E80D71EA0F7EC96F12731010E9520797256AF74C58AE37E31A5A5C6F83859DCA442DCD36DA814C53F3A66D52F7EC02A53A512D1E077FBEB6F5B85905CA9CA0E479250AE1C514AD12D138A80630AB84D12293CB7D63F7999C88AB211FDCDF29D1635CD1D2290BE1E5FEF7894B8D493BB");
			try
			{
			ServiceTest.SessionHeader sessionHeader = new ServiceTest.SessionHeader();
			sessionHeader.sessionId = session;

			ServiceTest.maClassParamIn paramIn = new ServiceTest.maClassParamIn();
			paramIn.monAttribut = "hello world";

			//invocation du service
			ServiceTest.maClasseSupportServiceLocalPortTypeClient srv = new ServiceTest.maClasseSupportServiceLocalPortTypeClient();
			ServiceTest.maClassParamOut paramOut = srv.monOperationDeService(sessionHeader, paramIn);

			MessageBox.Show(paramOut.monAttribut);
			}
			finally
			{
			auth.LocalServiceLogout(session);//ne pas oublier de se déconnecter à l'issue
			}
			</source>

Flfay : /* Création du paquet de service local */

2015-01-23T12:44:59Z

Création du paquet de service local

← Version précédente		Version du 23 janvier 2015 à 12:44
Ligne 14 :		Ligne 14 :
	//Function monOperationDeService(aParamIn:maClassParamIn):maClassParamOut;		//Function monOperationDeService(aParamIn:maClassParamIn):maClassParamOut;
	begin		begin
			result := maClassParamOut.Create;
	result.monAttribut := 'echo' + aParamIn.monAttribut;		result.monAttribut := 'echo' + aParamIn.monAttribut;
	end;		end;

Flfay le 23 janvier 2015 à 12:44

2015-01-23T12:44:12Z

← Version précédente		Version du 23 janvier 2015 à 12:44
Ligne 5 :		Ligne 5 :
	===Création du paquet de service local===		===Création du paquet de service local===

	Les étapes sont		Les étapes sont :
	*Création du paquet de stéréotype "Service Local"		*Création du paquet de stéréotype "Service Local"
	*Occuper le paquet,		*Occuper le paquet,
	*Ajouter deux classes de stéréotype "Classe non persistantes" maClassParamIn et maClassParamOut		*Ajouter deux classes de stéréotype "Classe non persistantes" maClassParamIn et maClassParamOut (cette étape n'est pas obligatoire, on peut utiliser des types simples)
	*Ajouter une classe de stéréotype "Classe support de service local"		*Ajouter une classe de stéréotype "Classe support de service local"
	*Sur cette classe ajouter une opération de service Function monOperationDeService(aParamIn:maClassParamIn):maClassParamOut;		*Sur cette classe ajouter une opération de service Function monOperationDeService(aParamIn:maClassParamIn):maClassParamOut;
Ligne 18 :		Ligne 18 :
	</source>		</source>
	*Libérer le paquet et le publier dans le référentiel		*Libérer le paquet et le publier dans le référentiel
			*redémarrer le service, on constate à l'adresse '''http://[hôte]/[service]/server/soap.l1000?wsdl''' que le web service est disponible
			*le wsdl est visible à l'adresse '''http://[hôte]/[service]/server/soap.l1000?wsdl=TestServiceLocal'''
			*on remarque en bas du wsdl la ligne <soap:address location=... qui représente le endpoint soap.

			===Création du token d'authentification===

			Outre les combinaisons utilisateur/mot de passe, il est possible de s'authentifier auprès d'un service web grâce à un token.
			Cette méthode est préférable, elle évite la divulgation du mot de passe et permet la révocation d'un token sans révoquer l'utilisateur.



	===Consommation du paquet de service local créé===		===Consommation du paquet de service local créé===

			Le web service d'authentification est disponible à l'adresse '''http://[hôte]/[service]/server/soap.l1000?wsdl=Sage1000Authentication'''