Compartir a través de


Salesforce

Salesforce Connector proporciona una API para trabajar con objetos de Salesforce.

Este conector está disponible en los siguientes productos y regiones:

Service Class Regions
Copilot Studio Premium Todas las regiones de Power Automate excepto las siguientes:
     - Gobierno de EE. UU. (GCC High)
     - China Cloud operado por 21Vianet
     - Departamento de Defensa de EE. UU. (DoD)
Aplicaciones lógicas Estándar Todas las regiones de Logic Apps excepto las siguientes:
     - Departamento de Defensa de EE. UU. (DoD)
Power Apps Premium Todas las regiones de Power Apps excepto las siguientes:
     - Gobierno de EE. UU. (GCC High)
     - China Cloud operado por 21Vianet
     - Departamento de Defensa de EE. UU. (DoD)
Power Automate Premium Todas las regiones de Power Automate excepto las siguientes:
     - Gobierno de EE. UU. (GCC High)
     - China Cloud operado por 21Vianet
     - Departamento de Defensa de EE. UU. (DoD)
Metadatos del conector
Publicador Microsoft

Para usar esta integración, necesitará acceder a una cuenta de Salesforce con el acceso de API habilitado. Para ver qué ediciones de Salesforce tienen acceso a la API, consulte el artículo de Salesforce. Para establecer una conexión, seleccione Iniciar sesión. Se le pedirá que proporcione el inicio de sesión de Salesforce y siga el resto de las pantallas para crear una conexión. La versión de API predeterminada que usa el conector es v58.0.

Ya está listo para empezar a usar esta integración.

Nota:

El conector de Salesforce ya está disponible en Microsoft CoPilot Studio.

Problemas conocidos y limitaciones

  1. Hay un límite en el número de campos que puede contener una consulta a Salesforce. El límite varía según el tipo de columnas, el número de columnas calculadas, etc. Cuando recibe un error "La consulta está seleccionando demasiados campos o las condiciones de filtro son demasiado complicadas", significa que la consulta supera el límite. Para evitar esto, use la opción avanzada "Seleccionar consulta" y especifique los campos que realmente necesita.
  2. La configuración de sesión de Salesforce puede bloquear esta integración. Asegúrese de que la opción "Bloquear sesiones en la dirección IP desde la que se originaron" está deshabilitada .
  3. Se debe habilitar el acceso a la API de Salesforce. Para comprobar la configuración de acceso, vaya a configuración de perfil para el usuario actual y busque la casilla "API Enabled" (Habilitada para API).
  4. Las cuentas de prueba de Salesforce no tienen acceso a la API y, por tanto, no se pueden usar.
  5. Las acciones Crear registro y Actualizar registro (V3) no admiten campos personalizados de tipo "Picklist (Multi-Select)" (incluidas sus respectivas versiones en desuso).
  6. No se admite la creación de una nueva conexión mediante el inicio de sesión "Dominio personalizado" de Salesforce.
  7. El uso de campos que aceptan valores NULL en Order By el parámetro debe evitarse, ya que esto puede provocar un error en tiempo de ejecución en las siguientes operaciones: Obtener registros, Cuando se crea un registro, cuando se crea o modifica un registro.
  8. Cuando se modifica un registro, el desencadenador solo puede detectar el cambio de registro del objeto estándar, pero no puede detectar el cambio de datos adjuntos del objeto estándar.
  9. Los siguientes desencadenadores y acciones no pudieron funcionar correctamente en tablas personalizadas sin la columna "Id": cuando se crea un registro, Cuando se crea o modifica un registro, Obtener registro, Crear registro, Actualizar registro (V3),Eliminar registro.
  10. Cuando se crea o modifica un registro, el desencadenador devolverá elementos nuevos y modificados. Para comprobar si un elemento devuelto es nuevo o modificado, compare sus valores de campo "CreatedDate" y "LastModifiedDate". En los nuevos elementos, se espera que estos valores sean iguales. A este respecto, ambos campos son obligatorios para los elementos para los que se aplica este desencadenador.
  11. Los objetos complejos (objetos con objetos anidados, vea el ejemplo siguiente) no son compatibles con create record y update record (V3) ( incluidas sus respectivas versiones en desuso). Para solucionar esta limitación, se deben usar estructuras de objetos planos.
  12. Ejecutar una consulta SOQL y obtener las acciones de registros se basan en la API "Query". Por lo tanto, no todos los registros se pueden devolver debido a las limitaciones de la API (por ejemplo, elementos eliminados).
  13. Si tiene algún problema con la obtención de datos establecido en el valor predeterminado mediante el registro de actualización (V3), esto se debe al encabezado "sforce-auto-assign" establecido en true. Para solucionar este problema, se recomienda usar la acción Enviar una solicitud HTTP y establecer el valor de encabezado personalizado como "sforce-auto-assign: false"
  14. Sin embargo, el conector de Salesforce tiene un control especial para la autenticación debido a una limitación en el back-end de Salesforce, los tokens expirarán si no se usan durante un largo período de tiempo y los usuarios podrían enfrentarse a un error "Bad_OAuth_Token/Sesión expirada o no válida". Vuelva a iniciar sesión con sus credenciales.
    • Esta limitación ahora se aborda, sin embargo, se debe crear una nueva conexión para su uso. La conexión preexistente seguirá funcionando, pero se puede enfrentar el problema anterior.

