Travaux Salesforce

• Les classes de traitement par lots Apex (et les méthodes connexes) que vous voulez exécuter avec le plug-in Salesforce doivent être définies avec un niveau d'accès global pour les rendre accessibles à tous les Apex, où qu'ils soient (le niveau d'accès public n'est pas suffisant).
• Lors de la définition du travail, seules les classes de traitement par lots Apex Salesforce peuvent être exécutées. Si vous sélectionnez une classe autre qu'une classe de traitement par lots Apex, le travail échoue.

1. Enregistrez-vous sur le serveur Salesforce et demandez un ID utilisateur et un mot de passe.
2. Connectez-vous au serveur Salesforce.
3. Créez les classes Apex suivantes qui sont nécessaires pour établir la communication entre IBM Workload Scheduler et le serveur Salesforce. Les classes Apex IBM Workload Scheduler doivent être définies en dehors de tout module.

   Classe TWSListApexClass

   @RestResource(urlMapping='/TWSListApexClass/*')
   global with sharing class TWSListApexClass{
   //Cette classe Apex expose le service REST TWSListApexClass 
   //qui renvoie une liste de tous les classes Batchable Apex.    
       @HttpGet
       global static List<ApexClass> doGet() {
           RestRequest req = RestContext.request;
           RestResponse res = RestContext.response;
           String fullName='';
           List<ApexClass> tempList = 
           [SELECT NamespacePrefix,Name FROM ApexClass ORDER BY Name];        
           List<ApexClass> result = new List<ApexClass>();
           for (ApexClass a: tempList){
               if (a.NamespacePrefix==null || a.NamespacePrefix.equals('')){
                  fullName=a.Name;
               } else {
                  fullName=a.NamespacePrefix+'.'+a.Name;
               }
               System.debug(LoggingLevel.Info, 'ApexClass: '+fullName);            
               result.add(a);
           }   
           return result;
       }
   }

   Classe TWSSubmitApexJob

   @RestResource(urlMapping='/TWSSubmitApexJob/*')
   global with sharing class TWSSubmitApexJob{
   //Cette classe Apex expose le service REST TWSSubmitApexJob 
   //qui soumet une classe Apex au serveur Salesforce.
       @HttpGet
       global static ID doGet() {
           RestRequest req = RestContext.request;
           RestResponse res = RestContext.response;
           String apexClass = req.params.get('className');
           System.debug(LoggingLevel.Info, 'Execute Batch:'+apexClass);
           Type t = Type.forName(apexClass);
           if (t == null){
              throw new TWSException (apexClass + ' not found');
           }         
           Object s = t.newInstance();
           ID batchprocessid = 
           Database.executeBatch((Database.Batchable<sObject>)s);
           System.debug(LoggingLevel.Info, 'Job ID: '+batchprocessid);
           return batchprocessid;
       }    
   global class TWSException extends Exception{}
   } 

   Classe TWSMonitorApexJob

   @RestResource(urlMapping='/TWSMonitorApexJob/*')
   global with sharing class TWSMonitorApexJob{
   //Cette classe Apex expose le service REST TWSMonitorApexJob 
   //qui surveillera la progression du travail Apex d'arrière-plan.
       @HttpGet
       global static AsyncApexJob doGet() {
           RestRequest req = RestContext.request;
           RestResponse res = RestContext.response;
           ID i = (ID) req.params.get('jobID');
           AsyncApexJob a = [SELECT Id, Status, ExtendedStatus, NumberOfErrors, 
           JobItemsProcessed, TotalJobItems FROM AsyncApexJob WHERE Id = :i];
           return a;
       }
   }

   Classe TWSAbortApexJob

   @RestResource(urlMapping='/TWSAbortApexJob/*')
   global with sharing class TWSAbortApexJob{
   //Cette classe Apex expose le service REST TWSAbortApexJob 
   //qui interrompra le travail Apex sur le serveur Salesforce.    
       @HttpGet
       global static void doGet() {
           RestRequest req = RestContext.request;
           RestResponse res = RestContext.response;
           String jobID = req.params.get('jobID');
           System.abortJob(jobID);
       }
   }

4. Vérifiez le contenu du fichier de propriétés du plug-in Salesforce :

   <rép_principal_TWA>\TWS\javaExt\cfg\<nom_plug-in>.properties

   Ce fichier contient les propriétés du plug-in définies au moment de l'installation et que vous pourrez substituer ultérieurement. Voici les propriétés du plug-in :

   ProxyServer
   ProxyServerPort
   pollingPeriod
   pollingTimeout

   où

   ProxyServer

   Adresse IP ou nom de serveur pour le serveur proxy. Indiquez cette propriété si vous vous connectez au serveur Salesforce via un serveur proxy.

   ProxyServerPort

   Port d'écoute du serveur proxy.

   pollingPeriod

   Fréquence de surveillance. Ce paramètre détermine la fréquence à laquelle le travail est surveillé pendant son exécution. Il est exprimé en secondes.

   pollingTimeout

   Durée de surveillance. Ce paramètre détermine la durée pendant laquelle le travail est surveillé pendant son exécution. A la fin de l'intervalle de délai d'attente, le travail échoue. Il est exprimé en secondes.

   Les valeurs que vous indiquez dans le fichier de propriétés sont les valeurs par défaut qui sont utilisées lors de la définition du travail.

