Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/carlijoy/syncgitlab2msproject
Synchronized Gitlab Issues into Microsoft Project
https://github.com/carlijoy/syncgitlab2msproject
gitlab microsoft-project synchronization
Last synced: 3 months ago
JSON representation
Synchronized Gitlab Issues into Microsoft Project
- Host: GitHub
- URL: https://github.com/carlijoy/syncgitlab2msproject
- Owner: CarliJoy
- License: mit
- Created: 2020-11-10T16:09:23.000Z (about 4 years ago)
- Default Branch: main
- Last Pushed: 2024-10-14T16:58:00.000Z (3 months ago)
- Last Synced: 2024-10-29T08:02:32.731Z (3 months ago)
- Topics: gitlab, microsoft-project, synchronization
- Language: Python
- Homepage: https://syncgitlab2msproject.readthedocs.io/en/latest/
- Size: 130 KB
- Stars: 10
- Watchers: 3
- Forks: 1
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.rst
- License: LICENSE.txt
- Authors: AUTHORS.rst
Awesome Lists containing this project
README
[](https://travis-ci.com/CarliJoy/SyncGitlab2MSProject)
[](https://pypi.org/project/SyncGitlab2MSProject/)
[](https://pypistats.org/packages/syncgitlab2msproject)
[](https://pypi.org/project/SyncGitlab2MSProject/)
[](https://pypi.org/project/SyncGitlab2MSProject/)
[](https://pypi.org/project/SyncGitlab2MSProject/)
[](https://github.com/psf/black)
[](http://mypy-lang.org/)
[](https://github.com/pre-commit/pre-commit)
[](https://opensource.org/licenses/MIT)
[](https://syncgitlab2msproject.readthedocs.io/en/latest/?badge=latest)
[](http://isitmaintained.com/project/CarliJoy/SyncGitlab2MSProject)
[](http://isitmaintained.com/project/CarliJoy/SyncGitlab2MSProject)
# Help wanted
I don't own Microsoft Project anymore. So if there is anybody willing to take up the development/maintance, just open an issue.
# SyncGitlab2MSProject
Sync Gitlab Issues into a Microsoft Project File.
Use it if you use MS Project for the general project planning but want to keep
the Issues in Gitlab as a part of your project planning to follow the process progess.
Currently only Information from Gitlab Issues are inserted and updated within the
Project File. Changes in synchronised fields will be overwritten.
The following MS Project attributes are synced (overwritten) from gitlab:
- Name
- Notes (from Description)
- Deadline (from Due Date)
- Work (from Time Estimated)
- Actual Work (from Time Spent)
- Percent Complete (if Tasks given for issue, otherwise only 0% and 100% [for closed])
- Text28 (the list of labels)
- Text29 (the URL to gitlab issue)
- Text30 (the reference to the issue is stored there)
- Hyperlink (link/URL to gitlab issue)
Not yet implemented but planned:
- Resources (from Assigned)
Moved issues will be handled if the group selected and the issue was moved within the
group. Problem is that accessing issues only by ID is just allowed for admins.
## Requirements
This project runs only in an Windows Environment with Microsoft Project installed.
**Please note:** This Script has been tested only mit Microsoft Project 2016.
It cloud be, that some of the API has changed in newer versions.
If you run into any troubles with a new version, please open an
[Issue](https://github.com/CarliJoy/SyncGitlab2MSProject/issues/new).
## Usage
```
usage: sync_gitlab2msproject [-h] [--version] [-v] [-vv] [--gitlab-url GITLAB_URL] [--gitlab-token GITLAB_TOKEN] {project,group} gitlab_resource_id project_file
Sync Gitlab Issue into MS Project
positional arguments:
{project,group} Gitlab resource type to sync with
gitlab_resource_id Gitlab resource id to sync with
project_file Microsoft Project File to sync with
optional arguments:
-h, --help show this help message and exit
--version show program's version number and exit
-v, --verbose set loglevel to INFO
-vv, --very-verbose set loglevel to DEBUG
--gitlab-url GITLAB_URL
URL to the gitlab instance i.e. https://gitlab.your-company.com
--gitlab-token GITLAB_TOKEN
Gitlab personal access token
```
## Quickstart
1. Optional: Install [pipx](https://github.com/pipxproject/pipx)
2. Install the package `pipx install SyncGitlab2MSProject` (or use `pip` if you don't like pipx)
3. Push the gitlab Issue to your MS Project file:
`sync_gitlab2msproject --gitlab-url https://gitlab.company.com --gitlab-token group ms_project_file.mpp`
## Open Hyplerlink Problems
If you have troubles that the wrong issues are opened once you click on a Hyperlink use
the following VBA Script as a workaround.
Simply add the VBA script to your Ribbon and it will open all Hyperlinks of the
selected tasks.
```vbscript
Option Explicit
Private Declare Function ShellExecute _
Lib "shell32.dll" Alias "ShellExecuteA" ( _
ByVal hWnd As Long, _
ByVal Operation As String, _
ByVal Filename As String, _
Optional ByVal Parameters As String, _
Optional ByVal Directory As String, _
Optional ByVal WindowStyle As Long = vbMinimizedFocus _
) As Long
Public Sub OpenUrls()
Dim lSuccess As Long
Dim T As Task
Dim Names As String
For Each T In ActiveSelection.Tasks
lSuccess = ShellExecute(0, "Open", T.HyperlinkAddress)
Next T
End Sub
```
## Note
This project has been set up using PyScaffold 3.2.3. For details and usage
information on PyScaffold see https://pyscaffold.org/.