Voir la source de $connect (sdata)

{{Version700}}

Le service SData supporte une fonction système pour ouvrir une session ou obtenir des information à propos de la session ouverte.

L'url de cette fonction est :

<pre>http://www.example.com/service/server/sdata/$connect</pre>

Pour un service utilisant le serveur HTTP intégré l'URL peut être simplifiée :

<pre>http://www.example.com/sdata/$connect</pre>

Les requêtes de méthode GET/HEAD/POST sont autorisées.

{|class="wikitable"
|-
!Méthode
!Paramètres
|-
|GET/HEAD
|Dans l'URL
|-
|POST
|Dans le payload, [http://www.w3.org/TR/html401/interact/forms.html#h-17.13.4.1 format form-encoded ]
|}

Lorsque un identifiant de session est passé en paramètre la session correspondante est contrôlée, si elle est valide cette session est réutilisée et la requête n'alloue pas de nouvelle session. La configuration de la session peut être ensuite modifiée suivant les paramètres de la requête.

===Paramètres===
Les paramètres supportés sont :

{|class="wikitable"
|-
!Paramètre
!Usage
|-
|username
|Identifiant de l'utilisateur
|-
|password
|Mot de passe de l'utilisateur
|-
|groupName
|Autorisé en tant que membre de ce groupe 
|-
|authdirectory
|Annuaire d'identité
|-
|md5
|Hash md5 du mot de passe
|-
|society
|Dossier où ouvrir une session
|}

{{tip|Le paramètre '''society''' est optionnel si le Service sert un seul dossier.}}

Pour un dossier multi-sociétés les paramètres suivants sont optionnels :

{|class="wikitable"
|-
!Paramètre
!Usage
|-
|shareSociety
|Société de travail du dossier si le dossier est multi-sociétés
|-
|shareSocieties
|Sociétés de restitution du dosser si le dossier est multi-sociétés
|}

===Code de retour===
{|class="wikitable"
|-
!Code
!Contenu
!Usage
|-
|200
|Information de session
|La session est connectée
|-
|403
|Forbidden
|Les informations d'authentification ne sont pas valident
|-
|404
|Dépend de la raison
|La session est connecté mais les informations de configuration du contexte ne sont pas valident.
|}

===Contenu===
Lorsque la la requête retourne 200 le contenu contient des informations sur la configuration de la session.

Le format de la réponse dépend de la valeur du paramètre ''Accept'' de l'entête de la requête, les formats supportés sont json,text,xml. 

Les paramètres retournés sont :

{{:Informations de session (server)}}


exemple
<pre>
POST /sdata/$connect HTTP/1.1
Content-Type: application/x-www-form-urlencoded
Host: localhost
Content-Length: 13
 
username=sage&password=pwd
</pre>

<pre>
https://pc100301/sdata/$connect
OK
{
   "methodResponse":{
      "params":{
         "username":"syfre",
         "userfullname":"....",
         "userlanguage":"FRA",
         "useremail":"...@sage.com",
         "groupname":"Projet 1000",
         "groupcaption":"Groupe Projet 1000",
         "authdirname":"enterprise",
         "socname":"8.00 - Suite Multi",
         "appname":"Sage FRP 1000 Suite Financière",
         "glbShareEnable":"true",
         "glbShareRestitution":"false",
         "glbShareAllPerimeters":"false",
         "glbShareRestitutionName":"",
         "glbShareSocieties":"AC2B84B4153A03FE07220000024D0048",
         "glbSharePerimeters":"AC2B84B4153A03FE06A1000002370002,....,AC2B84B4153A03FE07220000024C0004",
         "glbShareGroupMode":"false",
         "glbShareGroupPerimeter":"AC2B84B4153A03FE06A1000002370002",
         "glbShareSocietyPerimeter":"AC2B84B4153A03FE07220000024D0048",
         "GlbShareSocietyName":"S2",
         "GlbSharePerimeterNames":"Dossier,S2,P2 Services,T2 Tiers categorie 2",
         "GlbShareSocietyNames":"S2",
         "GlbShareAutorized":{
            "society":[
               {
                  "title":"S2",
                  "oid":"AC2B84B4153A03FE07220000024D0048"
               }
            ]
         },
         "ShareState":"AC2B84B4153A03FE06A1000002370002.....................",
         "ShareSociety":"AC2B84B4153A03FE07220000024D0048",
         "ShareSocietyName":"S2",
         "ShareRestitution":"false",
         "ShareAllPerimeters":"false",
         "ShareStateCaption":"S2",
         "database":"CF_db800SuiteMonobaseMultisoc",
         "databases":[
            "CF_db800SuiteMonobaseMultisoc"
         ],
         "GA":{
            "dialogUrl":"https://eme.sage.fr/pep/home.html",
            "enable":false,
            "ua":""
         },
         "menu":{
            "id":"",
            "caption":""
         }
      }
   }
}</pre>

Voir aussi:

[[Category:SData]]
[[Category:$SData]]
[[Category:Mobile]]
[[Category:Version700]]