search

sapmentors / SAPlink

SAPlink
Apache License 2.0
110 stars 101 forks source link

SAPLink Converter: nugges to Word #19

Open rpalotai opened 1 year ago

rpalotai commented 1 year ago

Hi,

We always had the problem of documenting the tremendous amount of ABAP objects that we have developed during a project. So we've created a converter that extract the most important objects from a nugget file and put them into a MS Wor document. This enables to document all exported objects in a nugget file, thus helping ABAPers to document their developments. Specially useful for those objects that has many components, like tables, structures, etc.

I was not sure where to publish that we have created a free online available version of this converter.

Under the hood there is a nodejs parser that uses JAVA for XSLT conversion. The XSLT maps the nuggets into MS Word XML format. That XML can be opened with MS Word and can be saved in DOCX format.

Everybody can access it at https://www.saplinkconverter.com free!

Pls. let me know if you have any comments.

Br Richard Palotai

gregorwolf commented 1 year ago

Hi Richard,

wouldn't be the more future proof solution to add support for Git repositories based on abapGit?

rpalotai commented 1 year ago

Hi Gregor,

We have created this site 2 years ago, and had now the time to make the online version stable enough to publish it for the community. I will rewrite the support for apapGit support, but I believe that is only the way to install SAPLink. Or the nuggets files have different format using abapGit source of SAPLink?

Have you tried it? What is your opinion on the converter?

Br Richard

mkysoft commented 1 year ago

abapGit and SAPLink have different formats. SAPLink hasn't supported all object types. So there is no way to convert between formats. On the other hand, SAPLink hasn't longer been updated. I prefer support to abapGit zip format.

rpalotai commented 1 year ago

I think you misunderstood something. Gregor meant to introduce the abapGIT version of SAPLink on our saplinkconverte.com site instead of the old hard ways of implementing the core reoport and then all extensions. https://blogs.sap.com/2018/11/06/saplink-available-as-abapgit-repo/ SAPLink is still an easy and quick way to export the basic and most important codes from an ABAP system. With our solution ABAP developers can save a lot of time to extract most important documentation data from the nuggets files. For examlpe if you have to document structures, tables with many fields... If our team has lot of free time in the future (don't think really that could happen soon :-)) than we can replace the XSLT transformation rules that convert the nuggets XML file in to a MS Word XML file as apaGIT is also using XML techniques... BR Richard

gregorwolf commented 1 year ago

Hi Richard,

one argument that might give a move to abapGit as the source format more priority is that abapGit is the SAP Supported format to connect Git Repositories to ABAP Cloud. I don't think it would be worth the effort to port SAPlink to ABAP Cloud.

What's about releasing SAPlink Converter as open source and talk to the abapGit community if they someone is interested to help with the migration.

Best Regards Gregor

rpalotai commented 1 year ago

Hi Gregor,

That is a good idea. The XSLT transformation MS Word XML part could be reused 100%, which was one of the most work intensive part. Let me know how can we start it. I have never been involved in open source development...

Br Richard

gregorwolf commented 1 year ago

Hi Richard,

as a start I suggest that you join the abapGit Slack channel and pitch the idea there. Let's see what feedback you get.

Internally you might check what license to use for the project. Do you have a legal department? Then you should talk to them or at least your boss.

CU Gregor