Detalles de Conexión de Oracle Sales Cloud¶

Introducción¶

Versión del conector

Esta documentación se basa en la versión 21.0.8257 del conector.

Empezando¶

Compatibilidad con la versión de Oracle Sales

Establecer una Conexión¶

Oracle Sales utiliza la autenticación básica sobre SSL; después de configurar las siguientes propiedades de conexión, está listo para conectarse:

• Username: Configure esto con el nombre de usuario que utiliza para iniciar sesión en su servicio de Oracle Cloud.
• Password: Configure esto con su contraseña.
• HostURL: establezca esto en la dirección web (URL) de su servicio Oracle Cloud.

Objetos y Campos Personalizados¶

Los esquemas para las tablas estándar de Oracle Sales se almacenan internamente en Jitterbit Connector for Oracle Sales y se utilizan para minimizar la cantidad de solicitudes enviadas y la carga útil recibida. De forma predeterminada, Jitterbit Connector for Oracle Sales utilizará estas tablas y no expondrá ninguno de los objetos personalizados de su instancia. Mientras que los campos personalizados están expuestos desde IncludeCustomFields por defecto es verdadero.

Jitterbit Connector for Oracle Sales admite la recuperación dinámica de esquemas para objetos y campos personalizados desde su instancia específica de Oracle Sales siguiendo los pasos que se describen a continuación.

Incluyendo Campos Personalizados¶

En caso de que su esquema necesite incluir campos personalizados (columnas) agregados a los objetos estándar de Oracle Sales (tablas), puede usar IncludeCustomFields propiedad de conexión. Establecer esta propiedad en verdadero dará como resultado que se emitan una o más llamadas adicionales y afectará el comportamiento de Jitterbit Connector for Oracle Sales de las siguientes maneras:

• Los campos personalizados se recuperarán y enumerarán junto con el resto de las columnas de su esquema.
• Todas las columnas almacenadas internamente se reemplazarán con columnas generadas dinámicamente según la última versión de la API.

Colocar IncludeCustomFields a falso para mejorar el rendimiento.

Incluyendo Objetos Personalizados¶

En caso de que necesite acceder a objetos personalizados (tablas), creados para su instancia de Oracle Sales, puede usar el IncludeCustomObjects propiedad de conexión. De forma predeterminada, esta propiedad se establece en falso y, cuando se intentan realizar consultas en objetos personalizados, no se ejecutarán debido al esquema interno que se está utilizando. Similar a IncludeCustomFields, al establecer esta propiedad en verdadero, se emitirán una o más solicitudes adicionales.

Generación de Archivos de Esquema¶

Si necesita trabajar regularmente con campos personalizados y/u objetos personalizados, puede usar el GenerateSchemaFiles propiedad de conexión para almacenar localmente un esquema generado dinámicamente y evitar el uso constante IncludeCustomFields y IncludeCustomObjects, que a cambio disminuirá el tiempo de ejecución y la carga útil.

Note: Configuración GenerateSchemaFiles=OnStart/OnUse solo generará un esquema que contenga campos personalizados para todas las tablas estándar, pero no para ninguna tabla personalizada. Usando GenerateSchemaFiles combinado con IncludeCustomObjects le permite generar un esquema que contiene campos y objetos personalizados.

Notas Importantes¶

Procedimientos Almacenados¶

• Las funciones de procedimientos almacenados descritas en esta documentación no se admiten actualmente.
• Debido a que los procedimientos almacenados no se admiten actualmente, cualquier característica que dependa de los procedimientos almacenados tampoco se admite actualmente.

Archivos de Configuración y Sus Rutas¶

• Todas las referencias a la adición de archivos de configuración y sus rutas se refieren a archivos y ubicaciones en Harmony Agente donde está instalado el conector. Estas rutas deben ajustarse según corresponda según el agente y el sistema operativo. Si se utilizan varios agentes en un grupo de agentes, se requerirán archivos idénticos en cada agente.

Características Avanzadas¶

Esta sección detalla una selección de funciones avanzadas del conector Oracle Sales.

Vistas definidas por el usuario

El conector le permite definir tablas virtuales, llamadas vistas definidas por el usuario, cuyo contenido se decide mediante una consultar preconfigurada. Estas vistas son útiles cuando no puede controlar directamente las consultas que se envían a los controladores. Consulte Vistas definidas por el usuario para obtener una descripción general de la creación y configuración de vistas personalizadas.

