--- language: "en" --- # Gauge Gadget for Jira Cloud This documentation is for Cloud only. Click [here](https://docs.akeles.com/gauge.md) for the Server documentation. Gauge Gadget for Jira Cloud is a great way to visualise issues in your Jira filters. The 3 styles to choose from are: * Counter Gadget * Horseshoe Gadget * Liquid Gauge ## Key Features ### Data Visualisation Visualise data with horseshoe, liquid gauge or counter. ![GAUGEC gadgets.png](https://docs.akeles.com/__attachments/a_4e6cc3e0334d344163b5c1764c4b2721cdc9857827d1d9a56fe2ed63967f34bc/GAUGEC%20gadgets.png?cb=e60a7a3cf1a7ea300c2db29f27f8a677) ### Zoom in to filter By using the provided filter link at the bottom, users can quickly zoom to see the relevant issues. ![Gauge link.png](https://docs.akeles.com/__attachments/a_9ce3774a389fe8a99d110bcfe398e1cab1116a1ee40b0f37fd26e43957ccd338/Gauge%20link.png?cb=6a6386249f7684b5d1237337a0c2acd0) ### Various customisation options * Setting minimum or maximum values * Color option This allows users to tell at one glance if the number of issues has exceeded, or is going to reach the given threshold. ![Gauge colors.png](https://docs.akeles.com/__attachments/a_3170bcd759ad683bab0539ff5cee4778e16d60d08956113c85cdf81f1f9522a5/Gauge%20colors.png?cb=28560b3c84ce62c7c4cc8f5c2fc1eecf) --- language: "en" --- # Release Notes * [Release Notes for 1.8.9](https://docs.akeles.com/gaugec/release-notes/release-notes-for-1-8-9.md) * [Release Notes for 1.8.10](https://docs.akeles.com/gaugec/release-notes/release-notes-for-1-8-10.md) * [Release Notes for 1.8.11](https://docs.akeles.com/gaugec/release-notes/release-notes-for-1-8-11.md) * [Release Notes for 1.8.16](https://docs.akeles.com/gaugec/release-notes/release-notes-for-1-8-16.md) * [Release Notes for 1.8.18](https://docs.akeles.com/gaugec/release-notes/release-notes-for-1-8-18.md) * [Release Notes for 1.8.19](https://docs.akeles.com/gaugec/release-notes/release-notes-for-1-8-19.md) * [Release Notes for 1.8.20](https://docs.akeles.com/gaugec/release-notes/release-notes-for-1-8-20.md) * [Release Notes for 1.8.22](https://docs.akeles.com/gaugec/release-notes/release-notes-for-1-8-22.md) * [Release Notes for 1.8.23](https://docs.akeles.com/gaugec/release-notes/release-notes-for-1-8-23.md) * [Release Notes for 1.8.24](https://docs.akeles.com/gaugec/release-notes/release-notes-for-1-8-24.md) * [Release Notes for 1.8.25](https://docs.akeles.com/gaugec/release-notes/release-notes-for-1-8-25.md) * [Release Notes for 1.8.26](https://docs.akeles.com/gaugec/release-notes/release-notes-for-1-8-26.md) * [Release Notes for 2.0.0](https://docs.akeles.com/gaugec/release-notes/release-notes-for-2-0-0.md) * [Release Notes for 2.2.0](https://docs.akeles.com/gaugec/release-notes/release-notes-for-2-2-0.md) * [Release Notes for 2.3.0](https://docs.akeles.com/gaugec/release-notes/release-notes-for-2-3-0.md) * [Release Notes for 2.4.0](https://docs.akeles.com/gaugec/release-notes/release-notes-for-2-4-0.md) * [Release Notes for 2.5.0](https://docs.akeles.com/gaugec/release-notes/release-notes-for-2-5-0.md) --- language: "en" --- # Release Notes for 1.8.10 ## Summary *** ** * ** *** ## Improvement ### Allow all filters You can now select any filters instead of just favourite filters as long as you have the permission. ![gaugec filters.png](https://docs.akeles.com/__attachments/a_bdd14d8aacc1b90078000fb6cfa66bc3ddc9e85aa59fce4355bd8de8f4ce942f/gaugec%20filters.png?cb=c14a358f154a7ddc494ba6b94cd91fab) --- language: "en" --- # Release Notes for 1.8.11 ## Bug Fix ### Unable to select filter for newly added gadgets You should now be able to search and select filters for existing and newly added gadgets. ![gaugec search filter.png](https://docs.akeles.com/__attachments/a_7eb23f2042d5b2932f7114b1858b3f949be710c484418465627f66390e2ab0ec/gaugec%20search%20filter.png?cb=84aae1d2238dbfb6ffccfeb23cf59250) --- language: "en" --- # Release Notes for 1.8.16 ## Summary *** ** * ** *** ## New Features ### Configurable colors for % values Added **Color Limit (%)** configuration where users can specify the limit for color change. For example, if the color is "Green to Red" and limit is "60,80", the gadget will be Green for 0% to 60%, and Red for 80% to 100% and Yellow in between. For **Horseshoe Gadget** , this is available only if meter type is **Horseshoe**. For **Counter Gadget** and **Liquid Gauge Gadget** , this is available only if color is **Green to Red** or **Red to Green**. ![GAUGEC Color Limit.png](https://docs.akeles.com/__attachments/a_da12a2b0489290b9bf7524f657cf68c1160c95ff20af2aaac20c43260d02a277/GAUGEC%20Color%20Limit.png?cb=2fd207b42d081ea3d89f8bb0bd2155f4) ![color limit example.png](https://docs.akeles.com/__attachments/a_2fff45066126dda5642ca37553051a813630c0f290964c82bd3b3b796dba0f74/color%20limit%20example.png?cb=e69e4ec44cae31cfb8e88ea9c916bb2b) ![:note:](https://docs.akeles.com/__attachments/a_8db73106c5cd0d4ef4cd9d9f19c9be065f9f00153b9d15685ea0ccaff90ac168/atlassian-note?cb=8b18e78f950443e7558a7b2e796bfe1c) Refer to [How to set Color Change Limit for Counters](https://docs.akeles.com/mchartc/how-to-articles/how-to-set-color-change-limit-for-counters.md) for more info. ### Option to hide filter link Added **Hide Filter Link** configuration for all gadgets with options: * Yes -- No links provided ![GAUGEC No Filter Link.png](https://docs.akeles.com/__attachments/a_6c7b6e8a63a57740712424efcb2fb75332b093c160525cc4f36cad64ca7cdf12/GAUGEC%20No%20Filter%20Link.png?cb=c495d71dfaa0387fe6230e90e4dc76b7) * No (display filter link) -- Users can click on the filter link at the bottom to view the issues at the Issue Navigator ![GAUGEC Display Filter Link.png](https://docs.akeles.com/__attachments/a_e5763f0a3f3d2a883bacdba1e9b79b9ec4275ff02a57a4cb8e724d10b0503482/GAUGEC%20Display%20Filter%20Link.png?cb=ffd9ece2ba2ce7dd36615cdf0f26050c) * No (link on Gadget) -- Users can click on the gauge to view the issues at the Issue Navigator ![GAUGEC Display Link on Gadget.png](https://docs.akeles.com/__attachments/a_a6c01cac51acb802eccfcc71e44f1af72112c0c7281e13bd9463e860f191eb7d/GAUGEC%20Display%20Link%20on%20Gadget.png?cb=9694aeef098451eba08b6d8edce28007) *** ** * ** *** ## Issues | Key | Summary | T | Created | Updated | Due | Assignee | Reporter | P | Status | Resolution | |-----|---------|---|---------|---------|-----|----------|----------|---|--------|------------| | Data cannot be retrieved due to an unexpected error. [View these issues in Jira](https://akeles.jira.com/issues/?jql=project+%3D+gaugec+and+fixVersion+%3D+1.13.0-AC+++&src=confmacro) ||||||||||| --- language: "en" --- # Release Notes for 1.8.18 ## Summary *** ** * ** *** ## New Features ### Configurable text size for Counter Gadget Added **Text Size** configuration where users can select: * Auto-adjust (default) * Small * Medium * Large ![gauge text size.png](https://docs.akeles.com/__attachments/a_2da44c6efa1771023664112f90f3dded0ee8d0556f73d3e6384f23ed8c7f2454/gauge%20text%20size.png?cb=9beab36522a574e40d5b7033a061aab6) ### Dark mode supported Similar color theme when user is in dark mode | | **Dashboard** | **Wallboard** | |-----------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | Counter Gauge | ![counter dashboard dark.png](https://docs.akeles.com/__attachments/a_8515e2cdc6423372a3597f9d277216179148cd8ed11fdbce5b5f75e94c06c8f2/counter%20dashboard%20dark.png?cb=934488d79adff314d9dfee1ccd14193f) | ![counter wallboard dark.png](https://docs.akeles.com/__attachments/a_9690c4bcdf3fce56247e8f029af3753d5757655f41a952fa36446b600272a65e/counter%20wallboard%20dark.png?cb=50d78137dc76f53525c2a746a552dcba) | | Liquid Gauge | ![liquid dashboard dark.png](https://docs.akeles.com/__attachments/a_b70c31b5d81418c91e9b0057c090458d27beddf50d21eca1528f8a3536870e46/liquid%20dashboard%20dark.png?cb=b74aced6f318df02160ea8bef42bab1c) | ![liquid wallboard dark.png](https://docs.akeles.com/__attachments/a_c634185565d08db2a2f8b5456a8b5e8617a98fd0c20029efe557fe00918979f6/liquid%20wallboard%20dark.png?cb=136422924429095950587a7e8e6846e5) | | Horseshoe Gauge | ![horseshoe dashboard dark.png](https://docs.akeles.com/__attachments/a_b88c294cd0b34c87ba64c086fbd1ae715e2b3bfe77dd686e6a27ef83985a77fa/horseshoe%20dashboard%20dark.png?cb=9d3512df2a1a50f79c44381a0f1f1584) | ![horseshoe wallboard dark.png](https://docs.akeles.com/__attachments/a_df950296089e5ebe9aaae501381aaed14f1df9cce0addac818a71cb059868622/horseshoe%20wallboard%20dark.png?cb=2c6ca052978608ef01d82458f3f17d83) | *** ** * ** *** ## Issues | Key | Summary | T | Status | Resolution | |-----|---------|---|--------|------------| | Data cannot be retrieved due to an unexpected error. [View these issues in Jira](https://akeles.jira.com/issues/?jql=key+in+%28GAUGEC-5%2CGAUGEC-4%29++&src=confmacro) ||||| --- language: "en" --- # Release Notes for 1.8.19 ## Summary *** ** * ** *** ## New Features ### To allow display of issue count or sum of selected custom field values | **Before** | **After** | |-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | Only Issue count is supported | You can also sum values from other numeric fields. E.g. Time spent | | ![CalculationIssueCount.png](https://docs.akeles.com/__attachments/a_e44e24f696a229e725f959b188db21ce98df7d6e14cd0c017eb1cb9dbfdc56c9/CalculationIssueCount.png?cb=c659545256e948098684d3bde269dbd5) | ![Calculation via Time Spent.png](https://docs.akeles.com/__attachments/a_5e92965251986b3b3abcc88c86c8715e89d4a878b7061a3139ac6093c25efe72/Calculation%20via%20Time%20Spent.png?cb=6073e4f673612e8a9464df9b276c14e0) | With a new preference "**Current Value**", you can select how the values are calculated | [**Counter Gauge**](https://docs.akeles.com/gaugec/user-guide/configuring-counter-gadget.md) | [**Liquid Gauge**](https://docs.akeles.com/gaugec/user-guide/configuring-liquid-gauge-gadget.md) | [**Horseshoe Gauge**](https://docs.akeles.com/gaugec/user-guide/configuring-horseshoe-gadget.md) | |-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | ![Counter Gauge Configuration.png](https://docs.akeles.com/__attachments/a_8ac309c537cb3e184f271a6cdae91257c53a64b3f49213be8e2fa520aa683fc6/Counter%20Gauge%20Configuration.png?cb=8f729b318555631f9a90de67cbd026cf) | ![Liquid Gauge Configuration.png](https://docs.akeles.com/__attachments/a_f4169be751e25c28d47263f9eb0e57766fa98919f987d3972ddbf4fbe1112ca7/Liquid%20Gauge%20Configuration.png?cb=c3819ba885dabd7fe485bd78bd6ca38d) | ![Horseshoe Gauge Configuration.png](https://docs.akeles.com/__attachments/a_a08353afe6e2da498bf4e2df7f1dd0f725679db97c5da92b7e84d902a751f70c/Horseshoe%20Gauge%20Configuration.png?cb=6152fc162c1f29f7d942bde8c8440c77) | *** ** * ** *** ## Issues | Key | Summary | T | Status | Resolution | |-----|---------|---|--------|------------| | Data cannot be retrieved due to an unexpected error. [View these issues in Jira](https://akeles.jira.com/issues/?jql=key+in+GAUGEC-3+&src=confmacro) ||||| --- language: "en" --- # Release Notes for 1.8.20 ## Bug Fix ### Unable to view more than 50 issues for "Issue Count" You should now be able to see the counter reflect the total issue count. | **Before** | **After** | |-------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------| | ![IssueCount Before.png](https://docs.akeles.com/__attachments/a_908a42a312e7fba0612fb04d67a1b5b135c39d0709bc985e220eadac984ab989/IssueCount%20Before.png?cb=581e4920208041dee3cc1a7738276618) | ![Counter Gadget.png](https://docs.akeles.com/__attachments/a_8e00068831a3f1940a0bd4c10094fb8070c69694e10fcc7a69b35cd6f8115a3c/Counter%20Gadget.png?cb=76189c5523bee6d228fd07fb2f8e605a) | --- language: "en" --- # Release Notes for 1.8.22 ## Summary *** ** * ** *** ## New Features ### Support JQL Input JQL is now supported and can be entered directly in the gadget instead of using saved filters. | **Before** | **After** | |-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | Only Saved Filters is supported | JQL can now be used to search for issues | | ![Counter_Gadget_Before.png](https://docs.akeles.com/__attachments/a_3316f21d148ef1a8bf0d466afbd44b7eac5ef939427459772f09893b92baac00/Counter_Gadget_Before.png?cb=3e6648c8c3672817905eba68ca8abb53) | ![Counter_Gadget_After.png](https://docs.akeles.com/__attachments/a_fc6cab4f2ccc5b4555ab7086fe36b0a3b52b1f1dca75163dfb80e5e752bc135c/Counter_Gadget_After.png?cb=27a17507b8ff4b3c35e56aaae67b5794) | With a new preference "**Issues**", you can select either Filter or JQL | [**Counter Gauge**](https://docs.akeles.com/gaugec/user-guide/configuring-counter-gadget.md) | [**Liquid Gauge**](https://docs.akeles.com/gaugec/user-guide/configuring-liquid-gauge-gadget.md) | [**Horseshoe Gauge**](https://docs.akeles.com/gaugec/user-guide/configuring-horseshoe-gadget.md) | |-------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | ![Counter_Gadget_JQL.png](https://docs.akeles.com/__attachments/a_2aa4ed64be8e1c5de95d7bd1c0d4fffc23d641fd3041892c59977e14ca75a4d6/Counter_Gadget_JQL.png?cb=141f08f00ae429f20342d59bb39fd060) | ![Liquid_Gadget_JQL.png](https://docs.akeles.com/__attachments/a_35086ea7cc7bb7a65252d372d78f16c96110a112c5bce3cbdda5d0cc3a26d650/Liquid_Gadget_JQL.png?cb=6174a9ab9705be0e9a8b7b1636b97534) | ![HorseShoe_Gadget_JQL.png](https://docs.akeles.com/__attachments/a_1b6dde0556ead288a657a61f1a8fd53ca116f4a6c343f7bda7bcb6c2f3281a11/HorseShoe_Gadget_JQL.png?cb=6e26373f7395949b2e94e1295d03a815) | *** ** * ** *** ## Issues | **S/N** | **Issue Type** | **Issue Key** | **Summary** | |---------|----------------|-----------------------------------------------------|----------------| | 1 | Improvement | [GAUGEC-7](https://akeles.jira.com/browse/GAUGEC-7) | To support JQL | --- language: "en" --- # Release Notes for 1.8.23 ## Vulnerability fix ### Upgraded libraries Upgraded jquery-ui from 1.31.1 to 1.31.3. * --- language: "en" --- # Release Notes for 1.8.24 ## New Feature ### [Aggregate Gadget](https://docs.akeles.com/gaugec/user-guide/configuring-aggregate-gadget.md) This is another alternative besides the [Counter Gadget](https://docs.akeles.com/gaugec/user-guide/configuring-counter-gadget.md) which can handle large values better and more flexible display formats. Possible use cases: * Counting total cost for the month * Calculating the total budget for the project * Summing the total cost savings from all the project enhancements #### More customizable settings * Display value can be formatted with delimiter for better readability for large values * 111,111,111 vs 111111111 * Text can be added before and after the aggregated values to support more scenarios * **US$**1,088,816.77 (prefix) * 3,645 **man hours** (suffix) * **Our top** 5 **voted requests** (both prefix and suffix) * Rounding off to 2 decimal places * Support auto refresh ![With Units and Format.png](https://docs.akeles.com/__attachments/a_abb3243e33dade18a146a17200a58f6d0f6c736b6ba7b5500180517d504ceaea/With%20Units%20and%20Format.png?cb=47eeda69ea7c5ffd95da85d34d6efc2f) You can use it together with other gadgets that require 1 column layout For more info, please check out the [Aggregation Gadget](https://docs.akeles.com/gaugec/user-guide/configuring-aggregate-gadget.md). ## Acknowledgements The **Aggregation Gadget** is inspired by the [Project Metrics for Jira](https://marketplace.atlassian.com/apps/1211289/project-metrics?hosting=server&tab=overview) app developed by **ACA IT-Solutions**. A customer raised a request to us to add this gadget due to the absence of a Cloud or Data Center edition for that app. After informing their team of our intentions, we commenced work on the gadget. We chose to retain the original name as a tribute to its creator. --- language: "en" --- # Release Notes for 1.8.25 ## Bug Fix ### Decimal points were showed for whole numbers | **Before** | **After** | |-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | ![AggregateGadgetBefore.png](https://docs.akeles.com/__attachments/a_5856a49672bd5c77f3cca2d178d5d4c40a55ebe029737c9b0933e6535384dd97/AggregateGadgetBefore.png?cb=65de86b180054164b96e317f73e0d094) | ![AggregateGadgetAfter.png](https://docs.akeles.com/__attachments/a_1f1ad3e1db3dde49b96ec625a72dfdcc65e03b204433be6ef2344cf59556e7f0/AggregateGadgetAfter.png?cb=bb43fec2f7377f7ecdb1b870c1694aba) | #### Unable to see difference in gadget height ![AggregateGadgetHeight.png](https://docs.akeles.com/__attachments/a_9310b29b15ad43667a9b83d262c7c2922c8cf3f7d489e2234f0fe05b34461d75/AggregateGadgetHeight.png?cb=3acc7b5aca6022c1b579874ef6c9990d) --- language: "en" --- # Release Notes for 1.8.26 ## Bug Fix ### Max filter link is not shown in gadget When displaying the filter link in the gadget, only the first link is shown. | **Before** | **After** | |---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | ![BeforeMaxFilterLinkFix.png](https://docs.akeles.com/__attachments/a_e3f2ce49c9f986fb2042ae122b42113c9395920a87c6077d4098b576516c0351/BeforeMaxFilterLinkFix.png?cb=da267dd129fe7c8b4e32c023d8a4eb1b) | ![AfterMaxFilterLinkFix.png](https://docs.akeles.com/__attachments/a_de218fac3351ac419fed844878fa45e573b67a71fdb67fcf8baf436a19a7b26d/AfterMaxFilterLinkFix.png?cb=97ff327261b0142e5e29b06821d591d5) | --- language: "en" --- # Release Notes for 1.8.9 ## Summary *** ** * ** *** ## Feature - Meter Type (Horseshoe Gadget) **Speedometer** Meter type has been added to horseshoe gadget (similar to server version). ![meter type.png](https://docs.akeles.com/__attachments/a_369bd612146f931fdbfca68d6ea6900348a747da14f5516ebff1f3c050ac7946/meter%20type.png?cb=060fce52b6cfe0e86d010d212e658fd1) --- language: "en" --- # Release Notes for 2.0.0 ## Benefit of Forge The app has been migrated from **Atlassian Connect Express (ACE)** to **Atlassian Forge**. * **Improved security** through Atlassian's built-in security, privacy, and compliance standards * **Optimized performance and scalability**, ensuring a more stable experience as usage grows * **Full alignment with Atlassian Cloud**, keeping the app compatible with Atlassian's future platform direction ## Actions Required ### Manual Update Required (by Jira Cloud Admins) Unlike previous releases, where updates were **automatically rolled out, major releases, including Forge modules, require Jira admins to trigger the update manually**. To update: 1. Navigate to **admin.atlassian.com** 2. Click on **Apps** and click on **Sites** to find your Cloud site ![AdminPage.png](https://docs.akeles.com/__attachments/a_77cc7c1acc54db5b8f868edd174b4e5a8a042011a7c9a2b9bb3b79dedf8acaa3/AdminPage.png?cb=28fc7447e1403837c094cf8f4cf9b033) 3. Click on your cloud site 4. Go to **Connected Apps** 5. Find **Gauge Gadget** ![image-20260708-033634.png](https://docs.akeles.com/__attachments/a_abf1a12c8cc03d3a9b07be45902dde16c244ba75dfc46681bda573b8c588ddf8/image-20260708-033634.png?cb=efd1c7d6bf57ebe4976767f5548fa2a3) 6. Click on **View app details** 7. Click **Update** ![image-20260708-083526.png](https://docs.akeles.com/__attachments/a_ddefa55250a48e7a5e6985a556dd16e7c670333686aea27cbf8439938faf8c11/image-20260708-083526.png?cb=1df611b23aea2062bed6dcfebb341637) For the detailed steps, please refer to [Upgrading the app to Atlassian Forge version](https://docs.akeles.com/gaugec/upgrading-the-app-to-atlassian-forge-version.md). *** ** * ** *** ### Configuration of gadgets The app functionality remains unchanged, with all settings preserved. **No action is required from users** ## Improvements While we were migrating to **Forge**, we have added refresh options for users and a progress bar to show the loading of gadget * Added a refresh option to all gadgets: * **Liquid Gauge** * **Horseshoe Gauge** * **Counter Gauge** * **Aggregate Gauge** | **Refresh Gadget Configuration** | ![Refresh_Interval.png](https://docs.akeles.com/__attachments/a_9b1fcb663117a4f5d7846653af2354c7f283783071d4bc0d629f101e8d8e6efe/Refresh_Interval.png?cb=7ed13c1840cfb9587e9ee32d927198c7) | |----------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------| * Progress bar to track fetching of work items | **Progress Bar** | ![Progress_Bar.png](https://docs.akeles.com/__attachments/a_da4188b988db2dd82cfeff722677d547827bd317037691cee8764c7e97cafd89/Progress_Bar.png?cb=cc6bff256701217e847c008d42e3ba38) | |------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------| --- language: "en" --- # Release Notes for 2.2.0 ## Bug Fix ### Unable to obtain all filters for gadget Gadgets will now load correctly for all available filters on your site. | **Before** | ![Missing Filter.png](https://docs.akeles.com/__attachments/a_7f9418dd43f694680b908acde13ebb708a034c751f793ace22d9300d28eda9f7/Missing%20Filter.png?cb=9b037911ec5d27d385124f8e03c6cca8) | | **After** | ![Filter Fixed.png](https://docs.akeles.com/__attachments/a_b06e1f7220311bdeb0f1bc5a04dcfe920d3fee64dc5cfa8f0af0726c148877e4/Filter%20Fixed.png?cb=79787cb4736e14ec23065873fa5ff3bb) | |------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------| --- language: "en" --- # Release Notes for 2.3.0 ## New Feature ### Aggregate Gadget has a fixed font size option Allow user to display gadget with a fixed font | **Auto Size** | **Fixed Size** | |-----------------------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------| | ![AutoSize.png](https://docs.akeles.com/__attachments/a_51ee43ac2e8ad1f6f220d4bb63e1d17895099d298c4a9b0d5e4011e1e1410fc7/AutoSize.png?cb=db63f72c34f9ec8415dc8a6ca9c26a9a) | ![FixedSize.png](https://docs.akeles.com/__attachments/a_20655fb6a9e66d358acfe1f112f337a433afe9b3078c50a10a00b4cbdb6854a3/FixedSize.png?cb=b37e2258f2147ffa992839941a24908a) | ## Bug Fixes ### Aggregate gadget font size shows no difference You can now see the different font sizes for your gadget | **Small** | **Medium** | **Large** | |-------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------| | ![Small-font-size.png](https://docs.akeles.com/__attachments/a_773eb8b3a1c381fab67de8f31c9eb3d35a2b4c1e82d9aa226e6368c9b354f62c/Small-font-size.png?cb=e3cb717713b9b2d8e07e4468411efe21) | ![medium-font-size.png](https://docs.akeles.com/__attachments/a_1d2e1a9774e6d22fc7294aa26a5c3c684e8429149c46702597e6dd2a3a67c348/medium-font-size.png?cb=c152262d9ff7aac5d7c88198ddecadd5) | ![large-font-size.png](https://docs.akeles.com/__attachments/a_866af4dc7ca3c7770b23f4e41def248211bcd30d2fb95b20374bfc90a748e47f/large-font-size.png?cb=ae2229e811d03a6476dec6436939bbad) | ### Auto-adjust value text font size in Counter Gadget If the value text width exceeds the counter board width, the font size will be auto-adjusted to fit the board. | **Before** | **After** | |-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | ![before-countergauge-fix.png](https://docs.akeles.com/__attachments/a_4ef5e140d5aa990af7b9bda2858c017d8f25ba0a8ecccbfb1afbcd8fb6f534a5/before-countergauge-fix.png?cb=52005e55427f081ae017d5145c5e2c81) | ![after-countergauge-fix.png](https://docs.akeles.com/__attachments/a_f9d1be3c4d2e935f6ee9b5912cfd4e1c871cd355dcce63e174870395e77b2c40/after-countergauge-fix.png?cb=9bc4b7765f9e0f330045e9ffe69434b9) | --- language: "en" --- # Release Notes for 2.4.0 ## Improvements ### To display error message if user has no permission to filter User will now see the filter name they have no permission to instead of an empty value. | **Before** | **After** | |-------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | ![MissingFilterValue.png](https://docs.akeles.com/__attachments/a_84c348659eacf9e8be25e9e491e84be3518cf91fd161f650a8805164c5c1a760/MissingFilterValue.png?cb=177ff2105ca6eb3eb43c48863b89f093) | ![NoPermissionToFilter.png](https://docs.akeles.com/__attachments/a_c825ad05e4cc66c0253c8aa756bbc6d53a3133eeea357c8433bbffc40d897179/NoPermissionToFilter.png?cb=2bc7d1ee2b5c7c355af2fa29090762c8) | --- language: "en" --- # Release Notes for 2.5.0 ## Bug Fixes ### Green to Red shows default Red color Users can now see the gadget color change to red based on their configurations. ### Color limit option shown when color option is not green to red Color limit is now only shown when Green to Red or Red to Green is selected as the wave color. | **Before** | **After** | |-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | ![ColorLimit_Before_Fix.png](https://docs.akeles.com/__attachments/a_50fc2ca66009d8a22394403f60ca0bbf5b582400f31856924b77d875b2a2ccdf/ColorLimit_Before_Fix.png?cb=bca372942878f1967f39439462cfa289) | ![ColorLimit_After_Fix.png](https://docs.akeles.com/__attachments/a_acfcd1c24682765955a89206a8b91f6c0d00afe997810a4b91e446033c4467af/ColorLimit_After_Fix.png?cb=cf997f4361e6882dde912b83aebab045) | --- language: "en" --- # Resources * [Differences between the Cloud and Server editions](https://docs.akeles.com/gaugec/resources/differences-between-the-cloud-and-server-editions.md) --- language: "en" --- # Differences between the Cloud and Server editions This page is to summarise the differences between the Cloud edition and the Server/DC editions of the Gauge Gadgets. ## Types of Gadgets We are targeting to roll out the same set of gadgets for both platforms. | **Feature** | **Cloud** | **Server** | |-----------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------| | Counter Gadget | ![check mark](https://docs.akeles.com/__attachments/a_8b8ed6a2b9a4d925d14c6dda1421f4aa63b0c16174722315c7f324c19160a577/atlassian-check_mark?cb=a10212e1c1021c5194f7535b6843f955) | ![check mark](https://docs.akeles.com/__attachments/a_8b8ed6a2b9a4d925d14c6dda1421f4aa63b0c16174722315c7f324c19160a577/atlassian-check_mark?cb=a10212e1c1021c5194f7535b6843f955) | | Horseshoe Gauge | ![check mark](https://docs.akeles.com/__attachments/a_8b8ed6a2b9a4d925d14c6dda1421f4aa63b0c16174722315c7f324c19160a577/atlassian-check_mark?cb=a10212e1c1021c5194f7535b6843f955) | ![check mark](https://docs.akeles.com/__attachments/a_8b8ed6a2b9a4d925d14c6dda1421f4aa63b0c16174722315c7f324c19160a577/atlassian-check_mark?cb=a10212e1c1021c5194f7535b6843f955) | | Liquid Gauge | ![check mark](https://docs.akeles.com/__attachments/a_8b8ed6a2b9a4d925d14c6dda1421f4aa63b0c16174722315c7f324c19160a577/atlassian-check_mark?cb=a10212e1c1021c5194f7535b6843f955) | ![check mark](https://docs.akeles.com/__attachments/a_8b8ed6a2b9a4d925d14c6dda1421f4aa63b0c16174722315c7f324c19160a577/atlassian-check_mark?cb=a10212e1c1021c5194f7535b6843f955) | ### Features Some of the features on server are not yet available on Cloud. | **Feature** | **Cloud** | **Server** | **Remarks** | |-------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------| | Allow selection of colours | ![check mark](https://docs.akeles.com/__attachments/a_8b8ed6a2b9a4d925d14c6dda1421f4aa63b0c16174722315c7f324c19160a577/atlassian-check_mark?cb=a10212e1c1021c5194f7535b6843f955) | ![check mark](https://docs.akeles.com/__attachments/a_8b8ed6a2b9a4d925d14c6dda1421f4aa63b0c16174722315c7f324c19160a577/atlassian-check_mark?cb=a10212e1c1021c5194f7535b6843f955) | For cloud, certain colours are not available on Counter gadget (Grey, Black, White) | | JQL Support | ![check mark](https://docs.akeles.com/__attachments/a_8b8ed6a2b9a4d925d14c6dda1421f4aa63b0c16174722315c7f324c19160a577/atlassian-check_mark?cb=a10212e1c1021c5194f7535b6843f955) | ![cross mark](https://docs.akeles.com/__attachments/a_a9cc6dc9605e0a2d78bb366d16d40b5229d4aa6abaa009416f1d74dbb4b819b9/atlassian-cross_mark?cb=a9c671cfc7809253be52d640dbbf1019) | | | Display values in % | ![check mark](https://docs.akeles.com/__attachments/a_8b8ed6a2b9a4d925d14c6dda1421f4aa63b0c16174722315c7f324c19160a577/atlassian-check_mark?cb=a10212e1c1021c5194f7535b6843f955) | ![check mark](https://docs.akeles.com/__attachments/a_8b8ed6a2b9a4d925d14c6dda1421f4aa63b0c16174722315c7f324c19160a577/atlassian-check_mark?cb=a10212e1c1021c5194f7535b6843f955) | | | Use a dynamic value (i.e. filter) for max value | ![check mark](https://docs.akeles.com/__attachments/a_8b8ed6a2b9a4d925d14c6dda1421f4aa63b0c16174722315c7f324c19160a577/atlassian-check_mark?cb=a10212e1c1021c5194f7535b6843f955) | ![check mark](https://docs.akeles.com/__attachments/a_8b8ed6a2b9a4d925d14c6dda1421f4aa63b0c16174722315c7f324c19160a577/atlassian-check_mark?cb=a10212e1c1021c5194f7535b6843f955) | | | Display sum of other custom fields | ![check mark](https://docs.akeles.com/__attachments/a_8b8ed6a2b9a4d925d14c6dda1421f4aa63b0c16174722315c7f324c19160a577/atlassian-check_mark?cb=a10212e1c1021c5194f7535b6843f955) | ![check mark](https://docs.akeles.com/__attachments/a_8b8ed6a2b9a4d925d14c6dda1421f4aa63b0c16174722315c7f324c19160a577/atlassian-check_mark?cb=a10212e1c1021c5194f7535b6843f955) | | | Configurable colours for % value (Counter) | ![check mark](https://docs.akeles.com/__attachments/a_8b8ed6a2b9a4d925d14c6dda1421f4aa63b0c16174722315c7f324c19160a577/atlassian-check_mark?cb=a10212e1c1021c5194f7535b6843f955) | ![check mark](https://docs.akeles.com/__attachments/a_8b8ed6a2b9a4d925d14c6dda1421f4aa63b0c16174722315c7f324c19160a577/atlassian-check_mark?cb=a10212e1c1021c5194f7535b6843f955) | | | Configurable text size (Counter) | ![check mark](https://docs.akeles.com/__attachments/a_8b8ed6a2b9a4d925d14c6dda1421f4aa63b0c16174722315c7f324c19160a577/atlassian-check_mark?cb=a10212e1c1021c5194f7535b6843f955) | ![check mark](https://docs.akeles.com/__attachments/a_8b8ed6a2b9a4d925d14c6dda1421f4aa63b0c16174722315c7f324c19160a577/atlassian-check_mark?cb=a10212e1c1021c5194f7535b6843f955) | | | Configurable Wave Speed (Liquid) | ![check mark](https://docs.akeles.com/__attachments/a_8b8ed6a2b9a4d925d14c6dda1421f4aa63b0c16174722315c7f324c19160a577/atlassian-check_mark?cb=a10212e1c1021c5194f7535b6843f955) | ![check mark](https://docs.akeles.com/__attachments/a_8b8ed6a2b9a4d925d14c6dda1421f4aa63b0c16174722315c7f324c19160a577/atlassian-check_mark?cb=a10212e1c1021c5194f7535b6843f955) | | --- language: "en" --- # Upgrading the app to Atlassian Forge version ## Introduction We have migrated the app from Atlassian Connect to Atlassian Forge from [version 2.0.0](https://docs.akeles.com/gaugec/release-notes/release-notes-for-2-0-0.md) onwards. * **version 1.x.x** - powered by Atlassian Connect * **version 2.x.x and beyond** - powered by Atlassian Forge Unlike previous releases, where updates were automatically rolled out, this version is a major release which requires Jira admins to trigger the update manually. ## Steps To upgrade to the latest version, 1. Go to Jira 2. Click on the **Settings** icon on the top right corner of the top menu bar 3. Select **Marketplace apps** from the dropdown menu ![Access Marketplace apps settings.png](https://docs.akeles.com/__attachments/a_0ff19bef4ca09682b5d5d438fb880ea357c326d74483a28aa6959f470216d87c/Access%20Marketplace%20apps%20settings.png?cb=0892e36faaa3292be37cdde3d5c8d8ec) 4. Click on **Take me there** button ![Take me there.png](https://docs.akeles.com/__attachments/a_9372a7a0d2c06128812381fa088673c9e905b09d0fbfdd55bdd21cf44d50eabd/Take%20me%20there.png?cb=5c2906d7375153670fcad7575799135c) 5. You will reach the **Connected Apps** page 6. Search for **Gauge Gadgets** ![Update_App.png](https://docs.akeles.com/__attachments/a_72e66363686bf81f047401f9ce67fd2c56d21a100fca61626650716a3893a649/Update_App.png?cb=929f6b169920b486920889b7ecd8dd0e) 7. Click on **View app details** link for the entry 8. Click on the **Update** button ![Gadget_Details.png](https://docs.akeles.com/__attachments/a_6199dc2a128da06c24df326a0e87050a9fd2e9683e15eed3a7a685338ec9adfb/Gadget_Details.png?cb=5cd1862df9a11a65e014a4c8c60a7527) 9. Click on the **Update** button to confirm the upgrade ![Confirm app update.png](https://docs.akeles.com/__attachments/a_7a9d5cb0812f837d03557d388fa5598aeb238a6c4592253a1bacd77e308bf6e4/Confirm%20app%20update.png?cb=487496b96b991d64c6c7cb651d858d30) 10. The app is upgraded successfully ![Gauge_Gadget_Details.png](/__attachments/a_950d595e74272be14e0736bd774f425e7445253148c0b15f0472fcdc0170a49d/Gauge_Gadget_Details.png?cb=703767709b68a8b21b33f63ec4903a03) Now you can verify if your gadgets are running as usual. If there are any issues, you can raise a ticket at [our Service Desk](https://akeles.jira.com/servicedesk/customer/portal/1/group/1/create/8). ## Benefits of switching to Forge With the app running on Atlassian infrastructure, * **Improved security** through Atlassian's built-in security, privacy, and compliance standards * It complies fully with Data Residency even though the app does not store data previously * It ensures there is no data egress to external servers * **Optimized performance and scalability**, ensuring a more stable experience as usage grows * **Full alignment with Atlassian Cloud**, keeping the app compatible with Atlassian's future platform direction --- language: "en" --- # User Guide * [Configuring Horseshoe Gadget](https://docs.akeles.com/gaugec/user-guide/configuring-horseshoe-gadget.md) * [Configuring Counter Gadget](https://docs.akeles.com/gaugec/user-guide/configuring-counter-gadget.md) * [Configuring Liquid Gauge Gadget](https://docs.akeles.com/gaugec/user-guide/configuring-liquid-gauge-gadget.md) * [Configuring Aggregate Gadget](https://docs.akeles.com/gaugec/user-guide/configuring-aggregate-gadget.md) --- language: "en" --- # Configuring Aggregate Gadget ## Introduction This is another alternative besides the [Counter Gadget](https://docs.akeles.com/gaugec/user-guide/configuring-counter-gadget.md) which can handle large values better and more flexible display formats. ![Hover For JQL.gif](https://docs.akeles.com/__attachments/a_18a010da0c0463ebec36b608581afb27614fc72e6be46c326d7adca34ed74f02/Hover%20For%20JQL.gif?cb=3839234127db7844d86bbc3c57717b67) **Possible use cases**: * Counting total cost for the month * Calculating the total budget for the project * Summing the total cost savings from all the project enhancements ## Why Aggregation Gadget * Display value can be formatted with delimiter for better readability for large values * 111,111,111 vs 111111111 * Text can be added before and after the aggregated values to support more scenarios * **US$**1,088,816.77 (prefix) * 3,645 **man hours** (suffix) * **Our top** 5 **voted requests** (both prefix and suffix) * Rounding off to 2 decimal places for floating point numbers *** ** * ** *** ## Adding Aggregate Gadget to a dashboard 1. Go to a dashboard and click on **Add gadget**. 2. Search for **Aggregate** and click on **Add gadget** next to it. ![Adding Aggregate Gadget.png](https://docs.akeles.com/__attachments/a_5a59bf4ebceb082a2906ec5c925eae1349a98944dee0ac4caf03f53376e2c342/Adding%20Aggregate%20Gadget.png?cb=5ebb05519625784987386a561a51cf81) ## Aggregate Gadget configuration ![Aggregate Gadget Configuration.png](https://docs.akeles.com/__attachments/a_5e29eb874dfa95d0e959558737f4f255cf830bedd57983573c1b9cee438889df/Aggregate%20Gadget%20Configuration.png?cb=56a856f11cfac6a866df8b997ed1259e) | **Settings** | **Description** | |------------------|-----------------------------------------------------------------------------------------------| | Title | The title of the gadget | | Issues | Filter or JQL can be used to search to display the number of issues shown in the gauge gadget | | Field | Calculation mode for Issues | | Header Text | Text shown above the aggregate value | | Footer Text | Text shown below the aggregate value | | Additional Text | Dropdown selection to choose if you want a prefix or suffix text | | Text Size | The size of the text that will be displayed | | Background Color | The color of the text to be use on the board | | Hide Filter Link | To hide the filter link | | Gadget Height | The height of the gadget and gauge will scale based on the height of the gadget | | Format Thousands | To format the calculated number if it is too large (E.g. 1000000 → 1,000,000) | | Refresh Interval | Frequency of gadget refresh rate | ![Hover For JQL.gif](https://docs.akeles.com/__attachments/a_18a010da0c0463ebec36b608581afb27614fc72e6be46c326d7adca34ed74f02/Hover%20For%20JQL.gif?cb=3839234127db7844d86bbc3c57717b67) **\*BONUS TIP\***Hover over "User JQL" to see your JQL Query ## Some possible ways you can use Aggregate Gadget ![Examples for aggregate gadgets.png](https://docs.akeles.com/__attachments/a_dfad2c6c06760c8c1d941ece0d2fb34b4531f9d41f9347b2cadc2f04532c9789/Examples%20for%20aggregate%20gadgets.png?cb=85cca0cce6b5d254e077d84034852c99) ## Comparison with other gadgets | [**Counter Gadget**](https://docs.akeles.com/gaugec/user-guide/configuring-counter-gadget.md) | [**Horseshoe Gadget**](https://docs.akeles.com/gaugec/user-guide/configuring-horseshoe-gadget.md) | **Aggregate Gadget** | |---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | ![CounterGadget.png](https://docs.akeles.com/__attachments/a_f0d885a4439d569e35e61a59d3778207fe5dae114f11bdf9781a54154bdd4ae0/CounterGadget.png?cb=b274df81d1b2530d7313ae5e6e603441) * Useful for counting small ranges of numbers * Suitable for multi-column layout * Can use [Multiple Filters Counter Gadget](https://docs.akeles.com/mchartc/user-guide/configure-counter.md) for single column layout | ![Horseshoe Gadget.png](https://docs.akeles.com/__attachments/a_eaef73c0685d51b6fbc2ec86be42f1481663c6a3d69a986d9beae90951152023/Horseshoe%20Gadget.png?cb=880ca715da6883806d3ab32e0f7db51b) * Useful for comparing 2 set of numbers visually * Suitable for multi-column layout | ![AggregateGadget.png](https://docs.akeles.com/__attachments/a_dae2d775a2ccdabcd93e3a0f056cfbd661d8d135c04fc9b34c589f88b2151cd1/AggregateGadget.png?cb=7f479a181a532bb307c238e0ce2b0378) * Useful for displaying large values * Suitable for single column layout due to its rectangular shape | --- language: "en" --- # Configuring Counter Gadget ## Adding Counter Gadget to a dashboard 1. Go to a dashboard and click on **Add gadget**. 2. Search for **Counter** and click on **Add gadget** next to it. ![Add Counter.png](https://docs.akeles.com/__attachments/a_7a1535b69a18d757bf99e995f54738e4d885b41dab8933eca50e3ddd4fbfd98f/Add%20Counter.png?cb=6560a1e86bc93e9ab291f644386bc608) ### Counter Gadget configuration ![Counter_Gadget.png](https://docs.akeles.com/__attachments/a_60fa91751d3850e7ca116d690b39ad1339ec7b5ea643468081aed52367ca6645/Counter_Gadget.png?cb=7f92e3efb3acac3ec60f0a0891d8e848) | **Settings** | **Description** | |------------------|-----------------------------------------------------------------------------------------------| | Title | The title of the gadget | | Issues | Filter or JQL can be used to search to display the number of issues shown in the gauge gadget | | Board Color | The colour of the counter gauge | | Footer Text | The helper text to show at the bottom of the board | | Text Size | The size of the text that will be displayed | | Text Color | The color of the text to be use on the board | | Hide Filter Link | To hide the filter link | | Gadget Height | The height of the gadget and gauge will scale based on the height of the gadget | **\*BONUS TIP\***Hover over "User JQL" to see your JQL Query ![Counter Gauge JQL.gif](https://docs.akeles.com/__attachments/a_5333f13cc847847a3f5fd76ecf7be12e642f77d55dd2dd93a133b1a671eb14d2/Counter%20Gauge%20JQL.gif?cb=98aa30b8fdb92b232cfcdf48ea130fc1) You might want to check out [Multiple Filters Counter Gadgets](https://docs.akeles.com/mchartc/resources/how-to-use-multiple-filters-counter-gadgets.md) which can display many counters within a single gadget. * Your dashboard loads faster since it renders 1 gadget instead of multiple gauge gadgets * It fits nicely with other gadgets in single column layout --- language: "en" --- # Configuring Horseshoe Gadget ## Adding Horseshoe Gadget to a dashboard 1. Go to a dashboard and click on **Add gadget**. 2. Search for **Horseshoe** and click on **Add gadget** next to it. ![Add Horseshoe.png](https://docs.akeles.com/__attachments/a_51dccc0031fba520e7dcde39c24b58e58ecb5906a592c004e2080502f6ab7467/Add%20Horseshoe.png?cb=91f1300d5178825291d386a2eea0ad85) ### Horseshoe Gadget configuration ![HorseShoe_Gadget.png](https://docs.akeles.com/__attachments/a_9d376aee7934490ff58ac23ee2a0ee33178bebad8b0a7b56a1f17174ed818d06/HorseShoe_Gadget.png?cb=04b5101faac4b269fb3b6f5306bfaff3) | **Settings** | **Description** | |---------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | Title | The title of the gadget | | Issues | Filter or JQL can be used to search to display the number of issues shown in the gauge gadget | | Meter Type | The type of gauge to be displayed. There are a total of 5 different gauges: * **Horseshoe**-- As the number of issues increases, it changes from Green to Yellow to Red * **Horseshoe (Reverse)** -- As the number of issues increases, it changes from Red to Yellow to Green * **Horseshoe in %**- Similar to Horseshoe except gauge value in normalised % * **Horseshoe in % (Reverse)**- Similar to Horseshoe (Reverse) except gauge value in normalised % * **Speedometer** | | Min Value | The minimum value of the gauge | | Max Value Type | The type of maximum value for the gadget * Fixed value (Use Number as Max Value) * Based on number of issues in another filter (Use Filter as Max Value) | | Max Value *(For Use Number as Max Value option)* | The maximum value of the gauge | | Max Value Filter *(For Use Filter as Max Value option)* | The filter in which the number of issues will be displayed in the gauge as the maximum value | | Gadget Height | The height of the gadget and gauge will scale based on the height of the gadget | **\*BONUS TIP\***Hover over "User JQL" to see your JQL Query ![HorseShoe Gauge JQL.gif](https://docs.akeles.com/__attachments/a_683185ce5a6a22a3d39679b288b6713a7b1e3fb905f7a7d0e2ca2fdfc2aae7ca/HorseShoe%20Gauge%20JQL.gif?cb=e5e5f0192aaa1e8a20b3a98ac1ad3b97) --- language: "en" --- # Configuring Liquid Gauge Gadget ## Adding Liquid Gauge Gadget to a dashboard 1. Go to a dashboard and click on **Add gadget**. 2. Search for **Liquid Gauge** and click on **Add gadget** next to it. ![Add Liquid Gauge.png](https://docs.akeles.com/__attachments/a_cb856b46c8c86d0f195ec5059b869a598490ff56ab63c02fc8b8dbdf5e220029/Add%20Liquid%20Gauge.png?cb=89483de2dc30a3042a1ab998a3cf045e) ### Liquid Gauge Gadget configuration ![Liquid_Gadget.png](https://docs.akeles.com/__attachments/a_e013804225c5b7474e56667ba92b160ca9aa7d69d649848b6fdf8b8695003de1/Liquid_Gadget.png?cb=a66e6c6679d1e0a02b3892e26ba7e7f5) | **Settings** | **Description** | |---------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------| | Title | The title of the gadget | | Issues | Filter or JQL can be used to search to display the number of issues shown in the gauge gadget | | Min Value | The minimum value of the gauge | | Max Value Type | The type of maximum value for the gadget * Fixed value (Use Number as Max Value) * Based on number of issues in another filter (Use Filter as Max Value) | | Max Value *(For Use Number as Max Value option)* | The maximum value of the gauge | | Max Filter *(For Use Filter as Max Value option)* | The filter in which the number of issues will be displayed in the gauge as the maximum value | | Gadget Height | The height of the gadget and gauge will scale based on the height of the gadget | | Gauge Color | The colour of the liquid gauge and there is option to change liquid colour based on the level of the gauge | | Wave Speed | Animation speed for the wave in liquid gauge | | Display in | Display in **percentage** of the gauge or the number given in the **Value Filter** | | Decimal Place | How many decimal to be display in the gauge | **\*BONUS TIP\***Hover over "User JQL" to see your JQL Query ![Liquid Gauge JQL.gif](https://docs.akeles.com/__attachments/a_17c77edfbaeef0537e7b82a3ebc0461c297decba7b9b4cc6ecafb1eedbab063b/Liquid%20Gauge%20JQL.gif?cb=20539a3711b6f6b3c995c43a42e101c5) --- language: "en" --- # General Information This page stores the general information * [Data Security and Privacy Statement](https://docs.akeles.com/info/data-security-and-privacy-statement.md) * [End User License Agreement](https://docs.akeles.com/info/end-user-license-agreement.md) * [Service Level Agreement for Akeles apps](https://docs.akeles.com/info/service-level-agreement-for-akeles-apps.md) * [CVE-2021-44228 Marketplace Apps Tracking List](https://docs.akeles.com/info/marketplace-apps-tracking-list.md) * [Our Security Philosophy](https://docs.akeles.com/info/our-security-philosophy.md) * [How to find the Entitlement Number for the Cloud apps](https://docs.akeles.com/info/how-to-find-the-entitlement-number-for-the-cloud-apps.md) --- language: "en" --- # Data Security and Privacy Statement ## We respect your privacy This Privacy Policy outlines how we treat your personal information. Any personal information you provide to us including and similar to your name, address, telephone number and e-mail address will not be released, sold, or rented to any entities or individuals outside of our organization except as noted below. ## With Whom Do We Share the Personal Information We Collect Through This Site ### **Our Service Providers, Business Partners and Others** We may share your personal information with companies (including our affiliates) that perform services on our behalf, for example, companies that help process credit card payments. Our service providers are required by contract to protect the confidentiality of the personal information we share with them and to use it only to provide specific services on our behalf. #### **Government and Legal Disclosures** We may disclose the personal information we collect through this Site, when we, in good faith, believe disclosure is appropriate to comply with the law (or a court order or subpoena); to prevent or investigate a possible crime, such as fraud or identity theft; to enforce our Terms and Conditions or other agreements that govern your use of this Site; or to protect the rights, property or safety of our company, our users, or others. #### Business Transfers Your personal information may be transferred to another entity (either an affiliated entity or an unrelated third party) in connection with a merger, reorganization, dissolution or similar corporate event. If such a transfer were ever to occur, the acquiring entity's use of your personal information will still be subject to this Privacy Policy. ## What information do we collect * Information relating to your access to our websites such as date and time of your visit, the originating IP address, browser type, referral source, length of visit and pages and images requested * Information that you provide to us for the purpose of registering with us, including information for the purpose of subscribing to our services and email notifications We use Google Analytics to collect detailed statistics and help us understand how you use our web sites. Google Analytics uses cookies and other means to transfer some information about how you're using our websites to Google Servers. Details are available in [Google Analytics Terms of Service](http://www.google.com/analytics/terms/us.html) ## How do we use your information We use your information for the following cases: * Provide, operate, maintain, improve and promote our services * Monitor and analyze trends, usage and activities for marketing or product development purposes * Track and manage your requests/feedback * Improve the product based in feedback provided * Communication with you We are using Atlassian's Jira to track your support tickets, feedback and feature requests. You can refer to [Atlassian's Privacy Policy](https://www.atlassian.com/legal/privacy-policy). We are using [MailChimp](http://mailchimp.com/) service for maintaining mailing lists and sending out newsletters. It is therefore essential to transfer to MailChimp your email, first name and last name (if the latter are provided). You can refer to [MailChimp's Privacy Policy](http://mailchimp.com/legal/privacy/). ## Security We take every precaution to protect your personal information. In addition, we have strict security protocols in place to protect our customer database from unauthorised access, improper use or disclosure, unauthorised modification, and unlawful destruction or accidental loss. We only allow access to the customer database when absolutely necessary, and then under strict guidelines as to what use may be made of such details. We may ask you for proof of identity before disclosing any personal information to you. ### Cookies A "cookie" is a small data text file that is placed in your browser and allows us to recognize you each time you visit this site (personalization, etc). Cookies themselves do not contain any personal information, and we do not use cookies to collect personal information. Cookies may also be used by 3rd party content providers such as newsfeeds. Some of our business partners (for example, 3rd party service providers) may use cookies on our Site or their own sites. We have no access to, or control over these cookies. You are not obliged to accept a cookie from us, or any other website, and you may modify your browser so that it will not accept cookies, although some features on the Site may not function if you do. #### Security Governance and Risk Management * Our apps do not store customer data externally in order to minimise our risks. * For on-premise apps, they are stored locally on the Jira/Confluence servers. * For Cloud apps, they are stored on Atlassian infrastructure. * We maintain internal security and privacy policies that are reviewed periodically. * Security considerations are incorporated into design, development, testing, and operations. * We assess security and operational risks for new features and significant changes. * Staff with access to customer data receive guidance on security and privacy responsibilities. #### Secure Development and Change Management * Changes to application code are tracked in version control and subject to review. * We follow secure coding practices to reduce common vulnerabilities such as injection, cross-site scripting, and insecure direct object references. * Changes are tested in non-production environments before release where practicable. * Only authorized personnel can approve and deploy changes to production systems. #### Vulnerability Management * We monitor for security updates relevant to the technologies we use. * Critical and high‑severity vulnerabilities in our environments are prioritized for remediation. * We patch or mitigate known vulnerabilities within commercially reasonable timeframes, taking into account severity and exploitability. * For Vulnerability Disclosure * We encourage responsible disclosure of potential security issues affecting our apps or systems. * Security issues can be reported to [our Service Desk](https://akeles.jira.com/servicedesk/customer/portals). * We will acknowledge receipt, investigate in good faith, and work to remediate confirmed issues. #### Incident Response and Customer Notification * We maintain processes to detect, assess, and respond to suspected security incidents. * If we confirm a security incident that materially affects the confidentiality, integrity, or availability of customer data or our apps, we will: * Investigate the scope and impact. * Take steps to contain and remediate the issue. * Provide affected customers with timely information, subject to legal and confidentiality obligations. * After significant incidents, we review root causes and improve controls where appropriate. #### Access Control and Authentication * Access to production systems and data is restricted to authorized personnel based on job role and necessity. * Administrative access requires strong authentication mechanisms where supported. * Accounts are provisioned and deprovisioned following documented processes (for example, upon role changes or termination). * Access rights are periodically reviewed. ## Policy Amendments We may update this privacy policy from time to time by posting a new version on this web site. Users can request to be notified on an update by sending the request to [our Service Desk](https://akeles.jira.com/servicedesk/customer/portals). Policy was last updated on 14 Apr 2026. ## Contact Information For any other information or comments, please contact us at ++8 Eu Tong Sen Street #14-94 The Central Singapore 059818++ or email [contact@akeles.com](mailto:contact@akelesconsulting.com) --- language: "en" --- # End User License Agreement IMPORTANT -- READ CAREFULLY: The END USER LICENSE AGREEMENT (hereinafter referred to as EULA) is a legal agreement between you (either an individual or a single entity) and Akeles Consulting Pte Ltd (hereinafter referred to as AKELES) for the Atlassian Add-on (hereinafter referred to as SOFTWARE). By installing, copying, or otherwise using the SOFTWARE, you agree to be bound by the terms of this EULA. This EULA is to be read in conjunction with "Atlassian Marketplace Terms of Use" available at . In case of any conflict between the terms of this License and Atlassian Marketplace Terms of Use, the former shall prevail. 1.Grant of License 1. The SOFTWARE is protected by copyright laws and international copyright treaties, as well as other intellectual property laws and treaties. 2. This license grants you the limited, worldwide, non-exclusive to install and use the SOFTWARE for the number of licensed users. 3. You are allowed to copy the software for backup, archival as well as testing purposes. 4. You may not sell, transfer or convey the Software to any third party without AKELES' prior express written consent. 2. Ownership and Reservation of Rights 1. All rights of any kind, which are not expressly granted by the present EULA, are entirely and exclusively reserved to and by AKELES. 2. The Software is licensed, not sold. You do not acquire any ownership rights as a result of downloading, installing or using the SOFTWARE. 3. Termination 1. You may terminate this EULA at any time by destroying all your copies of the Software. 2. The license will automatically terminate if you fail to comply with the terms of this agreement. 3. On termination, you are required to remove the SOFTWARE from your computer and destroy all copies of the Software and Documentation and all its component parts. 4. There shall be no refund or adjustment for amounts paid by you to AKELES. 5. The provisions of the present EULA which by their nature extend beyond the termination date of the EULA will survive and remain in effect and enforceable until all obligations are fully satisfied. 4. Infringement Indemnification 1. AKELES will hold YOU harmless, defend and indemnify You, against a third party claim to the extent based on an allegation that the SOFTWARE infringes a third party intellectual property right, provided that AKELES: (a) is promptly notified and furnished a copy of such Claim, and all other documents that the claim is based on (b) is given reasonable assistance in and sole control of the defense thereof and all negotiations for its settlement. 2. If the SOFTWARE becomes, or in the opinion of AKELES may become, the subject of a Claim, AKELES may, at its option and in its discretion: (a) procure for YOU the right to use the SOFTWARE, free of any liability; (b) replace or modify the SOFTWARE to make it non-infringing; or (c) terminate your right to continue using the SOFTWARE and refund, in this case, any license fees related to the SOFTWARE paid by YOU. 5. Limitation of Liability 1. Except for the indemnification clause, neither party will be liable to any person for the use of the SOFTWARE. 2. In no event will the total liability under any claims arising out of this agreement exceed the license fees paid under this agreement. 6. Publicity Rights 1. AKELES has the right to use your name for commercial purposes and/or to include your name and/or logos in her clients list or any promotional materials. 2. You can deny this right at any time by submitting a written request via email to [addons@akeles.com](mailto:addons@akeles.com) , requesting for exclusion from subsequent promotional materials. 3. AKELES will remove the name and/or logos from existing promotional materials within her best effort. 4. Requests submitted after purchasing may take thirty (30) calendar days to process 7. Governing Law 1. This EULA will be governed by the law of the Republic of Singapore. Any claims arising out of this EULA will be brought in the Republic of Singapore and in this regard, all parties will submit to the non exclusive jurisdiction of the Singapore Courts. 8. Entire Agreement 1. This EULA represents the complete agreement concerning this license between the parties and supersedes all prior agreements and representations between them 2. AKELES may amend or modify this EULA from time to time. Users can request to be informed of any changes by submitting a written request via email to [addons@akeles.com](mailto:addons@akeles.com) 3. Unless required by Laws, we agree not to make modifications that would substantially diminish our obligations during your then-current License Term 4. For our free software, you must accept the modifications to continue using the software. If you object to the modifications, your exclusive remedy is to stop using the free software 5. For our paid software, customers can raise their objection by providing notice to [addons@akeles.com](mailto:addons@akeles.com) within thirty (30) days of us providing notice of the modification If the resolution is unacceptable, customer can request for termination and refund for any fees pre-paid for use of the affected Software for the terminated portion of the License Term 6. For avoidance of doubt, any Order is subjected to the version of the version of Agreement in effect at the time of the Order 7. If any provision of this EULA is held to be unenforceable for any reason, such provision shall be reformed only to the extent necessary to make it enforceable and the remaining provisions of this EULA shall remain in full force and effect.This EULA represents the complete agreement concerning this license between the parties and supersedes all prior agreements and representations between them. Should you have any questions about this EULA, please contact Akeles Consulting Pte Ltd at 8, Eu Tong Sen Street, #14-94 The Central, Singapore 059818 Email: [contact@akeles.com](mailto:contact@akeles.com) Last Updated: 07th Feb 2019 --- language: "en" --- # How to find the Entitlement Number for the Cloud apps ## Introduction Unlike Data Center apps, the Entitlement Number for Atlassian Cloud apps are not displayed directly. You can refer to this guide on how to locate the info. ## About the Entitlement Number The **Entitlement Number** is a unique license reference for a specific Atlassian Marketplace app subscription on a Cloud site. It is used by Atlassian and Marketplace vendors to identify the customer's app license when handling support, billing, renewals, migrations, or entitlement-related questions. The Entitlement Number for Atlassian Marketplace cloud apps is essentially the **unique license identifier for a specific app subscription on a specific cloud site**. In practice, it is used for: * **Identifying the exact app license/installation** * Distinguishes your app subscription on a particular Jira/Confluence Cloud site from all others. * **Billing and subscription troubleshooting** * Lets Atlassian and vendors check: * whether the subscription is active or cancelled * billing/renewal history and tier (user count, edition) * trial vs paid status and start/end dates * **Support and case tracking with vendors** * When you raise a support ticket, vendors use the Entitlement Number to: * quickly locate your customer record and license * confirm that you're entitled to support * link your ticket to the right app instance and site * **Migrations, quotes, and commercial operations** * May be requested when: * migrating from one site/tenant to another * preparing renewal quotes or commercial offers * reconciling multiple app subscriptions across sites * **Audit and compliance** * Acts as a stable reference in internal records to prove which app license was active in a given period. * **Not a secret, but share selectively** * It's **not** a password or API token. * Still, you should normally share it **only with Atlassian or the Marketplace vendor/support** when requested for licensing or support purposes, not publish it broadly. ### Steps to find the Entitlement Number Only the Site Admin can access the info 1. Go to [++**admin.atlassian.com**++](http://admin.atlassian.com/). 2. Select your **organization** (if you have more than one). 3. In the left sidebar, go to **Apps → Sites** , then select your **site**. ![How to access the site.png](https://docs.akeles.com/__attachments/a_71b0a604b32838f34707d5594a6b6c106a53ea6408a6f2b10ee9778453d48700/How%20to%20access%20the%20site.png?cb=d80bb5e4ddb507ab2e2960c6dd05927f) 4. In the site sidebar, click **Connected apps**. ![How to access Connected apps on Atlassian Cloud.png](https://docs.akeles.com/__attachments/a_68b1c923789c5cc789277d50ad5914078971a65bd3684bde243141f5ea6d2ecc/How%20to%20access%20Connected%20apps%20on%20Atlassian%20Cloud.png?cb=98beb14f093d217a09a8045e1d1b10e7) 5. Find and click **View app details** for the app. ![How to view app details of a Jira Cloud app.png](https://docs.akeles.com/__attachments/a_8f9e32704a96f837cc8a6b1f8545f143bb383e08978afee18cd8d1efcdb0fc1d/How%20to%20view%20app%20details%20of%20a%20Jira%20Cloud%20app.png?cb=d2149a2821717c5010e753f900298324) 6. For a paid app, the information is directly available on the page ![How to find the Entitlement Number for a paid Jira Cloud app.png](https://docs.akeles.com/__attachments/a_8b08a232c049e33169f9d27a6325f607fc22d4aabdcdb8cf5e2215ca1cdd5860/How%20to%20find%20the%20Entitlement%20Number%20for%20a%20paid%20Jira%20Cloud%20app.png?cb=c078715c5d6aabaa2f694d1b6264511f) 7. For a free app, there are additional steps 1. Click on the ... and select **Manage subscription** ![How to manage subscription for a Jira Cloud app.png](/__attachments/a_a9f7057cfe0f7c3ffbff47835abbe76e278a23c1b6502fcbc17122cc7b97ad78/How%20to%20manage%20subscription%20for%20a%20Jira%20Cloud%20app.png?cb=60d97effcff57909c3295d0b36ac06bd) 2. The Entitlement Number is displayed together with your Site URL ![How to find the Entitlement Number for a Jira Cloud app.png](/__attachments/a_7188160989c0f118462e08a2ab77e70e705ef7220be2837b967b6694b90a10f3/How%20to%20find%20the%20Entitlement%20Number%20for%20a%20Jira%20Cloud%20app.png?cb=29e504f54dc2b098d6d9bd554e7110bc) --- language: "en" --- # CVE-2021-44228 Marketplace Apps Tracking List ## Introduction This page summarises the official statement from various Marketplace app vendors in response to [CVE-2021-44228](https://nvd.nist.gov/vuln/detail/CVE-2021-44228) (Log4Shell) exploit. ## The Compiled List of Official Statements ### Apps that are not impacted ![check mark](https://docs.akeles.com/__attachments/a_8b8ed6a2b9a4d925d14c6dda1421f4aa63b0c16174722315c7f324c19160a577/atlassian-check_mark?cb=a10212e1c1021c5194f7535b6843f955) ![check mark](https://docs.akeles.com/__attachments/a_8b8ed6a2b9a4d925d14c6dda1421f4aa63b0c16174722315c7f324c19160a577/atlassian-check_mark?cb=a10212e1c1021c5194f7535b6843f955) ![check mark](https://docs.akeles.com/__attachments/a_8b8ed6a2b9a4d925d14c6dda1421f4aa63b0c16174722315c7f324c19160a577/atlassian-check_mark?cb=a10212e1c1021c5194f7535b6843f955) The following app publishers have stated that their apps are not affected by the vulnerability. Clicking on the Marketplace Publisher's name will bring you to their list of apps | **Marketplace Publisher** | **Webpage** | |-------------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------| | [Adaptavist](https://marketplace.atlassian.com/vendors/81/adaptavist) | [The Log4Shell vulnerability: here's what you need to do next](https://www.adaptavist.com/blog/the-log4shell-vulnerability-heres-what-you-need-to-do-next) | | [Akeles](https://marketplace.atlassian.com/vendors/105/akeles-consulting) | | | [Apwide](https://marketplace.atlassian.com/vendors/1211423/apwide) | | | [Decadis AG](https://marketplace.atlassian.com/vendors/1210905/decadis-ag) | | | [eazyBI](https://marketplace.atlassian.com/vendors/866502/eazybi) | | | [Elements](https://marketplace.atlassian.com/vendors/4952/elements) | | | [iDalko](https://marketplace.atlassian.com/vendors/22511/idalko) | | | [Midori Global Consulting Kft.](https://marketplace.atlassian.com/vendors/103/midori-global-consulting-kft) | | | [Redmoon Software Ltd](https://marketplace.atlassian.com/vendors/1210925/redmoon-software-ltd) | | | [//SEIBERT/MEDIA](https://marketplace.atlassian.com/vendors/9093/seibert-media) | | | [//SEIBERT/MEDIA - Draw.io](https://marketplace.atlassian.com/vendors/1210578/seibert-media-draw-io) | | | [The StarWare](https://marketplace.atlassian.com/vendors/1211057/the-starware) | | | [Utoolity](https://marketplace.atlassian.com/vendors/772927/utoolity) | | --- language: "en" --- # Our Security Philosophy ## Introduction We have been receiving a significant number of security questionaires from our users. We thought it will be good to share our thoughts and actions taken publicly. ![Our Security Philosophy.png](https://docs.akeles.com/__attachments/a_e1b975406900bfd41264604c20334431508622bef192d60303fca22b24d82449/Our%20Security%20Philosophy.png?cb=e1137e9d40878812573ab4162374f722) ### Security should not be compromised Security is a continuous race rather than a one-time effort. Prevention is better than cure. It takes more effort to fix security issues than to prevent them. * We have been integrating reasonable security practices in our design and development process * We have periodic security awareness reminders to our team because they are the best enforcement agents * We are participating in the [Atlassian Marketplace Security Bug Bounty Program](https://developer.atlassian.com/platform/marketplace/marketplace-security-bug-bounty-program/) * We are working to add our Cloud apps to the [Atlassian Cloud Fortified Apps Program](https://developer.atlassian.com/platform/marketplace/cloud-fortified-apps-program/) gradually * We have answered the questions in the [Privacy \& Security tab](https://developer.atlassian.com/platform/marketplace/security-privacy-tab/) in the marketplace listing * Atlassian is also performing [Security Scanning](https://developer.atlassian.com/platform/marketplace/security-scanning/) to identify security issues to be fixed in a timely manner * [Ecoscanner](https://developer.atlassian.com/platform/marketplace/ecoscanner/) * [Malware Scanner](https://developer.atlassian.com/platform/marketplace/malwarescanner/) * [Vulnerability Disclosure Program](https://developer.atlassian.com/platform/marketplace/vdp/) * [Marketplace Security Bug Bounty Program](https://developer.atlassian.com/platform/marketplace/marketplace-security-bug-bounty-program/) * [Security Scanner for Data Center apps](https://developer.atlassian.com/platform/marketplace/dc-apps-security-scanner/) #### Privacy is our priority We value everyone's privacy just like our privacy * We do not put customer logos on our website * We believe we can get credibility with over 9000+ installs for 35 apps in [Atlassian Marketplace](https://marketplace.atlassian.com/vendors/105/akeles-consulting) * We have been an Atlassian Partner since 2008 * We do not post photos of our employees on our social media * An example is we are using avatars in [Our Engineering Team](https://www.akeles.com/our-engineering-team/) on our website #### Security by Simplicity Security is a heavy responsibility and user data is a big liability. Even big companies with huge investments in security are being challenged from time to time. Since we want to be agile and focused on building useful software, we defined boundary markers for ourselves to keep things simple. * We try to keep our processes simple instead of having tons of lengthy policies that is difficult to regulate * We avoid liabilities and risks that is unnecessary and whenever possible * We do not have user analytics in our apps (both for Cloud and Data Center apps) * We do not build apps that process or store user data at our end * That is a key reason why some of our DC apps do not have a Cloud edition * Our Forge apps do not have data egress except for [Tissue for Jira Cloud](https://docs.akeles.com/tissuec/getting-started/egress-permissions-for-tissue-cloud.md) ![Akeles Forge apps.png](/__attachments/a_1b7813a829030b65921fe067e6f172ddcf87ab249f32f32ef2a5e5af1643c09d/Akeles%20Forge%20apps.png?cb=e6c9873e62d245ea52b0812be7738693) --- language: "en" --- # Service Level Agreement for Akeles apps ## Service Level Agreement Our goal is that all our customers are satisfied with our products. This Service Level Agreement is applicable for all the commercial apps (also known previously as add-ons or plugins) developed by Akeles and listed on [Atlassian Marketplace](https://marketplace.atlassian.com/vendors/105/akeles-consulting). Akeles will use reasonable effort to perform the Support in accordance with this SLA, but will not be responsible for delays caused by the Client or reasons beyond Akeles' control. ### Response Time We strive to respond to your support request within 24 business hours from the time of your initial request. #### Business Days/Hours Our business hours are Monday through Friday, 10am - 7pm [Singapore Time](https://www.timeanddate.com/worldclock/singapore) (SGT). We are based in Singapore, so we get a break on [Public Holidays of Singapore](http://www.officeholidays.com/countries/singapore/index.php). #### Support Channels You can request support through one of the following channels: * Submit a ticket through our [JIRA Service Desk](https://akeles.jira.com/servicedesk/customer/portal/1) () * Send an email to [help@akeles.com](mailto:help@akeles.com) We do encourage you to raise a ticket through our Service Desk. With more complete information provided, it will help us to understand your issue and respond faster. We currently do not provide phone support. #### Support Includes * Answering questions related to the Akeles apps * Functionality and Best Practices * Installation \& Upgrades * Usage and Configuration * Billing and Renewals * Help with troubleshooting problems with Akeles apps * Collecting feedback and feature requests (we do not guarantee that feature requests will be implemented) * Providing new version releases of the app (active maintenance is required for app updates) #### Support does not include * Phone support * Product training * Issues not related to an Akeles app or caused by underlying Confluence/JIRA issues * App versions that * have reached end of life * is not compatible with the version of Confluence/JIRA * Confluence/JIRA versions which * has not been formally released including Beta or Development releases * is no longer supported by Atlassian * is not supported by our add-ons * Customers who do not have a valid and current license or active subscription --- language: "en" --- # Table Custom Fields for Jira Home ![](https://docs.akeles.com/__attachments/a_4cb78201a90a090f206d0d4819140583b441dd01ed8e8bf44129a1e0c09932cf/table%20custom%20fields%20logo.png?cb=ab5c6ad553fdff60432c1e57d745f7a5) ## Overview *** ** * ** *** The Table Custom Fields plugin displays associated fields in a read-only table. Updates to the table custom fields are done via workflow post functions providing a customisable audit trail. ## Possible Use Cases *** ** * ** *** * **Approval Tracking** * Easy tracking instead of having to reconstruct the changes from the Change History tab. * **Audit Tracking** * Serves as an audit log as it is non-editable and the values populated automatically via workflow post functions. * **Baseline Tracking** * Capture snapshots of important fields at various state of the lifecycle. * **Grouping of related fields** * A great tool for consolidating since Jira only allows 1 custom field to be displayed per row and the date and user fields are placed in separate panels. ## Features *** ** * ** *** **Bird's eye view of associated fields** Associated fields can be consolidated into a single table with configurable columns. Segregate important details like approvals into a Table custom field for convenient viewing. ![Table Custom Fields highlight 1.png](https://docs.akeles.com/__attachments/a_e3e79c34d8890bb7a239bc074fd7270a58baa96edc88257e6087c2155de3cb38/Table%20Custom%20Fields%20highlight%201.png?cb=cadb3cb13f0ed15bfa4210cc72492aa1) **Automate updates with workflow post functions** Post functions are available to add/update/delete rows or clear the table entirely. Choose to update the top/bottom row with values from system fields, custom fields, current date time or current user. ![Table Custom Fields highlight 2.png](https://docs.akeles.com/__attachments/a_0533914bf3f92bc55964010ec57587963512ab3c1d89b3a9984800e3580bdb00/Table%20Custom%20Fields%20highlight%202.png?cb=23725b588bac7b31072e56ea482eb23f) ## User Guides *** ** * ** *** * [Supported Field Types](https://docs.akeles.com/tablecf/supported-field-types.md) [User Guide](https://docs.akeles.com/tablecf/user-guide.md) [How-To Articles](https://docs.akeles.com/tablecf/how-to-articles.md) [Release Notes](https://docs.akeles.com/tablecf/release-notes.md) * [Product Brochure](https://docs.akeles.com/tablecf/product-brochure.md) --- language: "en" --- # How-To Articles ## ![light bulb on](https://docs.akeles.com/__attachments/a_294fe0072dcd01a799e0f5499b7ca98c9bae40dc270ceeb20fe0af8f489753ce/atlassian-light_bulb_on?cb=485b9fcaee6e0d0eefa559cab514727e) Tips and Tricks * [How to increment counter](https://docs.akeles.com/tablecf/how-to-articles/how-to-increment-counter.md) * [How to track field changes](https://docs.akeles.com/tablecf/how-to-articles/how-to-track-field-changes.md) ### ![warning](https://docs.akeles.com/__attachments/a_73e5c2cc86450a88243d6493f96c718efd1aaf7180d1f9d4936511bf6b088fd6/atlassian-warning?cb=14432459925d605e05cae2605cdfe666) Troubleshoot * [Unable to get status after transition](https://docs.akeles.com/tablecf/how-to-articles/unable-to-get-status-after-transition.md) --- language: "en" --- # How to increment counter This can be used to: * Count the number of times an issue has been in each status (Status Count) * Count the number of times an issue went from status to status (Transition Count) You can increment or decrement a cell data in the table custom field by using the counter options **Counter (+1)** and **Counter (-1)**. For example, you can use it to count the number of bouncebacks for each phase. ![tablecf bouncebacks.png](https://docs.akeles.com/__attachments/a_0c561eeb7d9d1c6701e2c9cc9640381231592fa318172063f8eaebae51754340/tablecf%20bouncebacks.png?cb=880ac8a51674f807ac9a9b8dfdf5dcbf) For each backflow transition, select **Counter (+1)** for the corresponding phase to increment the cell data. ![tablecf post function counter options.png](https://docs.akeles.com/__attachments/a_1e10a6a090f44cc9d9410300eb87108c0551796e5db6e6417380cc9ca8435827/tablecf%20post%20function%20counter%20options.png?cb=2b92c6c98286eb7e589ab27824f6c80a) ![tablecf post function counting bouncebacks.png](https://docs.akeles.com/__attachments/a_17e9b5a3569618f84b25e82939a9d64849370f80b5d2788c70069e201348d2f9/tablecf%20post%20function%20counting%20bouncebacks.png?cb=9c1072484a12fab0e8ae36cd0c011dfa) --- language: "en" --- # How to search for table values ## Search for historical values Direct searching in table custom fields is currently not supported. However, since the table values are mostly populated with values from issue fields, you can make use of the `was` or `was in` operator to search. For example, the Escalation (Properties Table Custom Field) has the following row headings: * **Reason**: Comment * **Escalated by** : Current User (The user who transitioned issue to the Escalated status) * **Escalated on**: Current Date Time (When issue is escalated) * **Resolved by** : Current User (The user who transitioned issue to the Resolved status) * **Resolved on**: Current Date Time (When issue is resolved) To view the table for issues escalated by a specific user in a project, you can search for: project = AND status WAS Escalated BY Using the list view, you can quickly browse through the table custom field values: ![tablecf search historical values.png](https://docs.akeles.com/__attachments/a_6a12a221c966ebe671f1e4927d72c53cc402f3955df55581043e576a58484e95/tablecf%20search%20historical%20values.png?cb=5d03b9badb02fc8d233dea276954f8b1) Refer to [Advanced searching - operators reference](https://confluence.atlassian.com/jirasoftwareserver/advanced-searching-operators-reference-939938745.html) for more info. --- language: "en" --- # How to track field changes To ensure that all changes are tracked, the field should be: * Updated through transitions * Removed from the Edit Screen Tracking of field changes during a transition is possible with the before transition and after transition options. For example, you can track the changes made to the **Due Date**, who changed it, when and why was it changed. ![tablecf due date changes.png](https://docs.akeles.com/__attachments/a_b128cf4c79e63da20ef97f87f5302c508d231181121e88b182cbcebaa4748de5/tablecf%20due%20date%20changes.png?cb=75599dcd8509c5f4557a3d6532d84c8f) In the post function configuration, select **Due Date (Before Transition)** for Previous Due Date, and **Due Date (After Transition)** for New Due Date. ![tablecf before and after transition options.png](https://docs.akeles.com/__attachments/a_ff31f7032861dc95ef5df8a3d926a54a924d3f726065509480fd72c50b1f34cf/tablecf%20before%20and%20after%20transition%20options.png?cb=fbb0a98fbaaa59e5fadc30640087cd56) ![tablecf post function track due date changes.png](https://docs.akeles.com/__attachments/a_378796bc50b0084467a90c6463f25b36d66d3a9751ac269ee235486ac61c24c3/tablecf%20post%20function%20track%20due%20date%20changes.png?cb=930f08c4d7e7787a4c8e469145e26736) --- language: "en" --- # Unable to get status after transition ## Problem The table is populated with **status before transition** even though post function is configured with **status after transition** value. ![tablecf unable to get status after transition.png](https://docs.akeles.com/__attachments/a_4eec9c3ffbcca96b629eb94bc058fae48d451ab43f5354292adf581e3917fedd/tablecf%20unable%20to%20get%20status%20after%20transition.png?cb=e7bd4e91c9e8b2398b82a94921fd8e12) ### Troubleshoot Please check that the table custom field post function is placed **after** the "Set issue status to the linked status of the destination workflow step" post function. ![tablecf post function ordering for status after transition.png](https://docs.akeles.com/__attachments/a_88e886ef4e9f06a26ee39e9bf71b0a1e678e3204bde7fb19d5ef6598b036a434/tablecf%20post%20function%20ordering%20for%20status%20after%20transition.png?cb=c768c5f3e18ff592594b1303c3e1703c) --- language: "en" --- # Product Brochure You can download a copy at [here](https://docs.akeles.com/__attachments/a_30c2c2a22f839e59cf500dadb9d5ecbb4e1c9aaacd5b4de840ae68aa307988ab/Table%2520Custom%2520Fields%2520Brochure.pdf.md?cb=a92c3318ad330a713b71a84608429b88). --- language: "en" --- # Release Notes * [Release Notes for 2.4.0](https://docs.akeles.com/tablecf/release-notes/release-notes-for-2-4-0.md) * [Release Notes for 2.3.0](https://docs.akeles.com/tablecf/release-notes/release-notes-for-2-3-0.md) * [Release Notes for 1.3.0/2.2.0](https://docs.akeles.com/tablecf/release-notes/release-notes-for-1-3-0-2-2-0.md) * [Release Notes for 1.2.0/2.1.0](https://docs.akeles.com/tablecf/release-notes/release-notes-for-1-2-0-2-1-0.md) * [Release Notes for 1.1.0](https://docs.akeles.com/tablecf/release-notes/release-notes-for-1-1-0.md) * [Release Notes for 1.0.0](https://docs.akeles.com/tablecf/release-notes/release-notes-for-1-0-0.md) * [Release Notes for 2.5.0](https://docs.akeles.com/tablecf/release-notes/release-notes-for-2-5-0.md) * [Release Notes for 2.7.0](https://docs.akeles.com/tablecf/release-notes/release-notes-for-2-7-0.md) * [Release Notes for 2.8.0](https://docs.akeles.com/tablecf/release-notes/release-notes-for-2-8-0.md) * [Release Notes for 3.0.0](https://docs.akeles.com/tablecf/release-notes/release-notes-for-3-0-0.md) --- language: "en" --- # Release Notes for 1.0.0 In this release, we will be introducing ## New features *** ** * ** *** ### 1. Support for Jira Service Desk Customer Portal The Table Custom Field can now be added to the Customer Portal. To do that, you simply have to add the field to the **Create Screen**, and you will be able to add it to the portal (Request types). | Agent View | Portal View | |-------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------| | ![Agent View.jpeg](https://docs.akeles.com/__attachments/a_db27febfec8a324286cc8cbcdb8d46a8318e96f49be5ccb78a71839bb8facbe2/Agent%20View.jpeg?cb=46d1114f2438c0237b0047908d62febf) | ![Portal View.jpeg](https://docs.akeles.com/__attachments/a_2e745cc7eeb94772cf49c42f64182425d134fda79314efa3ab401f19bafd7282/Portal%20View.jpeg?cb=df4b2e585b42ce519bacfd5a5a40163b) | However, adding the Table Custom Field as a **visible field** to a request type would mean that it would also be visible when creating requests from the portal. As the Table Custom Field is meant to be a non-editable field, to prevent uses to enter any values, you can use the [Extension for Jira Service Desk](https://marketplace.atlassian.com/plugins/com.intenso.jira.plugins.jsd-extender/server/overview), which allows you to hide custom fields from the portal's Create Screen. ### 2. Three new workflow post functions You can update the Table Custom Field by performing the following actions based on the selected key columns. #### **a. Populate row with key** If a matching row is found, it will be updated with the new values. Else, a new row will be added to either the top or bottom of the table. For example, you can choose to update the **Effort** of a row where **Department column value** matches the **Department field** and the **User column value** matches the **current user**. |-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | ![Table custom field workflow populate with key.png](https://docs.akeles.com/__attachments/a_a687e8d544b35074f7df8db668eee52c8cefbe87c0ea6f752eeb08fb0287a2b4/Table%20custom%20field%20workflow%20populate%20with%20key.png?cb=4c1002baee8a616ecf14107a0a949f6c) | #### **b. Delete an existing row with key** If a matching row is found, it will be deleted. Else, nothing will happen. For example, you can choose to delete the row where **Department column value** matches the **Department field** and the **User column value** matches the **current user**. |---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | ![Table custom field workflow delete with key.png](https://docs.akeles.com/__attachments/a_4d93364abb2d55e498ed2e1c4ddfe5912afd34481eb8727747030015754d8219/Table%20custom%20field%20workflow%20delete%20with%20key.png?cb=d45d6f7bda9ca1ea5508accffed9b7f2) | #### **c. Sort table** In some cases, you may wish to sort the table by certain columns. This can be achieved by simply selecting the columns you wish to sort by. For example, if you would like to view table entries of certain users in chronological order, you may choose to sort by **User** , then **Timestamp**. |-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | ![Table custom field workflow sort.png](https://docs.akeles.com/__attachments/a_90e424f3d19f53fbaa24b1a51381ae002f637ae1229119caead8709e1f8eff1a/Table%20custom%20field%20workflow%20sort.png?cb=aefffff3be56d507f4ae94bf7220a5d5) | If DateTime does not follow the following formats below, the data will not be treated as a date and will be placed in the last/bottom row * d/MMM/yy * dd/MMM/yy h:mm a * dd/MM/yyyy HH:mm:ss ### 3. Compatibility with Jira Data Center The app is now compatible with Jira Data Center too. ## Improvements *** ** * ** *** ### Preview of Table Custom Field in Configuration page To give a better visualisation of the Table Custom Field, we have changed the Column Names from **point form** to a **table** as shown below. | Before | After | |-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | ![table custom field column names preview (before).png](https://docs.akeles.com/__attachments/a_be542a2e7c7567bb6ad6a78e2d436608027f1a80cbb9c9571c6f0c0b579c93e8/table%20custom%20field%20column%20names%20preview%20(before).png?cb=82c36e4f11c215f0cb16ffca48690a61) | ![table custom field column names preview.png](https://docs.akeles.com/__attachments/a_61449a481f80e69a936c79a429b764566845230782125eae0c0b6d069fb4126f/table%20custom%20field%20column%20names%20preview.png?cb=43952f81d325556cb800fe6a47e73d93) | ### Support Selection of Customs Fields for Column Values You can now add Custom Field values into the Table custom fields. Here is a list of custom field types supported: * Checkboxes * Date pickers * Date time pickers * Number Fields * Radio Buttons * Select lists * [Scripted-field](https://marketplace.atlassian.com/plugins/com.onresolve.jira.groovy.groovyrunner/cloud/overview) * Text fields * URL fields * User pickers ## Bug fixes *** ** * ** *** ### 'Undefined' column name entry Fixed the 'Undefined' column name that appears when you delete all column names and click Save. ### Table purged when issue is edited Fixed the table value being purged when the issue is edited. This happens only if the Table Custom Field is placed in **Edit Screen**. ## Issues Fixed *** ** * ** *** | T | Key | Summary | Status | Resolution | |---|-----|---------|--------|------------| | Data cannot be retrieved due to an unexpected error. [View these issues in Jira](https://akeles.jira.com/issues/?jql=project+%3D+TABLECF+AND+fixVersion+%3D+1.0.0+order+by+issuetype%2C+key++&src=confmacro) ||||| *** ** * ** *** --- language: "en" --- # Release Notes for 1.1.0 ## Summary *** ** * ** *** ## New Features *** ** * ** *** ### Properties Table Custom Field A new custom field with configurable row headings has been added. ![properties table example.png](https://docs.akeles.com/__attachments/a_32d1ca23323010bd1a13f60d2c93118713e275ded87eebdf9786eab48313663f/properties%20table%20example.png?cb=efb24671c632c7ca4f29bed91f846354) The following actions are available for the **post function**: * Update table -- updates/overwrites the entire table. * Purge table -- purge the entire table. Refer to [How to configure Properties Table Custom Field post function](https://docs.akeles.com/tablecf/user-guide/how-to-configure-properties-table-custom-field-pos.md) for more information. ## Enhancements *** ** * ** *** ### Support for attachments value Attachments with special characters such as '@', '$' and '\&' are not supported for attachment link \[\^attachment.ext\] If attachments are found attached to the transition screen, they will be added/updated into the table as an **attachment link** in a bullet list. | Custom Field | Action | Option Supported | |-------------------------------|-----------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------| | Table Custom Field | Add a new row | ![check mark](https://docs.akeles.com/__attachments/a_8b8ed6a2b9a4d925d14c6dda1421f4aa63b0c16174722315c7f324c19160a577/atlassian-check_mark?cb=a10212e1c1021c5194f7535b6843f955) | | Table Custom Field | Update an existing row | ![check mark](https://docs.akeles.com/__attachments/a_8b8ed6a2b9a4d925d14c6dda1421f4aa63b0c16174722315c7f324c19160a577/atlassian-check_mark?cb=a10212e1c1021c5194f7535b6843f955) | | Table Custom Field | Populate an existing row with key | ![check mark](https://docs.akeles.com/__attachments/a_8b8ed6a2b9a4d925d14c6dda1421f4aa63b0c16174722315c7f324c19160a577/atlassian-check_mark?cb=a10212e1c1021c5194f7535b6843f955) | | Table Custom Field | Delete an existing row | | | Table Custom Field | Delete an existing row with key | | | Table Custom Field | Purge table | | | Table Custom Field | Sort table | | | Properties Table Custom Field | Update table | ![check mark](https://docs.akeles.com/__attachments/a_8b8ed6a2b9a4d925d14c6dda1421f4aa63b0c16174722315c7f324c19160a577/atlassian-check_mark?cb=a10212e1c1021c5194f7535b6843f955) | | Properties Table Custom Field | Purge table | | ### Support for string value A string value can now be specified in the workflow post function configuration. ![post function string value.png](https://docs.akeles.com/__attachments/a_57b3e779be0717c1ac8a0db29893227134e4a242a218a0b2487fbb3976bb1b29/post%20function%20string%20value.png?cb=028179656eb1fe919c00a0e040746384) | Custom Field | Action | Option Supported | |-------------------------------|-----------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------| | Table Custom Field | Add a new row | ![check mark](https://docs.akeles.com/__attachments/a_8b8ed6a2b9a4d925d14c6dda1421f4aa63b0c16174722315c7f324c19160a577/atlassian-check_mark?cb=a10212e1c1021c5194f7535b6843f955) | | Table Custom Field | Update an existing row | ![check mark](https://docs.akeles.com/__attachments/a_8b8ed6a2b9a4d925d14c6dda1421f4aa63b0c16174722315c7f324c19160a577/atlassian-check_mark?cb=a10212e1c1021c5194f7535b6843f955) | | Table Custom Field | Populate an existing row with key | ![check mark](https://docs.akeles.com/__attachments/a_8b8ed6a2b9a4d925d14c6dda1421f4aa63b0c16174722315c7f324c19160a577/atlassian-check_mark?cb=a10212e1c1021c5194f7535b6843f955) | | Table Custom Field | Delete an existing row | ![check mark](https://docs.akeles.com/__attachments/a_8b8ed6a2b9a4d925d14c6dda1421f4aa63b0c16174722315c7f324c19160a577/atlassian-check_mark?cb=a10212e1c1021c5194f7535b6843f955) | | Table Custom Field | Delete an existing row with key | | | Table Custom Field | Purge table | | | Table Custom Field | Sort table | | | Properties Table Custom Field | Update table | ![check mark](https://docs.akeles.com/__attachments/a_8b8ed6a2b9a4d925d14c6dda1421f4aa63b0c16174722315c7f324c19160a577/atlassian-check_mark?cb=a10212e1c1021c5194f7535b6843f955) | | Properties Table Custom Field | Purge table | | ### Immediate update of column/row headings The update of column/row headings are now immediate. Entries can also be updated, instead of having to delete and re-add. In previous versions, you have to click on the **Save** button in order to save the changes made. ## Issues Resolved *** ** * ** *** | Key | Summary | T | Status | Resolution | |-----|---------|---|--------|------------| | Data cannot be retrieved due to an unexpected error. [View these issues in Jira](https://akeles.jira.com/issues/?jql=project+%3D+tablecf+and+fixVersion+%3D+1.1.0++&src=confmacro) ||||| --- language: "en" --- # Release Notes for 1.2.0/2.1.0 ## Summary *** ** * ** *** ## New Features ### Support for values before/after transition You can now select whether to populate the table with values **before** or **after** the transition. This allows you to show the changes made to a field during a transition. For example, to show the changes made to the Due Date in a row, select **Due Date (Before Transition)** for a column and **Due Date (After Transition)** for another. ![tablecf post function edit before after transition.png](https://docs.akeles.com/__attachments/a_c336568a71cdb536baf8bd8faa1e06a0a4fa059392bcd80aab7493d81daca7cf/tablecf%20post%20function%20edit%20before%20after%20transition.png?cb=2db31430e0710443984a1c229fa8eace) ![tablecf post function view before after transition.png](https://docs.akeles.com/__attachments/a_509caee45c49652908c49210b40b39b0f0c7c8b86e90fb8b971e8ff61d60ae55/tablecf%20post%20function%20view%20before%20after%20transition.png?cb=6f7a3550c1d8f572bc8bd10bb8aec95b) This option is **not** applicable for the following values: * Attachment * Blank * Comment * Current Date Time * Current User * No Change * String For **Status (After Transition)** , the table custom field post function has to be after the "Set issue status to the linked status of the destination workflow step." post function. ### Added system date fields You can now populate the table with the following date fields: * Created * Updated * Due Date * Resolved *** ** * ** *** ## Bug Fix ### Unable to configure post function After configuring the column headings, "No columns configured" is displayed when adding a post function, thus, unable to proceed with configuring the post function. *** ** * ** *** ## Issues | Key | Summary | T | Status | Resolution | |-----|---------|---|--------|------------| | Data cannot be retrieved due to an unexpected error. [View these issues in Jira](https://akeles.jira.com/issues/?jql=project+%3D+tablecf+and+fixVersion+in+%281.2.0%2C+2.1.0%29++&src=confmacro) ||||| --- language: "en" --- # Release Notes for 1.3.0/2.2.0 For Jira 8, please use version 2.2.0. For Jira 7, please use version 1.3.0. We are currently preparing for a Data Center approved version and we intend to release it soon. ## Summary *** ** * ** *** ## New Feature ### Support for Counter You can now increment or decrement a cell data in the table by using the counter options: **Counter (+1)** and **Counter (-1)** This can be used to: * Count the number of times an issue has been in each status (Status Count) * Count the number of times an issue went from status to status (Transition Count) For example, you can use it to count the number of rework for an issue. ![tablecf rework count table.png](https://docs.akeles.com/__attachments/a_281d932ec9e840fb1bc71d36da85edb424efd40455ad2c78c3ad83665f1e1655/tablecf%20rework%20count%20table.png?cb=cbd3e86c033de638b301b31aa7b3b5e1) Select **Counter (+1)** as the value for **Rework Count** in the post function for **Send for Rework** transition. ![tablecf workflow transition for rework count.png](https://docs.akeles.com/__attachments/a_1bb3be2bdd0592dd3803fbd0c60df55d7cd714704098925252ff601b8a40df93/tablecf%20workflow%20transition%20for%20rework%20count.png?cb=307283bbb65a9658c1eb92148decf068) ![tablecf post function counter.png](https://docs.akeles.com/__attachments/a_9afae89b929f51259b554e9f98ff5037eb22c865aba8117614a66da8ccb99a2a/tablecf%20post%20function%20counter.png?cb=83e8149030d8b97d61bdc619c8d368db) *** ** * ** *** ## Issues | Key | Summary | T | P | Status | Resolution | Affected Versions | |-----|---------|---|---|--------|------------|-------------------| | Data cannot be retrieved due to an unexpected error. [View these issues in Jira](https://akeles.jira.com/issues/?jql=project+%3D+tablecf+and+fixVersion+in+%281.3.0%2C+2.2.0%29+&src=confmacro) ||||||| --- language: "en" --- # Release Notes for 2.3.0 ## Summary *** ** * ** *** ## New Features ### Data Center approved Table Custom Fields for Jira is now Data Center approved! 🥳 ### Support Description field and multi-line text custom fields You can now populate the table with values from: * Description field * Text Field (multi-line) custom fields ![text field multi-line type.png](https://docs.akeles.com/__attachments/a_36a837aea4832fba5261c2930c50aa0c512aaaa981913e0d41433ea6a4313d58/text%20field%20multi-line%20type.png?cb=2b20904dbd60839c025f7cc64f94d515) *** ** * ** *** ## Bug Fixes ### Table overflow if table is too long Scrollbar will be added when table is too long. | **Before** | **After** | |---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | ![tablecf overflow before.png](https://docs.akeles.com/__attachments/a_ab55c9c714dac7700d00e63181cddae0c1971d06219b9449276438eff97677a8/tablecf%20overflow%20before.png?cb=1054dc795b14bce18a8ceacb7e8b9f7b) | ![tablecf overflow after.png](https://docs.akeles.com/__attachments/a_64b018cf00a30cea7f8f67d144faa0ace1345bf5eb0e52100939d6fcaa3dc54d/tablecf%20overflow%20after.png?cb=ffce989645b708f26048641ae5bd296e) | ### Large dropdown arrows on multi-select field This happens in newer versions of Jira 8. | **Before** | **After** | |-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | ![tablecf multi-select before.png](https://docs.akeles.com/__attachments/a_0b9da88b640bb8cb5aecb5be1e69c23b9c62752b239f2b86a439c92de8a1a47f/tablecf%20multi-select%20before.png?cb=eee8f3bb7b9ab9693c44b982904197dd) | ![tablecf multi-select after.png](https://docs.akeles.com/__attachments/a_c53c691f5c5cac4969f1496b00bea590e0b8ae6a8b02eb5cdd81487b891592e7/tablecf%20multi-select%20after.png?cb=6de0672066e4a76dfa59d045af687bbb) | ### Timeout when adding table custom fields Table custom field is successfully added but the following error message is displayed: The call to the Jira server did not complete within the timeout period. We are unsure of the result of this operation. This happens in large instance with many field configurations. ### JSONException in logs when adding custom field via rest api This happens if request data is not in a single line. For example: curl -D- -u username:password -X POST -H "Content-Type: application/json" \ --data '{ "name": "My Table", "type": "com.akeles.jira.plugins.TableCustomFields:table-custom-field" }' \ http:///rest/api/2/field *** ** * ** *** ## Issues | Key | Summary | T | Status | Resolution | |-----|---------|---|--------|------------| | Data cannot be retrieved due to an unexpected error. [View these issues in Jira](https://akeles.jira.com/issues/?jql=project+%3D+tablecf+and+fixVersion+%3D+2.3.0+&src=confmacro) ||||| --- language: "en" --- # Release Notes for 2.4.0 ## Summary *** ** * ** *** ## New Feature ### Support for automation You can now update table custom fields using automation. #### **Automation for Jira** Check out [How to update table using Automation for Jira](https://docs.akeles.com/tablecf/user-guide/how-to-update-table-using-automation-for-jira.md) for more details. ![tablecf automation for jira.png](https://docs.akeles.com/__attachments/a_8fbb8abaf4eb1c1a9b7677fa35f16ee31b6c0b8ed28d8a77fd8b5b2687dfff72/tablecf%20automation%20for%20jira.png?cb=a05cf0882d40d4189ecac2569a79dfa8) #### **Jira Service Management Automation** Check out [How to update table using JSM Automation](https://docs.akeles.com/tablecf/user-guide/how-to-update-table-using-jira-service-management-.md) for more details. ![tablecf jsm automation.png](https://docs.akeles.com/__attachments/a_1dfcce2027326967567ecb30535e0e5013bacdef93eb4abda6fc4b0544683bd2/tablecf%20jsm%20automation.png?cb=e92f32ccd7b3a9714772527396c9a1ff) *** ** * ** *** ## Bug Fix ### JSONException in logs when getting custom field via rest api Sample: 2021-11-03 11:31:21,373 http-nio-2990-exec-5 DEBUG admin 691x11707x2 lj3u6t 0:0:0:0:0:0:0:1 /rest/api/2/field [c.a.j.plugins.filter.TableServletFilter] *** Table filter start *** 2021-11-03 11:31:21,377 http-nio-2990-exec-5 DEBUG admin 691x11707x2 lj3u6t 0:0:0:0:0:0:0:1 /rest/api/2/field [c.a.j.plugins.filter.TableServletFilter] Custom field added! 2021-11-03 11:31:21,377 http-nio-2990-exec-5 DEBUG admin 691x11707x2 lj3u6t 0:0:0:0:0:0:0:1 /rest/api/2/field [c.a.j.plugins.filter.TableServletFilter] Processing custom field added request 2021-11-03 11:31:21,377 http-nio-2990-exec-5 DEBUG admin 691x11707x2 lj3u6t 0:0:0:0:0:0:0:1 /rest/api/2/field [c.a.j.plugins.filter.TableServletFilter] Data [] 2021-11-03 11:31:21,377 http-nio-2990-exec-5 ERROR admin 691x11707x2 lj3u6t 0:0:0:0:0:0:0:1 /rest/api/2/field [c.a.j.plugins.filter.TableServletFilter] Error getting request body as json com.atlassian.jira.util.json.JSONException: A JSONObject text must begin with '{' at character 0 of at com.atlassian.jira.util.json.JSONTokener.syntaxError(JSONTokener.java:443) at com.atlassian.jira.util.json.JSONObject.(JSONObject.java:186) at com.atlassian.jira.util.json.JSONObject.(JSONObject.java:328) at com.akeles.jira.plugins.filter.TableServletFilter.b(SourceFile:230) at com.akeles.jira.plugins.filter.TableServletFilter.a(SourceFile:195) at com.akeles.jira.plugins.filter.TableServletFilter.doFilter(SourceFile:105) ... 3 filtered *** ** * ** *** ## Issues | Key | Summary | T | P | Status | Resolution | Affected Versions | |-----|---------|---|---|--------|------------|-------------------| | Data cannot be retrieved due to an unexpected error. [View these issues in Jira](https://akeles.jira.com/issues/?jql=project+%3D+tablecf+and+fixVersion+%3D+2.4.0++&src=confmacro) ||||||| --- language: "en" --- # Release Notes for 2.5.0 ## Compatibility with Jira 9 Table Custom Fields for Jira is now compatible with Jira 9! 😀 Kindly [let us know](https://akeles.jira.com/servicedesk/customer/portal/1/group/1/create/8) if you encounter any issues, thank you! *** ** * ** *** | Key | Summary | T | P | Status | Resolution | |-----|---------|---|---|--------|------------| | Data cannot be retrieved due to an unexpected error. [View these issues in Jira](https://akeles.jira.com/issues/?jql=project+%3D+tablecf+and+fixVersion+%3D+2.5.0+&src=confmacro) |||||| --- language: "en" --- # Release Notes for 2.7.0 ## Improvement ### Compatibility with Jira 10 This version includes changes for compatibility with Jira 10. Please [let us know](https://akeles.jira.com/servicedesk/customer/portal/1/group/1/create/8) if you encounter any issues. Thank you! *** ** * ** *** ## Issue resolved | **Issue Type** | **Issue Key** | **Summary** | |----------------|---------------------------------------------------------|----------------------------| | Improvement | [TABLECF-43](https://akeles.jira.com/browse/TABLECF-43) | Compatibility with Jira 10 | [Next Page](https://docs.akeles.com/llms-full.txt/1)