Ejemplo de un objeto complejo que no se admite porque tiene un objeto anidado con MerchandiseExtID__c campo:

{
    "Name" : "LineItemCreatedViaExtID",
    "Merchandise__r" :
    {
        "MerchandiseExtID__c" : 123
    }
}

Ejemplo del objeto complejo anterior reescrito como un objeto plano admitido:

{
    "Name" : "LineItemCreatedViaExtID",
    "MerchandiseExtID__c" : 123
}

Carga de datos adjuntos

Salesforce API admite la carga de datos adjuntos para los siguientes objetos: 'Account', 'Asset', 'Campaign', 'Case', 'Contact', 'Contract', 'Custom objects', 'EmailMessage', 'EmailTemplate', 'Event', 'Lead', 'Opportunity', 'Product2', 'Solution', 'Task'. Para cargar el archivo adjunto, use Crear acción de registro y consulte la página de documentación de Salesforce sobre los campos y parámetros necesarios.

Funciones y operacioneslegables de Power Apps para Salesforce

Estas operaciones de Power Apps, para un tipo de datos determinado, se pueden delegar en Salesforce para su procesamiento (en lugar de procesarlas localmente en Power Apps).

Funciones de nivel superior

  Delegable
Average No
Filter
LookUp
Máx. No
Minuto No
Search
Ordenar
SortByColumns
Suma No

Predicados Filter y LookUp

  Salesforce
not
IsBlank No
TrimEnds No
Len No
+, - No
<, <=, =, <>, >, >=
Y (&), o (||), No (!)
en
StartsWith No

Conector en profundidad

Para más información sobre el conector, consulte la sección en profundidad.

Límites generales

Nombre Importancia
Número máximo de solicitudes que procesa el conector simultáneamente 50

Creación de una conexión

El conector admite los siguientes tipos de autenticación:

Inicio de sesión con URI de inicio de sesión personalizado de Salesforce Inicio de sesión con URI de inicio de sesión personalizado de Salesforce Solo gobierno de EE. UU. (GCC) Compartible
Inicio de sesión con la cuenta de Salesforce Proporcione las credenciales de Salesforce para iniciar sesión. Todas las regiones Compartible
Valor predeterminado [EN DESUSO] Esta opción solo es para conexiones anteriores sin un tipo de autenticación explícito y solo se proporciona para la compatibilidad con versiones anteriores. Todas las regiones No se puede compartir

Inicio de sesión con URI de inicio de sesión personalizado de Salesforce

Identificador de autenticación: CustomLoginURIAuth

Aplicable: Solo gobierno de EE. UU. (GCC)

Inicio de sesión con URI de inicio de sesión personalizado de Salesforce

Se trata de una conexión que se puede compartir. Si la aplicación de energía se comparte con otro usuario, también se comparte la conexión. Para más información, consulte introducción a los conectores para aplicaciones de lienzo: Power Apps | Microsoft Docs

Nombre Tipo Description Obligatorio
URI de inicio de sesión de Salesforce cuerda / cadena https://custom-domain-or-instance.my.salesforce.com Cierto
Versión de la API de Salesforce cuerda / cadena Versión de la API de Salesforce. Para el valor predeterminado, deje en blanco o use v58.0

Inicio de sesión con la cuenta de Salesforce

Identificador de autenticación: BasicAuthentication

Aplicable: Todas las regiones

Proporcione las credenciales de Salesforce para iniciar sesión.

Se trata de una conexión que se puede compartir. Si la aplicación de energía se comparte con otro usuario, también se comparte la conexión. Para más información, consulte introducción a los conectores para aplicaciones de lienzo: Power Apps | Microsoft Docs

Nombre Tipo Description Obligatorio
URI de inicio de sesión (entorno) cuerda / cadena Identificador URI de inicio de sesión de Salesforce. En Producción, deje en blanco o use https://login.salesforce.com
Versión de la API de Salesforce cuerda / cadena Versión de la API de Salesforce. Para el valor predeterminado, deje en blanco o use v58.0

Valor predeterminado [EN DESUSO]

Aplicable: Todas las regiones

Esta opción solo es para conexiones anteriores sin un tipo de autenticación explícito y solo se proporciona para la compatibilidad con versiones anteriores.

