Documentação do desenvolvedor do Project 2013Project 2013 developer documentation

Localize documentação, exemplos de código, artigos de instruções e referências de programação para ajudar a criar aplicativos para o Office Store ou um catálogo de aplicativos e para personalizar e integrar clientes do Project Server e do Project a uma ampla variedade de outros aplicativos da área de trabalho e de negócios para o gerenciamento de projeto corporativo.Find documentation, code samples, how-to articles, and programming references to help build apps for the Office Store or a private app catalog and to customize and integrate Project Server and the Project clients with a wide variety of other desktop and business applications for enterprise project management.

Bem-vindo ao kit de desenvolvimento de software do Microsoft Project 2013 (SDK).Welcome to the Microsoft Project 2013 Software Development Kit (SDK). O SDK contém documentação, exemplos de código, artigos de instruções e referências de programação para ajudar a criar aplicativos para uma loja pública ou catálogo de aplicativos e para personalizar e integrar clientes do Project Server e do Project a uma ampla variedade de outros aplicativos da área de trabalho e de negócios para o gerenciamento de projeto corporativo.The SDK contains documentation, code samples, how-to articles, and programming references to help build apps for a public store or private app catalog and to customize and integrate Project Server and the Project clients with a wide variety of other desktop and business applications for enterprise project management.

Observação

O Project Server 2013 foi criado na plataforma SharePoint Server 2013 e o Project 2013 inclui grande parte da mesma infraestrutura que os outros aplicativos do Office 2013.Project Server 2013 is built on the SharePoint Server 2013 platform, and Project 2013 includes much of the same infrastructure as the other Office 2013 applications. Para obter documentação do modelo para suplementos do SharePoint, fluxos de trabalho baseados no SharePoint, Web Parts, desenvolvimento com outros recursos do SharePoint e documentação de suplementos do Office, confiraSuplementos do SharePoint e Suplementos do Office.For documentation of the model for SharePoint Add-ins, SharePoint-based workflows, Web Parts, development with other SharePoint features, and documentation of Office Add-ins, see SharePoint Add-ins and Office Add-ins.

Introdução ao SDK do ProjectIntroduction to the Project SDK

O Project Server 2013 é uma plataforma para criar soluções de gerenciamento de projetos corporativos no local ou na nuvem e para criar aplicativos que os usuários finais podem descobrir e adquirir por meio de um armazenamento público ou de um catálogo de aplicativos privado.Project Server 2013 is a platform for building on-premises or cloud-based enterprise project management solutions and for building apps that end users can discover and acquire through a public store or a private app catalog. A arquitetura do Project Server 2013 é baseada na plataforma apresentada no Microsoft Office Project Server 2007, com muitos acréscimos e melhorias.The Project Server 2013 architecture is based on the platform introduced in Microsoft Office Project Server 2007, with many additions and improvements. Os novos recursos incluem um modelo de objeto do lado do cliente (CSOM) para habilitar o acesso ao Project Online, um serviço OData para acesso online aos dados de relatório do Project Server, receptores remotos de eventos e arquitetura de fluxo de trabalho baseado na versão 4 do Windows Workflow Foundation. (WF4) e Suplementos do Office, que é uma arquitetura comum para extensões do painel de tarefas em aplicativos de clientes do Microsoft Office 2013.The new features include a client-side object model (CSOM) to enable access to Project Online, an OData service for online access to Project Server reporting data, remote event receivers, workflow architecture that is based on version 4 of the Windows Workflow Foundation (WF4), and Office Add-ins, which is a common architecture for task pane extensions in Microsoft Office 2013 client applications.

Uma alteração importante no Project Server 2013 é o uso de um único banco de dados no lugar dos bancos de dados Rascunho, Publicado, Arquivo e Relatórios no Project Server 2010.A major change in Project Server 2013 is the use of a single database in place of the Draft, Published, Archive, and Reporting databases in Project Server 2010. Para saber mais sobre novos recursos e recursos preteridos, consulte Atualizações para desenvolvedores no Project 2013.For more information about new features and deprecated features, see Updates for developers in Project 2013. Confira informações sobre as alterações de plataformas do Project Server em Arquitetura do Project Server 2013.For information about changes in the Project Server platform, see Project Server 2013 architecture. Para obter uma visão geral da plataforma de desenvolvimento que existe no Project Server 2010 e na qual o Project Server 2013 se baseia, consulteIntrodução ao desenvolvimento no Project 2010 no MSDN.For an overview of the development platform that exists in Project Server 2010 and that Project Server 2013 is based on, see Getting Started with Development for Project 2010 on MSDN.

