Thereforeâ„¢ Help

1.Pour créer des utilisateurs Therefore™ Portal à partir d'une base de données externe, la base de données ou la table doit fournir au moins l'adresse e-mail de l'utilisateur et un nom d'utilisateur (qui peut être identique à l'adresse e-mail si besoin est).

2.Exécutez une instruction SQL pour insérer de nouvelles entrées dans les colonnes de la table TheUserSync de la base de données Therefore™. Le script suivant illustre la procédure d'extraction de valeurs de la table « CustomerData ».

INSERT INTO TheUserSync (Email,        QueryNo,        UserName,        UserType,        UserPwd,        OneTimePwd,        ConditionXML,        SyncState)

SELECT                                Email,        68,                Email,                4,                NULL,                1,        '<Conds><C><FieldNo>1020</FieldNo><Filter>' + CustomerID + '</Filter></C></Conds>',        1

FROM CustomerData

3.Il est impératif de régler correctement ConditionXML pour limiter les permissions d'affichage de chaque utilisateur. La procédure suivante est recommandée :

i.Créez un exemple d'utilisateur Portal dans Therefore™ Solution Designer.

ii.Définissez la condition appropriée pour cet utilisateur.

iii.Accédez à la base de données Therefore™, puis à la table ThePortalAccess.

iv.Copiez ConditionXML de la colonne ConditionXML pour l'exemple d'utilisateur. Cette valeur servira de gabarit.

v.Modifiez cette chaîne XML pour chaque utilisateur et appliquez la condition appropriée. Modifiez la valeur placée entre les balises <Filter>.

vi.Appliquez la chaîne ConditionXML modifiée à la table TheUserSync.

Vous pouvez créer des utilisateurs Portal à l'aide de l'API ou WebAPI en utilisant un mécanisme similaire à celui décrit ci-dessus.

Utilisation de l'API

Dans l'API, vous devez utiliser la classe « ThePortalUserSync ». Ses propriétés sont similaires à celles de la table de base de données « TheUserSync » mentionnée dans la section ci-dessus.

Cet exemple illustre l'ajout d'une recherche Portal pour un seul utilisateur :

// ajout d'une recherche Portal pour un seul utilisateur

ThePortalUserSync userSync = new ThePortalUserSync();

userSync.Email = "apiPortal@therefore.net";

userSync.QueryNo = 363;

userSync.UserName = "apiPortal@therefore.net";

userSync.UserPwd = string.Empty;  // génère un mot de passe pour l'utilisateur

// ajouter des conditions

TheCondition condition = new TheCondition();

condition.FieldNo = 123;

condition.Condition = "some condition";

userSync.Conditions.Add(condition);

userSync.SavePortalUser(server);d

Pour ajouter plusieurs recherches pour un seul utilisateur, vous devez spécifier la même adresse e-mail/le même nom d'utilisateur et indiquer un autre QueryNo.

L'exemple suivant permet d'ajouter un téléchargement pour un utilisateur Portal.

//ajout d'un téléchargement Portal pour un seul utilisateur

ThePortalUserSync userSyncUpload = new ThePortalUserSync();

userSyncUpload.Email = "apiPortal@therefore.net";

userSyncUpload.CtgryNo = 68;

userSyncUpload.UserName = "apiPortal@therefore.net";

userSyncUpload.UserPwd = string.Empty;

//définir les valeurs prédéfinies des champs de données d'index pour cet utilisateur Portal

userSyncUpload.IndexData.SetCategory(68, server);

userSyncUpload.IndexData.SetValueByFieldID("Text", "some predefined value");

userSyncUpload.SavePortalUser(server);

Utilisation à l'aide de WebAPI

Le fonctionnement de l'appel WebAPI est similaire. Vous trouverez des informations complémentaires dans notre documentation WebAPI :

SavePortalUser (therefore.net)

Exemple d'appel destiné à ajouter une recherche Portal à un utilisateur :

{  

    "PortalUser": {

      "Conditions": [      

           {

               "FieldNoOrName" : "1019",

               "Condition" : "1"

           }      

       ],

      "Email": "myEmail@test.com",

      "IndexDataItems":[],

      "QueryNo": "163",

      "UserName": "test6",

      "UserPwd": "Abcd1234"

   }

}

1.Un utilisateur dont le compte a été créé par synchronisation doit d'abord activer son compte pour recevoir son mot de passe. L'administrateur doit envoyer à chaque utilisateur une notification contenant son nom d'utilisateur et un lien vers la page d'activation de Therefore™ Portal. Lien : http://<nomlocataire>.thereforeonline.com/Portal/PortalActivation.aspx. Remplacez nomlocataire par le nom de votre locataire Therefore™ Online.

2.L'utilisateur doit entrer son nom d'utilisateur et cliquer sur Activer pour recevoir par e-mail son mot de passe généré, qu'il utilise ensuite pour se connecter à Therefore™ Portal.