Esta conexión no se puede compartir. Si la aplicación de energía se comparte con otro usuario, se pedirá a otro usuario que cree explícitamente una nueva conexión.

Nombre Tipo Description Obligatorio
URI de inicio de sesión (entorno) cuerda / cadena Identificador URI de inicio de sesión de Salesforce. En Producción, deje en blanco o use https://login.salesforce.com
Versión de la API de Salesforce cuerda / cadena Versión de la API de Salesforce. Para el valor predeterminado, deje en blanco o use v58.0

Limitaciones

Nombre Llamadas Período de renovación
Llamadas API por conexión 900 60 segundos

Acciones

Carga de datos de trabajo

Carga datos para un trabajo mediante datos CSV.

Cerrar o anular un trabajo

Cierra o anula un trabajo. Use UploadComplete para cerrar un trabajo o Anular para anular un trabajo. Si cierra un trabajo, Salesforce pone en cola el trabajo y carga los datos para su procesamiento y no puede agregar datos de trabajo adicionales. Si anula un trabajo, el trabajo no se pone en cola ni se procesa.

Creación de un trabajo (V2)

Crea un trabajo, que representa una operación masiva (y datos asociados) que se envía a Salesforce para el procesamiento asincrónico. Proporcione datos de trabajo a través de una solicitud cargar datos de trabajo.

Crear registro

Esta operación crea un registro y permite valores NULL.

Crear registro [EN DESUSO]

Esta operación crea un registro.

Crear un trabajo [EN DESUSO]

Esta acción ha quedado en desuso. Use Crear un trabajo (V2) en su lugar.

Crea un trabajo, que representa una operación masiva (y datos asociados) que se envía a Salesforce para el procesamiento asincrónico. Proporcione datos de trabajo a través de una solicitud cargar datos de trabajo.

Ejecución de una consulta de búsqueda SOSL

Ejecución de la búsqueda soSL especificada qyery

Ejecución de una consulta SOQL

Ejecute una consulta SOQL.

Eliminación de un trabajo

Elimina un trabajo. Para eliminarlo, un trabajo debe tener el estado UploadComplete, JobComplete, Aborted o Failed.

Eliminar registro

Esta operación elimina un registro.

Enviar una solicitud HTTP

Construcción de una solicitud de API REST de Salesforce para invocar

Insertar o actualizar (Upsert) un registro por identificador externo (V2)

Esta operación inserta o actualiza (upserts) un registro mediante un identificador externo.

Insertar o actualizar (Upsert) un registro por identificador externo [EN DESUSO]

Esta acción ha quedado en desuso. Use Insert or Update (Upsert) a Record by External ID (V2) en su lugar.

Esta operación inserta o actualiza (upserts) un registro mediante un identificador externo.

Obtención de los resultados del trabajo

Recupera una lista de registros en función del tipo de resultado de un trabajo completado.

Obtención de registros de casos de Salesforce

Esta operación obtiene registros case de Salesforce.

Obtención de registros de cuentas de Salesforce

Esta operación obtiene registros de cuenta de Salesforce.

Obtención de registros de oportunidades de Salesforce

Esta operación obtiene registros de oportunidades de Salesforce.

Obtención de registros de productos de Salesforce

Esta operación obtiene registros de producto de Salesforce.

Obtener información del trabajo

Recupera información detallada sobre un trabajo.

Obtener registro

Esta operación obtiene un registro.

Obtener registro [EN DESUSO]

Esta acción ha quedado en desuso. Use Obtener registro en su lugar.

Esta operación obtiene un registro.

Obtener registros

Esta operación obtiene registros de un tipo de objeto de Salesforce determinado, como "Clientes potenciales".

Obtener registros de contacto de Salesforce

Esta operación obtiene los registros de contacto de Salesforce.

Obtener registros de usuario de Salesforce

Esta operación obtiene registros de usuario de Salesforce.

Obtener tipos de objeto

Esta operación enumera los tipos de objetos de Salesforce disponibles.

Obtener todos los trabajos

Obtener una lista de todos los trabajos

Obtener un registro por identificador externo

Esta operación recupera un registro mediante un identificador externo.

Registro de actualización (V3)

Esta operación actualiza un registro y permite valores NULL.

Registro de actualización [EN DESUSO]

Esta acción ha quedado en desuso. Use el registro de actualización (V3) en su lugar.

Esta operación actualiza un registro y permite valores NULL.

Registro de actualización [EN DESUSO]

Esta operación actualiza un registro.

Servidor MCP para Salesforce

Servidor MCP para Salesforce

Carga de datos de trabajo

Carga datos para un trabajo mediante datos CSV.

Parámetros

Nombre Clave Requerido Tipo Description
Id. del trabajo
jobId True string

Id. del trabajo

Contenido del archivo CSV
body True binary

Datos CSV para cargar