O Project Server 2013 foi criado no Microsoft .NET Framework 4 e Microsoft SharePoint Server 2013.Project Server 2013 is built on the Microsoft .NET Framework 4 and Microsoft SharePoint Server 2013. Os artigos e exemplos neste SDK oferecem um ponto de partida para o desenvolvimento de soluções personalizadas e de aplicativos; eles não tratam de todos os recursos de programabilidade do Project Server ou do Project Professional.The articles and samples in this SDK provide a starting place for developing custom solutions and apps; they do not address all programmability features of Project Server or Project Professional. A Central de desenvolvedores do Project inclui links para artigos de projetos, blogs, vídeos, webcasts, artigos com instruções visuais e outros recursos.The Project Developer Center includes links to Project articles, blogs, videos, webcasts, visual how-to articles, and other resources.

O SDK do Project 2013 inclui informações de desenvolvedor do Project Server 2013, do Project Web App, do Project Professional 2013 e do Project Standard 2013.The Project 2013 SDK includes developer information for Project Server 2013, Project Web App, Project Professional 2013, and Project Standard 2013. Os artigos do SDK foram projetados para ajudar desenvolvedores e administradores a avaliarem o Project e o Project Server em relação à extensibilidade e ao planejamento de soluções personalizadas.The SDK articles are designed to help developers and administrators evaluate Project and Project Server for extensibility and plan for custom solutions.

ComentáriosFeedback

Gostaríamos de saber sua opinião.We would like to hear from you. Nos tópicos on-line do MSDN, você pode adicionar comentários, exemplos de código ou sinalizar o conteúdo como um bug na seção Conteúdo da Comunidade, na parte inferior de cada página.In the online topics on MSDN, you can add comments, code samples, or flag the content as a bug in the Community Content section at the bottom of each page. Quando você instala o download SDK do Project 2013, os artigos de documentação local tem um link Enviar Feedback localizado abaixo do título.When you install the Project 2013 SDK download, the local documentation articles each have a Send Feedback link that is located below the title. A qualquer momento, ao ler o SDK, escolha o link para enviar um e-mail para a equipe do SDK.At any point in reading the SDK, choose the link to send an email to the SDK team. Você pode enviar correções, uma solicitação para esclarecimentos ou uma amostra de código ou outros comentários e nos ajudar a fortalecer o conteúdo.You can send corrections, a request for clarification or a code sample, or other comments, and help us make the content stronger.

BaixarDownload

