After the move to al, there is no use for the C/AL Open Library any longer. Any code contributions to Business Central should be delivered through the AlAppExtensions repository instead. Please also register any issues with extensibility you may have in the new repository. Thank you for your contributions to the C/AL Open Library throughout its existance. We're looking forward to seeing your contributions in the AlAppExtensions repository going forward.
C/AL Open Library
The purpose of this repository is to build a C/AL library based on community contributions that will serve as an accelerator for adoption of the Extensions V2 technology. The source code from this library will be included in the base application of 'Dynamics 365 Business Central' on a monthly basis.
The primary goal is to enable creation of .NET type wrappers written in C/AL that can then be subsequently used from Extensions V2. DotNet types must not be part of the definition of public functions in the submitted code to be callable by Extensions V2.
All contributions will be reviewed by Microsoft and assessed for the overall fit into the product, for reusability and for following the general coding style that is present in the other base application objects.
Process
Make the Pull Requests granular. Don't bundle together many different requests.
Code for this library should be written using the existing development environment (C/SIDE).
Object IDs should be created within the range 50K-99K.
In general we only accept codeunit objects. If you have a strong reason for another object type it is recommended to discuss it with Microsoft through an Issue first, before submitting the code.
All code needs to be submitted with accompanying unit tests.
Microsoft will review the contribution and decide whether it wants to make it part of the product.
If the contribution is accepted Microsoft will modify the object IDs to fit within the base Microsoft range and apply any code fixes resulting from internal best practice checks.
The code will be included in the next monthly update that is shipped after the contribution was accepted.
Add the dotnet assembly as a global, prefix the name with DotNet
There should be only 1 global
The signature of every function should match the signature of the corresponding .NET method
Exception: Return values can be VAR parameters.
You cannot not take a dependency on the BaseApp
i.e. The 3000 range must be compilable in a new empty database
Don't add helpers to the wrappers. Isolate type helper functions in codeunits of their own.
Small helpers can be added in the 3750..3999 range. These should not be large functions with logic but rather small helpers that make it easier to use the wrapper functions. Logic should be placed in normal BaseApp as usual.
Add a Get(dotnet)
This is a global function
This is NEVER an external function
It has 1 parameter
Has the same name as the global but with a '2' appended
Is a VAR
Add a Set(dotnet)
This is a global function
This is NEVER an external function
It has 1 parameter
Has the same name as the global but with a '2' appended
Is a VAR
All functions in the wrapper are global
If a function is SAFE, it is made External
The same rules apply for internal/external as for everything else
The internal/external is meant to protect tenants from each other
The internal/external is meant to protect our service
No file access is allowed!
Except for the Get and Set functions, no dotnet is allowed as parameters
If a function requires a dotnet parameter:
the dotnet variable is added as a local
The wrapper for the dotnet is added as a parameter (i.e. codeunit parameter)
The dotnet variable is retrieved from the the codeunit parameter by using the Get method
If a function returns a dotnet variable:
The dotnet variable is added as a local
The wrapper for the dotnet is added as a VAR parameter
The dotnet variable is set in the wrapper by using the Set method.
Contributing
This project welcomes contributions and suggestions. Most contributions require you to agree to a
Contributor License Agreement (CLA) declaring that you have the right to, and actually do, grant us
the rights to use your contribution. For details, visit https://cla.microsoft.com.
When you submit a pull request, a CLA-bot will automatically determine whether you need to provide
a CLA and decorate the PR appropriately (e.g., label, comment). Simply follow the instructions
provided by the bot. You will only need to do this once across all repos using our CLA.
请发表评论