Cerrar o anular un trabajo

Cierra o anula un trabajo. Use UploadComplete para cerrar un trabajo o Anular para anular un trabajo. Si cierra un trabajo, Salesforce pone en cola el trabajo y carga los datos para su procesamiento y no puede agregar datos de trabajo adicionales. Si anula un trabajo, el trabajo no se pone en cola ni se procesa.

Parámetros

Nombre Clave Requerido Tipo Description
Id. del trabajo
jobId True string

Id. del trabajo

estado
state True string

estado

Devoluciones

Body
JobInfo

Creación de un trabajo (V2)

Crea un trabajo, que representa una operación masiva (y datos asociados) que se envía a Salesforce para el procesamiento asincrónico. Proporcione datos de trabajo a través de una solicitud cargar datos de trabajo.

Parámetros

Nombre Clave Requerido Tipo Description
Objeto
object True string

Tipo de objeto para los datos que se procesan.

Operation
operation True string

Operación de procesamiento para el trabajo.

Delimitador de columna
columnDelimiter string

Delimitador de columna usado para datos de trabajo CSV.

Nombre del campo de id. externo
externalIdFieldName string

Campo id. externo del objeto que se está actualizando. Solo es necesario para las operaciones upsert. Los valores de campo también deben existir en los datos del trabajo CSV.

Fin de línea
lineEnding string

Final de línea usado para los datos del trabajo CSV, marcando el final de una fila de datos.

Tipo de contenido
contentType string

Tipo de contenido para el trabajo.

Devoluciones

Salida de la operación "CreateJobV2"

Crear registro

Esta operación crea un registro y permite valores NULL.

Parámetros

Nombre Clave Requerido Tipo Description
Tipo de objeto salesforce
table True string

Nombre de la tabla

Registro
item True dynamic

Registro

Devoluciones

Las salidas de esta operación son dinámicas.

Crear registro [EN DESUSO]

Esta operación crea un registro.

Parámetros

Nombre Clave Requerido Tipo Description
Tipo de objeto salesforce
table True string

El tipo de objeto Salesforce, como "Clientes potenciales".

Registro
item True dynamic

Registro que se va a crear.

Devoluciones

Las salidas de esta operación son dinámicas.

Crear un trabajo [EN DESUSO]

Esta acción ha quedado en desuso. Use Crear un trabajo (V2) en su lugar.

Crea un trabajo, que representa una operación masiva (y datos asociados) que se envía a Salesforce para el procesamiento asincrónico. Proporcione datos de trabajo a través de una solicitud cargar datos de trabajo.

Parámetros

Nombre Clave Requerido Tipo Description
Delimitador de columna
columnDelimiter string

Delimitador de columna

Nombre del campo de id. externo
externalIdFieldName string

Nombre del campo de id. externo

Fin de línea
lineEnding string

Fin de línea

Objeto
object True string

Objeto

Operation
operation True string

Operation

Devoluciones

Body
JobInfo

Ejecución de una consulta de búsqueda SOSL

Ejecución de la búsqueda soSL especificada qyery

Parámetros

Nombre Clave Requerido Tipo Description
Cadena de búsqueda SOSL
q True string

Cadena de búsqueda SOSL

Devoluciones

Respuesta de consulta de búsqueda SOSL

Ejecución de una consulta SOQL

Ejecute una consulta SOQL.

Parámetros

Nombre Clave Requerido Tipo Description
Consulta SOQL
query True string

Texto de consulta SOQL. Los parámetros dinámicos se pueden especificar mediante la sintaxis "@paramName".

Parámetros de consulta
parameters object

Parámetros dinámicos de consulta SOQL. La clave es el nombre del parámetro (sin '@' al signo), el valor es el valor del parámetro.

Devoluciones

response
object

Eliminación de un trabajo

Elimina un trabajo. Para eliminarlo, un trabajo debe tener el estado UploadComplete, JobComplete, Aborted o Failed.

Parámetros

Nombre Clave Requerido Tipo Description
Id. del trabajo
jobId True string

Id. del trabajo

Eliminar registro

Esta operación elimina un registro.

Parámetros

Nombre Clave Requerido Tipo Description
Tipo de objeto salesforce
table True string

El tipo de objeto Salesforce, como "Clientes potenciales".

Id. de registro
id True string

Identificador único del registro que se va a eliminar.

Enviar una solicitud HTTP

Construcción de una solicitud de API REST de Salesforce para invocar

Parámetros

Nombre Clave Requerido Tipo Description
URI
Uri True string

URI completo o relativo. Ejemplo de URI relativo: /services/data/v41.0/sobjects/account

Método
Method True string

El método HTTP (el valor predeterminado es GET).

Body
Body binary

Contenido del cuerpo de la solicitud.

Tipo de contenido
ContentType string