O download do SDK do Project 2013 está disponível na Central de Download da Microsoft (https://www.microsoft.com/en-us/download/details.aspx?id=30435%20).The Project 2013 SDK download is available in the Microsoft Download Center ( https://www.microsoft.com/en-us/download/details.aspx?id=30435%20). O download inclui o Project2013SDK.HxS (o arquivo que inclui este artigo), amostras de código relacionadas, assemblies redistribuíveis e outros recursos.The download includes Project2013SDK.HxS (the file that includes this article), related code samples, redistributable assemblies, and other resources. O Project 2013 SDK ainda não inclui a referência de tabelas de dados de relatórios.The Project 2013 SDK does not yet include the Reporting datatables reference.

Novidades no SDK do ProjectWhat's new in the Project SDK

O principal objetivo do SDK do Project 2013 é fornecer uma visão geral da capacidade de programação e documentação do CSOM e dos recursos relacionados para a criação de aplicativos, os serviços PSI (Interface do Servidor do Projecto) e aplicativos do painel de tarefas do Project Professional 2013.The main purpose of the Project 2013 SDK is to provide an overview of programmability and documentation of the CSOM and related features for creating apps, the Project Server Interface (PSI) services, and task pane apps for Project Professional 2013. O SDK do Project 2013 inclui exemplos passo a passo das principais áreas para personalização do Project Server 2013 e dos clientes do Project (Project Standard 2013, Project Professional 2013 e Project Web App).The Project 2013 SDK includes step-by-step examples of key areas for customization of Project Server 2013 and the Project clients (Project Standard 2013, Project Professional 2013, and Project Web App). A documentação está incompleta. mais conteúdo será adicionado em versões posteriores.The documentation is incomplete; more content will be added in later releases.

A tecnologia subjacente para comunicação de rede é o Windows Communication Foundation (WCF) no Project Server 2013, incluindo cenários de nuvem que usam o CSOM do Project Server e o desenvolvimento local usando o PSI.The underlying technology for network communication is Windows Communication Foundation (WCF) in Project Server 2013, including cloud scenarios that use the Project Server CSOM and on-premises development using the PSI. As referências de serviço da web herdadas do ASMX também são baseadas na arquitetura do WCF.The legacy ASMX web service references are also based on the WCF architecture. Configurar uma referência a um serviço web do PSI (arquivo ASMX) no Project Server 2013 requer acrescentar a opção de URL ?wsdl para o caminho.Setting a reference to a PSI web service (ASMX file) in Project Server 2013 requires appending the ?wsdl URL option to the path. Por exemplo, https://ServerName/ProjectServerName/_vti_bin/PSI/Resource.asmx?wsdl.For example, https://ServerName/ProjectServerName/_vti_bin/PSI/Resource.asmx?wsdl.

Observação

Embora ele aborde apenas os recursos mais usados ​​do Project Server, recomendamos usar o CSOM sempre que possível para aplicativos no local e na nuvem.Although it addresses only the most commonly used Project Server features, we recommend that you use the CSOM where possible for applications both on-premises and in the cloud. Embora ainda esteja disponível no Project Server 2013, a interface do ASMX para o PSI foi descontinuada.Although it is still available in Project Server 2013, the ASMX interface for the PSI is deprecated. Para aplicativos locais que exigem acesso total ao PSI, você deve usar a interface do WCF para o PSI, em vez da interface do ASMX.For on-premises applications that require full access to the PSI, you should use the WCF interface for the PSI, rather than the ASMX interface.

O desenvolvimento em um computador Windows 7 é suportado pela cópia dos assemblies CSOM do Project Server 2013 e do SharePoint Server 2013 para o computador de desenvolvimento.Development on a Windows 7 computer is supported by copying the CSOM assemblies for Project Server 2013 and for SharePoint Server 2013 to the development computer. O download SDK inclui assemblies CSOM para Project Server e uma licença para redistribuição.The SDK download includes the CSOM assemblies for Project Server and a redistribution license. Para obter assemblies do CSOM do SharePoint, consulte do SharePoint Server 2013 cliente componentes SDK.To get the SharePoint CSOM assemblies, see SharePoint Server 2013 Client Components SDK.

Para desenvolvimento com os serviços WCF, você pode definir uma referência para um assembly de proxy do PSI ou adicione arquivos de proxy do PSI à solução. Você pode definir referências diretas aos serviços Web ASMX do Project Server de front-end de um computador remoto no mesmo domínio ou usar um assembly de proxy ou de arquivos de proxy. O download do SDK inclui arquivos de proxy para os serviços WCF e os serviços Web do ASMX, além de scripts para a criação dos assemblies de proxy e para a geração de arquivos de proxy atualizados.For development with the WCF services, you can set a reference to a PSI proxy assembly or add PSI proxy files to the solution. You can set direct references to the front-end Project Server ASMX web services from a remote computer within the same domain, or use a proxy assembly or proxy files. The SDK download includes proxy files for the WCF services and the ASMX web services, plus scripts for building the proxy assemblies and for generating updated proxy files.

No Project Server 2013, você pode criar fluxos de trabalho declarativos do Project Server usando o Microsoft SharePoint Designer 2013, tanto para uso local quanto on-line.In Project Server 2013, you can create declarative Project Server workflows by using Microsoft SharePoint Designer 2013, for both on-premises and online use. O SharePoint Designer 2013 usa as propriedades e métodos da atividade do fluxo de trabalho no CSOM.SharePoint Designer 2013 uses the workflow activity properties and methods in the CSOM. O desenvolvimento e a implantação de soluções do Visual Studio 2012 que incluem Web Parts do Project Server, ou personalizações do Project Web App, são suportados apenas em um computador do Project Server.Development and deployment of Visual Studio 2012 solutions that include Project Server Web Parts, or customizations of Project Web App, is supported only on a Project Server computer.

Confira uma visão geral de recursos preteridos no Project Server 2013 e novos recursos de programação em atualizações para desenvolvedores no Project 2013.For an overview of new programmability features and deprecated features in Project Server 2013, see Updates for developers in Project 2013. Outra das principais alterações feitas no Project Server 2013 é o uso de fluxos de trabalho baseados em WF-4 para o gerenciamento da criação e da aprovação de propostas de projeto baseadas em modelos de projeto corporativo.Another major change in Project Server 2013 is the use of WF4-based workflows to manage the creation and approval of project proposals that are based on enterprise project templates.

Os novos tópicos incluem o seguinte:New topics include the following:

Tópicos na namespace Microsoft.ProjectServer.Client e novos métodos nos serviços PSI têm apenas uma documentação mínima.Topics in the Microsoft.ProjectServer.Client namespace and new methods in the PSI services have only minimal documentation. A maioria dos tópicos de referência para os serviços PSI permanece inalterada em relação à versão de julho de 2011 do SDK do Project 2010.Most of the reference topics for the PSI services are unchanged from the July 2011 release of the Project 2010 SDK.

Futuras versões do SDKFuture SDK releases

O SDK do Project 2013 será atualizado com novos artigos e conteúdo de referência para a versão de disponibilidade geral.The Project 2013 SDK will be updated with new articles and reference content for the general availability release.

Seções do SDK do ProjectSections in the Project SDK

Há duas seções de nível superior no SDK do Project 2013:There are two top-level sections in the Project 2013 SDK:

A seção Artigos conceituais e de instruções inclui o seguinte:The Conceptual and how-to articles section includes the following:

  • Novidades e o que há para desenvolvedores descreve os principais recursos de programabilidade novos e os recursos preteridos no Project 2013.What's new and what's out for developers describes the major new programmability features and deprecated features in Project 2013.

  • Visão geral do Project para desenvolvedores inclui artigos sobre a arquitetura do Project Server, artigos que mostram como iniciar o desenvolvimento com CSOM, informações sobre novos recursos no VBA para Project e uma referência ao SDK do Office 2013, que contém tópicos sobre aplicativos do painel de tarefas para o Project Professional 2013.Project overview for developers includes articles about Project Server architecture, articles that show how to get started developing with the CSOM, information about new features in VBA for Project, and a reference to the Office 2013 SDK, which contains topics about developing task pane apps for Project Professional 2013.

  • Project programming tasks inclui artigos de instruções sobre a criação de aplicativos para o Project Server usando o JavaScript com o CSOM, além da criação de propostas e fluxos de trabalho de projetos para gerenciamento de propostas.Project programming tasks includes how-to articles about creating apps for Project Server, using JavaScript with the CSOM, and creating project proposals and workflows for demand management.

  • Project 2013 programming references inclui uma introdução à referência de PSI para o Project Server 2013, informações sobre códigos de erro do Project Server e referência ao esquema OData para o serviço ProjectData.Project 2013 programming references includes an introduction to the PSI reference for Project Server 2013, information about Project Server error codes, and the OData schema reference for the ProjectData service.

Observação

Seguem os requisitos para desenvolver e implantar soluções e aplicativos de EPM da Office Store pública que se integra ao Project Server 2013:> Você deve instalar o .NET Framework 4 ou o .NET Framework 4.5 no computador de desenvolvimento e nos computadores de implantação.Following are requirements to develop and deploy EPM solutions and apps from the public Office Store that integrate with Project Server 2013: > You must install either the .NET Framework 4 or the .NET Framework 4.5 on the development computer and on the deployment computers. Para determinar se a versão correta está instalada, abra Programas e Recursos no painel de controle do Windows.To determine whether the correct release is installed, open Programs and Features in the Windows Control Panel. > O Visual Studio 2012 instala e usa o .NET Framework 4.5.> Visual Studio 2012 installs and uses the .NET Framework 4.5. Quando você cria um projeto do Visual Studio, você pode selecionar .NET Framework 4.0 ou NET Framework 4.5 na lista suspensa da caixa de diálogo Novo Projeto.When you create a Visual Studio project, you can select either .NET Framework 4.0 or NET Framework 4.5 in the drop-down list of the New Project dialog box. Você também pode selecionar as Estrutura de Destino na guiaAplicativo do projeto da janela Propriedades.You can also select the Target Framework on the Application tab of the project Properties window. > Você pode usar o Visual Studio 2010 para aplicativos que usam o CSOM ou o PSI e para os aplicativos do painel de tarefas do Project.> You can use Visual Studio 2010 for applications that use the CSOM or the PSI, and for Project task pane apps. No entanto, o Visual Studio 2010 não contém modelos de suplementos do Office, ferramentas de desenvolvimento do Office ou ferramentas de desenvolvimento do SharePoint para o Office 2013.However, Visual Studio 2010 does not contain the Office Add-ins templates, Office development tools, or SharePoint development tools for Office 2013. Para baixar o Visual Studio 2012 e o Web Platform Installer (WebPI) que inclui as ferramentas de desenvolvimento do Office e do SharePoint, confira Downloads para aplicativos do Office e SharePoint.To download Visual Studio 2012 and the Web Platform Installer (WebPI) that includes the Office and SharePoint development tools, see Downloads for Apps for Office and SharePoint. > Recomendamos que você desenvolva soluções personalizadas em um ambiente de teste.> We recommend that you develop custom solutions in a test environment. Se você desenvolver soluções para as versões atuais do Project Server 2013 e do Project 2013, elas deverão ser recompiladas com referências atualizadas e podem precisar de alterações adicionais para trabalhar com versões posteriores.If you develop solutions for the current builds of Project Server 2013 and Project 2013, they should be recompiled with updated references, and may need additional changes, to work with later releases. Soluções desenvolvidas para qualquer versão de pré-lançamento podem não funcionar com a versão de lançamento.Solutions developed for any pre-release version may not work with the released version.

Confira tambémSee also