Detalhes da Conexão do Oracle Sales Cloud¶

Introdução¶

Versão do conector

Esta documentação é baseada na versão 21.0.8257 do conector.

Começando¶

Suporte à Versão de Vendas Oracle

Estabelecendo uma Conexão¶

O Oracle Sales usa autenticação básica sobre SSL; depois de definir as seguintes propriedades de conexão, você está pronto para se conectar:

• Username: Defina como o nome de usuário que você usa para efetuar login em seu serviço Oracle Cloud.
• Password: Defina isso como sua senha.
• HostURL: Defina como o endereço da Web (URL) do seu serviço Oracle Cloud.

Campos e Objetos Personalizados¶

Esquemas para tabelas Oracle Sales padrão são armazenados internamente no Jitterbit Connector for Oracle Sales e usados para minimizar a quantidade de solicitações enviadas e a payload recebida. Por padrão, o Jitterbit Connector for Oracle Sales usará essas tabelas e não exporá nenhum dos objetos personalizados de sua instância. Embora os campos personalizados sejam expostos desde IncludeCustomFields o padrão é verdadeiro.

O Conector Jitterbit para Oracle Sales oferece suporte à recuperação dinâmica de esquemas para objetos e campos personalizados de dentro de sua instância específica do Oracle Sales seguindo as etapas descritas abaixo.

Incluindo Campos Personalizados¶

Caso seu esquema precise incluir campos personalizados (colunas) adicionados aos objetos padrão do Oracle Sales (tabelas), você pode usar o IncludeCustomFields propriedade de conexão. Definir essa propriedade como true resultará na emissão de uma ou mais chamadas extras e afetará o comportamento do Jitterbit Connector for Oracle Sales das seguintes maneiras:

• Os campos personalizados serão recuperados e listados junto com o restante das colunas em seu esquema.
• Todas as colunas armazenadas internamente serão substituídas por colunas geradas dinamicamente com base na versão mais recente da API.

Definir IncludeCustomFields para false para melhorar o desempenho.

Incluindo Objetos Personalizados¶

Caso precise acessar objetos customizados (tabelas), criados para sua instância do Oracle Sales, você pode utilizar o IncludeCustomObjects propriedade de conexão. Por padrão, essa propriedade é definida como false e, quando as consultas são tentadas em objetos personalizados, elas falham ao serem executadas devido ao esquema interno que está sendo usado. Similarmente a IncludeCustomFields, configurando esta propriedade como true, emitirá uma ou mais solicitações extras.

Gerando Arquivos de Esquema¶

Se você precisa trabalhar regularmente com campos personalizados e/ou objetos personalizados, pode usar o GenerateSchemaFiles propriedade de conexão para armazenar localmente um esquema gerado dinamicamente e evitar o uso constante IncludeCustomFields e IncludeCustomObjects, que em troca diminuirá o tempo de execução e a payload.

Note: Contexto GenerateSchemaFiles=Somente OnStart/OnUse gerará apenas um esquema contendo campos personalizados para todas as tabelas padrão, mas não para quaisquer tabelas personalizadas. Usando GenerateSchemaFiles combinado com IncludeCustomObjects permite gerar um esquema contendo campos e objetos personalizados.

Anotações Importantes¶

Procedimentos Armazenados¶

• Os recursos de procedimentos armazenados descritos nesta documentação não são suportados no momento.
• Como os procedimentos armazenados não são suportados atualmente, qualquer recurso dependente de procedimentos armazenados também não é suportado atualmente.

Arquivos de Configuração e Seus Caminhos¶

• Todas as referências para adicionar arquivos de configuração e seus caminhos referem-se a arquivos e locais no Harmony Agente onde o conector está instalado. Esses caminhos devem ser ajustados conforme apropriado, dependendo do agente e do sistema operacional. Se vários agentes forem usados em um grupo de agentes, arquivos idênticos serão necessários em cada agente.

Características Avançadas¶

Esta seção detalha uma seleção de recursos avançados do conector Oracle Sales.

Visualizações definidas pelo usuário