Encabezado de tipo de contenido para el cuerpo (el valor predeterminado es application/json).

CustomHeader1
CustomHeader1 string

Encabezado personalizado 1. Especifique en formato: header-name: header-value

CustomHeader2
CustomHeader2 string

Encabezado personalizado 2. Especifique en formato: header-name: header-value

CustomHeader3
CustomHeader3 string

Encabezado personalizado 3. Especifique en formato: header-name: header-value

CustomHeader4
CustomHeader4 string

Encabezado personalizado 4. Especifique en formato: header-name: header-value

CustomHeader5
CustomHeader5 string

Encabezado personalizado 5. Especifique en formato: header-name: header-value

Devoluciones

Insertar o actualizar (Upsert) un registro por identificador externo (V2)

Esta operación inserta o actualiza (upserts) un registro mediante un identificador externo.

Parámetros

Nombre Clave Requerido Tipo Description
Tipo de objeto salesforce
table True string

El tipo de objeto Salesforce, como "Clientes potenciales".

Campo de identificador externo
externalIdField True string

Campo marcado como campo de identificador externo en el objeto Salesforce.

External ID
externalId True string

Identificador externo del registro en upsert.

Registro
item True dynamic

Registro con propiedades modificadas.

Devoluciones

Las salidas de esta operación son dinámicas.

Insertar o actualizar (Upsert) un registro por identificador externo [EN DESUSO]

Esta acción ha quedado en desuso. Use Insert or Update (Upsert) a Record by External ID (V2) en su lugar.

Esta operación inserta o actualiza (upserts) un registro mediante un identificador externo.

Parámetros

Nombre Clave Requerido Tipo Description
Tipo de objeto salesforce
table True string

El tipo de objeto Salesforce, como "Clientes potenciales".

Campo de identificador externo
externalIdField True string

Campo marcado como campo de identificador externo en el objeto Salesforce.

External ID
externalId True string

Identificador externo del registro en upsert.

Registro
item True dynamic

Registro con propiedades modificadas.

Devoluciones

Las salidas de esta operación son dinámicas.

Obtención de los resultados del trabajo

Recupera una lista de registros en función del tipo de resultado de un trabajo completado.

Parámetros

Nombre Clave Requerido Tipo Description
Id. del trabajo
jobId True string

Id. del trabajo

Tipo de resultado
resultType True string

Tipo de resultado

Devoluciones

response
string

Obtención de registros de casos de Salesforce

Esta operación obtiene registros case de Salesforce.

Parámetros

Nombre Clave Requerido Tipo Description
Consulta de filtro
$filter string

Una consulta de filtro ODATA para restringir las entradas devueltas (por ejemplo, stringColumn eq 'string' OR numberColumn lt 123).

Ordenar por
$orderby string

Una consulta orderBy de ODATA para especificar el orden de las entradas.

Recuento superior
$top integer

Número total de entradas que se van a recuperar (valor predeterminado = todo).

Omitir recuento
$skip integer

Número de entradas que se van a omitir (valor predeterminado = 0).

Seleccionar consulta
$select string

Campos específicos que se van a recuperar de las entradas (valor predeterminado = todo).

Devoluciones

Las salidas de esta operación son dinámicas.

Obtención de registros de cuentas de Salesforce

Esta operación obtiene registros de cuenta de Salesforce.

Parámetros

Nombre Clave Requerido Tipo Description
Consulta de filtro
$filter string

Una consulta de filtro ODATA para restringir las entradas devueltas (por ejemplo, stringColumn eq 'string' OR numberColumn lt 123).

Ordenar por
$orderby string

Una consulta orderBy de ODATA para especificar el orden de las entradas.

Recuento superior
$top integer

Número total de entradas que se van a recuperar (valor predeterminado = todo).

Omitir recuento
$skip integer

Número de entradas que se van a omitir (valor predeterminado = 0).

Seleccionar consulta
$select string

Campos específicos que se van a recuperar de las entradas (valor predeterminado = todo).

Devoluciones

Las salidas de esta operación son dinámicas.

Obtención de registros de oportunidades de Salesforce

Esta operación obtiene registros de oportunidades de Salesforce.

Parámetros

Nombre Clave Requerido Tipo Description
Consulta de filtro
$filter string

Una consulta de filtro ODATA para restringir las entradas devueltas (por ejemplo, stringColumn eq 'string' OR numberColumn lt 123).

Ordenar por
$orderby string

Una consulta orderBy de ODATA para especificar el orden de las entradas.

Recuento superior
$top integer

Número total de entradas que se van a recuperar (valor predeterminado = todo).

Omitir recuento
$skip integer

Número de entradas que se van a omitir (valor predeterminado = 0).

Seleccionar consulta
$select string

Campos específicos que se van a recuperar de las entradas (valor predeterminado = todo).

Devoluciones