conman sj <nom_travail_Salesforce>;jobprop

Extra Information
  Apex batch class = TWSBatchTest
  Apex job ID = 7072000000eLnYOAA0
  Job item processed = 1
  Number of errors= 0
  Server address = regionA.salesforce.com
  Batch status = Completed
  Total Job items = 1
  User name = userabc@xyz.com

Apex batch class

Classe de lots APEX qui est prise en charge pour IBM Workload Scheduler.

Apex job ID

ID du travail Salesforce.

Job item processed

Nombre d'éléments de travail traités.

Number of errors

Nombre d'erreurs.

Server address

Serveur Salesforce que vous avez indiqué dans la zone Serveur.

Batch status

Statut de travail par lots

Total Job items

Nombre total d'éléments de travail traités.

User name

Nom de l'utilisateur autorisé à accéder au serveur Salesforce que vous avez indiqué dans la zone Nom d'utilisateur.

===============================================================
= JOB : NY0000000000#JOBS[(0000 05/08/14),(JOBS)].SF_MAR0318376017
= TASK      : <?xml version="1.0" encoding="UTF-8"?>
<jsdl:jobDefinition xmlns:jsdl=
"http://www.ibm.com/xmlns/prod/scheduling/1.0/jsdl" xmlns:jsdlsalesforce=
"http://www.ibm.com/xmlns/prod/scheduling/1.0/jsdlsalesforce" name="SALESFORCE">
<jsdl:variables>
<jsdl:stringVariable name=
        "tws.jobstream.name">JOBS</jsdl:stringVariable>
<jsdl:stringVariable name=
        "tws.jobstream.id">JOBS</jsdl:stringVariable>
<jsdl:stringVariable name="tws.job.name">
           SF_MAR0318376017</jsdl:stringVariable>
<jsdl:stringVariable name=
        "tws.job.workstation">NY0000000000</jsdl:stringVariable>
<jsdl:stringVariable name=
         "tws.job.iawstz">201405080000</jsdl:stringVariable>
<jsdl:stringVariable name=
........."tws.job.promoted">NO</jsdl:stringVariable>
<jsdl:stringVariable name=
.........."tws.job.resourcesForPromoted">10</jsdl:stringVariable>
<jsdl:stringVariable name=
.........."tws.job.num">607245960</jsdl:stringVariable>
</jsdl:variables>
<jsdl:application name="salesforce">
<jsdlsalesforce:salesforce>
<jsdlsalesforce:SalesforceParameters>
<jsdlsalesforce:SalesforceParms>
<jsdlsalesforce:ServerConnection>
<jsdlsalesforce:Server>
        regionA.salesforce.com</jsdlsalesforce:Server>
<jsdlsalesforce:UserID>userabc@xyz.com</jsdlsalesforce:UserID>
<jsdlsalesforce:password>
{aes}+D2UAAxhxtYf8ENfb7LNr0DLRt0hwKPHlDiA2/PO1e4=
</jsdlsalesforce:password>
</jsdlsalesforce:ServerConnection>
<jsdlsalesforce:APEXJobDetails>
<jsdlsalesforce:APEXClass>TWSBatchTest</jsdlsalesforce:APEXClass>
</jsdlsalesforce:APEXJobDetails>
</jsdlsalesforce:SalesforceParms>
</jsdlsalesforce:SalesforceParameters>
</jsdlsalesforce:salesforce>
</jsdl:application>
<jsdl:resources>
<jsdl:orderedCandidatedWorkstations>
<jsdl:workstation>
690830601B8D4681AF38D3529BC5199E</jsdl:workstation>
</jsdl:orderedCandidatedWorkstations>
</jsdl:resources>
</jsdl:jobDefinition>
= TWSRCMAP  : 
= AGENT : NC125181_1
= Job Number: 607245960
= Thu May 22 17:18:49 CEST 2014
===============================================================
Apex Batch job ID: 7072000000eLnYOAA0
Apex job completed with success
Apex Job ID: 7072000000eLnYOAA0
Status: Completed
Total Batches: 1
Batches Processed: 1
Failures: 0
===============================================================
= Exit Status : 0
= Elapsed Time (Minutes) : 1
= Thu May 22 17:18:53 CEST 2014
===============================================================