Документация для разработчиков Project 2013Project 2013 developer documentation

Документация, примеры кода, статьи с инструкциями и справочники по программированию, помогающие разрабатывать приложения для сайта "Магазин Office" или частного каталога приложений, а также настраивать и интегрировать Project Server и клиенты Project с обширным набором других классических приложений и бизнес-приложений для управления корпоративными проектами.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.

Вас приветствует пакет средств разработки программного обеспечения (SDK) для Microsoft Project 2013.Welcome to the Microsoft Project 2013 Software Development Kit (SDK). Этот пакет SDK включает документацию, примеры кода, статьи с инструкциями и справочники по программированию, помогающие разрабатывать приложения для общедоступного или частного каталога приложений, а также настраивать и интегрировать Project Server и клиенты Project с обширным набором других классических приложений и бизнес-приложений для управления корпоративными проектами.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.

Примечание

Project Server 2013 создан на основе платформы SharePoint Server 2013, и большая часть инфраструктуры Project 2013 ничем не отличается от других приложений 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. Документацию по модели для надстроек SharePoint, рабочих процессов на основе SharePoint, веб-частей, разработки с помощью других компонентов SharePoint, а также документацию по надстройкам Office см. в статьях Надстройки SharePoint и Надстройки 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.

Общие сведения о пакете SDK для ProjectIntroduction to the Project SDK

Project Server 2013 — это платформа для сборки локальных или облачных корпоративных решений по управлению проектами, а также для создания приложений, которые пользователи могут находить и скачивать в общедоступном магазине или частном каталоге приложений.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. В основе архитектуры Project Server 2013 лежит платформа, представленная в Microsoft Office Project Server 2007 и содержащая множество дополнений и улучшений.The Project Server 2013 architecture is based on the platform introduced in Microsoft Office Project Server 2007, with many additions and improvements. К новым компонентам относятся клиентская объектная модель (CSOM), которая обеспечивает доступ к Project Online, служба OData для сетевого доступа к данным отчетов Project Server, удаленные приемники событий, архитектура рабочих процессов, в основе которой лежит Windows Workflow Foundation версии 4 (WF4), а также надстройки Office, представляющие собой распространенную архитектуру для расширений области задач в клиентских приложениях 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.

Главное изменение в Project Server 2013 состоит в том, что вместо доступных в 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. Дополнительные сведения о новых и нерекомендуемых компонентах см. в статье Обновления для разработчиков в Project 2013.For more information about new features and deprecated features, see Updates for developers in Project 2013. Сведения об изменениях в платформе Project Server см. в статье Архитектура Project Server 2013.For information about changes in the Project Server platform, see Project Server 2013 architecture. Общие сведения о платформе разработки, которая доступна в Project Server 2010 и лежит в основе Project Server 2013, см. в статье Начало разработки в Project 2010 на сайте 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.

Project Server 2013 разработан на базе Microsoft .NET Framework 4 и Microsoft SharePoint Server 2013.Project Server 2013 is built on the Microsoft .NET Framework 4 and Microsoft SharePoint Server 2013. Статьи и примеры в этом пакете SDK позволяют получить начальные знания о разработке настраиваемых решений и приложений. Они не охватывают все программные компоненты Project Server и Project профессиональный.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. Центр разработчиков Project содержит ссылки на статьи, блоги, видеозаписи, веб-трансляции, наглядные статьи с инструкциями и другие ресурсы, посвященные Project.The Project Developer Center includes links to Project articles, blogs, videos, webcasts, visual how-to articles, and other resources.

Пакет SDK для Project 2013 включает в себя предназначенные для разработчиков сведения о Project Server 2013, Project Web App, Project профессиональный 2013 и Project стандартный 2013.The Project 2013 SDK includes developer information for Project Server 2013, Project Web App, Project Professional 2013, and Project Standard 2013. Статьи пакета SDK помогают разработчикам и администраторам оценить расширяемость Project и Project Server, а также планировать разработку настраиваемых решений.The SDK articles are designed to help developers and administrators evaluate Project and Project Server for extensibility and plan for custom solutions.

ОтзывыFeedback

Нам важно ваше мнение.We would like to hear from you. В статьях на сайте MSDN вы можете оставлять комментарии, примеры кода или помечать материалы как ошибочные в разделе Контент от сообщества, расположенном в нижней части каждой страницы.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. Когда вы установите скачанный пакет SDK для Project 2013, каждая локальная статья документации будет включать ссылку Отзывы и предложения под заголовком.When you install the Project 2013 SDK download, the local documentation articles each have a Send Feedback link that is located below the title. При чтении материалов пакета SDK вы можете в любой момент выбрать эту ссылку, чтобы отправить сообщение электронной почты команде разработчиков пакета SDK.At any point in reading the SDK, choose the link to send an email to the SDK team. Вы можете предложить исправления, попросить прояснить определенные аспекты или запросить пример кода либо дать комментарии и помочь нам повысить качество предлагаемых материалов.You can send corrections, a request for clarification or a code sample, or other comments, and help us make the content stronger.

