Workbook French

Manuel d'utilisation Force.com: Salesforce Summer '10

Manuel d'utilisation Force.com

Copyright 2000-2010 salesforce.com, inc. Tous droits rservs. Salesforce.com, le logo "no software" et Team Edition sont des marquesdposes, et AppExchange, "Success On Demand" et "The Business Web" sont des marques de commerce de salesforce.com, inc. Toutes

les autres marques mentionnes dans ce document sont la proprit de leur dtenteur respectif.

Table des matires

propos du Manuel d'utilisation Force.com........................................................................................................................................3Didacticiel n 1 : Cration d'une application Entrept..........................................................................................................................5

tape 1 : Cration d'un objet personnalis Article....................................................................................................................5tape 2 : Ajout des champs Description, Prix et Inventaire total..............................................................................................7tape 3 : Cration d'un onglet...................................................................................................................................................9tape 4 : Cration d'une sous-application Entrept................................................................................................................10tape 5 : Cration d'un enregistrement Article.......................................................................................................................11Rsum....................................................................................................................................................................................12

Didacticiel n 2 : Ajout de relations.....................................................................................................................................................13tape 1 : Cration d'un objet personnalis Relev de facture..................................................................................................13tape 2 : Cration d'un objet lment de ligne.......................................................................................................................16tape 3 : Association des objets...............................................................................................................................................17tape 4 : Ajout de relevs de facture la sous-application......................................................................................................18tape 5 : Cration d'un enregistrement Facture......................................................................................................................18Rsum....................................................................................................................................................................................20

Didacticiel n 3 : Utilisation de formules et de rgles de validation.....................................................................................................21tape 1 : Calcul d'une valeur pour chaque Elment de ligne...................................................................................................21tape 2 : Calcul d'une valeur pour le Relev de facture avec un champ rcapitulatif de cumul...............................................22tape 3 : Contrle d'inventaire avec une rgle de validation...................................................................................................23tape 4 : Test de la rgle de validation.....................................................................................................................................25tape 5 : Amlioration de la rgle de validation......................................................................................................................26Rsum....................................................................................................................................................................................27

Didacticiel n 4 : Utilisation de workflow et d'approbations................................................................................................................28tape 1 : Renseignement du prix d'lment de ligne l'aide d'une rgle de workflow............................................................29tape 2 : Mise jour de l'inventaire total lors d'une commande.............................................................................................30tape 3 : Test des rgles de workflow......................................................................................................................................32tape 4 : Cration d'un modle d'e-mail.................................................................................................................................33tape 5 : Cration d'un processus d'approbation.....................................................................................................................34tape 6 : Cration d'un profil de scurit personnalis............................................................................................................36tape 7 : Cration d'un utilisateur...........................................................................................................................................37tape 8 : Test du processus d'approbation...............................................................................................................................38Rsum....................................................................................................................................................................................40

Didacticiel n 5 : Ajout d'une logique commerciale avec Apex............................................................................................................41tape 1 : Cration d'une dfinition de dclencheur Apex.......................................................................................................42tape 2 : Dfinition d'une variable de liste..............................................................................................................................43tape 3 : Itration sur une liste et modification du prix..........................................................................................................44tape 4 : Test du dclencheur..................................................................................................................................................45Rsum....................................................................................................................................................................................46

Didacticiel n 6 : Ajout de tests l'application....................................................................................................................................47tape 1 : Cration d'une classe de test Apex...........................................................................................................................48tape 2 : Ajout de mthodes de test la classe........................................................................................................................48

Manuel d'utilisation Force.com | Table des matires | i

tape 3 : Ecriture du code excutant le dclencheur...............................................................................................................49tape 4 : Excution du test......................................................................................................................................................50tape 5 : Affichage de la couverture de code et amlioration des tests....................................................................................51Rsum....................................................................................................................................................................................53

Didacticiel n 7 : laboration d'une interface utilisateur personnalise en utilisant Visualforce..........................................................54tape 1 : Activation du Mode de dveloppement de Visualforce............................................................................................54tape 2 : Cration d'une page Visualforce...............................................................................................................................55tape 3 : Ajout d'une ressource statique Feuille de style.........................................................................................................56tape 4 : Ajout d'un contrleur la page................................................................................................................................58tape 5 : Affichage de la Feuille d'inventaire en tant que page Visualforce.............................................................................59Rsum....................................................................................................................................................................................61

Didacticiel n 8 : Cration d'une page Web publique en utilisant les Sites..........................................................................................62tape 1 : Cration d'une page de catalogue de produits..........................................................................................................62tape 2 : Enregistrement d'un nom de domaine Force.com....................................................................................................64tape 3 : Cration d'un site Force.com....................................................................................................................................65tape 4 : Configuration et test du site.....................................................................................................................................65Rsum....................................................................................................................................................................................67

Didacticiel n 9 : Cration d'une boutique..........................................................................................................................................68tape 1 : Cration d'un contrleur..........................................................................................................................................68tape 2 : Ajout de mthodes au contrleur.............................................................................................................................69tape 3 : Cration de la boutique............................................................................................................................................70tape 4 : Bonus - Mise jour de la page avec AJAX...............................................................................................................72Rsum....................................................................................................................................................................................73

Didacticiel n 10 : Cration d'une sous-application de bureau avec Adobe Flash Builder for Force.com............................................75tape 1 : Configuration des informations personnelles Salesforce.com...................................................................................76tape 2 : Cration d'une Configuration de porte-documents hors-ligne................................................................................77tape 3 : Gnration de votre WDSL Entreprise et tlchargement d'un certificat client.....................................................79tape 4 : Installation et lancement de Adobe Flash Builder for Force.com.............................................................................80tape 5 : Cration d'un projet Force.com Stratus....................................................................................................................80tape 6 : Dfinition des attributs du composant Stratus Application.....................................................................................82tape 7 : Cration d'un composant Window Suivi Inventaire................................................................................................83tape 8 : Test de la sous-application Suivi Inventaire..............................................................................................................87Rsum....................................................................................................................................................................................89

Annexe................................................................................................................................................................................................90Cration et connexion un environnement test sandbox........................................................................................................90Cration d'un projet dans l'IDE Force.com.............................................................................................................................90Distribution de votre application.............................................................................................................................................91

Manuel d'utilisation Force.com | Table des matires | ii

propos du Manuel d'utilisation Force.comLe Manuel d'utilisation Force.com prsente comment crer une application dans une srie de didacticiels. Vous pouvez utiliserla plate-forme Force.com pour laborer toutes sortes d'applications, mais la plupart des applications partagent certainescaractristiques, notamment :

Une base de donnes pour modliser les informations dans l'application Une logique commerciale et un workflow pour effectuer des tches spcifiques dans certaines conditions Une interface utilisateur pour prsenter les donnes et les fonctionnalits aux utilisateurs connects votre application Un site Internet public pour montrer les donnes et les fonctionnalits sur le Web

Les didacticiels sont axs sur l'laboration d'un systme trs simple de gestion d'un entrept. Vous allez dvelopper entirementl'application, c'est--dire que vous allez commencer par laborer un modle de base de donnes pour le suivi des articles. Vousallez ensuite ajouter une logique commerciale : des rgles de validation pour s'assurer que le stock est suffisant, un workflowpour mettre jour l'inventaire lors d'une vente, des approbations pour envoyer des notifications par e-mail pour les valeurs defacturation importantes et une logique de dclenchement pour mettre jour les prix dans les factures en cours. Une fois la basede donnes et la logique commerciale termines, vous allez crer une interface utilisateur pour montrer l'inventaire d'un produitau personnel, un site Web public pour prsenter un catalogue de produits, puis les premiers lments d'une boutique simple.Pour le dveloppement hors ligne et l'intgration la sous-application, nous avons ajout un dernier didacticiel qui prsentel'utilisation de Adobe Flash Builder for Force.com.

Chaque didacticiel repose sur les didacticiels prcdents selon une progression logique dans le dveloppement de l'application,et prsente en mme temps une fonctionnalit particulire de la plate-forme. Cela parat beaucoup, mais vous allez rapidementapprcier la simplicit des points abords.

Choix d'un environnement de dveloppementLe manuel est conu pour tre utilis dans une organisation Developer Edition qui offre l'ensemble des fonctionnalits etfonctions requises. Pour vous abonner gratuitement une organisation Developer Edition, accdez la pagedeveloper.force.com/join.

Vous pouvez toutefois utiliser la version Free Edition, en tenant compte des points ci-dessous.

Certains didacticiels ncessitent l'utilisation d'un environnement test sandbox. Il est par consquent plus facile de terminertous les didacticiels au sein d'une organisation test sandbox. Si vous n'avez pas encore cr d'environnement test sandbox,reportez-vous Cration et connexion un environnement test Sandbox la page 90.

Vous ne pouvez pas utiliser la version Free Edition pour terminer le Didacticiel n 10 : Cration d'une sous-application debureau avec Adobe Flash Builder for Force.com. En tant qu'aperu pour dveloppeur, Adobe Flash Builder for Force.comest disponible uniquement dans Developer Edition.

Les images du manuel peuvent tre lgrement diffrentes de celles affiches sur votre cran. Par exemple, DeveloperEdition utilise un onglet Dmarrer ici, tandis que Free Edition inclut un onglet Premiers pas. Dans la plupart des cas, lesdiffrences sont insignifiantes.

Manuel d'utilisation Force.com | propos du Manuel d'utilisation Force.com | 3

Une fois l'application termine, vous pouvez migrer les modifications depuis votre environnement test vers un environnementde production. Pour plus d'informations, reportez-vous Distribution de votre application la page 91.

Pour vous abonner une organisation Free Edition, accdez salesforce.com/form/signup/freeforce-platform.jsp.

Organisation du manuelLes didacticiels de ce manuel se compltent et s'inscrivent dans une progression logique.

Dure estimeNiveauDidacticiel

Crer la sous-application

20 30 minutesDbutantDidacticiel n 1 : Cration d'une application Entrept

