Работа с MS Project

Эта страница только для чтения. Вы можете посмотреть её исходный текст, но не можете его изменить. Сообщите администратору, если считаете, что это неправильно.
====== Работа с MS Project ======
{{tag>Реализация:из_коробки Реализация:настройка}}

===== Функциональность =====
Если у вас установлен MS Project, то вы можете экспортировать проекты из MS Project в Адванту и импортировать их обратно.

--------------------
[[product:settings:system:distribs|Установите модуль интеграции в MS Project]], чтобы функциональность импорта/экспорта стала доступна.   \\  
После успешной установки модуля в MS Project появится вкладка «Надстройки», на которой размещены кнопки для запуска операций импорта/экспорта.
<callout type="info" icon="true">
Для корректной работы модуля интеграции также нужно настроить работу систему через https: протокол, либо, если используется http: протокол – понизить уровень безопасности. Инструкция есть в разделе с дистрибутивами по ссылке выше (под таблицами актуальных версий интегратора).
</callout>
------------------

Параметры, которые можно импортировать/экспортировать:
  * даты (плановые и фактические) проектов и работ;
  * длительность проектов и работ;
  * связи между работами с учетом задержек (лагов);
  * трудозатраты.

<callout type="success" icon="fa fa-users">
Кроме проектов и задач, в MS Project можно импортировать в качестве ресурсов список пользователей из Адванты.  \\  
Можно ассоциировать ресурсы MS Project с пользователями Адванты и затем экспортировать их в Адванту в качестве ресурсов.</callout>

{{ :product:objects:users:planning:ms_project_1.png?nolink |Вкладка «Надстройки» в MS Project}} 

<callout type="danger" icon="true">Максимальное рекомендованное количество объектов для экспорта из MS Project в Адванту - 500 объектов((сюда входят и проекты, и работы)) **за один раз**.  \\  
Перенесите все необходимые проекты в ADVANTA в несколько итераций, если суммарное число объектов превышает 500.

Если ограничение превысить, есть риск, что операция экспорта зависнет, потребуется ее повторная настройка и запуск.</callout>

<callout type="warning" icon="true">Интегратор не работает через прокси-соединение.</callout>

=====Особенности экспорта/импорта из/в MS Project=====
==== Нормализованный файл ====

Для успешного экспорта из MS Project в Адванту мы рекомендуем предварительно «нормализовать» файл проекта MS Project. 

У MS Project и Адванты есть существенные различия в настройках и параметрах проектного планирования. В проектах MS Project есть дополнительные настройки и параметры. При экспорте они могут негативно повлиять на результат. Например, могут "поехать" даты и длительности и т.п.

Перед тем как экспортировать проект из MSP:
  - создайте новый файл проекта;
  - скопируйте в него значения только основных колонок: 
    * название,
    * даты начала и окончания, 
    * длительность, 
    * предшественники, 
    * названия ресурсов. 
  - сверьте даты и длительности с исходником и сохраните новый файл. 
Только после этого приступайте к экспорту данных в Адванту.

==== Корневой объект ====

Чтобы исключить многократные операции по выбору родительского объекта для каждого корневого узла в плане MS Project, мы рекомендуем создать один общий корневой узел над всеми ранее созданными узлами плана.

Так вы сможете экспортировать объекты не отдельными узлами, а как проект в целом.

==== Синхронизация календарей ====
<callout type="primary" icon="true">Обязательно синхронизируйте календари в обеих системах.</callout>

При экспорте из(в) MSP в(из) ADVANTA необходимо синхронизировать [[product:settings:interface:calendar|производственные календари]] ADVANTA и MSP. 

**В противном случае**:
  - в ADVANTA будут сдвиги в датах выгруженных проектов и задач, 
  - а в MSP будет появляться ошибка об отсутствии календаря. 

В MS Project идентичными должны быть:
  * как **настройки расписания**: "Файл" -> "Параметры",  \\  <image shape="thumbnail">{{ :product:objects:users:planning:ms_project_8.png?nolink |Страница параметров MS Project -- Расписание}}</image>
  * так и указанный для проекта **производственный календарь**: Меню "Проект" -> "Изменение рабочего времени".  \\  <image shape="thumbnail">{{ :product:objects:users:planning:ms_project_9.png?nolink |Страница изменения рабочего времени в MS Project}}</image>
    * Если **названия календарей** в  MS Project и ADVANTA **совпадают**, то для импортированного проекта будет использоваться указанный календарь. 
    * Если **названия календарей не совпадают**, то для импортированного проекта будет использован календарь вышестоящего объекта.