СкачатьDownload

Пакет SDK для Project 2013 можно скачать в Центре загрузки Майкрософт (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). Он содержит файл Project2013SDK.HxS (файл с этой статьей), соответствующие примеры кода, распространяемые сборки и другие ресурсы.The download includes Project2013SDK.HxS (the file that includes this article), related code samples, redistributable assemblies, and other resources. В пакет SDK для Project 2013 пока не входит справочник по таблицам данных отчетов.The Project 2013 SDK does not yet include the Reporting datatables reference.

Новые возможности пакета SDK для ProjectWhat's new in the Project SDK

Основная задача пакета SDK для Project 2013 заключается в предоставлении общих сведений о программировании, документации модели CSOM и соответствующих компонентов для создания приложений, служб PSI (Project Server Interface) и приложений области задач для Project профессиональный 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. Пакет SDK для Project 2013 содержит пошаговые примеры для ключевых задач настройки Project Server 2013 и клиентов Project (Project стандартный 2013, Project профессиональный 2013 и 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). Эта документация не является итоговой, и последующие ее выпуски будут дополняться новыми материалами.The documentation is incomplete; more content will be added in later releases.

Базовой технологией для сетевого взаимодействия является Windows Communication Foundation (WCF) в Project Server 2013, в том числе облачные сценарии, использующие модель CSOM Project Server, а также локальная разработка с использованием 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. Ссылки на веб-службы ASMX прежних версий также основаны на архитектуре WCF.The legacy ASMX web service references are also based on the WCF architecture. Чтобы задать ссылку на веб-службу PSI (ASMX-файл) в Project Server 2013, требуется добавить в путь параметр ?wsdl URL-адреса.Setting a reference to a PSI web service (ASMX file) in Project Server 2013 requires appending the ?wsdl URL option to the path. Пример: https://ServerName/ProjectServerName/_vti_bin/PSI/Resource.asmx?wsdl.For example, https://ServerName/ProjectServerName/_vti_bin/PSI/Resource.asmx?wsdl.

Примечание

Хотя это касается наиболее распространенных компонентов Project Server, мы рекомендуем по возможности использовать модель CSOM как для локальных, так и для облачных приложений.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. Интерфейс ASMX для PSI все еще доступен в Project Server 2013, однако он признан нерекомендуемым.Although it is still available in Project Server 2013, the ASMX interface for the PSI is deprecated. Для локальных приложений, требующих полного доступа к PSI, вместо интерфейса ASMX следует использовать интерфейс WCF для PSI.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.

Разработка на компьютере под управлением Windows 7 возможна после копирования сборок CSOM для Project Server 2013 и SharePoint Server 2013 на компьютер разработчика.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. Пакет SDK содержит сборки CSOM для Project Server и лицензию на повторное распространение.The SDK download includes the CSOM assemblies for Project Server and a redistribution license. Чтобы получить эти сборки CSOM SharePoint, перейдите на страницу Пакет SDK для клиентских компонентов SharePoint Server 2013.To get the SharePoint CSOM assemblies, see SharePoint Server 2013 Client Components SDK.

Для разработки с использованием служб WCF вы можете указать ссылку на сборку прокси-сервера PSI или добавить в решение файл прокси PSI. Вы можете задавать прямые ссылки на интерфейсные веб-службы ASMX Project Server с удаленного компьютера, расположенного в том же домене, или использовать сборку прокси-сервера либо файлы прокси. Загружаемый пакет SDK содержит файлы прокси для служб WCF и веб-служб ASMX, а также скрипты для построения сборок прокси-серверов и создания обновленных файлов прокси.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.

С помощью Microsoft SharePoint Designer 2013 в Project Server 2013 вы можете создать декларативные рабочие процессы Project Server как для локального использования, так и для использования в сети.In Project Server 2013, you can create declarative Project Server workflows by using Microsoft SharePoint Designer 2013, for both on-premises and online use. SharePoint Designer 2013 использует методы и свойства действий рабочего процесса в модели CSOM.SharePoint Designer 2013 uses the workflow activity properties and methods in the CSOM. Разработка и развертывание решений Visual Studio 2012, включающих в себя веб-части Project Server или настройки Project Web App, поддерживаются только на компьютере с 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.