Configuración SSL

Usar Configuración SSL para ajustar cómo el conector maneja las negociaciones de certificados TLS/SSL. Puede elegir entre varios formatos de certificado; ver el SSLServerCert propiedad en "Opciones de cadena de conexión" para obtener más información.

Apoderado

Para configurar el conector mediante Configuración de proxy de Agente Privado, Selecciona el Use Proxy Settings casilla de verificación en la pantalla de configuración de la conexión.

Vistas Definidas por el Usuario¶

Jitterbit Connector for Oracle Sales le permite definir una tabla virtual cuyos contenidos se deciden mediante una consultar preconfigurada. Estas se denominan Vistas definidas por el usuario, que son útiles en situaciones en las que no puede controlar directamente la consultar que se envía al controlador, por ejemplo, cuando se utiliza el controlador de Jitterbit. Las vistas definidas por el usuario se pueden utilizar para definir predicados que siempre se aplican. Si especifica predicados adicionales en la consultar a la vista, se combinan con la consultar ya definida como parte de la vista.

Hay dos formas de crear vistas definidas por el usuario:

• Cree un archivo de configuración con formato JSON que defina las vistas que desea.
• Declaraciones DDL.

Definición de Vistas Usando un Archivo de Configuración¶

Las vistas definidas por el usuario se definen en un archivo de configuración con formato JSON llamado UserDefinedViews.json. El conector detecta automáticamente las vistas especificadas en este archivo.

También puede tener múltiples definiciones de vista y controlarlas usando UserDefinedViews propiedad de conexión. Cuando utiliza esta propiedad, el conector solo ve las vistas especificadas.

Este archivo de configuración de vista definida por el usuario tiene el siguiente formato:

• Cada elemento raíz define el nombre de una vista.
• Cada elemento raíz contiene un elemento hijo, llamado query, que contiene la consultar SQL personalizada para la vista.

Por ejemplo:

{
    "MyView": {
        "query": "SELECT * FROM Opportunities WHERE MyColumn = 'value'"
    },
    "MyView2": {
        "query": "SELECT * FROM MyTable WHERE Id IN (1,2,3)"
    }
}

Utilizar el UserDefinedViews propiedad de conexión para especificar la ubicación de su archivo de configuración JSON. Por ejemplo:

"UserDefinedViews", "C:\Users\yourusername\Desktop\tmp\UserDefinedViews.json"

Esquema para Vistas Definidas por el Usuario¶

Las vistas definidas por el usuario se exponen en UserViews esquema por defecto. Esto se hace para evitar que el nombre de la vista entre en conflicto con una entidad real en el modelo de datos. Puede cambiar el nombre del esquema utilizado para UserViews configurando UserViewsSchemaName propiedad.

Trabajar con Vistas Definidas por el Usuario¶

Por ejemplo, una instrucción SQL con una vista definida por el usuario llamada UserViews.RCustomers solo enumera clientes en Raleigh:

SELECT * FROM Customers WHERE City = 'Raleigh';

Un ejemplo de una consultar al controlador:

SELECT * FROM UserViews.RCustomers WHERE Status = 'Active';

Dando como resultado la consultar efectiva a la fuente:

SELECT * FROM Customers WHERE City = 'Raleigh' AND Status = 'Active';

Ese es un ejemplo muy simple de una consultar a una vista definida por el usuario que es efectivamente una combinación de la consultar de vista y la definición de vista. Es posible componer estas consultas en patrones mucho más complejos. Todas las operaciones de SQL están permitidas en ambas consultas y se combinan cuando corresponde.

Configuración SSL¶

Personalización de la Configuración SSL¶

De forma predeterminada, el conector intenta negociar SSL/TLS comparando el certificado del servidor con el almacén de certificados de confianza del sistema.

Para especificar otro certificado, consulte SSLServerCert propiedad de los formatos disponibles para hacerlo.

Modelo de Datos¶

Jitterbit Connector for Oracle Sales modela los objetos de Oracle Sales como tablas relacionales. Las tablas admiten tanto la recuperación como la actualización de datos.

Puede trabajar con todas las tablas de su cuenta. El conector se conecta a Oracle Sales y obtiene la lista de tablas y los metadatos de las tablas llamando a los servicios web apropiados. Cualquier cambio que realice en su cuenta de Oracle Sales, como agregar una nueva tabla, agregar nuevas columnas o cambiar el tipo de datos de una columna, se reflejará inmediatamente cuando use el conector para conectarse.