O conector permite definir tabelas virtuais, denominadas visões definidas pelo usuário, cujo conteúdo é decidido por uma consultar pré-configurada. Essas exibições são úteis quando você não pode controlar diretamente as consultas enviadas aos drivers. Consulte Visualizações definidas pelo usuário para obter uma visão geral da criação e configuração de exibições personalizadas.

Configuração SSL

Use Configuração SSL para ajustar como o conector lida com as negociações de certificado TLS/SSL. Você pode escolher entre vários formatos de certificado; Veja o SSLServerCert propriedade em "Opções de cadeia de conexão" para obter mais informações.

Procurador

Para configurar o conector usando configurações de proxy do Agente Privado, selecione os Use Proxy Settings caixa de seleção na tela de configuração da conexão.

Visualizações Definidas pelo Usuário¶

O Jitterbit Connector for Oracle Sales permite definir uma tabela virtual cujo conteúdo é decidido por uma consultar pré-configurada. Elas são chamadas de Visualizações Definidas pelo Usuário, que são úteis em situações onde você não pode controlar diretamente a consultar que está sendo emitida para o driver, por exemplo, ao usar o driver do Jitterbit. As Visualizações Definidas pelo Usuário podem ser usadas para definir predicados que são sempre aplicados. Se você especificar predicados adicionais na consultar para a visualização, eles serão combinados com a consultar já definida como parte da visualização.

Há duas maneiras de criar exibições definidas pelo usuário:

• Crie um arquivo de configuração em formato JSON definindo as visualizações desejadas.
• declarações DDL.

Definindo Visualizações Usando um Arquivo de Configuração¶

As visualizações definidas pelo usuário são definidas em um arquivo de configuração formatado em JSON chamado UserDefinedViews.json. O conector detecta automaticamente as visualizações especificadas neste arquivo.

Você também pode ter várias definições de exibição e controlá-las usando o UserDefinedViews propriedade de conexão. Quando você usa essa propriedade, apenas as exibições especificadas são vistas pelo conector.

Este arquivo de configuração de exibição definida pelo usuário é formatado da seguinte forma:

• Cada elemento raiz define o nome de uma visualização.
• Cada elemento raiz contém um elemento filho, chamado query, que contém a consultar SQL personalizada para a exibição.

Por exemplo:

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

Use o UserDefinedViews propriedade de conexão para especificar a localização do seu arquivo de configuração JSON. Por exemplo:

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

Esquema para Exibições Definidas pelo Usuário¶

As visualizações definidas pelo usuário são expostas no UserViews esquema por padrão. Isso é feito para evitar que o nome da exibição entre em conflito com uma entidade real no modelo de dados. Você pode alterar o nome do esquema usado para UserViews definindo o UserViewsSchemaName propriedade.

Trabalhando com Exibições Definidas pelo Usuário¶

Por exemplo, uma instrução SQL com uma Visualização Definida pelo Usuário chamada UserViews.RCustomers lista apenas clientes em Raleigh:

SELECT * FROM Customers WHERE City = 'Raleigh';

Exemplo de consultar ao driver:

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

Resultando na consultar efetiva à fonte:

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

Esse é um exemplo muito simples de uma consultar a uma exibição definida pelo usuário que é efetivamente uma combinação da consultar de exibição e da definição de exibição. É possível compor essas consultas em padrões muito mais complexos. Todas as operações SQL são permitidas em ambas as consultas e são combinadas quando apropriado.

Configuração SSL¶

Personalizando a Configuração SSL¶

Por padrão, o conector tenta negociar SSL/TLS verificando o certificado do servidor em relação ao armazenamento de certificados confiáveis do sistema.

Para especificar outro certificado, consulte o SSLServerCert propriedade para os formatos disponíveis para fazê-lo.

Modelo de Dados¶

O Jitterbit Connector for Oracle Sales modela os objetos Oracle Sales como tabelas relacionais. As tabelas suportam a recuperação e atualização de dados.

Você pode trabalhar com todas as tabelas da sua conta. O conector se conecta ao Oracle Sales e obtém a lista de tabelas e os metadados das tabelas chamando os serviços Web apropriados. Quaisquer alterações feitas em sua conta do Oracle Sales, como adicionar uma nova tabela, adicionar novas colunas ou alterar o tipo de dados de uma coluna, serão refletidas imediatamente quando você usar o conector para se conectar.

