Guías para la práctica (2): Acceso a Salesforce

Transcripción

1 Guías para la práctica (2): Acceso a Salesforce

2 Pasos Previos Darse de alta en Salesforce como desarrollador: Crear nuevos leads (Candidatos), utilizando una dirección real (para que pueda ser encontrada en Google Maps). Ir a: Configuración (Parte superior de la pantalla). Configuración de la Aplicación > Desarrollo (menú izquierda) > Descargar el archivo WSDL específico de su organización y descargar la interfaz Enterprise.wsdl.

3 Acceso a Salesforce (1) El acceso a Salesforce debe ser conforme a la misma interfaz que el acceso al Servicio Web Interno. Los proxies ocultarán las diferencias a los usuarios de la interfaz. Usar wsimport para generar los stubs que permiten acceder al servicio web de Salesforce. <plugin> <groupid>org.codehaus.mojo</groupid> <artifactid>jaxws-maven-plugin</artifactid> <executions> <execution><goals><goal>wsimport</goal></goals></execution> </executions> <configuration> <wsdldirectory>src/wsdl</wsdldirectory> <sourcedestdir>src/main/java</sourcedestdir> <xjcargs> <xjcarg>-xautonameresolution</xjcarg> </xjcargs> </configuration> <dependencies> <groupid>com.sun.xml.ws</groupid> <artifactid>jaxws-tools</artifactid> <version>2.1.5</version> </dependencies> </plugin>

4 Acceso a Salesforce (2) Pasos de una petición al Servicio Web de Salesforce. Crear el stub. Llamar al método login del stub para establecer una sesión Requiere una clave de activación que debe concatenarse a la contraseña al acceder vía API. Configuración > Configuración Personal > Mi configuración personal> Restablecer mi testigo de Seguridad. Se envía por correo electrónico. Devuelve una URL de acceso y un identificador de sesión. Deben fijarse como propiedades en la cabecera de las restantes peticiones. Puede lanzar las excepciones InvalidIdFault, LoginFault, UnexpectedErrorFault.

5 Acceso a Salesforce (y 3) Para hacer una consulta se utiliza el método query. La consulta se expresa en un lenguaje llamado SOQL (SQL simplificado). La consulta puede incluir opciones, que se pasan como un objeto QueryOptions. Hay que recuperar los resultados en bloques: El método setbatchsize de las QueryOptions fija el tamaño de bloque. El método querymore permite acceder a más bloques. Los resultados pueden convertirse a objetos que representan cada entidad de datos soportada por Salesforce (e.g. Lead). Las llamadas al API pueden lanzar diferentes excepciones: InvalidFieldFault, InvalidSObjectFault, MalformedQueryFault, UnexpectedErrorFault, El paquete com.sforce.soap.enterprise contiene las clases necesarias que veremos en el ejemplo: SforceService, QueryOptions, QueryResult, Lead, LoginResult, SessionHeader, LoginFault,

6 Ejemplo: creación del Stub (1) Soap port = null; JAXBContext jc = null; LoginResult loginresponse = null; try { port = new SforceService().getSoap(); catch (Exception wse) { wse.printstacktrace(); return false; WSBindingProvider bindingprovider = ((WSBindingProvider) port); bindingprovider.getrequestcontext().put("com.sun.xml.ws.request.timeout", 60000);

7 Ejemplo: login (2) try { loginresponse = port.login(username, pwd); catch (Exception e) { e.printstacktrace(); return false; bindingprovider.getrequestcontext().put( BindingProvider.ENDPOINT_ADDRESS_PROPERTY, loginresponse.getserverurl()); try { jc = JAXBContext.newInstance( "com.sforce.soap.enterprise:com.sforce.soap.enterprise.fault" + ":com.sforce.soap.enterprise.sobject"); catch (JAXBException e) { e.printstacktrace(); return false; SessionHeader sh = new SessionHeader(); sh.setsessionid(loginresponse.getsessionid()); bindingprovider.setoutboundheaders(headers.create((jaxbricontext) jc, sh));

8 Ejemplo: preparación de la query (3) SessionHeader sh = new SessionHeader(); sh.setsessionid(loginresponse.getsessionid()); QueryOptions qo = new QueryOptions(); qo.setbatchsize(new Integer(10)); List<Header> headers = new ArrayList<Header>(); Header sessionidheader = Headers.create((JAXBRIContext) jc, sh); Header queryoptionsheader = Headers.create((JAXBRIContext) jc, qo); headers.add(sessionidheader); headers.add(queryoptionsheader); ((WSBindingProvider) port).setoutboundheaders(headers); QueryResult qr = null; String query = select FirstName, LastName, Company, + AnnualRevenue, Phone, Street, PostalCode, + City, State, Country from Lead"; try { qr = port.query(query); catch (Exception e) { e.printstacktrace(); return;

9 Ejemplo: ejecución de la query (y 4) boolean bcontinue = true; while (bcontinue) { List<SObject> records = qr.getrecords(); if (!records.isempty()) { for (SObject sobj : records) { Lead account = (Lead) sobj; System.out.println( account.getfirstname().getvalue() + " " + account.getlastname().getvalue() + " " + account.getcompany().getvalue()); if(qr.isdone()) { bcontinue = false; else { try { qr = port.querymore(qr.getquerylocator()); catch (Exception e) { e.printstacktrace();

10 Ejemplos y Documentación API y SOQL: Ejemplos accesibles desde:

11 Acceso vía proxy Fijar las propiedades del sistema http.proxyhost and http.proxyport a los valores deseados. Se puede utilizar http.nonproxyhosts para indicar que no se utilice proxy a localhost. export JAVA_OPTS=-Dhttp.proxyHost=proxy -Dhttp.proxyPort=3128 -Dhttp.nonProxyHosts=localhost export MAVEN_OPTS=$JAVA_OPTS export CATALINA_OPTS=$JAVA_OPTS