Ir para o conteúdo

Detalhes da Conexão do Microsoft Office 365

Introdução

Versão do conector

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

Começando

Suporte para versões do Office 365

Todas as versões hospedadas do Office 365 são suportadas por meio do Microsoft Graph API v1.0. Inclui informações acessíveis de 365 edições do Exchange/Outlook, Teams, Tasks e OneDrive.

Estabelecendo uma Conexão

Conectando-se ao Microsoft Office 365

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.

Usando Autenticação OAuth

OAuth requer que o usuário autenticado interaja com o Office 365 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 Office 365 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 Office 365 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 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.

Máquinas Sem Cabeça

Usando OAuth em uma Máquina Sem Cabeça

Para criar fontes de dados do Office 365 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: Configure para ATUALIZAR.
  • 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 Office 365 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 Office 365 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 conector Jitterbit para Office 365. 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. Selecione a API do Microsoft Graph e selecione as permissões que seu aplicativo buscará.
  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 inserido no Conector Jitterbit para Office 365 não contém permissões que exijam o consentimento do administrador. Portanto, essas informações se aplicam apenas a aplicativos personalizados.

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 inserido com o Jitterbit Connector for Office 365 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 Office 365. 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

Atualmente, apenas o uso de um segredo do cliente tem suporte para autenticação.

Obtenha um Token de Acesso OAuth

Você está pronto para se conectar depois de definir as seguintes propriedades de conexão:

  • 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.

Tarefas Administrativas

O Conector Jitterbit para Office 365 pode ser usado para executar tarefas administrativas. 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.

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 Office 365.

Visualizações definidas pelo usuário

O conector permite definir tabelas virtuais, denominadas visualizaçõ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 Office 365 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 exibição.
  • Cada elemento raiz contém um elemento filho, chamado query, que contém a consultar SQL personalizada para a visualização.

Por exemplo:

