About EasyMorph Tutorials & Examples Web-help

Autodocumentation


#1

Dear,

Is it possible in the desktop versions to configure the autodocumentation ?

For example, say that I want to configure that autodocumentation in HTML is generated after an ETL process has run. Is this possible or do we have to push the generate button manually ?
Can we also have a unique URL to the HTML after each iteration of the ETL-process or is this only available in the server edition?

Kind regards


Copying multiple files without iterations
#2

Autodocumentation can be generated from the command line:

morph.exe /c /document myproject.morph

See more details in the web-help: Command line options.

The desktop version doesn’t have a built-in web-server. Only the server edition does. Auto-documentation on the Server has a permanent URL for each task/project. This URL can be used from external applications.


#3

I have tried your solution but I think I am doing something wronge.

When I open my MS DOS command prompt and I navigate to the directory where my project is located and then execute the command:

morph.exe /c /document myproject.morph

it does not work. The command prompt says that morph.exe is not recognised as a program

What am I doing wrong?


#4

It is because morph.exe is not found in the directory where the project is located.

You need to either add the path to morph.exe to the system PATH variable, or use the full path to morph.exe while in the project directory, e.g.

"C:\Users\reynsnivea\AppData\Local\EasyMorph\morph.exe" /c /document myproject.morph

#5

Thanks !


#6

Could you also provide an example that is more generic in the sense that it can be copied over to other projects.
I mean that I should be able to write the documentation to a directory of choice and extract the path of the easymorph file that is autodocumented. I do not know if it is possible in easymorph to find the folder path in which the easymorph in which I am currently working resides.

Also, I would like to the same thing for creating log files.


#7

The documentation is always written in the same directory as the .morph project it’s been generated on. Just copy the auto-documentation HTML file to a directory of choice after it was generated.

It is possible, see the system function.

Log files also are created in the project directory. Copy them to a destination of choice, if needed.


#8

Hi Dmitry,

I was testing the autodocumentation function using the suggested command line mode.

I have an easyMorph project in which I iterate over a list of easyMorph files. I pass them as parameter values to another project in which I have a single “run program transformation”. In that transformation I have pasted something like:

“C:\Users\reynsnivea\AppData\Local\EasyMorph\morph.exe” /c /document {easymorph_project}

I see the documentation is generated but it also executes the easymorph projects ! Also when I paste this in my cmd prompt, it executes the easyMorph project. What am I doing wrong ?

Thanks in advance !


#9

We will disable running projects when only documentation is requested in version 3.8.2.


#10

UPDATE
It’s sufficient to just use the /document command to only generate documentation without running the project. Therefore, the correct syntax is

morph.exe /document {easymorph_project}

This feature already works, so no changes required. The web-help contained incorrect description and has been edited.


#11

Dmitry,

Thanks, I will check it out !

Kind regards


#12

Hi dmitry,

This works !

I have a project that loops over morph-files generates the documentation and moves the resulting HTML to a folder.

Is there a way to move a bunch of files in a folder in 1 transformation. Now, I have used the file command by iterating over a table of files names. Is there an option to avoid the iteration step ?

Kind regards


Copying multiple files without iterations
#13

I’ve answered in a separate topic as this question is general and not about documentation: Copying multiple files without iterations