Las salidas de esta operación son dinámicas.

Obtención de registros de productos de Salesforce

Esta operación obtiene registros de producto de Salesforce.

Parámetros

Nombre Clave Requerido Tipo Description
Consulta de filtro
$filter string

Una consulta de filtro ODATA para restringir las entradas devueltas (por ejemplo, stringColumn eq 'string' OR numberColumn lt 123).

Ordenar por
$orderby string

Una consulta orderBy de ODATA para especificar el orden de las entradas.

Recuento superior
$top integer

Número total de entradas que se van a recuperar (valor predeterminado = todo).

Omitir recuento
$skip integer

Número de entradas que se van a omitir (valor predeterminado = 0).

Seleccionar consulta
$select string

Campos específicos que se van a recuperar de las entradas (valor predeterminado = todo).

Devoluciones

Las salidas de esta operación son dinámicas.

Obtener información del trabajo

Recupera información detallada sobre un trabajo.

Parámetros

Nombre Clave Requerido Tipo Description
Id. del trabajo
jobId True string

Id. del trabajo

Devoluciones

Obtener registro

Esta operación obtiene un registro.

Parámetros

Nombre Clave Requerido Tipo Description
Tipo de objeto salesforce
table True string

Nombre de la tabla

Id. de registro
id True string

clave de elemento

Seleccionar consulta
$select string

Campos específicos que se van a recuperar de las entradas (valor predeterminado = todo).

Devoluciones

Las salidas de esta operación son dinámicas.

Obtener registro [EN DESUSO]

Esta acción ha quedado en desuso. Use Obtener registro en su lugar.

Esta operación obtiene un registro.

Parámetros

Nombre Clave Requerido Tipo Description
table
table True string
id
id True string

Devoluciones

Las salidas de esta operación son dinámicas.

Obtener registros

Esta operación obtiene registros de un tipo de objeto de Salesforce determinado, como "Clientes potenciales".

Parámetros

Nombre Clave Requerido Tipo Description
Tipo de objeto salesforce
table True string

El tipo de objeto Salesforce, como "Clientes potenciales".

Consulta de filtro
$filter string

Una consulta de filtro ODATA para restringir las entradas devueltas (por ejemplo, stringColumn eq 'string' OR numberColumn lt 123).

Ordenar por
$orderby string

Una consulta orderBy de ODATA para especificar el orden de las entradas.

Recuento superior
$top integer

Número total de entradas que se van a recuperar (valor predeterminado = todo).

Omitir recuento
$skip integer

Número de entradas que se van a omitir (valor predeterminado = 0).

Seleccionar consulta
$select string

Campos específicos que se van a recuperar de las entradas (valor predeterminado = todo).

Devoluciones

Las salidas de esta operación son dinámicas.

Obtener registros de contacto de Salesforce

Esta operación obtiene los registros de contacto de Salesforce.

Parámetros

Nombre Clave Requerido Tipo Description
Consulta de filtro
$filter string

Una consulta de filtro ODATA para restringir las entradas devueltas (por ejemplo, stringColumn eq 'string' OR numberColumn lt 123).

Ordenar por
$orderby string

Una consulta orderBy de ODATA para especificar el orden de las entradas.

Recuento superior
$top integer

Número total de entradas que se van a recuperar (valor predeterminado = todo).

Omitir recuento
$skip integer

Número de entradas que se van a omitir (valor predeterminado = 0).

Seleccionar consulta
$select string

Campos específicos que se van a recuperar de las entradas (valor predeterminado = todo).

Devoluciones

Las salidas de esta operación son dinámicas.

Obtener registros de usuario de Salesforce

Esta operación obtiene registros de usuario de Salesforce.

Parámetros

Nombre Clave Requerido Tipo Description
Consulta de filtro
$filter string

Una consulta de filtro ODATA para restringir las entradas devueltas (por ejemplo, stringColumn eq 'string' OR numberColumn lt 123).

Ordenar por
$orderby string

Una consulta orderBy de ODATA para especificar el orden de las entradas.

Recuento superior
$top integer

Número total de entradas que se van a recuperar (valor predeterminado = todo).

Omitir recuento
$skip integer

Número de entradas que se van a omitir (valor predeterminado = 0).

Seleccionar consulta
$select string

Campos específicos que se van a recuperar de las entradas (valor predeterminado = todo).

Devoluciones

Las salidas de esta operación son dinámicas.

Obtener tipos de objeto

Esta operación enumera los tipos de objetos de Salesforce disponibles.

Devoluciones

Representa una lista de tablas.

Body
TablesList

Obtener todos los trabajos

Obtener una lista de todos los trabajos

Parámetros

Nombre Clave Requerido Tipo Description
Modo de simultaneidad
concurrenyMode string

Modo de simultaneidad

¿Está habilitada la fragmentación de PK?
isPkChunkingEnabled boolean

