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 1. Darse de alta en Salesforce como desarrollador: 2. Crear nuevos leads (Candidatos), utilizando una dirección real (para que pueda ser encontrada en Yahoo Maps). 3. Ir a: 1. Configuración (Parte superior de la pantalla). 2. Configuración de la Aplicación Integrar- APEX API (menú izquierda) y descargar la interfaz Enterprise.wsdl. 4. Usar wsdl2java para generar los stubs que permiten acceder al servicio web de Salesforce.

3 Acceso a Salesforce (1) 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.

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 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 la excepción LoginFault.

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 la excepción APIFault. El paquete com.sforce.soap.enterprise contiene las clases necesarias que veremos en el ejemplo: SforceServiceLocator, QueryOptions, QueryResult, Lead, LoginResult, SessionHeader, LoginFault, ApiFault,

6 Ejemplo (1) Crear el Stub SoapBindingStub binding = null; LoginResult loginresult = null; try { binding = (SoapBindingStub) new SforceServiceLocator().getSoap(); } catch (ServiceException ex) { System.err.println("ERROR: create binding to soap service, error was: \n" + ex.getmessage()); } // Time out after a minute binding.settimeout(60000);

7 Ejemplo (2) Login try { loginresult = binding.login(login, password); } catch (LoginFault lf) { System.err.println(lf.getExceptionMessage()); } catch (ApiFault af) { System.err.println(af.getExceptionMessage()); } catch (RemoteException re) { System.err.println(re.getMessage()); } //Set Service URL binding._setproperty(soapbindingstub.endpoint_address_property,loginres ult.getserverurl()); // Create a new session header object and set the session id SessionHeader sh = new SessionHeader(); sh.setsessionid(loginresult.getsessionid()); binding.setheader(new SforceServiceLocator().getServiceName().getNamespaceURI(), "SessionHeader", sh);

8 Ejemplo (3) Preparar query /* Prepare query setting batch size */ QueryResult qr = null; QueryOptions qo = new QueryOptions(); qo.setbatchsize(new Integer(10)); binding.setheader(new SforceServiceLocator().getServiceName().getNam espaceuri(), "QueryOptions", qo); /* Set query */ String query = select FirstName, LastName, Company, AnnualRevenue, Phone, Street, PostalCode, City, State, Country from Lead ;

9 Ejemplo (4) Ejecutar query try { qr = binding.query(query); int loopcount = 0; boolean continueloop = true; while (continueloop) { // process the query results for (int i = 0; i<qr.getrecords().length; i++) { Lead lead = (Lead)qr.getRecords()[i]; } if (qr.isdone()) { continueloop = false; } else { qr = binding.querymore(qr.getquerylocator()); } } } catch (ApiFault af) { System.err.println("Failed to execute query succesfully, error message was: + af.getexceptionmessage()); } catch (Exception ex) { System.err.println("Failed to execute query succesfully, error message was: + ex.getmessage());

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

11 Acceso vía proxy (1) Utilizar proxies con Axis. Documentación: AxisProxy Dos opciones: Fijar las propiedades del sistema http.proxyhost and http.proxyport a los valores deseados. No nos vale porque el proxy se utilizaría en todas las llamadas. Se puede utilizar http.nonproxyhosts para indicar que no se utilice proxy a localhost.

12 Acceso vía proxy (2) Para usar la primera opción, podemos añadir las siguientes variables de entorno: export JAVA_OPTS=-Dhttp.proxyHost=proxy -Dhttp.proxyPort=3128 -Dhttp.nonProxyHosts=localhost export MAVEN_OPTS=$JAVA_OPTS

13 Acceso vía proxy (3) Otra opción: proporcionar una implementación alternativa de la clase que Axis utiliza para fijar las propiedades del cliente de una petición: org.apache.axis.components.net.transportclientproperties Antes de hacer una llamada que deba utilizar proxy fijaremos en el cliente el valor de dos propiedades (e.g. llamadas es.udc.ws.proxyhost y es.udc.ws.proxyport) Axis invoca los métodos getproxyhost y getproxyport de TransportClientProperties en cada petición. Nuestra implementación alternativa comprueba si las propiedades están fijadas y, en caso, alternativo devuelve el valor correspondiente. En el paquete util de los ejemplos WS se proporciona una implementación válida de esta clase: es.udc.ws.util.axis.axistransportclientproperties

14 Acceso vía proxy (4) - Para indicar a la máquina virtual que debe utilizar nuestra implementación alternativa debe utilizarse la opción: Dorg.apache.axis.components.net.TransportClientPr operties=es.udc.ws.util.axis.axistransportclientp roperties Para que lo utilice la máquina virtual de TOMCAT debemos fijar el valor de la propiedad CATALINA_OPTS al valor anterior

15 Acceso vía proxy (y 5) En el cliente, después de crear el stub y antes de la llamada, hay que fijar las propiedades: binding._setproperty( es.udc.ws.proxyhost","proxy"); binding._setproperty( es.udc.ws.proxyport","3128");