Detalhes da Conexão do Microsoft Exchange¶

Introdução¶

Versão do conector

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

Começando¶

Suporte à versão do Exchange

O Jitterbit Connector for Exchange se conecta com a API REST.

Estabelecendo uma Conexão¶

Esquemas Disponíveis¶

Existem dois serviços disponíveis para conexão com o Exchange. Estes são EWS (Exchange Web Services) e o Microsoft Graph. O Exchange Web Services está disponível para Exchange OnPremise e Online, mas não está mais recebendo atualizações. A Microsoft recomenda mudar para usar o Microsoft Graph para usuários do Exchange Online. Ambos estão disponíveis com nossa ferramenta.

Para alternar entre os dois, use o Schema propriedade de conexão para definir EWS ou MSGraph. Se você deseja usar o EWS com o Exchange Online, defina Schema para EWS e Platform para Exchange_Online.

Conectando-se ao Exchange Usando o Exchange OnPremise¶

Ao usar uma edição OnPremise do Exchange, OnPremise Set User, Password, e AuthScheme; por padrão, o conector executa a autenticação básica, mas Windows (NTLM), Kerberos e autenticação delegada também são compatíveis.

Autenticação com Kerberos¶

Consulte Usando Kerberos para obter detalhes sobre como autenticar com Kerberos

Além dos valores de autenticação, defina o Server propriedade para o endereço do servidor Exchange ao qual você está se conectando e definido Platform para a versão Exchange. Finalmente, defina Schema para EWS.

Conectando-se ao Exchange Usando o Exchange Online¶

Ao conectar-se ao Exchange Online, a autenticação será feita via OAuth. Se você estiver se conectando à plataforma Exchange Online por meio do EWS, defina o AuthScheme propriedade para AzureAD, AzureServicePrincipal ou AzureMSI. Caso contrário, se você estiver usando o Microsoft Graph para se conectar ao Exchange Online, os recursos serão extraídos de um serviço diferente para que o Schema deve ser definido como MSGraph. Quando Schema é definido como MSGraph, o Platform valor será ignorado.

Autenticando Usando o Azure AD¶

O Azure AD é um tipo de conexão que passa por OAuth. Defina seu AuthScheme para AzureAD e consulte Usando autenticação OAuth para obter um guia de autenticação.

Autenticação Usando a Entidade de Serviço do Azure¶

A Entidade de Serviço do Azure é um tipo de conexão que passa por OAuth. Defina seu AuthScheme para AzureServicePrincipal e consulte Usando a Autenticação Principal de Serviço do Azure para obter um guia de autenticação.

Autenticação Usando Autenticação MSI¶

Se você estiver executando o Exchange em uma VM do Azure, poderá aproveitar as credenciais do Managed Service Identity (MSI) para se conectar:

• AuthScheme: Defina para AzureMSI.

As credenciais MSI serão obtidas automaticamente para autenticação.

Usando Autenticação OAuth¶

OAuth requer que o usuário autenticado interaja com o Exchange usando o navegador. O conector facilita isso de várias maneiras, conforme descrito abaixo.

Credenciais Incorporadas¶

Consulte Credenciais incorporadas para se conectar com as credenciais incorporadas do conector e pule a criação de um aplicativo OAuth personalizado.

Credenciais Personalizadas¶

Em vez de se conectar com as credenciais incorporadas do conector, você pode registrar um aplicativo com Custom Credentials para obter o OAuthClientId e OAuthClientSecret.

Quando Criar um Aplicativo OAuth Personalizado¶

A criação de um aplicativo OAuth personalizado é opcional, pois o conector já está registrado no Exchange e você pode se conectar com suas credenciais incorporadas. Talvez você queira criar um aplicativo OAuth personalizado para alterar as informações exibidas quando os usuários fazem logon no endpoint OAuth do Exchange para conceder permissões ao conector.

Criando um Aplicativo OAuth Personalizado¶

Consulte Criando um aplicativo OAuth personalizado para um procedimento.

Credenciais Incorporadas¶

Autenticar Usando as Credenciais OAuth Incorporadas¶

Autenticação de Desktop com o Aplicativo OAuth Integrado¶

Você pode se conectar sem definir nenhuma propriedade de conexão para suas credenciais de usuário.

Quando você se conecta, o conector abre o endpoint OAuth em seu navegador padrão. Faça login e conceda permissões ao aplicativo. O conector então conclui o processo OAuth.

1. Extrai o token de acesso do URL de retorno de chamada e autentica as solicitações.
2. Obtém um novo token de acesso quando o antigo expira.
3. Salva valores OAuth em OAuthSettingsLocation para ser persistido nas conexões.

Credenciais Personalizadas¶

Existem dois tipos de autenticação de aplicativo disponíveis: usando um segredo do cliente e usando um certificado. Você pode usar qualquer um deles dependendo da autenticação de aplicativo configurada.

Autenticação de Área de Trabalho com Seu Aplicativo OAuth¶

Siga as etapas abaixo para autenticar com as credenciais de um aplicativo OAuth personalizado. Consulte Criando um aplicativo OAuth personalizado.

Obtenha um Token de Acesso OAuth¶

Você está pronto para se conectar após definir um dos grupos de propriedades de conexão abaixo, dependendo do tipo de autenticação.

1. Authenticating using a Client Secret
   • OAuthClientId: Defina isso como o ID do cliente nas configurações do aplicativo.
   • OAuthClientSecret: Defina isso como o segredo do cliente nas configurações do aplicativo.
   • CallbackURL: Defina isso para o URL de redirecionamento nas configurações do aplicativo.
   • AuthScheme: Defina isso como "AzureAD" nas configurações do aplicativo.
   • InitiateOAuth: Defina como GETANDREFRESH. Você pode usar InitiateOAuth para evitar repetir a troca de OAuth e configurar manualmente o OAuthAccessToken..
2. Authenticating using a Certificate
   • OAuthClientId: Defina isso como o ID do cliente nas configurações do aplicativo.
   • OAuthJWTCert: Defina isso para o armazenamento de certificados JWT.
   • OAuthJWTCertType: Defina isso para o tipo de armazenamento de certificado especificado por OAuthJWTCert.
   • CallbackURL: Defina isso para o URL de redirecionamento nas configurações do aplicativo.
   • AuthScheme: Defina isso como "AzureAD" nas configurações do aplicativo.
   • InitiateOAuth: Defina como GETANDREFRESH. Você pode usar InitiateOAuth para evitar repetir a troca de OAuth e configurar manualmente o OAuthAccessToken..

