Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

New System App Module for easy file systems access #663

Merged
merged 62 commits into from
Dec 20, 2024

Conversation

IceOnly
Copy link
Contributor

@IceOnly IceOnly commented Feb 29, 2024

Migration of microsoft/ALAppExtensions#23225

Now that we have made several clients Universal code ready.
One of the main problems turned out to be the replacement of the file record and the file object (File.Create, File.Exists).
Some of our customers now use Azure Blob Service from the System app. Others don't have a good internet and now use a local microservice with REST API, others use Azure File Shares.
The problem is that every integration is different. I think many other partners will have the same problem.
To simplify access I have adopted the email module and created new file accounts.
With just one codeunit, a developer can now connect to various file services without having to know how they actually work. The code unit "File System" delviers everything taht is needed.

An additional PR contains three connector apps:
microsoft/ALAppExtensions#23225

This Apps will conenct:

  • Azure Blob Storage
  • Azure File Share
  • SharePoint Online

All three service can be access over one unified interface!

New provider in the future could be:

  • a OneDrive Provider
  • Third Party file services

An example that shows how simple it is to use the new modules can be found here:
https://github.com/IceOnly/BC_FileSystem_Example

But before I go round the whole thing, I'm interested in whether there is any interest in the module at all.

Here are some Screenshots:
image
image
image
image
image
image

I have decided in favour of some restrictions. Paths must not start with a /. The only supported path separator is /. If services that require a \ are to be connected, this must be translated by the connector app.

These restrictions should ensure that the file service can be exchanged without upgrading data.

Assigned Workitems:
Fixes #2418
Fixes AB#559148

Copy link
Contributor

@JesperSchulz JesperSchulz left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This PR needs some work before the real code review can conducted.

@IceOnly IceOnly marked this pull request as draft February 29, 2024 13:40
@JesperSchulz JesperSchulz changed the title New System App Module for easy file systems access [DRAFT] New System App Module for easy file systems access Feb 29, 2024
@IceOnly IceOnly marked this pull request as ready for review March 1, 2024 15:08
@IceOnly IceOnly requested a review from JesperSchulz March 1, 2024 15:08
@IceOnly IceOnly changed the title [DRAFT] New System App Module for easy file systems access New System App Module for easy file systems access Mar 1, 2024
JesperSchulz
JesperSchulz previously approved these changes Dec 18, 2024
Copy link
Contributor

@JesperSchulz JesperSchulz left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I'm happy with the state of this PR. Now we just need one more from the product group to be happy 😊

JesperSchulz
JesperSchulz previously approved these changes Dec 18, 2024
Copy link
Contributor

@darjoo darjoo left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Just the permission fix, otherwise all good.

@StefanMaron
Copy link
Contributor

Sorry to do nit picking here, but there is one last thing I want to bring up once more.

Usage of temporary in variable declarations. I dont care if its used or not if a table has TableType = temporary but if its used, it should be done on all variable declarations, in this PR its not
image
image

IMHO its just inconsistent coding.

@IceOnly
Copy link
Contributor Author

IceOnly commented Dec 19, 2024

Sorry to do nit picking here, but there is one last thing I want to bring up once more.

Usage of temporary in variable declarations. I dont care if its used or not if a table has TableType = temporary but if its used, it should be done on all variable declarations, in this PR its not image image

IMHO its just inconsistent coding.

As long as the record is passed via var, temp or not doesn't matter anyway. I added it only to the fascade to make it clear in the Module Fascade Documentation. @JesperSchulz, @darjoo how should I proceed?

@JesperSchulz
Copy link
Contributor

JesperSchulz commented Dec 19, 2024

. I dont care if its used or not if a table has TableType = temporary

I don't have a definite answer here. I'm all for consistency, and I definitely prefer to see in the parameter list and parameter name, when a record is temporary - it just makes it easier to understand what's going on, without having to peek on the actual table object to see if it happens to be a temporary one.

Temporary on object level was added a small handful years ago to allow us to have a table object which won't result in breaking schema changes, when changed. We for instance had buffer tables in the system, which only ever were used as temporary tables, but which we couldn't change as the schema was synchronized. That was annoying and hence the temp property was added to help the compiler understand what kind of table we're dealing with here.

Long story short: In my opinion, you should "double specify" temporary. The property simply ensures, that you won't ever store the table in the DB.

However, we do not have firm rules around that (yet). The property was introduced quietly and we never got around to create rules for it.

But I agree with Stefan, that we at least must be consistent - if not everywhere, then at least in the module. So go for being explicit about the temp property in the procedure parameters and parameter names.

@IceOnly
Copy link
Contributor Author

IceOnly commented Dec 19, 2024

. I dont care if its used or not if a table has TableType = temporary

I don't have a definite answer here. I'm all for consistency, and I definitely prefer to see in the parameter list and parameter name, when a record is temporary - it just makes it easier to understand what's going on, without having to peek on the actual table object to see if it happens to be a temporary one.

Temporary on object level was added a small handful years ago to allow us to have a table object which won't result in breaking schema changes, when changed. We for instance had buffer tables in the system, which only ever were used as temporary tables, but which we couldn't change as the schema was synchronized. That was annoying and hence the temp property was added to help the compiler understand what kind of table we're dealing with here.

Long story short: In my opinion, you should "double specify" temporary. The property simply ensures, that you won't ever store the table in the DB.

However, we do not have firm rules around that (yet). The property was introduced quietly and we never got around to create rules for it.

But I agree with Stefan, that we at least must be consistent - if not everywhere, then at least in the module. So go for being explicit about the temp property in the procedure parameters and parameter names.

Done.

Copy link
Contributor

@JesperSchulz JesperSchulz left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Let's merge!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
AL: System Application From Fork Pull request is coming from a fork Integration GitHub request for Integration area Linked Issue is linked to a Azure Boards work item
Projects
None yet
Development

Successfully merging this pull request may close these issues.

[BC Idea]: Add a new File System Module to the System App
10 participants