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
- 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.
- 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 .
- 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).
- Las cuentas de prueba de Salesforce no tienen acceso a la API y, por tanto, no se pueden usar.
- Las acciones Crear registro y Actualizar registro (V3) no admiten campos personalizados de tipo "Picklist (Multi-Select)" (incluidas sus respectivas versiones en desuso).
- No se admite la creación de una nueva conexión mediante el inicio de sesión "Dominio personalizado" de Salesforce.
- El uso de campos que aceptan valores NULL en
Order Byel 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. - 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.
- 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.
- 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.
- 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.
- 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).
- 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"
- 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 | Sí |
| LookUp | Sí |
| Máx. | No |
| Minuto | No |
| Search | Sí |
| Ordenar | Sí |
| SortByColumns | Sí |
| Suma | No |
Predicados Filter y LookUp
| Salesforce | |
|---|---|
| not | Sí |
| IsBlank | No |
| TrimEnds | No |
| Len | No |
| +, - | No |
| <, <=, =, <>, >, >= | Sí |
| Y (&), o (||), No (!) | Sí |
| en | Sí |
| 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.
|
| 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.
|
| 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.
|
| 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.
|
| 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"
- Body
- CreateJobResponse
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
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
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
- response
- ObjectWithoutType
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
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
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
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
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
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
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
- Body
- CheckJobResponse
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
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
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
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
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
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
- Body
- GetAllJobsResponse
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
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
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
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
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
- Body
- MCPQueryResponse
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
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
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'.