mirror of
https://github.com/wekan/wekan.git
synced 2026-11-20 15:45:01 -05:00
Compare commits
| Author | SHA1 | Date | |
|---|---|---|---|
|
|
046d854ec9 | ||
|
|
f5d2a208f8 | ||
|
|
38db577f31 | ||
|
|
71b0eb9b7c | ||
|
|
fa28e3fba8 | ||
|
|
79cc436257 | ||
|
|
67fa4344c6 | ||
|
|
7b2d37fb41 | ||
|
|
dffbafd30f | ||
|
|
dd57704ed1 | ||
|
|
d3aa34e7b8 | ||
|
|
c5f30d8b7f | ||
|
|
3a4163cfc3 | ||
|
|
2120be5ae1 | ||
|
|
c916b15473 | ||
|
|
0ef02911a8 | ||
|
|
246b23eaf7 | ||
|
|
b4e66b7584 | ||
|
|
9ceb4dbf55 | ||
|
|
49dd8dcb00 | ||
|
|
efeb55f57a | ||
|
|
85da7079fb | ||
|
|
bb733d7692 | ||
|
|
dd8242b82f | ||
|
|
709fa87f4a | ||
|
|
35f3f6c9db | ||
|
|
f918deef0f | ||
|
|
deb4eed14e | ||
|
|
828ca63713 | ||
|
|
133be01324 | ||
|
|
75694ac644 | ||
|
|
9a18cc3dda | ||
|
|
a72b297268 | ||
|
|
651378d163 | ||
|
|
ab884547f4 | ||
|
|
8ac7afe95f | ||
|
|
c72a05d11a | ||
|
|
01f52748f3 | ||
|
|
60f569afe6 | ||
|
|
d8fff9a41a | ||
|
|
f546ff2383 | ||
|
|
e38168789d | ||
|
|
ce646dc937 | ||
|
|
ae1f084fb1 | ||
|
|
cf6f67e789 | ||
|
|
3ccce83480 | ||
|
|
0d65eec4f2 | ||
|
|
b26b148779 | ||
|
|
57a657445e | ||
|
|
b5a97bcd11 | ||
|
|
a4359731b1 | ||
|
|
c05ff7b9a8 | ||
|
|
d7b0641295 | ||
|
|
105a1ed0c1 | ||
|
|
1a02de4b5b | ||
|
|
59ee94667d | ||
|
|
14afc74adb | ||
|
|
ab1067e0b1 | ||
|
|
9bd503a71b | ||
|
|
a81050e9b8 | ||
|
|
22d000b913 | ||
|
|
1081ea7c88 | ||
|
|
28891103f6 | ||
|
|
a86e9d34e8 | ||
|
|
57413fd66a | ||
|
|
1b9ec7b9a1 | ||
|
|
2268f9d8bd | ||
|
|
24b6b9b024 | ||
|
|
07f1028d03 | ||
|
|
c640c5c376 | ||
|
|
0999864cef | ||
|
|
1122e49ca9 | ||
|
|
f72277a398 | ||
|
|
f467e31d17 | ||
|
|
8ff76652d4 | ||
|
|
20c4d90217 | ||
|
|
10caa20b09 | ||
|
|
720374efd8 | ||
|
|
3be07b147b | ||
|
|
c2a9c36829 | ||
|
|
95b88095c4 | ||
|
|
18740f4c22 | ||
|
|
5b9fa791a8 | ||
|
|
b1ab04a764 | ||
|
|
55c3f574f4 | ||
|
|
1984f72d5e | ||
|
|
878e53f418 | ||
|
|
887fdc7e6d | ||
|
|
bfdb37526e | ||
|
|
dc0a1ad049 | ||
|
|
24ac6b2bd2 | ||
|
|
8440a5e0fb | ||
|
|
31a808be6e | ||
|
|
2ce90cb95e | ||
|
|
0c277c4d18 | ||
|
|
b0612ebe57 | ||
|
|
9f85b51695 | ||
|
|
9c3a543f0a | ||
|
|
49dbdbb6d6 | ||
|
|
17ab5f8459 | ||
|
|
6187806cf1 | ||
|
|
369dd91789 | ||
|
|
bd34f44460 | ||
|
|
2d823e16dc | ||
|
|
c9da13b63e | ||
|
|
80e653b4ba | ||
|
|
c0b3d9013d | ||
|
|
394a8fd32c | ||
|
|
d613a00030 | ||
|
|
d1a1d46b73 | ||
|
|
e8330fb090 | ||
|
|
a18d2a553c | ||
|
|
3ac8b802c5 | ||
|
|
1fa7af0679 | ||
|
|
df92d8de63 | ||
|
|
ba31f2b592 | ||
|
|
ba657b9ab7 | ||
|
|
c20c7296a8 | ||
|
|
9222a60e41 | ||
|
|
cde21a7651 | ||
|
|
d1be2d2131 | ||
|
|
5d8c4a7635 | ||
|
|
db9c06dc5e | ||
|
|
338674fd1e | ||
|
|
a2257442a8 | ||
|
|
03e2fb416d | ||
|
|
4666bb60f4 | ||
|
|
bd9ec7e585 | ||
|
|
21c64e092d | ||
|
|
fc502d7206 | ||
|
|
f293ae4076 | ||
|
|
df731e648c | ||
|
|
bad71f9a1e | ||
|
|
b021a8be99 | ||
|
|
e1261ef5fb | ||
|
|
46a66c623b | ||
|
|
ce40b56abd | ||
|
|
3cbf938ae8 | ||
|
|
fd5c207006 | ||
|
|
3a1d670155 | ||
|
|
4989cd0b51 | ||
|
|
2f7a4e210f | ||
|
|
524946c1bf | ||
|
|
6f67fd298e | ||
|
|
6aedd70eeb | ||
|
|
9ac7b916c0 | ||
|
|
5673fd3bcd | ||
|
|
0071dde0f3 | ||
|
|
94ad2fd958 | ||
|
|
4fad2a9000 | ||
|
|
735f52ed11 | ||
|
|
e2cbbe5104 | ||
|
|
4e23929ee6 | ||
|
|
60bbf69164 | ||
|
|
905f60a1ea | ||
|
|
11992ac951 | ||
|
|
640e492593 | ||
|
|
e54c0f4646 | ||
|
|
d1732bd3a5 | ||
|
|
3b1c7ce7bb | ||
|
|
0d8f8b8d96 | ||
|
|
63b5e089f5 | ||
|
|
32c24ed84e | ||
|
|
257835733b | ||
|
|
ef8e82200f | ||
|
|
ccfa6cf362 | ||
|
|
c4da72ff72 | ||
|
|
96e730922e | ||
|
|
a24e3a49a9 | ||
|
|
c0339ccc59 | ||
|
|
b00e2c8133 | ||
|
|
60c25690df | ||
|
|
0ccf182001 | ||
|
|
42959d02f1 |
No files matched your search
@@ -53,9 +53,14 @@ on:
|
||||
workflow_dispatch:
|
||||
inputs:
|
||||
version:
|
||||
description: 'Release to complete, without the v (e.g. 10.58). Empty = the newest release.'
|
||||
description: 'Release to complete, without the v (e.g. 10.58). Empty = check the newest releases and complete each one that is missing something.'
|
||||
required: false
|
||||
type: string
|
||||
scan:
|
||||
description: 'With no version: how many of the newest releases to check.'
|
||||
required: false
|
||||
type: string
|
||||
default: '10'
|
||||
|
||||
# Read-only by default; the job that writes is granted it below.
|
||||
permissions:
|
||||
@@ -74,6 +79,10 @@ concurrency:
|
||||
|
||||
jobs:
|
||||
recover:
|
||||
# One release at a time: with no version, scan below starts a run of this
|
||||
# workflow for every release that is missing something, and each of those
|
||||
# recovers its own release.
|
||||
if: ${{ inputs.version != '' }}
|
||||
permissions:
|
||||
contents: read
|
||||
actions: write
|
||||
@@ -95,6 +104,41 @@ jobs:
|
||||
[ -n "$V" ] || V="$(gh release view --repo "$GITHUB_REPOSITORY" --json tagName --jq .tagName)"
|
||||
python3 releases/retry-failed-release.py "$V"
|
||||
|
||||
# With no version: which releases are missing something. Each of them gets a
|
||||
# run of its own (`-f version=...`), which does everything below for it -
|
||||
# retries the failed jobs of its full release, builds what can be built,
|
||||
# renames the variant snaps and finishes its Snap Store release - so one
|
||||
# run of this workflow, with no input, adds everything that is missing.
|
||||
scan:
|
||||
if: ${{ inputs.version == '' }}
|
||||
permissions:
|
||||
contents: read
|
||||
actions: write
|
||||
timeout-minutes: 15
|
||||
name: which releases are missing something
|
||||
runs-on: ubuntu-latest
|
||||
steps:
|
||||
- uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
|
||||
with:
|
||||
persist-credentials: false
|
||||
- name: Start a run for each incomplete release
|
||||
env:
|
||||
GH_TOKEN: ${{ github.token }}
|
||||
SCAN: ${{ inputs.scan }}
|
||||
run: |
|
||||
set -euo pipefail
|
||||
case "${SCAN:-10}" in ''|*[!0-9]*) echo "::error::scan must be a number of releases, not '$SCAN'."; exit 1 ;; esac
|
||||
bash releases/release-missing-scan.sh "${GITHUB_REPOSITORY:-wekan/wekan}" "${SCAN:-10}" > incomplete.txt
|
||||
{
|
||||
echo "### Releases missing something"
|
||||
echo ""
|
||||
if [ -s incomplete.txt ]; then sed 's/^/- /' incomplete.txt; else echo "None - the ${SCAN:-10} newest releases are complete."; fi
|
||||
} >> "$GITHUB_STEP_SUMMARY"
|
||||
while read -r version count; do
|
||||
echo "v$version is missing $count asset(s): starting Release all missing for it."
|
||||
gh workflow run release-all-missing.yml --repo "${GITHUB_REPOSITORY:-wekan/wekan}" --ref "${GITHUB_REF_NAME:-main}" -f version="$version"
|
||||
done < incomplete.txt
|
||||
|
||||
plan:
|
||||
needs: recover
|
||||
# The planner runs whatever recover's rerun ended with. A rerun that still
|
||||
@@ -102,7 +146,7 @@ jobs:
|
||||
# so in every rerun of it (v12.68's OpenBSD start) - used to skip the
|
||||
# planner and every build after it, so not even the assets that COULD be
|
||||
# filled were. recover stays red and names the jobs; the rest goes on.
|
||||
if: ${{ !cancelled() }}
|
||||
if: ${{ !cancelled() && inputs.version != '' }}
|
||||
timeout-minutes: 15
|
||||
name: what the release is missing
|
||||
runs-on: ubuntu-latest
|
||||
@@ -114,6 +158,8 @@ jobs:
|
||||
mac: ${{ steps.plan.outputs.mac }}
|
||||
flatpak: ${{ steps.plan.outputs.flatpak }}
|
||||
windows: ${{ steps.plan.outputs.windows }}
|
||||
variant: ${{ steps.plan.outputs.variant }}
|
||||
snap: ${{ steps.plan.outputs.snap }}
|
||||
manual: ${{ steps.plan.outputs.manual }}
|
||||
total: ${{ steps.plan.outputs.total }}
|
||||
steps:
|
||||
@@ -168,7 +214,7 @@ jobs:
|
||||
total="$(wc -l < missing.txt | tr -d ' ')"
|
||||
echo "total=$total" >> "$GITHUB_OUTPUT"
|
||||
|
||||
for kind in extra appimage mac flatpak windows bun; do
|
||||
for kind in extra appimage mac flatpak windows bun variant snap; do
|
||||
sels="$(awk -v k="$kind" '$1 == k { print $2 }' missing.txt)"
|
||||
json="$(printf '%s\n' $sels | sed '/^$/d' | jq -R . | jq -sc .)"
|
||||
[ -n "$json" ] || json='[]'
|
||||
@@ -197,18 +243,25 @@ jobs:
|
||||
echo ""
|
||||
echo "Not buildable here (run release-all.yml): \`$manual\`"
|
||||
fi
|
||||
if grep -q '^snap ' missing.txt; then
|
||||
echo ""
|
||||
echo "wekan snaps are rebuilt by retrying the release's snap-native or snap-launchpad job (recover, above)."
|
||||
fi
|
||||
fi
|
||||
} >> "$GITHUB_STEP_SUMMARY"
|
||||
echo "Missing $total. Needs release-all.yml: ${manual:-none}"
|
||||
|
||||
# Not a failure HERE: a red plan skipped every build below (they need
|
||||
# plan to succeed), so a release missing its amd64 zip did not get even
|
||||
# the AppImages that could be made. The done job, at the end, is red
|
||||
# for it instead.
|
||||
- name: Say plainly what this run will not do
|
||||
if: ${{ steps.plan.outputs.manual != '' }}
|
||||
env:
|
||||
STEP_PLAN_VERSION: ${{ steps.plan.outputs.version }}
|
||||
STEP_PLAN_MANUAL: ${{ steps.plan.outputs.manual }}
|
||||
run: |
|
||||
echo "::error::v${STEP_PLAN_VERSION} still lacks ${STEP_PLAN_MANUAL} after recovery. Inspect the matching full-release run; older unnamed runs need their failed jobs retried manually."
|
||||
exit 1
|
||||
echo "::warning::v${STEP_PLAN_VERSION} still lacks ${STEP_PLAN_MANUAL} after recovery, which this workflow cannot build; the rest is built anyway. Inspect the matching full-release run; older unnamed runs need their failed jobs retried manually."
|
||||
|
||||
# The six architectures nobody else builds for, repacked from the PUBLISHED
|
||||
# amd64 bundle - which is what makes this possible without a Meteor build.
|
||||
@@ -517,6 +570,74 @@ jobs:
|
||||
esac
|
||||
echo "$mark charts" >> "$GITHUB_STEP_SUMMARY"
|
||||
|
||||
# wekan-ondra and wekan-gantt-gpl snaps the release lacks: the release's own
|
||||
# wekan snap of that architecture under the variant's name and title
|
||||
# (releases/snap-rename.sh) - what snap-variants builds from source, with
|
||||
# nothing else changed. Releases before v13.21 have none attached.
|
||||
variants:
|
||||
permissions:
|
||||
contents: write
|
||||
name: variant snap ${{ matrix.variant }}
|
||||
needs: plan
|
||||
if: ${{ !cancelled() && needs.plan.result == 'success' && needs.plan.outputs.variant != '[]' }}
|
||||
runs-on: ubuntu-24.04
|
||||
timeout-minutes: 60
|
||||
strategy:
|
||||
fail-fast: false
|
||||
matrix:
|
||||
variant: ${{ fromJSON(needs.plan.outputs.variant) }}
|
||||
env:
|
||||
VERSION: ${{ needs.plan.outputs.version }}
|
||||
VARIANT: ${{ matrix.variant }}
|
||||
steps:
|
||||
- uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
|
||||
with:
|
||||
persist-credentials: false
|
||||
- name: Rename the release's wekan snap
|
||||
id: rename
|
||||
env:
|
||||
GH_TOKEN: ${{ github.token }}
|
||||
run: |
|
||||
set -euo pipefail
|
||||
name="${VARIANT%%:*}"
|
||||
arch="${VARIANT#*:}"
|
||||
case "$name" in
|
||||
wekan-ondra) title='Wekan Ondra' ;;
|
||||
wekan-gantt-gpl) title='Wekan Gantt GPL' ;;
|
||||
*) echo "::error::'$name' is not a variant snap."; exit 1 ;;
|
||||
esac
|
||||
case "$arch" in *[!a-z0-9]*|'') echo "::error::'$arch' is not an architecture."; exit 1 ;; esac
|
||||
sudo apt-get install -y squashfs-tools >/dev/null
|
||||
mkdir -p source out
|
||||
if ! gh release download "v$VERSION" --repo "$GITHUB_REPOSITORY" --dir source --pattern "wekan_${VERSION}_${arch}.snap"; then
|
||||
echo "::error::v$VERSION has no wekan_${VERSION}_${arch}.snap to make $name from. Retry the release's snap job first (recover does), then run this again."
|
||||
exit 1
|
||||
fi
|
||||
bash releases/snap-rename.sh "source/wekan_${VERSION}_${arch}.snap" "$name" "$title" out
|
||||
- name: Attach it to the release
|
||||
if: ${{ always() && steps.rename.outcome == 'success' }}
|
||||
env:
|
||||
GH_TOKEN: ${{ github.token }}
|
||||
run: |
|
||||
set -euo pipefail
|
||||
bash releases/github-release-upload.sh "$GITHUB_REPOSITORY" "v$VERSION" out/*.snap
|
||||
|
||||
# Every snap of the release, in every channel of its snap name: the same
|
||||
# "Push Snap to Store" that release-all.yml ends with. A revision the store
|
||||
# already has is released by number; nothing is uploaded twice.
|
||||
snap-store:
|
||||
needs: [plan, variants]
|
||||
if: ${{ !cancelled() && needs.plan.result == 'success' }}
|
||||
permissions:
|
||||
contents: read
|
||||
uses: ./.github/workflows/snap-store.yml
|
||||
with:
|
||||
tag: v${{ needs.plan.outputs.version }}
|
||||
snaps: wekan wekan-ondra wekan-gantt-gpl
|
||||
channels: stable,candidate,beta,edge
|
||||
secrets:
|
||||
SNAP_AUTH: ${{ secrets.SNAP_AUTH }}
|
||||
|
||||
# The end of the run attaches nothing: every job above attached its own files
|
||||
# as it finished them. This only reports what the release still lacks, and it
|
||||
# runs on always() - not !cancelled() - so a cancelled run still says what
|
||||
@@ -525,7 +646,7 @@ jobs:
|
||||
done:
|
||||
timeout-minutes: 15
|
||||
name: what is still missing
|
||||
needs: [plan, extra-arches, appimage, mac, flatpak, windows-exe, charts, bun]
|
||||
needs: [plan, extra-arches, appimage, mac, flatpak, windows-exe, charts, bun, variants, snap-store]
|
||||
if: ${{ always() && needs.plan.result == 'success' }}
|
||||
runs-on: ubuntu-latest
|
||||
steps:
|
||||
@@ -566,3 +687,10 @@ jobs:
|
||||
echo "::warning::v$V is still missing:${still}"
|
||||
echo "Still missing:\`${still# }\`" >> "$GITHUB_STEP_SUMMARY"
|
||||
fi
|
||||
# What only release-all.yml can build, still missing: red here,
|
||||
# once everything that could be built has been.
|
||||
case " $still" in
|
||||
*" meteor/"*|*" repack/"*|*" sandstorm/"*)
|
||||
echo "::error::v$V still lacks what only release-all.yml builds:${still}. Inspect the matching full-release run."
|
||||
exit 1 ;;
|
||||
esac
|
||||
@@ -5530,6 +5530,10 @@ jobs:
|
||||
needs: [prepare, release, snap-auth-check]
|
||||
continue-on-error: true
|
||||
timeout-minutes: 90
|
||||
# contents: write attaches the built snap to the GitHub Release; the
|
||||
# workflow's default is read.
|
||||
permissions:
|
||||
contents: write
|
||||
strategy:
|
||||
fail-fast: false
|
||||
matrix:
|
||||
@@ -5655,6 +5659,7 @@ jobs:
|
||||
echo "snap=$BUILT_SNAP" >> "$GITHUB_OUTPUT"
|
||||
|
||||
- name: Verify the built snap is ${{ matrix.snapname }}
|
||||
id: verify
|
||||
if: steps.guard.outputs.snap == 'true'
|
||||
env:
|
||||
STEP_BUILD_SNAP: ${{ steps.build.outputs.snap }}
|
||||
@@ -5684,6 +5689,21 @@ jobs:
|
||||
SNAP_UPLOAD_LABEL="${STEP_BUILD_SNAP}" \
|
||||
bash "$GITHUB_WORKSPACE/wekan/releases/snap-upload-retry.sh" "${STEP_BUILD_SNAP}" stable,candidate,beta,edge
|
||||
|
||||
# always(): a built variant snap goes onto the GitHub Release even when the
|
||||
# Snap Store push above failed. "Push Snap to Store"
|
||||
# (.github/workflows/snap-store.yml) releases the snaps OF A GITHUB
|
||||
# RELEASE to the store - and until v13.21 this job only uploaded to the
|
||||
# store, so v13.20 had no wekan-ondra_*.snap or wekan-gantt-gpl_*.snap and
|
||||
# that workflow failed with "no assets match the file pattern".
|
||||
- name: Attach the ${{ matrix.snapname }} ${{ matrix.arch }} snap to the GitHub Release
|
||||
if: ${{ always() && steps.verify.outcome == 'success' && steps.build.outputs.snap != '' }}
|
||||
env:
|
||||
GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
|
||||
STEP_BUILD_SNAP: ${{ steps.build.outputs.snap }}
|
||||
run: |
|
||||
set -euo pipefail
|
||||
bash "$GITHUB_WORKSPACE/wekan/releases/github-release-upload.sh" "${GITHUB_REPOSITORY:-wekan/wekan}" "v${VERSION}" "${STEP_BUILD_SNAP}"
|
||||
|
||||
# Always, as the last step: the run summary then answers "what worked and what
|
||||
# did not" for the whole release at a glance, instead of eighteen job logs. A
|
||||
# step that failed has already printed an ::error:: saying why; this names the
|
||||
@@ -5710,6 +5730,28 @@ jobs:
|
||||
|
||||
# Refresh the selected changelog notes after builds. Binary provenance remains
|
||||
# in build artifacts and is never appended to release notes.
|
||||
# ─── Finish the Snap Store release of all three snaps ───────────────────────
|
||||
# snap-native, snap-launchpad and snap-variants upload each snap with
|
||||
# --release to every channel, but the store can keep a revision in
|
||||
# "processing" for hours and then not release it: on v13.20 every snap job
|
||||
# was green and the store kept the old version of wekan, wekan-ondra and
|
||||
# wekan-gantt-gpl. This job takes the snaps those jobs attached to THIS
|
||||
# release and releases each to stable, candidate, beta and edge - a revision
|
||||
# the store already has by number, a missing one by uploading it - and is red
|
||||
# when one did not get there. It also runs by hand as "Push Snap to Store".
|
||||
snap-store:
|
||||
needs: [prepare, snap-native, snap-launchpad, snap-variants]
|
||||
if: ${{ !cancelled() && needs.prepare.result == 'success' }}
|
||||
permissions:
|
||||
contents: read
|
||||
uses: ./.github/workflows/snap-store.yml
|
||||
with:
|
||||
tag: v${{ needs.prepare.outputs.version }}
|
||||
snaps: wekan wekan-ondra wekan-gantt-gpl
|
||||
channels: stable,candidate,beta,edge
|
||||
secrets:
|
||||
SNAP_AUTH: ${{ secrets.SNAP_AUTH }}
|
||||
|
||||
release-notes:
|
||||
permissions:
|
||||
contents: write
|
||||
|
||||
@@ -0,0 +1,195 @@
|
||||
name: Push Snap to Store
|
||||
|
||||
# Puts the .snap files of a GitHub release on the Snap Store and RELEASES them
|
||||
# to every channel: wekan, wekan-ondra and wekan-gantt-gpl, every architecture
|
||||
# the release carries.
|
||||
#
|
||||
# WHY: release-all.yml uploads each snap as it builds it, with
|
||||
# `snapcraft upload --release=...`. The store can keep a revision in
|
||||
# "processing" for hours, and an upload that gives up waiting leaves the
|
||||
# release to the store - the job is green either way. On v13.20 every build
|
||||
# was green and the snaps were on the GitHub release, but the Snap Store kept
|
||||
# the old version. This workflow finishes that from the release itself,
|
||||
# without building anything: releases/snap-store-push.sh releases a revision
|
||||
# the store already has, uploads one it has not, waits for one still
|
||||
# processing, and FAILS - red, not green - when a snap still did not reach a
|
||||
# channel.
|
||||
#
|
||||
# "Release All Platforms" calls it as its last snap job, for the tag it just
|
||||
# released (its snap-store job), and it runs by hand from the Actions tab for
|
||||
# any release, snap names and channels. It used to run on workflow_run after
|
||||
# every Release All run and take "the latest release" - which, for a run that
|
||||
# finished before its release was published, was the previous one (v13.20).
|
||||
#
|
||||
# Secrets: SNAP_AUTH, as for release-all.yml - an exported login carrying
|
||||
# package_access, package_push, package_release and package_update for all
|
||||
# three names.
|
||||
|
||||
on:
|
||||
workflow_dispatch:
|
||||
inputs:
|
||||
tag:
|
||||
description: 'Release tag (e.g. v13.20). Empty: the latest release.'
|
||||
required: false
|
||||
default: ''
|
||||
snaps:
|
||||
description: 'Snap names, space separated'
|
||||
required: false
|
||||
default: 'wekan wekan-ondra wekan-gantt-gpl'
|
||||
channels:
|
||||
description: 'Channels to release to'
|
||||
required: false
|
||||
default: 'stable,candidate,beta,edge'
|
||||
workflow_call:
|
||||
inputs:
|
||||
tag:
|
||||
type: string
|
||||
required: true
|
||||
snaps:
|
||||
type: string
|
||||
required: false
|
||||
default: 'wekan wekan-ondra wekan-gantt-gpl'
|
||||
channels:
|
||||
type: string
|
||||
required: false
|
||||
default: 'stable,candidate,beta,edge'
|
||||
secrets:
|
||||
SNAP_AUTH:
|
||||
required: true
|
||||
|
||||
permissions:
|
||||
contents: read
|
||||
|
||||
concurrency:
|
||||
group: snap-store
|
||||
cancel-in-progress: false
|
||||
|
||||
env:
|
||||
DO_NOT_TRACK: 1
|
||||
|
||||
jobs:
|
||||
plan:
|
||||
runs-on: ubuntu-24.04
|
||||
timeout-minutes: 10
|
||||
outputs:
|
||||
tag: ${{ steps.plan.outputs.tag }}
|
||||
snaps: ${{ steps.plan.outputs.snaps }}
|
||||
channels: ${{ steps.plan.outputs.channels }}
|
||||
steps:
|
||||
- name: Which release, which snaps, which channels
|
||||
id: plan
|
||||
env:
|
||||
GH_TOKEN: ${{ github.token }}
|
||||
INPUT_TAG: ${{ inputs.tag }}
|
||||
INPUT_SNAPS: ${{ inputs.snaps }}
|
||||
INPUT_CHANNELS: ${{ inputs.channels }}
|
||||
run: |
|
||||
set -euo pipefail
|
||||
tag="${INPUT_TAG:-}"
|
||||
if [ -z "$tag" ]; then
|
||||
tag="$(gh release view --repo "$GITHUB_REPOSITORY" --json tagName --jq .tagName)"
|
||||
fi
|
||||
case "$tag" in v[0-9]*) ;; *) echo "::error::'$tag' is not a release tag like v13.20."; exit 1 ;; esac
|
||||
snaps="${INPUT_SNAPS:-wekan wekan-ondra wekan-gantt-gpl}"
|
||||
for s in $snaps; do
|
||||
case "$s" in wekan|wekan-ondra|wekan-gantt-gpl) ;; *) echo "::error::'$s' is not one of WeKan's snaps (wekan, wekan-ondra, wekan-gantt-gpl)."; exit 1 ;; esac
|
||||
done
|
||||
channels="${INPUT_CHANNELS:-stable,candidate,beta,edge}"
|
||||
case "$channels" in *[!a-z0-9/,.-]*) echo "::error::'$channels' is not a channel list."; exit 1 ;; esac
|
||||
echo "tag=$tag" >> "$GITHUB_OUTPUT"
|
||||
echo "snaps=$(printf '%s\n' $snaps | jq -R . | jq -cs .)" >> "$GITHUB_OUTPUT"
|
||||
echo "channels=$channels" >> "$GITHUB_OUTPUT"
|
||||
echo "Release $tag: $snaps -> $channels"
|
||||
|
||||
push:
|
||||
needs: [plan]
|
||||
runs-on: ubuntu-24.04
|
||||
# One snap name per job; its architectures one after another. A store
|
||||
# still processing may take the whole wait of snap-store-push.sh.
|
||||
timeout-minutes: 360
|
||||
strategy:
|
||||
fail-fast: false
|
||||
matrix:
|
||||
snap: ${{ fromJSON(needs.plan.outputs.snaps) }}
|
||||
steps:
|
||||
- uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
|
||||
with:
|
||||
sparse-checkout: releases
|
||||
persist-credentials: false
|
||||
- name: Install snapcraft and check SNAP_AUTH
|
||||
id: snapcraft
|
||||
env:
|
||||
SNAP_AUTH: ${{ secrets.SNAP_AUTH }}
|
||||
run: |
|
||||
set -euo pipefail
|
||||
if [ -z "${SNAP_AUTH:-}" ]; then
|
||||
echo "::error::SNAP_AUTH is not set. snapcraft export-login --snaps wekan,wekan-ondra,wekan-gantt-gpl --acls package_access,package_push,package_release,package_update snap-auth.txt && gh secret set SNAP_AUTH --repo wekan/wekan < snap-auth.txt"
|
||||
exit 1
|
||||
fi
|
||||
installed=""
|
||||
for i in 1 2 3 4 5; do
|
||||
if timeout 180 sudo snap install snapcraft --classic; then installed=1; break; fi
|
||||
sudo snap abort --last=install >/dev/null 2>&1 || true
|
||||
echo "snapcraft install attempt $i/5 failed; retrying in 30s..."
|
||||
sleep 30
|
||||
done
|
||||
[ -n "$installed" ] || { echo "::error::snapcraft could not be installed: the Snap Store did not answer. Re-run the job."; exit 1; }
|
||||
SNAPCRAFT_STORE_CREDENTIALS="$SNAP_AUTH" snapcraft whoami
|
||||
- name: Download ${{ matrix.snap }} from ${{ needs.plan.outputs.tag }}
|
||||
env:
|
||||
GH_TOKEN: ${{ github.token }}
|
||||
TAG: ${{ needs.plan.outputs.tag }}
|
||||
SNAP: ${{ matrix.snap }}
|
||||
run: |
|
||||
set -euo pipefail
|
||||
mkdir -p snaps
|
||||
# A release cut before v13.22 has no wekan-ondra or wekan-gantt-gpl
|
||||
# snap attached (snap-variants did not attach them). A variant IS
|
||||
# wekan with another name and title, so it is made from the
|
||||
# release's wekan snaps (releases/snap-rename.sh), as Release All
|
||||
# Missing does.
|
||||
if ! gh release download "$TAG" --repo "$GITHUB_REPOSITORY" --dir snaps --pattern "${SNAP}_*.snap"; then
|
||||
case "$SNAP" in
|
||||
wekan-ondra) title='Wekan Ondra' ;;
|
||||
wekan-gantt-gpl) title='Wekan Gantt GPL' ;;
|
||||
*) echo "::error::Release $TAG has no ${SNAP}_*.snap to push: its snap job did not attach one (snap-native and snap-launchpad attach wekan). Re-run that job of the release, or Release All Missing, then this workflow."; exit 1 ;;
|
||||
esac
|
||||
mkdir -p wekan-snaps
|
||||
if ! gh release download "$TAG" --repo "$GITHUB_REPOSITORY" --dir wekan-snaps --pattern "wekan_*.snap"; then
|
||||
echo "::error::Release $TAG has neither ${SNAP}_*.snap nor a wekan_*.snap to make it from. Re-run the release's snap jobs, or Release All Missing, then this workflow."
|
||||
exit 1
|
||||
fi
|
||||
sudo apt-get install -y squashfs-tools >/dev/null
|
||||
for f in wekan-snaps/wekan_*.snap; do
|
||||
bash releases/snap-rename.sh "$f" "$SNAP" "$title" snaps
|
||||
done
|
||||
echo "::notice::$TAG had no ${SNAP} snap; made it from the release's wekan snaps."
|
||||
fi
|
||||
ls -l snaps
|
||||
- name: Push ${{ matrix.snap }} to the Snap Store, releasing to ${{ needs.plan.outputs.channels }}
|
||||
env:
|
||||
SNAPCRAFT_STORE_CREDENTIALS: ${{ secrets.SNAP_AUTH }}
|
||||
CHANNELS: ${{ needs.plan.outputs.channels }}
|
||||
run: |
|
||||
set -euo pipefail
|
||||
failed=""
|
||||
for f in snaps/*.snap; do
|
||||
# Each architecture on its own: one that the store is still
|
||||
# processing does not stop the others.
|
||||
if ! bash releases/snap-store-push.sh "$f" "$CHANNELS"; then failed="$failed $(basename "$f")"; fi
|
||||
done
|
||||
if [ -n "$failed" ]; then
|
||||
echo "::error::Not released:$failed. The ::error:: lines above say why."
|
||||
exit 1
|
||||
fi
|
||||
# The newest revision the store has of each architecture, released to
|
||||
# every channel too - one that reached the store some other way, or a
|
||||
# reviewer approved later, whatever this release's files are. always():
|
||||
# also when a file above was not taken.
|
||||
- name: Release the newest ${{ matrix.snap }} revisions the store has to ${{ needs.plan.outputs.channels }}
|
||||
if: ${{ always() && steps.snapcraft.outcome == 'success' }}
|
||||
env:
|
||||
SNAPCRAFT_STORE_CREDENTIALS: ${{ secrets.SNAP_AUTH }}
|
||||
CHANNELS: ${{ needs.plan.outputs.channels }}
|
||||
SNAP: ${{ matrix.snap }}
|
||||
run: bash releases/snap-store-release-newest.sh "$SNAP" "$CHANNELS"
|
||||
+928
-951
File diff suppressed because it is too large.
Load diff
+37
-31
@@ -5,6 +5,43 @@ each one changed and the project status are in
|
||||
Written by `node releases/changelog-short.mjs` from CHANGELOG-big.md:
|
||||
make changes there.
|
||||
|
||||
# v13.23 2026-11-20 WeKan ® release
|
||||
|
||||
The **Import** page and the **Export** menu list a company's
|
||||
products under the company's name: **37signals**, **Atlassian**, **Google** and
|
||||
**Microsoft**.
|
||||
|
||||
[All changes in v13.23](CHANGELOG-big.md#v1323-2026-11-20-wekan--release)
|
||||
|
||||
# v13.22 2026-11-20 WeKan ® release
|
||||
|
||||
Repeating tasks of **Taskwarrior**, **Microsoft To Do**,
|
||||
**Todoist**, **TickTick**, **Tasks.org**, **Vikunja**, **Super Productivity**,
|
||||
**iCalendar**, **Org mode** and **Obsidian Kanban** now repeat in WeKan, and
|
||||
their exports write the repeat back. **Release All**
|
||||
builds and pushes **wekan**, **wekan-ondra** and **wekan-gantt-gpl** to every
|
||||
Snap Store channel, and **Release All Missing** adds what a release lacks,
|
||||
snaps included. A **WeKan board** imported from its own export keeps all of
|
||||
its Board Settings and card fields, and **Rocket.Chat** and **Fizzy** are
|
||||
imported and exported.
|
||||
|
||||
[All changes in v13.22](CHANGELOG-big.md#v1322-2026-11-20-wekan--release)
|
||||
|
||||
# v13.21 2026-11-20 WeKan ® release
|
||||
|
||||
Twelve new **Board View reports** - Created vs. Resolved, Net
|
||||
Flow, Time in List and more - and **grouped menus**: the Board View menu, the
|
||||
Import and Export lists and the list, card and swimlane menus have headings.
|
||||
WeKan imports **mail**, **calendars**, **chats** and **notes**, and large files
|
||||
are **streamed to disk** within the free space or an Admin Panel limit. Menu
|
||||
entries that did nothing now work. Cards get the **Kanban and Scrum flow
|
||||
fields** Blocked, Class of service, MoSCoW and WSJF, lists their **policies**,
|
||||
the board menu a **standup timer** and a **retrospective board**, every export
|
||||
is **written a page at a time**, and **InviteBleed** is closed for the old
|
||||
invitation codes too.
|
||||
|
||||
[All changes in v13.21](CHANGELOG-big.md#v1321-2026-11-20-wekan--release)
|
||||
|
||||
# v13.20 2026-11-19 WeKan ® release
|
||||
|
||||
The **REST API** card lists of a list and of a swimlane now carry
|
||||
@@ -21,34 +58,3 @@ to process an upload, or when a **Termux** or **BSD** package mirror has a bad
|
||||
minute.
|
||||
|
||||
[All changes in v13.19](CHANGELOG-big.md#v1319-2026-11-19-wekan--release)
|
||||
|
||||
# v13.18 2026-11-19 WeKan ® release
|
||||
|
||||
**Admin Panel / Problems** says what its numbers count - "New
|
||||
problems: 1" and "Checks with findings: 8 / 31", in every language - and a
|
||||
report row's address, location and user always belong to the same occurrence.
|
||||
|
||||
[All changes in v13.18](CHANGELOG-big.md#v1318-2026-11-19-wekan--release)
|
||||
|
||||
# v13.17 2026-11-19 WeKan ® release
|
||||
|
||||
The **Admin Panel** answers one question per tab: Settings gains
|
||||
**Appearance**, **Features**, **Feature profiles**, Security, Activities and
|
||||
notifications, and Delete, Problems keeps only what is going wrong, and every
|
||||
old
|
||||
address redirects. The docs now have a page for every menu entry, and cards of
|
||||
an archived swimlane no longer appear in the first swimlane.
|
||||
|
||||
[All changes in v13.17](CHANGELOG-big.md#v1317-2026-11-19-wekan--release)
|
||||
|
||||
# v13.16 2026-11-19 WeKan ® release
|
||||
|
||||
**ListLockBulkBleed** is fixed, and a list that refuses a role
|
||||
now also refuses that role's bulk writes, dependency lines, rule actions and
|
||||
changes to the list or swimlane itself. Administrators can give chosen users,
|
||||
teams and organizations a smaller WeKan with opt-in **feature profiles**. A
|
||||
server no longer runs out of memory in the hourly **History integrity audit**,
|
||||
**scheduled rules** can create cards again, and **Card Excel export** and
|
||||
clearing a card's text work again.
|
||||
|
||||
[All changes in v13.16](CHANGELOG-big.md#v1316-2026-11-19-wekan--release)
|
||||
+1
-1
@@ -38,7 +38,7 @@ FROM --platform=$BUILDPLATFORM debian:trixie AS bundle
|
||||
|
||||
ARG TARGETARCH
|
||||
ARG TARGETVARIANT
|
||||
ARG VERSION=13.20
|
||||
ARG VERSION=13.23
|
||||
ARG DEBIAN_FRONTEND=noninteractive
|
||||
|
||||
COPY --chmod=755 releases/check-telemetry.py /tmp/check-telemetry.py
|
||||
|
||||
@@ -44,8 +44,11 @@ that by providing one-click installation on various platforms.
|
||||
- Add Board / Import ([all import and export formats](docs/Features/Board-Sidebar/Board-Settings/Import-Export/External-Tools.md)):
|
||||
- WeKan JSON/.zip, CSV/TSV, Excel, Markdown, Obsidian Kanban, Leo, OPML, Org mode, todo.txt
|
||||
- Trello, Jira, Asana, Zenkit, Focalboard, Todoist, Microsoft Planner, MeisterTask, Linear, TickTick, ClickUp, Nullboard, Kanri, Pivotal Tracker, Redmine, Tasks.org, monday.com,
|
||||
Super Productivity, Taiga, Vikunja, Wrike (Excel and workflow), Quire, Teamwork.com, Businessmap, Notion, Plane
|
||||
- Kanboard, Nextcloud Deck, OpenProject, Taskwarrior
|
||||
Super Productivity, Taiga, Vikunja, Wrike (Excel and workflow), Quire, Teamwork.com, Businessmap, Notion, Fizzy, Plane
|
||||
- Kanboard, Nextcloud Deck, OpenProject, Taskwarrior, Planka, KanbanFlow, Basecamp, Microsoft To Do, Google Tasks
|
||||
- Mail (.eml/mbox), Calendars (iCalendar), Google Takeout, Google Keep, Evernote,
|
||||
Chats: Slack, Mattermost, Rocket.Chat, Telegram, WhatsApp, Discord - each into the view it fits
|
||||
- Large files are streamed to disk, within its free space or the Admin Panel limit
|
||||
- GitHub, GitLab, Gitea, Forgejo
|
||||
- Import many boards at once: several export files, or a .zip of them, each its own board;
|
||||
One board per project splits an export of a whole app into a board per project
|
||||
@@ -72,6 +75,9 @@ that by providing one-click installation on various platforms.
|
||||
- Minicard: At list there is card, that has not been not opened yet
|
||||
- Card: Opened card popup of minicard
|
||||
- Attachments viewer for PDF and Office documents
|
||||
- Kanban and Scrum flow fields: Blocked, Class of service, MoSCoW priority, WSJF score
|
||||
- List policies, Definition of Ready, commitment point, WIP limit per person,
|
||||
lists split into Doing and Done
|
||||
- Drag drop reorder one or Multi-Selection: Swimlanes, Lists, Minicards, Checklists, Checklist Items
|
||||
- Collapse/Uncollapse: Menus, Swimlanes, Lists, Cards
|
||||
- Table, Calendar, Multi Board Calendar, Time, Timeline
|
||||
@@ -82,6 +88,9 @@ that by providing one-click installation on various platforms.
|
||||
Lead Time, Throughtput Histogram, WIP Run, Pulse, Aging WIP,
|
||||
Blocker Analysis, Monte Carlo Forecasts, Process Behavior (XmR),
|
||||
Work Item Size vs Cycle Time, Map
|
||||
- Reports: Created vs. Resolved, Net Flow, Time in List, Average Age,
|
||||
Throughput Run Chart, Due Date Performance, Release Burndown, Epic Progress,
|
||||
Workload, Distribution, Dependency Map, Activity Heatmap - each with PDF and Excel export
|
||||
- Right Sidebar / Board Settings:
|
||||
- Rules: like IFTTT like Trello Butler
|
||||
- Lists view for Rules
|
||||
@@ -96,10 +105,11 @@ that by providing one-click installation on various platforms.
|
||||
Microsoft Planner, MeisterTask, Obsidian Kanban, Linear, TickTick, ClickUp, Nullboard, Kanri, Pivotal Tracker, Redmine, Tasks.org, monday.com,
|
||||
Super Productivity, Taiga, Vikunja, Wrike (Excel and workflow), Quire, Teamwork.com, Businessmap, Notion,
|
||||
Trello, Jira, NextCloud Deck, OpenProject, GitHub, GitLab,
|
||||
Gitea, Forgejo, Asana, Zenkit
|
||||
Gitea, Forgejo, Asana, Zenkit, Trello .zip with attachments, mbox, Evernote, Mattermost, Rocket.Chat, Fizzy
|
||||
- Every export is written a page of cards at a time, so a large board exports without running out of memory
|
||||
- Export all boards at once (All Boards sidebar, or Multi-Selection): Excel as one workbook
|
||||
with a sheet per board, every other format as a .zip with a file per board
|
||||
- Scrum Settings
|
||||
- Scrum Settings: Definition of Ready and Done, Daily standup timer, Retrospective board
|
||||
- Change color theme, Change Background Image, Date settings
|
||||
- Settings:
|
||||
- Board View: Show/Hide and drag drop reorder what is shown atat Public Board and Private Board
|
||||
@@ -108,7 +118,8 @@ that by providing one-click installation on various platforms.
|
||||
- Admin Panel
|
||||
- Settings
|
||||
- Version
|
||||
- Visibility: What is shown/hidden, Whitelabeling
|
||||
- Features: which features this WeKan offers, Card fields, Feature profiles
|
||||
- Appearance: What is shown/hidden, Whitelabeling
|
||||
- Announcement
|
||||
- Accessibility
|
||||
- Translation: Add custom translation strings
|
||||
|
||||
+1
-1
@@ -1,5 +1,5 @@
|
||||
appId: wekan-public/apps/77b94f60-dec9-0136-304e-16ff53095928
|
||||
appVersion: "v13.20.0"
|
||||
appVersion: "v13.23.0"
|
||||
files:
|
||||
userUploads:
|
||||
- README.md
|
||||
|
||||
@@ -20,28 +20,38 @@ the changelog only says what changed.
|
||||
- The WebKit stage cannot run in the Flatpak sandbox: MiniBrowser needs its own
|
||||
sandbox, and turning that off is not allowed there. Run it on a host.
|
||||
|
||||
## Found while documenting the menus, to fix
|
||||
## Need accounts on the tools, or a running copy of one
|
||||
|
||||
- Member menu / Edit Profile: with Admin Panel / People / Login **Username
|
||||
change** allowed, a user's new username is not saved - `setUsername`
|
||||
(`server/models/users.js`) writes only when the caller is a site admin, while
|
||||
`setEmail` beside it allows a self change when the setting says so. The popup
|
||||
closes as if it had saved. Found on 2026-11-19.
|
||||
- Member menu / Support: the Support page template has a case for signed-out
|
||||
visitors, but the `/support` route sends them to sign-in first, so that case is
|
||||
never reached; and `supportPopup` with its `.js-support` handler is no longer
|
||||
opened by the menu, which links to `/support`. Decide whether signed-out
|
||||
visitors should see the page, and remove the unused popup.
|
||||
- Card menu / Create board from this card: the entry sits under `unless
|
||||
canModifyCard` in `cardDetailsActionsPopup` (`client/components/cards/
|
||||
cardDetails.jade`), so a member who can edit the card does not see it, while
|
||||
the `createBoardFromCard` method requires write access. It was in both
|
||||
branches when added (17c6d8d9b9); a later refactor kept only this one. Check in
|
||||
the running app and restore it for members who can edit the card.
|
||||
- Board menu / All Boards Settings: the board menu entry is commented out
|
||||
("Bug Board icons random dance", [#4214](https://github.com/wekan/wekan/issues/4214)), so the popup cannot be reached.
|
||||
- Admin Panel / People / Shared templates: which group kinds the "Share template
|
||||
with" picker offers comes from the browser's `localStorage`
|
||||
(`sharedTemplatesScopes`), so it differs per browser and is empty in a browser
|
||||
where the admin never ticked them. An instance setting belongs in Settings.
|
||||
The import/export review asked on 2026-11-20 (everything each tool with a
|
||||
WeKan import or export can hold comes across, whole or in part) went through
|
||||
every parser and formatter against the export format its header documents.
|
||||
What it found is fixed and in the Upcoming release; the round trips are held
|
||||
by `tests/playwright/specs/export-import-round-trip.e2e.js` (41 formats, the
|
||||
description, checklist, comment, dependency, label and due date) and
|
||||
`tests/exportRoundTripFields.test.cjs` (32 formats in plain Node: start and
|
||||
creation dates, spent time, the done tick, recurrence, people, custom fields,
|
||||
color, Blocked), and a WeKan board's every field by
|
||||
`tests/wekanCardFields.test.cjs`. What is left needs what this checkout does
|
||||
not have:
|
||||
|
||||
- Each tool's newest release, checked with a real export file of it: Planner,
|
||||
Wrike, Teamwork, Businessmap, MeisterTask, Quire and Jira - the
|
||||
proprietary ones, whose current export is only seen with an account
|
||||
(Planner's newer Status, Task title and Assignments columns are read, as
|
||||
Microsoft's help page names them; a real file would confirm their exact
|
||||
spelling). The parsers follow
|
||||
the formats the tools document and report what they do not read, so a new
|
||||
field shows up in the import's loss report; checking for one needs an
|
||||
account on each tool. (Checked against their current source on 2026-11-20:
|
||||
Plane's IssueExportSerializer, Kanri's kanban-types.d.ts, Obsidian Kanban's
|
||||
markers, Nullboard's board object, and Gitea's (and Forgejo's) Issue
|
||||
struct, whose created_at, closed_at and time_estimate are read now;
|
||||
GitHub's REST issue, whose issue type is read now; GitLab's Issues API v4,
|
||||
whose health status and incident severity are read now. Redmine and
|
||||
monday.com import every column they do not name as a custom field, so a
|
||||
column a new release adds comes across without a change. Focalboard's archive
|
||||
format is frozen: Mattermost stopped merging changes to Focalboard and
|
||||
Boards in September 2023.
|
||||
Pivotal Tracker was shut down in 2025, so there is no newer release.
|
||||
Linear's open-source importer, @linear/import, declares the columns the
|
||||
parser reads.)
|
||||
@@ -2029,10 +2029,11 @@ if arguments >= 3 and sys.argv[1] == 'exportboardpdf':
|
||||
# { excelBase64 } (Plane's as { xlsxBase64 }), an export .zip as { zipBase64 },
|
||||
# a CSV/TSV file as rows, a text format as its text, and the rest as JSON.
|
||||
EXCEL_IMPORT_SOURCES = {'excel', 'planner', 'monday', 'wrike', 'teamwork', 'businessmap'}
|
||||
ZIP_IMPORT_SOURCES = {'vikunja', 'notion', 'plane'}
|
||||
ZIP_IMPORT_SOURCES = {'vikunja', 'notion', 'plane', 'slack', 'googletakeout', 'telegram', 'discord', 'rocketchat', 'fizzy'}
|
||||
TEXT_IMPORT_SOURCES = {'markdown', 'todotxt', 'taskwarrior', 'focalboard', 'todoist', 'meistertask', 'obsidian',
|
||||
'linear', 'ticktick', 'clickup', 'nullboard', 'pivotal', 'redmine', 'superproductivity',
|
||||
'quire', 'orgmode', 'leo', 'opml', 'vikunja', 'notion', 'plane'}
|
||||
'quire', 'orgmode', 'leo', 'opml', 'vikunja', 'notion', 'plane',
|
||||
'mail', 'ical', 'mattermost', 'whatsapp', 'evernote', 'slack', 'googletakeout', 'rocketchat', 'fizzy'}
|
||||
|
||||
def import_document(source, filepath):
|
||||
import base64, csv, io, os
|
||||
|
||||
@@ -110,6 +110,30 @@ template(name="boardBody")
|
||||
+processBehaviorView
|
||||
else if isViewSizeCycleTime
|
||||
+sizeCycleTimeView
|
||||
else if isViewCreatedResolved
|
||||
+createdResolvedView
|
||||
else if isViewNetFlow
|
||||
+netFlowView
|
||||
else if isViewTimeInList
|
||||
+timeInListView
|
||||
else if isViewAverageAge
|
||||
+averageAgeView
|
||||
else if isViewThroughputRun
|
||||
+throughputRunView
|
||||
else if isViewDueDatePerformance
|
||||
+dueDatePerformanceView
|
||||
else if isViewReleaseBurndown
|
||||
+releaseBurndownView
|
||||
else if isViewEpicProgress
|
||||
+epicProgressView
|
||||
else if isViewWorkload
|
||||
+workloadView
|
||||
else if isViewDistribution
|
||||
+distributionView
|
||||
else if isViewDependencyMap
|
||||
+dependencyMapView
|
||||
else if isViewActivityHeatmap
|
||||
+activityHeatmapView
|
||||
else if isViewPulse
|
||||
+pulseView
|
||||
else if isViewMap
|
||||
|
||||
@@ -964,6 +964,55 @@ Template.boardBody.helpers({
|
||||
return Utils.boardView() === 'board-view-size-cycle-time';
|
||||
},
|
||||
|
||||
// The reports of 2026-11-20 (models/lib/boardReports.js).
|
||||
isViewCreatedResolved() {
|
||||
return Utils.boardView() === 'board-view-created-resolved';
|
||||
},
|
||||
|
||||
isViewNetFlow() {
|
||||
return Utils.boardView() === 'board-view-net-flow';
|
||||
},
|
||||
|
||||
isViewTimeInList() {
|
||||
return Utils.boardView() === 'board-view-time-in-list';
|
||||
},
|
||||
|
||||
isViewAverageAge() {
|
||||
return Utils.boardView() === 'board-view-average-age';
|
||||
},
|
||||
|
||||
isViewThroughputRun() {
|
||||
return Utils.boardView() === 'board-view-throughput-run';
|
||||
},
|
||||
|
||||
isViewDueDatePerformance() {
|
||||
return Utils.boardView() === 'board-view-due-date-performance';
|
||||
},
|
||||
|
||||
isViewReleaseBurndown() {
|
||||
return Utils.boardView() === 'board-view-release-burndown';
|
||||
},
|
||||
|
||||
isViewEpicProgress() {
|
||||
return Utils.boardView() === 'board-view-epic-progress';
|
||||
},
|
||||
|
||||
isViewWorkload() {
|
||||
return Utils.boardView() === 'board-view-workload';
|
||||
},
|
||||
|
||||
isViewDistribution() {
|
||||
return Utils.boardView() === 'board-view-distribution';
|
||||
},
|
||||
|
||||
isViewDependencyMap() {
|
||||
return Utils.boardView() === 'board-view-dependency-map';
|
||||
},
|
||||
|
||||
isViewActivityHeatmap() {
|
||||
return Utils.boardView() === 'board-view-activity-heatmap';
|
||||
},
|
||||
|
||||
isViewMap() {
|
||||
return Utils.boardView() === 'board-view-map';
|
||||
},
|
||||
|
||||
@@ -983,3 +983,19 @@ body.board-view.mobile-mode #header #header-main-bar .board-header-sidebar-toggl
|
||||
font-size: calc(16px * var(--wekan-ui-font-scale, 1));
|
||||
}
|
||||
}
|
||||
|
||||
/* Board View menu: the heading over each group of views
|
||||
(models/lib/boardViewSettings.js BOARD_VIEW_GROUPS). */
|
||||
.pop-over-list .board-view-group-heading {
|
||||
padding: 8px 10px 2px;
|
||||
font-size: 0.8em;
|
||||
font-weight: bold;
|
||||
text-transform: uppercase;
|
||||
letter-spacing: 0.04em;
|
||||
color: #6b778c;
|
||||
cursor: default;
|
||||
}
|
||||
.pop-over-list .board-view-group-heading:not(:first-child) {
|
||||
margin-top: 4px;
|
||||
border-top: 1px solid #dfe1e6;
|
||||
}
|
||||
@@ -173,16 +173,18 @@ template(name="boardChangeWatchPopup")
|
||||
(js-open-<view>-view), which is what the click handlers in boardHeader.js
|
||||
listen for. docs/Features/Board-Sidebar/Board-Settings/Board-View.md
|
||||
template(name="boardChangeViewPopup")
|
||||
//- Grouped, a heading over each group (models/lib/boardViewSettings.js
|
||||
BOARD_VIEW_GROUPS), the board's own order inside a group.
|
||||
ul.pop-over-list
|
||||
each boardViewMenuEntries
|
||||
if groupLabelKey
|
||||
li.board-view-group-heading {{_ groupLabelKey}}
|
||||
li
|
||||
a.js-board-view-entry(class="{{jsClass}}")
|
||||
i.fa(class="{{icon}}")
|
||||
| {{_ labelKey}}
|
||||
if isCurrent
|
||||
i.fa.fa-check
|
||||
if separatorAfter
|
||||
hr
|
||||
|
||||
//- The Create Board form: a title, what the board is visible to, and Create.
|
||||
Four templates drew it letter for letter - the one on the All Boards page and
|
||||
|
||||
@@ -452,6 +452,55 @@ Template.boardChangeViewPopup.events({
|
||||
Utils.setBoardView('board-view-size-cycle-time');
|
||||
Popup.back();
|
||||
},
|
||||
// The reports of 2026-11-20 (models/lib/boardReports.js).
|
||||
'click .js-open-created-resolved-view'() {
|
||||
Utils.setBoardView('board-view-created-resolved');
|
||||
Popup.back();
|
||||
},
|
||||
'click .js-open-net-flow-view'() {
|
||||
Utils.setBoardView('board-view-net-flow');
|
||||
Popup.back();
|
||||
},
|
||||
'click .js-open-time-in-list-view'() {
|
||||
Utils.setBoardView('board-view-time-in-list');
|
||||
Popup.back();
|
||||
},
|
||||
'click .js-open-average-age-view'() {
|
||||
Utils.setBoardView('board-view-average-age');
|
||||
Popup.back();
|
||||
},
|
||||
'click .js-open-throughput-run-view'() {
|
||||
Utils.setBoardView('board-view-throughput-run');
|
||||
Popup.back();
|
||||
},
|
||||
'click .js-open-due-date-performance-view'() {
|
||||
Utils.setBoardView('board-view-due-date-performance');
|
||||
Popup.back();
|
||||
},
|
||||
'click .js-open-release-burndown-view'() {
|
||||
Utils.setBoardView('board-view-release-burndown');
|
||||
Popup.back();
|
||||
},
|
||||
'click .js-open-epic-progress-view'() {
|
||||
Utils.setBoardView('board-view-epic-progress');
|
||||
Popup.back();
|
||||
},
|
||||
'click .js-open-workload-view'() {
|
||||
Utils.setBoardView('board-view-workload');
|
||||
Popup.back();
|
||||
},
|
||||
'click .js-open-distribution-view'() {
|
||||
Utils.setBoardView('board-view-distribution');
|
||||
Popup.back();
|
||||
},
|
||||
'click .js-open-dependency-map-view'() {
|
||||
Utils.setBoardView('board-view-dependency-map');
|
||||
Popup.back();
|
||||
},
|
||||
'click .js-open-activity-heatmap-view'() {
|
||||
Utils.setBoardView('board-view-activity-heatmap');
|
||||
Popup.back();
|
||||
},
|
||||
'click .js-open-map-view'() {
|
||||
Utils.setBoardView('board-view-map');
|
||||
Popup.back();
|
||||
@@ -976,6 +1025,18 @@ Template.boardViewMenu.helpers({
|
||||
'board-view-chat': 'board-view-chat',
|
||||
'board-view-version-control': 'board-view-version-control',
|
||||
'board-view-column-sets': 'board-view-column-sets',
|
||||
'board-view-created-resolved': 'board-view-created-resolved',
|
||||
'board-view-net-flow': 'board-view-net-flow',
|
||||
'board-view-time-in-list': 'board-view-time-in-list',
|
||||
'board-view-average-age': 'board-view-average-age',
|
||||
'board-view-throughput-run': 'board-view-throughput-run',
|
||||
'board-view-due-date-performance': 'board-view-due-date-performance',
|
||||
'board-view-release-burndown': 'board-view-release-burndown',
|
||||
'board-view-epic-progress': 'board-view-epic-progress',
|
||||
'board-view-workload': 'board-view-workload',
|
||||
'board-view-distribution': 'board-view-distribution',
|
||||
'board-view-dependency-map': 'board-view-dependency-map',
|
||||
'board-view-activity-heatmap': 'board-view-activity-heatmap',
|
||||
};
|
||||
return TAPi18n.__(names[Utils.boardView()] || 'board-view');
|
||||
},
|
||||
|
||||
@@ -75,16 +75,11 @@ import { errorMessage } from '/client/lib/errorMessage';
|
||||
// SubsManager removed for Meteor 3 migration
|
||||
|
||||
// #5850: which sharing scopes (organizations/teams/domains) the admin enabled
|
||||
// in Admin Panel > People > Shared Templates (stored in localStorage, like the
|
||||
// Shared Templates admin UI). Used to gate the drag-to-share drop targets.
|
||||
// in Admin Panel > People > Shared Templates - an instance setting, the same in
|
||||
// every browser. Used to gate the drag-to-share drop targets.
|
||||
function loadSharedTemplatesScopes() {
|
||||
try {
|
||||
const raw = window.localStorage.getItem('sharedTemplatesScopes');
|
||||
const arr = raw ? JSON.parse(raw) : [];
|
||||
return Array.isArray(arr) ? arr : [];
|
||||
} catch (e) {
|
||||
return [];
|
||||
}
|
||||
const { sharedTemplatesScopes } = require('/models/lib/sharedTemplatesScopes');
|
||||
return sharedTemplatesScopes(ReactiveCache.getCurrentSetting());
|
||||
}
|
||||
|
||||
// #5850: share a (template) board with an Organization / Team / Domain by adding
|
||||
@@ -1178,7 +1173,7 @@ Template.boardList.helpers({
|
||||
return Template.instance().selectedMenu.get() === type;
|
||||
},
|
||||
// #5850: drag-to-share drop targets — the user's organizations/teams/domains,
|
||||
// gated by the admin's Shared Templates scopes (localStorage). Shown in the
|
||||
// gated by the admin's Shared Templates scopes (Settings). Shown in the
|
||||
// Templates view so a personal Template Board can be dragged onto one to share.
|
||||
shareTargets() {
|
||||
const scopes = loadSharedTemplatesScopes();
|
||||
|
||||
@@ -51,3 +51,42 @@ template(name="processBehaviorView")
|
||||
|
||||
template(name="sizeCycleTimeView")
|
||||
+boardChartView(chartKey="sizeCycleTime" titleKey="board-view-size-cycle-time")
|
||||
|
||||
//- The reports of 2026-11-20 (models/lib/boardReports.js): each answers bars and
|
||||
a table, drawn and exported by boardChartView like the charts above.
|
||||
|
||||
template(name="createdResolvedView")
|
||||
+boardChartView(chartKey="createdResolved" titleKey="board-view-created-resolved")
|
||||
|
||||
template(name="netFlowView")
|
||||
+boardChartView(chartKey="netFlow" titleKey="board-view-net-flow")
|
||||
|
||||
template(name="timeInListView")
|
||||
+boardChartView(chartKey="timeInList" titleKey="board-view-time-in-list")
|
||||
|
||||
template(name="averageAgeView")
|
||||
+boardChartView(chartKey="averageAge" titleKey="board-view-average-age")
|
||||
|
||||
template(name="throughputRunView")
|
||||
+boardChartView(chartKey="throughputRun" titleKey="board-view-throughput-run")
|
||||
|
||||
template(name="dueDatePerformanceView")
|
||||
+boardChartView(chartKey="dueDatePerformance" titleKey="board-view-due-date-performance")
|
||||
|
||||
template(name="releaseBurndownView")
|
||||
+boardChartView(chartKey="releaseBurndown" titleKey="board-view-release-burndown")
|
||||
|
||||
template(name="epicProgressView")
|
||||
+boardChartView(chartKey="epicProgress" titleKey="board-view-epic-progress")
|
||||
|
||||
template(name="workloadView")
|
||||
+boardChartView(chartKey="workload" titleKey="board-view-workload")
|
||||
|
||||
template(name="distributionView")
|
||||
+boardChartView(chartKey="distribution" titleKey="board-view-distribution")
|
||||
|
||||
template(name="dependencyMapView")
|
||||
+boardChartView(chartKey="dependencyMap" titleKey="board-view-dependency-map")
|
||||
|
||||
template(name="activityHeatmapView")
|
||||
+boardChartView(chartKey="activityHeatmap" titleKey="board-view-activity-heatmap")
|
||||
@@ -15,6 +15,18 @@ const PLACEHOLDER_VIEW_TEMPLATES = [
|
||||
'throughputHistogramView',
|
||||
'wipRunView',
|
||||
'pulseView',
|
||||
'createdResolvedView',
|
||||
'netFlowView',
|
||||
'timeInListView',
|
||||
'averageAgeView',
|
||||
'throughputRunView',
|
||||
'dueDatePerformanceView',
|
||||
'releaseBurndownView',
|
||||
'epicProgressView',
|
||||
'workloadView',
|
||||
'distributionView',
|
||||
'dependencyMapView',
|
||||
'activityHeatmapView',
|
||||
];
|
||||
|
||||
PLACEHOLDER_VIEW_TEMPLATES.forEach(name => {
|
||||
|
||||
@@ -98,6 +98,12 @@ function barsFromSeries(series, valueKey, labelKey) {
|
||||
|
||||
function computeBarRows(chartKey, data) {
|
||||
if (!data) return [];
|
||||
// The reports (models/lib/boardReports.js) answer their bars ready to draw.
|
||||
if (Array.isArray(data.bars)) {
|
||||
const { labelText } = require('/models/lib/boardReports');
|
||||
return data.bars.map(bar => ({ label: labelText(bar.label, (key, fallback) => TAPi18n.__(key) || fallback),
|
||||
value: Math.round((Number(bar.value) || 0) * 100) / 100 }));
|
||||
}
|
||||
if (chartKey === 'burndown') return barsFromSeries(data.series, 'remaining', 'day');
|
||||
if (chartKey === 'burnup') return barsFromSeries(data.series, 'completed', 'day');
|
||||
if (chartKey === 'wipRun') return barsFromSeries(data.series, 'count', 'day');
|
||||
|
||||
@@ -238,11 +238,18 @@ const EXPORT_FORMAT_GROUPS = [
|
||||
// Straight into Trello through its API (server/trelloApiExport.js), not
|
||||
// a file: an action that opens its own popup.
|
||||
{ key: 'trello-api', icon: 'fa-trello', label: 'Trello', action: 'js-export-to-trello', scopes: BOARD_ONLY },
|
||||
// Trello's board.json with the cards' attachments as files, the .zip
|
||||
// the Trello import reads (server/lib/renderExternalExport.js streamTrelloZip).
|
||||
{ key: 'trellozip', icon: 'fa-file-archive-o', labelKey: 'attachments', labelPrefix: 'Trello .zip', path: 'export/trellozip', ext: 'zip', scopes: BOARD_ONLY },
|
||||
{ key: 'kanboard', icon: 'fa-upload', label: 'Kanboard', path: 'export/kanboard', ext: 'json', scopes: BOARD_ONLY },
|
||||
{ key: 'markdown', icon: 'fa-file-text-o', label: 'Markdown', path: 'export/markdown', ext: 'md', scopes: BOARD_ONLY },
|
||||
{ key: 'leo', icon: 'fa-sitemap', label: 'Leo', path: 'export/leo', ext: 'leo', scopes: BOARD_ONLY },
|
||||
{ key: 'opml', icon: 'fa-indent', label: 'OPML', path: 'export/opml', ext: 'opml', scopes: BOARD_ONLY },
|
||||
{ key: 'orgmode', icon: 'fa-list-alt', label: 'Org mode', path: 'export/orgmode', ext: 'org', scopes: BOARD_ONLY },
|
||||
{ key: 'mbox', icon: 'fa-envelope-o', label: 'Mail (mbox)', path: 'export/mbox', ext: 'mbox', scopes: BOARD_ONLY },
|
||||
{ key: 'enex', icon: 'fa-sticky-note', label: 'Evernote (.enex)', path: 'export/enex', ext: 'enex', scopes: BOARD_ONLY },
|
||||
{ key: 'mattermost', icon: 'fa-comments', label: 'Mattermost', path: 'export/mattermost', ext: 'jsonl', scopes: BOARD_ONLY },
|
||||
{ key: 'rocketchat', icon: 'fa-comments', label: 'Rocket.Chat', path: 'export/rocketchat', ext: 'zip', scopes: BOARD_ONLY },
|
||||
{ key: 'todotxt', icon: 'fa-list-ul', label: 'todo.txt', path: 'export/todotxt', ext: 'txt', scopes: BOARD_ONLY },
|
||||
{ key: 'taskwarrior', icon: 'fa-terminal', label: 'Taskwarrior', path: 'export/taskwarrior', ext: 'json', scopes: BOARD_ONLY },
|
||||
{ key: 'focalboard', icon: 'fa-th-large', label: 'Focalboard', path: 'export/focalboard', ext: 'jsonl', scopes: BOARD_ONLY },
|
||||
@@ -261,6 +268,7 @@ const EXPORT_FORMAT_GROUPS = [
|
||||
{ key: 'monday', icon: 'fa-table', label: 'monday.com', path: 'export/monday', ext: 'xlsx', scopes: BOARD_ONLY },
|
||||
{ key: 'superproductivity', icon: 'fa-check-circle-o', label: 'Super Productivity', path: 'export/superproductivity', ext: 'json', scopes: BOARD_ONLY },
|
||||
{ key: 'vikunja', icon: 'fa-file-archive-o', label: 'Vikunja', path: 'export/vikunja', ext: 'zip', scopes: BOARD_ONLY },
|
||||
{ key: 'fizzy', icon: 'fa-file-archive-o', label: 'Fizzy', path: 'export/fizzy', ext: 'zip', scopes: BOARD_ONLY },
|
||||
{ key: 'wrike', icon: 'fa-table', label: 'Wrike', path: 'export/wrike', ext: 'xlsx', scopes: BOARD_ONLY },
|
||||
{ key: 'wrikeworkflow', icon: 'fa-sitemap', label: 'Wrike workflow', path: 'export/wrikeworkflow', ext: 'json', scopes: BOARD_ONLY },
|
||||
{ key: 'teamwork', icon: 'fa-table', label: 'Teamwork.com', path: 'export/teamwork', ext: 'xlsx', scopes: BOARD_ONLY },
|
||||
@@ -316,7 +324,22 @@ function resolvedFormatGroups() {
|
||||
url: entry.path ? exportUrl(`/api/boards/:boardId/${entry.path}`, entry.query || {}) : '',
|
||||
})),
|
||||
}))
|
||||
.filter(group => group.entries.length);
|
||||
.filter(group => group.entries.length)
|
||||
// The other tools' formats under headings by kind (models/lib/toolGroups.js),
|
||||
// the same groups as the Import page; WeKan's own JSON keeps "JSON", and
|
||||
// a company with several products is headed by the company's name.
|
||||
.flatMap(group => {
|
||||
if (group.key !== 'json') return [group];
|
||||
const { groupTools } = require('/models/lib/toolGroups');
|
||||
const parts = [];
|
||||
for (const entry of groupTools(group.entries)) {
|
||||
if (entry.groupStart) {
|
||||
parts.push({ key: `json-${entry.group}`, heading: entry.groupLabelKey ? TAPi18n.__(entry.groupLabelKey) : entry.groupLabel || group.heading, entries: [] });
|
||||
}
|
||||
parts[parts.length - 1].entries.push(entry);
|
||||
}
|
||||
return parts;
|
||||
});
|
||||
}
|
||||
|
||||
// Import writes to the board, so unlike export it is offered only to somebody
|
||||
|
||||
@@ -63,3 +63,8 @@
|
||||
global form rules give selects one row's height; show a few rows. */
|
||||
.scrum-view select[multiple], .scrum-metadata select[multiple] { min-height: 5.5em; height: auto; }
|
||||
.scrum-multiple-help { display: block; opacity: .8; max-width: 32em; }
|
||||
|
||||
/* The Definition of Ready and of Done, readable by every member. */
|
||||
.scrum-definition .scrum-definition-text {
|
||||
white-space: pre-wrap;
|
||||
}
|
||||
@@ -33,6 +33,16 @@ template(name="scrumView")
|
||||
p {{_ 'scrum-history-job-running' done=historyJob.done total=historyJob.total}}
|
||||
.scrum-progress
|
||||
.scrum-progress-bar(style=historyJob.style)
|
||||
//- The team's Definition of Ready and Definition of Done, readable by
|
||||
every member - the settings below are the board admin's.
|
||||
if settings.definitionOfReady
|
||||
details.scrum-definition.js-scrum-definition-of-ready
|
||||
summary {{_ 'scrum-definition-of-ready'}}
|
||||
p.scrum-definition-text= settings.definitionOfReady
|
||||
if settings.definitionOfDone
|
||||
details.scrum-definition.js-scrum-definition-of-done
|
||||
summary {{_ 'scrum-definition-of-done'}}
|
||||
p.scrum-definition-text= settings.definitionOfDone
|
||||
if canAdmin
|
||||
details.scrum-settings(open=settingsOpen)
|
||||
summary {{_ 'scrum-settings'}}
|
||||
@@ -42,8 +52,21 @@ template(name="scrumView")
|
||||
| {{_ 'scrum-enabled'}}
|
||||
label {{_ 'scrum-product-goal'}}
|
||||
textarea(name="productGoal") {{settings.productGoal}}
|
||||
//- Definition of Ready (2026-11-20): when a backlog item may be
|
||||
taken into a sprint, beside the Definition of Done.
|
||||
label {{_ 'scrum-definition-of-ready'}}
|
||||
textarea(name="definitionOfReady") {{settings.definitionOfReady}}
|
||||
label {{_ 'scrum-definition-of-done'}}
|
||||
textarea(name="definitionOfDone") {{settings.definitionOfDone}}
|
||||
//- The meeting helpers of the board menu (scrumMeetings.js).
|
||||
label
|
||||
input(type="checkbox" name="standupTimer" checked=settings.standupTimer)
|
||||
| {{_ 'daily-standup'}}
|
||||
label {{_ 'standup-minutes'}}
|
||||
input(type="number" name="standupMinutes" min="1" max="15" value=settings.standupMinutes)
|
||||
label
|
||||
input(type="checkbox" name="retrospectiveBoard" checked=settings.retrospectiveBoard)
|
||||
| {{_ 'retrospective-board'}}
|
||||
each accountabilityFields
|
||||
label {{label}}
|
||||
select(name=field multiple=multiple)
|
||||
|
||||
@@ -306,7 +306,10 @@ Template.scrumView.events({
|
||||
event.preventDefault(); const values = fields(event.currentTarget);
|
||||
const formData = new FormData(event.currentTarget);
|
||||
await mutate(tpl, 'scrum.configure', { enabled: values.enabled === 'on', productGoal: values.productGoal,
|
||||
definitionOfDone: values.definitionOfDone, estimateSource: values.estimateSource,
|
||||
definitionOfDone: values.definitionOfDone, definitionOfReady: values.definitionOfReady,
|
||||
standupTimer: values.standupTimer === 'on', retrospectiveBoard: values.retrospectiveBoard === 'on',
|
||||
standupMinutes: require('/models/lib/scrumMeetings').standupMinutes(values.standupMinutes),
|
||||
estimateSource: values.estimateSource,
|
||||
estimateCustomFieldId: nullable(values.estimateCustomFieldId), estimateUnit: values.estimateUnit,
|
||||
completionPolicy: values.completionPolicy, productOwnerId: nullable(values.productOwnerId),
|
||||
scrumMasterId: nullable(values.scrumMasterId), developerIds: formData.getAll('developerIds'),
|
||||
|
||||
@@ -398,6 +398,8 @@ template(name="cardFieldSectionDate")
|
||||
template(name="cardFieldSectionMembers")
|
||||
+cardSectionHeader(section="members" icon="fa-users" label="members")
|
||||
if isSectionOpen "members"
|
||||
//- The board's WIP limit per person (listFlowPolicies.jade).
|
||||
+cardPersonWipWarnings(card=this)
|
||||
.card-details-group-body
|
||||
each field in orderedMembersFields
|
||||
if $eq field "members"
|
||||
@@ -548,6 +550,19 @@ template(name="cardFieldSectionCard")
|
||||
a.js-add-dependency(title="{{_ 'add-dependency'}}")
|
||||
i.fa.fa-plus
|
||||
| {{_ 'add-dependency'}}
|
||||
//- The Kanban and Scrum flow fields (docs/Features/Cards/Flow-Fields.md).
|
||||
if $eq field "blocked"
|
||||
if currentBoard.allowsBlockedOnCard
|
||||
+cardFlowBlocked(card=this canModifyCard=canModifyCard)
|
||||
if $eq field "classOfService"
|
||||
if currentBoard.allowsClassOfServiceOnCard
|
||||
+cardFlowClassOfService(card=this canModifyCard=canModifyCard)
|
||||
if $eq field "moscow"
|
||||
if currentBoard.allowsMoscowOnCard
|
||||
+cardFlowMoscow(card=this canModifyCard=canModifyCard)
|
||||
if $eq field "wsjf"
|
||||
if currentBoard.allowsWsjfOnCard
|
||||
+cardFlowWsjf(card=this canModifyCard=canModifyCard)
|
||||
if $eq field "cardSortingByNumber"
|
||||
if currentBoard.allowsCardSortingByNumber
|
||||
.card-details-item.card-details-sort-order
|
||||
@@ -1141,9 +1156,13 @@ template(name="cardDetailsActionsPopup")
|
||||
Planning Poker, Change spent time and Card kind are in the hamburger of
|
||||
their own section of the opened card, and in Card Settings' pane of that
|
||||
section (docs/Features/Cards/Card-Fields.md).
|
||||
//- Grouped under headings (2026-11-20): Move and copy, Watch, Appearance,
|
||||
Share and history, Archive. Every entry keeps its own condition; a heading
|
||||
sits inside its group's.
|
||||
if currentUser
|
||||
ul.pop-over-list
|
||||
if cardMenuWrites
|
||||
li.menu-group-heading {{_ 'menu-group-move-copy'}}
|
||||
if currentUser.isBoardAdmin
|
||||
li
|
||||
a.js-move-card
|
||||
@@ -1175,6 +1194,7 @@ template(name="cardDetailsActionsPopup")
|
||||
a.js-move-card-to-bottom
|
||||
i.fa.fa-arrow-down
|
||||
| {{_ 'moveCardToBottom-title'}}
|
||||
li.menu-group-heading {{_ 'watch'}}
|
||||
li
|
||||
a.js-toggle-watch-card
|
||||
if isWatching
|
||||
@@ -1196,6 +1216,7 @@ template(name="cardDetailsActionsPopup")
|
||||
unless currentUser.isWorker
|
||||
hr
|
||||
ul.pop-over-list
|
||||
li.menu-group-heading {{_ 'appearance'}}
|
||||
li
|
||||
a.js-set-card-color
|
||||
i.fa.fa-paint-brush
|
||||
@@ -1214,6 +1235,7 @@ template(name="cardDetailsActionsPopup")
|
||||
| {{_ 'action-items-create'}}
|
||||
hr
|
||||
ul.pop-over-list
|
||||
li.menu-group-heading {{_ 'menu-group-share'}}
|
||||
if currentUser
|
||||
//- Copy link, named - the card's header carried this as an icon with only
|
||||
a tooltip. docs/Features/General/Board-Item-Links.md
|
||||
@@ -1254,6 +1276,7 @@ template(name="cardDetailsActionsPopup")
|
||||
if currentUser
|
||||
if cardMenuWrites
|
||||
unless currentUser.isWorker
|
||||
li.menu-group-heading {{_ 'archives'}}
|
||||
if archived
|
||||
li
|
||||
a.js-restore-archived-card
|
||||
@@ -1269,12 +1292,14 @@ template(name="cardDetailsActionsPopup")
|
||||
span.emoji-icon
|
||||
i.fa.fa-link
|
||||
| {{_ 'cardMorePopup-title'}}
|
||||
unless canModifyCard
|
||||
if boardCreationAllowed
|
||||
li
|
||||
a.js-create-board-from-card
|
||||
i.fa.fa-external-link
|
||||
| {{_ 'linkCardToNewBoard'}}
|
||||
//- For every member who may write the card (cardMenuWrites, not a
|
||||
Worker), as when it was added; createBoardFromCard checks the same
|
||||
write access and the assigned-only scope on the server.
|
||||
if boardCreationAllowed
|
||||
li
|
||||
a.js-create-board-from-card
|
||||
i.fa.fa-external-link
|
||||
| {{_ 'linkCardToNewBoard'}}
|
||||
span.copied-tooltip {{_ 'copied'}}
|
||||
|
||||
//- #1173: the card export popup IS the shared export body - the same checkbox
|
||||
|
||||
@@ -933,6 +933,9 @@ function cardSectionHasContent(card, board, id) {
|
||||
case 'card': {
|
||||
const swimlane = typeof card?.swimlane === 'function' ? card.swimlane() : null;
|
||||
return Boolean(board.allowsDependencies || board.allowsCardSortingByNumber || board.allowsShowLists
|
||||
// The flow fields (models/lib/cardFlow.js).
|
||||
|| board.allowsBlockedOnCard || board.allowsClassOfServiceOnCard || board.allowsMoscowOnCard
|
||||
|| board.allowsWsjfOnCard
|
||||
|| (board.allowsSwimlaneNameOnCard && swimlane && swimlane.title)
|
||||
|| (board.allowsCardButtonsOnCard !== false && cardHasButtons(card)));
|
||||
}
|
||||
|
||||
@@ -0,0 +1,69 @@
|
||||
/* The Kanban and Scrum flow fields (docs/Features/Cards/Flow-Fields.md). */
|
||||
/* Blocked is a labelled native checkbox; the app-wide material form rule hides
|
||||
native checkboxes three ways (display, visibility, an offset), so all three
|
||||
are undone, as in scrumView.css. */
|
||||
.card-flow-blocked-toggle input[type="checkbox"] {
|
||||
display: inline-block;
|
||||
visibility: visible;
|
||||
position: static;
|
||||
inset-inline-start: auto;
|
||||
width: 16px;
|
||||
height: 16px;
|
||||
min-height: 0;
|
||||
margin: 0;
|
||||
margin-inline-end: 4px;
|
||||
padding: 0;
|
||||
vertical-align: middle;
|
||||
}
|
||||
.card-details-item-flow-blocked.is-blocked .card-details-item-title,
|
||||
.card-flow-blocked-text {
|
||||
color: #c0392b;
|
||||
}
|
||||
.card-details-item-flow-blocked .js-card-flow-blocked-reason {
|
||||
display: block;
|
||||
width: 100%;
|
||||
margin-top: 4px;
|
||||
}
|
||||
.card-flow-blocked-since {
|
||||
font-size: 0.85em;
|
||||
}
|
||||
.card-flow-wsjf-score {
|
||||
margin-inline-start: 6px;
|
||||
font-weight: bold;
|
||||
}
|
||||
.card-flow-wsjf-parts {
|
||||
display: flex;
|
||||
flex-wrap: wrap;
|
||||
gap: 4px 12px;
|
||||
}
|
||||
.card-flow-wsjf-part {
|
||||
display: inline-flex;
|
||||
align-items: center;
|
||||
gap: 4px;
|
||||
}
|
||||
.minicard .badges .minicard-flow-blocked {
|
||||
color: #fff;
|
||||
background: #c0392b;
|
||||
border-radius: 3px;
|
||||
padding: 0 4px;
|
||||
}
|
||||
.minicard .badges .minicard-flow-class.flow-class-expedite {
|
||||
color: #fff;
|
||||
background: #d35400;
|
||||
border-radius: 3px;
|
||||
padding: 0 4px;
|
||||
}
|
||||
.minicard .badges .minicard-flow-class.flow-class-fixed-date {
|
||||
color: #8e44ad;
|
||||
}
|
||||
.minicard .badges .minicard-flow-moscow {
|
||||
border: 1px solid currentColor;
|
||||
border-radius: 3px;
|
||||
padding: 0 4px;
|
||||
}
|
||||
.minicard .badges .minicard-flow-moscow.flow-moscow-must {
|
||||
color: #c0392b;
|
||||
}
|
||||
.minicard .badges .minicard-flow-moscow.flow-moscow-wont {
|
||||
color: #7f8c8d;
|
||||
}
|
||||
@@ -0,0 +1,66 @@
|
||||
//- The Kanban and Scrum flow fields of the opened card (models/lib/cardFlow.js,
|
||||
docs/Features/Cards/Flow-Fields.md): each a row of Board Settings / Card,
|
||||
drawn in the Card section. Saved through the setCardFlow method.
|
||||
template(name="cardFlowBlocked")
|
||||
with flowOf card
|
||||
.card-details-item.card-details-item-flow-blocked(class="{{#if blocked}}is-blocked{{/if}}")
|
||||
h3.card-details-item-title
|
||||
i.fa.fa-ban
|
||||
| {{_ 'card-blocked'}}
|
||||
if ../canModifyCard
|
||||
label.card-flow-blocked-toggle
|
||||
input.js-card-flow-blocked(type="checkbox" checked=blocked)
|
||||
| {{_ 'card-blocked'}}
|
||||
if blocked
|
||||
input.js-card-flow-blocked-reason(type="text" maxlength="1000" value=blockedReason placeholder="{{_ 'card-blocked-reason'}}")
|
||||
else
|
||||
if blocked
|
||||
span.card-flow-blocked-text {{_ 'card-blocked'}}{{#if blockedReason}}: {{blockedReason}}{{/if}}
|
||||
if blocked
|
||||
if blockedAt
|
||||
.card-flow-blocked-since.quiet {{_ 'card-blocked-since' date=(flowDate blockedAt) user=(flowUser blockedBy)}}
|
||||
|
||||
template(name="cardFlowClassOfService")
|
||||
with flowOf card
|
||||
.card-details-item.card-details-item-flow-class
|
||||
h3.card-details-item-title
|
||||
i.fa.fa-road
|
||||
| {{_ 'class-of-service'}}
|
||||
if ../canModifyCard
|
||||
select.js-card-flow-class
|
||||
each option in classOptions
|
||||
option(value=option.value selected=option.selected) {{#if option.labelKey}}{{_ option.labelKey}}{{else}}-{{/if}}
|
||||
else
|
||||
span.card-flow-value {{#if classLabelKey}}{{_ classLabelKey}}{{else}}-{{/if}}
|
||||
|
||||
template(name="cardFlowMoscow")
|
||||
with flowOf card
|
||||
.card-details-item.card-details-item-flow-moscow
|
||||
h3.card-details-item-title
|
||||
i.fa.fa-sort-amount-desc
|
||||
| {{_ 'moscow-priority'}}
|
||||
if ../canModifyCard
|
||||
select.js-card-flow-moscow
|
||||
each option in moscowOptions
|
||||
option(value=option.value selected=option.selected) {{#if option.labelKey}}{{_ option.labelKey}}{{else}}-{{/if}}
|
||||
else
|
||||
span.card-flow-value {{#if moscowLabelKey}}{{_ moscowLabelKey}}{{else}}-{{/if}}
|
||||
|
||||
template(name="cardFlowWsjf")
|
||||
with flowOf card
|
||||
.card-details-item.card-details-item-flow-wsjf
|
||||
h3.card-details-item-title
|
||||
i.fa.fa-balance-scale
|
||||
| {{_ 'wsjf-score'}}
|
||||
if wsjfScore
|
||||
span.card-flow-wsjf-score {{wsjfScore}}
|
||||
.card-flow-wsjf-parts
|
||||
each part in wsjfParts
|
||||
label.card-flow-wsjf-part
|
||||
span {{_ part.labelKey}}
|
||||
if ../canModifyCard
|
||||
select.js-card-flow-wsjf(data-part=part.key)
|
||||
each option in part.options
|
||||
option(value=option.value selected=option.selected) {{option.text}}
|
||||
else
|
||||
span.card-flow-value {{#if part.value}}{{part.value}}{{else}}-{{/if}}
|
||||
@@ -0,0 +1,87 @@
|
||||
// The Kanban and Scrum flow fields of a card (models/lib/cardFlow.js,
|
||||
// docs/Features/Cards/Flow-Fields.md): the opened card's rows and the
|
||||
// minicard's `cardFlowOf` helper. Every change goes through setCardFlow, which
|
||||
// checks the card edit right and the Expedite limit on the server.
|
||||
import { Meteor } from 'meteor/meteor';
|
||||
import { Template } from 'meteor/templating';
|
||||
import { ReactiveCache } from '/imports/reactiveCache';
|
||||
import { TAPi18n } from '/imports/i18n';
|
||||
|
||||
const { flowView, CLASSES_OF_SERVICE, MOSCOW, WSJF_PARTS, WSJF_SCALE, CLASS_LABEL, MOSCOW_LABEL } = require('/models/lib/cardFlow');
|
||||
|
||||
const WSJF_LABEL = { businessValue: 'wsjf-business-value', timeCriticality: 'wsjf-time-criticality',
|
||||
riskReduction: 'wsjf-risk-reduction', jobSize: 'wsjf-job-size' };
|
||||
|
||||
// A linked card shows its source's flow, as the server writes it.
|
||||
function sourceOf(card) {
|
||||
if (card && typeof card.isLinkedCard === 'function' && card.isLinkedCard()) {
|
||||
return ReactiveCache.getCard(card.linkedId) || card;
|
||||
}
|
||||
return card;
|
||||
}
|
||||
|
||||
Template.registerHelper('cardFlowOf', card => {
|
||||
const view = flowView(sourceOf(card));
|
||||
return view.blocked || view.classOfService || view.moscow || view.wsjfScore ? view : null;
|
||||
});
|
||||
|
||||
function choices(values, labels, chosen) {
|
||||
return [{ value: '', labelKey: null, selected: !chosen },
|
||||
...values.map(value => ({ value, labelKey: labels[value], selected: value === chosen }))];
|
||||
}
|
||||
|
||||
function save(card, patch) {
|
||||
Meteor.callAsync('setCardFlow', card._id, patch).catch(error => {
|
||||
if (error && error.error === 'expedite-limit') window.alert(TAPi18n.__('expedite-limit'));
|
||||
else window.alert((error && (error.reason || error.error)) || String(error));
|
||||
});
|
||||
}
|
||||
|
||||
const helpers = {
|
||||
flowOf(card) { return flowView(sourceOf(card)); },
|
||||
flowDate(date) { return date ? new Date(date).toLocaleString() : ''; },
|
||||
flowUser(userId) {
|
||||
const user = userId && ReactiveCache.getUser(userId);
|
||||
return (user && (user.profile?.fullname || user.username)) || '-';
|
||||
},
|
||||
// Each select's options, the empty one ("-") first, with which is chosen.
|
||||
classOptions() { return choices(CLASSES_OF_SERVICE, CLASS_LABEL, this.classOfService); },
|
||||
moscowOptions() { return choices(MOSCOW, MOSCOW_LABEL, this.moscow); },
|
||||
wsjfParts() {
|
||||
const wsjf = this.wsjf || {};
|
||||
return WSJF_PARTS.map(key => {
|
||||
const value = WSJF_SCALE.includes(wsjf[key]) ? wsjf[key] : null;
|
||||
return { key, labelKey: WSJF_LABEL[key], value,
|
||||
options: [{ value: '', text: '-', selected: value === null },
|
||||
...WSJF_SCALE.map(n => ({ value: String(n), text: String(n), selected: n === value }))] };
|
||||
});
|
||||
},
|
||||
};
|
||||
['cardFlowBlocked', 'cardFlowClassOfService', 'cardFlowMoscow', 'cardFlowWsjf'].forEach(name => {
|
||||
Template[name].helpers(helpers);
|
||||
});
|
||||
|
||||
Template.cardFlowBlocked.events({
|
||||
'change .js-card-flow-blocked'(event, tpl) {
|
||||
save(tpl.data.card, { blocked: event.currentTarget.checked });
|
||||
},
|
||||
'change .js-card-flow-blocked-reason'(event, tpl) {
|
||||
save(tpl.data.card, { blockedReason: event.currentTarget.value });
|
||||
},
|
||||
});
|
||||
Template.cardFlowClassOfService.events({
|
||||
'change .js-card-flow-class'(event, tpl) {
|
||||
save(tpl.data.card, { classOfService: event.currentTarget.value });
|
||||
},
|
||||
});
|
||||
Template.cardFlowMoscow.events({
|
||||
'change .js-card-flow-moscow'(event, tpl) {
|
||||
save(tpl.data.card, { moscow: event.currentTarget.value });
|
||||
},
|
||||
});
|
||||
Template.cardFlowWsjf.events({
|
||||
'change .js-card-flow-wsjf'(event, tpl) {
|
||||
const value = event.currentTarget.value;
|
||||
save(tpl.data.card, { wsjf: { [event.currentTarget.dataset.part]: value === '' ? null : Number(value) } });
|
||||
},
|
||||
});
|
||||
@@ -17,6 +17,7 @@ template(name="minicard")
|
||||
class="{{#if minicardCollapsed}}minicard-collapsed{{/if}}"
|
||||
class="{{#if hasUnreadComments}}minicard-unread-comments{{/if}}"
|
||||
class="{{#if hasUnreadChanges}}minicard-unread-changes{{/if}}"
|
||||
class="{{#if splitDoneHere}}minicard-split-done{{/if}}"
|
||||
title="{{#if hasUnreadComments}}{{_ 'card-has-unread-comments'}}{{else}}{{#if hasUnreadChanges}}{{_ 'card-has-unread-changes'}}{{/if}}{{/if}}"
|
||||
style="{{#if showCardColorOnMinicard}}{{colorStyle}}{{/if}}")
|
||||
if canMoveCard
|
||||
@@ -30,6 +31,8 @@ template(name="minicard")
|
||||
if canModifyCard
|
||||
a.minicard-details-menu-with-handle.js-open-minicard-details-menu(title="{{_ 'cardDetailsActionsPopup-title'}}")
|
||||
i.fa.fa-bars
|
||||
//- Done here, in a list split into Doing and Done (listFlowPolicies.jade).
|
||||
+minicardSplitDone
|
||||
if showDependencyConnectHandle
|
||||
a.dependency-connect-handle.js-dependency-connect-handle(title="{{_ 'drag-to-connect'}}")
|
||||
i.fa.fa-dot-circle-o
|
||||
@@ -211,6 +214,37 @@ template(name="minicard")
|
||||
span.badge-icon(style="color:{{dependencyBadge.color}}")
|
||||
i.fa(class="fa-{{dependencyBadge.icon}}")
|
||||
span.badge-text {{ dependencyBadge.count }}
|
||||
//- The flow fields, Show on Minicard (docs/Features/Cards/Flow-Fields.md).
|
||||
if $eq field "blocked"
|
||||
if currentBoard.allowsBlockedOnMinicard
|
||||
with cardFlowOf this
|
||||
if blocked
|
||||
.badge.minicard-flow-blocked.js-minicard-flow-blocked(title="{{_ 'card-blocked'}}{{#if blockedReason}}: {{blockedReason}}{{/if}}")
|
||||
span.badge-icon
|
||||
i.fa.fa-ban
|
||||
span.badge-text {{_ 'card-blocked'}}
|
||||
if $eq field "classOfService"
|
||||
if currentBoard.allowsClassOfServiceOnMinicard
|
||||
with cardFlowOf this
|
||||
if classOfService
|
||||
.badge.minicard-flow-class(class="flow-class-{{classOfService}}" title="{{_ 'class-of-service'}}: {{_ classLabelKey}}")
|
||||
span.badge-icon
|
||||
i.fa.fa-road
|
||||
span.badge-text {{_ classLabelKey}}
|
||||
if $eq field "moscow"
|
||||
if currentBoard.allowsMoscowOnMinicard
|
||||
with cardFlowOf this
|
||||
if moscow
|
||||
.badge.minicard-flow-moscow(class="flow-moscow-{{moscow}}" title="{{_ 'moscow-priority'}}: {{_ moscowLabelKey}}")
|
||||
span.badge-text {{_ moscowLabelKey}}
|
||||
if $eq field "wsjf"
|
||||
if currentBoard.allowsWsjfOnMinicard
|
||||
with cardFlowOf this
|
||||
if wsjfScore
|
||||
.badge.minicard-flow-wsjf(title="{{_ 'wsjf-score'}}")
|
||||
span.badge-icon
|
||||
i.fa.fa-balance-scale
|
||||
span.badge-text {{wsjfScore}}
|
||||
if $eq field "stickers"
|
||||
if showStickersOnMinicard
|
||||
if stickers.length
|
||||
|
||||
@@ -180,6 +180,12 @@ Template.minicard.helpers({
|
||||
// #3984: visual card aging — fade cards that have not been touched recently,
|
||||
// based on dateLastActivity, when the board has card aging enabled.
|
||||
// docs/Features/Cards/At-Risk.md
|
||||
// Done here in a list split into Doing and Done (models/lib/boardFlowPolicies.js).
|
||||
splitDoneHere() {
|
||||
const { splitShown } = require('/client/components/lists/listFlowPolicies');
|
||||
return splitShown(ReactiveCache.getBoard(this.boardId), ReactiveCache.getList(this.listId))
|
||||
&& require('/models/lib/boardFlowPolicies').isSplitDone(this);
|
||||
},
|
||||
atRisk() {
|
||||
return riskOf(this);
|
||||
},
|
||||
|
||||
@@ -9,7 +9,7 @@
|
||||
import { ReactiveVar } from 'meteor/reactive-var';
|
||||
import { TAPi18n } from '/imports/i18n';
|
||||
import { CSV_IMPORT_FIELDS, csvSeparatorOf, normalizeHeader } from '/models/lib/csvImportMapping';
|
||||
import { csvGetMembersToMap } from './csvMembersMapper';
|
||||
import { csvGetMembersToMap, csvMembersFromNames } from './csvMembersMapper';
|
||||
|
||||
const Papa = require('papaparse');
|
||||
|
||||
@@ -28,7 +28,7 @@ export function parseCsvImportText(text) {
|
||||
// `excelBase64` for a workbook (read on the server, which answers with the
|
||||
// first board sheet's header and the sheets it found). `membersStep`: the
|
||||
// "map members" step follows this one.
|
||||
export async function startCsvMapping(importTpl, { rows, excelBase64, membersStep = false }) {
|
||||
export async function startCsvMapping(importTpl, { rows, excelBase64, uploadId, membersStep = false }) {
|
||||
activeImportTpl = importTpl;
|
||||
if (!importTpl.csvMappingState) importTpl.csvMappingState = new ReactiveVar(null);
|
||||
importTpl.csvMapping = null;
|
||||
@@ -40,6 +40,9 @@ export async function startCsvMapping(importTpl, { rows, excelBase64, membersSte
|
||||
let preview;
|
||||
if (excelBase64) {
|
||||
preview = await Meteor.callAsync('excelImportPreview', excelBase64);
|
||||
} else if (uploadId) {
|
||||
// A file streamed to the server's disk (server/lib/importUpload.js).
|
||||
preview = await Meteor.callAsync('csvUploadPreview', uploadId);
|
||||
} else {
|
||||
const header = (rows && rows[0]) || [];
|
||||
preview = {
|
||||
@@ -52,7 +55,9 @@ export async function startCsvMapping(importTpl, { rows, excelBase64, membersSte
|
||||
}
|
||||
const mapping = {
|
||||
columns: { ...((preview.mapping && preview.mapping.columns) || {}) },
|
||||
customFieldColumns: [],
|
||||
// The guess ticks every column it has no field for, so nothing is left
|
||||
// behind unless the user unticks it.
|
||||
customFieldColumns: [...((preview.mapping && preview.mapping.customFieldColumns) || [])],
|
||||
listName: TAPi18n.__('scrum-category-todo'),
|
||||
};
|
||||
importTpl.csvMappingState.set({
|
||||
@@ -62,6 +67,7 @@ export async function startCsvMapping(importTpl, { rows, excelBase64, membersSte
|
||||
boards: preview.boards || [],
|
||||
skipped: preview.skipped || [],
|
||||
rows: rows || null,
|
||||
uploadId: uploadId || null,
|
||||
membersStep,
|
||||
mapping,
|
||||
});
|
||||
@@ -201,7 +207,15 @@ Template.importCsvMapping.events({
|
||||
...(chosen.columns.list === undefined ? { listName } : {}),
|
||||
};
|
||||
const state = tpl.state();
|
||||
// The people to map are the ones in the columns chosen for people.
|
||||
// The people to map are the ones in the columns chosen for people - read
|
||||
// by the server from an uploaded file.
|
||||
if (state.uploadId && state.membersStep) {
|
||||
Meteor.callAsync('csvUploadPeople', state.uploadId, chosen.columns).then(names => {
|
||||
importTpl.membersToMap.set(csvMembersFromNames(names || []));
|
||||
importTpl.nextStep();
|
||||
}, error => tpl.mappingError.set((error && error.error) || 'error-csv-schema'));
|
||||
return;
|
||||
}
|
||||
if (state.rows && state.membersStep) {
|
||||
importTpl.membersToMap.set(csvGetMembersToMap(state.rows, chosen.columns));
|
||||
}
|
||||
|
||||
@@ -1,54 +1,18 @@
|
||||
import { ReactiveCache } from '/imports/reactiveCache';
|
||||
import { splitByField, splitPeople } from '/models/lib/csvImportMapping';
|
||||
import { csvPeopleNames } from '/models/lib/csvPeople';
|
||||
|
||||
// The usernames to map. Without `columns`, the ones in a column named
|
||||
// "Members"; with the columns the mapping step chose, the ones in every
|
||||
// people column: owner, members, assignees, requested by and assigned by.
|
||||
export function csvGetMembersToMap(data, columns) {
|
||||
// we will work on the list itself (an ordered array of objects) when a
|
||||
// mapping is done, we add a 'wekan' field to the object representing the
|
||||
// imported member
|
||||
|
||||
const membersToMap = [];
|
||||
const importedMembers = [];
|
||||
const peopleColumns = [];
|
||||
|
||||
if (columns) {
|
||||
['owner', 'members', 'assignees'].forEach(field => {
|
||||
if (columns[field] !== undefined) peopleColumns.push({ index: columns[field], split: splitPeople });
|
||||
});
|
||||
['requestedBy', 'assignedBy'].forEach(field => {
|
||||
if (columns[field] !== undefined) peopleColumns.push({ index: columns[field], split: splitByField });
|
||||
});
|
||||
} else {
|
||||
for (let i = 0; i < data[0].length; i++) {
|
||||
if (String(data[0][i] || '').toLowerCase() === 'members') {
|
||||
peopleColumns.push({ index: i, split: cell => String(cell).split(' ') });
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
for (let i = 1; i < data.length; i++) {
|
||||
for (const { index, split } of peopleColumns) {
|
||||
if (data[i][index]) {
|
||||
for (const importedMember of split(data[i][index])) {
|
||||
if (importedMember && importedMembers.indexOf(importedMember) === -1) {
|
||||
importedMembers.push(importedMember);
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
for (let importedMember of importedMembers) {
|
||||
importedMember = {
|
||||
username: importedMember,
|
||||
id: importedMember,
|
||||
};
|
||||
const wekanUser = ReactiveCache.getUser({ username: importedMember.username });
|
||||
if (wekanUser) importedMember.wekanId = wekanUser._id;
|
||||
membersToMap.push(importedMember);
|
||||
}
|
||||
|
||||
return membersToMap;
|
||||
// The people to map, each matched to a WeKan user of the same username when
|
||||
// there is one. `rows` are the file's rows, or `names` the usernames the
|
||||
// server read from an uploaded file (csvUploadPeople).
|
||||
export function csvMembersFromNames(names) {
|
||||
return names.map(username => {
|
||||
const member = { username, id: username };
|
||||
const wekanUser = ReactiveCache.getUser({ username });
|
||||
if (wekanUser) member.wekanId = wekanUser._id;
|
||||
return member;
|
||||
});
|
||||
}
|
||||
|
||||
export function csvGetMembersToMap(data, columns) {
|
||||
return csvMembersFromNames(csvPeopleNames(data, columns));
|
||||
}
|
||||
Vendored
+13
@@ -280,3 +280,16 @@ a.show-mapping {
|
||||
.import-report-row {
|
||||
overflow-wrap: anywhere;
|
||||
}
|
||||
|
||||
/* The Import page's sources by kind (models/lib/toolGroups.js). */
|
||||
.import-source-list .import-source-group {
|
||||
margin-top: 0.8em;
|
||||
font-weight: bold;
|
||||
font-size: 0.85em;
|
||||
text-transform: uppercase;
|
||||
letter-spacing: 0.04em;
|
||||
color: #6b778c;
|
||||
}
|
||||
.import-source-list .import-source-group:first-child {
|
||||
margin-top: 0;
|
||||
}
|
||||
@@ -39,6 +39,8 @@ template(name="import")
|
||||
h2 {{_ 'import-source-heading'}}
|
||||
ul.import-source-list
|
||||
each importSources
|
||||
if groupHeading
|
||||
li.import-source-group {{groupHeading}}
|
||||
li
|
||||
//- The same green tick every checkbox in the app uses
|
||||
(`.materialCheckBox`, forms.css) - the one Admin Panel /
|
||||
|
||||
@@ -3,7 +3,7 @@ import { trelloGetMembersToMap } from './trelloMembersMapper';
|
||||
import { FlowRouter } from 'meteor/ostrio:flow-router-extra';
|
||||
import { wekanGetMembersToMap } from './wekanMembersMapper';
|
||||
import { csvGetMembersToMap } from './csvMembersMapper';
|
||||
import { jiraGetMembersToMap } from './jiraMembersMapper';
|
||||
import { jiraGetMembersToMap } from '/models/lib/jiraMembersMapper';
|
||||
import getSlug from 'limax';
|
||||
import { UserSearchIndex } from '/models/users';
|
||||
import { Utils } from '/client/lib/utils';
|
||||
@@ -49,6 +49,13 @@ function attachmentAuthData(importTpl) {
|
||||
return auth ? { attachmentAuth: auth } : {};
|
||||
}
|
||||
|
||||
// The file streamed to the server for this import (postImportUpload), by its
|
||||
// id; the preview of its people and the import itself both read it.
|
||||
function uploadData(importTpl) {
|
||||
return importTpl.upload && importTpl.upload.uploadId
|
||||
? { uploadId: importTpl.upload.uploadId, ...(importTpl.uploadExtras || {}) } : {};
|
||||
}
|
||||
|
||||
// Helper to find the closest ancestor template instance by name
|
||||
function findParentTemplateInstance(childTemplateInstance, parentTemplateName) {
|
||||
let view = childTemplateInstance.view;
|
||||
@@ -118,6 +125,33 @@ async function postTrelloImport(body, contentType) {
|
||||
return result;
|
||||
}
|
||||
|
||||
// A chosen file of the generalized importer's sources, streamed to the server
|
||||
// a part at a time (server/routes/importUpload.js) rather than read here and
|
||||
// sent whole through the importBoard method: the server writes it to its disk,
|
||||
// checking the free space and the administrator's import limit, and importBoard
|
||||
// reads it by the id answered here. Returns { uploadId, size }.
|
||||
async function postImportUpload(source, file) {
|
||||
const token =
|
||||
(window.localStorage && window.localStorage.getItem('Meteor.loginToken')) || '';
|
||||
const resp = await fetch(`/api/import/upload/${encodeURIComponent(source)}`, {
|
||||
method: 'POST',
|
||||
credentials: 'same-origin',
|
||||
headers: {
|
||||
'Content-Type': 'application/octet-stream',
|
||||
...(token ? { Authorization: `Bearer ${token}` } : {}),
|
||||
},
|
||||
body: file,
|
||||
});
|
||||
let result = {};
|
||||
try {
|
||||
result = await resp.json();
|
||||
} catch (e) {
|
||||
result = {};
|
||||
}
|
||||
if (!resp.ok || result.error || !result.uploadId) throw new Error(result.error || 'import-upload-failed');
|
||||
return result;
|
||||
}
|
||||
|
||||
// A WeKan .zip export (the document and its attachment files) imported as a
|
||||
// NEW board: posted as it is to /api/import/zip?newBoard=1 (models/importZip.js),
|
||||
// which opens it on the server under its limits. Returns the new board's id.
|
||||
@@ -313,7 +347,19 @@ Template.import.onCreated(function () {
|
||||
openOrReportImportedBoard(boardId, '');
|
||||
return;
|
||||
}
|
||||
if (file) {
|
||||
this.upload = null;
|
||||
this.uploadExtras = null;
|
||||
// Jira too: its people are read from the uploaded file by the server.
|
||||
if (file && (spec.creator === 'generalized' || dataSource === 'jira' || dataSource === 'csv')) {
|
||||
// Streamed to the server's disk, never read into this page whole.
|
||||
try {
|
||||
this.upload = await postImportUpload(dataSource, file);
|
||||
} catch (e) {
|
||||
this.setError((e && e.message) || 'import-upload-failed');
|
||||
return;
|
||||
}
|
||||
doc = {};
|
||||
} else if (file) {
|
||||
doc = documentForFile(dataSource, file.name || '', new Uint8Array(await file.arrayBuffer()));
|
||||
} else {
|
||||
const text = (this.find('.js-import-json') || {}).value || '';
|
||||
@@ -331,6 +377,13 @@ Template.import.onCreated(function () {
|
||||
// CSV/TSV and Excel: which column is which field comes first
|
||||
// (csvMapping.js), the people after it for CSV.
|
||||
if (dataSource === 'csv') {
|
||||
// An uploaded file: its header, rows and people are read on the server.
|
||||
if (this.upload) {
|
||||
this.importedData.set([]);
|
||||
this.membersToMap.set([]);
|
||||
await startCsvMapping(this, { uploadId: this.upload.uploadId, membersStep: !skipMapping });
|
||||
return;
|
||||
}
|
||||
if (!Array.isArray(doc) || !doc.length) {
|
||||
this.setError('error-csv-schema');
|
||||
return;
|
||||
@@ -356,6 +409,8 @@ Template.import.onCreated(function () {
|
||||
const estimateFieldId = this.find('.js-jira-estimate-field')?.value.trim();
|
||||
if (estimateFieldId) doc.wekanScrumMapping = { estimateFieldId,
|
||||
estimateUnit: this.find('.js-jira-estimate-unit')?.value.trim() };
|
||||
// An uploaded file is read on the server: the mapping goes with the call.
|
||||
if (this.upload && doc.wekanScrumMapping) this.uploadExtras = { wekanScrumMapping: doc.wekanScrumMapping };
|
||||
}
|
||||
// Trello: remember the target personal-workspace name for finishImport.
|
||||
this.workspaceName = '';
|
||||
@@ -373,6 +428,17 @@ Template.import.onCreated(function () {
|
||||
await this.mapPeopleOrImport(dataSource, skipMapping);
|
||||
return;
|
||||
}
|
||||
// An uploaded Jira file: its people from the server, read from the file.
|
||||
if (this.upload && dataSource === 'jira') {
|
||||
try {
|
||||
this.membersToMap.set(await Meteor.callAsync('importBoard', {}, { previewPeople: true, ...uploadData(this) }, 'jira', null));
|
||||
} catch (e) {
|
||||
this.setError((e && (e.reason || e.error)) || 'error-json-malformed');
|
||||
return;
|
||||
}
|
||||
await advance();
|
||||
return;
|
||||
}
|
||||
this.membersToMap.set(_prepareAdditionalData(doc));
|
||||
await advance();
|
||||
};
|
||||
@@ -393,7 +459,7 @@ Template.import.onCreated(function () {
|
||||
let people = [];
|
||||
try {
|
||||
people = await Meteor.callAsync('importBoard', pruneImportDocument(this.importedData.get(), selectedFields()),
|
||||
{ previewPeople: true, importFields: selectedFields() }, source, null);
|
||||
{ previewPeople: true, importFields: selectedFields(), ...uploadData(this) }, source, null);
|
||||
} catch (e) {
|
||||
this.setError((e && (e.reason || e.error)) || 'error-json-malformed');
|
||||
return;
|
||||
@@ -544,7 +610,10 @@ Template.import.onCreated(function () {
|
||||
this.membersToMap.set([]);
|
||||
let settled = false;
|
||||
const importDocument = pruneImportDocument(importedData, selectedFields());
|
||||
const timeoutMs = importDeadlineFor(parseInt(window.WEKAN_IMPORT_TIMEOUT_MS, 10) || 120000, importDocument);
|
||||
// An uploaded file is not in the document: its size gives it time, two
|
||||
// seconds a megabyte on top of the usual deadline.
|
||||
const uploadMs = this.upload ? Math.ceil((this.upload.size || 0) / (1024 * 1024)) * 2000 : 0;
|
||||
const timeoutMs = importDeadlineFor(parseInt(window.WEKAN_IMPORT_TIMEOUT_MS, 10) || 120000, importDocument) + uploadMs;
|
||||
const watchdog = Meteor.setTimeout(() => {
|
||||
if (settled) return;
|
||||
settled = true;
|
||||
@@ -560,7 +629,7 @@ Template.import.onCreated(function () {
|
||||
// The selection again, for the parts only a creator can leave out:
|
||||
// the Scrum planning external parsers find (models/kanboardCreator.js).
|
||||
{ membersMapping: mappingById, importFields: selectedFields(), membersMode: this.membersMode || 'map', ...csvMappingData(this),
|
||||
...attachmentAuthData(this),
|
||||
...attachmentAuthData(this), ...uploadData(this),
|
||||
...(splitByProject(this.importSource) ? { splitBy: 'swimlane' } : {}) },
|
||||
this.importSource,
|
||||
Session.get('fromBoard'),
|
||||
@@ -614,12 +683,21 @@ Template.import.helpers({
|
||||
const setting = ReactiveCache.getCurrentSetting();
|
||||
const product = productNameOrDefault(setting && setting.productName);
|
||||
const current = Session.get('importSource');
|
||||
return IMPORT_SOURCES.map(source => ({
|
||||
// Grouped by kind under headings (models/lib/toolGroups.js), the same
|
||||
// groups the Export menu uses; WeKan's own is headed by the product name,
|
||||
// and a company with several products by the company's name.
|
||||
const { groupTools } = require('/models/lib/toolGroups');
|
||||
return groupTools(IMPORT_SOURCES.map(source => ({
|
||||
key: source.key,
|
||||
// "a previous export of <Product name>", which for an unbranded WeKan is
|
||||
// "WeKan" and for a rebranded one is whatever it was rebranded to.
|
||||
name: source.product ? `${product} (JSON, .zip)` : source.name,
|
||||
selected: source.key === current,
|
||||
}))).map(source => ({
|
||||
...source,
|
||||
groupHeading: source.groupStart
|
||||
? (source.groupLabelKey ? TAPi18n.__(source.groupLabelKey) : source.groupLabel || product)
|
||||
: '',
|
||||
}));
|
||||
},
|
||||
hasImportSource() {
|
||||
|
||||
@@ -4,7 +4,10 @@ export function trelloGetMembersToMap(data) {
|
||||
// we will work on the list itself (an ordered array of objects) when a
|
||||
// mapping is done, we add a 'wekan' field to the object representing the
|
||||
// imported member
|
||||
const membersToMap = data.members;
|
||||
// A Trello file may have no members (an export of a board nobody else is
|
||||
// on): there is then nobody to map, not an error. Without the fallback the
|
||||
// forEach below threw and the Import button silently did nothing.
|
||||
const membersToMap = Array.isArray(data.members) ? data.members : [];
|
||||
// auto-map based on username
|
||||
membersToMap.forEach(importedMember => {
|
||||
const wekanUser = ReactiveCache.getUser({ username: importedMember.username });
|
||||
|
||||
@@ -0,0 +1,57 @@
|
||||
/* The Kanban flow policies of the lists (docs/Features/Lists/Flow-Policies.md). */
|
||||
.list-policy-mark,
|
||||
.list-commitment-mark {
|
||||
display: inline-block;
|
||||
margin-inline-start: 4px;
|
||||
opacity: 0.75;
|
||||
}
|
||||
.list-policy-mark {
|
||||
cursor: pointer;
|
||||
}
|
||||
.list-commitment-mark {
|
||||
color: #27ae60;
|
||||
}
|
||||
.list-policy-popup textarea {
|
||||
width: 100%;
|
||||
box-sizing: border-box;
|
||||
}
|
||||
.list-policy-popup .list-policy-text {
|
||||
white-space: pre-wrap;
|
||||
}
|
||||
.board-flow-list-settings .board-flow-setting {
|
||||
display: flex;
|
||||
align-items: center;
|
||||
justify-content: space-between;
|
||||
gap: 8px;
|
||||
margin-top: 8px;
|
||||
}
|
||||
.board-flow-list-settings .board-flow-setting input,
|
||||
.board-flow-list-settings .board-flow-setting select {
|
||||
max-width: 50%;
|
||||
}
|
||||
.card-person-wip-over {
|
||||
color: #c0392b;
|
||||
margin-bottom: 4px;
|
||||
}
|
||||
|
||||
/* Split Doing / Done lists. */
|
||||
.list-split-counts {
|
||||
display: inline-block;
|
||||
margin-inline-start: 4px;
|
||||
font-size: 0.85em;
|
||||
opacity: 0.8;
|
||||
}
|
||||
.minicard-split-toggle {
|
||||
float: inline-end;
|
||||
margin-inline-start: 4px;
|
||||
cursor: pointer;
|
||||
opacity: 0.6;
|
||||
}
|
||||
.minicard-split-toggle.is-done {
|
||||
color: #27ae60;
|
||||
opacity: 1;
|
||||
}
|
||||
.minicard.minicard-split-done {
|
||||
opacity: 0.6;
|
||||
border-inline-start: 3px solid #27ae60;
|
||||
}
|
||||
@@ -0,0 +1,78 @@
|
||||
//- The Kanban flow policies of the lists (models/lib/boardFlowPolicies.js,
|
||||
docs/Features/Lists/Flow-Policies.md). Each is shown only when Admin Panel /
|
||||
Features offers it; a board admin changes them, others see them disabled.
|
||||
template(name="boardFlowListSettings")
|
||||
form.board-flow-list-settings
|
||||
if allowFeature 'list-policies'
|
||||
div.check-div
|
||||
a.flex.js-toggle-list-policies(class="{{#if allowsListPolicies}}is-checked{{/if}}" title="{{_ 'show-list-policies'}}")
|
||||
i.fa(class="{{#if allowsListPolicies}}fa-check{{else}}fa-square-o{{/if}}")
|
||||
span
|
||||
i.fa.fa-gavel
|
||||
| {{_ 'show-list-policies'}}
|
||||
if allowFeature 'split-lists'
|
||||
div.check-div
|
||||
a.flex.js-toggle-split-lists(class="{{#if allowsSplitLists}}is-checked{{/if}}" title="{{_ 'show-split-lists'}}")
|
||||
i.fa(class="{{#if allowsSplitLists}}fa-check{{else}}fa-square-o{{/if}}")
|
||||
span
|
||||
i.fa.fa-columns
|
||||
| {{_ 'show-split-lists'}}
|
||||
if allowFeature 'commitment-point'
|
||||
label.board-flow-setting
|
||||
span
|
||||
i.fa.fa-flag-checkered
|
||||
| {{_ 'commitment-point'}}
|
||||
select.js-commitment-list(disabled=notBoardAdmin)
|
||||
each option in commitmentOptions
|
||||
option(value=option.value selected=option.selected) {{option.title}}
|
||||
p.quiet {{_ 'commitment-point-hint'}}
|
||||
if allowFeature 'person-wip-limit'
|
||||
label.board-flow-setting
|
||||
span
|
||||
i.fa.fa-user-times
|
||||
| {{_ 'person-wip-limit'}}
|
||||
input.js-person-wip-limit(type="number" min="1" max="99" value=personWipLimit disabled=notBoardAdmin)
|
||||
|
||||
//- At the list header: the policy as an icon whose tooltip is the text, and the
|
||||
commitment point's flag.
|
||||
template(name="listFlowMarks")
|
||||
if showPolicy
|
||||
a.list-policy-mark.js-open-list-policy(title=policy aria-label="{{_ 'list-policy'}}")
|
||||
i.fa.fa-gavel
|
||||
if splitCounts
|
||||
span.list-split-counts(title="{{_ 'list-split'}}") {{_ 'split-counts' doing=splitCounts.doing done=splitCounts.done}}
|
||||
if isCommitmentPoint
|
||||
span.list-commitment-mark(title="{{_ 'commitment-point'}}: {{_ 'commitment-point-hint'}}" aria-label="{{_ 'commitment-point'}}")
|
||||
i.fa.fa-flag-checkered
|
||||
|
||||
template(name="listPolicyPopup")
|
||||
.list-policy-popup
|
||||
if canEdit
|
||||
form.js-list-policy-form
|
||||
textarea.js-list-policy-text(rows="6" maxlength="2000" placeholder="{{_ 'list-policy-placeholder'}}")= policy
|
||||
input.primary(type="submit" value="{{_ 'save'}}")
|
||||
else
|
||||
if policy
|
||||
p.list-policy-text= policy
|
||||
else
|
||||
p.quiet {{_ 'list-policy-placeholder'}}
|
||||
|
||||
//- In the opened card's Members section: each of its people over the board's
|
||||
WIP limit per person.
|
||||
template(name="cardPersonWipWarnings")
|
||||
each warning in warnings
|
||||
.card-person-wip-over.js-card-person-wip-over
|
||||
i.fa.fa-user-times
|
||||
| {{_ 'person-wip-over' user=warning.name count=warning.count limit=warning.limit}}
|
||||
|
||||
//- On a minicard of a split list: whether it is Done here, and the toggle for
|
||||
whoever may change the card.
|
||||
template(name="minicardSplitDone")
|
||||
if inSplitList
|
||||
if canModifyCard
|
||||
a.minicard-split-toggle.js-minicard-split-done(class="{{#if splitDone}}is-done{{/if}}" title="{{#if splitDone}}{{_ 'split-done'}}{{else}}{{_ 'mark-split-done'}}{{/if}}" aria-pressed="{{#if splitDone}}true{{else}}false{{/if}}")
|
||||
i.fa(class="{{#if splitDone}}fa-check-circle{{else}}fa-circle-o{{/if}}")
|
||||
else
|
||||
if splitDone
|
||||
span.minicard-split-toggle.is-done(title="{{_ 'split-done'}}")
|
||||
i.fa.fa-check-circle
|
||||
@@ -0,0 +1,134 @@
|
||||
// The Kanban flow policies of the lists (models/lib/boardFlowPolicies.js,
|
||||
// docs/Features/Lists/Flow-Policies.md): Board Settings / List, the marks at
|
||||
// a list's header, the list's policy popup and the opened card's warning.
|
||||
import { Meteor } from 'meteor/meteor';
|
||||
import { Template } from 'meteor/templating';
|
||||
import { ReactiveCache } from '/imports/reactiveCache';
|
||||
import { allowFeature } from '/client/lib/instanceFeatures';
|
||||
import { TAPi18n } from '/imports/i18n';
|
||||
import { Utils } from '/client/lib/utils';
|
||||
import Lists from '/models/lists';
|
||||
|
||||
const { normalizePolicy, overPersonWip, isSplitDone, splitCounts } = require('/models/lib/boardFlowPolicies');
|
||||
|
||||
// Whether a list of `board` is drawn split into Doing and Done.
|
||||
const splitShown = (board, list) => Boolean(board?.allowsSplitLists === true && list?.split === true && allowFeature('split-lists'));
|
||||
export { splitShown };
|
||||
|
||||
const board = () => Utils.getCurrentBoard();
|
||||
const isBoardAdmin = () => Boolean(ReactiveCache.getCurrentUser()?.isBoardAdmin?.());
|
||||
|
||||
Template.boardFlowListSettings.helpers({
|
||||
allowsListPolicies() { return board()?.allowsListPolicies === true; },
|
||||
allowsSplitLists() { return board()?.allowsSplitLists === true; },
|
||||
notBoardAdmin() { return !isBoardAdmin(); },
|
||||
personWipLimit() { return board()?.personWipLimit || ''; },
|
||||
commitmentOptions() {
|
||||
const current = board();
|
||||
if (!current) return [];
|
||||
const lists = ReactiveCache.getLists({ boardId: current._id, archived: false }, { sort: { sort: 1 } }) || [];
|
||||
const chosen = current.commitmentListId || '';
|
||||
return [{ value: '', title: '-', selected: !chosen },
|
||||
...lists.map(list => ({ value: list._id, title: list.title, selected: list._id === chosen }))];
|
||||
},
|
||||
});
|
||||
|
||||
Template.boardFlowListSettings.events({
|
||||
'click .js-toggle-list-policies'(event) {
|
||||
event.preventDefault();
|
||||
const current = board();
|
||||
if (current && isBoardAdmin()) current.setAllowsListPolicies(current.allowsListPolicies !== true);
|
||||
},
|
||||
'click .js-toggle-split-lists'(event) {
|
||||
event.preventDefault();
|
||||
const current = board();
|
||||
if (current && isBoardAdmin()) current.setAllowsSplitLists(current.allowsSplitLists !== true);
|
||||
},
|
||||
'change .js-commitment-list'(event) {
|
||||
const current = board();
|
||||
if (current && isBoardAdmin()) current.setCommitmentListId(event.currentTarget.value);
|
||||
},
|
||||
'change .js-person-wip-limit'(event) {
|
||||
const current = board();
|
||||
if (!current || !isBoardAdmin()) return;
|
||||
current.setPersonWipLimit(event.currentTarget.value.trim()).catch(() => {
|
||||
window.alert(TAPi18n.__('person-wip-limit'));
|
||||
});
|
||||
},
|
||||
'submit .board-flow-list-settings'(event) { event.preventDefault(); },
|
||||
});
|
||||
|
||||
// The list header's marks; the data context is the list.
|
||||
Template.listFlowMarks.helpers({
|
||||
showPolicy() {
|
||||
const current = ReactiveCache.getBoard(this.boardId);
|
||||
return Boolean(current?.allowsListPolicies === true && this.policy && allowFeature('list-policies'));
|
||||
},
|
||||
splitCounts() {
|
||||
const current = ReactiveCache.getBoard(this.boardId);
|
||||
if (!splitShown(current, this)) return null;
|
||||
return splitCounts(ReactiveCache.getCards({ listId: this._id, archived: false }, { fields: { listId: 1, flow: 1, archived: 1 } }) || []);
|
||||
},
|
||||
isCommitmentPoint() {
|
||||
const current = ReactiveCache.getBoard(this.boardId);
|
||||
return Boolean(current?.commitmentListId && current.commitmentListId === this._id && allowFeature('commitment-point'));
|
||||
},
|
||||
});
|
||||
Template.listFlowMarks.events({
|
||||
'click .js-open-list-policy': Popup.open('listPolicy'),
|
||||
});
|
||||
|
||||
Template.listPolicyPopup.helpers({
|
||||
// Whoever may write to the list's board (models/lib/boardRoleCapabilities.js),
|
||||
// the same as the server's Lists allow rule.
|
||||
canEdit() {
|
||||
return Utils.currentUserCan('write', ReactiveCache.getBoard(this.boardId));
|
||||
},
|
||||
});
|
||||
Template.listPolicyPopup.events({
|
||||
async 'submit .js-list-policy-form'(event, tpl) {
|
||||
event.preventDefault();
|
||||
let policy;
|
||||
try {
|
||||
policy = normalizePolicy(tpl.find('.js-list-policy-text').value);
|
||||
} catch (e) {
|
||||
return;
|
||||
}
|
||||
const modifier = policy ? { $set: { policy } } : { $unset: { policy: '' } };
|
||||
await Lists.updateAsync(this._id, modifier);
|
||||
Popup.back();
|
||||
},
|
||||
});
|
||||
|
||||
// The opened card's people over the WIP limit per person; the data is the card.
|
||||
Template.cardPersonWipWarnings.helpers({
|
||||
warnings() {
|
||||
const card = this.card;
|
||||
const current = card && ReactiveCache.getBoard(card.boardId);
|
||||
if (!current || !current.personWipLimit || !allowFeature('person-wip-limit')) return [];
|
||||
const cards = ReactiveCache.getCards({ boardId: card.boardId, archived: false },
|
||||
{ fields: { assignees: 1, members: 1, dueComplete: 1, archived: 1, type: 1 } }) || [];
|
||||
return overPersonWip(card, cards, current.personWipLimit).map(row => {
|
||||
const user = ReactiveCache.getUser(row.userId);
|
||||
return { ...row, name: (user && (user.profile?.fullname || user.username)) || row.userId };
|
||||
});
|
||||
},
|
||||
});
|
||||
|
||||
// The minicard's Done here toggle; the data is the card.
|
||||
Template.minicardSplitDone.helpers({
|
||||
inSplitList() {
|
||||
const card = this;
|
||||
return splitShown(ReactiveCache.getBoard(card.boardId), ReactiveCache.getList(card.listId));
|
||||
},
|
||||
splitDone() { return isSplitDone(this); },
|
||||
canModifyCard() { return Utils.canModifyCard(this); },
|
||||
});
|
||||
Template.minicardSplitDone.events({
|
||||
'click .js-minicard-split-done'(event) {
|
||||
event.preventDefault();
|
||||
event.stopPropagation();
|
||||
Meteor.callAsync('setCardFlow', this._id, { splitDone: !isSplitDone(this) })
|
||||
.catch(error => window.alert((error && (error.reason || error.error)) || String(error)));
|
||||
},
|
||||
});
|
||||
@@ -35,6 +35,7 @@ template(name="listHeader")
|
||||
| (
|
||||
span(class="{{#if exceededWipLimit}}highlight{{/if}}") {{cardsCountWhole}}
|
||||
|/#{wipLimit.value})
|
||||
+listFlowMarks
|
||||
if showCardsCountForList cardsCountWhole
|
||||
span.cardCount {{cardsCount containerSwimlaneId}} {{cardsCountForListIsOne cardsCountWhole}}
|
||||
if hasNumberFieldsSum
|
||||
@@ -88,6 +89,8 @@ template(name="listHeader")
|
||||
span(class="{{#if exceededWipLimit}}highlight{{/if}}") {{cardsCountWhole}}
|
||||
|/#{wipLimit.value})
|
||||
unless collapsed
|
||||
//- List policy and commitment point (listFlowPolicies.jade).
|
||||
+listFlowMarks
|
||||
if showCardsCountForList cardsCountWhole
|
||||
span.cardCount {{cardsCount containerSwimlaneId}} {{cardsCountForListIsOne cardsCountWhole}}
|
||||
if hasNumberFieldsSum
|
||||
@@ -165,9 +168,13 @@ template(name="editListTitleForm")
|
||||
i.fa.fa-times-thin
|
||||
|
||||
template(name="listActionPopup")
|
||||
//- Grouped under headings by what the entries act on (2026-11-20); every
|
||||
entry keeps its own condition, and a heading sits inside the same condition
|
||||
as its group.
|
||||
//- Copy link, FIRST and above every permission check - see the swimlane
|
||||
popup: copying an address is reading, not editing.
|
||||
models/lib/boardItemUrl.js, docs/Features/General/Board-Item-Links.md
|
||||
h4.menu-group-heading {{_ 'menu-group-share'}}
|
||||
ul.pop-over-list
|
||||
li: a.js-copy-list-link
|
||||
i.fa.fa-link
|
||||
@@ -196,6 +203,7 @@ template(name="listActionPopup")
|
||||
Import WRITES, so it is offered only to somebody who may change the board;
|
||||
`canImportIntoBoard` is the same question the popup itself asks
|
||||
(client/components/boards/exportScope.js).
|
||||
h4.menu-group-heading {{_ 'menu-group-export'}}
|
||||
ul.pop-over-list
|
||||
li: a.js-export-list
|
||||
i.fa.fa-upload
|
||||
@@ -207,6 +215,7 @@ template(name="listActionPopup")
|
||||
hr
|
||||
unless currentUser.isReadOnly
|
||||
unless currentUser.isReadAssignedOnly
|
||||
h4.menu-group-heading {{_ 'add'}}
|
||||
ul.pop-over-list
|
||||
li
|
||||
a.js-add-card.list-header-plus-top
|
||||
@@ -229,6 +238,7 @@ template(name="listActionPopup")
|
||||
the fixed-width value it used to set is now a board-wide admin toggle
|
||||
there too - a menu entry for the same thing was a second place to look
|
||||
for it. client/components/sidebar/sidebar.jade
|
||||
h4.menu-group-heading {{_ 'watch'}}
|
||||
ul.pop-over-list
|
||||
li
|
||||
a.js-toggle-watch-list
|
||||
@@ -241,6 +251,7 @@ template(name="listActionPopup")
|
||||
unless currentUser.isCommentOnly
|
||||
unless currentUser.isReadOnly
|
||||
unless currentUser.isReadAssignedOnly
|
||||
h4.menu-group-heading {{_ 'edit'}}
|
||||
unless currentUser.isWorker
|
||||
ul.pop-over-list
|
||||
li
|
||||
@@ -258,6 +269,7 @@ template(name="listActionPopup")
|
||||
a.js-archive-list-cards
|
||||
i.fa.fa-archive
|
||||
| {{_ 'list-archive-cards'}}
|
||||
h4.menu-group-heading {{_ 'settings'}}
|
||||
if currentUser.isBoardAdmin
|
||||
ul.pop-over-list
|
||||
li
|
||||
@@ -268,6 +280,22 @@ template(name="listActionPopup")
|
||||
a.js-list-permissions
|
||||
i.fa.fa-lock
|
||||
| {{_ 'listPermissionsPopup-title'}}
|
||||
//- The list's policy, when the board shows list policies
|
||||
(listFlowPolicies.jade); every member who may edit the list.
|
||||
if showsListPolicies
|
||||
ul.pop-over-list
|
||||
li
|
||||
a.js-list-policy
|
||||
i.fa.fa-gavel
|
||||
| {{_ 'list-policy'}}
|
||||
//- Split into Doing and Done (listFlowPolicies.jade), when the board
|
||||
allows split lists.
|
||||
if showsSplitLists
|
||||
ul.pop-over-list
|
||||
li
|
||||
a.js-toggle-list-split
|
||||
i.fa(class="{{#if split}}fa-check-square-o{{else}}fa-square-o{{/if}}")
|
||||
| {{_ 'list-split'}}
|
||||
//- #3847: board-wide toggle, exposed here per the maintainer's
|
||||
instruction to reach it from the List hamburger menu. See
|
||||
models/boards.js's stickyListHeaders and list.css's use of the
|
||||
@@ -290,6 +318,7 @@ template(name="listActionPopup")
|
||||
|
|
||||
i.fa.fa-check-circle(class="{{#if syncSource.enabled}}list-sync-active{{else}}list-sync-paused{{/if}}")
|
||||
hr
|
||||
h4.menu-group-heading {{_ 'menu-group-move-copy'}}
|
||||
ul.pop-over-list
|
||||
unless currentUser.isWorker
|
||||
li
|
||||
@@ -304,6 +333,7 @@ template(name="listActionPopup")
|
||||
unless currentUser.isWorker
|
||||
if mayWriteList
|
||||
hr
|
||||
h4.menu-group-heading {{_ 'archives'}}
|
||||
ul.pop-over-list
|
||||
li
|
||||
a.js-close-list
|
||||
|
||||
@@ -452,6 +452,16 @@ Template.listHeader.events({
|
||||
});
|
||||
|
||||
Template.listActionPopup.helpers({
|
||||
showsSplitLists() {
|
||||
const board = ReactiveCache.getBoard(this.boardId);
|
||||
return board?.allowsSplitLists === true
|
||||
&& require('/client/lib/instanceFeatures').allowFeature('split-lists');
|
||||
},
|
||||
showsListPolicies() {
|
||||
const board = ReactiveCache.getBoard(this.boardId);
|
||||
return board?.allowsListPolicies === true
|
||||
&& require('/client/lib/instanceFeatures').allowFeature('list-policies');
|
||||
},
|
||||
isBoardAdmin() {
|
||||
return ReactiveCache.getCurrentUser()?.isBoardAdmin();
|
||||
},
|
||||
@@ -611,6 +621,11 @@ Template.listActionPopup.events({
|
||||
Popup.back();
|
||||
},
|
||||
'click .js-set-wip-limit': Popup.open('setWipLimit'),
|
||||
'click .js-list-policy': Popup.open('listPolicy'),
|
||||
async 'click .js-toggle-list-split'(event) {
|
||||
event.preventDefault();
|
||||
await Lists.updateAsync(this._id, this.split === true ? { $unset: { split: '' } } : { $set: { split: true } });
|
||||
},
|
||||
'click .js-list-permissions': Popup.open('listPermissions'),
|
||||
'click .js-copy-list': Popup.open('copyList'),
|
||||
'click .js-move-list': Popup.open('moveList'),
|
||||
|
||||
@@ -1543,3 +1543,17 @@ body.mobile-mode .pop-over .content-wrapper {
|
||||
.pop-over[data-popup='boardCardSettingsPopup'] .content-container > .clearfix {
|
||||
display: none;
|
||||
}
|
||||
|
||||
/* A heading over a group of a menu's entries (the list, card and swimlane
|
||||
menus, 2026-11-20): not an entry - nothing to click. */
|
||||
.pop-over .menu-group-heading {
|
||||
margin: 0;
|
||||
padding: 8px 10px 2px;
|
||||
font-size: 0.8em;
|
||||
font-weight: bold;
|
||||
text-transform: uppercase;
|
||||
letter-spacing: 0.04em;
|
||||
color: #6b778c;
|
||||
cursor: default;
|
||||
pointer-events: none;
|
||||
}
|
||||
@@ -160,6 +160,13 @@ template(name="featuresSecurity")
|
||||
.materialCheckBox(class="{{#if disableAllImport}}is-checked{{/if}}")
|
||||
span {{_ 'disable-all-import'}}
|
||||
p.description {{_ 'disable-all-import-description'}}
|
||||
//- The largest import upload (server/lib/importDiskSpace.js); empty is no
|
||||
limit, only the free disk space.
|
||||
li
|
||||
label.flex
|
||||
span {{_ 'import-max-megabytes'}}
|
||||
input.js-import-max-megabytes(type="number" min="0" step="1" value="{{importMaxMegabytes}}" placeholder="{{_ 'import-max-megabytes-none'}}")
|
||||
p.description {{_ 'import-max-megabytes-description'}}
|
||||
li
|
||||
a.flex.js-toggle-disable-all-export
|
||||
.materialCheckBox(class="{{#if disableAllExport}}is-checked{{/if}}")
|
||||
|
||||
@@ -1261,6 +1261,10 @@ const featurePaneHelpers = {
|
||||
disableAllExport() {
|
||||
return (ReactiveCache.getCurrentSetting() || {}).disableAllExport;
|
||||
},
|
||||
importMaxMegabytes() {
|
||||
const mb = (ReactiveCache.getCurrentSetting() || {}).importMaxMegabytes;
|
||||
return mb > 0 ? mb : '';
|
||||
},
|
||||
disableImportAvatars() {
|
||||
return (ReactiveCache.getCurrentSetting() || {}).disableImportAvatars;
|
||||
},
|
||||
@@ -1302,6 +1306,14 @@ const featurePaneEvents = {
|
||||
'click .js-toggle-disable-all-export'() {
|
||||
toggleSettingField('disableAllExport');
|
||||
},
|
||||
// Empty or 0 is no limit; anything else a whole number of megabytes.
|
||||
'change .js-import-max-megabytes'(event) {
|
||||
const setting = ReactiveCache.getCurrentSetting();
|
||||
if (!setting) return;
|
||||
const mb = Math.floor(Number(event.currentTarget.value));
|
||||
Settings.update(setting._id, Number.isFinite(mb) && mb > 0
|
||||
? { $set: { importMaxMegabytes: mb } } : { $unset: { importMaxMegabytes: '' } });
|
||||
},
|
||||
'click .js-toggle-disable-import-avatars'() {
|
||||
toggleSettingField('disableImportAvatars');
|
||||
},
|
||||
|
||||
@@ -1475,34 +1475,47 @@ Template.rolesGeneral.events({
|
||||
|
||||
// Feature #3313 "Shared templates": admin view of users' shareable template
|
||||
// boards, grouped by Organization / Team / email Domain. The three checkboxes
|
||||
// are LIVE view filters (no Save button) — each toggles a grouping dimension and
|
||||
// the selection is remembered (persisted in localStorage) so it survives reload.
|
||||
const SHARED_TEMPLATES_SCOPE_KEY = 'sharedTemplatesScopes';
|
||||
const SHARED_TEMPLATES_VALID_SCOPES = ['organizations', 'teams', 'domains'];
|
||||
// write the instance setting Settings.sharedTemplatesScopes at once (no Save
|
||||
// button, like every checkbox here): it is both which groupings this view lists
|
||||
// and which group kinds every user may share a template board with
|
||||
// (models/lib/sharedTemplatesScopes.js). It used to live in this browser's
|
||||
// localStorage, so it differed per browser and was empty for everyone else.
|
||||
const sharedScopes = require('/models/lib/sharedTemplatesScopes');
|
||||
|
||||
function loadSharedTemplatesScopes() {
|
||||
try {
|
||||
const raw = window.localStorage.getItem(SHARED_TEMPLATES_SCOPE_KEY);
|
||||
const arr = raw ? JSON.parse(raw) : [];
|
||||
return Array.isArray(arr)
|
||||
? arr.filter(s => SHARED_TEMPLATES_VALID_SCOPES.includes(s))
|
||||
: [];
|
||||
} catch (e) {
|
||||
return [];
|
||||
}
|
||||
return sharedScopes.sharedTemplatesScopes(ReactiveCache.getCurrentSetting());
|
||||
}
|
||||
|
||||
function saveSharedTemplatesScopes(scopes) {
|
||||
const setting = ReactiveCache.getCurrentSetting();
|
||||
if (!setting) return;
|
||||
Settings.update(setting._id, {
|
||||
$set: { sharedTemplatesScopes: sharedScopes.normalizeScopes(scopes) },
|
||||
});
|
||||
}
|
||||
|
||||
// An install that has never stored the setting takes over the ticks an admin
|
||||
// made in this browser while it was localStorage, once; the old key is then
|
||||
// dropped so it cannot come back.
|
||||
function carryOverLegacyScopes() {
|
||||
let legacy = [];
|
||||
try {
|
||||
window.localStorage.setItem(SHARED_TEMPLATES_SCOPE_KEY, JSON.stringify(scopes));
|
||||
const raw = window.localStorage.getItem(sharedScopes.LEGACY_STORAGE_KEY);
|
||||
legacy = sharedScopes.normalizeScopes(raw ? JSON.parse(raw) : []);
|
||||
window.localStorage.removeItem(sharedScopes.LEGACY_STORAGE_KEY);
|
||||
} catch (e) {
|
||||
// ignore storage errors (e.g. private mode)
|
||||
return;
|
||||
}
|
||||
const setting = ReactiveCache.getCurrentSetting();
|
||||
if (legacy.length && setting && setting.sharedTemplatesScopes === undefined) {
|
||||
saveSharedTemplatesScopes(legacy);
|
||||
}
|
||||
}
|
||||
|
||||
Template.templatesGeneral.onCreated(function () {
|
||||
// Restore the previously-checked scopes (empty by default → nothing shown).
|
||||
this.selectedScopes = new ReactiveVar(loadSharedTemplatesScopes());
|
||||
carryOverLegacyScopes();
|
||||
// The instance setting, reactively: another admin's change shows here too.
|
||||
this.selectedScopes = { get: loadSharedTemplatesScopes };
|
||||
// Raw rows returned by the admin-only method (one entry per user whose
|
||||
// Templates board is non-empty).
|
||||
this.sharedTemplates = new ReactiveVar([]);
|
||||
@@ -1598,15 +1611,7 @@ Template.templatesGeneral.events({
|
||||
'click a.js-toggle-template-scope'(event, tpl) {
|
||||
event.preventDefault();
|
||||
const scope = $(event.currentTarget).data('scope');
|
||||
const current = tpl.selectedScopes.get().slice();
|
||||
const idx = current.indexOf(scope);
|
||||
if (idx >= 0) {
|
||||
current.splice(idx, 1);
|
||||
} else {
|
||||
current.push(scope);
|
||||
}
|
||||
tpl.selectedScopes.set(current);
|
||||
saveSharedTemplatesScopes(current);
|
||||
saveSharedTemplatesScopes(sharedScopes.toggleScope(tpl.selectedScopes.get(), scope));
|
||||
},
|
||||
});
|
||||
|
||||
|
||||
@@ -0,0 +1,20 @@
|
||||
/* The Scrum meeting helpers (docs/Features/Scrum/Meetings.md). */
|
||||
.daily-standup {
|
||||
min-width: 220px;
|
||||
}
|
||||
.daily-standup-speaker {
|
||||
font-size: 1.4em;
|
||||
margin: 4px 0;
|
||||
}
|
||||
.daily-standup-clock {
|
||||
font-size: 2em;
|
||||
font-variant-numeric: tabular-nums;
|
||||
margin: 4px 0;
|
||||
}
|
||||
.daily-standup-clock.is-overtime {
|
||||
color: #c0392b;
|
||||
}
|
||||
.daily-standup-order {
|
||||
margin-block: 4px;
|
||||
padding-inline-start: 20px;
|
||||
}
|
||||
@@ -0,0 +1,26 @@
|
||||
//- The Scrum meeting helpers of the board menu (models/lib/scrumMeetings.js,
|
||||
docs/Features/Scrum/Meetings.md).
|
||||
template(name="dailyStandupPopup")
|
||||
.daily-standup.js-daily-standup
|
||||
if running
|
||||
with view
|
||||
if done
|
||||
p.daily-standup-done {{_ 'standup-done' time=(clockOf elapsedSeconds)}}
|
||||
button.js-standup-reset(type="button") {{_ 'start'}}
|
||||
else
|
||||
p.daily-standup-position {{position}} / {{count}}
|
||||
h3.daily-standup-speaker= speakerName
|
||||
p.daily-standup-clock(class="{{#if overtime}}is-overtime{{/if}}") {{clockOf remainingSeconds}}
|
||||
p.quiet {{_ 'standup-total' time=(clockOf elapsedSeconds)}}
|
||||
button.primary.js-standup-next(type="button") {{_ 'next'}}
|
||||
button.js-standup-reset(type="button") {{_ 'stop'}}
|
||||
else
|
||||
ol.daily-standup-order
|
||||
each person in order
|
||||
li= person.name
|
||||
p
|
||||
button.js-standup-shuffle(type="button")
|
||||
i.fa.fa-random
|
||||
| {{_ 'standup-shuffle'}}
|
||||
p.quiet {{_ 'standup-minutes'}}: {{minutes}}
|
||||
button.primary.js-standup-start(type="button" disabled=noPeople) {{_ 'start'}}
|
||||
@@ -0,0 +1,92 @@
|
||||
// The Scrum meeting helpers of the board menu (models/lib/scrumMeetings.js,
|
||||
// docs/Features/Scrum/Meetings.md): the daily standup timer, kept in this
|
||||
// browser only, and the button that makes a retrospective board.
|
||||
import { Meteor } from 'meteor/meteor';
|
||||
import { Template } from 'meteor/templating';
|
||||
import { ReactiveVar } from 'meteor/reactive-var';
|
||||
import { FlowRouter } from 'meteor/ostrio:flow-router-extra';
|
||||
import getSlug from 'limax';
|
||||
import { ReactiveCache } from '/imports/reactiveCache';
|
||||
import { TAPi18n } from '/imports/i18n';
|
||||
import { Utils } from '/client/lib/utils';
|
||||
import { allowFeature } from '/client/lib/instanceFeatures';
|
||||
import Lists from '/models/lists';
|
||||
|
||||
const meetings = require('/models/lib/scrumMeetings');
|
||||
const { DEFAULT_SCRUM_SETTINGS } = require('/models/lib/scrum');
|
||||
|
||||
const settingsOf = board => ({ ...DEFAULT_SCRUM_SETTINGS, ...(board && board.scrum) });
|
||||
|
||||
// Whether the board menu offers each: the instance's feature AND the board's
|
||||
// Scrum setting.
|
||||
export function showsStandupTimer(board) {
|
||||
return Boolean(board) && allowFeature('standup-timer') && settingsOf(board).standupTimer !== false;
|
||||
}
|
||||
export function showsRetrospectiveBoard(board) {
|
||||
return Boolean(board) && allowFeature('retrospective-board') && settingsOf(board).retrospectiveBoard !== false;
|
||||
}
|
||||
|
||||
const nameOf = userId => {
|
||||
const user = ReactiveCache.getUser(userId);
|
||||
return (user && (user.profile?.fullname || user.username)) || userId;
|
||||
};
|
||||
|
||||
Template.dailyStandupPopup.onCreated(function () {
|
||||
const board = Utils.getCurrentBoard();
|
||||
const people = (board?.activeMembers?.() || board?.members || []).filter(m => m.isActive !== false).map(m => m.userId);
|
||||
this.order = new ReactiveVar(meetings.shuffle(people));
|
||||
this.state = new ReactiveVar(null);
|
||||
this.now = new ReactiveVar(Date.now());
|
||||
this.minutes = meetings.standupMinutes(settingsOf(board).standupMinutes);
|
||||
this.timer = Meteor.setInterval(() => this.now.set(Date.now()), 1000);
|
||||
});
|
||||
Template.dailyStandupPopup.onDestroyed(function () {
|
||||
Meteor.clearInterval(this.timer);
|
||||
});
|
||||
|
||||
Template.dailyStandupPopup.helpers({
|
||||
order() { return Template.instance().order.get().map(userId => ({ userId, name: nameOf(userId) })); },
|
||||
noPeople() { return !Template.instance().order.get().length; },
|
||||
minutes() { return Template.instance().minutes; },
|
||||
running() { return Boolean(Template.instance().state.get()); },
|
||||
view() {
|
||||
const tpl = Template.instance();
|
||||
const view = meetings.standupView(tpl.state.get(), tpl.now.get());
|
||||
return view && { ...view, speakerName: view.speaker ? nameOf(view.speaker) : '' };
|
||||
},
|
||||
clockOf(seconds) { return meetings.clock(seconds); },
|
||||
});
|
||||
|
||||
Template.dailyStandupPopup.events({
|
||||
'click .js-standup-shuffle'(event, tpl) { tpl.order.set(meetings.shuffle(tpl.order.get())); },
|
||||
'click .js-standup-start'(event, tpl) {
|
||||
tpl.now.set(Date.now());
|
||||
tpl.state.set(meetings.startStandup(tpl.order.get(), tpl.minutes, Date.now()));
|
||||
},
|
||||
'click .js-standup-next'(event, tpl) {
|
||||
tpl.now.set(Date.now());
|
||||
tpl.state.set(meetings.nextSpeaker(tpl.state.get(), Date.now()));
|
||||
},
|
||||
'click .js-standup-reset'(event, tpl) { tpl.state.set(null); },
|
||||
});
|
||||
|
||||
// A new private board of the reader's for one retrospective: its lists Start
|
||||
// doing, Stop doing, Keep doing and Action items. Board creation is the
|
||||
// server's (createBoardWithInitialSwimlanes, with its "who may create
|
||||
// boards" check); the lists are the new board admin's own inserts.
|
||||
export async function createRetrospectiveBoard(board) {
|
||||
const plan = meetings.retrospectivePlan(board.title, new Date(), (key, fallback, options) => {
|
||||
const text = TAPi18n.__(key, options);
|
||||
return text && text !== key ? text : fallback;
|
||||
});
|
||||
const slug = getSlug(plan.title) || 'board';
|
||||
const boardId = await Meteor.callAsync('createBoardWithInitialSwimlanes', {
|
||||
title: plan.title, slug, permission: 'private', type: 'board', migrationVersion: 1,
|
||||
swimlanes: [{ title: TAPi18n.__('default'), sort: 0 }],
|
||||
});
|
||||
for (const [sort, title] of plan.lists.entries()) {
|
||||
await Lists.insertAsync({ title, boardId, sort, swimlaneId: '' });
|
||||
}
|
||||
FlowRouter.go('board', { id: boardId, slug });
|
||||
return boardId;
|
||||
}
|
||||
@@ -785,3 +785,18 @@ body.sidebar-resizing-active {
|
||||
background: var(--wekan-popup-background, #fff);
|
||||
box-shadow: 0 2px 6px rgba(0, 0, 0, 0.2);
|
||||
}
|
||||
|
||||
/* Board Settings / Board View: the heading over each group of views, as in
|
||||
the Board View menu (models/lib/boardViewSettings.js BOARD_VIEW_GROUPS). */
|
||||
.board-view-settings .board-view-settings-group-heading {
|
||||
padding: 8px 4px 2px;
|
||||
font-size: 0.8em;
|
||||
font-weight: bold;
|
||||
text-transform: uppercase;
|
||||
letter-spacing: 0.04em;
|
||||
color: #6b778c;
|
||||
border-top: 1px solid #dfe1e6;
|
||||
}
|
||||
.board-view-settings .board-view-settings-group-heading:first-child {
|
||||
border-top: 0;
|
||||
}
|
||||
@@ -755,24 +755,20 @@ template(name="boardMenuPopup")
|
||||
a.js-open-board-date-settings(title="{{_ 'date'}}")
|
||||
i.fa.fa-calendar
|
||||
| {{_ 'date'}}
|
||||
//- All Boards Settings: what the All Boards page shows of this board
|
||||
(card counters, member avatars), card aging, auto-archive and personal
|
||||
list widths. It was commented out for the #4214 "icons random dance";
|
||||
the All Boards tiles now read one fetch of getAllBoardsTileData, not
|
||||
reactive cursors, so the loop it caused cannot return. The popup hides
|
||||
its own counter and avatar rows when Admin Panel turns those off.
|
||||
li
|
||||
a.js-board-info-on-my-boards(title="{{_ 'board-info-on-my-boards'}}")
|
||||
i.fa.fa-id-card-o
|
||||
| {{_ 'board-info-on-my-boards'}}
|
||||
//- "Board backgrounds" was here. It was the list of pictures uploaded to
|
||||
this board, and that list is drawn inside Change Background Image now -
|
||||
under the upload that adds to it - so a second entry to the same list
|
||||
was a second place to look for one thing.
|
||||
//Bug Board icons random dance https://github.com/wekan/wekan/issues/4214
|
||||
//if currentUser.isBoardAdmin
|
||||
//
|
||||
unless currentSetting.hideBoardMemberList
|
||||
//
|
||||
unless currentSetting.hideCardCounterList
|
||||
//
|
||||
li
|
||||
//
|
||||
a.js-board-info-on-my-boards(title="{{_ 'board-info-on-my-boards'}}")
|
||||
//
|
||||
i.fa.fa-id-card-o
|
||||
//
|
||||
| {{_ 'board-info-on-my-boards'}}
|
||||
hr
|
||||
else if rulesReadable
|
||||
//- #2217: a member of a board that shows its Rules reads them here; the
|
||||
@@ -875,6 +871,18 @@ template(name="boardMenuPopup")
|
||||
| {{_ 'since-last-visit-count' count=sinceVisitCount}}
|
||||
else
|
||||
| {{_ 'since-last-visit'}}
|
||||
//- The Scrum meeting helpers (client/components/boards/scrum/scrumMeetings.jade),
|
||||
each hidden by its Admin Panel feature and by the board's Scrum settings.
|
||||
if showsStandupTimer
|
||||
li
|
||||
a.js-open-daily-standup
|
||||
i.fa.fa-hourglass-half
|
||||
| {{_ 'daily-standup'}}
|
||||
if showsRetrospectiveBoard
|
||||
li
|
||||
a.js-create-retrospective-board
|
||||
i.fa.fa-refresh
|
||||
| {{_ 'retrospective-board'}}
|
||||
unless currentBoard.isTemplatesBoard
|
||||
if currentUser.isBoardAdmin
|
||||
// li
|
||||
@@ -920,6 +928,9 @@ template(name="boardViewSettingsPopup")
|
||||
h4 {{_ 'description'}}
|
||||
.board-view-settings-rows.js-board-view-sortable
|
||||
each boardViewRows
|
||||
//- The same groups as the Board View menu; only rows are dragged.
|
||||
if groupLabelKey
|
||||
.board-view-settings-group-heading {{_ groupLabelKey}}
|
||||
.board-view-settings-row.js-board-view-row(data-view="{{view}}")
|
||||
unless ../publicBoardsHidden
|
||||
.board-view-settings-column
|
||||
@@ -1001,6 +1012,7 @@ template(name="boardListSettingsPopup")
|
||||
span
|
||||
i.fa.fa-columns
|
||||
| {{_ 'same-width-for-all-lists'}}
|
||||
+boardFlowListSettings
|
||||
|
||||
//- #2489: Board Settings / WIP Limit Groups - a shared WIP limit across two or
|
||||
more of this board's lists together, on top of the existing per-list
|
||||
|
||||
@@ -547,6 +547,17 @@ function openRulesViewFromBoardMenu(mode) {
|
||||
}
|
||||
|
||||
Template.boardMenuPopup.events({
|
||||
'click .js-open-daily-standup': Popup.open('dailyStandup'),
|
||||
async 'click .js-create-retrospective-board'() {
|
||||
const board = Utils.getCurrentBoard();
|
||||
if (!board) return;
|
||||
Popup.close();
|
||||
try {
|
||||
await require('/client/components/sidebar/scrumMeetings').createRetrospectiveBoard(board);
|
||||
} catch (error) {
|
||||
window.alert((error && (error.reason || error.error)) || String(error));
|
||||
}
|
||||
},
|
||||
'click .js-open-rules-list-view'(event) { event.preventDefault(); openRulesViewFromBoardMenu('list'); },
|
||||
'click .js-open-rules-workflow-view'(event) { event.preventDefault(); openRulesViewFromBoardMenu('workflow'); },
|
||||
'click .js-open-rules-bots-view'(event) { event.preventDefault(); openRulesViewFromBoardMenu('bots'); },
|
||||
@@ -780,8 +791,13 @@ Template.boardViewSettingsPopup.helpers({
|
||||
boardViewRows() {
|
||||
const board = Utils.getCurrentBoard();
|
||||
// #6736: views the instance disabled are not rows; their board settings stay.
|
||||
const ordered = boardViewSettings.orderedBoardViews(board).filter(v => allowBoardView(v.view));
|
||||
return ordered.map(v => ({
|
||||
// Grouped as the Board View menu is (BOARD_VIEW_GROUPS): a heading over
|
||||
// each group, the board's order inside it.
|
||||
const ordered = boardViewSettings.groupedBoardViews(
|
||||
boardViewSettings.orderedBoardViews(board).filter(v => allowBoardView(v.view)));
|
||||
const headingOf = group => (boardViewSettings.BOARD_VIEW_GROUPS.find(g => g.group === group) || {}).labelKey;
|
||||
return ordered.map((v, i) => ({
|
||||
groupLabelKey: i === 0 || ordered[i - 1].group !== v.group ? headingOf(v.group) : null,
|
||||
view: v.view,
|
||||
labelKey: v.labelKey,
|
||||
icon: `fa ${v.icon}`,
|
||||
@@ -993,6 +1009,11 @@ Template.wipLimitGroupsPopup.events({
|
||||
});
|
||||
|
||||
Template.boardMenuPopup.helpers({
|
||||
// The Scrum meeting helpers (scrumMeetings.js).
|
||||
showsStandupTimer() { return require('/client/components/sidebar/scrumMeetings').showsStandupTimer(Utils.getCurrentBoard()); },
|
||||
showsRetrospectiveBoard() {
|
||||
return require('/client/components/sidebar/scrumMeetings').showsRetrospectiveBoard(Utils.getCurrentBoard());
|
||||
},
|
||||
sinceVisitCount() {
|
||||
return Template.instance().sinceVisitCount.get();
|
||||
},
|
||||
|
||||
@@ -52,6 +52,8 @@ template(name="editSwimlaneTitleForm")
|
||||
i.fa.fa-times-thin
|
||||
|
||||
template(name="swimlaneActionPopup")
|
||||
//- Grouped under headings (2026-11-20), as the list and card menus are; every
|
||||
entry keeps its own condition.
|
||||
if currentUser
|
||||
//- Copy link, FIRST and above every permission check: a swimlane has an
|
||||
address now, and copying it is reading, not editing - somebody who may
|
||||
@@ -59,6 +61,7 @@ template(name="swimlaneActionPopup")
|
||||
The rows below are all guarded because they change the board.
|
||||
models/lib/boardItemUrl.js, docs/Features/General/Board-Item-Links.md
|
||||
ul.pop-over-list
|
||||
li.menu-group-heading {{_ 'menu-group-share'}}
|
||||
li: a.js-copy-swimlane-link
|
||||
i.fa.fa-link
|
||||
span
|
||||
@@ -83,6 +86,7 @@ template(name="swimlaneActionPopup")
|
||||
like copying a link it is READING - so it sits above the rows that change
|
||||
the board and is not guarded by them.
|
||||
ul.pop-over-list
|
||||
li.menu-group-heading {{_ 'menu-group-export'}}
|
||||
li: a.js-export-swimlane
|
||||
i.fa.fa-upload
|
||||
span {{_ 'export'}}
|
||||
@@ -95,6 +99,7 @@ template(name="swimlaneActionPopup")
|
||||
unless currentUser.isReadOnly
|
||||
unless currentUser.isReadAssignedOnly
|
||||
ul.pop-over-list
|
||||
li.menu-group-heading {{_ 'add'}}
|
||||
li: a.js-add-swimlane
|
||||
i.fa.fa-plus
|
||||
span
|
||||
@@ -115,12 +120,14 @@ template(name="swimlaneActionPopup")
|
||||
if currentUser.isBoardAdmin
|
||||
hr
|
||||
ul.pop-over-list
|
||||
li.menu-group-heading {{_ 'appearance'}}
|
||||
li: a.js-set-swimlane-color
|
||||
i.fa.fa-paint-brush
|
||||
| {{_ 'select-color'}}
|
||||
unless this.isTemplateContainer
|
||||
hr
|
||||
ul.pop-over-list
|
||||
li.menu-group-heading {{_ 'menu-group-move-copy'}}
|
||||
li: a.js-copy-swimlane
|
||||
i.fa.fa-clipboard
|
||||
| {{_ 'copy-swimlane'}}
|
||||
@@ -130,6 +137,7 @@ template(name="swimlaneActionPopup")
|
||||
| {{_ 'move-swimlane'}}
|
||||
hr
|
||||
ul.pop-over-list
|
||||
li.menu-group-heading {{_ 'archives'}}
|
||||
li: a.js-close-swimlane
|
||||
i.fa.fa-archive
|
||||
| {{_ 'archive-swimlane'}}
|
||||
|
||||
@@ -237,12 +237,6 @@ template(name="editProfilePopup")
|
||||
input#anonymizeButton.primary.wide(type="button" value="{{_ 'anonymize-account'}}")
|
||||
|
||||
|
||||
template(name="supportPopup")
|
||||
ul.pop-over-list
|
||||
li
|
||||
+viewer
|
||||
= currentSetting.supportPopupText
|
||||
|
||||
template(name="changePasswordPopup")
|
||||
+atForm(state='changePwd')
|
||||
|
||||
|
||||
@@ -121,7 +121,6 @@ Template.memberMenuPopup.events({
|
||||
'click .js-sqrl': Popup.open('sqrl'),
|
||||
'click .js-hidden-boards': Popup.open('hiddenBoards'),
|
||||
'click .js-change-language': Popup.open('changeLanguage'),
|
||||
'click .js-support': Popup.open('support'),
|
||||
async 'click .js-logout'(event) {
|
||||
event.preventDefault();
|
||||
if (Meteor.user()?.authenticationMethod === 'saml') {
|
||||
|
||||
@@ -4,6 +4,7 @@ import '/client/components/cards/cardDate.jade';
|
||||
import '/client/components/cards/cardDescription.jade';
|
||||
import '/client/components/cards/cardDetails.jade';
|
||||
import '/client/components/cards/cardFlowtime.jade';
|
||||
import '/client/components/cards/cardFlow.jade';
|
||||
import '/client/components/cards/cardPomodoro.jade';
|
||||
import '/client/components/cards/cardStickers.jade';
|
||||
import '/client/components/cards/cardTextNotes.jade';
|
||||
@@ -23,6 +24,7 @@ import '/client/components/cards/cardDetails.js';
|
||||
import '/client/components/cards/cardAddFields.js';
|
||||
import '/client/components/cards/cardDrawing.js';
|
||||
import '/client/components/cards/cardFlowtime.js';
|
||||
import '/client/components/cards/cardFlow.js';
|
||||
import '/client/components/cards/cardPomodoro.js';
|
||||
import '/client/components/cards/cardStickers.js';
|
||||
import '/client/components/cards/cardTextNotes.js';
|
||||
@@ -44,6 +46,7 @@ import '/client/components/cards/cardDetails.css';
|
||||
import '/client/components/cards/cardAddFields.css';
|
||||
import '/client/components/cards/cardDrawing.css';
|
||||
import '/client/components/cards/cardFlowtime.css';
|
||||
import '/client/components/cards/cardFlow.css';
|
||||
import '/client/components/cards/cardPomodoro.css';
|
||||
import '/client/components/cards/cardTime.css';
|
||||
import '/client/components/cards/checklists.css';
|
||||
|
||||
@@ -2,12 +2,15 @@ import '/client/components/lists/list.jade';
|
||||
import '/client/components/lists/listBody.jade';
|
||||
import '/client/components/lists/listHeader.jade';
|
||||
import '/client/components/lists/listPermissions.jade';
|
||||
import '/client/components/lists/listFlowPolicies.jade';
|
||||
import '/client/components/lists/minilist.jade';
|
||||
|
||||
import '/client/components/lists/list.js';
|
||||
import '/client/components/lists/listBody.js';
|
||||
import '/client/components/lists/listHeader.js';
|
||||
import '/client/components/lists/listPermissions.js';
|
||||
import '/client/components/lists/listFlowPolicies.js';
|
||||
|
||||
import '/client/components/lists/list.css';
|
||||
import '/client/components/lists/listFlowPolicies.css';
|
||||
|
||||
@@ -4,6 +4,7 @@ import '/client/components/sidebar/sidebarOriginalPositions.jade';
|
||||
import '/client/components/sidebar/sidebarCustomFields.jade';
|
||||
import '/client/components/sidebar/sidebarFilters.jade';
|
||||
import '/client/components/sidebar/sidebarSearches.jade';
|
||||
import '/client/components/sidebar/scrumMeetings.jade';
|
||||
|
||||
import '/client/components/sidebar/sidebar.js';
|
||||
import '/client/components/sidebar/sidebarArchives.js';
|
||||
@@ -13,7 +14,9 @@ import '/client/components/sidebar/sidebarSinceLastVisit.js';
|
||||
import '/client/components/sidebar/sidebarCustomFields.js';
|
||||
import '/client/components/sidebar/sidebarFilters.js';
|
||||
import '/client/components/sidebar/sidebarSearches.js';
|
||||
import '/client/components/sidebar/scrumMeetings.js';
|
||||
|
||||
import '/client/components/sidebar/sidebar.css';
|
||||
import '/client/components/sidebar/sidebarSearches.css';
|
||||
import '/client/components/sidebar/scrumMeetings.css';
|
||||
|
||||
+3
-1
@@ -380,9 +380,11 @@ FlowRouter.route('/share-target', {
|
||||
},
|
||||
});
|
||||
|
||||
// No sign-in guard: Admin Panel / Settings / Visibility marks the Support page
|
||||
// Public or not, and the template says "only for logged-in users" to a signed-out
|
||||
// visitor of a page that is not public (the publication then sends no text).
|
||||
FlowRouter.route('/support', {
|
||||
name: 'support',
|
||||
triggersEnter: [ensureSignedInUnlessSandstorm],
|
||||
action() {
|
||||
Session.set('currentBoard', null);
|
||||
Session.set('currentList', null);
|
||||
|
||||
@@ -44,6 +44,12 @@
|
||||
],
|
||||
"handling": "Six visible fields in ordinary/local wrapper Details; sprint and release names require the same board. Internal Scrum snapshots and revisions are excluded."
|
||||
},
|
||||
{
|
||||
"fields": [
|
||||
"flow"
|
||||
],
|
||||
"handling": "The Kanban and Scrum flow fields (models/lib/cardFlow.js: blocked and why, class of service, MoSCoW, WSJF) are not in card emails yet; blockedBy is a user id and is never written into a message."
|
||||
},
|
||||
{
|
||||
"fields": [
|
||||
"archived",
|
||||
|
||||
@@ -21,6 +21,15 @@ here: **Rule suggestions**, **Summary**, **Since your last visit** and
|
||||
risk, Suggested members, Forecast, Checklist from description and Action
|
||||
items - are card fields, below.
|
||||
|
||||
The Kanban and Scrum helpers are features here too, each also turned on or off
|
||||
per board: **List policies**, **Commitment point**, **WIP limit per person**
|
||||
and **Split lists** ([flow policies](../../Lists/Flow-Policies.md), Board
|
||||
Settings / List), and **Daily standup** and **Retrospective board**
|
||||
([Scrum meetings](../../Board-Sidebar/Board-Settings/Scrum-Meetings.md), Board
|
||||
Settings / Scrum). The four flow fields - Blocked, Class of service, MoSCoW
|
||||
priority and WSJF score ([flow fields](../../Cards/Flow-Fields.md)) - are card
|
||||
fields, below.
|
||||
|
||||
### Card fields
|
||||
|
||||
Above the Features **Save** there is one tick per field type of the board right
|
||||
|
||||
@@ -25,6 +25,11 @@ Until 2026-11-19 this pane was Admin Panel / Problems / Security;
|
||||
Jira, Kanboard, NextCloud Deck, OpenProject, GitHub, GitLab, Gitea and Forgejo,
|
||||
and cloning a board. The menu options are hidden and the server refuses any
|
||||
import request.
|
||||
- **Largest import (MB)** - the largest file the Import page accepts. Empty is
|
||||
no limit: a file may be as large as the free disk space lets the import
|
||||
finish. Every upload is written to the server's disk a part at a time and an
|
||||
import that would fill the disk is refused
|
||||
([Large files](../../Board-Sidebar/Board-Settings/Import-Export/External-Tools.md#large-files)).
|
||||
- **Disable all export** - every export is off: WeKan JSON, CSV, Excel, Kanboard,
|
||||
and to NextCloud Deck / OpenProject / GitHub / GitLab / Gitea / Forgejo, and
|
||||
single-attachment export.
|
||||
|
||||
@@ -18,8 +18,12 @@ returns, for the signed-in user:
|
||||
|
||||
The page then keeps only the kinds - organizations, teams, domains - that are
|
||||
ticked as scopes in Admin Panel / People / Shared templates. Those ticks are
|
||||
read from this browser's `localStorage` (`sharedTemplatesScopes`), where that
|
||||
pane stores them; a browser in which they were never set offers no targets.
|
||||
the instance setting `Settings.sharedTemplatesScopes`
|
||||
(`models/lib/sharedTemplatesScopes.js`), the same for every user in every
|
||||
browser; with none ticked, no targets are offered. (They used to be read from
|
||||
the browser's `localStorage`, so they differed per browser; the first time an
|
||||
admin opens that pane, ticks still stored there are carried over to the
|
||||
setting when the instance has none yet.)
|
||||
|
||||
## Sharing
|
||||
|
||||
|
||||
@@ -7,7 +7,7 @@ the card. For dragging cards to new dates, and for the start, end and received
|
||||
dates, use the [Calendar](Calendar.md) view.
|
||||
|
||||
A site admin can turn the calendar views off in Admin Panel / Settings /
|
||||
Visibility / Features ("Calendar views").
|
||||
Features ("Calendar views").
|
||||
|
||||
## What it shows
|
||||
|
||||
|
||||
@@ -0,0 +1,43 @@
|
||||
# Board reports
|
||||
|
||||
Twelve reports of the Board View menu, added on 2026-11-20 after comparing
|
||||
WeKan's charts with the reports of Jira, Azure DevOps, Nave, ActionableAgile and
|
||||
the Flow Framework. Each opens like the other charts: the **export bar at its
|
||||
top** (PDF and Excel, the same as every board chart), the chart drawn with
|
||||
Chart.js, and the data table under it, which is also what the export writes.
|
||||
|
||||
The calculations are `models/lib/boardReports.js` (`BOARD_REPORTS`), pure
|
||||
functions tested by `tests/boardReports.test.cjs`; the server loads only what a
|
||||
report reads (`server/lib/boardChartData.js` `loadBoardReport`). A card is
|
||||
**finished** at its end date, else when it was archived - as in the other
|
||||
charts. Weeks start on Monday (UTC); the weekly reports show the board's weeks,
|
||||
at most the last 52, and the chart the last 24 of them.
|
||||
|
||||
| Report | Board View | Group | What it shows |
|
||||
| --- | --- | --- | --- |
|
||||
| Created vs. Resolved | `board-view-created-resolved` | Kanban flow | Cards created and finished per week, and how many were open at the end of each week. The chart is the open count. |
|
||||
| Net Flow | `board-view-net-flow` | Kanban flow | Finished less created per week. Positive: the board empties; negative: work arrives faster than it leaves. |
|
||||
| Time in List | `board-view-time-in-list` | Kanban flow | For each list, how many stays cards had in it and their median and 85th percentile in days, from the change history of the cards' moves. A card never moved stayed in its list from its creation. |
|
||||
| Average Age | `board-view-average-age` | Kanban flow | At the end of each week, the open cards and their mean age in days. |
|
||||
| Throughput Run Chart | `board-view-throughput-run` | Kanban flow | Cards finished per week, in time order, with the median of the weeks (the Throughput Histogram shows the same counts as a distribution). |
|
||||
| Due Date Performance | `board-view-due-date-performance` | Kanban flow | Cards finished per week on time, late and without a due date, and the average days late. The chart is the share on time. |
|
||||
| Release Burndown | `board-view-release-burndown` | Scrum | For each Scrum release, its cards, those done and those left, and the projected finish at the weekly rate of the last four weeks. |
|
||||
| Epic Progress | `board-view-epic-progress` | Scrum | Every card with subtasks: its subtasks done and open, and the share done - the least finished first. |
|
||||
| Workload | `board-view-workload` | Overview | The open cards of each person (assignees, else members), and how many are in each list. |
|
||||
| Distribution | `board-view-distribution` | Overview | Open and finished cards by label, and each label's share of the open ones. |
|
||||
| Dependency Map | `board-view-dependency-map` | Overview | Every dependency of an open card - the relation, the card it depends on and whether that is done - and the length of the chain of open cards it waits on, the longest first. The dependency graph itself is exported as SVG from Board Settings → Export → Dependencies. |
|
||||
| Activity Heatmap | `board-view-activity-heatmap` | Overview | The board's changes of the last year by weekday and hour (UTC); the table is the heatmap, the chart each weekday's total. |
|
||||
|
||||
## Who sees them
|
||||
|
||||
The same as the other charts (`models/lib/exportAccess.js`): a member who may
|
||||
see only the cards assigned to them gets none of these reports, because each
|
||||
reads every card of the board. The instance can turn them off with the other
|
||||
flow charts in Admin Panel → Settings → Features, and a board admin can hide
|
||||
each in Board Settings → Board View.
|
||||
|
||||
## Export
|
||||
|
||||
The export bar at the top of each report writes its title and table as PDF or
|
||||
Excel (`models/exportCharts.js`, `models/lib/chartExportRows.js`). An export
|
||||
follows Admin Panel → Anonymize export users for the names in Workload.
|
||||
@@ -4,7 +4,7 @@ Board header → **Board View** → **Table**. The board's cards as a table: one
|
||||
per card, sortable by every column. A board admin can hide the view in
|
||||
[Board Settings / Board View](../../Board-Sidebar/Board-Settings/Board-View.md),
|
||||
and a site admin can turn it off for the whole instance in Admin Panel /
|
||||
Settings / Visibility / Features ("Table view").
|
||||
Settings / Features ("Table view").
|
||||
|
||||
## What it shows
|
||||
|
||||
|
||||
@@ -4,7 +4,7 @@ Board header → **Board View** → **Time**. The board's time tracking in one
|
||||
place: how much time is spent, by whom and on which cards. Time is entered on
|
||||
the cards themselves ([Time tracking](../../Cards/Time-Tracking.md)); this view
|
||||
only reports it. A site admin can turn it off with "Time views" in Admin Panel /
|
||||
Settings / Visibility / Features.
|
||||
Settings / Features.
|
||||
|
||||
## What it shows
|
||||
|
||||
|
||||
@@ -3,7 +3,7 @@
|
||||
Board header → **Board View** → **Timeline**. The board as it was at an earlier
|
||||
moment. Click a point on the line to see the cards, by list, as they were then;
|
||||
**Now** returns to the present. A site admin can turn it off with "Time views"
|
||||
in Admin Panel / Settings / Visibility / Features.
|
||||
in Admin Panel / Settings / Features.
|
||||
|
||||
## What it shows
|
||||
|
||||
|
||||
@@ -82,3 +82,15 @@ Role permissions apply in every view; see
|
||||
| Chat | `board-view-chat` | `chatView` in `client/components/boards/chatView.jade` | [Chat-View](Board-Views/Chat-View.md) |
|
||||
| Version Control | `board-view-version-control` | `versionControlView` in `client/components/boards/versionControlView.jade` | [Version-Control-View](Board-Views/Version-Control-View.md) |
|
||||
| Column sets | `board-view-column-sets` | `columnSetsView` in `client/components/boards/columnSetsView.jade` | [Column-Sets](Board-Views/Column-Sets.md) |
|
||||
| Created vs. Resolved | `board-view-created-resolved` | `createdResolvedView` in `client/components/boards/chartPlaceholderViews.jade` | [Board-Reports](Board-Views/Charts/Board-Reports.md) |
|
||||
| Net Flow | `board-view-net-flow` | `netFlowView` in `client/components/boards/chartPlaceholderViews.jade` | [Board-Reports](Board-Views/Charts/Board-Reports.md) |
|
||||
| Time in List | `board-view-time-in-list` | `timeInListView` in `client/components/boards/chartPlaceholderViews.jade` | [Board-Reports](Board-Views/Charts/Board-Reports.md) |
|
||||
| Average Age | `board-view-average-age` | `averageAgeView` in `client/components/boards/chartPlaceholderViews.jade` | [Board-Reports](Board-Views/Charts/Board-Reports.md) |
|
||||
| Throughput Run Chart | `board-view-throughput-run` | `throughputRunView` in `client/components/boards/chartPlaceholderViews.jade` | [Board-Reports](Board-Views/Charts/Board-Reports.md) |
|
||||
| Due Date Performance | `board-view-due-date-performance` | `dueDatePerformanceView` in `client/components/boards/chartPlaceholderViews.jade` | [Board-Reports](Board-Views/Charts/Board-Reports.md) |
|
||||
| Release Burndown | `board-view-release-burndown` | `releaseBurndownView` in `client/components/boards/chartPlaceholderViews.jade` | [Board-Reports](Board-Views/Charts/Board-Reports.md) |
|
||||
| Epic Progress | `board-view-epic-progress` | `epicProgressView` in `client/components/boards/chartPlaceholderViews.jade` | [Board-Reports](Board-Views/Charts/Board-Reports.md) |
|
||||
| Workload | `board-view-workload` | `workloadView` in `client/components/boards/chartPlaceholderViews.jade` | [Board-Reports](Board-Views/Charts/Board-Reports.md) |
|
||||
| Distribution | `board-view-distribution` | `distributionView` in `client/components/boards/chartPlaceholderViews.jade` | [Board-Reports](Board-Views/Charts/Board-Reports.md) |
|
||||
| Dependency Map | `board-view-dependency-map` | `dependencyMapView` in `client/components/boards/chartPlaceholderViews.jade` | [Board-Reports](Board-Views/Charts/Board-Reports.md) |
|
||||
| Activity Heatmap | `board-view-activity-heatmap` | `activityHeatmapView` in `client/components/boards/chartPlaceholderViews.jade` | [Board-Reports](Board-Views/Charts/Board-Reports.md) |
|
||||
@@ -4,11 +4,11 @@
|
||||
`boardInfoOnMyBoardsPopup` in `client/components/sidebar/sidebar.jade`, with
|
||||
its helpers and events in `client/components/sidebar/sidebar.js`.
|
||||
|
||||
**It is not in the Board Settings menu at the moment.** The menu entry that
|
||||
opens it (`a.js-board-info-on-my-boards`, `fa-id-card-o`) is commented out in
|
||||
`boardMenuPopup`, with the note *Bug Board icons random dance* (#4214). The
|
||||
popup and its click handler (`'click .js-board-info-on-my-boards'`) are still
|
||||
in the code, so this page describes what it does when opened.
|
||||
A board admin opens it from the Board Settings menu, below **Date**
|
||||
(`a.js-board-info-on-my-boards`, `fa-id-card-o`). The entry was commented out
|
||||
for a while because of the *Bug Board icons random dance* (#4214), a reactive
|
||||
re-render loop on All Boards; the board tiles now read one fetch of
|
||||
`getAllBoardsTileData` instead of reactive cursors, so the entry is back.
|
||||
|
||||
## The popup
|
||||
|
||||
|
||||
@@ -7,6 +7,23 @@ board opens in - separately for when the board is **public** and when it is
|
||||
offer only Roadmap and Gantt and open in Roadmap, while the same board, made
|
||||
private again, shows its members every view and opens in Swimlanes.
|
||||
|
||||
## Groups
|
||||
|
||||
The Board View menu and this popup show the views in six groups, each under its
|
||||
heading (`BOARD_VIEW_GROUPS` in `models/lib/boardViewSettings.js`):
|
||||
|
||||
| Group | Views |
|
||||
| --- | --- |
|
||||
| Board | Swimlanes, Lists, Table, Column sets, Group by Assignee, Map, Bigboard |
|
||||
| Calendar and time | Calendar, Calendar Mode, Multi Board Calendar, Time, Timeline, Gantt, Frappe Gantt, DHTMLX Gantt, Roadmap |
|
||||
| Scrum | Product Backlog, Sprints, Sprint Report, Velocity, Burndown, Burnup, Release Burndown, Epic Progress |
|
||||
| Kanban flow | Cumulative Flow, Control, Cycle Time, Lead Time, Flow Efficiency, Throughput Histogram, WIP Run, Aging WIP, Blocker Analysis, Monte Carlo, Process Behavior, Size vs. Cycle Time, Created vs. Resolved, Net Flow, Time in List, Average Age, Throughput Run Chart, Due Date Performance |
|
||||
| Overview | Dashboard, Pulse, Statistics, Workload, Distribution, Dependency Map, Activity Heatmap |
|
||||
| Communication and code | Email, Chat, Version Control |
|
||||
|
||||
The order a board admin drags here decides inside each group; a view stays in
|
||||
its own group. A group none of whose views is shown has no heading.
|
||||
|
||||
## Where to find it
|
||||
|
||||
**Board sidebar (hamburger menu) → Board Settings → Board View**, the first
|
||||
@@ -108,6 +125,18 @@ menu's own order**, with the same translation keys the menu uses:
|
||||
38. Chat (`board-view-chat`)
|
||||
39. Version Control (`board-view-version-control`)
|
||||
40. Column sets (`board-view-column-sets`)
|
||||
41. Created vs. Resolved (`board-view-created-resolved`)
|
||||
42. Net Flow (`board-view-net-flow`)
|
||||
43. Time in List (`board-view-time-in-list`)
|
||||
44. Average Age (`board-view-average-age`)
|
||||
45. Throughput Run Chart (`board-view-throughput-run`)
|
||||
46. Due Date Performance (`board-view-due-date-performance`)
|
||||
47. Release Burndown (`board-view-release-burndown`)
|
||||
48. Epic Progress (`board-view-epic-progress`)
|
||||
49. Workload (`board-view-workload`)
|
||||
50. Distribution (`board-view-distribution`)
|
||||
51. Dependency Map (`board-view-dependency-map`)
|
||||
52. Activity Heatmap (`board-view-activity-heatmap`)
|
||||
|
||||
The one list is `BOARD_VIEWS` in `models/lib/boardViewSettings.js`. Both the
|
||||
popup and the Board View menu (`boardChangeViewPopup` in
|
||||
|
||||
@@ -153,6 +153,14 @@ where the helper works:
|
||||
|
||||
All are on by default except the minicard's forecast.
|
||||
|
||||
## The flow fields
|
||||
|
||||
The Card section also has four Kanban and Scrum fields, each a row with its
|
||||
Show on Minicard and Show on Card checkboxes, off until turned on:
|
||||
**Blocked** (with a reason), **Class of service**, **MoSCoW priority** and
|
||||
**WSJF score**. Admin Panel can hide any of them on every board. See
|
||||
[flow fields](../../Cards/Flow-Fields.md).
|
||||
|
||||
## Prerequisites
|
||||
|
||||
- Only a board admin can change these settings; only an admin can drag a
|
||||
|
||||
@@ -127,6 +127,10 @@ What the current code does (`parseAsana` in `models/lib/externalParsers.js`):
|
||||
| `gid` | Source reference, for parent and dependency links |
|
||||
| `name`, `notes` | Card title, description |
|
||||
| `start_at` / `start_on`, `due_at` / `due_on` | Start date, due date |
|
||||
| `actual_time_minutes` (time tracking) | Spent time (hours), written back on export |
|
||||
| `html_notes`, when there are no `notes` | Card description, as text |
|
||||
| `approval_status` of an approval task (not pending) | Label `approval:approved`, `approval:rejected` or `approval:changes requested` |
|
||||
| `likes` of a comment story | The comment's 👍 reactions, by who liked it; likes the export does not name are counted in the loss report |
|
||||
| `completed_at` (when completed) | End date |
|
||||
| `created_at` | Creation date |
|
||||
| `assignee` | Card member, when mapped |
|
||||
|
||||
@@ -110,7 +110,7 @@ The fetched JSON, which is also what the REST API takes:
|
||||
| `created_at` | Created date |
|
||||
| `completed` | Due date marked done; a completed to-do is archived |
|
||||
| `assignees` | Members: the first as owner, then the others |
|
||||
| Card `steps` (`title`, `completed`) | Checklist "Steps" |
|
||||
| Card `steps` (`title`, `completed`, `due_on`, `assignees`) | Checklist "Steps", each item with the step's due date and first assignee |
|
||||
| Comments (`content`, `creator`, `created_at`) | Comments |
|
||||
| Card and to-do `id` | Source reference |
|
||||
|
||||
|
||||
@@ -205,7 +205,7 @@ Last activity and Voting are not imported.
|
||||
| Parent card | The card's parent, by title |
|
||||
| Spent time, Overtime, Archived | Spent time, overtime, archived |
|
||||
| `CustomField-...` | Board custom fields and the card's values |
|
||||
| Other columns ticked in the mapping step | Text custom fields |
|
||||
| Every other named column | A text custom field of its name: ticked in the mapping step by default, and always when no mapping is sent (a REST import) |
|
||||
|
||||
The export writes every column listed under **Export columns**.
|
||||
|
||||
@@ -213,8 +213,8 @@ The export writes every column listed under **Export columns**.
|
||||
|
||||
On import:
|
||||
|
||||
- columns no field uses and that were not ticked as custom fields,
|
||||
including WeKan's Last activity and Voting columns;
|
||||
- columns unticked in the mapping step, and WeKan's own Number, Last
|
||||
activity and Voting columns, which no card field takes;
|
||||
- members who were not mapped (Requested By and Assigned By keep them as
|
||||
text);
|
||||
- label names with spaces or commas in them: those separate two labels;
|
||||
|
||||
@@ -129,7 +129,8 @@ From the current code (`models/lib/clickupCsvFormat.js`):
|
||||
Name, the board is named **Imported ClickUp tasks**.
|
||||
|
||||
The export writes the 31 workspace export columns, from **Task ID** to
|
||||
**Rolled Up Time Text**, then **Checklist**:
|
||||
**Rolled Up Time Text**, then **Checklist**, then one column per custom field
|
||||
of the board that is not one of those named above:
|
||||
|
||||
- Task ID is the WeKan card id; Parent ID and Subtask IDs link the cards of
|
||||
the same board;
|
||||
@@ -162,6 +163,8 @@ The export writes the 31 workspace export columns, from **Task ID** to
|
||||
| Due date | Due date |
|
||||
| Start date | Start date |
|
||||
| Time Spent / Time Tracked | Spent time, in hours |
|
||||
| Task Link | `Source: <link>` at the end of the description |
|
||||
| Any other column (a workspace export writes each custom field as one) | A custom field of the column's name |
|
||||
| Priority | Custom field Priority |
|
||||
| Task Type (other than task) | Custom field Task Type |
|
||||
| Task Custom ID | Custom field Custom ID |
|
||||
@@ -187,11 +190,11 @@ silently:
|
||||
- a parent that is not in the same import, a Task ID used twice, and a parent
|
||||
link that would form a cycle.
|
||||
|
||||
Other columns, such as Task Link, Rolled Up Time and the `Text` date columns,
|
||||
are not read and not reported.
|
||||
ClickUp's own Rolled Up Time and `Text` date columns repeat other columns,
|
||||
and are not read.
|
||||
|
||||
The export leaves out comments, attachments, done state of checklist items,
|
||||
spent time, archived cards, and custom fields other than those named above.
|
||||
The export writes the spent hours as Time Spent (milliseconds). It leaves
|
||||
out comments, attachments, done state of checklist items and archived cards.
|
||||
|
||||
## REST API
|
||||
|
||||
|
||||
@@ -0,0 +1,87 @@
|
||||
# Discord
|
||||
|
||||
WeKan imports a Discord channel exported with
|
||||
[DiscordChatExporter](https://github.com/Tyrrrz/DiscordChatExporter) as a
|
||||
board for **Board View → Chat**: the channel is a card in its category, the
|
||||
server its swimlane, and the messages the card's comments.
|
||||
|
||||
## How to import
|
||||
|
||||
1. Export the channel with DiscordChatExporter in the **JSON** format.
|
||||
2. In WeKan, go to **All Boards → New → Import → Discord (DiscordChatExporter)**.
|
||||
3. Choose the `.json` file, or paste its text - or, when DiscordChatExporter
|
||||
ran with `--media` (the attachments downloaded beside the JSON), zip the
|
||||
folder with the `.json` and its `_Files` folder and choose the `.zip`.
|
||||
4. Map the authors to WeKan members, or leave them as they are.
|
||||
5. Click **Import**.
|
||||
|
||||
## How to import many boards at once
|
||||
|
||||
1. On the import page, choose **Discord (DiscordChatExporter)**, then under **Import many boards**
|
||||
choose several files, or one `.zip` that holds them.
|
||||
2. Each file becomes its own board. The boards are imported without member
|
||||
mapping; members can be mapped later.
|
||||
|
||||
Discord is imported through the generalized importer
|
||||
(`models/kanboardCreator.js`), so the page also has the checkbox **One board
|
||||
per project**: each swimlane the import would create becomes its own board.
|
||||
|
||||
From a script:
|
||||
|
||||
```bash
|
||||
python3 api.py importboardsfrom discord FILE_OR_DIR ...
|
||||
```
|
||||
|
||||
## How to export
|
||||
|
||||
Discord has no import of its own for a file WeKan could write, so WeKan does not export to it. Export the board in another format, for example [WeKan JSON](../WeKan/WeKan.md).
|
||||
|
||||
## How to export all boards at once
|
||||
|
||||
Discord has no import of its own for a file WeKan could write, so WeKan does not export to it. Export the board in another format, for example [WeKan JSON](../WeKan/WeKan.md).
|
||||
|
||||
## Format details
|
||||
|
||||
The JSON has `guild`, `channel` (name, category, topic, type) and
|
||||
`messages` with `author`, `timestamp` and `content`; an array of such exports
|
||||
imports every channel (`models/lib/chatExportFormats.js`). Ordinary messages and
|
||||
replies are imported; pins, joins and other system messages are not.
|
||||
|
||||
## What is kept
|
||||
|
||||
Channel name and topic, category, server, messages with author, nickname and time.
|
||||
|
||||
## Replies
|
||||
|
||||
A reply, found by its `reference`, is a reply to the comment of the message it answers,
|
||||
one level deep as WeKan's replies are: a reply to a reply goes under the same
|
||||
comment. A reply to a message that is not in the file is a comment of its own,
|
||||
starting with "↳".
|
||||
|
||||
## Reactions
|
||||
|
||||
A message's reactions become the comment's reactions, read from the emoji itself.
|
||||
WeKan keeps a reaction by who reacted, so a reaction is kept for each person
|
||||
mapped to a WeKan user in the members step. The loss report counts the
|
||||
reactions of people who were not mapped, and those with an emoji WeKan cannot
|
||||
store: a shortcode WeKan does not know, a server's or a chat's own emoji, or an
|
||||
emoji of several code points (a skin tone, a flag). See
|
||||
`models/lib/importedReactions.js`.
|
||||
|
||||
## What is not kept
|
||||
|
||||
Attachments that are only links (not downloaded with `--media`) and stickers (counted), embeds, a server's own emoji reactions. An attachment the zipped folder carries is an attachment of the channel's card. What was left out is listed in the import's loss report, also in
|
||||
**Admin Panel → Problems → Recovery**.
|
||||
|
||||
## REST API
|
||||
|
||||
- Import: `POST /api/boards/import/discord` with the file's text, or a
|
||||
`.zip` as `{ "zipBase64": "..." }`, as for every source of the import page.
|
||||
|
||||
## How it is built and tested
|
||||
|
||||
`tests/chatExportFormats.test.cjs` reads a channel with an attachment and a system message, and refuses JSON without a channel and messages.
|
||||
|
||||
## Sources
|
||||
|
||||
- [DiscordChatExporter](https://github.com/Tyrrrz/DiscordChatExporter)
|
||||
@@ -0,0 +1,90 @@
|
||||
# Evernote
|
||||
|
||||
WeKan imports Evernote's `.enex` export as a board, and exports a board as
|
||||
an `.enex` file that Evernote, Joplin and other note apps import. A note is a
|
||||
card: its text the description, its to-do checkboxes a checklist, its tags
|
||||
labels and its reminder the due date.
|
||||
|
||||
## How to import
|
||||
|
||||
1. In Evernote, select the notes or a notebook, choose **Export**, and save
|
||||
as `.enex`.
|
||||
2. In WeKan, go to **All Boards → New → Import → Evernote (.enex)**.
|
||||
3. Choose the `.enex` file, or paste its text.
|
||||
4. Click **Import**.
|
||||
|
||||
## How to import many boards at once
|
||||
|
||||
1. On the import page, choose **Evernote (.enex)**, then under **Import many boards**
|
||||
choose several files, or one `.zip` that holds them.
|
||||
2. Each file becomes its own board. The boards are imported without member
|
||||
mapping; members can be mapped later.
|
||||
|
||||
Evernote is imported through the generalized importer
|
||||
(`models/kanboardCreator.js`), so the page also has the checkbox **One board
|
||||
per project**: each swimlane the import would create becomes its own board.
|
||||
|
||||
From a script:
|
||||
|
||||
```bash
|
||||
python3 api.py importboardsfrom evernote FILE_OR_DIR ...
|
||||
```
|
||||
|
||||
## How to export
|
||||
|
||||
1. Open the board, then **Board Settings → Export**, and choose **Evernote
|
||||
(.enex)**. The board downloads as `<board>.enex`.
|
||||
2. Import it in Evernote (**File → Import → ENEX**) or Joplin (**File →
|
||||
Import → ENEX**).
|
||||
|
||||
Each card is a note: the description as text, each checklist as a heading and
|
||||
to-do lines, the comments after a line, the labels and the list as tags, the
|
||||
due date as the reminder (done when the due date is complete) and the creator
|
||||
as the author.
|
||||
|
||||
## How to export all boards at once
|
||||
|
||||
1. In WeKan, go to **All Boards**, open the sidebar and choose **Export all
|
||||
boards**, then **Evernote (.enex)**.
|
||||
2. One `.zip` downloads, with one `.enex` file per board you can export.
|
||||
|
||||
From a script:
|
||||
|
||||
```bash
|
||||
python3 api.py exportallboards enex boards.zip
|
||||
```
|
||||
|
||||
## Format details
|
||||
|
||||
ENEX is XML: `<en-export>` with `<note>`s, each with `title`, `content` (ENML,
|
||||
XHTML in a CDATA section), `created`, `updated`, `tag`s, `note-attributes`
|
||||
(`reminder-time`, `reminder-done-time`, `author`, `source-url`) and `resource`s.
|
||||
The server parses it with htmlparser2 (`server/lib/enexImport.js`) and reads
|
||||
the content's text, a line per block, each `<en-todo>` marked as a checklist
|
||||
item; scripts, styles, media and encrypted parts are dropped. A note whose
|
||||
reminder is done goes to **Done**, the others to **Notes**
|
||||
(`models/lib/enexFormat.js`).
|
||||
|
||||
## What is kept
|
||||
|
||||
Title, text, to-dos and whether each is done, tags, created date, reminder and its done time, author, source URL.
|
||||
|
||||
## What is not kept
|
||||
|
||||
Images and attached files (counted), formatting, encrypted text, notebook stacks. What was left out is listed in the import's loss report, also in
|
||||
**Admin Panel → Problems → Recovery**.
|
||||
|
||||
## REST API
|
||||
|
||||
- Import: `POST /api/boards/import/evernote` with the file's text, or a
|
||||
`.zip` as `{ "zipBase64": "..." }`, as for every source of the import page.
|
||||
- Export: `GET /api/boards/:boardId/export/enex`.
|
||||
|
||||
## How it is built and tested
|
||||
|
||||
`tests/enexFormat.test.cjs` reads notes with to-dos, tags, reminders, a script and a resource, refuses a file that is not ENEX, and exports a board - with a `]]>` in its text - and reads it back.
|
||||
|
||||
## Sources
|
||||
|
||||
- [How Evernote's XML export format works](https://evernote.com/blog/how-evernotes-xml-export-format-works)
|
||||
- [Evernote export DTD](http://xml.evernote.com/pub/evernote-export4.dtd)
|
||||
@@ -8,6 +8,17 @@ tools. You use them from the existing menus:
|
||||
text where the format is text.
|
||||
- **Export**: **Board Settings → Export**. Choose the scope and the fields to
|
||||
include, then the format.
|
||||
- Both list the tools under the same headings - WeKan, Kanban and project
|
||||
tools, Issue trackers and version control, Task and to-do apps,
|
||||
Spreadsheets and tables, Text and outlines, Mail, calendars, chats and
|
||||
notes, and Fetched from a service - from one table,
|
||||
`models/lib/toolGroups.js`, so a tool is in the same group on both.
|
||||
- A company with more than one product there has a heading of its own, right
|
||||
after WeKan, and its products are listed under it without the company's
|
||||
name in front: **37signals** (Basecamp, Fizzy), **Atlassian** (Trello,
|
||||
Jira), **Google** (Takeout, Tasks, Keep) and **Microsoft** (Planner, To Do,
|
||||
Excel, GitHub). A company with one product stays under the heading of its
|
||||
kind.
|
||||
- **Rules and workflows**: **Board Settings → Rules → Import / Export rules**
|
||||
(see [Rules](../../../Rules/Rules/Rules.md#import--export)).
|
||||
|
||||
@@ -37,6 +48,7 @@ sources of the format.
|
||||
| [Linear](./Linear/Linear.md) | Issues CSV export | Linear CSV |
|
||||
| [Notion](./Notion/Notion.md) | *Markdown & CSV* export `.zip`, or one database CSV | Notion database CSV |
|
||||
| [Redmine](./Redmine/Redmine.md) | Issues list *Also available in: CSV* | Redmine issues CSV |
|
||||
| [Fizzy](./Fizzy/Fizzy.md) | Account export or personal data export `.zip`, or one card's `.json` | Fizzy account export `.zip` (its account import reads it) |
|
||||
| [Plane](./Plane/Plane.md) | Workspace Settings → Exports `.zip` (CSV, JSON or XLSX inside), or one file from it | — (Plane has no file import) |
|
||||
| [Taiga](./Taiga/Taiga.md) | Project export (dump) JSON | Taiga project dump JSON, with sprints |
|
||||
| [Pivotal Tracker](./Pivotal-Tracker/Pivotal-Tracker.md) | Stories CSV | Pivotal Tracker CSV |
|
||||
@@ -84,6 +96,24 @@ own API, so the exported file is for a script that calls it.
|
||||
| [OPML](./OPML/OPML.md) | Outline from Workflowy, Dynalist, OmniOutliner, Logseq and others | OPML (`.opml`) |
|
||||
| [Leo](./Leo/Leo.md) | Leo outline (`.leo`) | Leo outline |
|
||||
|
||||
## Mail, calendars, chats and notes
|
||||
|
||||
Mail shows in Board View → Email, chats in Board View → Chat (a channel is a
|
||||
card, its messages the comments), and dated items in Calendar and Gantt.
|
||||
|
||||
| Tool | Import (the file you give WeKan) | Export (the file WeKan writes) |
|
||||
| --- | --- | --- |
|
||||
| [Mail (mbox, .eml)](./Mail/Mail.md) | An `.mbox` (Thunderbird, Apple Mail, mutt, Gmail) or one `.eml` message | Mail (mbox) |
|
||||
| [iCalendar (.ics)](./iCalendar/iCalendar.md) | An `.ics` file: tasks (VTODO) by status, and events | Calendar feed of the board's dates |
|
||||
| [Google Takeout](./Google-Takeout/Google-Takeout.md) | The Takeout `.zip`: Tasks, Keep, Mail, Calendar and Google Chat | — (Takeout is not imported back into Google) |
|
||||
| [Slack](./Slack/Slack.md) | The workspace export `.zip` | — |
|
||||
| [Mattermost](./Mattermost/Mattermost.md) | Bulk export `.jsonl` (`mmctl export create`) | Mattermost bulk import `.jsonl` |
|
||||
| [Telegram](./Telegram/Telegram.md) | Telegram Desktop's JSON export `result.json` | — |
|
||||
| [WhatsApp](./WhatsApp/WhatsApp.md) | *Export chat* `.txt` | — |
|
||||
| [Discord (DiscordChatExporter)](./Discord/Discord.md) | DiscordChatExporter JSON | — |
|
||||
| [Rocket.Chat](./Rocket-Chat/Rocket-Chat.md) | "Download my data" as JSON `.zip`, one room's `.json`, or a CSV importer `.zip` | Rocket.Chat CSV importer `.zip` |
|
||||
| [Evernote (.enex)](./Evernote/Evernote.md) | Notes export `.enex` | Evernote (.enex) |
|
||||
|
||||
## WeKan's own formats and documents
|
||||
|
||||
| Format | Import | Export |
|
||||
@@ -92,7 +122,6 @@ own API, so the exported file is for a script that calls it.
|
||||
| [CSV / TSV](./CSV/CSV.md) | Comma, semicolon or tab separated | CSV `,` / CSV `;` / TSV |
|
||||
| [Excel](./Excel/Excel.md) | WeKan-style `.xlsx` | Excel (`.xlsx`) |
|
||||
| [PDF](./PDF/PDF.md), [HTML](./HTML/HTML.md) | — | PDF and an HTML archive of the board |
|
||||
| [iCalendar](./iCalendar/iCalendar.md) | — | Calendar feed of the board's dates |
|
||||
| [Dependencies](./Dependencies/Dependencies.md) | — | Dependency graph as JSON or SVG |
|
||||
| [Rules](./Rules/Rules.md) | WeKan rules JSON or CSV, Trello Butler text, n8n and Node-RED workflows, Wrike workflows | WeKan rules JSON or CSV, Wrike workflow |
|
||||
|
||||
@@ -119,6 +148,36 @@ at a time, never held whole in memory, and held to the upload limit set in
|
||||
**Admin Panel → Attachments → Limits**, if one is set
|
||||
(`server/lib/importAttachmentStream.js`).
|
||||
|
||||
## Large files
|
||||
|
||||
A file chosen on the Import page for any tool of the generalized importer is
|
||||
sent to the server a part at a time (`POST /api/import/upload/:source`,
|
||||
`server/routes/importUpload.js`) and written to `WRITABLE_PATH/import-uploads`,
|
||||
never held whole in the browser or in the server's memory on the way:
|
||||
|
||||
- before the first byte, the size the browser announces is checked against
|
||||
the largest import the administrator set (Admin Panel → Settings → Security)
|
||||
and against the free space of that disk, less a reserve
|
||||
(`IMPORT_DISK_RESERVE_MB`, default 512 MB); while it is written, the space is
|
||||
checked again every 64 MB. An import that would fill the disk is refused with
|
||||
that reason, and its partial file is removed;
|
||||
- with no limit set, an import may be as large as the free disk space lets it
|
||||
finish;
|
||||
- a `.zip` export (Slack, Google Takeout, Vikunja, Notion, Plane, Rocket.Chat,
|
||||
Fizzy) is opened from the disk, its entries read as they are needed, and what they inflate to is
|
||||
counted against the limit or the free space; a mailbox is read a message at
|
||||
a time, also inside a Takeout zip;
|
||||
- JSON is built from the file a chunk at a time (`server/lib/streamJson.js`),
|
||||
so an export larger than one JavaScript string - about 512 MB - can still be
|
||||
read; a Mattermost export is read a line at a time;
|
||||
- a Jira file is uploaded too, and the people of its map-members step are read
|
||||
from it on the server; a CSV / TSV file's header, sample rows and people come
|
||||
from the server for its column mapping step;
|
||||
- the file is removed once it has been read, or after an hour.
|
||||
|
||||
`tests/importUpload.test.cjs` covers the limit, the full disk before and during
|
||||
the upload, an interrupted upload and how each source reads its file.
|
||||
|
||||
## Many boards at once
|
||||
|
||||
- **Import many boards**: on the import page of any tool, choose several of
|
||||
|
||||
@@ -0,0 +1,119 @@
|
||||
# Fizzy
|
||||
|
||||
WeKan imports a board from [Fizzy](https://github.com/basecamp/fizzy), the
|
||||
kanban tool of 37signals, and exports a board as the account export Fizzy's own
|
||||
account import reads.
|
||||
|
||||
## How to import
|
||||
|
||||
1. In Fizzy, export either:
|
||||
- the whole account: **Account settings → Export** (admins and owners), or
|
||||
- your own cards: your profile → **Download my data**.
|
||||
Fizzy e-mails a link to the `.zip`.
|
||||
2. In WeKan, go to **All Boards → New → Import → Fizzy**.
|
||||
3. Choose the `.zip`, or one card's `.json` from the personal export, or paste
|
||||
that file's text.
|
||||
4. Map the people to WeKan members, or leave them as they are.
|
||||
5. Click **Import**.
|
||||
|
||||
## How to import many boards at once
|
||||
|
||||
1. On the import page, choose **Fizzy**, then under **Import many boards**
|
||||
choose several files.
|
||||
2. Each file becomes its own board. The boards are imported without member
|
||||
mapping; members can be mapped later.
|
||||
|
||||
Fizzy is imported through the generalized importer
|
||||
(`models/kanboardCreator.js`), so the page also has the checkbox **One board
|
||||
per project**: each Fizzy board becomes a WeKan board of its own.
|
||||
|
||||
From a script:
|
||||
|
||||
```bash
|
||||
python3 api.py importboardsfrom fizzy FILE_OR_DIR ...
|
||||
```
|
||||
|
||||
## How to export
|
||||
|
||||
1. Open the board, then **Board Settings → Export**, and choose **Fizzy**. The
|
||||
board downloads as `<board>.zip`.
|
||||
2. In Fizzy, make a new account from the zip with its account import
|
||||
(**Import** when signing up an account, or `script/import-account` on a
|
||||
server you run).
|
||||
|
||||
Each swimlane is a Fizzy board (a board with one swimlane is one Fizzy board
|
||||
named after it), each list a column in the board's order, and the lists named
|
||||
**Maybe?**, **Not now** and **Done** are Fizzy's own places of the same names.
|
||||
An archived card is closed (Done). The account is named after the board. The
|
||||
people are users of the new account with no e-mail address, so the import never
|
||||
joins them to existing accounts; every user can open every board.
|
||||
|
||||
## How to export all boards at once
|
||||
|
||||
1. In WeKan, go to **All Boards**, open the sidebar and choose **Export all
|
||||
boards**, then **Fizzy**.
|
||||
2. One `.zip` downloads, with one Fizzy account export per board you can export.
|
||||
|
||||
From a script:
|
||||
|
||||
```bash
|
||||
python3 api.py exportallboards fizzy boards.zip
|
||||
```
|
||||
|
||||
## Format details
|
||||
|
||||
The account export (`app/models/account/data_transfer/*` in Fizzy) holds a row
|
||||
of each table as `data/<table>/<id>.json` with every column of
|
||||
`db/schema.rb`, `data/account.json`, the users as `data/users/<id>.json`, rich
|
||||
text as `data/action_text_rich_texts/<id>.json` and the uploaded files as
|
||||
`storage/<blob key>`. Ids are UUIDv7 written in base36, 25 characters. The
|
||||
personal data export (`Card::Exportable`) holds `<number>.json` per card -
|
||||
number, title, board, status, creator, description (HTML), dates and comments -
|
||||
and its files under `<number>/<blob key>_<filename>`
|
||||
(`models/lib/fizzyFormat.js`, `server/lib/fizzyArchive.js`).
|
||||
|
||||
A Fizzy board becomes a swimlane; its columns become lists in their position
|
||||
order, after **Maybe?** (cards not yet triaged into a column) and before
|
||||
**Not now** (postponed) and **Done** (closed) - the status names Fizzy itself
|
||||
exports.
|
||||
|
||||
## What is kept
|
||||
|
||||
Boards, columns, cards with title, description, created date and due date,
|
||||
tags as labels, assignees as the card's members, the creator as "requested by",
|
||||
steps as the checklist **Steps**, comments by their author at their time, a
|
||||
golden card as the colour gold, and the files in a description or a comment
|
||||
(and a card's image) as attachments.
|
||||
|
||||
## What is not kept
|
||||
|
||||
Drafts never published (counted), reactions, watchers and pins (counted), and
|
||||
boosts, events, notifications, webhooks and column colours. On export: users'
|
||||
e-mail addresses, attachments, and a card's other dates. What was left out is
|
||||
listed in the import's loss report, also in **Admin Panel → Problems →
|
||||
Recovery**.
|
||||
|
||||
## REST API
|
||||
|
||||
- Import: `POST /api/boards/import/fizzy` with one card's `.json` text, or a
|
||||
`.zip` as `{ "zipBase64": "..." }`.
|
||||
- Export: `GET /api/boards/:boardId/export/fizzy`.
|
||||
|
||||
## How it is built and tested
|
||||
|
||||
`tests/fizzyFormat.test.cjs` reads an account export with columns out of
|
||||
order, a triaged, an untriaged, a closed, a postponed and a draft card, tags,
|
||||
assignments, steps, a comment, an embedded file and a missing one; reads a
|
||||
personal data export with its files; refuses what is not a Fizzy export and a
|
||||
file path outside a card's folder; and exports a board, checks every row has
|
||||
every column Fizzy's import requires, is named by its id and names only users
|
||||
of the export, and reads it back. The Playwright round trip
|
||||
(`tests/playwright/specs/export-import-round-trip.e2e.js`) sends it through the
|
||||
server.
|
||||
|
||||
## Sources
|
||||
|
||||
- [Fizzy source](https://github.com/basecamp/fizzy)
|
||||
- [Fizzy account data transfer](https://github.com/basecamp/fizzy/tree/main/app/models/account/data_transfer)
|
||||
- [Fizzy card export](https://github.com/basecamp/fizzy/blob/main/app/models/card/exportable.rb)
|
||||
- [Fizzy exports API](https://github.com/basecamp/fizzy/blob/main/docs/api/sections/exports.md)
|
||||
@@ -129,7 +129,9 @@ metadata and label colors are not imported.
|
||||
The export (`forgejo` in `models/lib/externalExportFormatters.js`) is the same
|
||||
as GitHub's: for each card that is not archived, `title`, `body`, `state`
|
||||
(`closed` when the list name contains done, closed, complete, archiv or
|
||||
finished, otherwise `open`), `labels` (as `{ "name": ... }`) and `due_date`.
|
||||
finished, otherwise `open`), `labels` (as `{ "name": ... }`), `due_date`, the
|
||||
owner as `assignee` (and `assignees`), the creator as `user`, `created_at`,
|
||||
`closed_at` for a closed issue, and a **Time estimate (hours)** custom field as `time_estimate` (seconds).
|
||||
|
||||
## What is kept
|
||||
|
||||
@@ -142,6 +144,8 @@ finished, otherwise `open`), `labels` (as `{ "name": ... }`) and `due_date`.
|
||||
| `state_reason` other than completed | Label `state_reason:...` |
|
||||
| `milestone.title` | Label `milestone:...` |
|
||||
| `milestone.due_on`, else `due_date` | Due date |
|
||||
| `created_at`, and `closed_at` of a closed issue | Created and end dates |
|
||||
| `time_estimate` (seconds, Gitea 1.23 and later) | Custom field **Time estimate (hours)** |
|
||||
| First of `assignees` (`assignee`) | Owner, when mapped to a WeKan user |
|
||||
| Other assignees | Labels `assignee:...` |
|
||||
| `user.login` | Requested By |
|
||||
|
||||
@@ -67,6 +67,7 @@ page or a format in the export menu has no page here.
|
||||
| [Linear](./Linear/Linear.md) | yes | yes |
|
||||
| [Notion](./Notion/Notion.md) | yes | yes |
|
||||
| [Redmine](./Redmine/Redmine.md) | yes | yes |
|
||||
| [Fizzy](./Fizzy/Fizzy.md) | yes | yes |
|
||||
| [Plane](./Plane/Plane.md) | yes | — |
|
||||
| [Taiga](./Taiga/Taiga.md) | yes | yes |
|
||||
| [Pivotal Tracker](./Pivotal-Tracker/Pivotal-Tracker.md) | yes | yes |
|
||||
@@ -93,6 +94,15 @@ page or a format in the export menu has no page here.
|
||||
| [Basecamp](./Basecamp/Basecamp.md) | yes | — |
|
||||
| [Google Tasks](./Google-Tasks/Google-Tasks.md) | yes | — |
|
||||
| [Google Keep](./Google-Keep/Google-Keep.md) | yes | — |
|
||||
| [Mail](./Mail/Mail.md) | yes | yes |
|
||||
| [Google Takeout](./Google-Takeout/Google-Takeout.md) | yes | — |
|
||||
| [Slack](./Slack/Slack.md) | yes | — |
|
||||
| [Mattermost](./Mattermost/Mattermost.md) | yes | yes |
|
||||
| [Telegram](./Telegram/Telegram.md) | yes | — |
|
||||
| [WhatsApp](./WhatsApp/WhatsApp.md) | yes | — |
|
||||
| [Discord](./Discord/Discord.md) | yes | — |
|
||||
| [Rocket.Chat](./Rocket-Chat/Rocket-Chat.md) | yes | yes |
|
||||
| [Evernote](./Evernote/Evernote.md) | yes | yes |
|
||||
|
||||
The [overview](./External-Tools.md) groups them by kind.
|
||||
|
||||
|
||||
@@ -149,7 +149,9 @@ creation or close dates, relationships or events.
|
||||
The export (`models/lib/externalExportFormatters.js`, `githubLike`) writes, for
|
||||
each card that is not archived: `title`, `body` (the description), `state`
|
||||
(`closed` when the list name contains done, closed, complete, archiv or
|
||||
finished, otherwise `open`), `labels` (as `{ "name": ... }`) and `due_date`.
|
||||
finished, otherwise `open`), `labels` (as `{ "name": ... }`), `due_date`, the
|
||||
owner as `assignee` (and `assignees`), the creator as `user`, `created_at`,
|
||||
`closed_at` for a closed issue.
|
||||
GitHub has no `due_date` field; WeKan reads it back when the file is imported
|
||||
again.
|
||||
|
||||
@@ -164,6 +166,8 @@ again.
|
||||
| `state_reason` other than completed | Label `state_reason:...` |
|
||||
| `milestone.title` | Label `milestone:...` |
|
||||
| `milestone.due_on`, else `due_date` | Due date |
|
||||
| `created_at`, and `closed_at` of a closed issue | Created and end dates |
|
||||
| `type.name` (GitHub's issue types: Bug, Feature, Task, or the organization's own) | Label `type:<name>` |
|
||||
| First of `assignees` (`assignee`) | Owner, when mapped to a WeKan user |
|
||||
| Other assignees | Labels `assignee:...` |
|
||||
| `user.login` | Requested By |
|
||||
|
||||
@@ -167,8 +167,8 @@ each card that is not archived: `title`, `description`, `state` (`closed` when
|
||||
the list name contains done, closed, complete, archiv or finished, otherwise
|
||||
`opened`), `labels` (names), `due_date`, and, when the parts are ticked,
|
||||
`assignees` (owner first), `author`, `created_at`, `closed_at` (closed items
|
||||
only), comments as `notes`, and the sprint and release as `iteration` and
|
||||
`milestone`. It writes no `iid`, so importing the file again does not add a
|
||||
only), comments as `notes`, the spent hours as `time_stats.total_time_spent`
|
||||
(seconds), and the sprint and release as `iteration` and `milestone`. It writes no `iid`, so importing the file again does not add a
|
||||
second `Source:` line.
|
||||
|
||||
## What is kept
|
||||
@@ -182,6 +182,8 @@ second `Source:` line.
|
||||
| `milestone` | Scrum release, and label `milestone:...` |
|
||||
| `iteration` | Scrum sprint, and label `iteration:...` |
|
||||
| `issue_type` other than issue | Label `type:...` |
|
||||
| `health_status` (on_track, needs_attention, at_risk) | Label `health:...` |
|
||||
| `severity` of an incident (not UNKNOWN) | Label `severity:...` |
|
||||
| `confidential` | Label `confidential`, and a warning |
|
||||
| `due_date`, else `milestone.due_date` | Due date |
|
||||
| `created_at` | Creation date |
|
||||
|
||||
@@ -129,7 +129,9 @@ metadata and label colors are not imported.
|
||||
The export (`gitea` in `models/lib/externalExportFormatters.js`) is the same
|
||||
as GitHub's: for each card that is not archived, `title`, `body`, `state`
|
||||
(`closed` when the list name contains done, closed, complete, archiv or
|
||||
finished, otherwise `open`), `labels` (as `{ "name": ... }`) and `due_date`.
|
||||
finished, otherwise `open`), `labels` (as `{ "name": ... }`), `due_date`, the
|
||||
owner as `assignee` (and `assignees`), the creator as `user`, `created_at`,
|
||||
`closed_at` for a closed issue, and a **Time estimate (hours)** custom field as `time_estimate` (seconds).
|
||||
|
||||
## What is kept
|
||||
|
||||
@@ -142,6 +144,8 @@ finished, otherwise `open`), `labels` (as `{ "name": ... }`) and `due_date`.
|
||||
| `state_reason` other than completed | Label `state_reason:...` |
|
||||
| `milestone.title` | Label `milestone:...` |
|
||||
| `milestone.due_on`, else `due_date` | Due date |
|
||||
| `created_at`, and `closed_at` of a closed issue | Created and end dates |
|
||||
| `time_estimate` (seconds, Gitea 1.23 and later) | Custom field **Time estimate (hours)** |
|
||||
| First of `assignees` (`assignee`) | Owner, when mapped to a WeKan user |
|
||||
| Other assignees | Labels `assignee:...` |
|
||||
| `user.login` | Requested By |
|
||||
|
||||
+85
@@ -0,0 +1,85 @@
|
||||
# Google Takeout
|
||||
|
||||
WeKan imports a [Google Takeout](https://takeout.google.com) `.zip` as one
|
||||
board with a swimlane per Google product: **Mail** for Board View → Email,
|
||||
**Tasks** and **Keep** as cards with their checklists, **Calendar** events and
|
||||
tasks with their dates for Calendar and Gantt, and **Google Chat** spaces whose
|
||||
messages are comments for Board View → Chat.
|
||||
|
||||
## How to import
|
||||
|
||||
1. At [takeout.google.com](https://takeout.google.com), choose **Tasks**,
|
||||
**Keep**, **Mail**, **Calendar** and **Google Chat** (any of them), choose
|
||||
the `.zip` file type, create the export and download it.
|
||||
2. In WeKan, go to **All Boards → New → Import → Google Takeout**.
|
||||
3. Choose the `.zip` file.
|
||||
4. Map the people to WeKan members, or leave them as they are.
|
||||
5. Click **Import**, and read the loss report: it lists the products in the
|
||||
zip that have no place on a board.
|
||||
|
||||
## How to import many boards at once
|
||||
|
||||
1. On the import page, choose **Google Takeout**, then under **Import many boards**
|
||||
choose several files, or one `.zip` that holds them.
|
||||
2. Each file becomes its own board. The boards are imported without member
|
||||
mapping; members can be mapped later.
|
||||
|
||||
Google Takeout is imported through the generalized importer
|
||||
(`models/kanboardCreator.js`), so the page also has the checkbox **One board
|
||||
per project**: each swimlane the import would create becomes its own board.
|
||||
|
||||
From a script:
|
||||
|
||||
```bash
|
||||
python3 api.py importboardsfrom googletakeout FILE_OR_DIR ...
|
||||
```
|
||||
|
||||
## How to export
|
||||
|
||||
Google Takeout has no import of its own for a file WeKan could write, so WeKan does not export to it. Export the board in another format, for example [WeKan JSON](../WeKan/WeKan.md).
|
||||
|
||||
## How to export all boards at once
|
||||
|
||||
Google Takeout has no import of its own for a file WeKan could write, so WeKan does not export to it. Export the board in another format, for example [WeKan JSON](../WeKan/WeKan.md).
|
||||
|
||||
## Format details
|
||||
|
||||
The products are recognised by what a file is, not by its folder name,
|
||||
which Takeout writes in the account's language (`server/lib/chatArchives.js`):
|
||||
|
||||
- a JSON file of `"kind": "tasks#taskLists"` - **Tasks**: task lists become
|
||||
lists, tasks cards, with notes, links, due date, completion (tagged `done`)
|
||||
and the parent of a subtask;
|
||||
- a JSON file with `textContent` or `listContent` - a **Keep** note: in the
|
||||
list **Notes** or **Archived**, its checklist, labels, color, *pinned* as a
|
||||
label; notes in the trash are left out;
|
||||
- `.mbox` - **Mail**, as [Mail](../Mail/Mail.md) reads it, in **Inbox**, the
|
||||
board's first list, which the Email view reads;
|
||||
- `.ics` - **Calendar**, as [iCalendar](../iCalendar/iCalendar.md) reads it;
|
||||
- `messages.json` and `group_info.json` of a folder - a **Google Chat** space
|
||||
or direct message (`models/lib/chatExportFormats.js`).
|
||||
|
||||
The mapping is `models/lib/googleTakeoutFormat.js`.
|
||||
|
||||
## What is kept
|
||||
|
||||
Everything the products above carry that a card has: titles, text, dates, checklists, labels, colors, the mail fields of the Email view and the messages of the Chat view.
|
||||
|
||||
## What is not kept
|
||||
|
||||
Other Google products (YouTube, Drive, Photos and the rest, listed in the loss report), attachments and images, Keep notes in the trash. The zip is read within bounds: at most 128 MB, 50,000 files and 256 MB unpacked. What was left out is listed in the import's loss report, also in
|
||||
**Admin Panel → Problems → Recovery**.
|
||||
|
||||
## REST API
|
||||
|
||||
- Import: `POST /api/boards/import/googletakeout` with the file's text, or a
|
||||
`.zip` as `{ "zipBase64": "..." }`, as for every source of the import page.
|
||||
|
||||
## How it is built and tested
|
||||
|
||||
`tests/googleTakeoutFormat.test.cjs` builds a Takeout zip with Finnish folder names and every product, reads it with the server's zip reader and checks each swimlane, the Inbox being first, the trash and the skipped products; and refuses a zip with nothing for a board and a file that is not a zip.
|
||||
|
||||
## Sources
|
||||
|
||||
- [Google Takeout](https://takeout.google.com)
|
||||
- [Google Tasks API task resource](https://developers.google.com/tasks/reference/rest/v1/tasks)
|
||||
+3
-3
@@ -90,7 +90,7 @@ The parser (`models/lib/googletasksApiFormat.js`):
|
||||
| `due` | Due date |
|
||||
| `status: completed` | Archived card |
|
||||
| `completed` | End date |
|
||||
| Subtasks (`parent`) | Checklist "Subtasks", done = completed |
|
||||
| Subtasks (`parent`) | Checklist "Subtasks", done = completed, with the subtask's due date |
|
||||
| `position` | Card and checklist item order |
|
||||
| Hidden (cleared) completed tasks | Archived cards |
|
||||
|
||||
@@ -99,8 +99,8 @@ The parser (`models/lib/googletasksApiFormat.js`):
|
||||
The import reports these on the loss report:
|
||||
|
||||
- deleted tasks (`deleted: true`), counted per list;
|
||||
- the notes, due date and links of a subtask: a checklist item has only a
|
||||
title and a done mark;
|
||||
- the notes and links of a subtask: a checklist item has a title, done, a due
|
||||
date and an assignee;
|
||||
- a subtask whose parent is missing (it becomes its own card);
|
||||
- a due date that is not a date;
|
||||
- a second list with the same title (it is imported as `<title> (2)`);
|
||||
|
||||
@@ -94,7 +94,9 @@ What the current code does:
|
||||
- `responsibleUserId` is the owner and `collaborators` are further
|
||||
assignees, both by the user's full name (or e-mail without one), mapped to
|
||||
WeKan members on the members step.
|
||||
- `subTasks` become a checklist **Subtasks**, `finished` = done.
|
||||
- `subTasks` become a checklist **Subtasks**, `finished` = done, a subtask's
|
||||
`dueDate` the item's due date and its `userId` the item's assignee (when
|
||||
mapped).
|
||||
- Comments keep their author and date.
|
||||
- The task id is the source reference.
|
||||
- Limits: 20,000 tasks; comments are fetched for the first 5,000 tasks
|
||||
@@ -117,7 +119,7 @@ What the current code does:
|
||||
| `totalSecondsEstimate` | Custom field "Estimate (hours)" |
|
||||
| `responsibleUserId` | Card member (owner) |
|
||||
| `collaborators` | Card members |
|
||||
| `subTasks` (`name`, `finished`) | Checklist "Subtasks" |
|
||||
| `subTasks` (`name`, `finished`, `dueDate`, `userId`) | Checklist "Subtasks", with each item's due date and assignee |
|
||||
| Comments | Comments, with author and date |
|
||||
|
||||
## What is not kept
|
||||
@@ -126,7 +128,7 @@ The import reports these on the loss report:
|
||||
|
||||
- the column a due date is tied to (`targetColumnId`): WeKan keeps the date;
|
||||
- every due date after the first;
|
||||
- a subtask's own person and due date;
|
||||
- a subtask due date that is not a date;
|
||||
- a color that is not one of KanbanFlow's ten;
|
||||
- a due date that is not a date;
|
||||
- a task in a column the board does not have, and tasks that are not objects;
|
||||
|
||||
@@ -121,8 +121,9 @@ From the [format coverage](../Format-Coverage.md) audit:
|
||||
creation dates, archive state, colors and source order are kept. Creation
|
||||
dates survive the schema's `createdAt` autoValue through
|
||||
`writeImportedEntity`. What has no equivalent is listed in the loss report:
|
||||
file contents (the JSON carries attachment metadata only), time estimates,
|
||||
external links, and task links WeKan cannot keep (see below).
|
||||
file contents (the JSON carries attachment metadata only), a repeat other
|
||||
than every 1 day, 7 days or 1 month, and task links WeKan cannot keep (see
|
||||
below).
|
||||
|
||||
What the current code does (`parseKanboard` in
|
||||
`models/lib/externalParsers.js`, `models/kanboardCreator.js`):
|
||||
@@ -175,8 +176,12 @@ What the current code does (`parseKanboard` in
|
||||
| `owner_username` (or `assignee_username`, `owner_id`, `owner_name`) | Card member, when mapped |
|
||||
| `creator_username` (or `creator_name`) | Requested by |
|
||||
| `tags`, category, `priority` | Board labels |
|
||||
| `color_id` | Card color |
|
||||
| `color_id` | Card color, written back on export |
|
||||
| `time_spent` | Spent time (hours) |
|
||||
| `time_estimated` | Custom field **Time estimate (hours)** |
|
||||
| `score`, `reference` | Custom fields **Score** and **Reference** |
|
||||
| `recurrence_status`, `recurrence_factor`, `recurrence_timeframe`: every 1 day, 7 days or 1 month | The card repeats daily, weekly or monthly |
|
||||
| `external_links` (`url`, `title`) | A line each at the end of the description |
|
||||
| `is_active` `0` | Archived card |
|
||||
| `subtasks` (`title`, `status`) | Checklist **Subtasks** |
|
||||
| `links` "is a child of" / "is a parent of" | The card's parent card |
|
||||
@@ -189,7 +194,10 @@ each card: an `id` (1, 2, 3 ... in card order), `title`, `description`,
|
||||
`column_name`, `swimlane_name`, `date_due`, `date_started`, `date_completed`,
|
||||
`date_creation`, `owner_username`, `creator_username`, the labels as `tags`,
|
||||
every checklist item as a `subtasks` entry (status `2` when finished, `0`
|
||||
otherwise), the comments, and the card's parent and dependencies as `links`
|
||||
otherwise), the comments, `time_spent`, a repeating open card's
|
||||
`recurrence_status`, `recurrence_factor` and `recurrence_timeframe`, the
|
||||
custom fields **Time estimate (hours)**, **Score** and **Reference** as
|
||||
`time_estimated`, `score` and `reference`, and the card's parent and dependencies as `links`
|
||||
in the `getAllTaskLinks` shape (`{ "id", "task_id", "label" }`, `task_id`
|
||||
being the other task). Like Kanboard, each link is written from both tasks,
|
||||
the second time with the opposite label, and the import folds the two back
|
||||
@@ -200,10 +208,9 @@ when **Dependencies** is.
|
||||
|
||||
The import reports these on the loss report:
|
||||
|
||||
- `time_estimated` (WeKan cards have no estimate field; map it to a custom
|
||||
field by hand);
|
||||
- `files` (the API export carries metadata, not file contents);
|
||||
- `external_links` (links to web pages and other systems are not imported);
|
||||
- a repeat other than every 1 day, 7 days or 1 month (the task is imported
|
||||
once);
|
||||
- task links to a task that is not in the file;
|
||||
- task links whose label is not one of Kanboard's built-in link types
|
||||
(a link type added in Kanboard's settings);
|
||||
|
||||
@@ -93,6 +93,11 @@ What the current code does (`models/lib/leoOutline.js`):
|
||||
- The outline is the `<v t="gnx">` nodes under `<vnodes>`. A node's body is
|
||||
the `<t tx="gnx">` under `<tnodes>` with the same id. A node marked in Leo
|
||||
carries `a="M"`.
|
||||
- Leo stamps a node's id with the time it was made (`ekr.20260902080910.2`);
|
||||
that time is the card's creation date. Leo writes it in local time with no
|
||||
zone, so it is read as UTC.
|
||||
- Any other attribute of a `<v>` or `<t>` is a Leo plugin's own data (its
|
||||
"unknown attributes", pickled Python), and is reported.
|
||||
- A level 3 node with children is a checklist named after it; all its
|
||||
descendants, at any depth, are the items. Level 3 nodes without children
|
||||
are the items of one checklist named after the card.
|
||||
@@ -113,7 +118,8 @@ What the export writes (`models/lib/leoOutlineFormat.js`):
|
||||
- each list as a top-level node, including lists without cards;
|
||||
- each card as a child node, with its description as the body, marked when
|
||||
its list's name looks finished (contains "done", "closed", "complete",
|
||||
"archiv" or "finished");
|
||||
"archiv" or "finished"), and its creation time in its id
|
||||
(`wekan.YYYYMMDDHHMMSS.n`);
|
||||
- each checklist as a child of the card, with its items as children, marked
|
||||
when finished.
|
||||
|
||||
@@ -128,6 +134,7 @@ Archived cards and archived lists are not exported.
|
||||
| Level 2 node: headline | Card title |
|
||||
| Level 2 node: body | Card description |
|
||||
| Level 2 node marked (`a="M"`) | Card with the label `done` |
|
||||
| Level 2 node: the time in its id | Creation date |
|
||||
| Level 3 node with children | Checklist, its descendants the items |
|
||||
| Level 3 node without children | Item of a checklist named after the card |
|
||||
| Marked item node | Finished checklist item |
|
||||
@@ -137,10 +144,12 @@ Archived cards and archived lists are not exported.
|
||||
The import reports these on the loss report:
|
||||
|
||||
- body text of a top-level (list) node: a WeKan list has no text field;
|
||||
- a Leo plugin's data on a node (an attribute Leo itself does not write);
|
||||
- nodes deeper than 64 levels.
|
||||
|
||||
The Leo export writes only lists, cards, descriptions, the done mark and
|
||||
checklists. It does not write swimlanes, labels, dates, members, comments,
|
||||
The Leo export writes only lists, cards, descriptions, the done mark, the
|
||||
creation date and checklists. It does not write swimlanes, labels, other
|
||||
dates, members, comments,
|
||||
custom fields or attachments.
|
||||
|
||||
## REST API
|
||||
|
||||
@@ -97,10 +97,16 @@ What the import covers:
|
||||
- `, `-separated labels;
|
||||
- the created, started, completed (or canceled) and due dates;
|
||||
- Archived as an archived card;
|
||||
- Priority, Estimate, Project and Cycle (and Canceled) as custom fields.
|
||||
- Priority, Estimate, Project and Cycle (and Canceled) as custom fields;
|
||||
- with Scrum ticked in the import, each cycle as a Scrum sprint with its Cycle
|
||||
Start and Cycle End, one per team (a cycle number is its team's), and each
|
||||
project milestone as a Scrum release. The CSV gives a cycle no state: one
|
||||
whose issues are all done is finished and not imported, as no commitment or
|
||||
close snapshot is in the export, and any other is imported as planned. A
|
||||
milestone has no dates in the CSV. Both are noted in the loss report.
|
||||
|
||||
Reported: Updated, Triaged, the cycle's dates, Initiatives, milestones, SLA
|
||||
Status, dates that are not ISO 8601, and unknown priorities. The export writes
|
||||
Reported: Updated, Triaged, Initiatives, SLA Status, dates that are not ISO
|
||||
8601, and unknown priorities. The export writes
|
||||
Linear's columns in its order, with the formula guard.
|
||||
|
||||
From the current code (`models/lib/linearCsvFormat.js`):
|
||||
|
||||
@@ -0,0 +1,106 @@
|
||||
# Mail
|
||||
|
||||
WeKan imports mail as a board for **Board View → Email**, and exports a
|
||||
board as an `.mbox` file. The import reads an **mbox** (RFC 4155) - the file
|
||||
Thunderbird, Apple Mail, mutt and Gmail through Google Takeout write - or a
|
||||
single **.eml** message (RFC 5322 / MIME). Each conversation becomes one card
|
||||
in the list **Inbox**, with its sender, recipients and subject, so it is mail in
|
||||
the Email view; the replies become the card's comments.
|
||||
|
||||
## How to import
|
||||
|
||||
1. Get the file: in Thunderbird, save the folder with an add-on such as
|
||||
ImportExportTools NG as `.mbox`, or save one message as `.eml`; in Apple
|
||||
Mail, **Mailbox → Export Mailbox**; from Gmail, use
|
||||
[Google Takeout](../Google-Takeout/Google-Takeout.md) (**Mail**) and take the
|
||||
`.mbox` from the zip; mutt and other Unix mail programs keep mbox files
|
||||
already.
|
||||
2. In WeKan, go to **All Boards → New → Import → Mail (mbox, .eml)**.
|
||||
3. Choose the `.mbox` or `.eml` file, or paste its text.
|
||||
4. Map the senders to WeKan members, or leave them as they are: a sender who
|
||||
is not mapped is named at the start of the comment.
|
||||
5. Click **Import**, and read the loss report.
|
||||
|
||||
## How to import many boards at once
|
||||
|
||||
1. On the import page, choose **Mail (mbox, .eml)**, then under **Import many boards**
|
||||
choose several files, or one `.zip` that holds them.
|
||||
2. Each file becomes its own board. The boards are imported without member
|
||||
mapping; members can be mapped later.
|
||||
|
||||
Mail is imported through the generalized importer
|
||||
(`models/kanboardCreator.js`), so the page also has the checkbox **One board
|
||||
per project**: each swimlane the import would create becomes its own board.
|
||||
|
||||
From a script:
|
||||
|
||||
```bash
|
||||
python3 api.py importboardsfrom mail FILE_OR_DIR ...
|
||||
```
|
||||
|
||||
## How to export
|
||||
|
||||
1. Open the board, then **Board Settings → Export**.
|
||||
2. Under the tools, choose **Mail (mbox)**. The board downloads as
|
||||
`<board>.mbox`.
|
||||
3. Open it in Thunderbird (ImportExportTools NG), Apple Mail (**File → Import
|
||||
Mailboxes**) or mutt.
|
||||
|
||||
Each card is a message from its creator, with the title as the subject and the
|
||||
description as the text; its comments follow as replies (`In-Reply-To`). A card
|
||||
that came from mail keeps its sender, recipients and Message-ID - unless Admin
|
||||
Panel anonymizes exports, which leaves them out because they name people.
|
||||
|
||||
## How to export all boards at once
|
||||
|
||||
1. In WeKan, go to **All Boards**, open the sidebar and choose **Export all
|
||||
boards**, then **Mail (mbox)**.
|
||||
2. One `.zip` downloads, with one `.mbox` file per board you can export.
|
||||
|
||||
From a script:
|
||||
|
||||
```bash
|
||||
python3 api.py exportallboards mbox boards.zip
|
||||
```
|
||||
|
||||
## Format details
|
||||
|
||||
- **mbox**: messages separated by a `From ` line; a body line starting `From `
|
||||
is escaped as `>From ` (mboxrd) and unescaped when read
|
||||
(`models/lib/mboxSplit.js`).
|
||||
- **MIME** is decoded on the server with mailparser
|
||||
(`server/lib/mailImport.js`): encoded words, quoted-printable, base64,
|
||||
multipart. An HTML-only message is read as its text with htmlparser2;
|
||||
scripts and styles are dropped and no markup is kept.
|
||||
- **Threads** join by `Message-ID`, `In-Reply-To` and `References`
|
||||
(`models/lib/mailFormat.js`). The first message is the card, the later ones
|
||||
its comments, oldest first.
|
||||
- **Gmail labels** (`X-Gmail-Labels`) become labels; Inbox, Unread, Opened,
|
||||
Important, Starred, Sent, Spam, Trash and the categories are mail state, not
|
||||
labels. A conversation labelled **Sent** is outgoing mail, in the Email view's
|
||||
Sent folder.
|
||||
|
||||
## What is kept
|
||||
|
||||
Subject, text, sender, To and Cc, date (the received date), Message-IDs of the thread (so a later reply sent to the board joins it), Gmail labels, replies as comments by their sender.
|
||||
|
||||
## What is not kept
|
||||
|
||||
Attachments (counted in the loss report), Bcc, HTML formatting, and mail headers other than the ones above. At most 20,000 messages are read from one file. What was left out is listed in the import's loss report, also in
|
||||
**Admin Panel → Problems → Recovery**.
|
||||
|
||||
## REST API
|
||||
|
||||
- Import: `POST /api/boards/import/mail` with the file's text, or a
|
||||
`.zip` as `{ "zipBase64": "..." }`, as for every source of the import page.
|
||||
- Export: `GET /api/boards/:boardId/export/mbox`.
|
||||
|
||||
## How it is built and tested
|
||||
|
||||
`tests/mailFormat.test.cjs` decodes an mbox with a thread, an encoded subject, Gmail labels and an HTML-only message with mailparser, checks that a malformed sender or a header injection does not become mail, sends the result through the import sanitizer, and exports a board to `.mbox` and reads it back.
|
||||
|
||||
## Sources
|
||||
|
||||
- [RFC 4155 - the application/mbox media type](https://www.rfc-editor.org/rfc/rfc4155)
|
||||
- [RFC 5322 - Internet Message Format](https://www.rfc-editor.org/rfc/rfc5322)
|
||||
- [mailparser](https://nodemailer.com/extras/mailparser/)
|
||||
@@ -95,8 +95,14 @@ What the current code does (`parseMarkdownKanban` in
|
||||
list called "Imported".
|
||||
- A line starting with `- ` or `* `, with or without `[ ]`, `[x]` or `[X]`,
|
||||
is a card. `[x]` adds the label `done`.
|
||||
- A line that starts with white space, under a card, is added to that card's
|
||||
description. Indented bullets therefore also become description lines.
|
||||
- On a card line, `#tag` words are labels (a word that starts with a letter,
|
||||
so `#1234` and `C#` stay in the title), and `@{2026-12-24}` with an optional
|
||||
`@@{14:30}` (Obsidian Kanban), `📅 2026-12-24` (Obsidian Tasks) or
|
||||
`due:2026-12-24` (todo.txt) is the due date. A due day that is no date is
|
||||
reported.
|
||||
- An indented `- [ ]` / `- [x]` line under a card is an item of its checklist.
|
||||
Any other line that starts with white space is added to the card's
|
||||
description; `\- [ ]` there is a description line, not an item.
|
||||
- Other headings (`#`, `###` and deeper, or a second `#` line) are skipped.
|
||||
Any other non-blank line is reported.
|
||||
- Every card goes to the swimlane Default.
|
||||
@@ -108,8 +114,12 @@ What the export writes (`formatMarkdownKanban` in
|
||||
lists without cards are left out.
|
||||
- Each card as `- [ ] <title>`, or `- [x] <title>` when its list's name looks
|
||||
finished: it contains "done", "closed", "complete", "archiv" or
|
||||
"finished" (case does not matter).
|
||||
- Each non-blank line of the description, indented two spaces.
|
||||
"finished" (case does not matter); then its labels as `#tags` (a space
|
||||
written as `-`) and its due date as `@{day}`, with `@@{time}` when it has
|
||||
one.
|
||||
- Each non-blank line of the description, indented two spaces, a line that
|
||||
looks like a checklist item escaped as `\- [ ]`.
|
||||
- Each checklist item as an indented `- [ ]` / `- [x]` line.
|
||||
- Archived cards and archived lists are not exported.
|
||||
|
||||
## What is kept
|
||||
@@ -121,6 +131,9 @@ What the export writes (`formatMarkdownKanban` in
|
||||
| `- [ ] Item`, `- Item`, `* Item` | Card |
|
||||
| `- [x] Item` | Card with the label `done` |
|
||||
| Indented lines under an item | Card description |
|
||||
| `#tag` on an item | Label |
|
||||
| `@{day}` `@@{time}`, `📅 day`, `due:day` | Due date |
|
||||
| Indented `- [ ]` / `- [x]` under an item | Checklist item |
|
||||
|
||||
## What is not kept
|
||||
|
||||
@@ -129,10 +142,12 @@ heading, a card or an indented line under a card (for example a numbered list
|
||||
item, or text before the first card). Headings other than the first `#` line
|
||||
and the `##` lines are skipped.
|
||||
|
||||
The Markdown export writes only lists, card titles and descriptions. It does
|
||||
not write swimlanes, labels (including `done`; the checkbox comes from the
|
||||
list name), dates, members, comments, checklists, custom fields,
|
||||
attachments, blank lines inside a description, or lists without cards.
|
||||
The Markdown export writes lists, card titles, descriptions, labels, the due
|
||||
date and checklist items. It does not write swimlanes, the `done` label (the
|
||||
checkbox comes from the list name), a label that does not start with a
|
||||
letter, other dates, members, comments, custom fields, attachments, blank
|
||||
lines inside a description, or lists without cards. A card's checklists come
|
||||
back as one checklist.
|
||||
|
||||
## REST API
|
||||
|
||||
|
||||
@@ -0,0 +1,104 @@
|
||||
# Mattermost
|
||||
|
||||
WeKan imports a Mattermost bulk export as a board for **Board View →
|
||||
Chat**, and exports a board as a bulk import file Mattermost reads. A channel
|
||||
is a card and its posts are the card's comments.
|
||||
|
||||
## How to import
|
||||
|
||||
1. On the Mattermost server, run `mmctl export create`, then
|
||||
`mmctl export download` and take the `.jsonl` file from the zip.
|
||||
2. In WeKan, go to **All Boards → New → Import → Mattermost**.
|
||||
3. Choose the `.jsonl` file, or paste its text.
|
||||
4. Map the users to WeKan members, or leave them as they are.
|
||||
5. Click **Import**.
|
||||
|
||||
## How to import many boards at once
|
||||
|
||||
1. On the import page, choose **Mattermost**, then under **Import many boards**
|
||||
choose several files, or one `.zip` that holds them.
|
||||
2. Each file becomes its own board. The boards are imported without member
|
||||
mapping; members can be mapped later.
|
||||
|
||||
Mattermost is imported through the generalized importer
|
||||
(`models/kanboardCreator.js`), so the page also has the checkbox **One board
|
||||
per project**: each swimlane the import would create becomes its own board.
|
||||
|
||||
From a script:
|
||||
|
||||
```bash
|
||||
python3 api.py importboardsfrom mattermost FILE_OR_DIR ...
|
||||
```
|
||||
|
||||
## How to export
|
||||
|
||||
1. Open the board, then **Board Settings → Export**, and choose **Mattermost**.
|
||||
The board downloads as `<board>.jsonl`.
|
||||
2. Zip it and import it on the Mattermost server with `mmctl import upload`
|
||||
and `mmctl import process`.
|
||||
|
||||
The file has one team named after the board, a public channel per card (its
|
||||
list as the purpose), the card's description and comments as posts, and a user
|
||||
per author with the address `<username>@wekan.invalid`, so the import never
|
||||
joins them to existing accounts by e-mail.
|
||||
|
||||
## How to export all boards at once
|
||||
|
||||
1. In WeKan, go to **All Boards**, open the sidebar and choose **Export all
|
||||
boards**, then **Mattermost**.
|
||||
2. One `.zip` downloads, with one `.jsonl` file per board you can export.
|
||||
|
||||
From a script:
|
||||
|
||||
```bash
|
||||
python3 api.py exportallboards mattermost boards.zip
|
||||
```
|
||||
|
||||
## Format details
|
||||
|
||||
Bulk export JSONL: a `version` line, then `team`, `channel`, `user`, `post`
|
||||
and `direct_channel` / `direct_post` lines; a post carries its `replies`
|
||||
(`models/lib/chatExportFormats.js`). Teams become swimlanes, public channels
|
||||
the list **Channels**, private ones **Groups**, direct messages **Direct
|
||||
messages**; a reply starts with `↳`.
|
||||
|
||||
## What is kept
|
||||
|
||||
Channels with header and purpose, posts and replies with author and time, teams.
|
||||
|
||||
## Replies
|
||||
|
||||
A reply, found by the post it is nested in, is a reply to the comment of the message it answers,
|
||||
one level deep as WeKan's replies are: a reply to a reply goes under the same
|
||||
comment. A reply to a message that is not in the file is a comment of its own,
|
||||
starting with "↳".
|
||||
|
||||
## Reactions
|
||||
|
||||
A message's reactions become the comment's reactions, read from Mattermost's `emoji_name`, such as `+1` or `tada`.
|
||||
WeKan keeps a reaction by who reacted, so a reaction is kept for each person
|
||||
mapped to a WeKan user in the members step. The loss report counts the
|
||||
reactions of people who were not mapped, and those with an emoji WeKan cannot
|
||||
store: a shortcode WeKan does not know, a server's or a chat's own emoji, or an
|
||||
emoji of several code points (a skin tone, a flag). See
|
||||
`models/lib/importedReactions.js`.
|
||||
|
||||
## What is not kept
|
||||
|
||||
Attachments (counted), custom emoji, users' profiles and preferences. What was left out is listed in the import's loss report, also in
|
||||
**Admin Panel → Problems → Recovery**.
|
||||
|
||||
## REST API
|
||||
|
||||
- Import: `POST /api/boards/import/mattermost` with the file's text, or a
|
||||
`.zip` as `{ "zipBase64": "..." }`, as for every source of the import page.
|
||||
- Export: `GET /api/boards/:boardId/export/mattermost`.
|
||||
|
||||
## How it is built and tested
|
||||
|
||||
`tests/chatExportFormats.test.cjs` reads a bulk export with a team, a channel, a reply and a direct post, refuses a file without a version line and a line that is not JSON, and exports a board and reads it back.
|
||||
|
||||
## Sources
|
||||
|
||||
- [Mattermost bulk export](https://docs.mattermost.com/manage/bulk-export-tool.html)
|
||||
- [Mattermost bulk loading data](https://docs.mattermost.com/onboard/bulk-loading-data.html)
|
||||
+4
-1
@@ -89,7 +89,10 @@ writes:
|
||||
|
||||
Columns are matched by name. The layout follows a real export: the test data
|
||||
of the [plannr](https://github.com/program--/plannr) package, copied to
|
||||
`tests/fixtures/planner/`.
|
||||
`tests/fixtures/planner/`. The newer Planner's **Export as Excel** is described by
|
||||
Microsoft's [Export a plan to Excel](https://support.microsoft.com/en-us/planner/export-a-plan-to-excel)
|
||||
with Status, Task title and Assignments; those names are read as Progress,
|
||||
Task Name and Assigned To.
|
||||
|
||||
What the import covers:
|
||||
|
||||
|
||||
+5
-3
@@ -100,7 +100,8 @@ What the current code does (`parseNextcloudDeck` in
|
||||
mark a card done with a timestamp). Either form, a date or Deck's REST API's
|
||||
plain `true`, marks the card's due date done. A card without a due date has
|
||||
no due date to mark, so `true` alone is not kept for it.
|
||||
- Label colors are not read: labels are created black.
|
||||
- A label keeps its color (Deck's hex `color`, such as `0082c9`); a label
|
||||
without one is created black.
|
||||
|
||||
## What is kept
|
||||
|
||||
@@ -116,12 +117,13 @@ What the current code does (`parseNextcloudDeck` in
|
||||
| `archived: true` | Archived card |
|
||||
| `assignedUsers` | Card members, when mapped |
|
||||
| `owner` | Requested by |
|
||||
| `labels` (title) | Board labels |
|
||||
| `labels` (`title`, `color`) | Board labels, with their colors |
|
||||
| `comments` (`message`, `actorId`, `creationDateTime`) | Comments |
|
||||
|
||||
The export writes the board `title` and a stack per list, in order. Each card
|
||||
has `title`, `description`, `duedate`, the labels as `{ title }`, `createdAt`,
|
||||
the end date as `done`, the owner and further people as `assignedUsers`, the
|
||||
the end date as `done` (or `done: true` for a due date ticked done without an
|
||||
end date), the owner and further people as `assignedUsers`, the
|
||||
creator as `owner` and the comments.
|
||||
|
||||
## Attachment files
|
||||
|
||||
@@ -118,7 +118,9 @@ them:
|
||||
and a range `A → B`. WeKan also reads `YYYY-MM-DD`, `MM/DD/YYYY` and a
|
||||
`(GMT+3)` style zone at the end. A time without a zone is taken as UTC.
|
||||
- Checkboxes are `Yes` and `No`.
|
||||
- Relations are the related page's title and its encoded path or URL.
|
||||
- Relations are the related page's title and its encoded path or URL. A
|
||||
related page that is one row of the export, in any of its databases, is a
|
||||
"related to" dependency between the two cards.
|
||||
- A row's page file starts with `# Title`, a blank line, one
|
||||
`Property: value` line per non-empty property, a blank line, then the page
|
||||
body.
|
||||
@@ -262,7 +264,8 @@ The export writes, per card:
|
||||
The import reports these on the loss report, rather than dropping them
|
||||
silently:
|
||||
|
||||
- relation columns (links to other pages);
|
||||
- a relation to a page that is not a row of the export, or to a title that
|
||||
two rows share (it is not guessed which one);
|
||||
- a **Last edited time** column;
|
||||
- date columns after the ones above; they are kept as text fields, and the
|
||||
report says which column was the due date;
|
||||
|
||||
@@ -97,7 +97,12 @@ What the import must cover:
|
||||
- deeper outlines become checklists, with their descendants as items
|
||||
(completed = finished);
|
||||
- the head title becomes the board title;
|
||||
- a list's note and `url` / `htmlUrl` / `xmlUrl` links are reported.
|
||||
- on a card, OPML 2.0's `created` becomes the creation date and `category`
|
||||
the labels, a `url` / `htmlUrl` / `xmlUrl` link goes at the end of the
|
||||
description, and any other attribute (OmniOutliner writes its columns this
|
||||
way) becomes a custom field;
|
||||
- a list's note, and an attribute of a list or a checklist item, are
|
||||
reported.
|
||||
|
||||
The export writes the same, with Workflowy's attribute names. Line breaks in
|
||||
notes survive as ` `. The file is parsed on the server only, and DTDs and
|
||||
@@ -122,9 +127,10 @@ What the export writes (`models/lib/opmlOutlineFormat.js`):
|
||||
- `<opml version="2.0">` with the board title in `<head><title>`;
|
||||
- each list as a top-level `<outline text="…">`, including lists without
|
||||
cards;
|
||||
- each card as a child outline, with its description as `_note` and
|
||||
- each card as a child outline, with its description as `_note`,
|
||||
`_complete="true"` when its list's name looks finished (contains "done",
|
||||
"closed", "complete", "archiv" or "finished");
|
||||
"closed", "complete", "archiv" or "finished"), its creation date as
|
||||
`created` (RFC 822) and its labels as `category`;
|
||||
- each checklist as a child of the card, with its items as children,
|
||||
`_complete="true"` when finished.
|
||||
|
||||
@@ -140,6 +146,10 @@ reader gives them back. Archived cards and archived lists are not exported.
|
||||
| Level 2 outline: `text` (or `title`) | Card title |
|
||||
| Level 2 outline: `_note` | Card description |
|
||||
| Level 2 outline: `_complete` / `complete` = true | Card with the label `done` |
|
||||
| Level 2 outline: `created` | Creation date |
|
||||
| Level 2 outline: `category` (comma-separated, leading `/` taken off) | Labels |
|
||||
| Level 2 outline: `url`, `htmlUrl`, `xmlUrl` | A link at the end of the description |
|
||||
| Level 2 outline: any other attribute | Custom field of that name (a leading `_` taken off) |
|
||||
| Level 3 outline with children | Checklist, its descendants the items |
|
||||
| Level 3 outline without children | Item of a checklist named after the card |
|
||||
| Completed item | Finished checklist item |
|
||||
@@ -149,14 +159,17 @@ reader gives them back. Archived cards and archived lists are not exported.
|
||||
The import reports these on the loss report:
|
||||
|
||||
- a `_note` on a top-level (list) outline;
|
||||
- `url`, `htmlUrl` and `xmlUrl` attributes, on any outline;
|
||||
- an attribute of a list or a checklist item other than its text and
|
||||
complete state;
|
||||
- a `created` that is not a date;
|
||||
- outlines deeper than 64 levels.
|
||||
|
||||
Other attributes, such as `created`, are not read.
|
||||
`type`, `isComment` and `isBreakpoint` only say how an outliner draws a row,
|
||||
and are not read.
|
||||
|
||||
The OPML export writes only lists, cards, notes, the complete state and
|
||||
checklists. It does not write swimlanes, labels, dates, members, comments,
|
||||
custom fields or attachments.
|
||||
The OPML export writes lists, cards, notes, the complete state, the creation
|
||||
date, labels and checklists. It does not write swimlanes, other dates,
|
||||
members, comments, custom fields or attachments.
|
||||
|
||||
## REST API
|
||||
|
||||
|
||||
@@ -133,9 +133,11 @@ What the current code does (`parseOpenProject` in
|
||||
(`_embedded.schemas`, or a work package's `_embedded.schema`); without a
|
||||
schema the field keeps the name `customFieldN`. Values are read from the
|
||||
work package (`raw` for formatted text) and from `_links` (the title).
|
||||
- `estimatedTime` (ISO 8601 duration) becomes the custom field **Estimated
|
||||
time (hours)**, and `percentageDone` the custom field **Progress (%)**.
|
||||
`spentTime` becomes the card's spent hours.
|
||||
- `estimatedTime` and `remainingTime` (ISO 8601 durations) become the custom
|
||||
fields **Estimated time (hours)** and **Remaining time (hours)**, and
|
||||
`percentageDone` the custom field **Progress (%)**. `spentTime` becomes the
|
||||
card's spent hours, and the export writes a card's spent hours back as
|
||||
`spentTime` (`PT1.5H`).
|
||||
- Relations embedded on a work package are kept from their `from` side:
|
||||
`blocks`, `blocked` (is blocked by), `duplicates`, `duplicated`; any other
|
||||
type is kept as related-to.
|
||||
@@ -161,7 +163,7 @@ What the current code does (`parseOpenProject` in
|
||||
| Embedded `relations` | Dependencies |
|
||||
| Embedded `watchers` | Card watchers, when mapped to a board member |
|
||||
| Type, priority, category, version | Labels |
|
||||
| `customFieldN`, `estimatedTime`, `percentageDone` | Custom fields |
|
||||
| `customFieldN`, `estimatedTime`, `remainingTime`, `percentageDone` | Custom fields |
|
||||
| `storyPoints` | Number field **Story points**, the Scrum estimate |
|
||||
| `version`, `sprint`, `position` | Scrum release, sprint, backlog rank |
|
||||
| Embedded comment activities | Comments |
|
||||
|
||||
@@ -3,8 +3,9 @@
|
||||
WeKan imports and exports a board as an [Org mode](https://orgmode.org/manual/)
|
||||
outline: the `.org` text file that Emacs, Orgzly, Beorg and organice write.
|
||||
Top-level headings are lists and second-level headings are cards. TODO
|
||||
keywords, priorities, tags, SCHEDULED, DEADLINE and CLOSED dates, the
|
||||
`:CREATED:` property, body text and checkboxes are kept.
|
||||
keywords, priorities, tags, SCHEDULED, DEADLINE and CLOSED dates and their
|
||||
daily, weekly or monthly repeaters, properties, clocked time, body text and
|
||||
checkboxes are kept.
|
||||
|
||||
## How to import
|
||||
|
||||
@@ -86,16 +87,21 @@ What the import must cover:
|
||||
keyword as the `done` label);
|
||||
- priorities become `priority:A` labels, and tags become labels;
|
||||
- SCHEDULED / DEADLINE / CLOSED become the start, due and end dates;
|
||||
- `:CREATED:` becomes the creation date;
|
||||
- `:CREATED:` becomes the creation date, `:ID:` (or `:CUSTOM_ID:`) the card's
|
||||
source reference, and every other property a custom field of that name;
|
||||
- the closed `CLOCK:` lines of the `:LOGBOOK:` drawer add up to the spent
|
||||
time;
|
||||
- a `+1d`, `+1w` or `+1m` repeater (also `++` and `.+`) makes the card repeat
|
||||
daily, weekly or monthly;
|
||||
- body text becomes the description;
|
||||
- checkboxes and level-3 headings without children become the card's
|
||||
checklist, and level-3 headings with children become checklists of their
|
||||
own;
|
||||
- `#+TITLE` becomes the board title.
|
||||
|
||||
Timestamps have no zone in Org, and are read and written as UTC. Repeaters
|
||||
and warning delays, text under a list heading and text before the first
|
||||
heading are reported. Comments have no place in Org and are not exported.
|
||||
Timestamps have no zone in Org, and are read and written as UTC. Other
|
||||
repeaters and warning delays, other drawers, open clocks, text under a list
|
||||
heading and text before the first heading are reported. Comments have no place in Org and are not exported.
|
||||
|
||||
What the current code does (`models/lib/orgModeFormat.js`):
|
||||
|
||||
@@ -107,8 +113,10 @@ What the current code does (`models/lib/orgModeFormat.js`):
|
||||
- A planning line (SCHEDULED, DEADLINE, CLOSED) is read when it comes before
|
||||
the body text. A timestamp may be active `<…>` or inactive `[…]`, with or
|
||||
without a time.
|
||||
- Of the property drawer, only `:CREATED:` is read. Other drawers (such as
|
||||
`:LOGBOOK:`) are skipped.
|
||||
- The property drawer is read whole: `:CREATED:`, `:ID:` / `:CUSTOM_ID:`, and
|
||||
every other property as a custom field (a `:NAME+:` line appends to it). The
|
||||
`:LOGBOOK:` drawer gives the spent time; its state-change notes are history
|
||||
and are not kept. Any other drawer is reported.
|
||||
- `- [ ]`, `+ [ ]` and numbered checkbox lines in the body become the first
|
||||
checklist, named after the card, together with level-3 headings that have
|
||||
no children. A level-3 heading with children is a checklist named after it,
|
||||
@@ -129,7 +137,9 @@ What the export writes (`formatOrgMode` in the same module):
|
||||
Org does not allow in a tag become `_`);
|
||||
- `SCHEDULED:` (start date), `DEADLINE:` (due date) and, for a done card,
|
||||
`CLOSED:` (end date);
|
||||
- the creation date as `:CREATED:` in a property drawer;
|
||||
- the creation date as `:CREATED:` and the custom fields as properties in a
|
||||
property drawer (a space in a field name is written as `_`);
|
||||
- a repeating card's repeater on its DEADLINE (`+1d`, `+1w`, `+1m`);
|
||||
- the description, indented three spaces;
|
||||
- each checklist as `*** <checklist>` with `**** TODO` / `**** DONE` items.
|
||||
|
||||
@@ -149,6 +159,10 @@ Archived cards and archived lists are not exported.
|
||||
| DEADLINE | Due date |
|
||||
| CLOSED | End date |
|
||||
| `:CREATED:` property | Creation date |
|
||||
| `:ID:` / `:CUSTOM_ID:` property | Source reference |
|
||||
| Any other property | Custom field |
|
||||
| `CLOCK:` lines in `:LOGBOOK:` | Spent time |
|
||||
| `+1d` / `+1w` / `+1m` repeater | Daily / weekly / monthly recurrence |
|
||||
| Body text | Card description |
|
||||
| `- [ ]` / `- [X]` checkboxes, level-3 headings without children | Checklist named after the card |
|
||||
| Level-3 heading with children | Checklist, its descendants the items |
|
||||
@@ -159,14 +173,14 @@ The import reports these on the loss report:
|
||||
|
||||
- text before the first heading (other than `#+` lines);
|
||||
- text under a level-1 (list) heading;
|
||||
- a repeater (`+1w`) or warning delay (`-2d`) on a planning timestamp: the
|
||||
date is kept, the repeat is not;
|
||||
- a SCHEDULED, DEADLINE or CLOSED value that is not a date.
|
||||
- a repeater other than every 1 day, week or month (`+2w`), or a warning
|
||||
delay (`-2d`): the date is kept, the repeat is not;
|
||||
- a SCHEDULED, DEADLINE or CLOSED value that is not a date, and a `:CREATED:`
|
||||
that is not one;
|
||||
- a property line that is not `:NAME: value`, an open clock (no end), and any
|
||||
drawer other than PROPERTIES and LOGBOOK.
|
||||
|
||||
Properties other than `:CREATED:` and other drawers are skipped without a
|
||||
report.
|
||||
|
||||
The Org mode export does not write swimlanes, members, comments, custom fields
|
||||
The Org mode export does not write swimlanes, members, comments, spent time
|
||||
or attachments.
|
||||
|
||||
## REST API
|
||||
|
||||
@@ -89,6 +89,8 @@ Limit: 20,000 cards. Every card goes to the swimlane Default.
|
||||
| Planka | WeKan |
|
||||
| --- | --- |
|
||||
| Board `name` | Board title |
|
||||
| v2 `customFieldValues` (`content`), named by `customFields` and `customFieldGroups` | Custom fields of the field's name (`Group: Field` when two groups have a field of that name) |
|
||||
| Card `stopwatch.total` (seconds) | Spent time (hours) |
|
||||
| Lists (`active`, `closed`) | Lists, in order |
|
||||
| Card `name` | Card title |
|
||||
| `description` | Card description |
|
||||
@@ -108,8 +110,7 @@ The import reports these on the loss report:
|
||||
|
||||
- cards in the Planka trash;
|
||||
- attachments: they are files on the Planka server;
|
||||
- custom field values;
|
||||
- the stopwatch time;
|
||||
- a custom field value of a field the export does not name;
|
||||
- a due date that is not a date;
|
||||
- a second list with the same name (it is imported as `<name> (2)`);
|
||||
- a card whose list is not on the board;
|
||||
|
||||
Loaded 100 of 619 files, more files were not shown because too many files have changed in this diff.
Show more
Reference in new issue
Block a user