20 30 minutesDbutantDidacticiel n 2 : Ajout de relations

Ajouter une logique

20 30 minutesDbutantDidacticiel n 3 : Utilisation de formules et de rgles de validation

30 45 minutesIntermdiaireDidacticiel n 4 : Utilisation de workflow et d'approbations

20 30 minutesAvancDidacticiel n 5 : Ajout d'une logique commerciale avec Apex

Ecrire des tests

20 30 minutesAvancDidacticiel n 6 : Ajout de tests l'application

tendre l'interface utilisateur

30 45 minutesIntermdiaireDidacticiel n 7 : laboration d'une interface utilisateur personnalise enutilisant Visualforce

20 30 minutesIntermdiaireDidacticiel n 8 : Cration d'une page Web publique en utilisant les Sites

30 minutesIntermdiaireDidacticiel n 9 : Cration d'une boutique

Intgration hors ligne

30 minutesAvancDidacticiel n 10 : Cration d'une sous-application de bureau avec AdobeFlash Builder for Force.com.

Annexe

Cration et connexion un environnement test sandbox

Cration d'un projet dans l'IDE Force.com

Distribution de votre application

En savoir plusChaque tape se termine par une section facultative En savoir plus. Pour avancer rapidement, passez l'tape suivante. Sitoutefois vous souhaitez approfondir, ces sections contiennent de nombreuses informations utiles et des tapes supplmentairespour toffer votre sous-application.

Pour en savoir plus sur Force.com et accder un vaste ensemble de ressources, visitez le site Developer Force l'adressedeveloper.force.com.

La dernire version de ce Manuel et des didacticiels complmentaires permettant d'tendre la sous-application sontdisponibles la page developer.force.com/workbook.

Manuel d'utilisation Force.com | propos du Manuel d'utilisation Force.com | 4

Didacticiel n 1 : Cration d'une application EntreptNiveau : Dbutant ; Dure : 20 30 minutes

Cette application repose sur ce que vous vendez : des articles. Vous commencez par crer un objet de donnes qui permet desuivre tous les lments relatifs un article spcifique, par exemple son nom, sa description, son prix, etc. Dans la plate-formeForce.com, ces objets de donnes sont appels objets personnaliss. Si vous matrisez le concept de bases de donnes, vous pouvezcomparer un objet personnalis un tableau.

Un objet contient des champs standard, ainsi que des crans qui permettent de rpertorier, d'afficher et de modifier lesinformations relatives l'objet. Vous pouvez toutefois ajouter vos propres champs afin de suivre ou de rpertorier tout lmentde votre choix. Une fois ce didacticiel termin, vous disposerez d'une application fonctionnelle dote de son propre menu, d'unonglet et d'un objet personnalis permettant de suivre le nom, la description et le prix de vos articles, ainsi que d'cransd'affichage et modification de ces informations.

Voir aussi :tape 1 : Cration d'un objet personnalis Articletape 2 : Ajout des champs Description, Prix et Inventaire totaltape 3 : Cration d'un onglettape 4 : Cration d'une sous-application Entrepttape 5 : Cration d'un enregistrement ArticleRsum

tape 1 : Cration d'un objet personnalis ArticleLa plate-forme Force.com inclut des objets standard prdfinis, mais vous pouvez galement crer des objets personnalissafin de suivre tout lment de votre choix. La premire tape consiste crer un objet personnalis capable de contenir lesinformations sur l'article.

1. Lancez un navigateur et accdez la page https://login.salesforce.com.2. Saisissez votre nom d'utilisateur (sous forme d'adresse de messagerie) et votre mot de passe.3. Cliquez sur Configuration dans le coin suprieur droit, puis sur CrerObjets dans le menu latral pour afficher la page

Objets personnaliss.

Manuel d'utilisation Force.com | Didacticiel n 1 : Cration d'une application Entrept | 5

4. Cliquez sur Nouvel objet personnalis pour afficher l'assistant Nouvel objet personnalis.5. Renseignez la dfinition de l'objet personnalis.

Dans le champ tiquette, saisissez Article. Dans le champ tiquette - pluriel, saisissez Articles. Laissez les autres champs inchangs.

6. Cliquez sur Enregistrer pour terminer la cration de l'objet.

En savoir plusUne fois le nouvel objet personnalis enregistr, la page de dtails le l'objet personnalis s'ouvre. Observez l'image ci-dessouspour vous familiariser avec l'objet personnalis Article.


1. Page de dtails Article : cette page affiche toutes les informations utiles relatives votre objet personnalis Article. Vousallez bientt ajouter des champs, des relations, des rgles de validation et d'autres fonctionnalits simples pour cet objetpersonnalis.

2. Nom API : lors de la cration de l'objet Article, vous n'avez spcifi aucun nom d'API, il a t automatiquement gnr.Ce nom sert rfrencer l'objet dans la programmation. Tous les objets personnaliss se terminent par __c, qui permetde les diffrencier des objets standard et de faciliter leur identification.

3. Champs standard : certains champs, appels champs standard, sont automatiquement gnrs. Par exemple, l'objet Articlecontient un champ standard Responsable, qui suit automatiquement le crateur de chaque enregistrement.

4. Champs personnaliss : vous n'avez pas encore dfini de champ personnalis, vous le ferez l'tape suivante. Si vous avezdevin que les noms des champs personnaliss se terminent par __c, bien vu !

Voir aussi :Didacticiel n 1 : Cration d'une application Entrepttape 2 : Ajout des champs Description, Prix et Inventaire total

tape 2 : Ajout des champs Description, Prix et Inventaire totalUn objet article doit contenir les champs qui permettent de suivre diverses informations, notamment la description, le cot etla quantit en stock. Vous pouvez ajouter des champs afin de rpertorier ou de suivre tout lment de votre choix.

Suivez les tapes ci-dessous afin de crer des champs personnaliss pour la description, le prix et l'inventaire.

1. Crez le champ Description.

a. Accdez la liste associe Champs personnaliss & relations.b. Cliquez sur Nouveau pour lancer l'assistant Nouveau champ personnalis.c. Dans la zone Type de donnes, slectionnez Zone de texte, puis cliquez sur Suivant.


d. Renseignez les dtails des champs personnaliss.

Dans le champ tiquette du champ, saisissez Description et appuyez sur la touche Tabulation. Le champ Nom du champ doit tre automatiquement renseign avec le nom de champ : Description. Slectionnez la case Obligatoire. L'une de vos rgles commerciales indique que vous ne pouvez pas crer d'article

sans fournir une description. Rendre le champ Description obligatoire satisfait cette rgle commerciale. Vous pouvez renseigner les champs facultatifs Description et Texte d'aide. Il est recommand de renseigner

ces champs, mais nous les laissons de ct dans ce didacticiel pour gagner du temps. Ne renseignez pas le champ Valeur par dfaut.

e. Cliquez sur Suivant, acceptez les valeurs par dfaut, puis cliquez de nouveau sur Suivant.f. Cliquez sur Enregistrer et Nouveau pour enregistrer le champ Description et revenir la premire tape de l'assistant.

2. Crez le champ Prix.

a. Dans la zone Type de donnes, slectionnez Devise, puis cliquez sur Suivant.b. Renseignez les dtails des champs personnaliss :

Dans le champ tiquette du champ, saisissez Prix. Dans le champ Longueur, saisissez 16, puis saisissez 2 dans le champ Dcimales. Slectionnez la case Obligatoire.

c. Laissez les autres champs inchangs, puis cliquez sur Suivant.d. l'tape suivante, acceptez les valeurs par dfaut, puis cliquez sur Suivant.e. l'tape suivante, cliquez sur Enregistrer et nouveau pour enregistrer le champ Prix et revenir la premire tape

de l'assistant.


Remarque: Cette sous-application ne contient qu'un seul champ Prix que nous allons utiliser pour le cours et leprix de dtail. Vous pouvez cependant crer un autre champ Cours si vous le souhaitez, il suffit de rpter les tapesci-dessus et d'utiliser le nom Cours.

3. Crez le champ Inventaire total.

a. Dans la zone Type de donnes, slectionnez Numro, puis cliquez sur Suivant.b. Renseignez les dtails des champs personnaliss :

Dans le champ tiquette du champ, saisissez Inventaire total. Slectionnez la case Obligatoire.

c. Acceptez les valeurs par dfaut des autres champs, puis cliquez sur Suivant.d. l'tape suivante, acceptez les valeurs par dfaut, puis cliquez sur Suivant.e. Cliquez sur Enregistrer pour crer le champ Inventaire et revenir la page Objet personnalis Article.

ce stade, nous disposons d'une prsentation claire de nos articles d'inventaire, avec un nom, une description et un prix. Nousavons galement enregistr la quantit (Inventaire total) dont nous disposons pour chaque article.

En savoir plusPeut-tre avez-vous remarqu que lors de la saisie de l'tiquette du champ, le systme a automatiquement renseign lechamp Nom du champ. Pourquoi avez-vous besoin des deux champs ? Une tiquette du champ est visible par l'utilisateur,il doit tre facile lire et peut contenir des espaces. Le Nom du champ est utilis en interne, dans le code, et ne doit pascontenir d'espace ou des caractres spciaux. Par exemple, le champ tiquet Client ph# : serait nomm Client_ph dansle code (le systme remplace les espaces par des caractres de soulignement, et supprime les caractres # et : ).

Voir aussi :Didacticiel n 1 : Cration d'une application Entrepttape 1 : Cration d'un objet personnalis Articletape 3 : Cration d'un onglet

tape 3 : Cration d'un ongletLes onglets permettent de rechercher et d'organiser aisment les objets et les enregistrements. Dans cette tape, vous allezcrer un onglet pour l'objet personnalis Article. Lorsque les utilisateurs cliquent sur cet onglet, ils peuvent crer, afficher etmodifier les enregistrements.

1. Dans le menu de Configuration, cliquez sur CrerOnglets.2. Dans la liste associe Onglets de l'objet personnalis, cliquez sur Nouveau pour lancer l'assistant Onglet Nouvel objet