Quando você conecta, o conector abre o endpoint OAuth em seu navegador padrão. Faça login e conceda permissões ao aplicativo. O conector então conclui o processo OAuth:

1. Extrai o token de acesso da URL de retorno de chamada e autentica as solicitações.
2. Obtém um novo token de acesso quando o antigo expira.
3. Salva valores OAuth em OAuthSettingsLocation para ser persistido nas conexões.

Máquinas Sem Cabeça¶

Usando OAuth em uma Máquina Sem Cabeça¶

Para criar fontes de dados do Exchange em servidores headless ou outras máquinas nas quais o conector não pode abrir um navegador, você precisa autenticar de outra máquina. A autenticação é um processo de duas etapas.

1. Ao invés de instalar o conector em outra máquina, você pode seguir os passos abaixo para obter o OAuthVerifier valor. Ou você pode instalar o conector em outra máquina e transferir os valores de autenticação OAuth, depois de autenticar por meio do fluxo normal baseado em navegador.
2. Em seguida, você pode configurar o conector para atualizar automaticamente o token de acesso da máquina sem periféricos.

Você pode seguir o fluxo de autenticação OAuth headless usando as credenciais OAuth incorporadas do conector ou usando as credenciais OAuth para seu aplicativo OAuth personalizado.

Usando as Credenciais para um Aplicativo OAuth Personalizado¶

Crie um aplicativo OAuth personalizado

Consulte Criando um aplicativo OAuth personalizado para um procedimento. Você pode seguir os procedimentos abaixo para autenticar e conectar-se aos dados.

Obtenha um código verificador

Na máquina sem periféricos, defina um dos seguintes grupos de propriedades, dependendo do tipo de autenticação:

1. Authenticating using a Client Secret
   • InitiateOAuth: Defina como DESLIGADO.
   • OAuthClientId: Defina isso como o ID do aplicativo nas configurações do aplicativo.
   • OAuthClientSecret: Defina isso como o Segredo do aplicativo nas configurações do aplicativo.
2. Authenticating using a Certificate
   • InitiateOAuth: Defina como DESLIGADO.
   • OAuthClientId: Defina isso como o ID do aplicativo nas configurações do aplicativo.
   • OAuthJWTCert: Defina isso para o armazenamento de certificados JWT.
   • OAuthJWTCertType: Defina isso para o tipo de armazenamento de certificado especificado por OAuthJWTCert.

Você pode seguir as etapas abaixo para autenticar em outra máquina e obter o OAuthVerifier propriedade de conexão.

1. Chame o GetOAuthAuthorizationURL procedimento armazenado* com o parâmetro de entrada CallbackURL definido para o URI de redirecionamento exato que você especificou nas configurações do aplicativo.
2. Abra o URL retornado em um navegador. Faça login e conceda permissões ao conector. Você será redirecionado para a URL de retorno de chamada. A página da Web indicará que o site não pôde ser acessado.
3. Inspecione o URL da página deste site e encontre o code valor. Ele estará presente na URL no formato code=XXXXXX (terminado com &, que denota o próximo parâmetro da URL ) O valor após o "code=" é o código do verificador.
4. Salve o valor do código do verificador. Você definirá isso no OAuthVerifier propriedade de conexão.

Na máquina sem periféricos, defina um dos seguintes grupos de propriedades de conexão dependendo do tipo de autenticação para obter os valores de autenticação OAuth:

• OAuthClientId: Defina isso como a chave do consumidor nas configurações do aplicativo.
• OAuthClientSecret: Defina isso como o segredo do consumidor nas configurações do aplicativo.
• OAuthVerifier: Defina isso para o código do verificador.
• OAuthSettingsLocation: Defina para manter os valores de autenticação OAuth criptografados no arquivo especificado.
• InitiateOAuth: Configure para ATUALIZAR.

Conecte-se aos dados

Depois que o arquivo de configurações OAuth for gerado, defina as seguintes propriedades para se conectar aos dados:

• OAuthSettingsLocation: Defina isso para o arquivo que contém os valores de autenticação OAuth criptografados. Certifique-se de que este arquivo forneça permissões de leitura e gravação ao provedor para ativar a atualização automática do token de acesso.
• InitiateOAuth: Configure para ATUALIZAR.

Configurações de transferência OAuth

Siga as etapas abaixo para instalar o conector em outra máquina, autenticar e depois transferir os valores OAuth resultantes.

Em uma segunda máquina, instale o conector e conecte-se a um dos seguintes grupos de propriedades, dependendo do tipo de autenticação:

1. Authenticating using a Client Secret
   • OAuthSettingsLocation: Defina isso como um arquivo de texto gravável.
   • InitiateOAuth: Defina como GETANDREFRESH.
   • OAuthClientId: Defina isso como o ID do cliente nas configurações do aplicativo.
   • OAuthClientSecret: Defina isso como o segredo do cliente nas configurações do aplicativo.
   • CallbackURL: Defina isso para o URL de retorno de chamada nas configurações do aplicativo.
2. Authenticating using a Certificate
   • OAuthSettingsLocation: Defina isso como um arquivo de texto gravável.
   • InitiateOAuth: Defina como GETANDREFRESH.
   • OAuthClientId: Defina isso como o ID do cliente nas configurações do aplicativo.
   • OAuthJWTCert: Defina isso para o armazenamento de certificados JWT.
   • OAuthJWTCertType: Defina isso para o tipo de armazenamento de certificado especificado por OAuthJWTCert.
   • CallbackURL: Defina isso para o URL de retorno de chamada nas configurações do aplicativo.

Teste a conexão para autenticar. Os valores de autenticação resultantes são gravados, criptografados, no caminho especificado por OAuthSettingsLocation. Depois de testar a conexão com sucesso, copie o arquivo de configurações OAuth para sua máquina sem periféricos. Na máquina sem periféricos, defina as seguintes propriedades de conexão para se conectar aos dados:

• InitiateOAuth: Defina como REFRESH.
• OAuthSettingsLocation: Defina isso como o caminho para o arquivo de configurações OAuth. Certifique-se de que este arquivo forneça permissões de leitura e gravação ao conector para habilitar a atualização automática do token de acesso.

Criando um Aplicativo OAuth Personalizado¶

Quando Criar um Aplicativo OAuth Personalizado¶

