Skip to content
Snippets Groups Projects
README.md 1.73 KiB
Newer Older
Riße, Matthias's avatar
MVP
Riße, Matthias committed
<!--
SPDX-FileCopyrightText: 2024 Matthias Riße <m.risse@fz-juelich.de>

SPDX-License-Identifier: CC-BY-4.0
-->

## What?

This is an [annextimelog](https://gitlab.com/nobodyinperson/annextimelog) specific [git-annex](https://git-annex.branchable.com/) [special remote](https://git-annex.branchable.com/special_remotes/)
that can automatically submit annextimelog events (e.g. recorded working hours) to the FZJ time management portal.


## Why?

The employee portal,
which contains the time management stuff,
can be frustratingly slow.
I don't want to spend more time on it than strictly necessary,
it is just not fun.
So to minimize time spend with it I automated the submission of time corrections,
e.g. for when I am working from home.
This is a big chunk of the interactions I have with the employee portal.


## How?

1. Have annextimelog installed
2. Install this thing (it is a python project, pick your poison for how to do that)
Riße, Matthias's avatar
Riße, Matthias committed
3. Do `atl config fast true` so that annextimelog does not drop the event files
4. Do this:
Riße, Matthias's avatar
MVP
Riße, Matthias committed
   ```
   FZJ_EMPLOYEE_PORTAL_USERNAME='<username>' FZJ_EMPLOYEE_PORTAL_PASSWORD='<password>' atl git annex initremote fzj-time-management type=external externaltype=fzj-time-management uuid=56d55214-8d47-4972-a6ff-13742df2e010 encryption=none
   atl git annex untrust fzj-time-management
   ```
Riße, Matthias's avatar
Riße, Matthias committed
5. Create some (closed) events with annextimelog, set `fzj-time-management-reason=<reason>` (e.g. `fzj-time-management-reason=FA-K`) for each event
6. `atl sync`
7. Observe the submitted correction in the employee portal
Riße, Matthias's avatar
MVP
Riße, Matthias committed

When your credentials change you can just use `enableremote` to reconfigure them, i.e.
```
FZJ_EMPLOYEE_PORTAL_USERNAME='<username>' FZJ_EMPLOYEE_PORTAL_PASSWORD='<password>' atl git annex enableremote fzj-time-management
```