Detalhes da Conexão do Microsoft Project

Introdução

Versão do conector

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

Começando

Suporte à versão do Microsoft Project

Habilitando o acesso SQL bidirecional ao Project Server, o conector modela as APIs CSOM e OData do Microsoft Project como um banco de dados relacional. O Jitterbit Connector for Microsoft Project pode se conectar à nuvem e às versões locais do Project Server.

Estabelecendo uma Conexão

Conectando-se ao Microsoft Project

Para se conectar à fonte de dados do Microsoft Project, primeiro você precisará especificar as propriedades de conexão abaixo.

• URL: (Obrigatório) Defina isso como uma URL válida do Microsoft Project Web App. Por exemplo:

  http://contoso.com/sites/pwa/
  

• Schema: (Opcional) Existem dois esquemas disponíveis, "ODataV1" e "ODataV2". O esquema "ODataV2" (padrão) pode ser usado para operações CRUD completas. No entanto, para fins de relatório, o esquema "ODataV1" é superior, pois fornece dados mais granulares e expõe os campos personalizados. Consulte Modelo de dados para obter mais informações sobre a funcionalidade disponível em cada Schema.

• ProjectId: (Opcional) Se o esquema "ODataV2" for especificado, você pode definir adicionalmente esta propriedade para um ID de projeto específico, a fim de definir o projeto padrão para todas as operações que exigem um.

Autenticação para o Project Online

Existem vários métodos de autenticação disponíveis para conexão com o Microsoft Project, incluindo o SharePoint Online Cookie Service para conexão com o SharePoint Online, OAuth e SSO. Os provedores de identidade SSO com suporte são: Azure Active Directory, OneLogin e OKTA.

Autenticando com o Serviço de Cookies do SharePoint Online

Para se conectar ao Microsoft Project em SharePoint Online usando suas credenciais de login, defina o AuthScheme para SharePointOnlineCookies, o User e Password às suas credenciais de usuário.

Autenticação com OAuth

Para usar o padrão de autenticação OAuth 2.0, você deve primeiro criar um aplicativo OAuth personalizado para obter o OAuthClientId, OAuthClientSecret. Além dessas propriedades, defina CallbackURL. Consulte Usando autenticação OAuth2 Para maiores informações.

Você deve definir o AuthScheme para OAuth para impor o esquema de autenticação OAuth.

Autenticação com ADFS

Colocou o AuthScheme para ADFS. As seguintes propriedades de conexão precisam ser definidas:

• User: Defina isso para o usuário ADFS.
• Password: Defina como senha do ADFS para o usuário.
• SSOLoginURL: Defina isso para a URL de login usada pelo provedor SSO.

Abaixo está um exemplo de string de conexão:

AuthScheme=ADFS;User=username;Password=password;SSOLoginURL='https://sts.company.com';

ADFS Integrado

O fluxo integrado do ADFS indica que você está se conectando com o currently logged in Windows user credentials. Para usar o fluxo integrado do ADFS, simplesmente não especifique o User e Password, mas siga as mesmas etapas no guia ADFS acima.

Autenticação com Okta

Colocou o AuthScheme para Okta. As seguintes propriedades de conexão são usadas para se conectar ao Okta:

• User: Defina isso para o usuário Okta.
• Password: Defina como senha Okta para o usuário.
• SSOLoginURL: Defina isso para a URL de login usada pelo provedor SSO.

A seguir SSOProperties são necessários para autenticar no Okta:

• APIToken (opcional): defina como o API Token que o cliente criou a partir da organização Okta. Ele deve ser usado ao autenticar um usuário por meio de um aplicativo ou proxy confiável que substitui o contexto de solicitação do cliente OKTA.
• MFAType (opcional): Defina isso apenas caso você tenha configurado o fluxo de MFA. Atualmente suportamos apenas os seguintes tipos: OktaVerify, E-mail e SMS.
• MFAPassCode (opcional): Defina isso apenas caso você tenha configurado o fluxo de MFA. Se estiver definido como vazio/inválido, o driver emitirá inicialmente um desafio de MFA que acionará a plataforma para enviar a você uma senha de uso único em seu dispositivo ou e-mail, com base no tipo de MFA configurado. Você precisa reemitir outra conexão em que o valor da senha única recuperada é passado para a propriedade de conexão MFAPassCode.