A criação de um aplicativo OAuth personalizado é opcional, pois o conector já está registrado no Exchange e você pode se conectar com suas credenciais incorporadas.

Talvez você queira criar um aplicativo OAuth personalizado para alterar as informações exibidas quando os usuários fazem logon no endpoint OAuth do Exchange para conceder permissões ao conector.

Siga as etapas abaixo para criar um aplicativo OAuth personalizado e obter as propriedades de conexão em um fluxo de autenticação OAuth específico.

Etapas para Criar um Aplicativo OAuth Personalizado¶

Siga as etapas abaixo para obter os valores OAuth para seu aplicativo, o OAuthClientId e OAuthClientSecret.

1. Faça login em https://portal.azure.com.
2. No painel de navegação à esquerda, selecione Azure Active Directory, em seguida, Registros de aplicativos e clique no botão Novo registro.
3. Insira um nome de aplicativo e defina o botão de opção para a configuração de locatário desejada. Ao criar um aplicativo OAuth personalizado no Azure Active Directory, você pode definir se o aplicativo é único ou multilocatário. Se você selecionar a opção padrão "Somente contas neste diretório organizacional", precisará definir o AzureTenant propriedade de conexão para a ID do locatário do Azure AD ao estabelecer uma conexão com o Jitterbit Connector for Exchange. Caso contrário, a tentativa de autenticação falhará com um erro. Se seu aplicativo for apenas para uso privado, "Somente contas neste diretório da organização" deve ser suficiente. Caso contrário, se você quiser distribuir seu aplicativo, escolha uma das opções multilocatário.
4. Em seguida, defina o URL de redirecionamento para algo como http://localhost:33333, o padrão do conector. Ou defina uma porta diferente de sua escolha e defina CallbackURL para o URL de resposta exato que você definiu.
5. Defina o tipo de autenticação do aplicativo na seção Certificados e segredos. Existem dois tipos de autenticação disponíveis: usando um segredo do cliente e usando um certificado. O método de autenticação recomendado é por meio de um certificado, mas você também pode criar um segredo de aplicativo.
   • Option 1 - Upload a certificate: Na seção Certificados e Segredos, selecione Carregar certificado e selecione o certificado para carregar de sua máquina local.
   • Option 2 - Create a new application secret: Na seção Certificates & Secrets, selecione New Client Secret para o aplicativo e selecione sua duração. Depois de salvar o segredo do cliente, o valor da chave é exibido. Copie este valor, pois ele é exibido apenas uma vez e é usado como OAuthClientSecret.
6. Selecione Permissões de API e clique em Adicionar. Se você planeja que seu aplicativo se conecte sem um contexto de usuário, selecione as Permissões do aplicativo (OAuthGrantType = CLIENTE). Caso contrário, ao selecionar permissões, use as permissões delegadas.
7. Se você estiver se conectando ao Exchange por meio do esquema EWS, selecione Exchange API e adicione a permissão EWS.AccessAsUser.All. Se você estiver se conectando ao Exchange por meio do esquema MSGraph, selecione Microsoft Graph API e adicione as seguintes permissões: Calendars.ReadWrite.Shared, Contacts.ReadWrite, Group.Read.All, Group.ReadWrite.All, User.ReadWrite.All e Mail .ReadWrite.Shared.
8. Salve suas alterações.
9. Se você optou por usar permissões que exigem consentimento do administrador (como as Permissões do aplicativo), você pode concedê-las do locatário atual na página Permissões da API. Caso contrário, siga as etapas em Consentimento do administrador.

Consentimento do Administrador¶

O consentimento do administrador refere-se a quando o administrador de um locatário do Azure Active Directory concede permissões a um aplicativo que exige que um administrador consinta com o caso de uso. O aplicativo incorporado no Jitterbit Connector for Exchange não contém permissões que exijam o consentimento do administrador. Portanto, essas informações se aplicam apenas a aplicativos personalizados.

Permissões de Consentimento do Administrador¶

Ao criar um novo aplicativo OAuth no Portal do Azure, você deve especificar quais permissões o aplicativo exigirá. Algumas permissões podem ser marcadas informando "Consentimento do administrador necessário". Por exemplo, todas as permissões de grupos exigem consentimento do administrador. Se seu aplicativo exigir consentimento do administrador, há algumas maneiras de fazer isso.

A maneira mais fácil de conceder consentimento de administrador é apenas fazer com que um administrador faça logon em portal.azure.com e navegue até o aplicativo que você criou em Registros de aplicativos. Em Permissões da API, haverá um botão para Conceder consentimento. Você pode consentir aqui para que seu aplicativo tenha permissões no locatário sob o qual foi criado.

Se sua organização tiver vários locatários ou o aplicativo precisar receber permissões para outros locatários fora de sua organização, o GetAdminConsentURL pode ser usado para gerar o URL de autorização do administrador. Ao contrário do GetOAuthAuthorizationURL, não haverá nenhuma informação importante retornada desse endpoint. Se conceder acesso, ele simplesmente retornará um booleano indicando que as permissões foram concedidas.

Depois que um administrador concede o consentimento, a autenticação pode ser realizada normalmente.

Credenciais do Cliente¶

As credenciais do cliente referem-se a um fluxo no OAuth em que não ocorre nenhuma autenticação direta do usuário. Em vez disso, as credenciais são criadas apenas para o próprio aplicativo. Todas as tarefas executadas pelo aplicativo são realizadas sem um contexto de usuário padrão. Isso torna o fluxo de autenticação um pouco diferente do padrão.

Fluxo OAuth do Cliente¶

Todas as permissões relacionadas ao fluxo oauth do cliente exigem o consentimento do administrador. Isso significa que o aplicativo incorporado com o Jitterbit Connector for Exchange não pode ser usado no fluxo de oauth do cliente. Você deve criar seu próprio aplicativo OAuth para usar as credenciais do cliente. Consulte Criando um aplicativo OAuth personalizado para mais detalhes.

Em seu registro de aplicativo em portal.azure.com, navegue até API Permissions e selecione as permissões do Microsoft Graph. Existem dois conjuntos distintos de permissões - Permissões delegadas e de aplicativos. As permissões usadas durante a autenticação da credencial do cliente estão em Permissões do aplicativo. Selecione as permissões aplicáveis necessárias para sua integração.

Você está pronto para se conectar após definir um dos grupos de propriedades de conexão abaixo, dependendo do tipo de autenticação.

