Conception > Intégrations > Services d'appairage

Les services d'appairage sont conçus pour partager des données et des fonctionnalités entre plusieurs applications. Dans un scénario typique, une application unique, appelée application de service pair, stocke tous les jetons achetés par un utilisateur pour être utilisés par diverses autres applications, appelées applications clientes pairs.

Configurer l'application pair

Si vous n'avez pas configuré d'application en tant que service pair à pair, sur la page Conception > Info de base de l'app > Publication d'appairage , cliquez sur [Modifier] pour commencer à modifier les informations de pair à pair. Pour plus d'informations sur ces options, consultez la documentation relative à la publication pair à pair.
- Cochez l'option Activer en tant que service d'appairage.
- Sélectionnez une option pour la visibilité du service.
- Sélectionnez une option pour l'utilisation de l'API.
- Dans l'onglet Répertoire, ajoutez des informations lisibles sur votre homologue.
Sur la page Conception > Marché > Monnaies virtuelles , ajoutez une monnaie virtuelle en cliquant sur le bouton [CRÉER...] et en lui attribuant un nom.
Passez à une autre application. Sur la page Conception > Intégrations > Services d'appairage , vous trouverez le service d'application pair dans la section Services disponibles. Sélectionnez le service pair que vous venez de créer en cliquant sur l'icône plus pour le connecter.
Dans la boîte de dialogue Ajouter Service d'appairage, saisissez un nom dans le champ Code de service. (Cette valeur est utilisée lors des appels d'API vers le service pair via l'application actuelle.) Cliquez ensuite sur [Sauvegarder].
Vous trouverez désormais le service pair que vous avez sélectionné dans la section Services connectés.
Accédez à la page Conception > Marché > Monnaies virtuelles ; les devises des applications pairs devraient apparaître dans la section Devises d'appairage.

Tester les données de l'application pair

Appelez l'API AttachPeerProfile() du service Identity en spécifiant le code du service pair (ici "peerLib") et les identifiants de connexion de l'usager actuel sur la page Explorateur d'API. Un nouvel usager sera créé dans l'application du service pair et associé à l'usager actuel dans l'application cliente pair.
Sur la page Usager > Résumé > Résumé de l'usager, la relation entre pairs apparaît dans la liste Relations.
Retournez à la page de l'explorateur d'API, appelez l'API AwardPeerCurrency () depuis le service VirtualCurrency, définissez les paramètres suivants : l'identifiant de la monnaie virtuelle avec le nom que vous avez défini dans l'application de service pair, une valeur pour le montant et le code du service pair.
Passez à l'application de service pair à pair (ici "peerLib"). Sur la page Usager > Résumé > Résumé de l'utilisateur , vous trouverez les informations du client pair à pair (la monnaie virtuelle que vous avez ajoutée depuis l'application client pair à pair et les relations avec les applications clientes dans la section Relations).

Test avec des crochets

Accédez à la page de l'application de service pair Conception > Info de base de l'app > Publication d'appairage et liez un script pour Valider la configuration depuis l'onglet Points d'encrages.

Remarque : ce script createAsset prendra certains paramètres et créera une entité personnalisée comme ci-dessous.

"use strict";

function main() {

	var response = {};
        // définir une clé valide pour la validation de la configuration 
        response.valid = true;

	bridge.logDebugJson("Script inputs", data);
	
	var templateResc = {
      "assetType": "templateType",
      "assetUrl": "templateUrl",
      "assetDesc": "tempalteDesc"
    };
    
    // si l'appel provient d'une application pair, le système ajoute automatiquement le paramètre peerConfig 

    var addpeerConfig = Object.assign({"peerConfig":"someconfigs"},templateResc);
    
    var checkkeymessage = null;
    
    // boucle sur la clé JSON d'entrée, générer une erreur si une clé invalide est trouvée 

    for (var x in data){
        if(!addpeerConfig.hasOwnProperty(x)){
            checkkeymessage = "invalid key found: "+ x;
            response.createResult = checkkeymessage;
            break;
        }
    }
    
    if(!checkkeymessage){
        //Compter le nombre d'entités avant de créer une nouvelle entité personnalisée ; ce nombre détermine l'assetId 

        var entityType = "asset";
        var context = {
          "pagination": {
            "rowsPerPage": 100,
            "pageNumber": 1
          },
          "searchCriteria": {
          },
          "sortCriteria": {
            "createdAt": 1
          }
        }
        
        var customEntityProxy = bridge.getCustomEntityServiceProxy();
        
        var postResult = customEntityProxy.sysGetEntityPage(entityType, context);
        if (postResult.status == 200) {
            
            // Créer une nouvelle entité avec les champs JSON définis
            var assetId = postResult.data.results.count + 1;
            
            // Autoriser l'utilisateur à saisir zéro ou les trois paramètres du modèle. 

            var dataJson = Object.assign({"assetId": assetId.toString()}, templateResc, data);
            var acl = {
              "other": 2
            };
            var timeToLive = null;
            var owner = null;
            
            var createResult = customEntityProxy.sysCreateEntity(entityType, dataJson, acl, timeToLive, owner);
            if (createResult.status == 200) {
                // Success!
                response.createResult = "asset with id "+assetId+" is successfully created!"
            }
        }
    }
	return response;
}

main();

Passez à une application cliente pair sur la page Usager > Résumé > Résumé de l'usager, et sélectionnez un usager qui a associé une identité pair à l'application de service d'appairage, puis cliquez sur Se connecter en tant qu'usager pour définir l'usager actuel du portail.
Accédez à la page Conception > Intégrations > Services d'appairage, recherchez ce serveur d'application pair et cliquez sur [Voir...] dans la liste Services connectés et ensuite sur [Modifier]. Saisissez les données requises par le script en tant que paramètres dans la section Paramètres de configuration. Cliquez sur Sauvegarder.
Revenez à l'application de service d'appairage sur la page Global > Data Global > Entités personnalisées ; l'entité personnalisée devrait y figurer. Elle a été créée à partir d'une application cliente pair lors de l'étape de validation précédente.

Scripts d'appel entre pairs

Accédez à l'application de service pair sur la page Conception > Cloud Code > Scripts , créez ou importez des scripts et assurez-vous que l'option "Peer" est cochée sous Appelable par le client dans la boîte de dialogue de l'éditeur de script.
Ensuite, les utilisateurs de votre application cliente pair qui ont attaché une identité pair associée à cette application de service d'appairage peuvent appeler ce script en exécutant l'API RunPeerScript () du service ScriptService avec le code du service d'appairage.

Pour une illustration supplémentaire de l'utilisation des services d'appairage, veuillez consulter l'article suivant pour plus d'informations.