personnalis.3. Dans la liste droulante Objet, slectionnez Article.4. Cliquez sur l'icne de recherche en regard du champ Style d'onglet, puis slectionnez l'icne Bote.


5. Acceptez les autres valeurs par dfaut, puis cliquez sur Suivant.6. Cliquez sur Suivant, puis sur Enregistrer pour terminer la cration de l'onglet.

Une fois l'onglet cr, il s'affiche en haut de l'cran.

En savoir plusLors de la cration d'un onglet, vous n'tes pas limit un ensemble d'icnes et de couleurs standard, vous pouvez slectionnerla couleur de votre choix et une image personnalise en cliquant sur Crer votre propre style.

Voir aussi :Didacticiel n 1 : Cration d'une application Entrepttape 2 : Ajout des champs Description, Prix et Inventaire totaltape 4 : Cration d'une sous-application Entrept

tape 4 : Cration d'une sous-application EntreptUne application est un ensemble d'onglets. Dans cette tape, vous allez crer une application Entrept et lui ajouter un onglet.Vous lui ajouterez plus tard des onglets supplmentaires.

1. Cliquez sur Configuration Crer Sous-applications.2. Cliquez sur Nouveau pour lancer l'assistant Nouvelle sous-application personnalise.3. Renseignez les dtails des champs de la sous-application.

Dans le champ tiquette de sous-application, saisissez Entrept. Dans le champ Nom de la sous-application, saisissez Entrept.


4. Cliquez sur Suivant.5. Acceptez les valeurs par dfaut de cette page, en acceptant le logo par dfaut pour la sous-application, puis cliquez sur

Suivant.6. Dans la liste Onglets disponibles, slectionnez l'onglet Articles, puis cliquez sur Ajouter pour l'ajouter la liste des onglets

slectionns.

7. Laissez le champ Onglet de destination par dfaut dfini sur l'onglet Accueil, puis cliquez sur Suivant.8. Slectionnez la case Visible pour rendre l'application disponible pour tous les profils d'utilisateur.9. Cliquez sur Enregistrer pour crer l'application Entrept.

Une fois l'application cre, elle s'affiche dans le menu Sous-applications Force.com, en haut droite de la page.

En savoir plusLes onglets de cette application ne doivent pas obligatoirement tre associs. Vous pouvez modifier les applications personnalisesafin de regrouper un emplacement commun les onglets que vous utilisez le plus souvent. Par exemple, si vous avez souventrecours l'onglet Dmarrer ici, vous pouvez l'ajouter la sous-application Entrept. Vous pouvez basculer vers l'une desapplications que vous avez cres, achetes ou installes en slectionnant simplement son nom dans le menu.

Voir aussi :Didacticiel n 1 : Cration d'une application Entrepttape 3 : Cration d'un onglettape 5 : Cration d'un enregistrement Article

tape 5 : Cration d'un enregistrement Article ce stade, vous avez cr une application qui fonctionne. Lors de la dfinition d'un objet dans Force.com, la plate-formegnre automatiquement une interface utilisateur qui permet de crer, de lire, de mettre jour et de supprimer desenregistrements. Observez maintenant le fonctionnement de votre sous-application.

1. Slectionnez l'application Entrept dans le menu des sous-applications Force.com.


2. Cliquez sur l'onglet Articles, puis cliquez sur Nouveau pour crer un produit.3. Renseignez tous les champs.

Dans le champ Nom de l'article, saisissez Wee Jet. Dans le champ Description, saisissez Un petit avion. Dans le champ Prix, saisissez 9,99. Dans le champ Inventaire total, saisissez 2000.

comme indiqu sur l'image suivante.

4. Cliquez sur Enregistrer.

En savoir plusVotre entrept peut fonctionner avec un seul article, mais il serait plus raliste de lui ajouter des articles. Crez davantaged'articles. Astuce : utilisez le bouton Enregistrer et Nouveau pour crer rapidement des enregistrements.

Voir aussi :Didacticiel n 1 : Cration d'une application Entrepttape 4 : Cration d'une sous-application EntreptRsum

RsumFlicitations ! Vous venez de crer une application Entrept qui permet de suivre les produits que vous possdez en stock.Comme vous l'avez constat, il est facile d'utiliser l'interface en ligne pour crer un objet personnalis, des champs et un onglet,puis de les organiser dans une application permettant de crer et de suivre les informations associes vos articles. Bien quel'application soit trs incomplte, elle contient dj de nombreuses fonctionnalits intgres, notamment la possibilit d'afficheret de crer des articles.

L'tape suivante prsente l'utilisation d'une facture afin de suivre les mouvements d'entre et de sortie des articles dans l'entrept.

Voir aussi :Didacticiel n 1 : Cration d'une application Entrepttape 5 : Cration d'un enregistrement Article


Didacticiel n 2 : Ajout de relationsNiveau : Dbutant ; Dure : 20 30 minutes

Ce didacticiel prsente comment crer deux objets, un relev de facture et un lment de ligne, puis comment les associer dansune relation principal-dtails. Cette relation permet de composer plusieurs lments de ligne et de les associer un seul relevde facture. Chaque lment de ligne indique la quantit d'units vendues pour un article particulier. Vous allez par consquentajouter une relation entre les articles et les objets d'lments de ligne.

Si vous matrisez le concept de bases de donnes relationnelles, vous pouvez comparer une relation des cls trangres, ladiffrence que Force.com effectue la mise en uvre sous-jacente pour vous, vous vous contentez de dfinir les associationsentre les objets.

PrrequisSous-application Entrept

Vous devez commencer par crer une application Entrept de base en suivant les instructions du Didacticiel n 1 :Cration d'une application Entrept la page 5.

Voir aussi :tape 1 : Cration d'un objet personnalis Relev de facturetape 2 : Cration d'un objet lment de lignetape 3 : Association des objetstape 4 : Ajout de relevs de facture la sous-applicationtape 5 : Cration d'un enregistrement FactureRsum

tape 1 : Cration d'un objet personnalis Relev de factureUn relev de facture est requis pour les mouvements d'entre et de sortie d'inventaire dans l'entrept. Dans cette tape, vousallez crer un relev de facture avec un numro unique, un statut et une description.

1. Cliquez sur Configuration CrerObjets.2. Cliquez sur Nouvel objet personnalis, puis dfinissez l'objet personnalis.

Dans le champ tiquette, saisissez Relev de facture Dans le champ tiquette - pluriel, saisissez Relevs de facture Dans le champ Nom de l'enregistrement, saisissez Numro de facture Dans le champ Type de donnes, slectionnez Numro automatique

Manuel d'utilisation Force.com | Didacticiel n 2 : Ajout de relations | 13

Dans le champ Format d'affichage, saisissez FACT-{0000} Dans le champ Numro de dbut, saisissez 1.

3. Laissez les autres valeurs inchanges, puis cliquez sur Enregistrer.4. Ajoutez un champ Statut.

a. Accdez la liste associe Champs personnaliss & relations, puis cliquez sur Nouveau.b. Dans la zone Type de donnes, slectionnez Liste de slection, puis cliquez sur Suivant.c. Renseignez les dtails des champs personnaliss.

Dans le champ tiquette du champ, saisissez Statut. Saisissez les valeurs de liste de slection suivantes dans la zone fournie, une entre par ligne.

En cours Ferm Ngociation En attente

Slectionnez la case Utiliser la premire valeur comme valeur par dfaut.


d. Cliquez sur Suivant.e. Dans la zone Scurit au niveau du champ, slectionnez Lecture seule, puis cliquez sur Suivant.f. Cliquez sur Enregistrer et Nouveau.

5. Crez maintenant un champ Description facultatif.

a. Dans la zone Type de donnes, slectionnez Zone de texte, puis cliquez sur Suivant.b. Dans les champs tiquette du champ et Nom du champ, saisissez Description.c. Cliquez sur Suivant, acceptez les valeurs par dfaut, puis cliquez de nouveau sur Suivant.d. Cliquez sur Enregistrer pour accder la page de dtails de l'objet Relev de facture.

Votre objet Relev de facture doit dsormais inclure deux champs personnaliss, comme illustr ici.

En savoir plusNotez comment nous avons dfini le type de donnes du nom de la facture sur Numro automatique et dfini un Formatd'affichage. La plate-forme attribue automatiquement un numro chaque enregistrement unique cr, en commenant parle numro de dbut que vous avez spcifi. Le format affich se prsente comme suit : FACT-002.

Voir aussi :Didacticiel n 2 : Ajout de relationstape 2 : Cration d'un objet lment de ligne


tape 2 : Cration d'un objet lment de ligneChaque facture est compose d'un nombre d'lments de ligne de facture, qui reprsente la quantit d'articles vendus un prixspcifique. Vous allez crer l'objet lment de ligne, puis l'associer aux objets Relev de facture et Articles.

1. Cliquez sur Configuration CrerObjets.2. Cliquez sur Nouvel objet personnalis, puis dfinissez l'objet personnalis.

Dans le champ tiquette, saisissez lment de ligne Dans le champ tiquette - pluriel, saisissez lments de ligne Modifiez le Nom de l'enregistrement en Numro de l'lment de ligne. Laissez le champ Type de donnes dfini sur Texte.

3. Laissez les autres valeurs inchanges, puis cliquez sur Enregistrer.4. Ajoutez un champ Prix unitaire en lecture seule. Ce champ est en lecture seule car la valeur sera rcupre partir de l'objet

Article dans un autre didacticiel. Nous l'appelons Prix unitaire pour le diffrencier du champ Prix de l'objet Article.

a. Accdez la liste associe Champs personnaliss & relations, puis cliquez sur Nouveau.b. Dans la zone Type de donnes, slectionnez Devise, puis cliquez sur Suivant.c. Renseignez les dtails des champs personnaliss.

Dans le champ tiquette du champ, saisissez Prix unitaire. Dans le champ Longueur, saisissez 16, puis saisissez 2 dans le champ Dcimales.