1. Authenticating using a Client Secret
   • InitiateOAuth: Defina como GETANDREFRESH. Você pode usar InitiateOAuth para evitar repetir a troca de OAuth e configurar manualmente o OAuthAccessToken.
   • AzureTenant: Defina isso para o inquilino ao qual você deseja se conectar.
   • OAuthGrantType: Defina como CLIENTE.
   • OAuthClientId: Defina isso como o ID do cliente nas configurações do aplicativo.
   • OAuthClientSecret: Defina isso como o segredo do cliente nas configurações do aplicativo.
2. Authenticating using a Certificate
   • InitiateOAuth: Defina como GETANDREFRESH. Você pode usar InitiateOAuth para evitar repetir a troca de OAuth e configurar manualmente o OAuthAccessToken.
   • AzureTenant: Defina isso para o inquilino ao qual você deseja se conectar.
   • OAuthGrantType: Defina como CLIENTE.
   • OAuthClientId: Defina isso como o ID do cliente nas configurações do aplicativo.
   • OAuthJWTCert: Defina isso para o armazenamento de certificados JWT.
   • OAuthJWTCertType: Defina isso para o tipo de armazenamento de certificado especificado por OAuthJWTCert.

A autenticação com as credenciais do cliente ocorrerá automaticamente como qualquer outra conexão, exceto que não haverá nenhuma janela aberta solicitando ao usuário. Como não há contexto do usuário, não há necessidade de um pop-up do navegador. As conexões ocorrerão e serão tratadas internamente.

Usando a Autenticação Principal de Serviço do Azure¶

A autenticação como Entidade de Serviço do Azure é tratada por meio do fluxo de Credenciais do Cliente OAuth e não envolve autenticação direta do usuário. Em vez disso, as credenciais são criadas apenas para o próprio aplicativo. Todas as tarefas executadas pelo aplicativo são feitas sem um contexto de usuário padrão, mas com base nas funções atribuídas. O acesso do aplicativo aos recursos é controlado por meio das permissões das funções atribuídas.

Credenciais Personalizadas¶

Você precisará registrar um aplicativo OAuth para obter os valores da propriedade OAuth antes da conexão com a fonte de dados do Exchange. Você pode verificar as Credenciais personalizadas guia sobre como definir as propriedades OAuth.

Criando um Aplicativo OAuth Personalizado¶

Consulte Criando um aplicativo OAuth personalizado para um procedimento.

Criando um Aplicativo OAuth Personalizado¶

A criação de um aplicativo OAuth personalizado e uma entidade de serviço que pode acessar os recursos necessários é necessária ao autenticar usando uma entidade de serviço do Azure.

Siga as etapas abaixo para criar um aplicativo OAuth personalizado e obter as propriedades de conexão para a autenticação da Entidade de Serviço do Azure.

Etapas para Criar um Aplicativo OAuth Personalizado¶

Siga as etapas abaixo para obter os valores OAuth para seu aplicativo.

1. Faça login em <https://portal.azure.com>.
2. No painel de navegação à esquerda, selecione Azure Active Directory, em seguida, Registros de aplicativos e clique no botão Novo registro.
3. Insira um nome de aplicativo e defina o botão de opção para "Qualquer diretório do Azure AD - multilocatário". Em seguida, defina o URL de redirecionamento para algo como http://localhost:33333, o padrão do conector.
4. Copie o valor do ID do aplicativo (cliente) exibido na seção Visão geral após criar o aplicativo, pois esse valor é usado como OAuthClientId
5. Defina o tipo de autenticação do aplicativo na seção Certificados e segredos. Existem dois tipos de autenticação disponíveis: usando um segredo do cliente e usando um certificado. O método de autenticação recomendado é por meio de um certificado, mas você também pode criar um segredo de aplicativo.
   • Option 1 - Upload a certificate: Na seção Certificados e Segredos, selecione Carregar certificado e selecione o certificado para carregar de sua máquina local.
   • Option 2 - Create a new application secret: Na seção Certificates & Secrets, selecione New Client Secret para o aplicativo e selecione sua duração. Depois de salvar o segredo do cliente, o valor da chave é exibido. Copie este valor, pois ele é exibido apenas uma vez e é usado como OAuthClientSecret.
6. Na aba Autenticação, certifique-se de marcar a opção: Tokens de acesso (usados para fluxos implícitos).
7. Abra a página Assinaturas pesquisando e selecionando o serviço Assinaturas na barra de pesquisa.
8. Selecione a assinatura específica à qual atribuir o aplicativo, abra a seção Controle de acesso (IAM) e clique no botão Adicionar atribuição de papel.
9. Selecione Proprietário como a papel a ser atribuída ao aplicativo OAuth criado.

Credenciais Personalizadas¶

Siga as etapas abaixo para autenticar com as credenciais de um aplicativo OAuth personalizado. Consulte Criando um aplicativo OAuth personalizado.

Autenticação com Seu Aplicativo OAuth¶

Existem dois tipos de autenticação de aplicativo disponíveis: usando um segredo do cliente e usando um certificado. Você pode usar qualquer um deles dependendo da autenticação de aplicativo configurada.

Obtenha um Token de Acesso OAuth¶

Você está pronto para se conectar após definir um dos grupos de propriedades de conexão abaixo, dependendo do tipo de autenticação.

1. Authenticating using a Client Secret
   • AuthScheme: Defina isso como "AzureServicePrincipal" nas configurações do aplicativo.
   • InitiateOAuth: Defina como GETANDREFRESH. Você pode usar InitiateOAuth para evitar repetir a troca de OAuth e configurar manualmente o OAuthAccessToken.
   • AzureTenant: Defina isso para o inquilino ao qual você deseja se conectar.
   • OAuthClientId: Defina isso como o ID do cliente nas configurações do aplicativo.
   • OAuthClientSecret: Defina isso como o segredo do cliente nas configurações do aplicativo.
2. Authenticating using a Certificate
   • AuthScheme: Defina isso como "AzureServicePrincipal" nas configurações do aplicativo.
   • InitiateOAuth: Defina como GETANDREFRESH. Você pode usar InitiateOAuth para evitar repetir a troca de OAuth e configurar manualmente o OAuthAccessToken.
   • AzureTenant: Defina isso para o inquilino ao qual você deseja se conectar.
   • OAuthClientId: Defina isso como o ID do cliente nas configurações do aplicativo.
   • OAuthJWTCert: Defina isso para o armazenamento de certificados JWT.
   • OAuthJWTCertType: Defina isso para o tipo de armazenamento de certificado especificado por OAuthJWTCert.

