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

Документация, примеры кода, статьи с инструкциями и справочники по программированию, помогающие разрабатывать приложения для AppSource. Узнайте, как настроить и интегрировать клиенты Project и Project Server с различными классическими и бизнес-приложениями для решения по управлению крупными проектами (EPM).

Примечание.

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

Общие сведения о пакете средств разработки программного обеспечения (SDK) для Project

Project Server 2013 — это платформа для сборки локальных или облачных корпоративных решений по управлению проектами, а также для создания приложений, которые пользователи могут находить и скачивать в AppSource (прежнее название — Магазин Office). В основе архитектуры Project Server 2013 лежит платформа, представленная в Microsoft Office Project Server 2007 и содержащая множество дополнений и улучшений. К новым компонентам относятся клиентская объектная модель (CSOM), которая обеспечивает доступ к Project Online, служба OData для сетевого доступа к данным отчетов Project Server, удаленные приемники событий, архитектура рабочих процессов, в основе которой лежит Windows Workflow Foundation версии 4 (WF4), а также надстройки Office, представляющие собой распространенную архитектуру для расширений области задач в клиентских приложениях Microsoft Office 2013.

Главное изменение в Project Server 2013 состоит в том, что вместо доступных в Project Server 2010 баз данных черновиков, опубликованных проектов, архивных проектов и отчетов используется одна база данных. Дополнительные сведения о новых и нерекомендуемых компонентах см. в статье Обновления для разработчиков в Project 2013. Сведения об изменениях в платформе Project Server см. в статье Архитектура Project Server 2013. Общие сведения о платформе разработки, которая доступна в Project Server 2010 и лежит в основе Project Server 2013, см. в статье Начало разработки в Project 2010 на сайте MSDN.

Project Server 2013 разработан на базе Microsoft .NET Framework 4 и Microsoft SharePoint Server 2013. Статьи и примеры в этом пакете SDK позволяют получить начальные знания о разработке настраиваемых решений и приложений. Они не охватывают все программные компоненты Project Server и Project профессиональный. Центр разработчиков Project содержит ссылки на статьи, блоги, видеозаписи, веб-трансляции, наглядные статьи с инструкциями и другие ресурсы, посвященные Project.

Пакет SDK для Project 2013 включает в себя предназначенные для разработчиков сведения о Project Server 2013, Project Web App, Project профессиональный 2013 и Project стандартный 2013. Статьи пакета SDK помогают разработчикам и администраторам оценить расширяемость Project и Project Server, а также планировать разработку настраиваемых решений.

Мы рады вашим отзывам

Нам важно ваше мнение. В статьях на сайте MSDN вы можете оставлять комментарии, примеры кода или помечать материалы как ошибочные в разделе Контент от сообщества, расположенном в нижней части каждой страницы. Когда вы установите скачанный пакет SDK для Project 2013, каждая локальная статья документации будет включать ссылку Отзывы и предложения под заголовком. При чтении материалов пакета SDK вы можете в любой момент выбрать эту ссылку, чтобы отправить сообщение электронной почты команде разработчиков пакета SDK. Вы можете предложить исправления, попросить прояснить определенные аспекты, запросить пример кода либо оставить комментарии и помочь нам повысить качество предлагаемых материалов.

Скачать