Mesas

Os objetos do Oracle Sales têm relacionamentos com outros objetos; nas tabelas, esses relacionamentos são expressos por meio de chaves estrangeiras. Os objetos Oracle Sales também fazem parte de um aplicativo que a conta contém. Por exemplo, a tabela Oportunidades representa o objeto Oportunidade, que faz parte do aplicativo Vendas.

Tabelas¶

O conector modela os dados no Oracle Sales em uma lista de tabelas que podem ser consultadas usando instruções SQL padrão.

Geralmente, consultar tabelas do Oracle Sales é o mesmo que consultar uma tabela em um banco de dados relacional. Às vezes, há casos especiais, por exemplo, incluir uma determinada coluna na cláusula WHERE pode ser necessário para obter dados para determinadas colunas na tabela. Isso geralmente é necessário para situações em que uma solicitação separada deve ser feita para cada linha para obter determinadas colunas. Esses tipos de situações estão claramente documentados na parte superior da página da tabela vinculada abaixo.

Conector Jitterbit para Oracle Sales Tables¶

Endereços da Conta¶

O recurso de endereço é usado para visualizar, criar e atualizar endereços de uma conta. Um endereço representa as informações de localização de uma conta.

Colunas¶

ContaEndereçoPropósitos¶

O recurso de finalidade do endereço é usado para exibir, criar ou modificar a finalidade do endereço. A finalidade do endereço descreve o uso de um endereço, como endereço de entrega ou endereço de cobrança.

Colunas¶

Notas de Conta¶

O recurso de nota é usado para capturar comentários, informações ou instruções para uma conta.

Colunas¶

Endereços Primários da Conta¶

O recurso de endereço principal é usado para exibir, criar e atualizar o endereço principal de uma conta. Um endereço primário é o endereço de comunicação padrão de uma conta.

Colunas¶

Relacionamentos de Conta¶

O recurso de relacionamento é usado para exibir, criar e atualizar relacionamentos de contas.

Colunas¶

Recursos da Conta¶

O recurso de membro da equipe de vendas representa uma parte do recurso e é atribuído a uma equipe de conta de vendas. Um membro da equipe da conta de vendas tem uma papel de acesso definida para a conta de vendas.

Colunas¶

Contas¶

O recurso de membro da equipe de vendas representa uma parte do recurso e é atribuído a uma equipe de conta de vendas. Um membro da equipe da conta de vendas tem uma papel de acesso definida para a conta de vendas.

Colunas¶

Atividades¶

Tabela para capturar informações de tarefas e compromissos.

Colunas¶

Responsáveis pela Atividade¶

Tabela utilizada para capturar os responsáveis/recursos associados à atividade.

Colunas¶

AtividadeContatos¶

Tabela utilizada para capturar os contatos associados à atividade.

Colunas¶

Notas de Atividade¶

Observe os objetos de dados que capturam comentários, informações ou instruções para um objeto de negócios Oracle Fusion Applications.

Colunas¶

Objetivos da Atividade¶

Tabela utilizada para capturar os objetivos associados à atividade.

Colunas¶

Endereços de Contato¶

Tabela que inclui atributos usados para armazenar valores durante a criação ou atualização de um endereço. Um endereço representa as informações de localização de uma conta, contato ou família.

Colunas¶

ContatoEndereçoPropósitos¶

O recurso de finalidade do endereço é usado para visualizar, criar ou modificar a finalidade do endereço. A finalidade do endereço descreve o uso de um endereço, como endereço de entrega ou endereço de cobrança.

Colunas¶

Notas de Contato¶

O recurso de nota é usado para capturar comentários, informações ou instruções para um contato.

Colunas¶

ContactPrimaryAddresss¶

O recurso de endereço principal é usado para exibir, criar ou modificar um endereço principal de um contato. Um endereço primário é o endereço de comunicação padrão de uma entidade.

Colunas¶

ContatoRelacionamentos¶

O recurso de relacionamento inclui atributos que são usados para armazenar valores durante a visualização, criação ou atualização de um relacionamento.

Colunas¶

Contatos¶

Os itens de recursos da tabela incluem atributos usados para armazenar valores durante a criação ou atualização de um contato.

Colunas¶