Microaplicaciones

Integrar Salesforce

Integre con Salesforce para acceder desde cualquier lugar a clientes potenciales, cuentas, oportunidades, casos y contratos.

Utilice el siguiente proceso para habilitar la integración de Salesforce. Compruebe que cumple los requisitos previos y, a continuación, configure la integración de Salesforce. Después de completar este proceso, el nivel existente de registros de auditoría persiste, incluidas las acciones llevadas a cabo por el uso de microaplicaciones de Citrix.

Para obtener una lista completa de las microaplicaciones de Salesforce de uso inmediato, consulte Usar microaplicaciones de Salesforce.

Revisar requisitos previos

Tras configurar esta integración en Salesforce, necesitará estos artefactos para agregar la integración en las microaplicaciones de Citrix Workspace:

  • Nombre de usuario
  • Password
  • Token de seguridad

Para OAuth 2.0:

  • Clave de consumidor
  • Secreto de consumidor
  • URL base de autorización de OAuth

Nota:

Se recomienda utilizar OAuth 2.0 como método de autenticación del servicio siempre que esté disponible. OAuth 2.0 garantiza que la integración es conforme a los requisitos de seguridad más estrictos con la microaplicación configurada.

La integración requiere acceso periódico de API a su instancia de Salesforce, por lo que recomendamos crear una cuenta de usuario dedicada en Salesforce. A continuación, utilice esa cuenta para configurar la integración de Salesforce. Esta cuenta debe:

  • tener privilegios de pleno acceso a los datos
  • estar habilitada para API
  • no permitir autenticación de dos factores.

El uso de una cuenta dedicada es útil para los registros de auditoría, ya que ayuda a distinguir las actividades realizadas a través de Citrix Workspace. Esta página contiene tutoriales tanto para Salesforce Classic como para Salesforce Lightning Experience. En ambos tutoriales, se presupone que usted es un administrador de sistemas en Salesforce.

Nota:

Las ediciones “Contact” y “Group” de Salesforce no admiten ninguna API. La edición “Professional” no lo incluye automáticamente. Sin embargo, se puede activar la compatibilidad bajo petición.

Además, el número de solicitudes de API está limitado en Salesforce. Si tiene previsto sincronizar con frecuencia una gran cantidad de datos, consulte Límites y asignaciones de solicitudes de API de Salesforce.

  • Configure Citrix Gateway para que admita Single Sign-On para Salesforce, de modo que, una vez que los usuarios hayan iniciado sesión, no tengan que volver a introducir sus credenciales para registrarse. Siga las instrucciones indicadas en Configuración de Single Sign-On de Salesforce. Para obtener más información acerca de la configuración de Single Sign-On, consulte Citrix Gateway Service.

Agregar un nuevo perfil

Siga estos pasos:

  1. Inicie sesión en www.salesforce.com
  2. Vaya al icono Setting y seleccione Setup > Administration > Manage Users > Profiles > New Profile.
  3. Establezca Existing Profile en System Administrator para asegurarse de que el usuario que cree para este perfil tenga privilegios de pleno acceso a los datos.
  4. Introduzca un nombre de perfil y seleccione Save. Se recomienda asignar un nombre al perfil como Acceso a Citrix Workspace como referencia fácil al agregar el perfil como nuevo usuario en un procedimiento posterior.

    Se abrirá un panel Profile con su nuevo perfil.

Habilite el acceso de API para el perfil creado

  1. En el panel Profile, seleccione Edit.
  2. Desplácese hacia abajo hasta Administrative Permissions y marque la casilla API enabled.
  3. (Opcional) Para inhabilitar la caducidad de la contraseña, marque la casilla Password Never Expires.

    Nota:

    El uso de esta opción constituye una posible vulnerabilidad de seguridad.

  4. Seleccione Guardar.

Agregar direcciones URL de respuesta