Usando Kerberos¶

Esta seção mostra como usar o conector para autenticar no Exchange usando Kerberos.

Autenticação com Kerberos¶

Para autenticar no Exchange usando Kerberos, defina as seguintes propriedades:

• AuthScheme: Defina para NEGOTIATE.
• KerberosKDC: Defina isso como host name or IP Address de sua máquina Kerberos KDC.
• KerberosRealm: Defina para the realm of the Exchange Kerberos principal. Este será o valor após o símbolo '@' (por exemplo, EXAMPLE.COM) do principal value (por exemplo, ServiceName/MyHost@EXAMPLE.COM).
• KerberosSPN: Defina isso como service and host of the Exchange Kerberos Principal. Este será o valor antes do símbolo '@' (por exemplo, ServiceName/MyHost) do principal value (por exemplo, ServiceName/MyHost@EXAMPLE.COM).

Recupere o Tíquete Kerberos¶

Você pode usar uma das opções a seguir para recuperar o tíquete Kerberos necessário.

Arquivo de Cache de Credenciais do MIT Kerberos¶

Esta opção permite que você use o MIT Kerberos Ticket Manager ou o comando kinit para obter tickets. Observe que você não precisa definir o User ou Password propriedades de conexão com esta opção.

1. Certifique-se de ter criado uma variável de ambiente chamada KRB5CCNAME.
2. Defina o KRB5CCNAME variável de ambiente para um caminho apontando para o seu credential cache file (por exemplo, C:\krb_cache\krb5cc_0 ou /tmp/krb5cc_0). Este arquivo será criado ao gerar seu ticket com o MIT Kerberos Ticket Manager.
3. Para obter um ticket, abra o aplicativo MIT Kerberos Ticket Manager, clique em Get Ticket, enter your principal name and password, then click OK. Se for bem-sucedido, as informações do tíquete aparecerão no Kerberos Ticket Manager e agora serão armazenadas no arquivo de cache de credenciais.
4. Agora que o arquivo de cache de credencial foi criado, o conector usará o arquivo de cache para obter o tíquete Kerberos para se conectar ao Exchange.

Como alternativa para definir o KRB5CCNAME variável de ambiente, você pode definir diretamente o caminho do arquivo usando KerberosTicketCache propriedade. Quando definido, o conector usará o arquivo de cache especificado para obter o tíquete Kerberos para se conectar ao Exchange.

Arquivo Keytab¶

Se a variável de ambiente KRB5CCNAME não foi definida, você pode recuperar um tíquete Kerberos usando um Keytab File. Para fazer isso, defina o User propriedade para o nome de usuário desejado e defina o KerberosKeytabFile para um caminho de arquivo apontando para o arquivo keytab associado ao usuário.

Usuário e Senha¶

Se a variável de ambiente KRB5CCNAME e a propriedade KerberosKeytabFile não tiverem sido definidas, você pode recuperar um ticket usando um User and Password combination. Para fazer isso, defina o User e Password propriedades para a combinação de usuário/senha que você usa para autenticar com o Exchange.

Autenticação Cross-Realm¶

Ambientes Kerberos mais complexos podem exigir autenticação cross-realm em que vários realms e servidores KDC são usados (por exemplo, onde um realm/KDC é usado para autenticação do usuário e outro realm/KDC usado para obter o tíquete de serviço).

Em tal ambiente, o KerberosRealm e KerberosKDC as propriedades podem ser definidas com os valores necessários para autenticação do usuário. O KerberosServiceRealm e KerberosServiceKDC as propriedades podem ser definidas com os valores necessários para obter o ticket de serviço.

Tarefas Administrativas do Exchange Online¶

O Jitterbit Connector for Exchange pode ser usado para executar tarefas administrativas com MSGraph Schema. Isso pode ser feito especificando a coluna UserId para executar operações CUD.

A Coluna UserId¶

Muitas tabelas expõem uma coluna UserId especial. Isso é projetado para ser usado por um administrador para modificar registros na conta de outro usuário. Se você não for um administrador ou não desejar esse comportamento, não especifique o UserId ao executar uma operação INSERT/UPDATE/DELETE. Por exemplo, executar o seguinte irá inserir um contato para outro usuário:

INSERT INTO Contacts (displayName, CompanyName, UserId) VALUES ('Bill', 'Bob Co', '12345')

A solicitação acima terá o efeito geral de tentar adicionar um contato no recurso em /users/12345/contacts. Quando UserId não for especificado, os recursos afetados serão modificados em /users/me/contacts. Em geral, se você não for um administrador, poderá apenas afetar ou visualizar registros em /users/me, portanto, não é recomendável definir UserId quando você não for um administrador.

Note: Especificar UserId em conjunto com um operador 'OR' de qualquer consultar não é suportado. Como alternativa, você pode usar 'UNION' para recuperar o mesmo conjunto de resultados.

Selecionando Dados de Troca¶

Nota: O seguinte descreve o comportamento quando Schema é definido como EWS. Não tem impacto no MSGraph.

FindItem Vs. GetItem¶

Por padrão, o conector executará a chamada API FindItem dos Serviços Web do Exchange e solicitará apenas informações resumidas sobre os itens quando uma operação SELECT for executada. Qualquer solicitação que possa retornar mais de um item retornará apenas informações resumidas. Por exemplo:

SELECT ItemId, Surname, EmailAddress1 FROM Contacts WHERE Surname='Smith'

Se desejar solicitar o conteúdo de uma mensagem ou mais informações sobre um contato ou evento de calendário, você precisará definir IncludeContent como TRUE, especifique os ItemIds dos itens ou limite seus resultados a um único item. Por exemplo:

SELECT ItemId, Surname, EmailAddress1 FROM Contacts WHERE ItemId='AZQ111222...'

OU

SELECT ItemId, Surname, EmailAddress1 FROM Contacts WHERE ItemdId IN ('AZQ111222...', 'AZQ111223...', 'AZQ111224...', 'AZQ111225...')

OU

SELECT ItemId, Surname, EmailAddress1 FROM Contacts WHERE Surname='Smith' LIMIT 1

Pastas Públicas e Personalizadas¶

