Compartilhar via

Introdução rápida ao Project Online

Um desenvolvedor de aplicativos pode personalizar um site Project Online (hospedado no SharePoint) usando aplicativos autônomos e/ou suplementos do Project. Uma riqueza de aplicativos é possível que vão desde atender às necessidades dos envolvidos em um projeto até funções de suporte ao PMO, como qualquer um dos seguintes:

  • Entrada de dados de cartão de tempo simplificada para trabalhadores
  • Aprovação eficiente do cartão de tempo para supervisores
  • Supervisão de licenças (aquisição e status) necessárias para um projeto
  • Status/integridade marcar de projetos ativos
  • Relatório de problemas
  • Relatório Status de Gerenciamento de Alterações

Project Online inclui suporte à API para acomodar os seguintes cenários:

  • Para um suplemento hospedado do Project (SharePoint):

    • Código (JavaScript, HTML, CSS) hospedado no SharePoint Online
    • Ativos que são baixados no navegador e executados no SharePoint Online.
    • Lógica de negócios que está no JavaScript
    • Acessar dados que estão em/armazenados em Project Online ou SharePoint como (mas não se limita a):
    • Campos personalizados
    • Listas

  • Para um suplemento hospedado pelo provedor do Project (SharePoint):

    • Código que existe em um site externo ao site Project Online
    • Um site externo, que pode ser (mas não se limita a):
    • Outro site do SharePoint
    • Aplicativo Web/Serviço criado em qualquer plataforma
    • O site externo contém lógica de negócios
    • O navegador é redirecionado do Project Online para o site externo com tokens de acesso para Project Online
    • O site externo pode fazer chamadas para o SharePoint e Project Online

  • Para um suplemento externo/autônomo:

    • O usuário executa um aplicativo em seu dispositivo
    • O aplicativo autentica e chama Project Online APIs diretamente
Tipo de aplicativo Implementação de API Ambiente de destino Exemplos de aplicativo
Projeto hospedado
 JSOM (modelo de objeto de script java)
REST
 Navegador
 Entrada timecard
Aprovação do timecard
Status do Projeto
Relatório de problemas
Provedor de projetos hospedado
 Biblioteca de clientes CSOM
 Site/Aplicativo do Azure
Ambiente não Windows (LAMP etc.)
 Validador de planilha externa
Importador de Projetos
Externo/Autônomo
 REST
CSOM
 REST - qualquer plataforma
CSOM - qualquer plataforma com suporte ao .NET
 Entrada timecard
Migração de projetos para um novo site
Alterar Status de Gerenciamento.

O que é preciso para começar a desenvolver aplicativos para Project Online?

Os itens comuns necessários para o desenvolvimento de aplicativos Project Online são uma conta Project Online e dados de teste — projetos e informações relacionadas ao projeto que incluem atribuições, tarefas, recursos e campos personalizados. Um ambiente de desenvolvimento também é necessário, mas as especificidades do ambiente de desenvolvimento dependem do tipo de aplicativo e da interface da API necessária para o aplicativo. As próximas seções descrevem as necessidades de desenvolvimento para as três interfaces de API.

A documentação de referência descreve o modelo de objeto comum para todas as três interfaces, bem como um mapa de entidade que mostra as relações entre os componentes do modelo de objeto.

Ambiente de desenvolvimento de suplemento hospedado pelo projeto

Um suplemento hospedado é um suplemento que reside no servidor e é baixado em um navegador para execução de runtime. Os suplementos hospedados podem usar as interfaces JSOM ou REST e são gravados em JavaScript. Project Online fornece referências à biblioteca JSOM para execução de runtime. Supondo que o desenvolvimento esteja em uma plataforma windows, os recursos necessários seguem:

  • Visual Studio 2015 (preferencial) ou Visual Studio 2013

  • Ferramentas de desenvolvimento do Office para Visual Studio

  • Idioma JavaScript

Visite https://github.com/OfficeDev/Project-JSOM-Copy-Work-Packages um aplicativo de exemplo.