Обзор новых программных компонентов и нерекомендуемых компонентов в Project Server 2013 см. в статье Обновления для разработчиков в Project 2013.For an overview of new programmability features and deprecated features in Project Server 2013, see Updates for developers in Project 2013. Другим важным изменением в Project Server 2013 является использование рабочих процессов на базе WF4 для управления созданием и утверждением проектных инициатив, основанных на шаблонах корпоративных проектов.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.

Новые статьи:New topics include the following:

Документация по разделам в пространстве имен Microsoft.ProjectServer.Client и новым методам в службах PSI представлена только в минимальном объеме.Topics in the Microsoft.ProjectServer.Client namespace and new methods in the PSI services have only minimal documentation. Большинство справочных статей для служб PSI остались неизменными со времени выпуска пакета SDK для Project 2010 за июль 2011 года.Most of the reference topics for the PSI services are unchanged from the July 2011 release of the Project 2010 SDK.

Последующие выпуски пакета SDKFuture SDK releases

К моменту выхода официального выпуска пакет SDK для Project 2013 будет дополнен новыми статьями и справочными материалами.The Project 2013 SDK will be updated with new articles and reference content for the general availability release.

Разделы в пакете SDK для ProjectSections in the Project SDK

Пакет SDK для Project 2013 содержит два раздела верхнего уровня:There are two top-level sections in the Project 2013 SDK:

Раздел Концептуальные и практические статьи содержит следующее:The Conceptual and how-to articles section includes the following:

  • В статье Новые и исключенные возможности для разработчиков описываются важные новые программные возможности и нерекомендуемые компоненты в Project 2013.What's new and what's out for developers describes the major new programmability features and deprecated features in Project 2013.

  • Раздел Обзор Project для разработчиков содержит статьи об архитектуре Project Server, статьи о том, как приступить к разработке с использованием модели CSOM, информацию о новых компонентах в VBA для Project, а также ссылку на пакет SDK для Office 2013, содержащий статьи о разработке приложений области задач для Project профессиональный 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 содержит практические статьи о создании приложений для Project Server, использовании JavaScript с моделью CSOM, а также создании проектных инициатив и рабочих процессов для управления запросами.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 содержит вводные сведения о справке по PSI для Project Server 2013, информацию о кодах ошибок Project Server и справку по схеме OData для службы 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.

Примечание

Далее приведены требования к разработке и развертыванию решений и приложений EPM с общедоступного сайта "Магазин Office", интегрированного с Project Server 2013: вам следует установить .NET Framework 4 или .NET Framework 4.5 как на компьютере разработчика, так и на компьютерах развертывания.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. Чтобы определить, установлен ли нужный выпуск, откройте раздел Программы и компоненты на панели управления Windows.To determine whether the correct release is installed, open Programs and Features in the Windows Control Panel. В Visual Studio 2012 устанавливается и используется .NET Framework 4.5.> Visual Studio 2012 installs and uses the .NET Framework 4.5. При создании проекта Visual Studio вы можете выбрать в раскрывающемся списке диалогового окна Новый проект платформу .NET Framework 4.0 или NET Framework 4.5.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. Вы также можете выбрать значение Требуемая версия .NET Framework на вкладке Приложение окна Свойства.You can also select the Target Framework on the Application tab of the project Properties window. Вы можете применять Visual Studio 2010 для приложений, использующих модель CSOM или интерфейс PSI, а также для приложений области задач Project.> You can use Visual Studio 2010 for applications that use the CSOM or the PSI, and for Project task pane apps. Однако Visual Studio 2010 не содержит шаблоны надстроек Office, средства разработки Office или SharePoint для Office 2013.However, Visual Studio 2010 does not contain the Office Add-ins templates, Office development tools, or SharePoint development tools for Office 2013. Чтобы скачать Visual Studio 2012 и установщик веб-платформы (WebPI), содержащий средства разработки Office и SharePoint, перейдите на страницу со скачиваемыми материалами для приложений для Office и 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. Мы рекомендуем вам разрабатывать настраиваемые решения в тестовой среде.> We recommend that you develop custom solutions in a test environment. Если вы разрабатываете решения для текущих сборок Project Server 2013 и Project 2013, их следует перекомпилировать с использованием обновленных ссылок. Кроме того, для совместимости с последующими выпусками может потребоваться внести дополнительные изменения.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. Решения, разработанные для любой предварительной версии, могут не работать с окончательной версией.Solutions developed for any pre-release version may not work with the released version.

См. такжеSee also