Agregue una URL personalizada a la configuración de la instancia para dar acceso a datos privados y habilitar acciones de usuarios autenticados por OAuth. La primera respuesta que aparece en la lista no cambia. La segunda respuesta depende de la aplicación de destino, y se puede encontrar en la barra de direcciones URL al crear la integración. La sección {yourmicroappserverurl} se compone de una parte de arrendatario, una parte de región y una parte de entorno: https://{tenantID}.{region(us/eu/ap-s)}.iws.cloud.com.

  1. Inicie sesión en Salesforce como administrador.
  2. Vaya a Platform Tools > Apps > App Manager.
  3. Seleccione New Connected App.
  4. En Basic Information, complete los campos siguientes:
    • Connected App Name (Nombre de la aplicación conectada)
    • API Name (Nombre de la API)
    • Contact Email (Correo electrónico de contacto)
  5. En API, marque la casilla Enable OAuth Settings.
  6. En el campo Callback URL, agregue las siguientes URL de redirección autorizadas con la URL del servidor de microaplicaciones:

    • https://{yourmicroappserverurl}/admin/api/external-services/com.sapho.services.salesforce.SalesforceService/auth/serverContext
    • https://{yourmicroappserverurl}/app/api/auth/serviceAction/callback
  7. Junto a Selected OAuth Scopes, elija los siguientes ámbitos de Available OAuth Scopes. A continuación, seleccione Add para moverlos al campo Selected OAuth Scopes:
    • Acceda a sus datos y adminístrelos (api)
    • Acceda a su información básica (identificación, perfil, correo electrónico, dirección, teléfono)
    • Haga solicitudes en su nombre en cualquier momento (refresh_token, offline_access)
  8. Seleccione Guardar.

(Opcional) Restringir rangos de IP de inicio de sesión

Si su organización establece rangos de IP para perfiles de usuario, puede controlar el acceso de inicio de sesión a nivel de usuario. Especifique un rango de direcciones IP autorizadas en el perfil de un usuario. Para obtener más información, consulte Restringir rangos de IP de inicio de sesión en la interfaz de usuario de perfil mejorado.

Si restringe los rangos de IP de inicio de sesión, no es necesario generar un token de seguridad en el siguiente procedimiento.

Agregar un nuevo usuario

Cree una cuenta de usuario dedicada que le sirva para conectarse a Salesforce. Utilice el nuevo perfil que agregó en el procedimiento anterior, Agregar un nuevo perfil.

Siga estos pasos:

  1. Vaya a Setup > Administer > Manage Users > Users > New User.
  2. Complete los campos obligatorios en rojo.
  3. Establezca User License en Salesforce.
  4. Establezca Profile en el perfil que agregó en el procedimiento anterior. En el ejemplo anterior, recomendamos Citrix Workspace Access para facilitar la consulta al agregar el perfil.
  5. Haga clic en Guardar.

Configurar el nuevo usuario

Después de agregar una cuenta de usuario dedicada, recibirá un correo electrónico en la dirección que proporcionó.

Siga estos pasos:

  1. Busque el correo electrónico y haga clic en el enlace como se indica.
  2. Inicie sesión en Salesforce.
  3. Establezca una contraseña y una pregunta de contraseña.

Generar un token de seguridad

Si ha restringido los rangos de IP de inicio de sesión para el perfil de usuario dedicado, puede omitir este paso. El token de seguridad no es necesario para las cuentas que se conectan a la API de Salesforce desde un bloque de IP de lista blanca.

Siga estos pasos:

  1. Inicie sesión y seleccione el nombre de la cuenta.
  2. Ve a Setup > Administer > Manage Users > Users > New User.
  3. Seleccione Reset Security Token.

    El nuevo token de seguridad se envía a la dirección de correo electrónico que proporcionó en la configuración personal de esta cuenta. También recibirá un nuevo token de seguridad cada vez que se restablezca la contraseña de esta cuenta.

Ahora puede completar la integración. Introduzca el nombre de usuario y la contraseña de la cuenta de usuario dedicada en los campos de entrada de la definición del servicio de Salesforce.

Si la dirección IP está en una lista blanca, no es necesario que introduzca un token de seguridad. De lo contrario, pegue el token de seguridad que se le envió al buzón de correo electrónico de la cuenta dedicada.

Filtrar consultas

La mayoría de las entidades de Salesforce admiten el filtrado. Elija entre consultas predefinidas o escriba sus propias consultas personalizadas mediante el lenguaje SOQL de Salesforce. Para obtener más información, consulte Documentación del lenguaje de consulta de objetos de Salesforce (SOQL).

Agregar la integración a las microaplicaciones de Citrix Workspace

Agregue la integración de Salesforce a las microaplicaciones de Citrix Workspace para conectarse a su aplicación. Esto proporciona microaplicaciones de uso inmediato con notificaciones y acciones preconfiguradas que se pueden usar desde ya en su espacio de trabajo.