<image shape="thumbnail">{{ :product:objects:users:planning:ms_project_10.png?nolink |Производственный календарь в ADVANTA}}</image>
\\
\\
===== Экспорт проектов из MS Project в ADVANTA=====
{{ :product:objects:users:выгрузка_плана_из_ms_project_в_адванту_3.mp4?600x400 |Видеинструкция для экспорта проектов из MS Project в ADVANTA}}

1. Авторизуйтесь в Системе в браузере по умолчанию (на уровне операционной системы) под нужной для интеграции учётной записью.

2. Зайдите в MS Project -> откройте ваш проект.

2. Меню "Надстройки" -> «Выгрузить в Адванту».

3. В открывшемся окне укажите адрес сервера (в поле адреса по умолчанию будет указан шаблон адреса к Cистеме).

4. В модуле интеграции MS Project нажмите кнопку «Войти через браузер».

<image shape="thumbnail">{{ :product:objects:users:proj.png |Окно подключения модуля интеграции к системе}}</image>

<callout type="warning">Адрес Системы для подключения должен быть тот же, по которому Вы заходите в Систему (как имя Системы в IIS).</callout>

<callout type="warning">Если обращение к системе настроено через протокол ''https'', то для корректной работы модуля интеграции установите SSL-сертификат на компьютере, с которого производится импорт/экспорт.</callout>

<callout type="primary" icon="true">Если установлена старая [[product:settings:system:distribs|версия модуля интеграции с MS Project]], подключение может отличаться. В этом случае необходимо:

1. Зайти в MS Project → открыть Ваш проект.

2. Меню «Надстройки» → «Выгрузить в Адванту».

3. В открывшемся окне указать:
  * адрес сервера (в поле адреса по умолчанию будет указан шаблон адреса к системе),
  * логин и пароль Пользователя в ADVANTA.


4. Нажмите «Подключить».

<image shape="thumbnail">{{ :product:objects:users:planning:ms_project_2.png?nolink |Окно подключения модуля интеграции к системе}}</image>

</callout>

5. Выберите родительский объект, в который хотите поместить экспортируемый проект. Для этого нажмите кнопку «Выбрать родительский проект».

{{ :product:objects:users:planning:ms_project_3.png?nolink |Кнопка выбора родительского проекта}}

6. Найдите требуемый проект в дереве, либо воспользуйтесь строкой для поиска -> выделите его -> "Ок".

Если нужно экспортировать проект в корень, и у вас на это [[product:access:about|есть права]], выберите «Создать в корне».

<callout type="primary">Эти действия нужно выполнить для каждого корневого узла в плане MS Project.</callout>

<callout type="success">А по клику на «Создать шаблон» можно экспортировать проект в ADVANTA как шаблон - при этом он появится [[product:templates:object|в списке шаблонов проектов в администрировании]].</callout> 

{{ :product:objects:users:planning:ms_project_4.png?nolink |Выбор родительского проекта}}

7. Укажите [[product:objects:admin:about|тип проекта]] для всех выгружаемых проектов. По умолчанию выбран тип «Задача». Чтобы выбрать тип проекта:
  * выберите проект (клик на него), тип которого вы хотите сменить;
  * в выпадающем меню выберите нужный тип проекта -> "Далее".

{{ :product:objects:users:planning:ms_project_5.png?nolink |Выбор типа объекта}}

<callout type="info">По умолчанию при выгрузке все даты начала и окончания проектов задаются либо как расчетные, либо как плановые -- зависит от установленных в MS Project ограничениях.  \\  При использовании опции «Выгрузить даты как жестко заданные» все даты начала и окончания проектов становятся плановыми.  \\  При выгрузке проектов с плановыми датами накладываются ограничения на возможности по перепланировке календарного плана у выгруженных проектов. Например, если работы связаны между собой, то сдвиг дат в одной из работ не вызовет сдвига дат в связанных работах.
</callout>

8. Если у работ в MS Project указаны человеческие ресурсы, их можно связывать с пользователями «Адванты». Для этого:
  * выберите ресурс MS Project;
  * выберите пользователя из ADVANTA, с которым необходимо связать ресурс MS Project;
  * нажмите «Связать».

{{ :product:objects:users:planning:ms_project_6.png?nolink |Связывание ресурсов MS Project с ресурсами «Адванты»}}

<callout type="warning">Если в списке таблицы «Ассоциированные ресурсы» есть ресурсы из MS Project, с которыми не связаны ресурсы из системы «Адванта», то кнопка «Выгрузить» станет неактивной. Чтобы выгрузка стала возможной, нужно связать Все ресурсы из MS Project с ресурсами Адванты.</callout>