Se desejar ler de uma pasta pública ou personalizada, você precisará primeiro identificar o FolderId da pasta da qual deseja ler. Isso pode ser feito enviando uma consultar de leitura do ParentFolder (para uma pasta personalizada) ou da tabela relevante para o tipo de objeto armazenado em uma pasta pública, usando a caixa de entrada se a pasta pública

contém mensagens. Por exemplo:

Encontrando o FolderId de uma subpasta da caixa de entrada:

SELECT DisplayName, FolderId FROM Inbox

Encontrar o FolderId de uma pasta personalizada que contém contatos:

SELECT DisplayName, FolderId FROM Contacts WHERE ParentFolderName='publicfoldersroot'

Se sua pasta pública estiver aninhada, talvez seja necessário fazer uma consultar SELECT separada na pasta personalizada pai:

SELECT DisplayName, FolderId FROM Contacts WHERE ParentFolderId='AAEuAAAAAAAa...'

Criando Itens em Pastas Públicas e Personalizadas¶

Inserção em Pastas Públicas e Personalizadas¶

Se você deseja criar um item em uma pasta pública ou personalizada, você precisará primeiro identificar o FolderID da pasta que deseja ler (consulte Selecionando dados do Exchange). Depois de saber o FolderID, você pode usar esse valor como ParentFolderId ao criar um novo objeto. Para criar um objeto em uma pasta personalizada ou pública, use o

tipo de objeto como a tabela (ou Caixa de entrada se a pasta contiver Mensagens). Por exemplo:

Inserindo em uma subpasta da caixa de entrada:

INSERT INTO Inbox (Subject, FromEmailAddress, ToRecipients_EmailAddress, ParentFolderId) VALUES ('New email message', 'user1@email.com', 'user2@email.com', 'AAEuAAAAAAAa...')

Inserindo em uma pasta pública que contém contatos:

INSERT INTO Contacts (GivenName, Surname, EmailAddress1, ParentFolderId) VALUES ('Jill', 'Smith', 'user3@email.com', 'AAEuAAAAAAAa...')

Atualizando Ou Excluindo Itens em Pastas Públicas e Personalizadas¶

Atualizando Ou Excluindo um Item em Pastas Públicas e Personalizadas¶

Ao contrário de ler ou inserir em uma pasta pública ou personalizada, você não precisa do FolderId para atualizar ou excluir um item. Você simplesmente precisa saber que tipo

do objeto que a pasta contém e use esse tipo como Tabela (ou use Caixa de entrada para uma pasta que contenha Mensagens). Por exemplo:

Atualizando um item de mensagem em uma pasta personalizada:

UPDATE Inbox SET Subject = 'Updated email message' WHERE ItemID = 'AZQ111222...')

Excluindo um item de contato de uma pasta pública:

DELETE FROM Contacts WHERE ItemID = 'AZQ111222...')

Acesso a Dados de Ajuste Fino¶

Personificação de Usuários¶

Esse método de autenticação normalmente é usado por administradores para configurar o acesso por uma conta de serviço.
Para representar todas as solicitações, defina as seguintes propriedades de conexão no momento da conexão.
Para representar um usuário para uma consultar individual, use as pseudocolunas do mesmo nome.

• ImpersonationUser: Defina isso para o usuário a representar.
• ImpersonationType: Defina isso para o formato que você está usando para especificar o usuário. Por exemplo, UPN ou SID.

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 do Exchange.

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 Exchange 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 Contacts 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 Exchange modela o Exchange 2 e as APIs do Exchange como tabelas relacionais, exibições e procedimentos armazenados. Eles são definidos em arquivos de esquema, que são arquivos de configuração simples baseados em texto.

As entidades disponíveis, bem como quaisquer limitações e requisitos de API para consultar essas entidades, estão documentadas em Modelo de dados EWS e Modelo de dados do MSGraph. Você pode usar o SupportEnhancedSQL recurso, definido por padrão, para contornar a maioria dessas limitações.

Visão geral

Os Modelos de Dados ilustram um exemplo de como seu ambiente do Exchange pode parecer. O modelo de dados real será obtido dinamicamente com base em sua conta do Exchange.

Características principais

• Tabelas e exibições são definidas dinamicamente para modelar calendários, documentos e projetos no Exchange.
• Procedimentos armazenados* permitem que você execute operações no Exchange, incluindo download e upload de objetos.
• A conectividade ao vivo com esses objetos significa que quaisquer alterações em sua conta do Exchange são refletidas imediatamente ao usar o conector.

Modelo de Dados EWS

Modelo de Dados EWS descreve os esquemas disponíveis para se conectar ao Exchange OnPremise e Exchange Online usando EWS. Você pode usar tabelas para trabalhar com dados dinâmicos do Exchange. Você pode usar procedimentos armazenados* fornecido pelo Jitterbit Connector for Exchange para automatizar o trabalho com dados do Exchange.

Modelo de Dados MSGraph

Modelo de dados MSGraph descreve os esquemas disponíveis para se conectar a contas do Exchange Online por meio do Microsoft Graph. Você pode usar tabelas para trabalhar com dados dinâmicos do Exchange. Você pode usar procedimentos armazenados* fornecido pelo Jitterbit Connector for Exchange para automatizar o trabalho com dados do Exchange.

Modelo de Dados EWS¶

O Jitterbit Connector for Exchange modela entidades do Exchange como relacionais Tabelas e Procedimentos Armazenados. Eles são definidos em arquivos de esquema, que são arquivos de configuração simples baseados em texto.

As limitações e requisitos da API estão documentados nesta seção; você pode usar o SupportEnhancedSQL recurso, definido por padrão, para contornar a maioria dessas limitações.

Procedimentos armazenados* são interfaces semelhantes a funções para o Exchange. Eles podem ser usados para pesquisar, atualizar e modificar informações no Exchange.

Tabelas¶

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

Geralmente, consultar tabelas do Exchange é 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 Tabelas do Exchange¶

Calendário¶

Crie, atualize, exclua e consultar itens do Calendário.

Informações Específicas da Tabela¶

Atualizar e Excluir

O conector precisará da ItemChangeKey para atualizar ou excluir um item. No entanto, se você não tiver certeza da ItemChangeKey, o conector poderá recuperá-la do servidor Exchange automaticamente. Observe que isso pode aumentar o tempo necessário para realizar uma consultar.

Selecione eventos recorrentes