Siga estos pasos:

  1. En la página de descripción general, seleccione Introducción.

    Se abrirá la página Administrar integraciones.

  2. Seleccione Agregar nueva integración y Agregar una nueva integración a partir de plantillas proporcionadas por Citrix.
  3. Elija el mosaico de Salesforce.
  4. Introduzca un nombre para la integración.

    Parámetros del conector de Salesforce, nombre de usuario, contraseña, autenticación de usuario, token de seguridad

  5. Introduzca la autenticación del servicio que recopiló en los procedimientos anteriores.
    • Introduzca sus credenciales de nombre de usuario y contraseña para la autenticación del servicio de los sistemas de destino.
  6. Seleccione el método de autenticación OAuth 2.0.
    • Introduzca la clave de consumidor y el secreto de consumidor que recopiló en el procedimiento de requisitos previos.
    • Introduzca su URL base de autorización de OAuth. Esto le permite configurar una página de inicio de sesión SSO personalizada para su instancia de Salesforce. Introduzca su dominio Este es el mismo que la URL de SFDC, donde normalmente inicia sesión, y requiere HTTPS seguro. Por ejemplo, https://{your_domain}/services/oauth2/authorize.
  7. Introduzca los parámetros del conector.
    • Introduzca el token de seguridad.
    • Active Sandbox si necesita que los datos se carguen en un entorno de espacio aislado o sandbox.
    • Deje habilitada la opción que permite consultar los registros eliminados durante la sincronización incremental y eliminarlos también de la caché. Si el sistema genera un error que indica que no se pueden cargar las entidades eliminadas de tipo después de la primera sincronización incremental, puede inhabilitar esta opción para evitar el problema.
  8. Seleccione Agregar.

Se abrirá la página Integraciones de microaplicaciones con la integración agregada y sus microaplicaciones. Desde aquí, puede agregar otra integración, seguir configurando sus microaplicaciones de uso inmediato o crear una nueva microaplicación para esta integración.

Ya tiene todo listo para configurar y llevar a cabo su primera sincronización de datos. Como se puede extraer una gran cantidad de datos de la aplicación integrada y transferirla a la plataforma de microaplicaciones, le recomendamos utilizar la página Tabla para filtrar entidades relacionadas con la primera sincronización de datos y, así, acelerar la sincronización.

Para obtener más información, consulte Verificar las entidades necesarias y Establecer sincronización de datos en el artículo Configurar la integración.

Para obtener información detallada sobre los dispositivos de punto final de las API y las entidades de tabla, consulte Especificaciones del conector de Salesforce.

Usar microaplicaciones de Salesforce

Las integraciones de las aplicaciones existentes vienen con microaplicaciones de uso inmediato. Comience con estas microaplicaciones y personalícelas conforme a sus exigencias.

Microaplicaciones de Salesforce

Nuestra integración de Salesforce incluye las siguientes microaplicaciones preconfiguradas de uso inmediato:

Cuentas: Permite buscar, ver y modificar cuentas.

Notificación o página Flujos de trabajo por caso de uso
Notificación Se le ha asignado una cuenta (existente) Cuando se cambia el propietario de una cuenta, el nuevo propietario recibe una notificación.
Notificación Se le ha asignado una cuenta (nueva) Cuando se asigna una nueva cuenta a un usuario, este recibe una notificación.
Página Detalles de la cuenta Proporciona una vista de una cuenta con detalles, incluidos los contactos y un enlace a los detalles de esos contactos.
Página Detalles del contacto Proporciona una vista de solo lectura de un contacto con detalles.
Página Modificar cuenta Proporciona un formulario para enviar las modificaciones realizadas en una cuenta.
Página Mis cuentas Proporciona una lista personalizada de las cuentas.

Casos: Permite ver y modificar casos que se le asignen.

Notificación o página Flujos de trabajo por caso de uso
Notificación Se le ha asignado un caso (existente) Cuando se cambia el propietario de un caso, el nuevo propietario recibe una notificación.
Notificación Se le ha asignado un caso (nuevo) Cuando se asigna un nuevo caso a un usuario, este recibe una notificación.
Notificación Nuevo caso relacionado con su cuenta Cuando se crea un caso relacionado con la cuenta de un usuario, este recibe una notificación.
Página Detalles de la cuenta Proporciona una vista de una cuenta con detalles, incluidos los contactos y un enlace a los detalles de esos contactos.
Página Detalles del caso Permite ver un caso y ofrece un botón para abrir la página de modificaciones.
Página Detalles del contacto Proporciona una vista de solo lectura de un contacto con detalles.
Página Modificar caso Proporciona un formulario para enviar las modificaciones realizadas en un caso.
Página Mis casos activos Proporciona una lista personalizada de casos asignados a un usuario.

Contactos: Permite buscar, ver y modificar contactos.

