====== Работа с MS Project ======
===== Функциональность =====
Если у вас установлен MS Project, то вы можете экспортировать проекты из MS Project в Адванту и импортировать их обратно.
--------------------
[[product:settings:system:distribs|Установите модуль интеграции в MS Project]], чтобы функциональность импорта/экспорта стала доступна. \\
После успешной установки модуля в MS Project появится вкладка «Надстройки», на которой размещены кнопки для запуска операций импорта/экспорта.
Для корректной работы модуля интеграции также нужно настроить работу систему через https: протокол, либо, если используется http: протокол – понизить уровень безопасности. Инструкция есть в разделе с дистрибутивами по ссылке выше (под таблицами актуальных версий интегратора).
------------------
Параметры, которые можно импортировать/экспортировать:
* даты (плановые и фактические) проектов и работ;
* длительность проектов и работ;
* связи между работами с учетом задержек (лагов);
* трудозатраты.
Кроме проектов и задач, в MS Project можно импортировать в качестве ресурсов список пользователей из Адванты. \\
Можно ассоциировать ресурсы MS Project с пользователями Адванты и затем экспортировать их в Адванту в качестве ресурсов.
{{ :product:objects:users:planning:ms_project_1.png?nolink |Вкладка «Надстройки» в MS Project}}
Максимальное рекомендованное количество объектов для экспорта из MS Project в Адванту - 500 объектов((сюда входят и проекты, и работы)) **за один раз**. \\
Перенесите все необходимые проекты в ADVANTA в несколько итераций, если суммарное число объектов превышает 500.
Если ограничение превысить, есть риск, что операция экспорта зависнет, потребуется ее повторная настройка и запуск.
Интегратор не работает через прокси-соединение.
=====Особенности экспорта/импорта из/в MS Project=====
==== Нормализованный файл ====
Для успешного экспорта из MS Project в Адванту мы рекомендуем предварительно «нормализовать» файл проекта MS Project.
У MS Project и Адванты есть существенные различия в настройках и параметрах проектного планирования. В проектах MS Project есть дополнительные настройки и параметры. При экспорте они могут негативно повлиять на результат. Например, могут "поехать" даты и длительности и т.п.
Перед тем как экспортировать проект из MSP:
- создайте новый файл проекта;
- скопируйте в него значения только основных колонок:
* название,
* даты начала и окончания,
* длительность,
* предшественники,
* названия ресурсов.
- сверьте даты и длительности с исходником и сохранить новый файл.
Только после этого приступайте к экспорту данных в Адванту.
==== Корневой объект ====
Чтобы исключить многократные операции по выбору родительского объекта для каждого корневого узла в плане MS Project, мы рекомендуем создать один общий корневой узел над всеми ранее созданными узлами плана.
Так вы сможете экспортировать объекты не отдельными узлами, а как проект в целом.
==== Синхронизация календарей ====
Обязательно синхронизируйте календари в обеих системах.
При экспорте из(в) MSP в(из) ADVANTA необходимо синхронизировать [[product:settings:interface:calendar|производственные календари]] ADVANTA и MSP.
**В противном случае**:
- в ADVANTA будут сдвиги в датах выгруженных проектов и задач,
- а в MSP будет появляться ошибка об отсутствии календаря.
В MS Project идентичными должны быть:
* как **настройки расписания**: "Файл" -> "Параметры", \\ {{ :product:objects:users:planning:ms_project_8.png?nolink |Страница параметров MS Project -- Расписание}}
* так и указанный для проекта **производственный календарь**: Меню "Проект" -> "Изменение рабочего времени". \\ {{ :product:objects:users:planning:ms_project_9.png?nolink |Страница изменения рабочего времени в MS Project}}
* Если **названия календарей** в MS Project и ADVANTA **совпадают**, то для импортированного проекта будет использоваться указанный календарь.
* Если **названия календарей не совпадают**, то для импортированного проекта будет использован календарь вышестоящего объекта.
{{ :product:objects:users:planning:ms_project_10.png?nolink |Производственный календарь в ADVANTA}}
\\
\\
===== Экспорт проектов из MS Project в ADVANTA=====
{{ :product:objects:users:выгрузка_плана_из_ms_project_в_адванту_3.mp4?600x400 |Видеинструкция для экспорта проектов из MS Project в ADVANTA}}
1. Авторизуйтесь в Системе в браузере по умолчанию (на уровне операционной системы) под нужной для интеграции учётной записью.
2. Зайдите в MS Project -> откройте ваш проект.
2. Меню "Надстройки" -> «Выгрузить в Адванту».
3. В открывшемся окне укажите адрес сервера (в поле адреса по умолчанию будет указан шаблон адреса к Cистеме).
4. В модуле интеграции MS Project нажмите кнопку «Войти через браузер».
{{ :product:objects:users:proj.png |Окно подключения модуля интеграции к системе}}
Адрес Системы для подключения должен быть тот же, по которому Вы заходите в Систему (как имя Системы в IIS).
Если обращение к системе настроено через протокол ''https'', то для корректной работы модуля интеграции установите SSL-сертификат на компьютере, с которого производится импорт/экспорт.
Если установлена старая [[product:settings:system:distribs|версия модуля интеграции с MS Project]], подключение может отличаться. В этом случае необходимо:
1. Зайти в MS Project → открыть Ваш проект.
2. Меню «Надстройки» → «Выгрузить в Адванту».
3. В открывшемся окне указать:
* адрес сервера (в поле адреса по умолчанию будет указан шаблон адреса к системе),
* логин и пароль Пользователя в ADVANTA.
4. Нажмите «Подключить».
{{ :product:objects:users:planning:ms_project_2.png?nolink |Окно подключения модуля интеграции к системе}}
5. Выберите родительский объект, в который хотите поместить экспортируемый проект. Для этого нажмите кнопку «Выбрать родительский проект».
{{ :product:objects:users:planning:ms_project_3.png?nolink |Кнопка выбора родительского проекта}}
6. Найдите требуемый проект в дереве, либо воспользуйтесь строкой для поиска -> выделите его -> "Ок".
Если нужно экспортировать проект в корень, и у вас на это [[product:access:about|есть права]], выберите «Создать в корне».
Эти действия нужно выполнить для каждого корневого узла в плане MS Project.
А по клику на «Создать шаблон» можно экспортировать проект в ADVANTA как шаблон - при этом он появится [[product:templates:object|в списке шаблонов проектов в администрировании]].
{{ :product:objects:users:planning:ms_project_4.png?nolink |Выбор родительского проекта}}
7. Укажите [[product:objects:admin:about|тип проекта]] для всех выгружаемых проектов. По умолчанию выбран тип «Задача». Чтобы выбрать тип проекта:
* выберите проект (клик на него), тип которого вы хотите сменить;
* в выпадающем меню выберите нужный тип проекта -> "Далее".
{{ :product:objects:users:planning:ms_project_5.png?nolink |Выбор типа объекта}}
По умолчанию при выгрузке все даты начала и окончания проектов задаются либо как расчетные, либо как плановые -- зависит от установленных в MS Project ограничениях. \\ При использовании опции «Выгрузить даты как жестко заданные» все даты начала и окончания проектов становятся плановыми. \\ При выгрузке проектов с плановыми датами накладываются ограничения на возможности по перепланировке календарного плана у выгруженных проектов. Например, если работы связаны между собой, то сдвиг дат в одной из работ не вызовет сдвига дат в связанных работах.
8. Если у работ в MS Project указаны человеческие ресурсы, их можно связывать с пользователями «Адванты». Для этого:
* выберите ресурс MS Project;
* выберите пользователя из ADVANTA, с которым необходимо связать ресурс MS Project;
* нажмите «Связать».
{{ :product:objects:users:planning:ms_project_6.png?nolink |Связывание ресурсов MS Project с ресурсами «Адванты»}}
Если в списке таблицы «Ассоциированные ресурсы» есть ресурсы из MS Project, с которыми не связаны ресурсы из системы «Адванта», то кнопка «Выгрузить» станет неактивной. Чтобы выгрузка стала возможной, нужно связать Все ресурсы из MS Project с ресурсами Адванты.
9. Нажмите "Выгрузить". По завершении выгрузки проектов в систему, отобразится окно с отчетом.
В ходе выполнения выгрузки может появиться сообщение «У вас нет прав на создание корневых проектов» даже в том случае, когда вы указали родительский проект.
Это происходит, если выгружается не один проект, а несколько работ (проектов), не связанных в файле MS Project общим родительским проектом. В подобном случае, чтобы выгрузка произошла корректно, необходимо задать родительский проект для каждой такой работы (проекта).
====Как экспортируются вехи проекта из MS Project в ADVANTA====
[[product/objects/admin/interfaces|Укажите тип объекта]], с которым в ADVANTA будут экспортироваться вехи проекта.
Как [[product:objects:gant:milestone|вехи]] в ADVANTA будут экспортированы задачи:
- у которых в MS Project нулевая длительность (вне зависимости от активации чек-бокса "пометить задачу как веху" в свойствах задачи);
- с ненулевой длительностью и активированным чек-боксом "пометить задачу как веху".
Все вехи будут загружены в ADVANTA с нулевой длительностью, вне зависимости от их длительности, указанной в MS Project.
* Если веха имеет входящую связь, то при загрузке в ADVANTA она устанавливается на дату начала периода, указанного для нее в MS Project.
* Если веха не имеет входящей связи, то при загрузке в ADVANTA она устанавливается на дату окончания периода, указанного для нее в MS Project.
=====Импорт проектов в MS Project из ADVANTA=====
{{ :product:objects:users:выгрузка_плана_из_адванты_в_ms_project.mp4?600x400 |Видеоинструкция для импорта проектов в MS Project из ADVANTA}}
В MS Project название задачи ограничено 255 символами. В Адванте такого ограничения нет. При импорте в MS Project проектов и работ с длинными названиями будут возникать ошибка с текстом «Ошибка валидации имени проекта». Исправьте длинные названия объектов в Адванте в соответствии с ограничением MS Project (255 символов).
- Зайдите в MS Project -> меню "Надстройки" -> "Загрузить из Адванты";
- В открывшемся окне укажите:
* адрес сервера (в поле адреса по умолчанию будет указан шаблон адреса к системе),
* логин и пароль пользователя в ADVANTA.
- Нажмите «Подключить». \\ {{ :product:objects:users:planning:ms_project_2.png?nolink |Окно подключения модуля интеграции к системе}} Адрес системы для подключения должен заканчиваться на имени приложения, под которым система установлена на сервере с IIS. \\ На примере выше это имя ''streamline''. Все, что отображается в адресной строке браузера после этого имени, в поле «Адрес» вводить не нужно.Если обращение к системе настроено через протокол ''https'', то для корректной работы модуля интеграции установите SSL-сертификат на компьютере, с которого производится импорт/экспорт.
- В списке выберите проект для загрузки -> «Загрузить».C помощью операции «Загрузить ресурсы» из ADVANTA импортируется список пользователей, которые становятся ресурсами в MS Project. \\ {{ :product:objects:users:planning:ms_project_7.png?nolink |Список проектов для загрузки из Адванты}}
Импортируемый проект добавляется к существующему в MS Project проекту.
==== Как импортируются даты план-графиков из ADVANTA в MS Project ====
Выгрузка дат проводится для конечных работ -- объектов, не имеющих дочерних работ, задач.
Если у узлового объекта есть фиксированные ограничения по датам начала и окончания, и они выходят за границу дат дочерних объектов, то после импорта в MS Project появляются [[product:objects:gant:milestone|Вехи]] с названиями «Утвержденный Старт» или «Утвержденный Финиш» для дополнительного ограничения по дате начала или дате окончания узлового объекта, которое автоматически не получится из совокупности дочерних задач.
В MS Project даты узловых работ рассчитываются только исходя из дат дочерних объектов, и у них не может быть задано своих фиксированных ограничений, а в ADVANTA такие ограничения могут быть заданы.
=== Как выгружаются даты ===
* В MS Project нельзя проставлять фиксированные ограничения по датам для узловых объектов. Поэтому при экспорте проектов, содержащих узловые задачи с фиксированными ограничениями, может произойти сдвиг дат узла и его дочерних задач, так как в MS Project фиксированные ограничения сбросятся.
* Дата начала задач без входящих ограничений по связям и фиксированных ограничений по датам в ADVANTA сдвигается на дату начала родительского узла, а в MS Project на текущую дату.
* Если есть фактические даты, то они полностью игнорируются.
* Если есть плановые даты (фиксированные ограничения по датам), то плановые даты выгружаются в атрибут задачи Advanced/Constraint (не завершенные и не начатые проекты).
* По каждому проекту выгружаются его связи и зависимости.
* Расчетные даты не выгружаются, а рассчитываются MS Project по его алгоритмам. => Указываются % завершения проектов.
* Задачи с нулевой длительностью также выгружаются с нулевой длительностью, как вехи.
\\
=====Экспорт/импорт пользовательских колонок из/в MS Project=====
''Начиная с версии 3.29'' появилась возможность указать в надстройке соответствие пользовательских колонок MS Project и сущностей в системе ADVANTA - реквизитов объектов или записей табличных справочников.
==== При импорте ====
При импорте объектов процесс связывания реквизитов или записей табличных справочников системы ADVANTA с колонками MS Project происходит на вкладках "Связывание реквизитов проектов" и "Связывание реквизитов справочников" в окне "Импорт проектов в Адванту".
{{ :product:objects:users:import_ms_project3.png?800 |Импорт реквизитов в Адванту }}
=== Связывание реквизитов проектов ===
Для того, чтобы раздел с возможностью связывания реквизитов системы ADVANTA с колонками MS Project стал активен и доступен на изменение, необходимо в окне "Связывание реквизитов проектов" отметить чекбокс "Выгрузить значения реквизитов проектов".
{{ :product:objects:users:import_ms_project2.png?800 |Чекбокс "Выгрузить значения реквизитов проектов" }}
В столбце "Колонка MS Project" отображаются только колонки с типами:
* дата;
* флаг;
* число;
* текст.
Реквизит системы ADVANTA отображается в блоке «Реквизиты Адванты», если реквизит привязан хотя бы к одному подтипу пользовательских объектов, созданных в системе ADVANTA и имеет тип:
* дата;
* классификатор;
* процесс;
* строка;
* число.
Для связки в столбце «Колонка MS Project» таблицы «Ассоциированные реквизиты» и в блоке «Реквизиты Адванты» выделите нужные значения. После этого нажмите кнопку "Связать".
{{ :product:objects:users:import_ms_project5.png?direct&800 |Связка }}
В случае, если значение из таблицы «Ассоциированные реквизиты» уже связано с другим значением блока «Реквизиты Адванты», то после нажатия кнопки "Связать" новое значение перезаписывает его.
=== Связывание реквизитов справочников ===
Аналогично связыванию реквизитов объектов в окне "Связывание реквизитов справочников" необходимо отметить чекбокс "Выгрузить значения реквизитов справочников".
{{ :product:objects:users:import_ms_project4.png?direct&800 |Чекбокс "Выгрузить значения реквизитов справочников" }}
Справочник системы ADVANTA отображается в блоке «Реквизиты справочников», если справочник привязан хотя бы к одному подтипу пользовательских объектов, созданных в системе ADVANTA и имеет тип:
* пользовательский справочник (независимо от того, входит он в состав закладок справочников (типов "Ведущий/Подчиненный" и "Список") или нет;
* объектный справочник.
При импорте записей справочников выделите необходимые значения в столбце «Колонка MS Project» таблицы «Ассоциированные реквизиты» и в блоке «Реквизиты справочника», и после этого нажмите кнопку "Выгрузить".
{{ :product:objects:users:import_ms_project7.png?direct&800 |Выгрузка }}
Также при необходимости реквизиты или записи табличных справочников системы ADVANTA можно отвязать с помощью соответствующей кнопки - выделенное значение в столбце «Колонка MS Project» таблицы «Ассоциированные реквизиты» отвяжется от реквизита системы ADVANTA.
==== При экспорте ====
При экспорте объектов процесс связывания реквизитов или записей табличных справочников системы ADVANTA с колонками MS Project происходит на вкладках «Связывание реквизитов проектов» и «Связывание реквизитов справочников» в окне "Загрузка проектов из Адванты".
На вкладке "Выбор проектов" необходимо выделить нужный проект и нажать кнопку "Далее".
{{ :product:objects:users:export_ms_project1.png?direct&800 |Выбор проектов }}
Если объект не выбран, то переход на следующую вкладку недоступен, выдается окно с ошибкой.
{{ :product:objects:users:error.png?200 |Окно ошибки }}
Дальнейшие действия по связыванию реквизитов или записей табличных справочников системы ADVANTA с колонками MS Project при экспорте аналогичны действиям при [[product:objects:users:ms_project#при_импорте|импорте]].
==== Сохранение настроек ====
После того, как связывание пользовательских колонок MS Project и сущностей в системе ADVANTA закончено, настройки необходимо сохранить.
Для этого в разделе "Надстройки" панели инструментов MS Project нажмите команду "Сохранить настройки" - по нажатию отобразится стандартное окно для выбора места сохранения файла с настройками соответствий.
{{ :product:objects:users:save_settings1.png?direct&800 |Сохранение настроек }}
Если необходимо загрузить ранее сохраненные настройки соответствий пользовательских колонок MS Project и сущностей в системе ADVANTA, то нажмите на команду "Загрузить настройки" - откроется стандартное окно для выбора файла с настройками.
Множественный выбор файлов с ранее сохраненными настройками соответствий недоступен.
Загруженные настройки соответствий могут быть изменены вручную и сохранены как новый отдельный файл.
В связи с существенными доработками надстройки для импорта и экспорта данных MS Project после подключения из нее к ADVANTA происходит проверка совместимости версии надстройки. Если версия надстройки не совместима с версией ADVANTA, то будет выдано сообщение об этом.
{{ releases:3_29:msp_check_version.png |}}
Для решения проблемы - необходимо обновить систему ADVANTA до требуемой версии (указывается в сообщении об ошибке).