Пакет SDK для Project 2013 можно скачать в Центре загрузки Майкрософт (https://www.microsoft.com/download/details.aspx?id=30435%20). Он содержит файл Project2013SDK.HxS (файл с этой статьей), соответствующие примеры кода, распространяемые сборки и другие ресурсы. В пакет SDK для Project 2013 пока не входит справочник по таблицам данных отчетов.

Новые возможности пакета SDK для Project

Основная задача пакета SDK для Project 2013 заключается в предоставлении общих сведений о программировании, документации модели CSOM и соответствующих компонентов для создания приложений, служб PSI (Project Server Interface) и приложений области задач для Project профессиональный 2013. Пакет SDK для Project 2013 содержит пошаговые примеры для ключевых задач настройки Project Server 2013 и клиентов Project (Project стандартный 2013, Project профессиональный 2013 и Project Web App). Эта документация не является итоговой, и последующие ее выпуски будут дополняться новыми материалами.

Базовой технологией для сетевого взаимодействия является Windows Communication Foundation (WCF) в Project Server 2013, в том числе облачные сценарии, использующие модель CSOM Project Server, а также локальная разработка с использованием PSI. Ссылки на веб-службы ASMX прежних версий также основаны на архитектуре WCF. Чтобы задать ссылку на веб-службу PSI (ASMX-файл) в Project Server 2013, требуется добавить в путь параметр ?wsdl URL-адреса. Например, https://ServerName/ProjectServerName/_vti_bin/PSI/Resource.asmx?wsdl.

Примечание.

Хотя это касается наиболее распространенных компонентов Project Server, мы рекомендуем по возможности использовать модель CSOM как для локальных, так и для облачных приложений. Интерфейс ASMX для PSI все еще доступен в Project Server 2013, однако он признан нерекомендуемым. Для локальных приложений, требующих полного доступа к PSI, вместо интерфейса ASMX следует использовать интерфейс WCF для PSI.

Разработка на компьютере под управлением Windows 7 возможна после копирования сборок CSOM для Project Server 2013 и SharePoint Server 2013 на компьютер разработчика. Пакет SDK содержит сборки CSOM для Project Server и лицензию на повторное распространение. Чтобы получить эти сборки CSOM SharePoint, перейдите на страницу Пакет SDK для клиентских компонентов SharePoint Server 2013.

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

С помощью Microsoft SharePoint Designer 2013 в Project Server 2013 вы можете создать декларативные рабочие процессы Project Server как для локального использования, так и для использования в сети. SharePoint Designer 2013 использует методы и свойства действий рабочего процесса в модели CSOM. Разработка и развертывание решений Visual Studio 2012, включающих в себя веб-части Project Server или настройки Project Web App, поддерживаются только на компьютере с Project Server.

Обзор новых программных компонентов и нерекомендуемых компонентов в Project Server 2013 см. в статье Обновления для разработчиков в Project 2013. Другим важным изменением в Project Server 2013 является использование рабочих процессов на базе WF4 для управления созданием и утверждением проектных инициатив, основанных на шаблонах корпоративных проектов.

Новые статьи:

Документация по разделам в пространстве имен Microsoft.ProjectServer.Client и новым методам в службах PSI представлена только в минимальном объеме. Большинство справочных статей для служб PSI остались неизменными со времени выпуска пакета SDK для Project 2010 за июль 2011 года.

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

К моменту выхода официального выпуска пакет SDK для Project 2013 будет дополнен новыми статьями и справочными материалами.

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

Пакет SDK для Project 2013 содержит два раздела верхнего уровня:

Раздел Концептуальные и практические статьи содержит следующее:

  • В статье Новые и исключенные возможности для разработчиков описываются важные новые программные возможности и нерекомендуемые компоненты в Project 2013.

  • Раздел Обзор Project для разработчиков содержит статьи об архитектуре Project Server, статьи о том, как приступить к разработке с использованием модели CSOM, информацию о новых компонентах в VBA для Project, а также ссылку на пакет SDK для Office 2013, содержащий статьи о разработке приложений области задач для Project профессиональный 2013.

  • Раздел Задачи программирования в Project содержит практические статьи о создании приложений для Project Server, использовании JavaScript с моделью CSOM, а также создании проектных инициатив и рабочих процессов для управления запросами.

  • Раздел Справочные материалы по программированию в Project 2013 содержит вводные сведения о справке по PSI для Project Server 2013, информацию о кодах ошибок Project Server и справку по схеме OData для службы ProjectData.

Примечание.

Далее приведены требования к разработке и развертыванию решений и приложений EPM из AppSource, интегрированных с Project Server 2013: вам необходимо установить .NET Framework 4 или .NET Framework 4.5 как на компьютере разработчика, так и на компьютерах развертывания. Чтобы определить, установлен ли нужный выпуск, откройте раздел Программы и компоненты на панели управления Windows. В Visual Studio 2012 устанавливается и используется .NET Framework 4.5. При создании проекта Visual Studio вы можете выбрать в раскрывающемся списке диалогового окна Новый проект платформу .NET Framework 4.0 или NET Framework 4.5. Вы также можете выбрать значение Требуемая версия .NET Framework на вкладке Приложение окна Свойства. Вы можете применять Visual Studio 2010 для приложений, использующих модель CSOM или интерфейс PSI, а также для приложений области задач Project. Однако Visual Studio 2010 не содержит шаблоны надстроек Office, средства разработки Office или SharePoint для Office 2013. Чтобы скачать Visual Studio 2012 и установщик веб-платформы (WebPI), содержащий средства разработки Office и SharePoint, перейдите на страницу со скачиваемыми материалами для приложений для Office и SharePoint. Мы рекомендуем вам разрабатывать настраиваемые решения в тестовой среде. Если вы разрабатываете решения для текущих сборок Project Server 2013 и Project 2013, их следует перекомпилировать с использованием обновленных ссылок. Кроме того, для совместимости с последующими выпусками может потребоваться внести дополнительные изменения. Решения, разработанные для любой предварительной версии, могут не работать с окончательной версией.

См. также