Mesas

Los objetos de Oracle Sales tienen relaciones con otros objetos; en las tablas, estas relaciones se expresan a través de claves foráneas. Los objetos de Oracle Sales también forman parte de una aplicación que contiene la cuenta. Por ejemplo, la tabla Oportunidades representa el objeto Oportunidad, que forma parte de la aplicación Ventas.

Mesas¶

El conector modela los datos de Oracle Sales en una lista de tablas que se pueden consultar mediante instrucciones SQL estándar.

Generalmente, consultar las tablas de Oracle Sales es lo mismo que consultar una tabla en una base de datos relacional. A veces hay casos especiales, por ejemplo, incluir una determinada columna en la cláusula WHERE puede ser necesario para obtener datos para ciertas columnas de la tabla. Esto suele ser necesario para situaciones en las que se debe realizar una solicitud separada para cada fila para obtener ciertas columnas. Estos tipos de situaciones están claramente documentados en la parte superior de la página de la tabla vinculada a continuación.

Conector Jitterbit para Tablas de Ventas de Oracle¶

Direcciones de Cuenta¶

El recurso de dirección se utiliza para ver, crear y actualizar las direcciones de una cuenta. Una dirección representa la información de ubicación de una cuenta.

Columnas¶

CuentaDirecciónPropósitos¶

El recurso de propósito de la dirección se usa para ver, crear o modificar el propósito de la dirección. El propósito de la dirección describe el uso de una dirección, como la dirección de envío o la dirección de facturación.

Columnas¶

CuentaNotas¶

El recurso de nota se utiliza para capturar comentarios, información o instrucciones para una cuenta.

Columnas¶

AccountPrimaryAddresses¶

El recurso de dirección principal se utiliza para ver, crear y actualizar la dirección principal de una cuenta. Una dirección principal es la dirección de comunicación predeterminada de una cuenta.

Columnas¶

CuentaRelaciones¶

El recurso de relación se utiliza para ver, crear y actualizar relaciones de cuenta.

Columnas¶

CuentaRecursos¶

El recurso de miembro del equipo de ventas representa un grupo de recursos y está asignado a un equipo de cuentas de ventas. Un miembro del equipo de la cuenta de ventas tiene un rol de acceso definido para la cuenta de ventas.

Columnas¶

Cuentas¶

El recurso de miembro del equipo de ventas representa un grupo de recursos y está asignado a un equipo de cuentas de ventas. Un miembro del equipo de la cuenta de ventas tiene un rol de acceso definido para la cuenta de ventas.

Columnas¶

Actividades¶

Tabla para capturar información de tareas y citas.

Columnas¶

ActividadAsignados¶

Tabla utilizada para capturar los asignatarios/recursos asociados a la actividad.

Columnas¶

ActividadContactos¶

Tabla utilizada para capturar los contactos asociados a la actividad.

Columnas¶

ActividadNotas¶

Tenga en cuenta los objetos de datos que capturan comentarios, información o instrucciones para un objeto comercial de Oracle Fusion Applications.

Columnas¶

ActividadObjetivos¶

Tabla utilizada para plasmar los objetivos asociados a la actividad.

Columnas¶

Direcciones de Contacto¶

Tabla que incluye atributos utilizados para almacenar valores al crear o actualizar una dirección. Una dirección representa la información de ubicación de una cuenta, contacto u hogar.

Columnas¶

ContactoDirecciónPropósitos¶

El recurso de propósito de la dirección se usa para ver, crear o modificar el propósito de la dirección. El propósito de la dirección describe el uso de una dirección, como la dirección de envío o la dirección de facturación.

Columnas¶

ContactoNotas¶

El recurso de nota se utiliza para capturar comentarios, información o instrucciones para un contacto.

Columnas¶

Direcciones Principales de Contacto¶

El recurso de dirección principal se utiliza para ver, crear o modificar una dirección principal de un contacto. Una dirección principal es la dirección de comunicación predeterminada de una entidad.

Columnas¶

ContactoRelaciones¶

El recurso de relación incluye atributos que se utilizan para almacenar valores al visualizar, crear o actualizar una relación.

Columnas¶

Contactos¶

Los elementos de recursos de la tabla incluyen atributos utilizados para almacenar valores al crear o actualizar un contacto.

Columnas¶