9. Нажмите "Выгрузить". По завершении выгрузки проектов в систему, отобразится окно с отчетом.

<callout type="warning" icon="true">В ходе выполнения выгрузки может появиться сообщение «У вас нет прав на создание корневых проектов» даже в том случае, когда вы указали родительский проект. 

Это происходит, если выгружается не один проект, а несколько работ (проектов), не связанных в файле MS Project общим родительским проектом. В подобном случае, чтобы выгрузка произошла корректно, необходимо задать родительский проект для каждой такой работы (проекта).</callout>
====Как экспортируются вехи проекта из MS Project в ADVANTA====

[[product/objects/admin/interfaces|Укажите тип объекта]], с которым в ADVANTA будут экспортироваться вехи проекта. 

Как [[product:objects:gant:milestone|вехи]] в ADVANTA будут экспортированы задачи:
  - у которых в MS Project нулевая длительность (вне зависимости от активации чек-бокса "пометить задачу как веху" в свойствах задачи);
  - с ненулевой длительностью и активированным чек-боксом "пометить задачу как веху".

Все вехи будут загружены в ADVANTA с нулевой длительностью, вне зависимости от их длительности, указанной в MS Project. 

<callout type="primary" title="Особенность логики в выгрузке вех с ненулевой длительностью">
  * Если веха имеет входящую связь, то при загрузке в ADVANTA она устанавливается на дату начала периода, указанного для нее в MS Project. 
  * Если веха не имеет входящей связи, то при загрузке в ADVANTA она устанавливается на дату окончания периода, указанного для нее в MS Project.
</callout>


=====Импорт проектов в MS Project из ADVANTA=====

{{ :product:objects:users:выгрузка_плана_из_адванты_в_ms_project.mp4?600x400 |Видеоинструкция для импорта проектов в MS Project из ADVANTA}}

<callout type="warning" icon="true">В MS Project название задачи ограничено 255 символами. В Адванте такого ограничения нет. При импорте в MS Project проектов и работ с длинными названиями будут возникать ошибка с текстом «Ошибка валидации имени проекта». Исправьте длинные названия объектов в Адванте в соответствии с ограничением MS Project (255 символов).</callout>

  - Зайдите в MS Project -> меню "Надстройки" -> "Загрузить из Адванты";
  - В открывшемся окне укажите:
    * адрес сервера (в поле адреса по умолчанию будет указан шаблон адреса к системе),
    * логин и пароль пользователя в ADVANTA. 
  - Нажмите «Подключить».  \\  <image shape="thumbnail">{{ :product:objects:users:planning:ms_project_2.png?nolink |Окно подключения модуля интеграции к системе}}</image> <callout type="warning">Адрес системы для подключения должен заканчиваться на имени приложения, под которым система установлена на сервере с IIS.  \\  На примере выше это имя ''streamline''. Все, что отображается в адресной строке браузера после этого имени, в поле «Адрес» вводить не нужно.</callout><callout type="warning">Если обращение к системе настроено через протокол ''https'', то для корректной работы модуля интеграции установите SSL-сертификат на компьютере, с которого производится импорт/экспорт.</callout>
  - В списке выберите проект для загрузки -> «Загрузить».<callout type="success">C помощью операции «Загрузить ресурсы» из ADVANTA импортируется список пользователей, которые становятся ресурсами в MS Project.</callout>  \\  {{ :product:objects:users:planning:ms_project_7.png?nolink |Список проектов для загрузки из Адванты}}

<callout type="info" icon="true">Импортируемый проект добавляется к существующему в MS Project проекту.</callout>
==== Как импортируются даты план-графиков из 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 происходит на вкладках "Связывание реквизитов проектов" и "Связывание реквизитов справочников" в окне "Импорт проектов в Адванту".

<image shape="thumbnail">{{ :product:objects:users:import_ms_project3.png?800 |Импорт реквизитов в Адванту }}</image>

=== Связывание реквизитов проектов ===
Для того, чтобы раздел с возможностью связывания реквизитов системы ADVANTA с колонками MS Project стал активен и доступен на изменение, необходимо в окне "Связывание реквизитов проектов" отметить чекбокс "Выгрузить значения реквизитов проектов".

<image shape="thumbnail">{{ :product:objects:users:import_ms_project2.png?800 |Чекбокс "Выгрузить значения реквизитов проектов" }}</image>

В столбце "Колонка MS Project" отображаются только колонки с типами:
  * дата;
  * флаг;
  * число;
  * текст.