{
    "MyView": {
        "query": "SELECT * FROM Events 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 bem 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 conector modela a API do Office 365 como tabelas relacionais. Quaisquer alterações nos dados remotos são refletidas imediatamente em suas consultas; as definições da tabela são recuperadas dinamicamente. Quando você se conecta, o conector se conecta ao Office 365 e obtém a lista de tabelas e os metadados das tabelas chamando os serviços Web apropriados.

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.

Mesas

Tabelas mostra as definições de um site de exemplo do Office 365. O modelo de dados real será obtido dinamicamente com base em suas credenciais de usuário e no site do Office 365.

Procedimentos armazenados

NOTE: Procedimentos armazenados não são suportados atualmente. Veja a nota para detalhes.

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

Tabelas

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

Geralmente, consultar tabelas do Office 365 é 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 Office 365

Nome Descrição
Calendars Essa tabela é dinâmica e mapeia para o campo correspondente na API.
Contacts A tabela de contatos do Office365.
Conversations A tabela Conversas do Office365.
Events Este campo é dinâmico e mapeia para o campo correspondente na API.
Files A tabela do Office365 Arquivos.
Groups A tabela Grupos do Office365.
Messages As mensagens da tabela Office365.
Plans A tabela Planos do Office365.
Tasks As tarefas da tabela do Office365.
Users A tabela Usuários do Office365.

Calendários

Esta tabela é dinâmica e mapeia para o campo correspondente na API.

Informações Específicas da Tabela
Selecione

Você pode consultar calendários especificando um ID ou selecionando todos:

SELECT * FROM Calendars WHERE ID = 'your Calendar ID goes here'

Selecione uma determinada coluna da entidade e filtre por essa coluna:

SELECT ID FROM Calendars WHERE name LIKE 'Calendar%'
Inserir

Especifique um nome no mínimo para criar um novo calendário:

INSERT INTO Calendars (Name) VALUES ('John')

Observação: No caso de credenciais de cliente, o UserId é necessário para criar um novo calendário:

INSERT INTO Calendars(Name, UserId)values('Test123', '92dfdfc6-f1d4-4965-9f71-30e4da4fa7fe');
Colunas
Nome Tipo Somente leitura Referências Descrição
id [KEY] String Verdadeiro Este campo é dinâmico e mapeia para o campo correspondente na API.
Etag String Falso Este campo é dinâmico e mapeia para o campo correspondente na API.
allowedOnlineMeetingProviders String Falso Este campo é dinâmico e mapeia para o campo correspondente na API.
canEdit Bool Falso Este campo é dinâmico e mapeia para o campo correspondente na API.
canShare Bool Falso Este campo é dinâmico e mapeia para o campo correspondente na API.
canViewPrivateItems Bool Falso Este campo é dinâmico e mapeia para o campo correspondente na API.
changeKey String Falso Este campo é dinâmico e mapeia para o campo correspondente na API.
color String Falso Este campo é dinâmico e mapeia para o campo correspondente na API.
defaultOnlineMeetingProvider String Falso Este campo é dinâmico e mapeia para o campo correspondente na API.
hexColor String Falso Este campo é dinâmico e mapeia para o campo correspondente na API.
isDefaultCalendar Bool Falso Este campo é dinâmico e mapeia para o campo correspondente na API.
isRemovable Bool Falso Este campo é dinâmico e mapeia para o campo correspondente na API.
isTallyingResponses Bool Falso Este campo é dinâmico e mapeia para o campo correspondente na API.
name String Falso Este campo é dinâmico e mapeia para o campo correspondente na API.
owner_address String Falso Este campo é dinâmico e mapeia para o campo correspondente na API.
owner_name String Falso Este campo é dinâmico e mapeia para o campo correspondente na API.
UserId [KEY] String Falso A coluna UserId da tabela Calendars.

Contatos

A tabela de contatos do Office365.

Informações Específicas da Tabela
Selecione

Você pode consultar Contatos especificando um ID ou selecionando todos:

SELECT * FROM Contacts WHERE ID = 'your Contact ID goes here'

Selecione uma determinada coluna da entidade e filtre por essa coluna:

SELECT GivenName FROM Contacts WHERE GivenName LIKE 'John%'
Inserir

Especifique um GivenName e um Sobrenome no mínimo para criar um novo contato:

INSERT INTO Contacts (GivenName, Surname) VALUES ('John', 'Smith')

Observação: No caso de credenciais de cliente, o UserId é necessário para criar um novo contato:

INSERT INTO Contacts (GivenName, Surname, UserId) VALUES ('John', 'Smith', '92dfdfc6-f1d4-4965-9f71-30e4da4fa7fe')
Colunas
Nome Tipo Somente leitura Referências Descrição
id [KEY] String Verdadeiro O identificador exclusivo do contato.
Etag String Falso
categories String Falso As categorias associadas ao contato.
changeKey String Falso Identifica a versão do contato. Isso muda toda vez que o contato é alterado.
createdDateTime Datetime Falso A hora em que o contato foi criado.
lastModifiedDateTime Datetime Falso A hora em que o contato foi modificado pela última vez.
assistantName String Falso O nome do assistente do contato.
birthday Datetime Falso Aniversário do contato.
businessAddress_city String Falso A cidade do endereço comercial do contato.
businessAddress_countryOrRegion String Falso O país ou região do endereço comercial do contato.
businessAddress_postalCode String Falso O código postal do endereço comercial do contato.
businessAddress_state String Falso O estado do endereço comercial do contato.
businessAddress_street String Falso A rua do endereço comercial do contato.
businessHomePage String Falso A página inicial comercial do contato.
businessPhones String Falso Os números de telefone comerciais do contato.
children String Falso Os nomes dos filhos do contato.
companyName String Falso O nome da empresa do contato.
department String Falso O departamento do contato.
displayName String Falso O nome de exibição do contato.
emailAddresses String Falso Uma coleção de endereços e-mail associados ao contato.
fileAs String Falso O nome sob o qual o contato está arquivado.
generation String Falso A geração do contato.
givenName String Falso O nome dado do contato.
homeAddress_city String Falso A cidade do endereço residencial do contato.
homeAddress_countryOrRegion String Falso O país ou região do endereço residencial do contato.
homeAddress_postalCode String Falso O código postal do endereço residencial do contato.
homeAddress_state String Falso O estado do endereço residencial do contato.
homeAddress_street String Falso A rua do endereço residencial do contato.
homePhones String Falso Os números de telefone residencial do contato
imAddresses String Falso O endereço de mensagens instantâneas (IM) do contato.
initials String Falso As iniciais do contato.
jobTitle String Falso O cargo do contato.
manager String Falso O nome do gerente do contato.
middleName String Falso O nome do meio do contato.
mobilePhone String Falso O número do celular do contato.
nickName String Falso O apelido do contato.
officeLocation String Falso A localização do endereço do contato.
otherAddress_city String Falso A cidade do outro endereço do cliente.
otherAddress_countryOrRegion String Falso O país ou região do outro endereço do cliente.
otherAddress_postalCode String Falso O código postal do outro endereço do cliente
otherAddress_state String Falso O estado do outro endereço do cliente.
otherAddress_street String Falso A rua do outro endereço do cliente.
parentFolderId String Falso A ID da pasta pai do contato.
personalNotes String Falso As notas do usuário sobre o contato.
profession String Falso A profissão do contato.
spouseName String Falso O nome do cônjuge/parceiro do contato.
surname String Falso O sobrenome do contato.
title String Falso O título do contato.
yomiCompanyName String Falso O nome fonético japonês da empresa do contato.
yomiGivenName String Falso O nome fonético japonês (primeiro nome) do contato.
yomiSurname String Falso O sobrenome japonês fonético (sobrenome) do contato.
UserId [KEY] String Falso A ID de usuário do contato.

Conversas

A tabela Conversas do Office365.

Informações Específicas da Tabela
Selecione

O GroupId é necessário para obter conversas em grupo.

SELECT * FROM Conversations WHERE GroupId = 'your GroupId goes here'

Você também pode obter conversas em grupo usando o GroupId e o ID da conversa.

SELECT * FROM Conversations WHERE ID = 'conversation ID here' AND GroupId = 'your GroupId goes here'
Inserir

Especifique GroupId, Topic, Content e NewParticipants para criar uma nova conversa. NewParticipants é um tipo complexo. Seu formato é o seguinte: 'name1, email1; nome2, e-mail2'.

INSERT INTO Conversations (GroupId, Topic, Content, NewParticipants) VALUES ('GroupId here', 'This is a test topic.', 'Hi, How Are you?', 'someone, someone@example.com')
Colunas
Nome Tipo Somente leitura Referências Descrição
id [KEY] String Verdadeiro A coluna ID da tabela Conversations.
Etag String Falso
hasAttachments Bool Falso A coluna hasAttachments da tabela Conversations.
lastDeliveredDateTime Datetime Falso A coluna lastDeliveredDateTime da tabela Conversations.
preview String Falso A coluna de visualização da tabela Conversations.
topic String Falso A coluna do tópico para a tabela Conversations.
uniqueSenders String Falso A coluna uniqueSenders da tabela Conversations.
GroupId [KEY] String Falso A coluna GroupId para a tabela Conversations.
Content String Falso A coluna Conteúdo da tabela Conversas.
NewParticipants String Falso A coluna NewParticipants da tabela Conversations.

Eventos

Este campo é dinâmico e mapeia para o campo correspondente na API.

Informações Específicas da Tabela
Selecione

A propriedade 'me' é usada por padrão para retornar eventos.

Você pode usar o UserId na cláusula WHERE para substituir isso ao procurar eventos.

SELECT * FROM Events WHERE UserId = 'abc123' AND Subject LIKE '%test%'

O GroupId pode ser um ID de tipo de calendário ou um ID de grupo. Por exemplo:

SELECT * FROM Events WHERE GroupId = 'enter your group ID here'
Inserir

Para criar um novo evento, são necessários início e fim, incluindo o fuso horário.

INSERT INTO Events (Subject, Body_Content, Start_DateTime, Start_TimeZone, End_DateTime, End_TimeZone) VALUES ('New Test Event', 'Event created using Office365Provider', '2016-01-01T10:00:00', 'UTC', '2016-01-01T11:00:00', 'UTC')

Observação: Por padrão, esta instrução criará seu evento no calendário padrão.

Observação: No caso de credenciais de cliente, o UserId é necessário para criar um novo evento:

INSERT INTO Events (Subject, Body_Content, Start_DateTime, Start_TimeZone, End_DateTime, End_TimeZone, UserId) VALUES ('New Test Event', 'Event created using Office365Provider', '2016-01-01T10:00:00', 'UTC', '2016-01-01T11:00:00', 'UTC', '92dfdfc6-f1d4-4965-9f71-30e4da4fa7fe')
Colunas
Nome Tipo Somente leitura Referências Descrição
id [KEY] String Verdadeiro Este campo é dinâmico e mapeia para o campo correspondente na API.
Etag String Falso Este campo é dinâmico e mapeia para o campo correspondente na API.
categories String Falso Este campo é dinâmico e mapeia para o campo correspondente na API.
changeKey String Falso Este campo é dinâmico e mapeia para o campo correspondente na API.
createdDateTime Datetime Falso Este campo é dinâmico e mapeia para o campo correspondente na API.
lastModifiedDateTime Datetime Falso Este campo é dinâmico e mapeia para o campo correspondente na API.
allowNewTimeProposals Bool Falso Este campo é dinâmico e mapeia para o campo correspondente na API.
attendees String Falso Este campo é dinâmico e mapeia para o campo correspondente na API.
body_content String Falso Este campo é dinâmico e mapeia para o campo correspondente na API.
body_contentType String Falso Este campo é dinâmico e mapeia para o campo correspondente na API.
bodyPreview String Falso Este campo é dinâmico e mapeia para o campo correspondente na API.
end_dateTime Datetime Falso Este campo é dinâmico e mapeia para o campo correspondente na API.
end_timeZone String Falso Este campo é dinâmico e mapeia para o campo correspondente na API.
hasAttachments Bool Falso Este campo é dinâmico e mapeia para o campo correspondente na API.
hideAttendees Bool Falso Este campo é dinâmico e mapeia para o campo correspondente na API.
iCalUId String Falso Este campo é dinâmico e mapeia para o campo correspondente na API.
importance String Falso Este campo é dinâmico e mapeia para o campo correspondente na API.
isAllDay Bool Falso Este campo é dinâmico e mapeia para o campo correspondente na API.
isCancelled Bool Falso Este campo é dinâmico e mapeia para o campo correspondente na API.
isDraft Bool Falso Este campo é dinâmico e mapeia para o campo correspondente na API.
isOnlineMeeting Bool Falso Este campo é dinâmico e mapeia para o campo correspondente na API.
isOrganizer Bool Falso Este campo é dinâmico e mapeia para o campo correspondente na API.
isReminderOn Bool Falso Este campo é dinâmico e mapeia para o campo correspondente na API.
location_address_city String Falso Este campo é dinâmico e mapeia para o campo correspondente na API.
location_address_countryOrRegion String Falso Este campo é dinâmico e mapeia para o campo correspondente na API.
location_address_postalCode String Falso Este campo é dinâmico e mapeia para o campo correspondente na API.
location_address_state String Falso Este campo é dinâmico e mapeia para o campo correspondente na API.
location_address_street String Falso Este campo é dinâmico e mapeia para o campo correspondente na API.
location_coordinates_accuracy Double Falso Este campo é dinâmico e mapeia para o campo correspondente na API.
location_coordinates_altitude Double Falso Este campo é dinâmico e mapeia para o campo correspondente na API.
location_coordinates_altitudeAccuracy Double Falso Este campo é dinâmico e mapeia para o campo correspondente na API.
location_coordinates_latitude Double Falso Este campo é dinâmico e mapeia para o campo correspondente na API.
location_coordinates_longitude Double Falso Este campo é dinâmico e mapeia para o campo correspondente na API.
location_displayName String Falso Este campo é dinâmico e mapeia para o campo correspondente na API.
location_locationEmailAddress String Falso Este campo é dinâmico e mapeia para o campo correspondente na API.
location_locationType String Falso Este campo é dinâmico e mapeia para o campo correspondente na API.
location_locationUri String Falso Este campo é dinâmico e mapeia para o campo correspondente na API.
location_uniqueId String Falso Este campo é dinâmico e mapeia para o campo correspondente na API.
location_uniqueIdType String Falso Este campo é dinâmico e mapeia para o campo correspondente na API.
locations String Falso Este campo é dinâmico e mapeia para o campo correspondente na API.
onlineMeeting_conferenceId String Falso Este campo é dinâmico e mapeia para o campo correspondente na API.
onlineMeeting_joinUrl String Falso Este campo é dinâmico e mapeia para o campo correspondente na API.
onlineMeeting_phones String Falso Este campo é dinâmico e mapeia para o campo correspondente na API.
onlineMeeting_quickDial String Falso Este campo é dinâmico e mapeia para o campo correspondente na API.
onlineMeeting_tollFreeNumbers String Falso Este campo é dinâmico e mapeia para o campo correspondente na API.
onlineMeeting_tollNumber String Falso Este campo é dinâmico e mapeia para o campo correspondente na API.
onlineMeetingProvider String Falso Este campo é dinâmico e mapeia para o campo correspondente na API.
onlineMeetingUrl String Falso Este campo é dinâmico e mapeia para o campo correspondente na API.
organizer_emailAddress_address String Falso Este campo é dinâmico e mapeia para o campo correspondente na API.
organizer_emailAddress_name String Falso Este campo é dinâmico e mapeia para o campo correspondente na API.
originalEndTimeZone String Falso Este campo é dinâmico e mapeia para o campo correspondente na API.
originalStart Datetime Falso Este campo é dinâmico e mapeia para o campo correspondente na API.
originalStartTimeZone String Falso Este campo é dinâmico e mapeia para o campo correspondente na API.
recurrence_pattern_dayOfMonth Int Falso Este campo é dinâmico e mapeia para o campo correspondente na API.
recurrence_pattern_daysOfWeek String Falso Este campo é dinâmico e mapeia para o campo correspondente na API.
recurrence_pattern_firstDayOfWeek String Falso Este campo é dinâmico e mapeia para o campo correspondente na API.
recurrence_pattern_index String Falso Este campo é dinâmico e mapeia para o campo correspondente na API.
recurrence_pattern_interval Int Falso Este campo é dinâmico e mapeia para o campo correspondente na API.
recurrence_pattern_month Int Falso Este campo é dinâmico e mapeia para o campo correspondente na API.
recurrence_pattern_type String Falso Este campo é dinâmico e mapeia para o campo correspondente na API.
recurrence_range_endDate Datetime Falso Este campo é dinâmico e mapeia para o campo correspondente na API.
recurrence_range_numberOfOccurrences Int Falso Este campo é dinâmico e mapeia para o campo correspondente na API.
recurrence_range_recurrenceTimeZone String Falso Este campo é dinâmico e mapeia para o campo correspondente na API.
recurrence_range_startDate Datetime Falso Este campo é dinâmico e mapeia para o campo correspondente na API.
recurrence_range_type String Falso Este campo é dinâmico e mapeia para o campo correspondente na API.
reminderMinutesBeforeStart Int Falso Este campo é dinâmico e mapeia para o campo correspondente na API.
responseRequested Bool Falso Este campo é dinâmico e mapeia para o campo correspondente na API.
responseStatus_response String Falso Este campo é dinâmico e mapeia para o campo correspondente na API.
responseStatus_time Datetime Falso Este campo é dinâmico e mapeia para o campo correspondente na API.
sensitivity String Falso Este campo é dinâmico e mapeia para o campo correspondente na API.
seriesMasterId String Falso Este campo é dinâmico e mapeia para o campo correspondente na API.
showAs String Falso Este campo é dinâmico e mapeia para o campo correspondente na API.
start_dateTime Datetime Falso Este campo é dinâmico e mapeia para o campo correspondente na API.
start_timeZone String Falso Este campo é dinâmico e mapeia para o campo correspondente na API.
subject String Falso Este campo é dinâmico e mapeia para o campo correspondente na API.
transactionId String Falso Este campo é dinâmico e mapeia para o campo correspondente na API.
type String Falso Este campo é dinâmico e mapeia para o campo correspondente na API.
webLink String Falso Este campo é dinâmico e mapeia para o campo correspondente na API.
UserId String Falso Este campo é dinâmico e mapeia para o campo correspondente na API.
GroupId String Falso Este campo é dinâmico e mapeia para o campo correspondente na API.

Arquivos

A tabela do Office365 Arquivos.

Informações Específicas da Tabela
Selecione

Recupere arquivos usando UserId ou File ID (Id), por exemplo, ou simplesmente filtre por uma determinada coluna:

SELECT * FROM Files WHERE UserId = 'MyUserId'

SELECT Name, LastModifiedDateTime FROM Files WHERE Name LIKE 'test%'

Para trabalhar com arquivos em nível de pasta, precisamos especificar o parentReference_path na consultar.

SELECT * FROM files WHERE parentReference_path = '/drives/b!3LIvU2zISEqicGlWkgVknKxKT-q7gM5IqlBJ4w4MZqaX6BQc_vtwQpnqaldXkH9I/root:/Test_Shubham';
Inserir

A operação de inserção não é suportada para esta tabela.

Observação: Consulte UploadArquivo (ou CriarPasta para criar uma pasta) para inserir e atualizar o conteúdo de um arquivo.

Colunas
Nome Tipo Somente leitura Referências Descrição
id [KEY] String Verdadeiro A coluna ID da tabela Files.
Etag String Falso A coluna Etag da tabela Files.
createdBy_application_displayName String Falso A coluna createdBy_application_displayName para a tabela Files.
createdBy_application_id String Falso A coluna createdBy_application_id para a tabela Files.
createdDateTime Datetime Falso A coluna createdDateTime para a tabela Files.
description String Falso A coluna de descrição da tabela Arquivos.
lastModifiedBy_application_displayName String Falso A coluna lastModifiedBy_application_displayName para a tabela Files.
lastModifiedBy_application_id String Falso A coluna lastModifiedBy_application_id para a tabela Files.
lastModifiedDateTime Datetime Falso A coluna lastModifiedDateTime da tabela Files.
name String Falso A coluna de nome para a tabela Files.
parentReference_driveId String Falso A coluna parentReference_driveId para a tabela Files.
parentReference_driveType String Falso A coluna parentReference_driveType da tabela Files.
parentReference_id String Falso A coluna parentReference_id para a tabela Files.
parentReference_name String Falso A coluna parentReference_name para a tabela Files.
parentReference_path String Falso A coluna parentReference_path para a tabela Files.
parentReference_shareId String Falso A coluna parentReference_shareId para a tabela Files.
parentReference_sharepointIds_listId String Falso A coluna parentReference_sharepointIds_listId para a tabela Arquivos.
parentReference_sharepointIds_listItemId String Falso A coluna parentReference_sharepointIds_listItemId para a tabela Arquivos.
parentReference_sharepointIds_listItemUniqueId String Falso A coluna parentReference_sharepointIds_listItemUniqueId para a tabela Arquivos.
parentReference_sharepointIds_siteId String Falso A coluna parentReference_sharepointIds_siteId para a tabela Arquivos.
parentReference_sharepointIds_siteUrl String Falso A coluna parentReference_sharepointIds_siteUrl para a tabela Arquivos.
parentReference_sharepointIds_tenantId String Falso A coluna parentReference_sharepointIds_tenantId para a tabela Arquivos.
parentReference_sharepointIds_webId String Falso A coluna parentReference_sharepointIds_webId para a tabela Arquivos.
parentReference_siteId String Falso A coluna parentReference_siteId para a tabela Files.
webUrl String Falso A coluna webUrl da tabela Files.
audio_album String Falso A coluna audio_album para a tabela Files.
audio_albumArtist String Falso A coluna audio_albumArtist para a tabela Files.
audio_artist String Falso A coluna audio_artist para a tabela Files.
audio_bitrate Long Falso A coluna audio_bitrate da tabela Files.
audio_composers String Falso A coluna audio_composers para a tabela Files.
audio_copyright String Falso A coluna audio_copyright para a tabela Arquivos.
audio_disc Int Falso A coluna audio_disc para a tabela Files.
audio_discCount Int Falso A coluna audio_discCount para a tabela Files.
audio_duration Long Falso A coluna audio_duration da tabela Files.
audio_genre String Falso A coluna audio_genre para a tabela Files.
audio_hasDrm Bool Falso A coluna audio_hasDrm para a tabela Files.
audio_isVariableBitrate Bool Falso A coluna audio_isVariableBitrate para a tabela Files.
audio_title String Falso A coluna audio_title da tabela Files.
audio_track Int Falso A coluna audio_track para a tabela Files.
audio_trackCount Int Falso A coluna audio_trackCount para a tabela Files.
audio_year Int Falso A coluna audio_year da tabela Files.
content String Falso A coluna de conteúdo da tabela Files.
cTag String Falso A coluna cTag para a tabela Files.
deleted_state String Falso A coluna delete_state para a tabela Files.
file_hashes_crc32Hash String Falso A coluna file_hashes_crc32Hash para a tabela Files.
file_hashes_quickXorHash String Falso A coluna file_hashes_quickXorHash para a tabela Files.
file_hashes_sha1Hash String Falso A coluna file_hashes_sha1Hash para a tabela Files.
file_hashes_sha256Hash String Falso A coluna file_hashes_sha256Hash para a tabela Files.
file_mimeType String Falso A coluna file_mimeType para a tabela Files.
file_processingMetadata Bool Falso A coluna file_processingMetadata para a tabela Files.
fileSystemInfo_createdDateTime Datetime Falso A coluna fileSystemInfo_createdDateTime para a tabela Files.
fileSystemInfo_lastAccessedDateTime Datetime Falso A coluna fileSystemInfo_lastAccessedDateTime para a tabela Files.
fileSystemInfo_lastModifiedDateTime Datetime Falso A coluna fileSystemInfo_lastModifiedDateTime para a tabela Files.
folder_childCount Int Falso A coluna folder_childCount para a tabela Files.
folder_view_sortBy String Falso A coluna folder_view_sortBy da tabela Files.
folder_view_sortOrder String Falso A coluna folder_view_sortOrder para a tabela Arquivos.
folder_view_viewType String Falso A coluna folder_view_viewType da tabela Files.
image_height Int Falso A coluna image_height para a tabela Files.
image_width Int Falso A coluna image_width para a tabela Files.
location_altitude Double Falso A coluna location_altitude para a tabela Files.
location_latitude Double Falso A coluna location_latitude para a tabela Files.
location_longitude Double Falso A coluna location_longitude para os arquivos da tabela.
package_type String Falso A coluna package_type da tabela Files.
pendingOperations_pendingContentUpdate_queuedDateTime Datetime Falso A coluna pendingOperations_pendingContentUpdate_queuedDateTime da tabela Files.
photo_cameraMake String Falso A coluna photo_cameraMake para a tabela Files.
photo_cameraModel String Falso A coluna photo_cameraModel para a tabela Files.
photo_exposureDenominator Double Falso A coluna photo_exposureDenominator para a tabela Files.
photo_exposureNumerator Double Falso A coluna photo_exposureNumerator para a tabela Files.
photo_fNumber Double Falso A coluna photo_fNumber para a tabela Files.
photo_focalLength Double Falso A coluna photo_focalLength para a tabela Files.
photo_iso Int Falso A coluna photo_iso para a tabela Files.
photo_orientation Int Falso A coluna photo_orientation para a tabela Files.
photo_takenDateTime Datetime Falso A coluna photo_takenDateTime para a tabela Files.
publication_level String Falso A coluna de nível_da_publicação para a tabela Arquivos.
publication_versionId String Falso A coluna publication_versionId para a tabela Files.
remoteItem_createdBy_application_displayName String Falso A coluna remoteItem_createdBy_application_displayName para a tabela Arquivos.
remoteItem_createdBy_application_id String Falso A coluna remoteItem_createdBy_application_id para a tabela Arquivos.
remoteItem_createdDateTime Datetime Falso A coluna remoteItem_createdDateTime para a tabela Files.
remoteItem_file_hashes_crc32Hash String Falso A coluna remoteItem_file_hashes_crc32Hash para a tabela Files.
remoteItem_file_hashes_quickXorHash String Falso A coluna remoteItem_file_hashes_quickXorHash para a tabela Files.
remoteItem_file_hashes_sha1Hash String Falso A coluna remoteItem_file_hashes_sha1Hash para a tabela Files.
remoteItem_file_hashes_sha256Hash String Falso A coluna remoteItem_file_hashes_sha256Hash para a tabela Files.
remoteItem_file_mimeType String Falso A coluna remoteItem_file_mimeType para a tabela Files.
remoteItem_file_processingMetadata Bool Falso A coluna remoteItem_file_processingMetadata para a tabela Files.
remoteItem_fileSystemInfo_createdDateTime Datetime Falso A coluna remoteItem_fileSystemInfo_createdDateTime para a tabela Files.
remoteItem_fileSystemInfo_lastAccessedDateTime Datetime Falso A coluna remoteItem_fileSystemInfo_lastAccessedDateTime para a tabela Files.
remoteItem_fileSystemInfo_lastModifiedDateTime Datetime Falso A coluna remoteItem_fileSystemInfo_lastModifiedDateTime para a tabela Files.
remoteItem_folder_childCount Int Falso A coluna remoteItem_folder_childCount para a tabela Files.
remoteItem_folder_view_sortBy String Falso A coluna remoteItem_folder_view_sortBy para a tabela Files.
remoteItem_folder_view_sortOrder String Falso A coluna remoteItem_folder_view_sortOrder para a tabela Files.
remoteItem_folder_view_viewType String Falso A coluna remoteItem_folder_view_viewType para a tabela Files.
remoteItem_id String Falso A coluna remoteItem_id para a tabela Files.
remoteItem_image_height Int Falso A coluna remoteItem_image_height para a tabela Files.
remoteItem_image_width Int Falso A coluna remoteItem_image_width para a tabela Files.
remoteItem_lastModifiedDateTime Datetime Falso A coluna remoteItem_lastModifiedDateTime para a tabela Files.
remoteItem_name String Falso A coluna remoteItem_name para a tabela Files.
remoteItem_package_type String Falso A coluna remoteItem_package_type para a tabela Files.
remoteItem_parentReference_driveId String Falso A coluna remoteItem_parentReference_driveId para a tabela Files.
remoteItem_parentReference_driveType String Falso A coluna remoteItem_parentReference_driveType para a tabela Files.
remoteItem_parentReference_id String Falso A coluna remoteItem_parentReference_id para a tabela Files.
remoteItem_parentReference_name String Falso A coluna remoteItem_parentReference_name para a tabela Files.
remoteItem_parentReference_path String Falso A coluna remoteItem_parentReference_path para a tabela Files.
remoteItem_parentReference_shareId String Falso A coluna remoteItem_parentReference_shareId para a tabela Files.
remoteItem_parentReference_sharepointIds_listId String Falso A coluna remoteItem_parentReference_sharepointIds_listId para a tabela Files.
remoteItem_parentReference_sharepointIds_listItemId String Falso A coluna remoteItem_parentReference_sharepointIds_listItemId para a tabela Files.
remoteItem_parentReference_sharepointIds_listItemUniqueId String Falso A coluna remoteItem_parentReference_sharepointIds_listItemUniqueId para a tabela Arquivos.
remoteItem_parentReference_sharepointIds_siteId String Falso A coluna remoteItem_parentReference_sharepointIds_siteId para a tabela Files.
remoteItem_parentReference_sharepointIds_siteUrl String Falso A coluna remoteItem_parentReference_sharepointIds_siteUrl para a tabela Files.
remoteItem_parentReference_sharepointIds_tenantId String Falso A coluna remoteItem_parentReference_sharepointIds_tenantId para a tabela Files.
remoteItem_parentReference_sharepointIds_webId String Falso A coluna remoteItem_parentReference_sharepointIds_webId para a tabela Files.
remoteItem_parentReference_siteId String Falso A coluna remoteItem_parentReference_siteId para a tabela Files.
remoteItem_shared_scope String Falso A coluna remoteItem_shared_scope para a tabela Files.
remoteItem_shared_sharedDateTime Datetime Falso A coluna remoteItem_shared_sharedDateTime para a tabela Files.
remoteItem_size Long Falso A coluna remoteItem_size para a tabela Files.
remoteItem_specialFolder_name String Falso A coluna remoteItem_specialFolder_name para a tabela Files.
remoteItem_video_audioBitsPerSample Int Falso A coluna remoteItem_video_audioBitsPerSample para a tabela Files.
remoteItem_video_audioChannels Int Falso A coluna remoteItem_video_audioChannels para a tabela Files.
remoteItem_video_audioSamplesPerSecond Int Falso A coluna remoteItem_video_audioSamplesPerSecond para a tabela Files.
remoteItem_video_bitrate Int Falso A coluna remoteItem_video_bitrate para a tabela Files.
remoteItem_video_duration Long Falso A coluna remoteItem_video_duration para a tabela Files.
remoteItem_video_fourCC String Falso A coluna remoteItem_video_fourCC para a tabela Files.
remoteItem_video_frameRate Double Falso A coluna remoteItem_video_frameRate para a tabela Files.
remoteItem_video_height Int Falso A coluna remoteItem_video_height para a tabela Files.
remoteItem_video_width Int Falso A coluna remoteItem_video_width para a tabela Files.
remoteItem_webDavUrl String Falso A coluna remoteItem_webDavUrl para a tabela Files.
remoteItem_webUrl String Falso A coluna remoteItem_webUrl para a tabela Files.
searchResult_onClickTelemetryUrl String Falso A coluna searchResult_onClickTelemetryUrl para a tabela Files.
shared_owner_application_displayName String Falso A coluna shared_owner_application_displayName para a tabela Arquivos.
shared_owner_application_id String Falso A coluna shared_owner_application_id para a tabela Arquivos.
shared_scope String Falso A coluna shared_scope para a tabela Files.
shared_sharedDateTime Datetime Falso A coluna shared_sharedDateTime para a tabela Files.
sharepointIds_listId String Falso A coluna sharepointIds_listId para a tabela Arquivos.
sharepointIds_listItemId String Falso A coluna sharepointIds_listItemId para a tabela Arquivos.
sharepointIds_listItemUniqueId String Falso A coluna sharepointIds_listItemUniqueId para a tabela Arquivos.
sharepointIds_siteId String Falso A coluna sharepointIds_siteId para a tabela Arquivos.
sharepointIds_siteUrl String Falso A coluna sharepointIds_siteUrl para a tabela Files.
sharepointIds_tenantId String Falso A coluna sharepointIds_tenantId para a tabela Arquivos.
sharepointIds_webId String Falso A coluna sharepointIds_webId para a tabela Files.
size Long Falso A coluna de tamanho para a tabela Files.
specialFolder_name String Falso A coluna specialFolder_name para a tabela Files.
video_audioBitsPerSample Int Falso A coluna video_audioBitsPerSample para a tabela Files.
video_audioChannels Int Falso A coluna video_audioChannels da tabela Files.
video_audioFormat String Falso A coluna video_audioFormat para a tabela Files.
video_audioSamplesPerSecond Int Falso A coluna video_audioSamplesPerSecond da tabela Files.
video_bitrate Int Falso A coluna video_bitrate da tabela Files.
video_duration Long Falso A coluna video_duration da tabela Files.
video_fourCC String Falso A coluna video_fourCC para a tabela Files.
video_frameRate Double Falso A coluna video_frameRate da tabela Files.
video_height Int Falso A coluna video_height da tabela Files.
video_width Int Falso A coluna video_width da tabela Files.
webDavUrl String Falso A coluna webDavUrl para a tabela Files.
UserId String Falso A coluna UserId da tabela Files.

Grupos

A tabela Grupos do Office365.

Informações Específicas da Tabela

Os grupos requerem permissões de administrador. Para trabalhar com eles, você deve criar seu próprio aplicativo OAuth personalizado e definir o apropriadoOAuthClientId e OAuthClientSecret. Neste aplicativo, você deve configurá-lo para solicitar as permissões Group.Read.All e Group.ReadWrite.All. Isso pode ser feito em https://apps.dev.microsoft.com, ou no painel Registros de aplicativos em http://portal.azure.com. Consulte Credenciais personalizadas para obter mais detalhes sobre como criar um aplicativo personalizado.

Para autorizar permissões de Grupos, um administrador deve conceder as permissões de Grupos para sua organização como um todo. Isso pode ser feito por meio do endpoint de autorização do administrador. Basta que o administrador navegue até a seguinte página da Web e conceda permissões. Em seguida, execute a autorização OAuth normalmente.

https://login.microsoftonline.com/common/adminconsent?client_id=[YourClientId]&redirect_uri=http://localhost:33333

Observe que, se sua organização tiver vários locatários, você poderá substituir /common/ na URL pela ID do locatário para indicar a qual locatário conceder permissões.

Selecione

Recupere todos os grupos, especifique um GroupId (Id) ou simplesmente filtre por uma determinada coluna:

SELECT * FROM Groups
SELECT * FROM Groups WHERE Id = 'Group Id here'
SELECT Id, Description, DisplayName FROM Groups WHERE Name = 'test'
Inserir

Os itens a seguir são necessários para criar um novo grupo de segurança:

INSERT INTO Groups (DisplayName, MailEnabled, MailNickname, SecurityEnabled) VALUES ('Test group', false, 'test', true)
Colunas
Nome Tipo Somente leitura Referências Descrição
id [KEY] String Verdadeiro O identificador exclusivo do grupo.
Etag String Falso
deletedDateTime Datetime Falso
allowExternalSenders Bool Falso Indica se pessoas externas à organização podem enviar mensagens ao grupo.
assignedLabels String Falso
assignedLicenses String Falso
autoSubscribeNewMembers Bool Falso Indica se novos membros adicionados ao grupo serão inscritos automaticamente para receber notificações e-mail.
classification String Falso
createdDateTime Datetime Falso
description String Falso Uma descrição opcional para o grupo.
displayName String Falso O nome de exibição do grupo.
expirationDateTime Datetime Falso
groupTypes String Falso Especifica o tipo de grupo a ser criado. Os valores possíveis são Unificado para criar um grupo do Office 365 ou DynamicMembership para grupos dinâmicos. Para todos os outros tipos de grupo, como grupos com segurança habilitada e grupos de segurança com email, não defina esta propriedade.
hasMembersWithLicenseErrors Bool Falso
hideFromAddressLists Bool Falso
hideFromOutlookClients Bool Falso
isArchived Bool Falso
isSubscribedByMail Bool Falso Indica se o usuário atual está inscrito para receber conversas e-mail.
licenseProcessingState_state String Falso
mail String Falso O endereço SMTP do grupo.
mailEnabled Bool Falso Especifica se o grupo está habilitado para email. Se a propriedade securityEnabled também for verdadeira, o grupo é um grupo de segurança habilitado para email; caso contrário, o grupo é um grupo de distribuição do Microsoft Exchange.
mailNickname String Falso O alias de e-mail do grupo, exclusivo na organização.
membershipRule String Falso
membershipRuleProcessingState String Falso
onPremisesDomainName String Falso
onPremisesLastSyncDateTime Datetime Falso Indica a última vez em que o grupo foi sincronizado com o diretório local.
onPremisesNetBiosName String Falso
onPremisesProvisioningErrors String Falso
onPremisesSamAccountName String Falso
onPremisesSecurityIdentifier String Falso Contém o identificador de segurança local (SID) para o grupo que foi sincronizado do local para a nuvem.
onPremisesSyncEnabled Bool Falso Verdadeiro se este grupo for sincronizado de um diretório local; false se este grupo foi originalmente sincronizado de um diretório local, mas não está mais sincronizado; null se este objeto nunca foi sincronizado de um diretório local.
preferredDataLocation String Falso
preferredLanguage String Falso
proxyAddresses String Falso Os endereços de proxy para a tabela Groups.
renewedDateTime Datetime Falso
securityEnabled Bool Falso Especifica se o grupo é um grupo de segurança. Se a propriedade mailEnabled também for verdadeira, o grupo é um grupo de segurança habilitado para email; caso contrário, é um grupo de segurança. Deve ser falso para grupos do Office 365.
securityIdentifier String Falso
theme String Falso
unseenCount Int Falso Contagem de postagens que o usuário atual não viu desde sua última visita.
visibility String Falso Especifica a visibilidade de um grupo do Office 365. Os valores possíveis são: Private, Public, HiddenMembership ou vazio (que é interpretado como Public).

Mensagens

As mensagens da tabela Office365.

Informações Específicas da Tabela
Selecione

Você pode recuperar tudo de Mensagens, especificar uma Mensagem (Id), UserId ou ParentFolderId ou filtrar os resultados por uma determinada coluna:

SELECT * FROM Messages
SELECT * FROM Messages WHERE Id = 'MyMessageId'

SELECT * FROM Messages WHERE UserId = 'MyUserId'

SELECT * FROM Messages WHERE ParentFolderId = 'MyParentfolderId' 
SELECT * FROM Messages WHERE ParentFolderId = 'Drafts'
SELECT DisplayName, ID FROM Users WHERE DisplayName LIKE 'John%'
Inserir

Após a inserção uma nova Mensagem será criada na pasta Rascunhos do Usuário.

INSERT INTO Messages (Subject, Body_Content, UserId) VALUES ('New test Email', 'Test Email created.', 'User ID goes here')

Nota: Para enviar o e-mail, consulte SendMail.

Problemas Conhecidos

No momento, há um problema com esta tabela. Às vezes, pode retornar um número inconsistente de resultados. Ou seja, ele pode retornar um número X de linhas para alguma consultar e se você tentar essa consultar novamente logo após ela retornará um número diferente de linhas, mesmo que você não tenha alterado nada. Algumas linhas podem estar faltando.
Este é um problema de API conhecido que atualmente não tem solução alternativa. Assim que a Microsoft o corrigir em sua API do Microsoft Graph, ele também funcionará automaticamente neste conector.

Dito isso, existe uma configuração que você pode aplicar no conector para recuperar todas as mensagens, mas ela vem com uma desvantagem: os dados de 'eventos' e 'contatos' serão retornados junto com os dados de 'mensagens'. Portanto, não garantimos a pureza das informações. Você terá que confiar em sua própria filtragem para distinguir entre linhas de mensagens e não mensagens.

Para ativar a configuração basta adicionar "ClientSidePaging=true;" (sem aspas) no valor de Other propriedade de conexão.

Colunas
Nome Tipo Somente leitura Referências Descrição
id [KEY] String Verdadeiro A coluna ID da tabela Mensagens.
Etag String Falso A coluna Etag da tabela Mensagens.
categories String Falso A coluna de categorias da tabela Mensagens.
changeKey String Falso A coluna changeKey da tabela Messages.
createdDateTime Datetime Falso A coluna createdDateTime da tabela Messages.
lastModifiedDateTime Datetime Falso A coluna lastModifiedDateTime da tabela Messages.
bccRecipients String Falso A coluna bccRecipients da tabela Messages.
body_content String Falso A coluna body_content da tabela Messages.
body_contentType String Falso A coluna body_contentType da tabela Messages.
bodyPreview String Falso A coluna bodyPreview da tabela Messages.
ccRecipients String Falso A coluna ccRecipients da tabela Messages.
conversationId String Falso A coluna conversationId da tabela Messages.
conversationIndex Binary Falso A coluna conversationIndex da tabela Messages.
flag_completedDateTime_dateTime Datetime Falso A coluna flag_completedDateTime_dateTime da tabela Mensagens.
flag_completedDateTime_timeZone String Falso A coluna flag_completedDateTime_timeZone da tabela Messages.
flag_flagStatus String Falso A coluna flag_flagStatus da tabela Mensagens.
from_emailAddress_address String Falso A coluna from_emailAddress_address da tabela Mensagens.
from_emailAddress_name String Falso A coluna from_emailAddress_name da tabela Mensagens.
hasAttachments Bool Falso A coluna hasAttachments da tabela Messages.
importance String Falso A coluna de importância da tabela Mensagens.
inferenceClassification String Falso A coluna inferenceClassification da tabela Messages.
internetMessageHeaders String Falso A coluna internetMessageHeaders da tabela Messages.
internetMessageId String Falso A coluna internetMessageId da tabela Messages.
isDeliveryReceiptRequested Bool Falso A coluna isDeliveryReceiptRequested da tabela Messages.
isDraft Bool Falso A coluna isDraft da tabela Messages.
isRead Bool Falso A coluna isRead da tabela Messages.
isReadReceiptRequested Bool Falso A coluna isReadReceiptRequested da tabela Messages.
parentFolderId String Falso A coluna parentFolderId da tabela Messages.
receivedDateTime Datetime Falso A coluna ReceiveDateTime da tabela Messages.
replyTo String Falso A coluna replyTo da tabela Messages.
sender_emailAddress_address String Falso A coluna sender_emailAddress_address da tabela Messages.
sender_emailAddress_name String Falso A coluna sender_emailAddress_name da tabela Messages.
sentDateTime Datetime Falso A coluna sentDateTime da tabela Messages.
subject String Falso A coluna de assunto da tabela Mensagens.
toRecipients String Falso A coluna toRecipients da tabela Messages.
uniqueBody_content String Falso A coluna uniqueBody_content da tabela Mensagens.
uniqueBody_contentType String Falso A coluna uniqueBody_contentType da tabela Messages.
webLink String Falso A coluna webLink da tabela Mensagens.
UserId String Falso A coluna UserId da tabela Messages.
IsEventMessage Bool Falso coluna para distinguir se as mensagens são com convites de calendário/evento

Planos

A tabela Planos do Office365.

Informações Específicas da Tabela

O uso de Planos requer acesso às permissões de Grupos. Isso requer aprovação do administrador. Por esse motivo, você deve usar seu próprio aplicativo OAuth para adicionar as permissões de grupos e do Microsoft Graph. Consulte Criando um aplicativo OAuth personalizado para mais detalhes.

Selecione

Todos os planos no MS Planner existem como parte de um grupo. Para recuperar a lista de planos disponíveis, você deve recuperar uma lista de planos disponíveis por grupo. Se nenhum GroupId for especificado, a seguinte condição WHERE será anexada a qualquer consultar:

GroupId IN (SELECT ID FROM Groups)
Colunas
Nome Tipo Somente leitura Referências Descrição
createdBy_application_displayName String Falso A coluna createdBy_application_displayName para a tabela Plans.
createdBy_application_id String Falso A coluna createdBy_application_id para a tabela Plans.
createdDateTime Datetime Falso A coluna createdDateTime para a tabela Plans.
owner String Falso A coluna do proprietário da tabela Planos.
title String Falso A coluna de título da tabela Planos.
GroupId [KEY] String Falso A coluna GroupId para a tabela Plans.

Tarefas

As tarefas da tabela do Office365.

Informações Específicas da Tabela

Tarefas requer as permissões Grupos e Tarefas do Microsoft Graph. Por esse motivo, você deve criar seu próprio aplicativo OAuth. Consulte Criando um aplicativo OAuth personalizado para mais detalhes.

Selecione

Por padrão, se nenhum critério for especificado, apenas as Tarefas atribuídas pessoalmente a você serão exibidas. Por exemplo:

SELECT * FROM Tasks

Para trazer de volta tarefas em toda a organização, forneça os IDs de planos específicos ou use uma subseleção para o ID do plano. Por exemplo:

SELECT * FROM Tasks WHERE PlanId IN (SELECT ID FROM Plans)
Inserir

Para inserir uma Tarefa, o plano associado deve ser especificado:

INSERT INTO Tasks (Title, PlanId) VALUES ('My Title', '99999999-eeeeeeeee')
Atualizar

Para atualizar uma tarefa, o ID e a Etag devem ser especificados:

UPDATE Tasks SET Title='New Title' WHERE ID = 'xxxxxx-AAAAAAAAAAA' AND Etag='W/\"XXXXXXQEBAQEBAQEBAQEBAQEBARCc=\"'
Excluir

Para excluir uma tarefa, tanto o ID quanto a Etag devem ser especificados:

DELETE FROM Tasks WHERE ID = 'xxxxxx-AAAAAAAAAAA' AND Etag='W/\"XXXXXXQEBAQEBAQEBAQEBAQEBARCc=\"'
Colunas
Nome Tipo Somente leitura Referências Descrição
activeChecklistItemCount Int Falso A coluna activeChecklistItemCount da tabela Tasks.
assigneePriority String Falso A coluna assigneePriority da tabela Tasks.
bucketId String Falso A coluna bucketId da tabela Tasks.
checklistItemCount Int Falso A coluna checklistItemCount da tabela Tasks.
completedBy_application_displayName String Falso A coluna CompleteBy_application_displayName para a tabela Tasks.
completedBy_application_id String Falso A coluna CompleteBy_application_id para a tabela Tasks.
completedDateTime Datetime Falso A coluna CompleteDateTime para a tabela Tasks.
conversationThreadId String Falso A coluna conversationThreadId para a tabela Tasks.
createdBy_application_displayName String Falso A coluna createdBy_application_displayName para a tabela Tasks.
createdBy_application_id String Falso A coluna createdBy_application_id para a tabela Tasks.
createdDateTime Datetime Falso A coluna createdDateTime para a tabela Tasks.
dueDateTime Datetime Falso A coluna dueDateTime para a tabela Tasks.
hasDescription Bool Falso A coluna hasDescription para a tabela Tasks.
orderHint String Falso A coluna orderHint da tabela Tasks.
percentComplete Int Falso A coluna percentComplete da tabela Tasks.
planId String Falso A coluna planId para a tabela Tasks.
previewType String Falso A coluna previewType da tabela Tasks.
referenceCount Int Falso A coluna referenceCount para a tabela Tasks.
startDateTime Datetime Falso A coluna startDateTime da tabela Tasks.
title String Falso A coluna de título da tabela Tasks.
Etag [KEY] String Falso A coluna Etag da tabela Tasks.

Usuários

A tabela Usuários do Office365.

Informações Específicas da Tabela
Selecione

Consulte a tabela Users recuperando tudo de Users, especificando um ID ou filtrando por uma coluna:

SELECT * FROM Users WHERE Id = '616391f0-32d8-4127-8f25-aa55771d6617'

SELECT DisplayName, ID FROM Users WHERE DisplayName LIKE 'John%'
Inserir

O seguinte é necessário para criar um novo usuário organizacional:

INSERT INTO Users (AccountEnabled, DisplayName, MailNickname, UserPrincipalName, PasswordProfile_ForceChangePasswordNextSignIn, PasswordProfile_Password) VALUES (false, 'John Smith', 'JohnS', 'smithjohn@yourcompanydomain.com', true, '123password')
Colunas
Nome Tipo Somente leitura Referências Descrição
id [KEY] String Verdadeiro
Etag String Falso
deletedDateTime Datetime Falso
accountEnabled Bool Falso
ageGroup String Falso
assignedLicenses String Falso
assignedPlans String Falso
businessPhones String Falso
city String Falso
companyName String Falso
consentProvidedForMinor String Falso
country String Falso
createdDateTime Datetime Falso
creationType String Falso
department String Falso
displayName String Falso
employeeHireDate Datetime Falso
employeeId String Falso
employeeOrgData_costCenter String Falso
employeeOrgData_division String Falso
employeeType String Falso
externalUserState String Falso
externalUserStateChangeDateTime Datetime Falso
faxNumber String Falso
givenName String Falso
identities String Falso
imAddresses String Falso
isResourceAccount Bool Falso
jobTitle String Falso
lastPasswordChangeDateTime Datetime Falso
legalAgeGroupClassification String Falso
licenseAssignmentStates String Falso
mailNickname String Falso
mobilePhone String Falso
officeLocation String Falso
onPremisesDistinguishedName String Falso
onPremisesDomainName String Falso
onPremisesImmutableId String Falso
onPremisesLastSyncDateTime Datetime Falso
onPremisesProvisioningErrors String Falso
onPremisesSamAccountName String Falso
onPremisesSecurityIdentifier String Falso
onPremisesSyncEnabled Bool Falso
onPremisesUserPrincipalName String Falso
otherMails String Falso
passwordPolicies String Falso
passwordProfile_forceChangePasswordNextSignIn Bool Falso
passwordProfile_forceChangePasswordNextSignInWithMfa Bool Falso
passwordProfile_password String Falso
postalCode String Falso
preferredLanguage String Falso
provisionedPlans String Falso
proxyAddresses String Falso
showInAddressList Bool Falso
signInSessionsValidFromDateTime Datetime Falso
state String Falso
streetAddress String Falso
surname String Falso
usageLocation String Falso
userPrincipalName String Falso
userType String Falso

Visualizações

As exibições são compostas por colunas e pseudocolunas. As exibições são semelhantes às tabelas na forma como os dados são representados; no entanto, as exibições não oferecem suporte a atualizações. Entidades que são representadas como exibições são normalmente entidades somente leitura. Frequentemente, um procedimento armazenado* está disponível para atualizar os dados se tal funcionalidade for aplicável à fonte de dados.

As consultas podem ser executadas em uma exibição como se fosse uma tabela normal, e os dados retornados são semelhantes nesse aspecto. Para saber mais sobre tabelas e procedimentos armazenados, navegue até as entradas correspondentes neste documento de ajuda.

Conector Jitterbit para Exibições do Office 365

Nome Descrição
CalendarView Recupere as ocorrências, exceções e instâncias únicas de eventos em uma exibição de calendário definida por um intervalo de tempo, do calendário padrão do usuário ou de algum outro calendário do usuário.
EventOccurrences Informações de uso para a operação EventOccurrences.rsd.

CalendarView

Recupere as ocorrências, exceções e instâncias únicas de eventos em uma exibição de calendário definida por um intervalo de tempo, do calendário padrão do usuário ou de algum outro calendário do usuário.

Informações Específicas da Tabela
Selecione

Obtenha as ocorrências, exceções e instâncias únicas de eventos em uma exibição de calendário definida por um intervalo de tempo, do calendário padrão do usuário ou de algum outro calendário do usuário. Por padrão, serão retornadas apenas as ocorrências de eventos do calendário padrão do usuário no intervalo dos últimos 30 dias. Você pode filtrar os resultados por CalendarId, UserId, Start_DateTime, End_DateTime.

Por exemplo, as seguintes consultas serão processadas no lado do servidor:

Select * FROM CalendarView Where Start_DateTime>='2019-12-10 15:00' AND End_DateTime<='2020-01-10 14:30'
SELECT * FROM CalendarView Where CalendarId='AQMkAGRlMWQ5MDg0LWI5ZTQtNDk2Yi1hOTQ1LTU4YzFmMzEwZjlhMgBGAAAD-FjxR3cIwE6TEGSCVtIHcwcAQyR2Iw3coEOaUD1BLt0tnAAAAwcAAABDJHYjDdygQ5pQPUEu3S2cAAACC_IAAAA='
SELECT * from CalendarView Where CalendarId='AQMkAGRlMWQ5MDg0LWI5ZTQtNDk2Yi1hOTQ1LTU4YzFmMzEwZjlhMgBGAAAD-FjxR3cIwE6TEGSCVtIHcwcAQyR2Iw3coEOaUD1BLt0tnAAAAwcAAABDJHYjDdygQ5pQPUEu3S2cAAACC_IAAAA=' And UserId='a98f25b5-5da1-4937-8729-c0d03026caa0' AND Start_DateTime>='2019-12-15 08:00' AND End_DateTime<='2020-01-14 08:00'
Colunas
Nome Tipo Referências Descrição
id [KEY] String
Etag String
categories String
changeKey String
createdDateTime Datetime
lastModifiedDateTime Datetime
allowNewTimeProposals Bool
attendees String
body_content String
body_contentType String
bodyPreview String
end_dateTime Datetime
end_timeZone String
hasAttachments Bool
hideAttendees Bool
iCalUId String
importance String
isAllDay Bool
isCancelled Bool
isDraft Bool
isOnlineMeeting Bool
isOrganizer Bool
isReminderOn Bool
location_address_city String
location_address_countryOrRegion String
location_address_postalCode String
location_address_state String
location_address_street String
location_coordinates_accuracy Double
location_coordinates_altitude Double
location_coordinates_altitudeAccuracy Double
location_coordinates_latitude Double
location_coordinates_longitude Double
location_displayName String
location_locationEmailAddress String
location_locationType String
location_locationUri String
location_uniqueId String
location_uniqueIdType String
locations String
onlineMeeting_conferenceId String
onlineMeeting_joinUrl String
onlineMeeting_phones String
onlineMeeting_quickDial String
onlineMeeting_tollFreeNumbers String
onlineMeeting_tollNumber String
onlineMeetingProvider String
onlineMeetingUrl String
organizer_emailAddress_address String
organizer_emailAddress_name String
originalEndTimeZone String
originalStart Datetime
originalStartTimeZone String
recurrence_pattern_dayOfMonth Int
recurrence_pattern_daysOfWeek String
recurrence_pattern_firstDayOfWeek String
recurrence_pattern_index String
recurrence_pattern_interval Int
recurrence_pattern_month Int
recurrence_pattern_type String
recurrence_range_endDate Datetime
recurrence_range_numberOfOccurrences Int
recurrence_range_recurrenceTimeZone String
recurrence_range_startDate Datetime
recurrence_range_type String
reminderMinutesBeforeStart Int
responseRequested Bool
responseStatus_response String
responseStatus_time Datetime
sensitivity String
seriesMasterId String
showAs String
start_dateTime Datetime
start_timeZone String
subject String
transactionId String
type String
webLink String
UserId String
CalendarId String

Ocorrências de Eventos

Informações de uso para a operação EventOccurrences.rsd.

Informações Específicas da Tabela
Selecione

Você pode consultar EventOccurrences especificando a ID do evento, StartDatetime e EndDateTime. EventId é um campo obrigatório, em vez disso, StartDatetime e EndDateTime têm um intervalo padrão dos últimos 30 dias. Se você consultar a filtragem apenas por EventId e o evento específico não existir nesse intervalo de tempo, obterá resultados vazios.

SELECT * FROM [Ocorrências de eventos] WHERE id='event id' AND StartDateTime='2018/01/01' AND EndDateTime='2018/12/31'

Por padrão, se os filtros StartDateTime e EndDateTime não forem especificados, serão retornadas apenas as ocorrências de eventos do calendário padrão do usuário no intervalo dos últimos 30 dias. Caso contrário, a consultar obterá as Ocorrências do Evento durante o período especificado por StartDateTime e EndDateTime.

Colunas
Nome Tipo Referências Descrição
GroupId String
UserId String
Events_id [KEY] String Eventos.id
id [KEY] String
categories String
changeKey String
createdDateTime Datetime
lastModifiedDateTime Datetime
allowNewTimeProposals Bool
attendees String
body_content String
body_contentType String
bodyPreview String
end_dateTime Datetime
end_timeZone String
hasAttachments Bool
hideAttendees Bool
iCalUId String
importance String
isAllDay Bool
isCancelled Bool
isDraft Bool
isOnlineMeeting Bool
isOrganizer Bool
isReminderOn Bool
location_address_city String
location_address_countryOrRegion String
location_address_postalCode String
location_address_state String
location_address_street String
location_coordinates_accuracy Double
location_coordinates_altitude Double
location_coordinates_altitudeAccuracy Double
location_coordinates_latitude Double
location_coordinates_longitude Double
location_displayName String
location_locationEmailAddress String
location_locationType String
location_locationUri String
location_uniqueId String
location_uniqueIdType String
locations String
onlineMeeting_conferenceId String
onlineMeeting_joinUrl String
onlineMeeting_phones String
onlineMeeting_quickDial String
onlineMeeting_tollFreeNumbers String
onlineMeeting_tollNumber String
onlineMeetingProvider String
onlineMeetingUrl String
organizer_emailAddress_address String
organizer_emailAddress_name String
originalEndTimeZone String
originalStart Datetime
originalStartTimeZone String
recurrence_pattern_dayOfMonth Int
recurrence_pattern_daysOfWeek String
recurrence_pattern_firstDayOfWeek String
recurrence_pattern_index String
recurrence_pattern_interval Int
recurrence_pattern_month Int
recurrence_pattern_type String
recurrence_range_endDate Datetime
recurrence_range_numberOfOccurrences Int
recurrence_range_recurrenceTimeZone String
recurrence_range_startDate Datetime
recurrence_range_type String
reminderMinutesBeforeStart Int
responseRequested Bool
responseStatus_response String
responseStatus_time Datetime
sensitivity String
seriesMasterId String
showAs String
start_dateTime Datetime
start_timeZone String
subject String
transactionId String
type String
webLink String

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 Office 365

Nome Descrição
AssignLicense Adicione ou remova assinaturas para o usuário. Você também pode habilitar e desabilitar planos específicos associados a uma assinatura
CancelEvent Cancela um evento.
CreateFolder Carregue um novo arquivo ou atualize o conteúdo de um arquivo existente.
CreateSchema Cria um arquivo de esquema para a tabela ou exibição especificada.
DownloadAttachments Baixe os anexos de um e-mail
DownloadEmail Baixe o E-mail
DownloadFile Baixe o arquivo
ForwardEvent Encaminhar eventos para destinatários.
ForwardMail Recuperar e-mails encaminhados.
GetAdminConsentURL Obtém a URL de consentimento do administrador que deve ser aberta separadamente por um administrador de um determinado domínio para conceder acesso ao seu aplicativo. Necessário apenas ao usar credenciais OAuth personalizadas.
GetOAuthAccessToken Obtém um token de autenticação do Office365.
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 token de autenticação deste URL.
MoveMail Mover correio.
RefreshOAuthAccessToken Atualiza o token de acesso OAuth usado para autenticação com vários serviços do Office 365.
SendMail Enviar correio.
UploadFile Carregue um novo arquivo ou atualize o conteúdo de um arquivo existente.

Atribuir Licença

Adicione ou remova assinaturas para o usuário. Você também pode ativar e desativar planos específicos associados a uma assinatura

Entrada
Nome Tipo Obrigatório Descrição
UserID String Falso O ID do usuário para o qual a licença precisa ser atribuída. Não alimente se tiver que fazer pelo usuário com o qual está logado.
UserPrincipalName String Falso O Nome Principal do Usuário para o qual a Licença precisa ser atribuída. Não alimente se tiver que fazer pelo usuário com o qual está logado.
AddLicenseSkuId String Falso O identificador exclusivo para o SKU.
DisabledPlans String Falso Uma coleção de identificadores exclusivos separados por vírgulas para planos que foram desativados.
RemoveLicenses String Falso Uma coleção de GUIDs separados por vírgulas que identificam as licenças a serem removidas.
Colunas do Conjunto de Resultados
Nome Tipo Descrição
Status String Procedimento armazenado* Status de Execução

CancelEvento

Cancela um evento.

Entrada
Nome Tipo Obrigatório Descrição
EventId String Verdade ID do evento.
UserId String Falso ID do usuário.
UserPrincipalName String Falso O Nome Principal do Usuário para o qual a Licença precisa ser atribuída. Não alimente se tiver que fazer pelo usuário com o qual está logado.
Comment String Falso Um comentário a incluir. Pode ser uma string vazia.
Colunas do Conjunto de Resultados
Nome Tipo Descrição
Status String Procedimento armazenado* Status de Execução

Criar Pasta

Carregue um novo arquivo ou atualize o conteúdo de um arquivo existente.

Entrada
Nome Tipo Obrigatório Descrição
FolderName String Verdade Nome da pasta a ser criada.
ParentId String Falso ID da pasta onde está o item atual.
Colunas do Conjunto de Resultados
Nome Tipo Descrição
Id String ID do Foler criado.

Criar Esquema

Cria um arquivo de esquema para a tabela ou exibição especificada.

Entrada
Nome Tipo Obrigatório Descrição
TableName String Verdade O nome da tabela ou visualização.
FileName String Verdade O caminho completo do arquivo e o nome do esquema a ser gerado. Ex: 'C:\Usuários\Usuário\Desktop\SmartSheet\sheet.rsd'
Colunas do Conjunto de Resultados
Nome Tipo Descrição
Result String Retorna Sucesso ou Falha.

DownloadAnexos

Baixar os anexos de um e-mail

Entrada
Nome Tipo Obrigatório Descrição
MessageId String Verdade ID do e-mail do qual você deseja obter os anexos.
AttachmentId String Falso ID do anexo que você deseja baixar. Retorna todos os anexos do e-mail se não for especificado.
DownloadTo String Falso Onde guardar os anexos. Se não especificado, retorna os bytes de conteúdo do anexo.
Colunas do Conjunto de Resultados
Nome Tipo Descrição
Id String ID do anexo baixado.
Name String Nome do anexo baixado.
ContentBytes String Conteúdo do anexo.
LastmodifiedDatetime String Data da última modificação do anexo.
ContentType String Tipo de conteúdo do anexo. Se DownloadTo for especificado, este campo será nulo.

Baixar Email

Baixe o E-mail

Entrada
Nome Tipo Obrigatório Descrição
MessageId String Verdade ID da Mensagem que deseja baixar
DownloadTo String Verdade Onde armazenar o arquivo.
Colunas do Conjunto de Resultados
Nome Tipo Descrição
Status String Procedimento armazenado* Status de Execução

⇬ Fazer Download do Arquivo

Baixe o arquivo

Entrada
Nome Tipo Obrigatório Descrição
FileId String Verdade ID do arquivo que deseja baixar
DownloadTo String Verdade Onde armazenar o arquivo.
Colunas do Conjunto de Resultados
Nome Tipo Descrição
Status String Procedimento armazenado* Status de Execução

ForwardEvent

Encaminhar eventos para destinatários.

Entrada
Nome Tipo Obrigatório Descrição
EventId String Verdade ID do evento.
ToRecipients String Verdade Uma lista separada por ponto-e-vírgula de e-mails de destinatários.
UserId String Falso ID do usuário.
UserPrincipalName String Falso O Nome Principal do Usuário para o qual a Licença precisa ser atribuída. Não alimente se tiver que fazer pelo usuário com o qual está logado.
Comment String Falso Um comentário a incluir. Pode ser uma string vazia.
Colunas do Conjunto de Resultados
Nome Tipo Descrição
Status String Procedimento armazenado* Status de Execução

ForwardMail

Recuperar e-mails encaminhados.

Entrada
Nome Tipo Obrigatório Descrição
MessageId String Verdade ID do e-mail.
ToRecipients String Verdade Uma lista separada por ponto-e-vírgula de e-mails de destinatários.
Comment String Falso BodyContent na parte superior da mensagem original.
Colunas do Conjunto de Resultados
Nome Tipo Descrição
Id String ID de e-mail encaminhado.

GetAdminConsentURL

Obtém a URL de consentimento do administrador que deve ser aberta separadamente por um administrador de um determinado domínio para conceder acesso ao seu aplicativo. Necessário apenas ao usar credenciais OAuth personalizadas.

Entrada
Nome Tipo Obrigatório Descrição
CallbackUrl String Falso A URL para a qual o usuário será redirecionado após autorizar seu aplicativo. Esse valor deve corresponder à URL de resposta nas configurações do aplicativo Azure AD.
State String Falso O mesmo valor para o estado que você enviou quando solicitou o código de autorização.
Scope String Falso Uma lista separada por espaços de permissões a serem solicitadas ao administrador. O valor padrão é *offline_access https://graph.microsoft.com/group.read.all https://graph.microsoft.com/group.readwrite.all https://graph.microsoft.com/user.read https://graph.microsoft.com/user.readwrite.all https://graph.microsoft.com/calendars.readwrite https://graph.microsoft.com/contacts.readwrite https://graph.microsoft.com/mail.readwrite*.
Colunas do Conjunto de Resultados
Nome Tipo Descrição
URL String O URL de autorização, inserido em um navegador da Web para obter o token do verificador e autorizar seu aplicativo.

GetOAuthAccessToken

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

Entrada
Nome Tipo Obrigatório Descrição
AuthMode String Falso O tipo de modo de autenticação a ser usado. Selecione App para obter tokens de autenticação por meio de um aplicativo de desktop. Selecione Web para obter tokens de autenticação por meio de um aplicativo Web. Os valores permitidos são APP, WEB. O valor padrão é APP.
CallbackUrl String Falso A URL para a qual o usuário será redirecionado após autorizar seu aplicativo. Esse valor deve corresponder à URL de resposta que você especificou nas configurações do aplicativo Azure AD.
Verifier String Falso O verificador retornou do Azure AD depois que o usuário autorizou seu aplicativo a ter acesso aos dados dele. Esse valor será retornado como um parâmetro para a URL de retorno de chamada.
State String Falso Uma string arbitrária de sua escolha que é retornada ao seu aplicativo; uma ida e volta bem-sucedida dessa string ajuda a garantir que seu aplicativo iniciou a solicitação.
Scope String Falso Uma lista separada por espaços de permissões a serem solicitadas ao usuário quando OAuthGrantType='CODE'. Verifique a API do Microsoft Graph para obter uma lista de permissões disponíveis. Quando OAuthGrantType='CLIENT', um escopo de 'https://graph.microsoft.com/.default' é usado. '/.default' seleciona todas as permissões que seu aplicativo já possui. O valor padrão é *offline_access https://graph.microsoft.com/group.read.all https://graph.microsoft.com/group.readwrite.all https://graph.microsoft.com/user.read https://graph.microsoft.com/user.readwrite.all https://graph.microsoft.com/calendars.readwrite https://graph.microsoft.com/contacts.readwrite https://graph.microsoft.com/mail.readwrite*.
Prompt String Falso O padrão é 'select_account', que solicita que o usuário selecione a conta durante a autenticação. Defina como 'Nenhum', para nenhum prompt, 'login' para forçar o usuário a inserir suas credenciais ou 'consentimento' para acionar a caixa de diálogo de consentimento OAuth depois que o usuário entrar, solicitando que ele conceda permissões ao aplicativo.
Colunas do Conjunto de Resultados
Nome Tipo Descrição
OAuthAccessToken String O token de acesso usado para comunicação com o Office365.
ExpiresIn String O tempo de vida restante no token de acesso. Um -1 denota que não irá expirar.
OAuthRefreshToken String Atualizar token para renovar o token de acesso.

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 token de autenticação deste URL.

Entrada
Nome Tipo Obrigatório Descrição
CallbackUrl String Falso A URL para a qual o usuário será redirecionado após autorizar seu aplicativo. Esse valor deve corresponder à URL de resposta nas configurações do aplicativo Azure AD.
State String Falso O mesmo valor para o estado que você enviou quando solicitou o código de autorização.
Scope String Falso Uma lista separada por espaços de permissões a serem solicitadas ao usuário quando OAuthGrantType='CODE'. Verifique a API do Microsoft Graph para obter uma lista de permissões disponíveis. Quando OAuthGrantType='CLIENT', um escopo de 'https://graph.microsoft.com/.default' é usado. '/.default' seleciona todas as permissões que seu aplicativo já possui. O valor padrão é *offline_access https://graph.microsoft.com/group.read.all https://graph.microsoft.com/group.readwrite.all https://graph.microsoft.com/user.read https://graph.microsoft.com/user.readwrite.all https://graph.microsoft.com/calendars.readwrite https://graph.microsoft.com/contacts.readwrite https://graph.microsoft.com/mail.readwrite*.
Prompt String Falso O padrão é 'select_account', que solicita que o usuário selecione a conta durante a autenticação. Defina como 'Nenhum' para nenhum prompt, 'login' para forçar o usuário a inserir suas credenciais ou 'consentimento' para acionar a caixa de diálogo de consentimento OAuth depois que o usuário entrar, solicitando que ele conceda permissões ao aplicativo.
Colunas do Conjunto de Resultados
Nome Tipo Descrição
URL String O URL de autorização, inserido em um navegador da Web para obter o token do verificador e autorizar seu aplicativo.

MoveMail

Mover correio.

Entrada
Nome Tipo Obrigatório Descrição
MessageId String Verdade A identificação e-mail.
DestinationId String Verdade ID da pasta de destino para onde o e-mail será movido.
Colunas do Conjunto de Resultados
Nome Tipo Descrição
Id String ID de e-mail movido.

RefreshOAuthAccessToken

Atualiza o token de acesso OAuth usado para autenticação com vários serviços do Office 365.

Entrada
Nome Tipo Obrigatório Descrição
OAuthRefreshToken String Verdade O token de atualização retornado da troca do código de autorização original.
Colunas do Conjunto de Resultados
Nome Tipo Descrição
OAuthAccessToken String O token de autenticação retornado do Azure AD. Isso pode ser usado em chamadas subseqüentes para outras operações para este serviço específico.
OAuthRefreshToken String Um token que pode ser usado para obter um novo token de acesso.
ExpiresIn String O tempo de vida restante no token de acesso.

Enviar Correio

Enviar correio.

Entrada
Nome Tipo Obrigatório Descrição
Id String Falso O ID da mensagem a ser enviada (isso é opcional). O usuário pode usar um ID e-mail existente ou enviar um novo e-mail opcionalmente preenchendo os outros campos.
Subject String Falso O assunto e-mail.
Content String Falso Conteúdo do corpo E-mail.
Attachments String Falso Os anexos. Especifique os anexos de arquivo no seguinte formato: filename1, filecontent1;filename2, filecontent2. Cada conteúdo de arquivo pode ser dados base64 ou o caminho de um arquivo local com o caractere @ antes dele
FileName String Falso Nome do anexo e-mail.
LocalFile String Falso O arquivo contendo o conteúdo do anexo
ContentBytes String Falso Conteúdo do anexo codificado na base 64.
ToRecipients String Falso Os destinatários. Especifique os destinatários na seguinte ordem: person1@example.com;person2@example.com.
CCRecipients String Falso Os destinatários CC. Especifique os destinatários na seguinte ordem: person1@example.com;person2@example.com.
SenderEmail String Falso O endereço e-mail em nome de quem e-mail precisa ser enviado. Defina isso se quiser enviar e-mail em nome da conta de outro usuário.
FromEmail String Falso O endereço e-mail do usuário do qual e-mail precisa ser enviado. Defina isso se quiser enviar e-mail da conta de outro usuário.
ContentType String Falso O tipo de conteúdo do corpo e-mail. Os valores permitidos são texto, html. O valor padrão é texto.

Subir Arquivo

Carregue um novo arquivo ou atualize o conteúdo de um arquivo existente.

Entrada
Nome Tipo Obrigatório Descrição
FileName String Verdade Nome do arquivo para o qual você precisa carregar o conteúdo. Especifique-o apenas se você já tiver um arquivo existente.
ParentId String Verdade ID da pasta onde está o item atual.
Content String Falso Conteúdo do arquivo a ser carregado.
LocalFile String Falso Arquivo local contendo o conteúdo a ser carregado.
Colunas do Conjunto de Resultados
Nome Tipo Descrição
Id String ID do arquivo carregado.
\* String Resultados do upload do arquivo.

Tabelas do Sistema

Você pode consultar as tabelas do sistema descritas nesta seção para acessar informações de esquema, informações sobre a funcionalidade da fonte de dados e estatísticas de operação em lote.

Tabelas de Esquema

As tabelas a seguir retornam metadados de banco de dados para o Office 365:

Tabelas de Fonte de Dados

As tabelas a seguir retornam informações sobre como se conectar e consultar a fonte de dados:

  • sys_connection_props: Retorna informações sobre as propriedades de conexão disponíveis.
  • sys_sqlinfo: Descreve as consultas SELECT que o conector pode descarregar para a fonte de dados.

Consultar Tabelas de Informações

A tabela a seguir retorna estatísticas de consultar para consultas de modificação de dados:

  • sys_identity: Retorna informações sobre operações em lote ou atualizações únicas.

Sys_catalogs

Lista os bancos de dados disponíveis.

A consultar a seguir recupera todos os bancos de dados determinados pela string de conexão:

SELECT * FROM sys_catalogs
Colunas
Nome Tipo Descrição
CatalogName String O nome do banco de dados.

Sys_schemas

Lista os esquemas disponíveis.

A consultar a seguir recupera todos os esquemas disponíveis:

SELECT * FROM sys_schemas
Colunas
Nome Tipo Descrição
CatalogName String O nome do banco de dados.
SchemaName String O nome do esquema.

Sys_tables

Lista as tabelas disponíveis.

A consultar a seguir recupera as tabelas e exibições disponíveis:

SELECT * FROM sys_tables
Colunas
Nome Tipo Descrição
CatalogName String O banco de dados que contém a tabela ou exibição.
SchemaName String O esquema que contém a tabela ou exibição.
TableName String O nome da tabela ou exibição.
TableType String O tipo de tabela (tabela ou exibição).
Description String Uma descrição da tabela ou visualização.
IsUpdateable Boolean Se a tabela pode ser atualizada.

Sys_tablecolumns

Descreve as colunas das tabelas e exibições disponíveis.

A consultar a seguir retorna as colunas e os tipos de dados da tabela Eventos:

SELECT ColumnName, DataTypeName FROM sys_tablecolumns WHERE TableName='Events' 
Colunas
Nome Tipo Descrição
CatalogName String O nome do banco de dados que contém a tabela ou exibição.
SchemaName String O esquema que contém a tabela ou exibição.
TableName String O nome da tabela ou exibição que contém a coluna.
ColumnName String O nome da coluna.
DataTypeName String O nome do tipo de dados.
DataType Int32 Um número inteiro indicando o tipo de dados. Esse valor é determinado no tempo de execução com base no ambiente.
Length Int32 O tamanho de armazenamento da coluna.
DisplaySize Int32 A largura máxima normal da coluna designada em caracteres.
NumericPrecision Int32 O número máximo de dígitos em dados numéricos. O comprimento da coluna em caracteres para caracteres e dados de data e hora.
NumericScale Int32 A escala da coluna ou o número de dígitos à direita do ponto decimal.
IsNullable Boolean Se a coluna pode conter null.
Description String Uma breve descrição da coluna.
Ordinal Int32 O número de sequência da coluna.
IsAutoIncrement String Se o valor da coluna é atribuído em incrementos fixos.
IsGeneratedColumn String Se a coluna é gerada.
IsHidden Boolean Se a coluna está oculta.
IsArray Boolean Se a coluna é uma matriz.

Sys_procedures

Lista os procedimentos armazenados disponíveis.

A consultar a seguir recupera os procedimentos armazenados disponíveis:

SELECT * FROM sys_procedures
Colunas
Nome Tipo Descrição
CatalogName String O banco de dados que contém o procedimento armazenado.
SchemaName String O esquema que contém o procedimento armazenado.
ProcedureName String O nome do procedimento armazenado.
Description String Uma descrição do procedimento armazenado.
ProcedureType String O tipo do procedimento, como PROCEDURE ou FUNCTION.

Sys_procedureparameters

Descreve procedimento armazenado* parâmetros.

A consultar a seguir retorna informações sobre todos os parâmetros de entrada para o procedimento armazenado SendMail:

SELECT * FROM sys_procedureparameters WHERE ProcedureName='SendMail' AND Direction=1 OR Direction=2
Colunas
Nome Tipo Descrição
CatalogName String O nome do banco de dados que contém o procedimento armazenado.
SchemaName String O nome do esquema que contém o procedimento armazenado.
ProcedureName String O nome do procedimento armazenado* contendo o parâmetro.
ColumnName String O nome do procedimento armazenado* parâmetro.
Direction Int32 Um número inteiro correspondente ao tipo do parâmetro: entrada (1), entrada/saída (2) ou saída (4). parâmetros de tipo de entrada/saída podem ser parâmetros de entrada e saída.
DataTypeName String O nome do tipo de dados.
DataType Int32 Um inteiro indicando o tipo de dados. Esse valor é determinado no tempo de execução com base no ambiente.
Length Int32 O número de caracteres permitido para dados de caractere. O número de dígitos permitidos para dados numéricos.
NumericPrecision Int32 A precisão máxima para dados numéricos. O comprimento da coluna em caracteres para caracteres e dados de data e hora.
NumericScale Int32 O número de dígitos à direita do ponto decimal em dados numéricos.
IsNullable Boolean Se o parâmetro pode conter null.
IsRequired Boolean Se o parâmetro é necessário para a execução do procedimento.
IsArray Boolean Se o parâmetro é uma matriz.
Description String A descrição do parâmetro.
Ordinal Int32 O índice do parâmetro.

Sys_keycolumns

Descreve as chaves primárias e estrangeiras. A consultar a seguir recupera a chave primária da tabela Eventos:

SELECT * FROM sys_keycolumns WHERE IsKey='True' AND TableName='Events'
Colunas
Nome Tipo Descrição
CatalogName String O nome do banco de dados que contém a chave.
SchemaName String O nome do esquema que contém a chave.
TableName String O nome da tabela que contém a chave.
ColumnName String O nome da coluna chave.
IsKey Boolean Se a coluna é uma chave primária na tabela referenciada no campo TableName.
IsForeignKey Boolean Se a coluna é uma chave estrangeira referenciada no campo TableName.
PrimaryKeyName String O nome da chave primária.
ForeignKeyName String O nome da chave estrangeira.
ReferencedCatalogName String O banco de dados que contém a chave primária.
ReferencedSchemaName String O esquema que contém a chave primária.
ReferencedTableName String A tabela que contém a chave primária.
ReferencedColumnName String O nome da coluna da chave primária.

Sys_foreignkeys

Descreve as chaves estrangeiras. A consultar a seguir recupera todas as chaves estrangeiras que se referem a outras tabelas:

SELECT * FROM sys_foreignkeys WHERE ForeignKeyType = 'FOREIGNKEY_TYPE_IMPORT'
Colunas
Nome Tipo Descrição
CatalogName String O nome do banco de dados que contém a chave.
SchemaName String O nome do esquema que contém a chave.
TableName String O nome da tabela que contém a chave.
ColumnName String O nome da coluna chave.
PrimaryKeyName String O nome da chave primária.
ForeignKeyName String O nome da chave estrangeira.
ReferencedCatalogName String O banco de dados que contém a chave primária.
ReferencedSchemaName String O esquema que contém a chave primária.
ReferencedTableName String A tabela que contém a chave primária.
ReferencedColumnName String O nome da coluna da chave primária.
ForeignKeyType String Designa se a chave estrangeira é uma chave de importação (aponta para outras tabelas) ou de exportação (referenciada de outras tabelas).

Sys_indexes

Descreve os índices disponíveis. Ao filtrar por índices, você pode escrever consultas mais seletivas com tempos de resposta de consultar mais rápidos.

A consultar a seguir recupera todos os índices que não são chaves primárias:

SELECT * FROM sys_indexes WHERE IsPrimary='false'
Colunas
Nome Tipo Descrição
CatalogName String O nome do banco de dados que contém o índice.
SchemaName String O nome do esquema que contém o índice.
TableName String O nome da tabela que contém o índice.
IndexName String O nome do índice.
ColumnName String O nome da coluna associada ao índice.
IsUnique Boolean True se o índice for exclusivo. Falso caso contrário.
IsPrimary Boolean Verdadeiro se o índice for uma chave primária. Falso caso contrário.
Type Int16 Um valor inteiro correspondente ao tipo de índice: estatística (0), agrupado (1), hash (2) ou outro (3).
SortOrder String A ordem de classificação: A para crescente ou D para decrescente.
OrdinalPosition Int16 O número de sequência da coluna no índice.

Sys_connection_props

Retorna informações sobre as propriedades de conexão disponíveis e as definidas na string de conexão.

Ao consultar esta tabela, a string de conexão de configuração deve ser usada:

jdbc:cdata:office365:config:

Esta string de conexão permite que você consultar esta tabela sem uma conexão válida.

A consultar a seguir recupera todas as propriedades de conexão que foram definidas na string de conexão ou definidas por meio de um valor padrão:

SELECT * FROM sys_connection_props WHERE Value <> ''
Colunas
Nome Tipo Descrição
Name String O nome da propriedade de conexão.
ShortDescription String Uma breve descrição.
Type String O tipo de dados da propriedade de conexão.
Default String O valor padrão, se não houver um definido explicitamente.
Values String Uma lista separada por vírgulas de valores possíveis. Um erro de validação é lançado se outro valor for especificado.
Value String O valor que você definiu ou um padrão pré-configurado.
Required Boolean Se a propriedade é necessária para se conectar.
Category String A categoria da propriedade de conexão.
IsSessionProperty String Se a propriedade é uma propriedade de sessão, usada para salvar informações sobre a conexão atual.
Sensitivity String O nível de sensibilidade da propriedade. Isso informa se a propriedade está ofuscada nos formulários de registro e autenticação.
PropertyName String Uma forma truncada em camel case do nome da propriedade de conexão.
Ordinal Int32 O índice do parâmetro.
CatOrdinal Int32 O índice da categoria do parâmetro.
Hierarchy String Mostra as propriedades dependentes associadas que precisam ser definidas juntamente com esta.
Visible Boolean Informa se a propriedade está visível na UI da conexão.
ETC String Diversas informações diversas sobre o imóvel.

Sys_sqlinfo

Descreve o processamento da consultar SELECT que o conector pode transferir para a fonte de dados.

Processamento de Consultas Colaborativas

Ao trabalhar com fontes de dados que não suportam SQL-92, você pode consultar a exibição sys_sqlinfo para determinar os recursos de consultar das APIs subjacentes, expressas na sintaxe SQL. O conector transfere o máximo possível do processamento da instrução SELECT para o servidor e, em seguida, processa o restante da consultar na memória.

Descobrindo os Recursos SELECT da Fonte de Dados

Abaixo está um exemplo de conjunto de dados de recursos SQL. O conjunto de resultados a seguir indica a funcionalidade SELECT que o conector pode descarregar para a fonte de dados ou processar o lado do cliente. Sua fonte de dados pode suportar sintaxe SQL adicional. Alguns aspectos da funcionalidade SELECT são retornados em uma lista separada por vírgulas, se suportados; caso contrário, a coluna contém NO.

Nome Descrição Valores Possíveis
AGGREGATE_FUNCTIONS Funções de agregação suportadas. AVG, COUNT, MAX, MIN, SUM, DISTINCT
COUNT Se a função COUNT é suportada. YES, NO
IDENTIFIER_QUOTE_OPEN_CHAR O caractere de abertura usado para escapar de um identificador. [
IDENTIFIER_QUOTE_CLOSE_CHAR O caractere de fechamento usado para escapar de um identificador. ]
SUPPORTED_OPERATORS Uma lista de operadores SQL com suporte. =, >, <, >=, <=, <>, !=, LIKE, NOT LIKE, IN, NOT IN, IS NULL, IS NOT NULL, AND, OR
GROUP_BY Se GROUP BY é compatível e, em caso afirmativo, o grau de suporte. NO, NO_RELATION, EQUALS_SELECT, SQL_GB_COLLATE
STRING_FUNCTIONS Funções de string suportadas. LENGTH, CHAR, LOCATE, REPLACE, SUBSTRING, RTRIM, LTRIM, RIGHT, LEFT, UCASE, SPACE, SOUNDEX, LCASE, CONCAT, ASCII, REPEAT, OCTET, BIT, POSITION, INSERT, TRIM, UPPER, REGEXP, LOWER, DIFFERENCE, CHARACTER, SUBSTR, STR, REVERSE, PLAN, UUIDTOSTR, TRANSLATE, TRAILING, TO, STUFF, STRTOUUID, STRING, SPLIT, SORTKEY, SIMILAR, REPLICATE, PATINDEX, LPAD, LEN, LEADING, KEY, INSTR, INSERTSTR, HTML, GRAPHICAL, CONVERT, COLLATION, CHARINDEX, BYTE
NUMERIC_FUNCTIONS Funções numéricas suportadas. ABS, ACOS, ASIN, ATAN, ATAN2, CEILING, COS, COT, EXP, FLOOR, LOG, MOD, SIGN, SIN, SQRT, TAN, PI, RAND, DEGREES, LOG10, POWER, RADIANS, ROUND, TRUNCATE
TIMEDATE_FUNCTIONS Funções de data/hora suportadas. NOW, CURDATE, DAYOFMONTH, DAYOFWEEK, DAYOFYEAR, MONTH, QUARTER, WEEK, YEAR, CURTIME, HOUR, MINUTE, SECOND, TIMESTAMPADD, TIMESTAMPDIFF, DAYNAME, MONTHNAME, CURRENT_DATE, CURRENT_TIME, CURRENT_TIMESTAMP, EXTRACT
REPLICATION_SKIP_TABLES Indica tabelas ignoradas durante a replicação.
REPLICATION_TIMECHECK_COLUMNS Uma matriz de string contendo uma lista de colunas que serão usadas para verificar (na ordem especificada) para usar como uma coluna modificada durante a replicação.
IDENTIFIER_PATTERN Valor de string que indica qual string é válida para um identificador.
SUPPORT_TRANSACTION Indica se o provedor oferece suporte a transações como confirmação e reversão. YES, NO
DIALECT Indica o dialeto SQL a ser usado.
KEY_PROPERTIES Indica as propriedades que identificam o banco de dados uniforme.
SUPPORTS_MULTIPLE_SCHEMAS Indica se vários esquemas podem existir para o provedor. YES, NO
SUPPORTS_MULTIPLE_CATALOGS Indica se vários catálogos podem existir para o provedor. YES, NO
DATASYNCVERSION A versão do Data Sync necessária para acessar este driver. Standard, Starter, Professional, Enterprise
DATASYNCCATEGORY A categoria Data Sync deste driver. Source, Destination, Cloud Destination
SUPPORTSENHANCEDSQL Se a funcionalidade SQL aprimorada além do que é oferecido pela API é suportada. TRUE, FALSE
SUPPORTS_BATCH_OPERATIONS Se as operações em lote são suportadas. YES, NO
SQL_CAP Todos os recursos SQL suportados para este driver. SELECT, INSERT, DELETE, UPDATE, TRANSACTIONS, ORDERBY, OAUTH, ASSIGNEDID, LIMIT, LIKE, BULKINSERT, COUNT, BULKDELETE, BULKUPDATE, GROUPBY, HAVING, AGGS, OFFSET, REPLICATE, COUNTDISTINCT, JOINS, DROP, CREATE, DISTINCT, INNERJOINS, SUBQUERIES, ALTER, MULTIPLESCHEMAS, GROUPBYNORELATION, OUTERJOINS, UNIONALL, UNION, UPSERT, GETDELETED, CROSSJOINS, GROUPBYCOLLATE, MULTIPLECATS, FULLOUTERJOIN, MERGE, JSONEXTRACT, BULKUPSERT, SUM, SUBQUERIESFULL, MIN, MAX, JOINSFULL, XMLEXTRACT, AVG, MULTISTATEMENTS, FOREIGNKEYS, CASE, LEFTJOINS, COMMAJOINS, WITH, LITERALS, RENAME, NESTEDTABLES, EXECUTE, BATCH, BASIC, INDEX
PREFERRED_CACHE_OPTIONS Um valor de string especifica o cacheOptions preferencial.
ENABLE_EF_ADVANCED_QUERY Indica se o driver oferece suporte direto a consultas avançadas provenientes do Entity Framework. Caso contrário, as consultas serão tratadas no lado do cliente. YES, NO
PSEUDO_COLUMNS Uma matriz de cadeia de caracteres que indica as pseudocolunas disponíveis.
MERGE_ALWAYS Se o valor for verdadeiro, o modo de mesclagem será executado à força no Data Sync. TRUE, FALSE
REPLICATION_MIN_DATE_QUERY Uma consultar de seleção para retornar a data e hora de início da replicação.
REPLICATION_MIN_FUNCTION Permite que um provedor especifique o nome da fórmula a ser usado para executar um min do lado do servidor.
REPLICATION_START_DATE Permite que um provedor especifique uma data de início de replicação.
REPLICATION_MAX_DATE_QUERY Uma consultar de seleção para retornar a data e hora de término da replicação.
REPLICATION_MAX_FUNCTION Permite que um provedor especifique o nome da fórmula a ser usado para executar um máximo do lado do servidor.
IGNORE_INTERVALS_ON_INITIAL_REPLICATE Uma lista de tabelas que ignorará a divisão da replicação em blocos na replicação inicial.
CHECKCACHE_USE_PARENTID Indica se a instrução CheckCache deve ser executada na coluna de chave pai. TRUE, FALSE
CREATE_SCHEMA_PROCEDURES Indica procedimentos armazenados* que pode ser usado para gerar arquivos de esquema.

A consultar a seguir recupera os operadores que podem ser usados na cláusula WHERE:

SELECT * FROM sys_sqlinfo WHERE Name='SUPPORTED_OPERATORS'

Observe que tabelas individuais podem ter diferentes limitações ou requisitos na cláusula WHERE; consulte o Modelo de Dados para obter mais informações.

Colunas
Nome Tipo Descrição
NAME String Um componente da sintaxe SQL ou um recurso que pode ser processado no servidor.
VALUE String Detalhes sobre a sintaxe SQL ou SQL suportada.

Sys_identity

Retorna informações sobre tentativas de modificação.

A consultar a seguir recupera os IDs das linhas modificadas em uma operação em lote:

SELECT * FROM sys_identity
Colunas
Nome Tipo Descrição
Id String O ID gerado pelo banco de dados retornado de uma operação de modificação de dados.
Batch String Um identificador para o lote. 1 para uma única operação.
Operation String O resultado da operação no lote: INSERTED, UPDATED ou DELETED.
Message String SUCCESS ou uma mensagem de erro se a atualização no lote falhou.

Mapeamento de Tipo de Dados

Mapeamentos de Tipo de Dados

O conector mapeia os tipos da fonte de dados para o tipo de dados correspondente disponível no esquema. A tabela abaixo documenta esses mapeamentos.

Office 365 (OData V4) Esquema
Edm.Binary binário
Edm.Boolean bool
Edm.Date data e hora
Edm.DateTimeOffset data e hora
Edm.Decimal decimal
Edm.Double duplo
Edm.Guid guia
Edm.Int32 int
Edm.String cadeia
Edm.TimeOfDay tempo

Propriedades de Configurações Avançadas

As propriedades de configurações avançadas são as várias opções que podem ser usadas para estabelecer uma conexão. Esta seção fornece uma lista completa das opções que você pode configurar. Clique nos links para mais detalhes.

Autenticação

Propriedade Descrição
AuthScheme O tipo de autenticação a ser usado ao conectar-se ao Microsoft Office 365.

Autenticação do Azure

Propriedade Descrição
AzureTenant O locatário do Microsoft Online sendo usado para acessar dados. Se não for especificado, seu tentante padrão será usado.
AzureEnvironment O ambiente do Azure a ser usado ao estabelecer uma conexão.

OAuth

Propriedade Descrição
InitiateOAuth Configure esta propriedade para iniciar o processo para obter ou atualizar o token de acesso OAuth ao se conectar.
OAuthClientId O ID do cliente atribuído quando você registra seu aplicativo com um servidor de autorização OAuth.
OAuthClientSecret O segredo do cliente atribuído quando você registra seu aplicativo com um servidor de autorização OAuth.
OAuthGrantType O tipo de concessão para o fluxo OAuth.

SSL

Propriedade Descrição
SSLServerCert O certificado a ser aceito do servidor ao conectar usando TLS/SSL.

Exploração madeireira

Propriedade Descrição
Logfile Um caminho de arquivo que designa o nome e a localização do arquivo de log.
Verbosity O nível de detalhamento que determina a quantidade de detalhes incluídos no arquivo de log.
LogModules Módulos principais a serem incluídos no arquivo de log.
MaxLogFileSize Uma string especificando o tamanho máximo em bytes para um arquivo de log (por exemplo, 10 MB).
MaxLogFileCount Uma string especificando a contagem máxima de arquivos de log.

Esquema

Propriedade Descrição
Location Um caminho para o diretório que contém os arquivos de esquema que definem tabelas, exibições e procedimentos armazenados.
BrowsableSchemas Essa propriedade restringe os esquemas relatados a um subconjunto dos esquemas disponíveis. Por exemplo, BrowsableSchemas=SchemaA, SchemaB, SchemaC.
Tables Esta propriedade restringe as tabelas reportadas a um subconjunto das tabelas disponíveis. Por exemplo, Tables=TableA, TableB, TableC.
Views Restringe as visualizações relatadas a um subconjunto das tabelas disponíveis. Por exemplo, Views=ViewA, ViewB, ViewC.

Diversos

Propriedade Descrição
AllowDuplicateRecords Indica se o driver deve verificar as regras de detecção de duplicatas configuradas.
IncludeFormattedValues Indica se as colunas que contêm valores formatados devem ser expostas.
IncludeNavigationProperties Um booleano que indica se as propriedades de navegação devem ser incluídas na listagem de colunas.
MaxRows Limita o número de linhas retornadas quando nenhuma agregação ou agrupamento é usado na consultar. Isso ajuda a evitar problemas de desempenho em tempo de design.
Other Essas propriedades ocultas são usadas apenas em casos de uso específicos.
Pagesize O número máximo de resultados a serem retornados por página do Microsoft Office 365.
PseudoColumns Esta propriedade indica se deve ou não incluir pseudocolunas como colunas na tabela.
Timeout O valor em segundos até que o erro de timeout seja lançado, cancelando a operação.

Autenticação

Esta seção fornece uma lista completa de propriedades de autenticação que você pode configurar.

Propriedade Descrição
AuthScheme O tipo de autenticação a ser usado ao se conectar ao Office 365. Voltar para o início

AuthScheme

O tipo de autenticação a ser usado ao conectar-se ao Microsoft Office 365. Atualmente, apenas AzureServicePrincipal é suportado

Valores Possíveis

AzureServicePrincipal

Tipo de Dados

string

Valor Padrão

"AzureServicePrincipal"

Observações
  • AzureServicePrincipal: defina isso para autenticar como uma Entidade de Serviço do Azure.

Autenticação do Azure

Esta seção fornece uma lista completa das propriedades de autenticação do Azure que você pode configurar.

Propriedade Descrição
AzureTenant O locatário do Microsoft Online sendo usado para acessar dados. Se não for especificado, seu tentante padrão será usado.
AzureEnvironment O ambiente do Azure a ser usado ao estabelecer uma conexão.

AzureTenant

O locatário do Microsoft Online sendo usado para acessar dados. Se não for especificado, seu tentante padrão será usado.

Tipo de Dados

string

Valor Padrão

""

Observações

O locatário do Microsoft Online sendo usado para acessar dados. Por exemplo, "example.onmicrosoft.com". Como alternativa, especifique o ID do locatário. Esse valor é a ID do diretório no Portal do Azure > Azure Active Directory > Propriedades.

Normalmente não é necessário especificar o inquilino. Isso pode ser determinado automaticamente pela Microsoft ao usar o OAuthGrantType definido como CODE (padrão). No entanto, pode falhar caso o usuário pertença a vários locatários. Por exemplo, se um administrador do domínio A convidar um usuário do domínio B para ser um usuário convidado. O usuário agora pertencerá a ambos os locatários. É uma boa prática especificar o inquilino, embora em geral as coisas funcionem normalmente sem ter que especificá-lo.

O AzureTenant é necessário ao definir OAuthGrantType ao CLIENTE. Ao usar credenciais de cliente, não há contexto de usuário. As credenciais são obtidas do contexto do próprio aplicativo. Embora a Microsoft ainda permita que as credenciais do cliente sejam obtidas sem especificar qual locatário, ela tem uma probabilidade muito menor de escolher o locatário específico com o qual deseja trabalhar. Por este motivo, exigimos AzureTenant a ser declarado explicitamente para todas as conexões de credenciais do cliente para garantir que você obtenha credenciais aplicáveis ao domínio ao qual pretende se conectar.

Ambiente Azure

O ambiente do Azure a ser usado ao estabelecer uma conexão.

Valores Possíveis

GLOBAL, CHINA, GERMANY, USGOVT, USGOVTDOD

Tipo de Dados

string

Valor Padrão

"GLOBAL"

Observações

Na maioria dos casos, deixar o ambiente definido como global funcionará. No entanto, se sua conta do Azure tiver sido adicionada a um ambiente diferente, o AzureEnvironment pode ser usado para especificar qual ambiente. Os valores disponíveis são GLOBAL, CHINA, GERMANY, USGOVT e USGOVTDOD.

OAuth

Esta seção fornece uma lista completa de propriedades OAuth que você pode configurar.

Propriedade Descrição
InitiateOAuth Configure esta propriedade para iniciar o processo para obter ou atualizar o token de acesso OAuth ao se conectar.
OAuthClientId O ID do cliente atribuído quando você registra seu aplicativo com um servidor de autorização OAuth.
OAuthClientSecret O segredo do cliente atribuído quando você registra seu aplicativo com um servidor de autorização OAuth.
OAuthGrantType O tipo de concessão para o fluxo OAuth.

InitiateOAuth

Configure esta propriedade para iniciar o processo para obter ou atualizar o token de acesso OAuth ao se conectar.

Valores Possíveis

GETANDREFRESH

Tipo de Dados

string

Valor Padrão

"GETANDREFRESH"

Observações

A seguinte opção é suportada:

  • GETANDREFRESH: Indica que todo o fluxo OAuth será tratado pelo conector. Se nenhum token existir atualmente, ele será obtido. Se existir um token, ele será atualizado quando aplicável.

OAuthVersion

A versão do OAuth que está sendo usada.

Valores Possíveis

1.0, 2.0

Tipo de Dados

string

Valor Padrão

"2.0"

Observações

A versão do OAuth que está sendo usada. As seguintes opções estão disponíveis: 1.0,2.0

OAuthClientId

O ID do cliente atribuído quando você registra seu aplicativo com um servidor de autorização OAuth.

Tipo de Dados

string

Valor Padrão

""

Observações

Como parte do registro de um aplicativo OAuth, você receberá o OAuthClientId valor, às vezes também chamado de chave do consumidor e segredo do cliente, o OAuthClientSecret.

OAuthClientSecret

O segredo do cliente atribuído quando você registra seu aplicativo com um servidor de autorização OAuth.

Tipo de Dados

string

Valor Padrão

""

Observações

Como parte do registro de um aplicativo OAuth, você receberá o segredo do cliente, também chamado de segredo do consumidor. Defina o segredo do cliente como OAuthClientSecret propriedade.

Você também receberá um OAuthClientId, também chamada de chave do consumidor.

OAuthAccessToken

O token de acesso para conexão usando OAuth.

Tipo de Dados

string

Valor Padrão

""

Observações

O OAuthAccessToken propriedade é usada para conectar usando OAuth. O OAuthAccessToken é recuperado do servidor OAuth como parte do processo de autenticação. Ele tem um tempo limite dependente do servidor e pode ser reutilizado entre as solicitações.

O token de acesso é usado no lugar do seu nome de usuário e senha. O token de acesso protege suas credenciais, mantendo-as no servidor.

URL de Retorno

O URL de retorno de chamada OAuth ao qual retornar durante a autenticação. Esse valor deve corresponder ao URL de retorno especificado nas configurações do aplicativo.

Tipo de Dados

string

Valor Padrão

""

Observações

Durante o processo de autenticação, o servidor de autorização OAuth redireciona o usuário para esta URL. Esse valor deve corresponder ao URL de retorno especificado nas configurações do aplicativo.

OAuthGrantType

O tipo de concessão para o fluxo OAuth.

Valores Possíveis

CLIENT

Tipo de Dados

string

Valor Padrão

"CLIENT"

Observações

O tipo de concessão para o fluxo OAuth. Apenas o CLIENT opção é suportada.

OAuthAuthorizationURL

A URL de autorização para o serviço OAuth.

Tipo de Dados

string

Valor Padrão

""

Observações

A URL de autorização para o serviço OAuth. Nessa URL, o usuário efetua login no servidor e concede permissões ao aplicativo. No OAuth 1.0, se as permissões forem concedidas, o token de solicitação será autorizado.

OAuthAccessTokenURL

A URL da qual recuperar o token de acesso OAuth.

Tipo de Dados

string

Valor Padrão

""

Observações

A URL da qual recuperar o token de acesso OAuth. No OAuth 1.0, o token de solicitação autorizado é trocado pelo token de acesso nessa URL.

OAuthVerifier

O código do verificador retornado da URL de autorização OAuth.

Tipo de Dados

string

Valor Padrão

""

Observações

O código do verificador retornado da URL de autorização OAuth. Isso pode ser usado em sistemas em que um navegador não pode ser iniciado, como sistemas headless.

Autenticação em Máquinas Sem Cabeça

Consulte para obter o OAuthVerifier valor.

Defina OAuthSettingsLocation juntamente com OAuthVerifier. Quando você conecta, o conector troca o OAuthVerifier para os tokens de autenticação OAuth e os salva, criptografados, no arquivo especificado. Definir InitiateOAuth para GETANDREFRESH automatizar a troca.

Depois que o arquivo de configurações OAuth for gerado, você poderá remover OAuthVerifier nas propriedades de conexão e conecte-se com OAuthSettingsLocation definir.

Para atualizar automaticamente os valores do token OAuth, defina OAuthSettingsLocation e adicionalmente defina InitiateOAuth para ATUALIZAR.

OAuthRefreshToken

O token de atualização OAuth para o token de acesso OAuth correspondente.

Tipo de Dados

string

Valor Padrão

""

Observações

O OAuthRefreshToken a propriedade é usada para atualizar o OAuthAccessToken ao usar a autenticação OAuth.

OAuthExpiresIn

O tempo de vida em segundos do OAuth AccessToken.

Tipo de Dados

string

Valor Padrão

""

Observações

Emparelhe com OAuthTokenTimestamp para determinar quando o AccessToken expirará.

OAuthTokenTimestamp

O registro de data e hora da época do Unix em milissegundos quando o token de acesso atual foi criado.

Tipo de Dados

string

Valor Padrão

""

Observações

Emparelhe com OAuthExpiresIn para determinar quando o AccessToken expirará.

JWT OAuth

Esta seção fornece uma lista completa das propriedades JWT OAuth que você pode configurar.

Propriedade Descrição
OAuthJWTCert A loja de certificados JWT.
OAuthJWTCertType O tipo de armazenamento de chaves que contém o certificado JWT.
OAuthJWTCertPassword A senha para o certificado OAuth JWT.
OAuthJWTCertSubject O assunto do certificado OAuth JWT.
OAuthJWTIssuer O emissor do Java Web Token.
OAuthJWTSubject O assunto do usuário para o qual o aplicativo está solicitando acesso delegado.

OAuthJWTCert

A loja de certificados JWT.

Tipo de Dados

string

Valor Padrão

""

Observações

O nome do armazenamento de certificados para o certificado do cliente.

O OAuthJWTCertType campo especifica o tipo de armazenamento de certificado especificado por OAuthJWTCert. Se o armazenamento estiver protegido por senha, especifique a senha em OAuthJWTCertPassword.

OAuthJWTCert é usado em conjunto com o OAuthJWTCertSubject para especificar os certificados do cliente. Se OAuthJWTCert tem um valor e OAuthJWTCertSubject for definido, uma pesquisa por um certificado será iniciada. Consulte OAuthJWTCertSubject para obter detalhes.

As designações de armazenamentos de certificados dependem da plataforma.

A seguir estão as designações dos armazenamentos de certificados de Usuário e Máquina mais comuns no Windows:

Propriedade Descrição
MY Um armazenamento de certificados que contém certificados pessoais com suas chaves privadas associadas.
CA Certificados de autoridade certificadora.
ROOT Certificados raiz.
SPC Certificados de editor de software.

Em Java, o armazenamento de certificados normalmente é um arquivo contendo certificados e chaves privadas opcionais.

Quando o tipo de armazenamento de certificado for PFXFile, essa propriedade deverá ser configurada para o nome do arquivo. Quando o tipo é PFXBlob, a propriedade deve ser configurada para o conteúdo binário de um arquivo PFX (ou seja, armazenamento de certificados PKCS12).

OAuthJWTCertType

O tipo de armazenamento de chaves que contém o certificado JWT.

Valores Possíveis

USER, MACHINE, PFXFILE, PFXBLOB, JKSFILE, JKSBLOB, PEMKEY_FILE, PEMKEY_BLOB, PUBLIC_KEY_FILE, PUBLIC_KEY_BLOB, SSHPUBLIC_KEY_FILE, SSHPUBLIC_KEY_BLOB, P7BFILE, PPKFILE, XMLFILE, XMLBLOB

Tipo de Dados

string

Valor Padrão

"USER"

Observações

Esta propriedade pode assumir um dos seguintes valores:

Propriedade Descrição
USER Para Windows, isso especifica que o armazenamento de certificados é um armazenamento de certificados pertencente ao usuário atual. Nota: Este tipo de loja não está disponível em Java.
MACHINE Para Windows, isso especifica que o armazenamento de certificados é um armazenamento de máquina. Nota: este tipo de loja não está disponível em Java.
PFXFILE O armazenamento de certificados é o nome de um arquivo PFX (PKCS12) que contém certificados.
PFXBLOB O armazenamento de certificados é uma string (codificada em base 64) que representa um armazenamento de certificados no formato PFX (PKCS12).
JKSFILE O armazenamento de certificados é o nome de um arquivo de armazenamento de chaves Java (JKS) que contém certificados. Nota: este tipo de loja só está disponível em Java.
JKSBLOB O armazenamento de certificados é uma sequência (codificada em base 64) que representa um armazenamento de certificados no formato Java key store (JKS). Nota: este tipo de loja só está disponível em Java.
PEMKEY_FILE O armazenamento de certificados é o nome de um arquivo codificado por PEM que contém uma chave privada e um certificado opcional.
PEMKEY_BLOB O armazenamento de certificados é uma string (codificada em base64) que contém uma chave privada e um certificado opcional.
PUBLIC_KEY_FILE O armazenamento de certificados é o nome de um arquivo que contém um certificado de chave pública codificado por PEM ou DER.
PUBLIC_KEY_BLOB O armazenamento de certificados é uma string (codificada em base 64) que contém um certificado de chave pública codificado em PEM ou DER.
SSHPUBLIC_KEY_FILE O armazenamento de certificados é o nome de um arquivo que contém uma chave pública de estilo SSH.
SSHPUBLIC_KEY_BLOB O armazenamento de certificados é uma string (codificada em base 64) que contém uma chave pública de estilo SSH.
P7BFILE O armazenamento de certificados é o nome de um arquivo PKCS7 contendo certificados.
PPKFILE O armazenamento de certificados é o nome de um arquivo que contém um PPK (PuTTY Private Key).
XMLFILE O armazenamento de certificados é o nome de um arquivo que contém um certificado no formato XML.
XMLBLOB O armazenamento de certificados é uma string que contém um certificado no formato XML.

OAuthJWTCertPassword

A senha para o certificado OAuth JWT.

Tipo de Dados

string

Valor Padrão

""

Observações

Se o armazenamento de certificados for de um tipo que requer uma senha, essa propriedade será usada para especificar essa senha para abrir o armazenamento de certificados.

OAuthJWTCertSubject

O assunto do certificado OAuth JWT.

Tipo de Dados

string

Valor Padrão

"\*"

Observações

Ao carregar um certificado, o assunto é usado para localizar o certificado na loja.

Se uma correspondência exata não for encontrada, a loja é pesquisada em busca de assuntos que contenham o valor da propriedade.

Se uma correspondência ainda não for encontrada, a propriedade será definida como uma string vazia e nenhum certificado será selecionado.

O valor especial "*" seleciona o primeiro certificado no armazenamento de certificados.

O assunto do certificado é uma lista separada por vírgulas de campos e valores de nomes distintos. Por exemplo, "CN=www.server.com, OU=test, C=US, E=support@jitterbit.com". Os campos comuns e seus significados são exibidos abaixo.

Campo Significado
CN Nome comum. Geralmente, é um nome de hospedar como www.server.com.
O Organização
OU Unidade Organizacional
L Localidade
S Estado
C País
E Endereço E-mail

Se um valor de campo contiver uma vírgula, ela deverá ser colocada entre aspas.

OAuthJWTIssuer

O emissor do Java Web Token.

Tipo de Dados

string

Valor Padrão

""

Observações

O emissor do Java Web Token. Normalmente, é o ID do cliente ou o endereço E-mail do aplicativo OAuth.

OAuthJWTSubject

O assunto do usuário para o qual o aplicativo está solicitando acesso delegado.

Tipo de Dados

string

Valor Padrão

""

Observações

O assunto do usuário para o qual o aplicativo está solicitando acesso delegado. Normalmente, o nome da conta do usuário ou endereço de e-mail.

SSL

Esta seção fornece uma lista completa de propriedades SSL que você pode configurar.

Propriedade Descrição
SSLServerCert O certificado a ser aceito do servidor ao conectar usando TLS/SSL.

SSLServerCert

O certificado a ser aceito do servidor ao conectar usando TLS/SSL.

Tipo de Dados

string

Valor Padrão

""

Observações

Se estiver usando uma conexão TLS/SSL, esta propriedade pode ser usada para especificar o certificado TLS/SSL a ser aceito do servidor. Qualquer outro certificado que não seja confiável para a máquina é rejeitado.

Esta propriedade pode assumir as seguintes formas:

Descrição Exemplo
Um certificado PEM completo (exemplo abreviado para concisão) -----BEGIN CERTIFICATE----- MIIChTCCAe4CAQAwDQYJKoZIhv......Qw== -----END CERTIFICATE-----
Um caminho para um arquivo local contendo o certificado C:\cert.cer
A chave pública (exemplo abreviado para concisão) -----BEGIN RSA PUBLIC KEY----- MIGfMA0GCSq......AQAB -----END RSA PUBLIC KEY-----
O Thumbprint MD5 (os valores hexadecimais também podem ser separados por espaço ou dois-pontos) ecadbdda5a1529c58a1e9e09828d70e4
A impressão digital SHA1 (os valores hexadecimais também podem ser separados por espaço ou dois-pontos) 34a929226ae0819f2ec14b4a3d904f801cbb150d

Se não for especificado, qualquer certificado confiável pela máquina será aceito.

Os certificados são validados como confiáveis pela máquina com base no armazenamento confiável do sistema. O armazenamento confiável usado é o valor 'javax.net.ssl.trustStore' especificado para o sistema. Se nenhum valor for especificado para esta propriedade, o armazenamento confiável padrão do Java será usado (por exemplo, JAVA_HOME\lib\security\cacerts).

Use '*' para indicar a aceitação de todos os certificados. Observe que isso não é recomendado devido a questões de segurança.

Esquema

Esta seção fornece uma lista completa de propriedades de esquema que você pode configurar.

Propriedade Descrição
Location Um caminho para o diretório que contém os arquivos de esquema que definem tabelas, exibições e procedimentos armazenados.
BrowsableSchemas Essa propriedade restringe os esquemas relatados a um subconjunto dos esquemas disponíveis. Por exemplo, BrowsableSchemas=SchemaA, SchemaB, SchemaC.
Tables Esta propriedade restringe as tabelas reportadas a um subconjunto das tabelas disponíveis. Por exemplo, Tables=TableA, TableB, TableC.
Views Restringe as visualizações relatadas a um subconjunto das tabelas disponíveis. Por exemplo, Views=ViewA, ViewB, ViewC.

Localização

Um caminho para o diretório que contém os arquivos de esquema que definem tabelas, exibições e procedimentos armazenados.

Tipo de Dados

string

Valor Padrão

"%APPDATA%\\\Office365 Data Provider\\Schema"

Observações

O caminho para um diretório que contém os arquivos de esquema para o conector (arquivos .rsd para tabelas e exibições, arquivos .rsb para procedimentos armazenados). A localização da pasta pode ser um caminho relativo a partir da localização do executável. O Location a propriedade só é necessária se você quiser personalizar definições (por exemplo, alterar um nome de coluna, ignorar uma coluna e assim por diante) ou estender o modelo de dados com novas tabelas, exibições ou procedimentos armazenados.

Se não for especificado, o local padrão é "%APPDATA%\\Office365 Data Provider\Schema" com %APPDATA% sendo definido para o diretório de configuração do usuário:

Plataforma %APPDATA%
Windows O valor da variável de ambiente APPDATA
Mac ~/Biblioteca/Suporte de aplicativos
Linux ~/.config

Esquemas Navegáveis

Essa propriedade restringe os esquemas relatados a um subconjunto dos esquemas disponíveis. Por exemplo, BrowsableSchemas=SchemaA,SchemaB,SchemaC.

Tipo de Dados

string

Valor Padrão

""

Observações

Listar os esquemas de bancos de dados pode ser caro. Fornecer uma lista de esquemas na string de conexão melhora o desempenho.

Tabelas

Esta propriedade restringe as tabelas reportadas a um subconjunto das tabelas disponíveis. Por exemplo, Tabelas=TabelaA,TabelaB,TabelaC.

Tipo de Dados

string

Valor Padrão

""

Observações

Listar as tabelas de alguns bancos de dados pode ser caro. Fornecer uma lista de tabelas na string de conexão melhora o desempenho do conector.

Essa propriedade também pode ser usada como uma alternativa para listar automaticamente as exibições se você já souber com quais deseja trabalhar e, caso contrário, haveria muitos para trabalhar.

Especifique as tabelas que deseja em uma lista separada por vírgulas. Cada tabela deve ser um identificador SQL válido com quaisquer caracteres especiais escapados usando colchetes, aspas duplas ou acentos graves. Por exemplo, Tables=TableA,[TableB/WithSlash],WithCatalog.WithSchema.`TableC With Space`.

Observe que, ao conectar-se a uma fonte de dados com vários esquemas ou catálogos, você precisará fornecer o nome totalmente qualificado da tabela nesta propriedade, como no último exemplo aqui, para evitar ambigüidade entre tabelas que existem em vários catálogos ou esquemas.

Visualizações

Restringe as visualizações relatadas a um subconjunto das tabelas disponíveis. Por exemplo, Views=ViewA,ViewB,ViewC.

Tipo de Dados

string

Valor Padrão

""

Observações

Listar as exibições de alguns bancos de dados pode ser caro. Fornecer uma lista de exibições na string de conexão melhora o desempenho do conector.

Essa propriedade também pode ser usada como uma alternativa para listar automaticamente as exibições se você já souber com quais deseja trabalhar e, caso contrário, haveria muitas para trabalhar.

Especifique as exibições desejadas em uma lista separada por vírgulas. Cada exibição deve ser um identificador SQL válido com quaisquer caracteres especiais escapados usando colchetes, aspas duplas ou acentos graves. Por exemplo, Views=ViewA,[ViewB/WithSlash],WithCatalog.WithSchema.`ViewC With Space`.

Observe que, ao conectar-se a uma fonte de dados com vários esquemas ou catálogos, você precisará fornecer o nome totalmente qualificado da tabela nesta propriedade, como no último exemplo aqui, para evitar ambigüidade entre tabelas que existem em vários catálogos ou esquemas.

Diversos

Esta seção fornece uma lista completa de diversas propriedades que você pode configurar.

Propriedade Descrição
DirectoryRetrievalDepth Especifique quantas pastas você deseja obter resultados para a tabela de arquivos. Os recursos diretamente na raiz estão localizados na profundidade 0. Os recursos uma pasta mais abaixo estão localizados na profundidade 1 e assim por diante. Você pode especificar o valor -1 para obter todos os dados em uma unidade, independentemente da profundidade em que estão.TABLEROWEND
MaxRows Limita o número de linhas retornadas quando nenhuma agregação ou agrupamento é usado na consultar. Isso ajuda a evitar problemas de desempenho em tempo de design.
Other Essas propriedades ocultas são usadas apenas em casos de uso específicos.
Pagesize O número máximo de resultados a serem retornados por página do Office 365. Voltar para o início
PseudoColumns Esta propriedade indica se deve ou não incluir pseudocolunas como colunas na tabela.
Timeout O valor em segundos até que o erro de timeout seja lançado, cancelando a operação.
UseClientSidePaging Se o Provedor ADO.NET para Office 365 deve ou não usar a paginação do lado do cliente.

DirectoryRetrievalDepth

Especifique quantas pastas você deseja obter resultados para a tabela de arquivos. Os recursos diretamente na raiz estão localizados na profundidade 0. Os recursos uma pasta mais abaixo estão localizados na profundidade 1 e assim por diante. Você pode especificar o valor -1 para obter todos os dados em uma unidade, independentemente da profundidade em que estão.

Tipo de Dados

string

Valor Padrão

"5"

Observações

Essa propriedade deve ser definida na string de conexão ou o driver usará um padrão de DirectoryRetrievalDepth=5.

MaxRows

Limita o número de linhas retornadas quando nenhuma agregação ou agrupamento é usado na consultar. Isso ajuda a evitar problemas de desempenho em tempo de design.

Tipo de Dados

int

Valor Padrão

-1

Observações

Limita o número de linhas retornadas quando nenhuma agregação ou agrupamento é usado na consultar. Isso ajuda a evitar problemas de desempenho em tempo de design.

Outro

Essas propriedades ocultas são usadas apenas em casos de uso específicos.

Tipo de Dados

string

Valor Padrão

""

Observações

As propriedades listadas abaixo estão disponíveis para casos de uso específicos. Os casos de uso e a funcionalidade normais do driver não devem exigir essas propriedades.

Especifique várias propriedades em uma lista separada por ponto e vírgula.

Integração e Formatação
Propriedade Descrição
DefaultColumnSize Define o comprimento padrão dos campos de string quando a fonte de dados não fornece o comprimento da coluna nos metadados. O valor padrão é 2000. Voltar para o início
ConvertDateTimeToGMT Determina se os valores de data e hora devem ser convertidos em GMT, em vez da hora local da máquina.
RecordToFile=filename Registra a transferência de dados do soquete subjacente para o arquivo especificado.

Tamanho da Página

O número máximo de resultados a serem retornados por página do Office 365.

Tipo de Dados

int

Valor Padrão

100

Observações

O Pagesize propriedade afeta o número máximo de resultados a serem retornados por página do Office 365. Definir um valor mais alto pode resultar em melhor desempenho ao custo de memória adicional alocada por página consumida.

Pseudocolunas

Esta propriedade indica se deve ou não incluir pseudocolunas como colunas na tabela.

Tipo de Dados

string

Valor Padrão

""

Observações

Essa configuração é particularmente útil no Entity Framework, que não permite definir um valor para uma pseudocoluna, a menos que seja uma coluna de tabela. O valor dessa configuração de conexão está no formato "Table1=Column1, Table1=Column2, Table2=Column3". Você pode usar o caractere "*" para incluir todas as tabelas e todas as colunas; por exemplo, "*=*".

Tempo Esgotado

O valor em segundos até que o erro de timeout seja lançado, cancelando a operação.

Tipo de Dados

int

Valor Padrão

60

Observações

Se Timeout = 0, as operações não expiram. As operações são executadas até serem concluídas com êxito ou até encontrarem uma condição de erro.

Se Timeout expira e a operação ainda não está concluída, o conector lança uma exceção.

UseClientSidePaging

Se o Provedor ADO.NET para Office 365 deve ou não usar a paginação do lado do cliente.

Tipo de Dados

bool

Valor Padrão

false

Observações

Algumas fontes não suportam paginação do lado do servidor. Nesses casos, defina UseClientSidePaging como true. Caso contrário, deixe-o como falso. Definir UseClientSidePaging como true em uma fonte que já dá suporte à paginação pode causar resultados incompletos.