d. Cliquez sur Suivant.e. Slectionnez Lecture seule pour tous les profils, cliquez sur Suivant, puis cliquez sur Enregistrer et Nouveau.

Remarque: Si l'option Lecture seule n'est pas disponible, vous avez probablement slectionn par erreurObligatoire. Cliquez sur Prcdent et dsactivez Obligatoire.

5. Rptez les tapes ci-dessus pour ajouter un champ Units vendues.


a. Dans la zone Type de donnes, slectionnez Numro, puis cliquez sur Suivant.b. Dans le champ tiquette du champ, saisissez Units vendues, puis cliquez sur Suivant.c. Cliquez sur Suivant, en acceptant les valeurs par dfaut.d. Cliquez sur Enregistrer pour revenir la page de dtails de l'objet personnalis lment de ligne.

En savoir plus ce stade, vous avez cr trois objets personnaliss : Article, Relev d'inventaire et Elment de ligne. Dans chacun de cesobjets, vous avez cr des champs personnaliss pour reprsenter du texte, des chiffres et une devise. Tous ces champs ont unlment en commun : les valeurs sont fournies par l'utilisateur. Vous avez galement cr deux champs personnaliss contenantdes valeurs gnres par le systme : la liste de slection Statut qui s'ouvre sur En cours et le champ Numro de facture qui estautomatiquement attribu par le type de donnes Numrotation automatique. l'tape suivante, vous allez crer deux champsupplmentaires. Contrairement aux champs prcdents, leurs valeurs proviennent d'autres objets.

Voir aussi :Didacticiel n 2 : Ajout de relationstape 1 : Cration d'un objet personnalis Relev de facturetape 3 : Association des objets

tape 3 : Association des objetsVous disposez maintenant de tous les objets reprsentant le modle de donnes et vous souhaitez par consquent les associer.L'lment de ligne est associ un Relev de facture (un relev est compos d'un nombre d'lments de ligne) et un Article(dans un lment de ligne, le prix provient de l'article).

1. Dans la page de dtails de l'objet lment de ligne, accdez la liste associe Champs personnaliss & relations, puiscliquez sur Nouveau.

2. Dans la zone Type de donnes, slectionnez Relation principal-dtails, puis cliquez sur Suivant.3. Dans le champ Associ , slectionnez votre objet personnalis Article, puis cliquez sur Suivant.4. Acceptez les valeurs par dfaut dans les trois crans qui suivent en cliquant sur Suivant.5. Dsactivez la case en regard de Prsentation de Article afin de ne pas afficher Elments de ligne dans la liste

associe Article.6. Cliquez sur Enregistrer et Nouveau.7. Dans la zone Type de donnes, slectionnez Relation principal-dtails, puis cliquez sur Suivant.8. Dans le champ Associ , slectionnez votre objet personnalis Relev de facture, puis cliquez sur Suivant.9. Acceptez les valeurs par dfaut dans les crans qui suivent en cliquant sur Suivant, puis cliquez sur Enregistrer pour revenir

la page de dtails Elment de ligne.

En savoir plusVous venez de crer deux relations principal-dtails en associant les enregistrements Relev de facture aux enregistrementslments de ligne de facture et en associant les lments de ligne de facture aux Articles. Les relations principal-dtails


prennent galement en charge les champs rcapitulatifs de cumul, qui permettent de regrouper les informations sur lesenregistrements enfant. Vous utiliserez cette fonctionnalit dans un didacticiel ultrieur.

Voir aussi :Didacticiel n 2 : Ajout de relationstape 2 : Cration d'un objet lment de lignetape 4 : Ajout de relevs de facture la sous-application

tape 4 : Ajout de relevs de facture la sous-applicationComme vous l'avez fait pour l'objet personnalis Article, vous allez crer un onglet pour l'objet Relev de facture et l'ajouter votre sous-application Entrept. Cet onglet affichera l'interface utilisateur que Force.com gnre automatiquement pour cetobjet.

1. Dans le menu de Configuration, cliquez sur CrerOnglets.2. Dans la liste associe Onglets de l'objet personnalis, cliquez sur Nouveau pour lancer l'assistant Onglet Nouvel objet

personnalis.3. Dans la liste droulante Objet, slectionnez Relev de facture.4. Cliquez sur l'icne de recherche en regard du champ Style d'onglet, puis slectionnez l'icne Formulaire.5. Acceptez les autres valeurs par dfaut, puis cliquez sur Suivant deux fois.6. Dans la page Ajouter aux applications personnalises, dsactivez toutes les cases l'exception de Entrept. L'onglet

Relevs de facture est ajout votre sous-application Entrept.7. Cliquez sur Enregistrer pour terminer la cration de l'onglet.

Votre onglet Relevs de facture fait dsormais partie de votre sous-application.

Voir aussi :Didacticiel n 2 : Ajout de relationstape 3 : Association des objetstape 5 : Cration d'un enregistrement Facture

tape 5 : Cration d'un enregistrement FactureComme vous l'avez constat dans le didacticiel prcdent, la plate-forme gnre automatiquement une interface utilisateurpour les objets que vous crez pour vous permettre d'afficher, de modifier, de supprimer et de mettre jour les enregistrements.Comme vous avez galement associ les objets, l'interface utilisateur reprsente galement un outil de navigation entre lesenregistrements associs.

1. Cliquez sur l'onglet Relevs de facture.2. Cliquez sur Nouveau.


3. Dans le champ Description, saisissez Premire facture, puis cliquez sur Enregistrer.

La page de dtails de votre relev de facture doit se prsenter comme dans l'illustration ci-dessous.

Notez que le numro de facture a t automatiquement attribu et que l'interface utilisateur affiche une liste associe lmentsde ligne vide dessous. Le Relev de facture est li l'Elment de ligne via un champ principal-dtails. Vous avez cr cetterelation qui explique la prsence d'une liste associe dans la page de dtails Relev de facture. Vous allez ensuite ajouter unlment de ligne la facture.

1. Cliquez sur Nouvel lment de ligne.2. Renseignez les champs.

Dans le champ Numro de l'lment de ligne, saisissez 1. Dans le champ Prix unitaire, saisissez 10. Dans le champ Units vendues, saisissez 4. Cliquez sur l'icne de recherche en regard du champ Article, puis slectionnez un produit.


En savoir plusVous vous demandez peut-tre pourquoi le Numro de l'lment de ligne est un champ de texte alors que vous saisissez desvaleurs. Si les lments de ligne sont numrots, pourquoi ne pas dfinir le champ sur la numrotation automatique, commeles Relevs de facture ? Pour rpondre simplement, il est plus facile d'utiliser du texte avec des enregistrements et ce didacticiel


doit rester convivial. Si vous le souhaitez, vous pouvez dfinir le champ Elment de ligne sur la numrotation automatique, cequi rendra toutefois le Didacticiel n 8, Cration d'une page Web publique en utilisant les Sites, plus complexe.

Voir aussi :Didacticiel n 2 : Ajout de relationstape 4 : Ajout de relevs de facture la sous-applicationRsum

RsumDans ce didacticiel, vous avez cr des relations entre les objets dans votre modle de donnes. Les relations fonctionnentcomme des cls trangres dans des bases de donnes relationnelles, mais de faon plus abstraite, en vous laissant grer leslments importants (les relations) plutt que la mise en uvre sous-jacente. Les relations principal-dtails permettent deregrouper les informations. Le didacticiel suivant prsente comment calculer le prix de chaque lment de ligne de facturedans le relev de facture. Les relations offrent galement l'avantage suivant : vous pouvez accder aux enregistrements associsdans une interface utilisateur et un langage de requte. Nous en reparlerons.

Vous venez de crer l'application de base ; vous pouvez maintenant ajouter une logique commerciale l'aide de formules et dergles de validation dans le Didacticiel n 3 : Utilisation de formules et de rgles de validation la page 21.

Voir aussi :Didacticiel n 2 : Ajout de relationstape 5 : Cration d'un enregistrement Facture


Didacticiel n 3 : Utilisation de formules et de rgles devalidation

Niveau : Dbutant ; Dure : 20 30 minutes

La plate-forme Force.com permet de crer des formules et des rgles de validation de champ qui facilitent la gestion etl'optimisation de la qualit des donnes saisies dans votre sous-application. Les champs de formule et les rgles de validationde champ utilisent des fonctions intgres qui permettent de manipuler automatiquement vos donnes, de les valider et decalculer d'autres valeurs bases sur vos donnes. Les fonctions que vous utilisez dans les champs de formule et les rgles devalidation de champ ressemblent celles que vous utilisez dans un tableur pour rfrencer des valeurs dans d'autres champsd'une feuille de calcul, effectuer des calculs et renvoyer un rsultat. Toutefois, avec les champs de formule et les rgles devalidation de champ, vous rfrencez des champs dans les enregistrements de votre sous-application.

Dans ce didacticiel, vous allez amliorer la sous-application Entrept an ajoutant un champ de formule qui calculeautomatiquement la valeur totale de chaque lment de ligne. Vous allez galement utiliser cette nouvelle valeur d'lment deligne et une proprit des relations principal-dtails pour calculer automatiquement le total d'une facture. Pour terminer, vousallez ajouter une formule qui effectue un contrle d'inventaire, afin de vous empcher de crer un lment de ligne pour unequantit d'articles suprieure votre stock.

PrrequisSous-application Entrept

Vous devez commencer par crer une application Entrept de base en suivant les instructions du Didacticiel n 2 : Ajoutde relations la page 13.

Voir aussi :tape 1 : Calcul d'une valeur pour chaque Elment de lignetape 2 : Calcul d'une valeur pour le Relev de facture avec un champ rcapitulatif de cumultape 3 : Contrle d'inventaire avec une rgle de validationtape 4 : Test de la rgle de validationtape 5 : Amlioration de la rgle de validationRsum

tape 1 : Calcul d'une valeur pour chaque Elment de ligneDans cette tape, vous allez ajouter un nouveau champ calcul appel Valeur l'lment de ligne. Ce champ multipliera lenombre d'articles par le prix et agira comme un total pour chaque lment de ligne.