Ao executar uma operação SELECT na tabela Calendário, o conector não incluirá eventos recorrentes individuais por padrão (somente o item principal será incluído). Se desejar visualizar as recorrências individuais de um evento recorrente, você precisará especificar o ItemId. Sua consultar precisará incluir uma cláusula WHERE semelhante à seguinte:

SELECT Subject,IsRecurring,Recurrence_StartDate,Recurrence_EndDate,Recurrence_Interval,Recurrence_Type,Recurrence_NumberOfOccurrences,FirstOccurrence_Start  FROM Calendar WHERE ItemId='myid'

Colunas¶

Pseudo-colunas¶

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Calendar_OptionalAttendees¶

Os participantes opcionais para um determinado evento. Um ItemId deve ser especificado ao consultar esta visualização.

Informações Específicas da Tabela¶

Atualizar e Excluir

O conector precisará da ItemChangeKey para atualizar ou excluir um item. No entanto, se você não tiver certeza da ItemChangeKey, o conector poderá recuperá-la do servidor Exchange automaticamente. Observe que isso pode aumentar o tempo necessário para realizar uma consultar.

Inserindo

Ao executar uma operação SELECT na tabela Calendário, o conector não incluirá eventos recorrentes individuais por padrão (somente o item principal será incluído). Se desejar visualizar as recorrências individuais de um evento recorrente, você precisará filtrar a pesquisa pela coluna IsRecurring e usar Start e End para especificar um período de tempo. Sua consultar precisará incluir uma cláusula WHERE semelhante à seguinte:

INSERT INTO Calendar_OptionalAttendees (EmailAddress, ItemId, SendMeetingInvitations) VALUES ('johndoe@example.com', 'itemid', 'SendOnlyToChanged')

Colunas¶

Pseudo-colunas¶

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Calendar_RequiredAttendees¶

Os participantes necessários para um determinado evento. Um ItemId deve ser especificado ao consultar esta visualização.

Informações Específicas da Tabela¶

Inserir declarações

Ao executar uma operação INSERT, você precisará especificar EmailAddress e ItemId. Além disso, há uma propriedade chamada SendMeetingInvitations que você pode definir para decidir quem é notificado quando você insere os participantes necessários.

INSERT INTO Calendar_RequiredAttendees (EmailAddress, ItemId, SendMeetingInvitations) VALUES ('johndoe@example.com', 'itemid', 'SendOnlyToChanged')

Colunas¶

Pseudo-colunas¶

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Contatos¶

Crie, atualize, exclua e consultar itens de Contatos.

Informações Específicas da Tabela¶

Atualizar e Excluir

O conector precisará da ItemChangeKey para atualizar ou excluir um item. No entanto, se você não tiver certeza da ItemChangeKey, o conector poderá recuperá-la do servidor Exchange automaticamente. Observe que isso pode aumentar o tempo necessário para realizar uma consultar.

Colunas¶

Pseudo-colunas¶

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Itens Deletados¶

Crie, atualize, exclua e consultar itens excluídos.

Informações Específicas da Tabela¶

Selecionar E-mails das subpastas DeletedItems

Ao executar uma operação SELECT na tabela DeletedItems, o conector não incluirá os itens nas subpastas em DeletedItems, mas apenas os itens contidos na pasta DeletedItems. Se você deseja recuperar os itens nas subpastas DeletedItems, precisará especificar ParentFolderId-s na cláusula WHERE. Você pode obter cada ID de subpasta DeletedItems executando uma consultar filtrada por ParentFolderName para a tabela Pastas. Você pode usar a consultar de exemplo abaixo para recuperar os itens nas subpastas DeletedItems:

SELECT * FROM DeletedItems where ParentFolderId in (Select FolderId from Folders where ParentFolderName='DeletedItems' and TotalCount>0)

Atualizar e Excluir

O conector precisará da ItemChangeKey para atualizar ou excluir um item. No entanto, se você não tiver certeza da ItemChangeKey, o conector poderá recuperá-la do servidor Exchange automaticamente. Observe que isso pode aumentar o tempo necessário para realizar uma consultar.

Colunas¶

Pseudo-colunas¶

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Rascunhos¶

Crie, atualize, exclua e consultar itens de Rascunhos.

Informações Específicas da Tabela¶

Selecionar E-mails nas subpastas de rascunhos

Ao executar uma operação SELECT na tabela Rascunhos, o conector não incluirá os itens nas subpastas em Rascunhos, mas apenas os itens contidos na pasta Rascunhos. Se você deseja recuperar os itens nas subpastas Rascunhos, precisará especificar ParentFolderId-s na cláusula WHERE. Você pode obter cada ID da subpasta Rascunhos executando uma consultar filtrada por ParentFolderName para a tabela Pastas. Você pode usar a consultar de exemplo abaixo para recuperar os itens nas subpastas Rascunhos:

SELECT * FROM Drafts where ParentFolderId in (Select FolderId from Folders where ParentFolderName='Drafts' and TotalCount>0)

Atualizar e Excluir

O conector precisará da ItemChangeKey para atualizar ou excluir um item. No entanto, se você não tiver certeza da ItemChangeKey, o conector poderá recuperá-la do servidor Exchange automaticamente. Observe que isso pode aumentar o tempo necessário para realizar uma consultar.

Colunas¶

Pseudo-colunas¶

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Pastas¶

Crie, atualize, exclua e consultar subpastas para uma determinada pasta.

Informações Específicas da Tabela¶

Atualizar e Excluir

O conector precisará da FolderChangeKey para atualizar ou excluir um item. No entanto, se você não tiver certeza da FolderChangeKey, o conector poderá recuperá-la do servidor Exchange automaticamente. Observe que isso pode aumentar o tempo necessário para realizar uma consultar.

Colunas¶

Pseudo-colunas¶

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Caixa de Entrada¶

Crie, atualize, exclua e consultar itens da caixa de entrada.

Informações Específicas da Tabela¶

Selecionar E-mails nas subpastas da caixa de entrada

Ao executar uma operação SELECT na tabela Caixa de entrada, o conector não incluirá os itens nas subpastas da Caixa de entrada, mas apenas os itens contidos na pasta Caixa de entrada. Se desejar recuperar os itens nas subpastas Caixa de entrada, você precisará especificar ParentFolderId-s na cláusula WHERE. Você pode obter cada ID de subpasta da caixa de entrada executando uma consultar filtrada por ParentFolderName para a tabela de pastas. Você pode usar a consultar de exemplo abaixo para recuperar os itens nas subpastas Caixa de entrada:

