@@ -18,14 +18,43 @@ The following MS Project attributes are synced (overwritten) from gitlab:
18
18
- Text30 (the reference to the issue is stored there)
19
19
- Hyperlink (link to gitlab issue - note: somehow ms project is not handling the links correctly)
20
20
21
- Not yet implemented but planned>
21
+ Not yet implemented but planned:
22
22
- Resources (from Assigned)
23
23
24
24
Moved issues will be handled if the group selected and the issue was moved within the
25
25
group. Problem is that accessing issues only by ID is just allowed for admins.
26
26
## Requirements
27
27
This project runs only in an Windows Environment with Microsoft Project installed.
28
28
29
+ ## Usage
30
+ ```
31
+ usage: sync_gitlab2msproject [-h] [--version] [-v] [-vv] [--gitlab-url GITLAB_URL] [--gitlab-token GITLAB_TOKEN] {project,group} gitlab_resource_id project_file
32
+
33
+ Sync Gitlab Issue into MS Project
34
+
35
+ positional arguments:
36
+ {project,group} Gitlab resource type to sync with
37
+ gitlab_resource_id Gitlab resource id to sync with
38
+ project_file Microsoft Project File to sync with
39
+
40
+ optional arguments:
41
+ -h, --help show this help message and exit
42
+ --version show program's version number and exit
43
+ -v, --verbose set loglevel to INFO
44
+ -vv, --very-verbose set loglevel to DEBUG
45
+ --gitlab-url GITLAB_URL
46
+ URL to the gitlab instance i.e. https://gitlab.your-company.com
47
+ --gitlab-token GITLAB_TOKEN
48
+ Gitlab personal access token
49
+
50
+ ```
51
+
52
+ ## Quickstart
53
+ 1 . Optional: Install [ pipx] ( https://github.com/pipxproject/pipx )
54
+ 2 . Install the package ` pipx install SyncGitlab2MSProject ` (or use ` pip ` if you don't like pipx)
55
+ 3 . Push the gitlab Issue to your MS Project file:
56
+ ` sync_gitlab2msproject --gitlab-url https://gitlab.company.com --gitlab-token <your_token> group <your_group_id> ms_project_file.mpp `
57
+
29
58
## Note
30
59
31
60
This project has been set up using PyScaffold 3.2.3. For details and usage
0 commit comments