¿Está habilitada la fragmentación de PK?

Tipo de trabajo
jobType string

Tipo de trabajo

Localizador de consultas
queryLocator string

Localizador de consultas

Devoluciones

Obtener un registro por identificador externo

Esta operación recupera un registro mediante un identificador externo.

Parámetros

Nombre Clave Requerido Tipo Description
Tipo de objeto salesforce
table True string

El tipo de objeto Salesforce, como "Clientes potenciales".

Campo de identificador externo
externalIdField True string

Campo marcado como campo de identificador externo en el objeto Salesforce.

External ID
externalId True string

Identificador externo del registro que se va a recuperar.

Devoluciones

Las salidas de esta operación son dinámicas.

Registro de actualización (V3)

Esta operación actualiza un registro y permite valores NULL.

Parámetros

Nombre Clave Requerido Tipo Description
Tipo de objeto salesforce
table True string

Nombre de la tabla

Id. de registro
id True string

clave de elemento

elemento que se va a actualizar
item True dynamic

elemento que se va a actualizar

Seleccionar consulta
$select string

Campos específicos que se van a recuperar de las entradas (valor predeterminado = todo).

Devoluciones

Las salidas de esta operación son dinámicas.

Registro de actualización [EN DESUSO]

Esta acción ha quedado en desuso. Use el registro de actualización (V3) en su lugar.

Esta operación actualiza un registro y permite valores NULL.

Parámetros

Nombre Clave Requerido Tipo Description
Tipo de objeto salesforce
table True string

Nombre de la tabla

Id. de registro
id True string

clave de elemento

elemento que se va a actualizar
item True dynamic

elemento que se va a actualizar

Seleccionar consulta
$select string

Campos específicos que se van a recuperar de las entradas (valor predeterminado = todo).

Devoluciones

Las salidas de esta operación son dinámicas.

Registro de actualización [EN DESUSO]

Esta operación actualiza un registro.

Parámetros

Nombre Clave Requerido Tipo Description
Tipo de objeto salesforce
table True string

El tipo de objeto Salesforce, como "Clientes potenciales".

Id. de registro
id True string

Identificador único del registro que se va a actualizar.

Registro
item True dynamic

Registro con propiedades modificadas.

Devoluciones

Las salidas de esta operación son dinámicas.

Servidor MCP para Salesforce

Servidor MCP para Salesforce

Parámetros

Nombre Clave Requerido Tipo Description
jsonrpc
jsonrpc string
id
id string
method
method string
parámetros
params object
resultado
result object
error
error object
sessionId
sessionId string

Devoluciones

Desencadenadores

Cuando se crea un registro

Esta operación se desencadena cuando hay registros recién creados.

Cuando se modifica un registro

Esta operación se desencadena cuando hay registros recién modificados.

Cuando se crea un registro

Esta operación se desencadena cuando hay registros recién creados.

Parámetros

Nombre Clave Requerido Tipo Description
Tipo de objeto salesforce
table True string

El tipo de objeto Salesforce, como "Clientes potenciales".

Consulta de filtro
$filter string

Una consulta de filtro ODATA para restringir las entradas devueltas (por ejemplo, stringColumn eq 'string' OR numberColumn lt 123).

Ordenar por
$orderby string

Una consulta orderBy de ODATA para especificar el orden de las entradas.

Seleccionar consulta
$select string

Campos específicos que se van a recuperar de las entradas (valor predeterminado = todo).

Devoluciones

Las salidas de esta operación son dinámicas.

Cuando se modifica un registro

Esta operación se desencadena cuando hay registros recién modificados.

Parámetros

Nombre Clave Requerido Tipo Description
Tipo de objeto salesforce
table True string

El tipo de objeto Salesforce, como "Clientes potenciales".

Consulta de filtro
$filter string

Una consulta de filtro ODATA para restringir las entradas devueltas (por ejemplo, stringColumn eq 'string' OR numberColumn lt 123).

Ordenar por
$orderby string

Una consulta orderBy de ODATA para especificar el orden de las entradas.

Seleccionar consulta
$select string

Campos específicos que se van a recuperar de las entradas (valor predeterminado = todo).

Devoluciones

Las salidas de esta operación son dinámicas.

Definiciones

CreateJobResponse

Salida de la operación "CreateJobV2"

Nombre Ruta de acceso Tipo Description
Objeto
object string

Tipo de objeto para los datos que se procesan.

Operation
operation string

Operación de procesamiento para el trabajo.

Delimitador de columna
columnDelimiter string

Delimitador de columna usado para datos de trabajo CSV.

Nombre del campo de id. externo
externalIdFieldName string

Campo id. externo del objeto que se está actualizando. Solo es necesario para las operaciones upsert. Los valores de campo también deben existir en los datos del trabajo CSV.