Реквизит системы ADVANTA отображается в блоке «Реквизиты Адванты», если реквизит привязан хотя бы к одному подтипу пользовательских объектов, созданных в системе ADVANTA и имеет тип:
  * дата;
  * классификатор;
  * процесс;
  * строка;
  * число.

Для связки в столбце «Колонка MS Project» таблицы «Ассоциированные реквизиты» и в блоке «Реквизиты Адванты» выделите нужные значения. После этого нажмите кнопку "Связать".

<image shape="thumbnail">{{ :product:objects:users:import_ms_project5.png?direct&800 |Связка }}</image>

<callout type="info" icon="true"> В случае, если значение из таблицы «Ассоциированные реквизиты» уже связано с другим значением блока «Реквизиты Адванты», то после нажатия кнопки "Связать" новое значение перезаписывает его.</callout>
=== Связывание реквизитов справочников ===
Аналогично связыванию реквизитов объектов в окне "Связывание реквизитов справочников" необходимо отметить чекбокс "Выгрузить значения реквизитов справочников".

<image shape="thumbnail">{{ :product:objects:users:import_ms_project4.png?direct&800 |Чекбокс "Выгрузить значения реквизитов справочников" }}</image>

Справочник системы ADVANTA отображается в блоке «Реквизиты справочников», если справочник привязан хотя бы к одному подтипу пользовательских объектов, созданных в системе ADVANTA и имеет тип:
  * пользовательский справочник (независимо от того, входит он в состав закладок справочников (типов "Ведущий/Подчиненный" и "Список") или нет;
  * объектный справочник.

При импорте записей справочников выделите необходимые значения в столбце «Колонка MS Project» таблицы «Ассоциированные реквизиты» и в блоке «Реквизиты справочника», и после этого нажмите кнопку "Выгрузить".

<image shape="thumbnail">{{ :product:objects:users:import_ms_project7.png?direct&800 |Выгрузка }}</image>

<callout type="info" icon="true"> Также при необходимости реквизиты или записи табличных справочников системы ADVANTA можно отвязать с помощью соответствующей кнопки - выделенное значение в столбце «Колонка MS Project» таблицы «Ассоциированные реквизиты» отвяжется от реквизита системы ADVANTA.</callout>


==== При экспорте ====
При экспорте объектов процесс связывания реквизитов или записей табличных справочников системы ADVANTA с колонками MS Project происходит на вкладках «Связывание реквизитов проектов» и «Связывание реквизитов справочников» в окне "Загрузка проектов из Адванты".

На вкладке "Выбор проектов" необходимо выделить нужный проект и нажать кнопку "Далее".

<image shape="thumbnail">{{ :product:objects:users:export_ms_project1.png?direct&800 |Выбор проектов }}</image>

<callout type="warning" icon="true">Если объект не выбран, то переход на следующую вкладку недоступен, выдается окно с ошибкой.
<image shape="thumbnail">{{ :product:objects:users:error.png?200 |Окно ошибки }}</image></callout>

Дальнейшие действия по связыванию реквизитов или записей табличных справочников системы ADVANTA с колонками MS Project при экспорте аналогичны действиям при [[product:objects:users:ms_project#при_импорте|импорте]].
==== Сохранение настроек ====
После того, как связывание пользовательских колонок MS Project и сущностей в системе ADVANTA закончено, настройки необходимо сохранить.

Для этого в разделе "Надстройки" панели инструментов MS Project нажмите команду "Сохранить настройки" - по нажатию отобразится стандартное окно для выбора места сохранения файла с настройками соответствий.

<image shape="thumbnail">{{ :product:objects:users:save_settings1.png?direct&800 |Сохранение настроек }}</image>

Если необходимо загрузить ранее сохраненные настройки соответствий пользовательских колонок MS Project и сущностей в системе ADVANTA, то нажмите на команду "Загрузить настройки" - откроется стандартное окно для выбора файла с настройками.

<callout type="warning" icon="true">Множественный выбор файлов с ранее сохраненными настройками соответствий недоступен.</callout>

Загруженные настройки соответствий могут быть изменены вручную и сохранены как новый отдельный файл.

<callout type="primary" icon="true">В связи с существенными доработками надстройки для импорта и экспорта данных MS Project после подключения из нее к ADVANTA происходит проверка совместимости версии надстройки. Если версия надстройки не совместима с версией ADVANTA, то будет выдано сообщение об этом.
<image shape="thumbnail">{{ releases:3_29:msp_check_version.png |}}</image>
Для решения проблемы - необходимо обновить систему ADVANTA до требуемой версии (указывается в сообщении об ошибке).</callout>