Manuel d'utilisation Force.com | Didacticiel n 3 : Utilisation de formules et de rgles de validation | 21

1. Accdez l'objet personnalis Elment de ligne en cliquant sur Configuration CrerObjets Elment de ligne.2. Accdez la liste associe Champs personnaliss & relations, puis cliquez sur Nouveau.3. Choisissez le type de champ Formule, puis cliquez sur Suivant.4. Dans les champs tiquette du champ et Nom du champ, saisissez Valeur.5. Dans la zone Type de renvoi de la formule, slectionnez Devise.6. Cliquez sur Suivant.7. Dans la liste droulante Insrer un champ de fusion, slectionnez Prix unitaire. La valeur Prix_unitaire__c

s'affiche dans la zone de texte.8. Cliquez sur la liste droulante Insrer un oprateur, puis slectionnez Multiplication.9. Dans la liste droulante Insrer un champ de fusion, slectionnez Units vendues. La valeur Prix_unitaire__c *

Unit_s_vendues__c s'affiche dans la zone de texte.

10. Cliquez sur Suivant deux fois, puis cliquez sur Enregistrer.

Lorsque vous revenez la page de dtails de l'objet personnalis, notez le nouveau champ appel Valeur.

En savoir plusLe type de champ Formule est trs pratique pour calculer automatiquement les valeurs de champ partir d'autre valeurs,comme nous l'avons fait ici. La formule que vous avez saisie ne prsentait pas de difficult : une simple multiplication de deuxvaleurs de champ dans le mme enregistrement. Il existe galement un onglet Formule avance qui permet de crer des formulesplus complexes.

Voir aussi :Didacticiel n 3 : Utilisation de formules et de rgles de validationtape 2 : Calcul d'une valeur pour le Relev de facture avec un champ rcapitulatif de cumul

tape 2 : Calcul d'une valeur pour le Relev de facture avec un champrcapitulatif de cumul

Vous disposez maintenant du total de chaque lment de ligne ; il est naturel d'ajouter ces totaux afin d'obtenir le total de lafacture. Puisque ces lments de ligne ont une relation principal-dtails avec le relev de facture, nous pouvons utiliser unchamp rcapitulatif de cumul pour calculer cette valeur. Le rcapitulatif de cumul est un type de champ spcial qui permet deregrouper les informations relatives aux objets (enfant) de dtails associs. Dans ce cas, vous calculez la valeur de chaque lmentde ligne.


1. Revenez la page de l'objet personnalis Relev de facture en cliquant sur Configuration CrerObjets Relevde facture.

2. Accdez la liste associe Champs personnaliss & relations, puis cliquez sur Nouveau.3. Slectionnez le type de champ Rcapitulatif de cumul, puis cliquez sur Suivant.4. Dans le champ tiquette du champ, saisissez Valeur de facture, puis cliquez sur Suivant.5. Dans la liste Objet synthtis, slectionnez Elments de ligne6. Dans le champ Slectionner le type de cumul, slectionnez SUM.7. Dans la liste Champ synthtiser, slectionnez Valeur.8. Vrifiez que votre cran se prsente comme dans l'illustration ci-dessous, puis cliquez sur Suivant.

9. Cliquez de nouveau sur Suivant, puis cliquez sur Enregistrer.

En savoir plusSi vous revenez l'enregistrement du relev de facture, notez le nouveau champ de rcapitulatif de cumul qui affiche la valeurtotale de tous les lments de ligne de facture. Si un sablier est affich en regard du champ, attendez quelques secondes, puisactualisez la page. Vous pouvez tester cette nouvelle fonctionnalit en ajoutant un autre lment de ligne.

Voir aussi :Didacticiel n 3 : Utilisation de formules et de rgles de validationtape 1 : Calcul d'une valeur pour chaque Elment de lignetape 3 : Contrle d'inventaire avec une rgle de validation

tape 3 : Contrle d'inventaire avec une rgle de validationLes champs que vous dfinissez dans des objets peuvent tre dots de rgles de validation crits dans le mme langage deformule que vous avez utilis pour crer le champ de formule. Les rgles de validation peuvent servir dterminer quelle plagede saisie est valide et afficher un message l'utilisateur lorsqu'une valeur de champ n'est pas valide. L'valuation des formulesde condition d'erreur doit tre True lorsque vous souhaitez afficher un message l'utilisateur.

1. Revenez la page de l'objet personnalis Elment de ligne en cliquant sur ConfigurationCrerObjets Elmentde ligne.

2. Accdez la liste associe Rgles de validation, puis cliquez sur Nouveau.


3. Dans le champ Nom de rgle, saisissez Commande en stock.4. Dans la zone Formule de condition d'erreur, cliquez sur Insrer un champ pour ouvrir la fentre contextuelle Insrer un

champ.

a. Slectionnez Elment de ligne > dans la premire colonne.b. Slectionnez Article > dans la deuxime colonne.c. Slectionnez Inventaire total dans la troisime colonne.d. Cliquez sur Insrer.e. Tapez le symbole infrieur < pour obtenir la formule :

Article__r.Inventaire_total__c dans la premire colonne.h. Slectionnez Units vendues dans la deuxime colonne.i. Cliquez sur Insrer, puis vrifiez que le code se prsente comme suit :

Article__r.Inventaire_total__c < Unit_s_vendues__c

5. Cliquez sur Vrifier la syntaxe pour vous assurer de l'absence d'erreur. Si des erreurs sont dtectes, corrigez-les avant decontinuer.

6. Dans le champ Message d'erreur, saisissez Vous avez command un nombre d'articles suprieur la quantit en stock.

7. Pour l'option Emplacement de l'erreur, activez Champ, puis slectionnez Units vendues dans la liste droulante.


En savoir plusVous pouvez saisir une formule directement dans la zone Formule de condition d'erreur, cependant, comme vous l'avez constatici, vous pouvez aisment parcourir les objets disponibles et slectionner les composants ncessaires pour la formule. Analysonsla formule que vous avez cre.


Article__r : puisque l'objet Article est associ l'objet Elment de ligne, la plate-forme fournit automatiquement unchamp de relation qui permet de naviguer depuis un enregistrement Elment de ligne vers un enregistrement Article, ceque fait le champ Article__r.

Inventaire_total__c : il s'agit du champ que vous avez cr pour suivre le montant total du stock dans un enregistrementArticle.

Article__r.Inventaire_total__c : indique au systme de rcuprer la valeur du champ Inventaire total dans unenregistrement Article associ.

Unit_s_vendues__c : correspond au champ Units vendues dans l'enregistrement actuel (Elment de ligne).

Une fois regroups, ces lments constituent une formule qui vrifie si l'inventaire total dans l'enregistrement Article associest infrieur la quantit d'units vendues. Comme indiqu la page Formule de condition d'erreur, vous devez fournir uneformule qui renvoie True si vous souhaitez afficher une erreur. La formule est vraie lorsque l'inventaire total est infrieur auxunits vendues.

Voir aussi :Didacticiel n 3 : Utilisation de formules et de rgles de validationtape 2 : Calcul d'une valeur pour le Relev de facture avec un champ rcapitulatif de cumultape 4 : Test de la rgle de validation

tape 4 : Test de la rgle de validationVous allez maintenant tester la rgle de validation cre l'tape 3.

1. Cliquez sur l'onglet Relevs de facture, puis slectionnez une facture existante.2. Accdez la zone Elments de ligne, puis cliquez sur Modifier en regard d'un ou des lments de ligne.3. Modifiez la valeur Units vendues avec un chiffre suprieur la quantit en stock.4. Cliquez sur Enregistrer. Une erreur devrait s'afficher indiquant que la quantit d'articles en stock est insuffisante. Cliquez

sur Annuler.


5. Cliquez sur Annuler.

Voir aussi :Didacticiel n 3 : Utilisation de formules et de rgles de validationtape 3 : Contrle d'inventaire avec une rgle de validationtape 5 : Amlioration de la rgle de validation

tape 5 : Amlioration de la rgle de validationLa logique de la formule de validation est imparfaite ! Imaginez que vous modifiez un enregistrement et diminuez la quantitd'units vendues. Dans ce cas, aucun contrle de l'inventaire n'est ncessaire. l'inverse, si vous augmentez la quantit d'unitsvendues, il suffit de vrifier que les articles supplmentaires sont disponibles en stock. Vous pouvez amliorer la rgle devalidation en lui ajoutant ces scnarios en utilisant la fonction ISNEW() dans votre formule, qui dtermine si vos crez unenregistrement. S'il ne s'agit pas d'un nouvel enregistrement, vous devez utiliser la fonction PRIORVALUE() qui indique lavaleur prcdente du champ, avant sa modification.

1. Revenez la page de l'objet personnalis Elment de ligne en cliquant sur ConfigurationCrerObjets Elmentde ligne.

2. Dans la liste associe Rgles de validation, cliquez sur Modifier en regard du champ Commande en stock.3. Remplacez la formule existante par la formule suivante :