Veja a seguir um exemplo de string de conexão:

AuthScheme=Okta;SSOLoginURL='https://example.okta.com/home/appType/0bg4ivz6cJRZgCz5d6/46';User=oktaUserName;Password=oktaPassword;

Autenticação com OneLogin

Colocou o AuthScheme para OneLogin. As seguintes propriedades de conexão são usadas para se conectar ao OneLogin:

• User: Defina isso para o usuário OneLogin.
• Password: Defina como senha do OneLogin para o usuário.

A seguir SSOProperties são necessários para autenticar no OneLogin:

• OAuthClientId: Defina como OAuthClientId, que pode ser obtido selecionando Developers > API Credentials > Credential > ClientId.
• OAuthClientSecret: Defina como OAuthClientSecret, que pode ser obtido selecionando Developers > API Credentials > Credential > ClientSecret.
• Subdomínio: Defina como o subdomínio do usuário OneLogin acessando o aplicativo SSO. Por exemplo, se a URL do OneLogin for splinkly.onelogin.com, insira splinkly como o valor do subdomínio.
• AppId: Defina como o ID do aplicativo SSO.
• Região (opcional): defina a região em que sua conta OneLogin reside. A API OneLogin opera em várias regiões e essa propriedade é usada para encontrar o domínio correto. Pode assumir um dos seguintes valores:
  • EUA (padrão)
  • UE

Veja a seguir um exemplo de string de conexão: A string de conexão a seguir usa uma chave de API para se conectar ao OneLogin:

AuthScheme=OneLogin;User=OneLoginUserName;Password=OneLoginPassword;SSOProperties='OAuthClientID=3fc8394584f153ce3b7924d9cd4f686443a52b;OAuthClientSecret=ca9257fd5cc3277abb5818cea28c06fe9b3b285d73d06;Subdomain=OneLoginSubDomain;AppId=1433920';

Usando Autenticação OAuth2

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

Credenciais Personalizadas

Você pode registrar um aplicativo para obter o OAuthClientId e OAuthClientSecret.

Quando Criar um Aplicativo OAuth Personalizado

Você precisa criar um aplicativo OAuth personalizado no fluxo da área de trabalho.

Credenciais Personalizadas

Quando Usar um Aplicativo OAuth Personalizado

Autenticação de Desktop com um Aplicativo OAuth Personalizado

Siga as etapas abaixo para autenticar com as credenciais de um aplicativo OAuth personalizado. Consulte Criando um aplicativo OAuth personalizado Para maiores informações.

Obtenha e Atualize o Token de Acesso OAuth

Depois de definir o seguinte, você está pronto para se conectar:

• OAuthClientId: Defina isso para o ID do cliente atribuído quando você registrou seu aplicativo.
• OAuthClientSecret: Defina isso como o segredo do cliente atribuído quando você registrou seu aplicativo.
• CallbackURL: Defina isso para o Callback definido quando você registrou seu aplicativo.
• URL: Defina isso para a URL da sua instância de serviço.
• 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. Atualiza o token de acesso quando ele expira.
3. Salva valores OAuth em OAuthSettingsLocation para ser persistido nas conexões.

Obtenha um Token de Acesso OAuth

Defina as seguintes propriedades de conexão para obter o OAuthAccessToken:

• 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 Callback definido quando você registrou seu aplicativo.
• URL: Defina isso para a URL da sua instância de serviço.

Você pode então chamar procedimentos armazenados* para concluir a troca OAuth:

1. Chame o GetOAuthAuthorizationURL procedimento armazenado. Defina a entrada CallbackURL para o retorno de chamada que você especificou nas configurações do aplicativo.

   O procedimento armazenado* retorna a URL para o endpoint OAuth.

2. Abra a URL, faça login e autorize o aplicativo. Você é redirecionado de volta para o URL de retorno de chamada.

3. Chame o GetOAuthAccessToken procedimento armazenado. Defina a entrada do Verifier para o parâmetro "code" na string de consultar do URL de retorno de chamada.

Atualize o Token de Acesso OAuth