Fin de línea
lineEnding string

Final de línea usado para los datos del trabajo CSV, marcando el final de una fila de datos.

Tipo de contenido
contentType string

Tipo de contenido para el trabajo.

Versión de la API
apiVersion float

Versión de la API en la que se creó el trabajo.

Modo de simultaneidad
concurrencyMode string

Modo de simultaneidad para el trabajo.

Dirección URL de contenido
contentUrl string

Dirección URL que se va a usar para cargar solicitudes de datos de trabajo para este trabajo. Solo es válido si el trabajo está en estado "Abrir".

Creado por identificador
createdById string

Identificador del usuario que creó el trabajo.

Fecha de creación
createdDate date-time

Fecha y hora en la zona horaria UTC cuando se creó el trabajo.

Id
id string

Identificador único para este trabajo.

Tipo de trabajo
jobType string

Tipo del trabajo.

Estado
state string

Estado actual del procesamiento del trabajo.

Módulo del sistema
systemModstamp date-time

Fecha y hora en la zona horaria UTC cuando finalice el trabajo.

Table

Representa una tabla.

Nombre Ruta de acceso Tipo Description
Nombre
Name string

Nombre de la tabla. El nombre se usa en tiempo de ejecución.

DisplayName (Nombre para mostrar)
DisplayName string

Nombre para mostrar de la tabla.

DynamicProperties
DynamicProperties object

Propiedades de tabla adicionales proporcionadas por el conector a los clientes.

TablesList

Representa una lista de tablas.

Nombre Ruta de acceso Tipo Description
value
value array of Table

Lista de tablas

GetAllJobsResponse

Nombre Ruta de acceso Tipo Description
Done
done boolean

Done

archivo
records array of JobInfo
Siguiente URL de recored
nextRecordUrl string

Dirección URL del registro siguiente

JobInfo

Nombre Ruta de acceso Tipo Description
Versión de la API
apiVersion float

Versión de la API

Delimitador de columna
columnDelimiter string

Delimitador de columna

Modo de simultaneidad
concurrencyMode string

Modo de simultaneidad

Tipo de contenido
contentType string

Tipo de contenido

Dirección URL de contenido
contentUrl string

Dirección URL de contenido

Creado por id.
createdById string

Creado por id.

Fecha de creación
createdDate date-time

Fecha de creación

Nombre del campo de id. externo
externalIdFieldName string

Nombre del campo de id. externo

identificación
id string

identificación

Tipo de trabajo
jobType string

Tipo de trabajo

Fin de línea
lineEnding string

Fin de línea

Objeto
object string

Objeto

Operation
operation string

Operation

Estado
state string

Estado

Marca de módulos del sistema
systemModstamp date-time

Marca de módulos del sistema

CheckJobResponse

Nombre Ruta de acceso Tipo Description
Tiempo de procesamiento de APEX
apexProcessingTime number

Tiempo de procesamiento de APEX

Tiempo de procesamiento activo de API
apiActiveProcessingTime number

Tiempo de procesamiento activo de API

Versión de la API
apiVersion float

Versión de la API

Delimitador de columna
columnDelimiter string

Delimitador de columna

Modo de simultaneidad
concurrencyMode string

Modo de simultaneidad

Tipo de contenido
contentType string

Tipo de contenido

Dirección URL de contenido
contentUrl string

Dirección URL de contenido

Creado por id.
createdById string

Creado por id.

Fecha de creación
createdDate date-time

Fecha de creación

Nombre de campo externo
externalFieldName string

Nombre de campo externo

identificación
id string

identificación

Tipo de trabajo
jobType string

Tipo de trabajo

Fin de línea
lineEnding string

Fin de línea

Objeto
object string

Objeto

Operation
operation string

Operation

Reintentos
retries number

Reintentos

Estado
state string

Estado

systemModStamp
systemModStamp date-time
Tiempo total de procesamiento
totalProcessingTime number

Tiempo total de procesamiento

SOSLSearchQueryResponse

Respuesta de consulta de búsqueda SOSL

Nombre Ruta de acceso Tipo Description
searchRecords
searchRecords array of SearchRecordObject

Lista de registros de búsqueda devueltos por una consulta de búsqueda SOSL

SearchRecordObject

Registro individual devuelto por la consulta SOSL

Nombre Ruta de acceso Tipo Description
type
attributes.type string

Tipo del registro

URL
attributes.url string

Ruta de acceso de API que se puede usar para recuperar el objeto

Id
Id string

Identificador único del registro

ObjectWithoutType

MCPQueryResponse

Nombre Ruta de acceso Tipo Description
jsonrpc
jsonrpc string
id
id string
method
method string
parámetros
params object
resultado
result object
error
error object

cuerda / cadena

Este es el tipo de datos básico "string".

objeto

Este es el tipo 'objeto'.