Nextcloud Deck¶
You can import tasks from your Nextcloud Deck instance using the deck
service name.
This service requires deck to be installed in a Nextcloud installation and available to bugwarrior.
Example Service¶
Here’s an example of a Nextcloud Deck target:
[my_nextcloud_deck]
service = deck
deck.base_uri = https://nextcloud.example.com
deck.username = my_user
deck.password = my-nextcloud-app-password
[my_nextcloud_deck]
service = "deck"
base_uri = "https://nextcloud.example.com"
username = "my_user"
password = "my-nextcloud-app-password"
The above example is the minimum required to import issues from Deck. You can also feel free to use any of the configuration options described in Common Service Configuration Options or described in Service Features below.
The base_uri
should point to the location of your Nextcloud installation.
username
should be the username of the user that has access to the Deck boards you are interested in.
password
should be an app-password (or the real password, although that is not recommended) of the user.
Service Features¶
Only if assigned¶
You can filter for cards assigned to a specific user:
deck.only_if_assigned = my_user
only_if_assigned = "my_user"
Note
only_if_assigned
can be set to a username, then only issues assigned to that user will be taken into account. Attention, deck can assign multiple users, and this plugin has no support for multiple assignees - it will always only take the first assignee into account.
Exclude / include board IDs¶
You can explicitly exclude or include specific boards:
deck.exclude_board_ids = 5,6
deck.include_board_ids = 4
exclude_board_ids = ["5", "6"]
include_board_ids = ["4"]
Note
include_board_ids
can explicitly include specific boards from importing;
exclude_board_ids
can explicitly exclude specific boards from importing.
Use them to filter what cards you want to have imported.
If both are defined, include_board_ids
will be used.
Provided UDA Fields¶
Field Name |
Description |
Type |
---|---|---|
nextclouddeckassignee |
Nextcloud Deck Assignee(s) |
Text (string) |
nextclouddeckauthor |
Nextcloud Deck Issue Author |
Text (string) |
nextclouddeckboardid |
Nextcloud Deck Board ID |
Number (numeric) |
nextclouddeckboardtitle |
Nextcloud Deck Board Title |
Text (string) |
nextclouddeckcardid |
Nextcloud Deck Card ID |
Number (numeric) |
nextclouddeckcardtitle |
Nextcloud Deck Card Title |
Text (string) |
nextclouddeckdescription |
Nextcloud Deck Card Description |
Text (string) |
nextclouddeckorder |
Nextcloud Deck Order |
Number (numeric) |
nextclouddeckstackid |
Nextcloud Deck Stack ID |
Number (numeric) |
nextclouddeckstacktitle |
Nextcloud Deck Stack Title |
Text (string) |