diff --git a/.github/workflows/main.yml b/.github/workflows/main.yml index 571c80645..a081ef6ce 100644 --- a/.github/workflows/main.yml +++ b/.github/workflows/main.yml @@ -6,7 +6,7 @@ name: Deploy To Site on: # Triggers the workflow on push or pull request events but only for the master branch push: - branches: [ master, test ] + branches: [ master, test, next ] # A workflow run is made up of one or more jobs that can run sequentially or in parallel jobs: diff --git a/docs/guides/msp-export-module.md b/docs/guides/msp-export-module.md index 872adfe40..579e01b8b 100644 --- a/docs/guides/msp-export-module.md +++ b/docs/guides/msp-export-module.md @@ -103,6 +103,22 @@ Also, please note, that if you call `gantt.exportToMSProject()` without paramete The MSP export module and export server use the MPXJ library to import and export MSP and Primavera files. Unfortunately, there is no way to export MPP files, but you can [import both XML and MPP files](https://www.mpxj.org/faq/). +Even though a direct export to MPP isn't supported, you can still get the changes made in Gantt back into MS Project. A typical round-trip workflow looks like this: + +1. A user creates or edits a project in MS Project and saves the file (as MPP or XML). +2. The file is [imported into Gantt](guides/export-msproject.md#import-from-ms-project), where the data can be viewed or modified. +3. The Gantt data is [exported into an XML Project file](guides/export-msproject.md#export-to-ms-project). +4. The resulting XML file is imported back into the original file in MS Project: + - If no tasks were deleted in Gantt, import the XML file using the **Merge** option (see the screenshot below). The existing tasks will be updated, and the new ones will be added. + + ![MS Project import wizard - Merge option](/img/msp_import_merge.png) + + - If some tasks were deleted in Gantt, they won't be removed automatically during the import, since MS Project only updates and adds tasks when merging. In this case, first select and delete the corresponding tasks in MS Project manually, then import the XML file using either the **Append** or the **Merge** option (the **Append** option is shown below). + + ![MS Project import wizard - Append option](/img/msp_import_append.png) + +By default, Gantt imports and exports only the default set of task/project properties. To carry additional properties through the round trip, see [Getting tasks properties](guides/export-msproject.md#getting-tasks-properties) for import, and the `tasks` object described in [Export settings](guides/export-msproject.md#export-settings) for export. + ### Import of large files If you want to import large files, you will need to remove the limits on the request size. To do that, you need to open the diff --git a/static/img/msp_import_append.png b/static/img/msp_import_append.png new file mode 100644 index 000000000..e579633de Binary files /dev/null and b/static/img/msp_import_append.png differ diff --git a/static/img/msp_import_merge.png b/static/img/msp_import_merge.png new file mode 100644 index 000000000..703f6f8f7 Binary files /dev/null and b/static/img/msp_import_merge.png differ