SELECT * FROM Inbox where ParentFolderId in (Select FolderId from Folders where ParentFolderName='Inbox' and TotalCount>0)

Atualizar e Excluir

O conector precisará da ItemChangeKey para atualizar ou excluir um item. No entanto, se você não tiver certeza da ItemChangeKey, o conector poderá recuperá-la do servidor Exchange automaticamente. Observe que isso pode aumentar o tempo necessário para realizar uma consultar.

Colunas¶

Pseudo-colunas¶

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Spam¶

Crie, atualize, exclua e consultar itens de E-mail.

Colunas¶

Pseudo-colunas¶

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Caixa de Fora¶

Crie, atualize, exclua e consultar itens da caixa de saída.

Informações Específicas da Tabela¶

Selecione E-mails nas subpastas da caixa de saída

Ao executar uma operação SELECT na tabela Caixa de saída, o conector não incluirá os itens nas subpastas da Caixa de saída, mas apenas os itens contidos na pasta Caixa de saída. Se desejar recuperar os itens nas subpastas Caixa de saída, você precisará especificar ParentFolderId-s na cláusula WHERE. Você pode obter cada ID de subpasta de caixa de saída executando uma consultar filtrada por ParentFolderName para a tabela de pastas. Você pode usar o exemplo de consultar abaixo para recuperar os itens nas subpastas Caixa de saída:

SELECT * FROM Outbox where ParentFolderId in (Select FolderId from Folders where ParentFolderName='Outbox' and TotalCount>0)

Atualizar e Excluir

O conector precisará da ItemChangeKey para atualizar ou excluir um item. No entanto, se você não tiver certeza da ItemChangeKey, o conector poderá recuperá-la do servidor Exchange automaticamente. Observe que isso pode aumentar o tempo necessário para realizar uma consultar.

Colunas¶

Pseudo-colunas¶

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Itens Enviados¶

Crie, atualize, exclua e consultar itens enviados.

Informações Específicas da Tabela¶

Selecionar E-mails das subpastas SentItems

Ao executar uma operação SELECT na tabela SentItems, o conector não incluirá os itens nas subpastas em SentItems, mas apenas os itens contidos na pasta SentItems. Se você deseja recuperar os itens nas subpastas SentItems, precisará especificar ParentFolderId-s na cláusula WHERE. Você pode obter cada ID de subpasta SentItems executando uma consultar filtrada por ParentFolderName para a tabela Pastas. Você pode usar a consultar de exemplo abaixo para recuperar os itens nas subpastas SentItems:

SELECT * FROM SentItems where ParentFolderId in (Select FolderId from Folders where ParentFolderName='SentItems' and TotalCount>0)

Atualizar e Excluir

O conector precisará da ItemChangeKey para atualizar ou excluir um item. No entanto, se você não tiver certeza da ItemChangeKey, o conector poderá recuperá-la do servidor Exchange automaticamente. Observe que isso pode aumentar o tempo necessário para realizar uma consultar.

Colunas¶

Pseudo-colunas¶

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Tarefas¶

Crie, atualize, exclua e consultar itens de Tarefas.

Informações Específicas da Tabela¶

Atualizar e Excluir

O conector precisará da ItemChangeKey para atualizar ou excluir um item. No entanto, se você não tiver certeza da ItemChangeKey, o conector poderá recuperá-la do servidor Exchange automaticamente. Observe que isso pode aumentar o tempo necessário para realizar uma consultar.

Campos de recorrência

Para INSERIR, SELECIONAR ou ATUALIZAR os campos Recorrência em uma Tarefa, você precisará certificar-se de definir apenas os campos associados aos campos Recurrence_Type e Recurrence_Duration. Veja as tabelas abaixo:

Valores Recurrence_Type e campos associados

Recurrence_Duration e campos associados

Colunas¶

Pseudo-colunas¶

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Procedimentos Armazenados¶

Procedimentos armazenados* estão disponíveis para complementar os dados disponíveis no Modelo de Dados. Pode ser necessário atualizar os dados disponíveis em uma exibição usando um procedimento armazenado* porque os dados não fornecem atualizações bidirecionais diretas, semelhantes a tabelas. Nessas situações, a recuperação dos dados é feita usando a visualização ou tabela apropriada, enquanto a atualização é feita chamando um procedimento armazenado. Procedimentos armazenados* pega uma lista de parâmetros e retorna um conjunto de dados que contém a coleção de tuplas que constituem a resposta.

Conector Jitterbit para Procedimentos Armazenados do Exchange¶

CriarAnexos¶

Crie e adicione um anexo a um e-mail existente.

Procedimento Armazenado* Informações Específicas¶

Use o procedimento CreateAttachments para adicionar um anexo a um e-mail existente. Para especificar os caminhos de arquivo dos anexos, use a entrada Attachments, enquanto para o conteúdo codificado na base 64, especifique AttachmentContent e AttachmentName.

EXECUTE CreateAttachments ItemId = 'AQMkAGRlMWQ5MDg0LWI5ZTQtNDk2Yi1hOTQ1LTU4YzFmMzEwZjlhMgBGAAAD/FjxR3cIwE6TEGSCVtIHcwcAQyR2Iw3coEOaUD1BLt0tnAAAAxEAAABDJHYjDdygQ5pQPUEu3S2cAAVZoayvAAAA', Attachments = 'C:\Users\User\Desktop\logfile.txt,C:\Users\User\Desktop\TestConnectionLog.txt'

Entrada

Colunas do conjunto de resultados

GetAttachment¶

Recupera os anexos indicados.

Entrada¶

Colunas do conjunto de resultados¶

GetOAuthAccessToken¶

Obtém um token de autenticação do Outlook.

Entrada¶

Colunas do conjunto de resultados¶

GetOAuthAuthorizationURL¶

Obtém a URL de autorização que deve ser aberta separadamente pelo usuário para conceder acesso ao seu aplicativo. Necessário apenas ao desenvolver aplicativos da Web. Você solicitará o OAuthAccessToken deste URL.

Entrada¶

Colunas do conjunto de resultados¶

GetUserOofSettings¶

Fornece acesso às configurações OOF de um usuário. Um usuário é identificado pelo endereço e-mail do usuário. Se a mensagem OOF for nula e OOF estiver habilitado, nenhuma mensagem OOF será enviada.

Entrada¶

Colunas do conjunto de resultados¶