Notificación o página Flujos de trabajo por caso de uso
Notificación Se le ha asignado un contacto (existente) Cuando se cambia el propietario de un contacto, el nuevo propietario recibe una notificación.
Notificación Se le ha asignado un contacto (nuevo) Cuando se asigna un nuevo contacto a un usuario, este recibe una notificación.
Página Detalles del contacto Permite ver un contacto y ofrece un botón para abrir la página de modificaciones.
Página Modificar contacto Proporciona un formulario para enviar las modificaciones realizadas en un contacto.
Página Mis contactos Proporciona una lista personalizada de los contactos.

Contratos: Permite buscar, consultar y modificar contratos.

Notificación o página Flujos de trabajo por caso de uso
Notificación Contrato actualizado Cuando se cambia un detalle de un contrato, el propietario del contrato recibe una notificación.
Notificación Contrato que va a caducar Cuando un contrato supera un umbral definido antes o después de su fecha de finalización (por ejemplo, 3 días de forma predeterminada), el propietario recibe un recordatorio de notificación.
Notificación Nuevo contrato por activar Cuando se asigna a un usuario una nueva solicitud de aprobación de activación de contrato pendiente, este recibe una notificación.
Página Detalles de la cuenta Proporciona una vista de una cuenta con detalles, incluidos los contactos y un enlace a los detalles de esos contactos.
Página Detalles del contacto Proporciona una vista de solo lectura de un contacto con detalles.
Página Detalles del contrato Permite ver un contrato y ofrece un botón para abrir la página de modificaciones y activarlo.
Página Modificar contrato Proporciona un formulario para enviar las modificaciones realizadas en un contrato.
Página Mis contratos pendientes de activación Proporciona una lista personalizada de los contratos pendientes de activación.

Crear cuenta: Sirve para crear una cuenta.

Notificación o página Flujos de trabajo por caso de uso
Página Crear cuenta Proporciona un formulario para enviar una cuenta nueva.

Crear caso: Sirve para crear un caso.

Notificación o página Flujos de trabajo por caso de uso
Página Crear caso Proporciona un formulario para enviar un caso nuevo.

Crear contacto: Sirve para crear un contacto.

Notificación o página Flujos de trabajo por caso de uso
Página Crear contacto Proporciona un formulario para enviar un contacto nuevo.

Crear contrato: Sirve para crear un contrato.

Notificación o página Flujos de trabajo por caso de uso
Página Crear contrato Proporciona un formulario para enviar un contrato nuevo.

Crear evento: Sirve para crear un evento.

Notificación o página Flujos de trabajo por caso de uso
Página Crear evento Proporciona un formulario para enviar un evento nuevo.

Crear cliente potencial: Sirve para crear un cliente potencial.

Notificación o página Flujos de trabajo por caso de uso
Página Crear cliente potencial Proporciona un formulario para enviar un nuevo cliente potencial.

Crear oportunidad: Sirve para crear una oportunidad.

Notificación o página Flujos de trabajo por caso de uso
Página Crear oportunidad Proporciona un formulario para enviar una nueva oportunidad.

Crear tarea: Sirve para crear una tarea.

Notificación o página Flujos de trabajo por caso de uso
Página Crear tarea Proporciona un formulario para enviar una tarea nueva.

Eventos: Permite buscar, ver y modificar eventos.

Notificación o página Flujos de trabajo por caso de uso
Notificación Recordatorio del evento Cuando un evento supera un umbral definido antes o después de su fecha y hora de actividad (por ejemplo, 1 hora de forma predeterminada), el propietario recibe un recordatorio de notificación.
Página Detalles de la cuenta Proporciona una vista de una cuenta con detalles, incluidos los contactos y un enlace a los detalles de esos contactos.
Página Detalles del contacto Proporciona una vista de solo lectura de un contacto con detalles.
Página Modificar evento Proporciona un formulario para enviar las modificaciones realizadas en un evento.
Página Detalles del evento Permite ver un evento y ofrece un botón para abrir la página de modificaciones.
Página Mis eventos Proporciona una lista personalizada de los eventos.

Clientes potenciales: Permite buscar, ver, modificar y convertir clientes potenciales.

Notificación o página Flujos de trabajo por caso de uso
Notificación Se le ha asignado un cliente potencial (existente) Cuando se cambia el propietario de un cliente potencial, el nuevo propietario recibe una notificación.
Notificación Se le ha asignado un cliente potencial (nuevo) Cuando se asigna un nuevo cliente potencial a un usuario, este recibe una notificación.
Página Convertir cliente potencial Proporciona un formulario para convertir a un cliente potencial.
Página Modificar cliente potencial Proporciona un formulario para enviar las modificaciones realizadas en un cliente potencial.
Página Mis clientes potenciales activos Proporciona una lista personalizada de los clientes potenciales.