Você pode definir InitiateOAuth para REFRESH para atualizar automaticamente o token de acesso OAuth quando ele expirar, ou você pode chamar o RefreshOAuthAccessToken procedimento armazenado* para atualizar o token manualmente.

Atualização Automática

Para atualizar o token com InitiateOAuth, defina o seguinte na primeira conexão de dados:

• OAuthAccessToken: Defina isso para o token de acesso retornado por GetOAuthAccessToken.
• InitiateOAuth: Configure para ATUALIZAR. Você pode usar InitiateOAuth para evitar repetir a troca de OAuth e configurar manualmente o OAuthAccessToken.
• OAuthSettingsLocation: Defina como o caminho em que o conector salvará os valores OAuth, para serem mantidos nas conexões.
• 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.
• OAuthRefreshToken: Defina isso para o token de atualização retornado por GetOAuthAccessToken.
• URL: Defina isso para a URL da sua instância de serviço.

Nas conexões de dados subsequentes, defina o seguinte:

• InitiateOAuth
• OAuthSettingsLocation
• URL: Defina isso para a URL da sua instância de serviço.

Atualização Manual

Você pode usar o RefreshOAuthAccessToken procedimento armazenado* para atualizar manualmente o OAuthAccessToken. Chame o procedimento armazenado* após o valor do parâmetro ExpiresIn retornado por GetOAuthAccessToken já passou. Você precisa definir as seguintes propriedades de conexão:

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

Você pode então chamar RefreshOAuthAccessToken com o seguinte conjunto de parâmetros:

• OAuthRefreshToken: Defina isso para o OAuthRefreshToken retornado por GetOAuthAccessToken.

Máquinas Sem Cabeça

Usando OAuth em uma Máquina Sem Cabeça

Para estabelecer uma conexão com a fonte de dados do Microsoft Project em servidores headless ou outras máquinas nas quais o conector não pode abrir um navegador, você precisa se autenticar em 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 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

Defina as seguintes propriedades na máquina sem periféricos:

