Passer au contenu principal

Conception > Cloud Code > Scripts

Créez et modifiez des scripts Cloud Code basés sur JavaScript.

Jason Liang avatar
Écrit par Jason Liang
Mis à jour hier

brainCloud permet aux développeurs d'écrire des routines Cloud Code personnalisées en JavaScript, qui résident et s'exécutent sur les serveurs brainCloud, permettant l'exécution du code de manière plus sécurisée et plus efficace que s'il était exécuté côté client.

brainCloud permet également aux développeurs d'organiser leurs scripts de Cloud Code dans des dossiers, afin de mieux les gérer. Cette fonctionnalité constitue la base :

  • d'une plus grande réutilisation des scripts

  • de gestion des scripts hors ligne dans les référentiels sources (c'est-à-dire git)

  • de pousser les mises à jour de script à partir de serveurs de build externes (c'est-à-dire Jenkins)

Le service Cloud Code de brainCloud est implémenté à l'aide d'un moteur Javascript Mozilla Rhino intégré.

Les communications avec les API brainCloud sont facilitées par un objet bridge , disponible depuis tous les scripts. Le bridge permet de récupérer les références aux proxys de service permettant d'effectuer des appels d'API vers brainCloud. Ces proxys de service sont organisés en fonction des modules d'API de brainCloud.

Les avantages des scripts Cloud Code incluent :

  • Meilleures performances lors de l'appel de plusieurs appels d'API consécutifs

  • Coûts brainCloud réduits (les 2 premiers appels API sont gratuits, et chacun des suivants est à moitié prix)

  • Plus sûr

  • Possibilité de modifier la logique côté serveur sans mise à jour du client

  • Possibilité d'appeler des services Web externes

  • Possibilité d'effectuer certaines opérations qui ne sont pas activées dans l'API client

Les scripts Cloud Code peuvent être appelés depuis :

  • applications clientes – via les API du service de script

  • serveurs gérés par les développeurs – via l'API serveur à serveur

  • services tiers – via l'interface WebHooks de brainCloud

  • déclenché via d'autres opérations (API Hooks) – les scripts peuvent être configurés pour être déclenchés automatiquement comme conditions préalables ou postérieures pour d'autres opérations API

  • planifié – scripts programmés pour s'exécuter dans le futur

Les scripts Cloud Code sont écrits à l'aide de l'éditeur de scripts Web de brainCloud optimisé par Monaco Editor, situé dans le portail sous la page Conception > Cloud Code > Scripts .

Définir le niveau JavaScript

  • Accédez à la page Conception > Info de base de l'app > Réglages avancés , dans la section Code Cloud, et sélectionnez Niveau JavaScript dans le menu déroulant.

Créer et gérer des scripts

  • Accédez à la page Conception > Cloud Code > Scripts . Dans le menu Explorateur situé dans le panneau supérieur de la liste des scripts, sélectionnez l'option [Créer un répertoire] pour accéder à la fenêtre contextuelle correspondante. Vous pourrez ainsi désigner un nouveau répertoire pour la création de votre script.

  • Cliquez sur l'icône Action correspondante, les ellipses verticales, pour manipuler les répertoires et les scripts après leur création.

  • Après avoir sélectionné un répertoire et cliqué sur l'option Créer un script à partir de l'icône d'action, ou en utilisant l'icône + située dans la barre de menu supérieure, la fenêtre contextuelle Créer un script s'affiche.

  • Vous pouvez revenir en arrière pour modifier ces métadonnées et paramètres de script en cliquant sur l'icône d'édition dans la barre DÉTAILS.

  • Pour commencer à écrire votre script, veuillez sélectionner le bouton "MODIFIER" dans le coin supérieur droit de la fenêtre d'édition du script.

  • Note: Il existe trois types d'options d'appel pour les scripts :

    • Client : permet d'appeler des scripts depuis les applications clientes via scriptServiceProxy ou depuis l'explorateur d'API du portail via le service de scripts.

    • S2S : permet d'appeler des scripts depuis des serveurs gérés par le client ou depuis le service de scripts S2S Explorer du portail.

    • Peer : cette option s'affiche uniquement sur les applications de service d'appairage, ce qui permet d'appeler des scripts depuis scriptServiceProxy ou depuis l'explorateur d'API du portail via l'API scriptService RunPeerScript(). Pour plus d'informations sur le service d'appairage, consultez la documentation correspondante: service d'appairage.

  • Après avoir configuré les métadonnées de votre script et cliqué sur le bouton CRÉER, un nouvel onglet s'ouvrira. Vous pouvez écrire un script en utilisant la fonctionnalité de saisie semi-automatique intégrée d'Intellisense.

    • Un double-clic sur les scripts depuis le panneau de navigation de gauche permet d'ouvrir plusieurs onglets pour la fenêtre d'édition des scripts. La documentation de l'API est également accessible pour référencer le code pendant l'écriture.

    • Utilisez l'icône de basculement Plein écran pour basculer entre la fenêtre d'édition plein écran et la fenêtre d'édition normale.

    • À l'aide des icônes de fonction, à savoir Explorateur , Rechercher , Exécuter et Déboguer et Réglages , situées dans le coin supérieur gauche de l'écran, basculez entre le mode d'édition et le mode d'affichage normal de la mise en page.

Exécutez et déboguez votre script

  • Cliquez sur le bouton DÉBOGUER pour basculer la disposition de l'éditeur en mode Exécuter et Déboguer .

  • Cliquez sur le bouton [Authentification rapide] pour vous connecter en tant qu'utilisateur actuel du portail, puis cliquez sur "Exécuter" pour tester votre script. Consultez votre journal de débogage, votre requête et votre réponse dans la section "Journaux" à droite de l'écran.

Remarque : le cloud code brainCloud prend en charge le partage de script, ce qui signifie que vous pouvez inclure un autre script dans un script en utilisant simplement la nouvelle opération bridge.include("script_path/scriptname.ccjs").

Par exemple, disons que vous avez ce script :

MathFunctions script:

fonction sumNums( num1, num2 ) { 
return (num1 + num2); 
} 

fonction prodNums( num1, num2 ) { 
return (num1 * num2 ); 
}

Vous pouvez l'inclure à partir d'un autre script de cloud code très simplement :

"use strict"; 
bridge.include("MathFunctions.ccjs"); 

fonction main() { 
var response = {}; 
response.answer = sumNums(data.number1, data.number2); 
return response; 
} 
main();

Note: Le chemin du script est un chemin relatif, donc si vous ne spécifiez pas le chemin dans votre opération d'inclusion, le système recherchera uniquement les scripts dans le même dossier que celui dans lequel se trouve le script actuel.

Pour plus de détails sur l'écriture d'un script de cloud code, reportez-vous à notre documentation ici .

Avez-vous trouvé la réponse à votre question ?