Oportunidades: Permite buscar, ver y modificar oportunidades.

Notificación o página Flujos de trabajo por caso de uso
Notificación Se le ha asignado una oportunidad (existente) Cuando se cambia el propietario de una oportunidad, el nuevo propietario recibe una notificación.
Notificación Se le ha asignado una oportunidad (nueva) Cuando se asigna una nueva oportunidad a un usuario, este recibe una notificación.
Página Detalles de la cuenta Proporciona una vista de una cuenta con detalles, incluidos los contactos y un enlace a los detalles de esos contactos.
Página Detalles del contacto Proporciona una vista de solo lectura de un contacto con detalles.
Página Modificar oportunidad Proporciona un formulario para enviar las modificaciones realizadas en una oportunidad.
Página Mis oportunidades activas Proporciona una lista personalizada de las oportunidades.
Página Detalles de la oportunidad Permite ver una oportunidad y ofrece un botón para abrir la página de modificaciones.

Aprobaciones pendientes de cuentas: Permite buscar y aprobar o rechazar cuentas.

Notificación o página Flujos de trabajo por caso de uso
Notificación Nueva cuenta por aprobar Cuando se envía una nueva cuenta para la aprobación de un actor, este recibe una notificación.
Página Aprobar cuenta Proporciona un formulario para aprobar o rechazar una cuenta.
Página Mis aprobaciones de cuentas pendientes Proporciona una lista personalizada de las aprobaciones de cuentas pendientes y enlaces a la página de aprobación.

Aprobaciones pendientes de contactos: Permite buscar y aprobar o rechazar contactos.

Notificación o página Flujos de trabajo por caso de uso
Notificación Nuevo contacto por aprobar Cuando se envía un nuevo contacto para la aprobación de un actor, este recibe una notificación.
Página Aprobar contacto Proporciona un formulario para aprobar o rechazar un contacto.
Mis aprobaciones de contactos pendientes Proporciona una lista personalizada de las aprobaciones de contactos pendientes y enlaces a la página de aprobación.

Aprobaciones pendientes de contratos: Permite buscar y aprobar contratos.

Notificación o página Flujos de trabajo por caso de uso
Notificación Nuevo contrato por aprobar Cuando se envía un nuevo contrato para la aprobación de un actor, este recibe una notificación.
Página Aprobar contrato Proporciona un formulario para aprobar o rechazar un contrato.
Mis aprobaciones de contratos pendientes Proporciona una lista personalizada de las aprobaciones de contratos pendientes y enlaces a la página de aprobación.

Tareas: Permite buscar, ver y modificar tareas.

Notificación o página Flujos de trabajo por caso de uso
Notificación Recordatorio de tarea Cuando una tarea supera un umbral definido antes o después de su fecha y hora de actividad (por ejemplo, 1 hora de forma predeterminada), el propietario recibe un recordatorio de notificación.
Página Detalles de la cuenta Proporciona una vista de una cuenta con detalles, incluidos los contactos y un enlace a los detalles de esos contactos.
Página Detalles del contacto Proporciona una vista de solo lectura de un contacto con detalles.
Página Modificar tarea Proporciona un formulario para enviar las modificaciones realizadas en una tarea.
Página Mis tareas abiertas Proporciona una lista personalizada de las tareas.
Página Detalles de la tarea Permite ver una tarea y ofrece un botón para abrir la página de modificaciones.

Agregar tabla de valores de listas de selección

Debido al tipo de esquema de Salesforce, no todos los datos están disponibles como entidades de tabla. Utilice la tabla “picklistvalue” para ver la lista de selección de cada objeto de Salesforce y todas sus opciones.

  1. Abra una microaplicación de Salesforce y vaya al generador de páginas.
  2. Seleccione y arrastre un componente Select al campo.
  3. En Seleccione propiedades, desactive la opción Asignar a la columna de datos. Esto le permite ver todos los objetos de Salesforce.
  4. Seleccione picklistvalue en el menú de tabla de datos.
  5. Seleccione MODIFICAR FILTRO para abrir el filtro de datos.
  6. Seleccione el objeto y el campo de los que necesita datos. Seleccione Deben darse todas las condiciones y GUARDAR para cerrar el filtro. En la siguiente captura de pantalla, se muestra un ejemplo de configuración del filtro: Configuración de filtros picklistvalue Esta captura de pantalla muestra los objetos de base de datos y los campos a los que estamos intentando acceder: Ejemplo de base de datos de Salesforce
  7. Termine de configurar este componente. Para obtener más información, consulte Componentes del generador de páginas.