IF( ISNEW(), Article__r.Inventaire_total__c < Unit_s_vendues__c , IF ( Unit_s_vendues__c< PRIORVALUE(Unit_s_vendues__c), FALSE, Article__r.Inventaire_total__c dans la premire colonne,Article > dans la deuxime et Prix dans la troisime.16. Cliquez sur Insrer.

Manuel d'utilisation Force.com | Didacticiel n 4 : Utilisation de workflow et d'approbations | 29

17. Cliquez sur Enregistrer pour fermer l'assistant Nouvelle mise jour du champ et revenir l'tape 3 de l'assistant duworkflow.

18. Dans la page Spcifier les actions de workflow, cliquez sur Termin.19. Dans la page Rgle de workflow, cliquez sur Activer.

Important: Ne pas activer une nouvelle rgle de workflow est une erreur frquente. Si la rgle n'est pas active,ses critres ne sont pas valus lorsque les enregistrements sont crs ou enregistrs.

En savoir plusSi vous crez maintenant un nouvel lment de ligne et l'affichez, vous pouvez constater que son prix unitaire estautomatiquement dfini sur le prix de l'enregistrement de l'article associ. Puisque vous tes un administrateur, un champ desaisie s'affiche pour le prix. Vos utilisateurs ne voient pas ce champ car il est en lecture seule.

Cette rgle de workflow s'excute uniquement lors de la cration d'un enregistrement (jamais aprs) car nous ne voulons pasaugmenter le prix indiqu sur la facture une fois l'article ajout la facture. Le client serait pour le moins surpris de dcouvrirun prix suprieur celui annonc. Toutefois, si le prix baissait, le client apprcierait d'tre tenu inform de tout changement.Vous dfinirez cette fonction ultrieurement.

Vous vous demandez peut-tre pourquoi nous avons cr un rgle dont les formules sont toujours values sur True. C'estparce-que nous souhaitons mettre jour le champ chaque fois qu'un enregistrement est cr, ce qui est toujours vrai. Vouspouvez utiliser une formule pour valuer une expression, ce qui n'tait pas ncessaire dans notre exemple.

Voir aussi :Didacticiel n 4 : Utilisation de workflow et d'approbationstape 2 : Mise jour de l'inventaire total lors d'une commande

tape 2 : Mise jour de l'inventaire total lors d'une commandeVous allez prfrer que la gestion de l'inventaire total des enregistrements d'articles soit automatique. Lors de la cration defactures (dont le statut par dfaut est En cours ), vous allez vouloir reflter les mises jour des lments de ligne dans le


champ Inventaire total que vous avez cr dans l'objet Article. Vous pouvez le faire avec une autre rgle de workflow. La seuledifficult est la modification de la valeur de l'inventaire total. Si vous crez un lment de ligne, vous devez diminuer l'inventairetotal par le nombre d'units vendues. Cependant, si vous mettez jour un lment de ligne, vous devez ajuster l'inventairetotal avec la diffrence entre l'ancienne et la nouvelle quantits d'units vendues.

1. Cliquez sur Configuration CrerWorkflow & approbations Rgles de workflow.2. Si l'cran Prsentation du workflow s'affiche, cliquez sur Continuer ou passez l'tape suivante.3. Dans la page Toutes les rgles de workflow, cliquez sur Nouvelle rgle.4. l'tape 1 de l'assistant Rgle de workflow, slectionnez l'objet Elment de ligne, puis cliquez sur Suivant.5. Dans le champ Nom de rgle, saisissez Elment de ligne mis jour.6. Dans la zone Critres d'valuation, slectionnez chaque cration ou modification d'un

enregistrement.7. Dans le champ Critres de la rgle, slectionnez critres suivants sont remplis.8. Dans la liste droulante Champ, slectionnez Relev de facture: Statut. Dans la liste droulante Oprateur,

slectionnez gal . En regard de Valeur, cliquez sur l'icne de recherche, puis slectionnez En cours. Cliquez surInsrer les lments slectionns.

9. Assurez-vous que l'cran se prsente comme dans l'illustration ci-dessous, puis cliquez sur Enregistrer et Suivant.

10. l'tape 3 de l'assistant Rgle de workflow, dans la section Actions de workflow immdiates, cliquez sur Ajouter uneaction de workflow, puis slectionnez Nouvelle mise jour du champ. L'assistant Nouvelle mise jour du champ s'ouvre.

11. Dans le champ Nom, saisissez Mettre jour l'inventaire du stock.12. Dans la premire liste droulante, Champ mettre jour, slectionnez Article. Dans la deuxime, slectionnez

Inventaire total.13. Slectionnez Utiliser une formule pour dfinir la nouvelle valeur.14. Cliquez sur Afficher l'diteur de formule.15. Saisissez le code suivant :

IF ( ISNEW(), Article__r.Inventaire_total__c - Unit_s_vendues__c ,Article__r.Inventaire_total__c - (Unit_s_vendues__c - PRIORVALUE(Unit_s_vendues__c)) )

16. Cliquez sur Vrifier la syntaxe et corrigez toute erreur ventuelle.


17. Cliquez sur Enregistrer pour fermer l'assistant Nouvelle mise jour du champ et revenir l'tape 3 de l'assistant duworkflow.

18. Dans la page Spcifier les actions de workflow, cliquez sur Termin.19. Dans la page Rgle de workflow, cliquez sur Activer.

Voir aussi :Didacticiel n 4 : Utilisation de workflow et d'approbationstape 1 : Renseignement du prix d'lment de ligne l'aide d'une rgle de workflowtape 3 : Test des rgles de workflow

tape 3 : Test des rgles de workflowVous pouvez vrifier le fonctionnement de vos workflow en crant un lment de ligne, puis vous assurer que son prix unitaireest automatiquement dfini et que l'inventaire total du stock a diminu.

1. Cliquez sur l'onglet Relevs de facture.2. Cliquez sur l'enregistrement de facture cr prcdemment.3. Cliquez sur Nouvel lment de ligne, puis saisissez les valeurs ci-dessous.

Dans le champ Numro de l'lment de ligne, saisissez 2. Laissez le champ Prix unitaire vide. Dfinissez Units vendues sur 1000. En regard du champ Article, cliquez sur l'icne de recherche, puis slectionnez l'enregistrement de l'article Wee Jet.

4. Cliquez sur Enregistrer.5. Cliquez sur l'lment de ligne 2. Notez que le prix unitaire est dfini sur une valeur identique celle de l'enregistrement

Wee Jet.


6. Ouvrez maintenant l'enregistrement d'article Wee Jet en cliquant sur le lien Wee Jet. Notez que l'Inventaire totalest pass de 2 000 1 000.

Voir aussi :Didacticiel n 4 : Utilisation de workflow et d'approbationstape 2 : Mise jour de l'inventaire total lors d'une commandetape 4 : Cration d'un modle d'e-mail

tape 4 : Cration d'un modle d'e-mailL'une des rgles commerciales que vous souhaitez appliquer votre workflow est l'approbation du responsable pour toutes lesfactures dont le total dpasse 2 000 . Pour mettre en uvre cette rgle, vous devez crer deux lments supplmentaires : une-mail envoyer au responsable lorsqu'une facture dpasse 2 000 et un processus d'approbation que le responsable doit suivre.

Remarque: Si votre devise par dfaut n'est pas dfinie sur Euros, appliquez votre devise cet exemple.

Dans cette tape, vous allez crer le modle d'e-mail que la rgle de workflow doit utiliser pour gnrer et envoyer l'e-mail.Vous allez crer le processus d'approbation dans les tapes suivantes.

1. Cliquez sur ConfigurationModles de communicationModles de message.2. Cliquez sur Nouveau modle.3. l'tape 1 de l'assistant Modle du message, slectionnez Texte, puis cliquez sur Suivant.4. Activez la case Disponible.5. Dans le champ Nom du modle de message, saisissez Modle facture importante.6. Dans le champ Objet, saisissez Une facture importante a t soumise.7. Dans le champ Corps du message, saisissez le code et le texte suivants :

{!Relev_de_facture__c.OwnerFullName} a soumis pour approbation un Relev de facture quidpasse le total {!Relev_de_facture__c.Valeur_de_facture__c} du{!Relev_de_facture__c.LastModifiedDate}

8. Vrifiez que votre cran se prsente comme dans l'illustration ci-dessous, puis cliquez sur Enregistrer.


En savoir plusLe texte du corps de l'e-mail que vous avez saisi prend en charge les champs de fusion, par exemple{!Relev_de_facture__c.Valeur_de_facture__c}. Lors de la gnration de l'e-mail, cette valeur est remplacedynamiquement par la valeur relle de la facture qui a gnr le processus d'approbation.

Voir aussi :Didacticiel n 4 : Utilisation de workflow et d'approbationstape 3 : Test des rgles de workflowtape 5 : Cration d'un processus d'approbation

tape 5 : Cration d'un processus d'approbationDans cette tape, vous allez crer un processus d'approbation qui ncessite l'approbation explicite du responsable si une facturedpasse 2 000 . La cration et l'utilisation d'un processus d'approbation sont aussi faciles que la cration d'une rgle deworkflow.

1. Cliquez sur Configuration CrerWorkflow & approbations Processus d'approbation.2. Dans la liste droulante Grer les processus d'approbation pour, slectionnez Relev de facture.3. Cliquez sur Crer un processus d'approbation et slectionnez l'option Utiliser l'assistant de dmarrage

automatique dans la liste droulante.4. Dans le champ Nom, saisissez Valeur facture importante.5. En regard du champ Modle d'e-mail d'attribution de l'approbation, cliquez sur l'icne de recherche et

slectionnez le Modle facture importante que vous venez de crer.6. Saisissez les valeurs suivantes dans la zone Spcifier les critres d'entre.

a. Dans la liste droulante Champ, slectionnez Valeur de facture.b. Dans la liste droulante Oprateur, slectionnez suprieur .c. Dans le champ Valeur, saisissez 2000.

7. Slectionnez l'option Attribuer automatiquement un approbateur l'aide d'un champ de hirarchiepersonnalis ou standard, puis Responsable dans le champ de relation hirarchique. Cette option permet


d'attribuer le rle d'approbateur au responsable de l'utilisateur qui dmarre le processus d'approbation. Vous allez crer unutilisateur Alain Durand l'tape suivante.

8. Cliquez sur Enregistrer.9. Un avertissement vous invite activer le processus d'approbation. Cliquez sur OK. Vous avez termin la cration du

processus d'approbation, mais avant de pouvoir l'excuter, vous devez dfinir les actions excutes lors de la soumissioninitiale, de l'approbation et du refus des enregistrements.

10. Cliquez sur Afficher la page de dtails sur le processus d'approbation.11. Crez des actions de mise jour de champ en cliquant sur Ajouter une nouvelle action et en slectionnant Mise jour

du champ pour chaque liste associe du tableau ci-dessous. Configurez chaque action de mise jour de champ commeindiqu.

Options de liste de slectionChamp mettre jourNomListe associe

Slectionner Une valeurspcifique, puis Enattente.

StatutDfinir le statut

d'approbation

initiale

Actions de soumission initiale

Slectionner Une valeurspcifique, puis Ferm.

StatutDfinir le statut

d'approbation finale

Actions d'approbation finale

Slectionner Une valeurspcifique, puis Encours.

StatutDfinir le statut de

refus final

Actions de refus final

12. Cliquez sur Enregistrer.13. Cliquez sur Processus d'approbation pour revenir la liste des approbations.14. Cliquez sur Activer pour activer le processus d'approbation.


En savoir plusDes actions par dfaut sont associes certaines tapes d'approbation. Les actions de soumission initiale et d'approbation finaleverrouillent l'enregistrement, alors que l'action de refus final dverrouille l'enregistrement. Ceci est logique : si un enregistrementest soumis pour approbation, il ne doit pas tre modifiable durant l'approbation. S'il est refus, il doit tre dverrouill pourlui apporter des modifications.

Voir aussi :Didacticiel n 4 : Utilisation de workflow et d'approbationstape 4 : Cration d'un modle d'e-mailtape 6 : Cration d'un profil de scurit personnalis

tape 6 : Cration d'un profil de scurit personnalisUn profil est un ensemble d'autorisations et d'autres paramtres associs un utilisateur ou un groupe d'utilisateurs. Votreorganisation est associe des profils standard prdfinis. Si vous crez un objet personnalis, les autorisations d'accs cetobjet ( Lire , Crer , Modifier et Supprimer ) sont dsactives pour la plupart des profils. Ce paramtre de scuritpar dfaut permet de bloquer l'accs de tous les utilisateurs aux objets personnaliss et leurs donnes tant que l'autorisationn'est pas explicitement accorde. Vous pouvez modifier ces autorisations dans des profils personnaliss, mais pas dans desprofils standard.

Dans cette tape, vous allez crer un profil personnalis que vous pouvez attribuer aux utilisateurs qui doivent accder auxobjets personnaliss de la sous-application Entrept. Dans le nouveau profil personnalis, vous allez ensuite activer lesautorisations d'objet pour permettre aux utilisateurs d'accder aux objets. Vous crerez un utilisateur l'tape suivante.

1. Cliquez sur Configuration Gestion des utilisateurs Profils.2. Cliquez sur Nouveau.3. Dans le champ Profil existant, slectionnez Utilisateur standard. Si vous utilisez la version Free Edition, slectionnez

Force.com - Free User.4. Dans le champ Licence utilisateur Nom du profil, saisissez Utilisateur de base.5. Dans la page de dtails du nouveau profil, cliquez sur Modifier.6. En bas de la page, dans la zone Autorisations de l'objet personnalis, activez les cases Lecture, Crer, Modifier et Supprimer

pour les objets Relevs de facture, Elments de ligne et Articles.7. Vrifiez que votre cran se prsente comme dans l'illustration ci-dessous, puis cliquez sur Enregistrer.


En savoir plusVous venez de crer et de modifier aisment un profil personnalis. Pour modifier de nombreux modles, vous pouvez utiliserla gestion de profils avance afin de crer une vue de liste personnalise de vos profils et de les modifier dans la vue. Pour plusd'informations, reportez-vous Modification de profils l'aide de listes de profils dans l'aide en ligne de Salesforce.com.

Voir aussi :Didacticiel n 4 : Utilisation de workflow et d'approbationstape 5 : Cration d'un processus d'approbationtape 7 : Cration d'un utilisateur

tape 7 : Cration d'un utilisateurLors de la cration d'une application Force.com, elle est automatiquement active pour permettre la connexion de plusieursutilisateurs. Vous pouvez dsormais personnaliser l'application en la configurant selon le profil de l'utilisateur connect. Vouspouvez par exemple accorder un accs en lecture seule aux champs un groupe d'utilisateurs spcifique, ou les rendre invisibles.Vous pouvez galement imposer un strict partage de donnes pour permettre un utilisateur d'afficher ses enregistrements ouceux de son responsable.

Dans cette tape, vous allez crer un utilisateur et l'associer votre compte d'utilisateur actuel via le champ Responsable. Cetteconfiguration permet de s'assurer que si le nouvel utilisateur cre une facture respectant certaines conditions, la facture estachemine vers son responsable.

1. Cliquez sur Configuration Gestion des utilisateurs Utilisateurs.2. Dans la page Tous les utilisateurs, cliquez sur Nouvel utilisateur.3. Saisissez les informations suivantes :

Dans le champ Prnom, saisissez Alain. Dans le champ Nom, saisissez Durand. Dans le champ Alias, saisissez adurand. Dans le champ Adresse e-mail, saisissez votre adresse e-mail pour vous permettre de recevoir les demandes

d'approbation achemines vers Alain Durand. Le champ Nom d'utilisateur est renseign par dfaut avec votre adresse e-mail, mais vous devez crer un nom

d'utilisateur unique pour Alain, sous la forme d'une adresse e-mail imaginaire.

Remarque: Notez le nom d'utilisateur d'Alain (son adresse e-mail imaginaire), vous allez bientt vous connectersous son identit.

Dans le champ Responsable, slectionnez l'utilisateur cr lors de l'inscription l'organisation. Dans le champ Licence utilisateur, slectionnez Salesforce. Dans le champ Profil, slectionnez Utilisateur de base.



Vous devriez recevoir un message de confirmation de la cration du nouvel utilisateur. Vous devez effectuer une tapesupplmentaire pour terminer le processus d'approbation. Ne vous connectez-pas immdiatement Alain Durand, car vousavez encore besoin de votre accs administrateur.

Dans la version Free Edition, pour permettre Alain Durand de se connecter et d'utiliser la sous-application Entrept, vousdevez modifier le profil Utilisateur de base en consquence. Les utilisateurs de Free Edition ayant accs une seulesous-application, Entrept doit tre slectionne par dfaut (si vous utilisez Developer Edition, passez cette tape).

1. Cliquez sur Configuration Gestion des utilisateurs Profils.2. En regard du profil Utilisateur de base, cliquez sur Modifier.3. En regard de Entrept, slectionnez Par dfaut.

Voir aussi :Didacticiel n 4 : Utilisation de workflow et d'approbationstape 6 : Cration d'un profil de scurit personnalistape 8 : Test du processus d'approbation

tape 8 : Test du processus d'approbationVous pouvez maintenant prparer le processus d'approbation et l'excuter. Si Alain Durand cre une facture avec un totalsuprieur 2 000 , il peut cliquer sur le bouton Soumettre pour approbation dans le relev de facture. La sous-applicationenvoie un e-mail son responsable ( l'aide du modle d'e-mail cr prcdemment) et verrouille l'enregistrement, empchantainsi Alain d'effectuer de nouvelles modifications.

Lorsqu'il se connecte, le responsable peut approuver (ou refuser) la facture. S'il l'approuve, vous pouvez mettre jour le statutde la facture sur Ferm. Dans le cas contraire, vous conservez le statut initial En cours. Dans un scnario rel, votre processuscommercial peut exiger l'envoi d'un e-mail au propritaire de la facture et demander une confirmation, entre autres.

Avant de tester le processus d'approbation, vous devez vous assurer que votre page d'accueil peut afficher les lments ncessitantune approbation.

1. Cliquez sur Configuration Personnalisation Accueil Prsentations de page d'accueil.2. Cliquez sur Modifier en regard de votre prsentation de page d'accueil (si vous utilisez Free Edition, cliquez sur Modifier

en regard de VolunteerForce Home Page).


3. Slectionnez l'option lments approuver, si elle est dsactive.4. Cliquez sur Suivant, puis sur Enregistrer.

Pendant le dveloppement de l'application, vous tes connect en tant qu'administrateur. Pour crer un enregistrement ettester le processus d'approbation, vous devez vous dconnecter du compte administrateur et vous connecter en tant qu'utilisateurstandard.

1. Connectez-vous en tant que Alain Durand. S'il s'agit de votre premire connexion sous cette identit, vous serez probablementinvit changer de mot de passe.

2. Slectionnez la sous-application Entrept.3. Cliquez sur l'onglet Relevs de facture.4. Cliquez sur Nouveau, puis crez un relev de facture.5. Ajoutez un Nouvel lment de ligne et une quantit d'units suffisante pour obtenir un total de facture suprieur 2 000

.6. Cliquez sur Enregistrer.7. Cliquez sur Soumettre pour approbation.8. Dconnectez-vous de l'application.

Un e-mail est envoy l'administrateur dsign d'Alain Durand, soit vous-mme dans ce didacticiel. Comme vous tesadministrateur, vous pouvez vrifier cet envoi dans votre bote de rception. Lorsque vous vous connectez l'application entant qu'administrateur, vous pouvez accder la demande d'approbation en attente sous l'onglet Accueil (faites dfiler la pagepour l'afficher). L'enregistrement est verrouill jusqu' l'approbation de la facture par le responsable. Un champ Approbationpermet au responsable d'approuver ou de refuser la facture, puis de continuer le workflow. Approuvez la facture.

En savoir plusLa page de dtails Processus d'approbation permet d'afficher un diagramme de processus d'approbation ainsi que les actionsdclenches chaque tape.

1. Dans la Configuration, cliquez sur Processus d'approbation, puis slectionnez le processus que vous avez cr.2. Cliquez sur Afficher le diagramme. Le diagramme de processus d'approbation s'affiche dans une nouvelle fentre de

navigateur.


Voir aussi :Didacticiel n 4 : Utilisation de workflow et d'approbationstape 7 : Cration d'un utilisateurRsum

RsumLes rgles de workflow et les processus d'approbation permettent d'automatiser vos processus commerciaux et d'appliquer vosnormes. La rgle de workflow met automatiquement jour le prix et l'inventaire dans diffrents objets. Le processus d'approbationest excut ds qu'une condition est remplie et envoie une alerte par e-mail au destinataire dsign.

Important: Si vous utilisez la version Free Edition, les didacticiels qui suivent ncessitent un dveloppement dansun environnement test sandbox. Si vous ne dveloppez pas dans un environnement test sandbox, suivez les instructionsde l'tape Cration et connexion un environnement test sandbox la page 90. La copie de votre environnementtest sandbox ne duplique pas les enregistrements pour vous. Par consquent, une fois connect, crez de nouveaul'enregistrement Wee Jet de l'Etape 5 : Cration d'un enregistrement Article la page 11 ainsi que le Relev de facturede l'Etape 5 : Cration d'un enregistrement Facture la page 18.

Voir aussi :Didacticiel n 4 : Utilisation de workflow et d'approbationstape 8 : Test du processus d'approbation


Didacticiel n 5 : Ajout d'une logique commerciale avecApex

Niveau : Avanc ; Dure : 20 30 minutes

Apex est un langage de programmation fortement typ, orient objet et de type Java qui s'excute sous Force.com. Apexpermet d'ajouter une logique commerciale programme aux applications. Par exemple, vous pouvez l'utiliser pour rdiger desdclencheurs, des services Web et des contrleurs de programme dans la couche interface utilisateur de votre sous-application.

Vous avez dj ajout une logique commerciale en utilisant l'environnement de workflow dclaratif. Dans ce didacticiel, vousallez crer une logique supplmentaire en utilisant le langage Apex, qui est idal pour grer de multiples enregistrements etune logique complexe.

L'tude de cas sur laquelle nous allons nous appuyer stipule que lors de la baisse du prix d'un article, les clients bnficient dela rduction. Pour cela, vous crez un dclencheur Apex qui met jour toutes les factures en cours ds que le prix de l'articlediminue. Un dclencheur est un ensemble de codes qui s'excutent un moment donn du cycle de vie d'un enregistrement.Dans notre cas, vous allez crer un dclencheur qui s'excute aprs la mise jour d'un article.

Il existe deux faons de dvelopper des applications dans Force.com : vous pouvez utiliser l'environnement en ligne, commevous l'avez fait jusqu' prsent, ou utiliser l'IDE Force.com. Si l'IDE n'est pas install, son installation va tre prendre dutemps. Cependant, si vous matrisez l'IDE, vous connaissez les fonctionnalits Syntax highlighting (mise en vidence de lasyntaxe), Code insight (prdiction de code) et bien d'autres, qui optimisent la productivit du dveloppement, notamment enquipe.

Remarque: Si vous utilisez la version Free Edition, l'ensemble du dveloppement doit tre effectu dans votreenvironnement test sandbox. Si vous n'avez pas encore cr d'environnement test sandbox, reportez-vous Crationet connexion un environnement test Sandbox la page 90.

PrrequisConnaissances de base

Pour ce didacticiel, il est prfrable de matriser les notions de base de langages de programmation oriente objet telsque Java ou C#, sans tre indispensable. Ce didacticiel peut galement tre accompli dans l'IDE Force.com, par consquent,matriser Eclipse peut tre utile mais n'est pas indispensable.

Configuration logicielle requiseVous pouvez utiliser l'IDE Force.com pour ce didacticiel. Dans ce cas, Eclipse 3.3 ou 3.4 et le composant IDE Force.comsont requis : wiki.developerforce.com/index.php/Force.com_IDE. Pour crer un projet, reportez-vous Cration d'unprojet dans l'IDE Force.com la page 90.

Manuel d'utilisation Force.com | Didacticiel n 5 : Ajout d'une logique commerciale avec Apex | 41

Les autorisations Mode dveloppeur , Modifier toutes les donnes et Auteur Apex Puisque ce didacticiel s'appuie sur le langage Apex, assurez-vous de disposer des autorisations requises pour crer desclasses Apex.

Voir aussi :tape 1 : Cration d'une dfinition de dclencheur Apextape 2 : Dfinition d'une variable de listetape 3 : Itration sur une liste et modification du prixtape 4 : Test du dclencheurRsum

tape 1 : Cration d'une dfinition de dclencheur ApexVous devez commencer pas crer la dfinition du dclencheur, qui contient le nom du dclencheur, l'objet affect et une actionqui lance le dclencheur. Vous pouvez crer des dclencheurs dans l'interface Web ou dans l'IDE Force.com. Les instructionssont fournies pour les deux outils.

Pour crer un dclencheur dans l'interface Web :

1. Cliquez sur Configuration CrerObjets dans le menu latral.2. Cliquez sur votre objet personnalis Article.3. Dans la page de dtails Article, accdez Dclencheurs, puis cliquez sur Nouveau.4. Remplacez et afin d'obtenir le code suivant :

trigger HandleProductPriceChange on Article__c (after update) {

}

5. Si vous utilisez l'interface Web, cliquez sur Enregistrement rapide, qui enregistre votre travail et vous permet de continuer.L'enregistrement de votre travail ce stade permet galement de vrifier le code saisi, car si la syntaxe est incorrecte, lesystme n'enregistre pas.

Pour crer le dclencheur dans l'IDE Force.com :

1. Dans le Package Explorer, cliquez avec le bouton droit sur votre projet, puis cliquez sur New Apex Trigger.2. Dans la bote de dialogue, saisissez HandleProductPriceChange pour le nommer.3. Dans la liste droulante Object, slectionnez Article__c.

Remarque: Si cet objet ne figure pas dans la liste des objets, cliquez sur Refresh Objects (ignorez l'avertissementrelatif la slection d'une opration).

4. Slectionnez after update.


5. Cliquez sur Finish. Le fichier s'ouvre dans l'diteur.

En savoir plusVotre dclencheur ne lance aucune opration pour le moment, mais il est prt pour accepter toute logique que vous souhaitezexcuter lors de la mise jour d'un enregistrement Article. Avant de passer la logique du dclencheur, dtaillons et examinonschaque partie de la dfinition du dclencheur.

HandleProductPriceChange : correspond au nom du dclencheur. on Article__c : correspond l'objet sur lequel le dclencheur agit, soit l'objet personnalis Article__c dans notre

cas. (after update) : correspond l'action qui lance le dclencheur. Les dclencheurs Apex sont excuts en rponse des

actions sur les donnes, telles que des insertions, des mises jour et des suppressions, avant ou aprs l'un de ces vnements.Le dclencheur que vous dfinissez est excut aprs la mise jour d'un enregistrement.

{ } : le code insr entre accolades est appel body (corps) et dtermine l'action du dclencheur. Vous allez coder ledclencheur l'tape suivante.

Voir aussi :Didacticiel n 5 : Ajout d'une logique commerciale avec Apextape 2 : Dfinition d'une variable de liste

tape 2 : Dfinition d'une variable de listeVous devez commencer par dfinir une variable de liste qui contient un liste d'lments de ligne. Les lments de ligne ne sontpas tous ncessaires. Slectionnez uniquement ceux qui figurent dans l'ensemble des enregistrements qui a dclench l'excutionde ce code et dont le statut est Ngociation.

1. Entre les accolades de votre dfinition de dclencheur, saisissez le commentaire suivant, puis instruisez une variable deliste.

// mettre jour les lments de ligne associs des factures en coursList openLineItems = [ ];

Remarque: Pour gagner du temps, nous n'allons rien commenter ici, mais il est recommand de commenter votrecode.

2. Entre les parenthses carres, saisissez une requte qui rcupre les informations depuis votre objet personnalis Elmentde ligne.

List openLineItems = [SELECT j.Prix_unitaire__c, j.Article__r.Prix__cFROM El_ment_de_ligne__c j WHERE j.Relev_de_facture__r.Statut__c = 'Ngociation' ANDj.Article__r.id IN :Trigger.new FOR UPDATE];


Remarque: Comme nous essayons d'ajuster notre exemple de code la page, il contient des sauts de ligne nonindispensables dans le code. Apex ignore les espaces, par consquent, le format de votre code peut diffrer. Enoutre, Apex n'est pas sensible la casse, par consquent, vous pouvez saisir par exemple select au lieu de SELECT.

En savoir plusLa liste openLineItems contient une liste d'enregistrements de votre objet personnalis El_ment_de_ligne__c. Lecontenu de cette liste est dtermin par la requte insre entre les accolades, qui est crite en langage SOQL (SalesforceObject Query Language). Examinons cette requte en dtails.

SELECT : dtermine quels champs sont rcuprs dans l'objet. FROM : dtermine le ou les objets auxquels vous souhaitez accder. Le j dans El_ment_de_ligne__c j est un alias

: il correspond un raccourci pratique qui permet de se rfrer El_ment_de_ligne__c avec j . WHERE : correspond au dbut de l'instruction de la condition. Dans notre cas, vous souhaitez renvoyer uniquement les

enregistrements dont le statut est Ngociation. AND : correspond la deuxime condition de l'instruction. Elle rcupre les ID uniques des nouveaux enregistrements. Le

code utilise une variable spciale, Trigger.new, qui est automatiquement initialise avec les identificateurs desenregistrements mis jour.

FOR UPDATE : indique la plate-forme de verrouiller les enregistrements, afin d'empcher les autres programmes etutilisateurs de les mettre jour. Le verrou reste en place jusqu'au terme du dclencheur.

Voir aussi :Didacticiel n 5 : Ajout d'une logique commerciale avec Apextape 1 : Cration d'une dfinition de dclencheur Apextape 3 : Itration sur une liste et modification du prix

tape 3 : Itration sur une liste et modification du prix l'tape prcdente, vous avez cr une liste d'lments de ligne, puis vous l'avez stocke dans une variable appeleopenLineItems. Vous pouvez maintenant itrer sur la liste l'aide d'une boucle for et modifier le prix initial d'un articlesi le nouveau prix est infrieur.

1. Dclarez une boucle for.

Date post:	05-Sep-2015
Category:	Documents
Upload:	raitmansour8013
View:	235 times
Download:	0 times

Workbook French

Documents