Você pode baixar e executar o exemplo em algumas etapas fáceis:

  1. Baixar e abrir o aplicativo de exemplo

  2. Atualizar o SiteURL no janela Propriedades

    Project Online examina o escopo do aplicativo do suplemento e as permissões do usuário para controlar o acesso às informações no host Project Online. Se o acesso for explicitamente negado em ambas as configurações, Project Online negará acesso às informações. Caso contrário, o acesso será concedido.

  3. Habilite o sideload em seu site.

  4. Compile o projeto.

  5. Execute o projeto.

Ambiente de desenvolvimento de suplemento hospedado pelo provedor de projetos

Os suplementos hospedados pelo provedor são aplicativos gravados e residentes em qualquer plataforma Web. Eles podem se conectar e executar operações de dados usando a API REST (ou CSOM para plataformas Microsoft). Qualquer idioma e ambiente que dê suporte à interface REST pode ser usado para desenvolvimento.

Um exemplo do ambiente de desenvolvimento do Windows para esse tipo de aplicativo inclui os seguintes itens:

  • Visual Studio 2015 (preferencial) ou Visual Studio 2013

  • Ferramentas de desenvolvimento do Microsoft Office para Visual Studio (fornecidas com edições profissionais e empresariais do Visual Studio 2015)

  • .NET Framework 4.0 ou mais recente

  • Pacote CSOM do SharePointOnline (para chamadas CSOM)

  • Uma linguagem de programação, como C#

Visite https://github.com/OfficeDev/Project-Add-in-REST-BasicDataOperations para trabalhar scripts de exemplo.

Você pode executar o exemplo em algumas etapas:

  1. Baixar e abrir o aplicativo de exemplo

  2. Atualizar o SiteURL no janela Propriedades

    Project Online examina o escopo do aplicativo do suplemento e as permissões do usuário para controlar o acesso às informações no host Project Online. Se o acesso for explicitamente negado em ambas as configurações, Project Online negará acesso às informações. Caso contrário, o acesso será concedido.

  3. Habilite o sideload em seu site.

  4. Compile o projeto.

  5. Execute o projeto.

Ambiente de desenvolvimento de aplicativos externo/autônomo

Um aplicativo autônomo pode chamar Project Online usando o CSOM (Modelo de Objeto lateral do cliente) ou REST para se comunicar com Project Online para criar, recuperar, atualizar e excluir informações residentes no servidor. Este é um aplicativo cliente autônomo que depende do nível de acesso do usuário a ser executado.

Um exemplo do ambiente de desenvolvimento do Windows para esse tipo de aplicativo inclui os seguintes itens:

  • Visual Studio 2015 (preferencial) ou Visual Studio 2013

  • Ferramentas de desenvolvimento do Microsoft Office para Visual Studio (fornecidas com edições profissionais e empresariais do Visual Studio 2015)

  • .NET Framework 4.0 ou mais recente

  • Pacote CSOM do SharePointOnline (para chamadas CSOM)

  • Uma linguagem de programação, como C#

Visite https://github.com/OfficeDev/Project-CSOM-Read-Enterprise-CustomFields um aplicativo de exemplo.

Você pode executar o exemplo em algumas etapas:

  1. Baixar o aplicativo de exemplo

  2. Faça algumas alterações para acessar seu site Project Online: o nome do site, a conta de usuário e a senha.

    Verifique se o usuário tem acesso a todos os projetos. Project Online usa permissões de usuário para controlar o acesso às informações no armazenamento de dados.

  3. Adicione o assembly do SharePoint às referências usando o Console do Gerenciador de Pacotes do Nuget, disponível no menu Ferramentas digitando o seguinte no console do Nuget:

    Install-Package Microsoft.SharePointOnline.CSOM

  4. Compile o projeto.

  5. Execute o projeto.

Próximas etapas

Cada aplicativo de exemplo tem um artigo para explicar os destaques de trabalhar com a API de Projeto individual. Os artigos aparecem na lista a seguir, juntamente com alguns artigos que descrevem as relações de entidade, as informações sobre o sistema de consulta e o acesso a Campos Personalizados.

Confira também

Confira a documentação e exemplos relacionados ao desenvolvimento de aplicativos usando o CSOM e Project Online no Portal de Desenvolvimento do Project.