• InitiateOAuth = DESLIGADO.
• OAuthClientId = ID do cliente.
• OAuthClientSecret = Segredo do cliente.
• URL = A URL do seu site ( https://{site}.sharepoint.com/sites/pwa).

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 o URL de retorno de chamada, que contém o código do verificador.
3. Salve o valor do código do verificador. Você definirá isso no OAuthVerifier propriedade de conexão.

Na máquina sem periféricos, defina as seguintes propriedades de conexão para obter os valores de autenticação OAuth:

• OAuthClientId = ID do cliente.
• OAuthClientSecret = Segredo do cliente.
• URL = A URL do seu site ( https://{site}.sharepoint.com/sites/pwa).
• 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 com o seguinte conjunto de propriedades:

• 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.
• URL = A URL do seu site ( https://{site}.sharepoint.com/sites/pwa).

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

Autenticar Usando Credenciais OAuth Personalizadas

Você pode criar um aplicativo OAuth por meio da IU do seu site ou inserindo manualmente o link criar aplicativo do seu site no navegador: https://{site}.sharepoint.com/sites/{Project_Web_App_Site}/\_layouts/15/appregnew.aspx.

Depois de preencher os campos obrigatórios, você pode clicar em "Criar" e as seguintes credenciais serão exibidas.

Observe que, ao criar o aplicativo OAuth, será necessário especificar um URL de retorno de chamada.

Este é o URL para o qual você será redirecionado após conceder acesso explicitamente. O Microsoft Project requer este retorno de chamada para usar 'https://'.

Você pode contornar essa restrição fornecendo 'https://oauth.cdata.com/oauth/' como retorno de chamada e adicionando uma propriedade de conexão de estado extra que conterá o retorno de chamada de redirecionamento real. Copie o ClientID e o ClientSecret que serão necessários posteriormente.
Para acessar a API do projeto da Microsoft, precisamos conceder permissões de escopo ao aplicativo criado. Para fazer isso, vá para a seguinte URL: https://{site}.sharepoint.com/sites/{Project_Web_App_Site}/\_layouts/15/AppInv.aspx.<br/> No campo App ID digite o ClientID obtido ao criar o app e clique em Lookup. Os outros campos devem ser preenchidos automaticamente com os detalhes do aplicativo, como Título, Domínio do aplicativo e URL de redirecionamento. No XML de solicitação de permissões, insira o seguinte:

<AppPermissionRequests>
<AppPermissionRequest Scope="http://sharepoint/projectserver" Right="Manage"/>
<AppPermissionRequest Scope="http://sharepoint/projectserver/projects" Right="Write"/>
<AppPermissionRequest Scope="http://sharepoint/projectserver/enterpriseresources" Right="Write"/>
<AppPermissionRequest Scope="http://sharepoint/projectserver/reporting" Right="Read"/>
</AppPermissionRequests>

Estas são as permissões padrão necessárias para ter acesso total à API. Além disso, o usuário conectado deve certificar-se de que possui as permissões apropriadas para acessar a API. Caso seu Project Web App (PWA) esteja no modo de permissão do Project, você pode conceder explicitamente acesso aos serviços da Web para usuários PWA especificados. Para fazer isso, você pode seguir as etapas abaixo.

1. Abra a página 'Configurações do PWA' no seu PWA.
2. Clique em 'Gerenciar usuários' na seção de segurança.
3. Clique no 'Nome de usuário' do usuário interessado.
4. Na página 'Editar usuário', expanda a seção Permissões globais.
5. Certifique-se de que a caixa de seleção 'Permitir' do 'Access Project Server Reporting Service' opção na seção 'Geral' está marcada.

Caso seu PWA esteja no modo de permissão do SharePoint, você precisará adicionar o usuário interessado em um grupo com pelo menos o 'Access Project Server Reporting Service' permissão habilitada, como: Portfolio Viewers, Portfolio Managers e Administrators. Para fazer isso, você pode seguir as etapas abaixo.

1. Abra a página 'Configurações do PWA' no seu PWA.
2. Clique em 'Gerenciar usuários' na seção de segurança.
3. Clique no 'Nome de usuário' do usuário interessado.
4. Em 'Editar Usuário' e em 'Grupos de Segurança' selecione um dos grupos com as permissões de acesso necessárias (como: Visualizadores de Portfólio, Gerentes de Portfólio e Administradores) e clique no botão '>' botão para adicionar o usuário atual.

Agora você pode usar essas credenciais para se conectar ao Microsoft Project, definindo-as como as seguintes propriedades de conexão:

• InitiateOAuth = GETANDREFRESH.
• OAuthClientId = ID do cliente.
• OAuthClientSecret = Segredo do cliente.
• CallbackURL = Seu URL de retorno de chamada.
• URL = A URL do seu site ( https://{site}.sharepoint.com/sites/{Project_Web_App_Site }).

Como alternativa, para usar o retorno de chamada:

Agora você pode usar essas credenciais para se conectar ao Microsoft Project, definindo-as como as seguintes propriedades de conexão:

• InitiateOAuth = GETANDREFRESH.
• OAuthClientId = ID do cliente.
• OAuthClientSecret = Segredo do cliente.
• CallbackURL = https://oauth.cdata.com/oauth/.
• State = Sua URL de retorno de chamada real (por exemplo http://localhost:3333).
• URL = A URL do seu site ( https://{site}.sharepoint.com/sites/{Project_Web_App_Site }).

Depreciação do CSOM

Houve algumas alterações feitas no conector na edição 2020 que devem ser levadas em consideração.

Suporte CSOM Descontinuado

Antes da edição 2020 do conector, havia suporte para conexões com o Microsoft Project usando a interface CSOM e OData, o que causava dificuldades na manutenção dos dois esquemas simultaneamente.

Ao remover o suporte para o CSOM, as conexões com o Microsoft Project são simplificadas devido à falta de propriedades de conexão especiais feitas especificamente para cada esquema. Além disso, a interface OData agora pode executar todas as mesmas operações CRUD das quais o CSOM é capaz. Por fim, o CSOM é mal documentado e mais propenso a erros do que o OData.

Por esses motivos, foi tomada a decisão de depreciar o suporte para o CSOM em favor do suporte exclusivo ao ODatainterface.

Desempenho Aprimorado com Operações em Massa OData

Uma vantagem adicional de usar a interface OData do Microsoft Project exclusivamente é o suporte para operações em massa eficientes.

Os dados do Microsoft Project devem ser verificados, uma operação INSERT/UPDATE/DELETE é executada, as alterações são publicadas e, finalmente, as alterações são verificadas.

Às vezes, a etapa de verificação pode falhar, levando a várias solicitações por única operação INSERT/UPDATE/DELETE.

Com o suporte de lote do conector, você pode reduzir drasticamente o número de solicitações enviadas, pois vários registros podem ser enviados por meio do processo de check-in/check-out por vez.

Consulte Processamento em Lote para obter detalhes sobre operações em lote.

Características Avançadas

Esta seção detalha uma seleção de recursos avançados do conector do Microsoft Project.

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

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

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

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

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

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

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

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

Por exemplo:

{
    "MyView": {
        "query": "SELECT * FROM Projects 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

Visão geral

O Jitterbit Connector for Microsoft Project modela objetos do Microsoft Project como tabelas relacionais e exibições. Um objeto do Microsoft Project tem relacionamentos com outros objetos; nas tabelas, esses relacionamentos são expressos por meio de chaves estrangeiras.

Conectando com o Esquema ODataV2

O modelo de dados ODataV2 (padrão) pode ser usado para operações CRUD completas. Os metadados das colunas principais são recuperados dinamicamente para cada entidade, mas o esquema é fixo e os campos personalizados não são incluídos.

Tabelas e Visualizações descrevem uma amostra das tabelas disponíveis na API ODataV2.

Conectando com o Esquema ODataV1

O modelo de dados ODataV1 só pode ser usado para leitura de dados. Os metadados são recuperados dinamicamente, incluindo os campos personalizados para este esquema.

Visualizações descrevem uma amostra das exibições disponíveis na API ODataV1.

Características principais

• O conector modela entidades do Microsoft Project como tabelas e exibições relacionais, permitindo que você escreva SQL para consultar dados do Microsoft Project.
• Procedimentos armazenados* permitem que você execute operações no Microsoft Project.
• A conectividade ao vivo com esses objetos significa que quaisquer alterações em sua conta do Microsoft Project são refletidas imediatamente ao usar o conector.

Processamento de consulta colaborativa

O conector transfere o máximo possível do processamento da instrução SELECT para o Microsoft Project e, em seguida, processa o restante da consultar na memória. Ver SupportEnhancedSQL para obter mais informações sobre como o conector contorna as limitações da API com processamento na memória do lado do cliente.

As instruções SELECT para as tabelas principais são mais suportadas do lado do servidor. Por exemplo:

SELECT * FROM Tasks WHERE Id = '61a6cc2d-cff5-e911-b093-00155ddc7224'

será executado no lado do servidor.

Observação: Ao executar instruções SELECT em tabelas filhas, tudo é processado no lado do cliente.

Modelo de Dados ODataV2

O esquema ODataV2 implementa os endpoints do serviço ProjectServer, que tem suporte para operações CRUD completas.

Tabelas

Tabelas são recuperados dinamicamente da conta autenticada do Microsoft Project.

Visualizações

Visualizações são recuperados dinamicamente da conta autenticada do Microsoft Project.

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 Microsoft Project. Procedimentos armazenados* permitem que você execute operações no Microsoft Project.

Vantagens do ODataV2 em Comparação com o ODataV1

• Suporta operações de gravação (INSERT, UPDATE e DELETE) nas tabelas expostas.

Limitações do ODataV2

• Para consultar algumas tabelas e visualizações, como Assignments, Recursos do Projeto, TaskLinks e Tarefas,

  o ProjectId deve ser especificado nos critérios da cláusula WHERE da consulta ou por meio do ProjectId propriedade de conexão.

• Os campos personalizados não são expostos.

Tabelas

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

Geralmente, consultar tabelas do Microsoft Project é 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 Microsoft Project

Atribuições

Recupere e modifique atribuições.

Informações Específicas da Tabela

Para consultar esta tabela, o ProjectId deve ser especificado nos critérios da cláusula WHERE da consulta ou por meio do ProjectId propriedade de conexão.

SELECT * FROM Assignments WHERE ProjectId = '99a38309-dc1d-eb11-bf8a-00155d9c6312'

Colunas

Calendários

Recupere e modifique calendários.

Colunas

EnterpriseResources

Recupere e modifique recursos.

Colunas

Fases

Recupere e modifique as fases do projeto.

Colunas

ProjetoRecursos

Recupere e modifique os recursos do projeto.

Informações Específicas da Tabela

Para consultar esta tabela, o ProjectId deve ser especificado nos critérios da cláusula WHERE da consulta ou por meio do ProjectId propriedade de conexão.

SELECT * FROM ProjectResources WHERE ProjectId = '99a38309-dc1d-eb11-bf8a-00155d9c6312'

Colunas

Projetos

Recupere e modifique projetos.

Colunas

Estágios

Recupere e modifique as etapas do projeto.

Colunas

TaskLinks

Recupere e modifique links de tarefas.

Informações Específicas da Tabela

Para consultar esta tabela, o ProjectId deve ser especificado nos critérios da cláusula WHERE da consulta ou por meio do ProjectId propriedade de conexão.

SELECT * FROM TaskLinks WHERE ProjectId = '99a38309-dc1d-eb11-bf8a-00155d9c6312'

Colunas

Tarefas

Recupere e modifique tarefas.

Informações Específicas da Tabela

Para consultar esta tabela, o ProjectId deve ser especificado nos critérios da cláusula WHERE da consulta ou por meio do ProjectId propriedade de conexão.

SELECT * FROM Tasks WHERE ProjectId = '99a38309-dc1d-eb11-bf8a-00155d9c6312'

Colunas

TimeSheet Lines

Recupere e modifique quadros de horários.

Colunas

Folhas de Horário

Recupere e modifique quadros de horários.

Colunas

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 Microsoft Project Views

Atribuição_Recurso

Recupere e modifique atribuições.

Colunas

Atribuição_Tarefa

Recupere e modifique atribuições.

Colunas

Eventos

Recuperar eventos.

Colunas

ProjectDetailPages

Recupere detalhes do projeto.

Colunas

StageDetailPages

Recuperar detalhes do projeto..

Colunas

Tarefas_Atribuições

Recupere e modifique atribuições.

Colunas

Tarefas_Calendário

Recupere e modifique atribuições.

Colunas

Períodos do TimeSheet

Recupere os períodos do quadro de horários.

Colunas

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 Microsoft Project

Check-in

Faça check-in do projeto especificado.

Entrada

Colunas do Conjunto de Resultados

Confira

Confira o projeto especificado.

Entrada

Colunas do Conjunto de Resultados

GetOAuthAccessToken

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

Entrada

Colunas do Conjunto de Resultados

GetOAuthAuthorizationURL

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

Entrada

Colunas do Conjunto de Resultados

GetOnlineCookies

Recupera os cookies para autenticação com o SharePoint Online.

Entrada

Colunas do Conjunto de Resultados

Publicar

Publique o projeto especificado.

Entrada

Colunas do Conjunto de Resultados

RefreshOAuthAccessToken

Atualiza o token de acesso OAuth usado para autenticação com o Microsoft Project.

Entrada

Colunas do Conjunto de Resultados

Procurar

Pesquisa OData usando o URL fornecido.

Entrada

Colunas do Conjunto de Resultados

Modelo de Dados ODataV1

O esquema ODataV1 implementa os endpoints do serviço ProjectData, que são somente leitura e só podem ser usados para geração de relatórios.

Visualizações

Visualizações são recuperados dinamicamente da conta autenticada do Microsoft Project.

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 Microsoft Project. Procedimentos armazenados* permitem que você execute operações no Microsoft Project.

Vantagens do ODataV1 em Comparação com o ODataV2

• Os campos personalizados são expostos como colunas de visualização.
• O ProjectId não é necessário para consultar nenhuma das exibições expostas, pois os endpoints ProjectData retornam dados para todos os projetos disponíveis.

Limitações do ODataV1

• Nenhuma operação de gravação é suportada, pois este esquema é somente leitura.

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 Microsoft Project Views

Linhas de Base de Atribuição

Recupere linhas de base de atribuição.

Colunas

AssignmentBaselineTimephasedDataSet

Recupere o conjunto de dados dividido em fases da linha de base da atribuição.

Colunas

Atribuições

Recuperar atribuições.

Colunas

AssignmentTimephasedDataSet

Recupere o conjunto de dados dividido em fases de atribuição.

Colunas