Skip to content

Commit

Permalink
New version & update documentation
Browse files Browse the repository at this point in the history
  • Loading branch information
TKapitan committed Mar 13, 2021
1 parent aefd2fb commit 05c7cd7
Show file tree
Hide file tree
Showing 4 changed files with 35 additions and 6 deletions.
2 changes: 1 addition & 1 deletion App/app.json
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
"id": "387c89df-1def-40e2-8953-e467ea2a15dc",
"name": "AL ID Range Manager",
"publisher": "ART AA AE from Czechia + Kepty.cz",
"version": "0.1.0.0",
"version": "0.1.1.0",
"brief": "Manage object IDs in of your AL projects using combination of VS Code extension and this Business Central extension.",
"description": "Manage object IDs in of your AL projects using combination of VS Code extension and this Business Central extension.",
"privacyStatement": "https://github.com/TKapitan/ALRM-BusinessCentral/blob/Kepty/LICENSE.md",
Expand Down
32 changes: 29 additions & 3 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,16 +4,42 @@

- Enhance UI (Navigation, Structure of cards)
- Test "Range per BC Instance"
- Option "Default" in Assignable Range Header has no functionality
- Add validation for changing existing extensions
- Add validation for changing existing assignable ranges field ranges
- Add option to set assignable ranges to "re-use" gaps in object & field IDs
- Add support for extension synchronization using API
- Remove existing object line
- Register object line (table/enum extension field) with specific ID
- Remove object line (table/enum extension field) with specific ID
- Remove object line (table/enum extension field) with specific ID

## [Released Versions]

### v0.1.1.0

- Date of release 12/03/2021

Major changes

- New setting on assignalbe range: "Fill Object ID Gaps"
- If set to true, the system tries to find gaps in assigned objects. If there is a gap in corresponsing ID range, system use the ID for newly created object.
- It is possible to set it on the header and lines, the header is for default ranges and the setting in lines is only for the range specified in the line.
- The process may have impact on performance of assigning new objects (however, should still be ok).
- New supported object types: PageCustomization, Profile
- New supported runtime: Business Central 2021 W1
- New supported object types: ReportExtension, PermissionSet, PermissionSetExtension, Entitlement
- New API method for consuming by VS Code Extension
- Microsoft.NAV.createObjectFieldOrValue for obtaining field IDs in "ALRM: New object extension field or value" command. Replace old command Microsoft.NAV.createObjectLine that is not called anymore).
- Microsoft.NAV.createObjectFieldOrValueWithOwnID for registering existing fields (with already assigned field/value ID) using "ALRM: Synchronize (beta)" command.
- Microsoft.NAV.createObjectWithOwnID for registering existing objects (with already assigned object ID) using "ALRM: Synchronize (beta)" command.

Other changes

- CreateObjectLine API replaced by CreateObjectFieldOrValue, Obsolete('Replaced by CreateObjectFieldOrValue(), will be removed 2021/04.')
- Created By field in Extension Object Line table (filled by user who create the record directly in BC or username provided using APIs method).
- ID to Extension Object Line record is assigned OnInsert (previously OnValidate of Extension Object ID).
- Some error messages were improved to be more readable/usable.
- It is possible to register also field/value names through UI or API (no additional functionality or validation)
- Code maintenance

### v0.1.0.0

- Date of release 15/01/2021
Expand Down
3 changes: 3 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,6 +12,7 @@ The core of the extension are "Assignable Ranges" that manage all available rang

The assignable range has two primary parts - header and lines. In the header, you can also define

- "Fill Object ID Gaps": If set to true, the system tries to find gaps in assigned objects. If there is a gap in corresponsing ID range, system use the ID for newly created object. It is possible to set it on the header and lines, the header is for default ranges and the setting in lines is only for the range specified in the line. The process may have impact on performance of assigning new objects (however, should still be ok).
- "Default Object Range From" / "To": This range is used to assign IDs to all types of objects except those defined specifically in lines (with their own range).
- "Default Field Range From" / "To": This range is used to assign IDs to all fields created in EnumExtensions and TableExtensions.
- "Ranges per BC Instance": This value specifies, whether the object ID is used only once (when this field is set to false) even if two extensions are used for different BC instances. If this field is set to true, IDs are assigning uniquelly only by checking extensions installed to the same BC instance. This value is especially useful for standard Customer range (50000 - 99999) when you can set it only once and then reuse objects for each customer extension (and for each customer start assigning always from the initial ID).
Expand Down Expand Up @@ -61,6 +62,8 @@ To use the extension in the combination with ALRM VS Code extension (<https://gi
- Setting "Range per BC Instance" is not properly tested
- Field Ranges in Assignable Ranges are not tested on change whether the old IDs are not already in use

For list of minor issues and upcoming changes see <https://github.com/TKapitan/ALRM-BusinessCentral/blob/master/CHANGELOG.md#unreleased>

## Release Notes

See [changelog](https://github.com/TKapitan/ALRM-BusinessCentral/blob/master/CHANGELOG.md)
4 changes: 2 additions & 2 deletions Test/app.json
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
"id": "c3f20afb-35e2-4476-a163-072b5141f028",
"name": "AL ID Range Manager - tests",
"publisher": "ART AA AE from Czechia + Kepty.cz",
"version": "0.1.0.0",
"version": "0.1.1.0",
"brief": "Manage object IDs in of your AL projects using combination of VS Code extension and this Business Central extension.",
"description": "Manage object IDs in of your AL projects using combination of VS Code extension and this Business Central extension.",
"privacyStatement": "https://github.com/TKapitan/ALRM-BusinessCentral/blob/Kepty/LICENSE.md",
Expand All @@ -15,7 +15,7 @@
"id": "387c89df-1def-40e2-8953-e467ea2a15dc",
"publisher": "ART AA AE from Czechia + Kepty.cz",
"name": "AL ID Range Manager",
"version": "0.1.0.0"
"version": "0.1.1.0"
},
{
"id": "dd0be2ea-f733-4d65-bb34-a28f4624fb14",
Expand Down

0 comments on commit 05c7cd7

Please sign in to comment.