Page 1 of 1

A Beginner's Guide for ProcessMaker

Posted: Tue Aug 22, 2017 12:53 pm
by dipolediamond
I recently completed a book on ProcessMaker - "A Beginner's Guide to Business Process Automation with ProcessMaker 3.1" on leanpub and the primary motivation is to provide those new to ProcessMaker with a step by step guide to building and deploying their first process on ProcessMaker. The first 9 (nine) chapters are available to read online on leanpub - https://leanpub.com/beginnersguidetopro ... ead_sample.

Please help share with anyone new to ProcessMaker and who might benefit from it. The link to the book is https://leanpub.com/beginnersguidetoprocessmaker. Your feedback on the book will also be greatly appreciated.

EDIT:
The book is now available as an Apress title - http://www.apress.com/9781484233443 and also on Amazon - https://www.amazon.com/Business-Process ... 484233441/

Re: A Beginner's Guide for ProcessMaker

Posted: Tue Aug 22, 2017 5:46 pm
by amosbatto
I just randomly flipped through parts of the book, and it looks pretty good. I hope that you have good sales of the book.

Would you like me to make this post a sticky announcement on the forum for the next week (so it stays at the top of the list of posts)? We are always happy to see others promoting the use of ProcessMaker.

I have two observations about the book. In the beginning when installing PM with Bitnami, you should mention that Bitnami installations are generally only used for testing and developing processes. A manual installation is recommended when using processes in production, because Bitnami installations cannot be upgraded to later versions and Bitnami installations are generally slower and use more resources than manual installations.

In your JavaScript code, I recommend only using jQuery selectors. For example, you use code like this that mixes standard JavaScript and jQuery:
Code: Select all
//Register comments handler to button events
document.getElementById("form\[comment_button\]").onclick = addComments;
$("form").submit( addComments );
First of all, you don't need to escape the [ and ] characters in standard Javascript, so this will work:
Code: Select all
document.getElementById("form[comment_button]").onclick = addComments;
However, the PM Developers don't recommend using document.getElementById() to obtain the elements of a form, because the developers say that it might not always work in the ProcessMaker Mobile App, although I haven't seen an example where it doesn't work. However, it is necessary to use the custom helper functions setValue(), getValue() and setOnchange() which only work with jQuery, instead of the value and onchange properties in standard JavaScript. To avoid problems and possible confusion, we recommend always using jQuery(), even though it may be more complicated in some instances.

Officially, we recommend that you use code like this:
Code: Select all
$("#comment_button").find("button").on("click", addComments);
I personally don't like using the find() function because you have to know what HTML element you are searching for ("button", "div", "input", "select", "textarea", etc.) with each type of control, so I directly select the element through its ID "form[id]" which requires escaping the square brackets [ and ] with \\:
Code: Select all
$("#form\\[comment_button\\]").on("click", addComments );
I also don't see much reason to use .on() instead of .click() which is a shorthand that does the same thing:
Code: Select all
$("#form\\[comment_button\\]").click( addComments );
Some people find escaping with jQuery selectors to be very confusing, so they use this code:
Code: Select all
$("[id='form[comment_button]']").click( addComments );
No matter which method that you choose, I do recommend using jQuery() in all instances, so that people get used to using jQuery and won't try to use document.getElementById().value and document.getElementById().onchange which will cause problems.

If you want me to review your code in the entire book, you can email me a copy of your book at [email protected] and I will look at it when I have time.

Re: A Beginner's Guide for ProcessMaker

Posted: Mon Aug 28, 2017 2:46 pm
by dipolediamond
Hi Amos,

I really appreciate the feedback. Yes, please make it a sticky post. I will send you a copy of the book as it could really use your wealth of experience in making it a better resource for learning ProcessMaker.

I will also make the suggested updates. Once again, thank you.

Re: A Beginner's Guide for ProcessMaker

Posted: Mon Aug 28, 2017 7:00 pm
by amosbatto
Hi Dipo,
I made this post a global announcement for the next 2 weeks, so hopefully people will notice it.
Regards,
Amos

Re: A Beginner's Guide for ProcessMaker

Posted: Tue Aug 29, 2017 2:24 am
by groakes
Terrific! I have just purchased a copy (I couldn't resist at that price)!

Thanks
Greg

Re: A Beginner's Guide for ProcessMaker

Posted: Tue Aug 29, 2017 6:01 pm
by dipolediamond
groakes wrote:Terrific! I have just purchased a copy (I couldn't resist at that price)!

Thanks
Greg
Thank you Greg. Would appreciate any feedback you have on the book to help make it better.

Re: A Beginner's Guide for ProcessMaker

Posted: Sat Oct 21, 2017 6:30 am
by springhigh
Thank You
Great read for when on the road.

Re: A Beginner's Guide for ProcessMaker

Posted: Thu Jan 18, 2018 11:29 pm
by process1985
Thanks for sharing the book. Haven't read it yet but will do. Believe it would be of great help for many of us.

Re: A Beginner's Guide for ProcessMaker

Posted: Tue Feb 27, 2018 3:57 pm
by higgledy
I bought a copy off amazon. It arrived yesterday afternoon. It looks good so far. Is there a place to download the example code? Thanks.

Re: A Beginner's Guide for ProcessMaker

Posted: Fri Jan 11, 2019 2:08 pm
by DagfarGewgaw
Thank you for this brief Guide. it is very informative and helpful

Re: A Beginner's Guide for ProcessMaker

Posted: Thu Feb 21, 2019 10:39 am
by ziadeh
Absolutely yes , there are so many ideas that you can use Processmaker in your business with easy way and less code for developers.

You can read this book: https://www.amazon.com/Business-Process ... way&sr=8-1

Also there are online documentation: https://wiki.processmaker.com/

Re: A Beginner's Guide for ProcessMaker

Posted: Fri May 17, 2019 3:07 am
by juanforce
Great read for when on the road. Thank you for sharing the book.

Re: A Beginner's Guide for ProcessMaker

Posted: Tue Jul 02, 2019 4:08 am
by huuanh2811
Hola, soy nuevo en PM y tengo el siguiente problema:
Un proceso genera el archivo de salida pdf, pero cuando lo graba lo guarda lo hace con el nombre cases_ShowOutputDocument sin agregarle la extensión .pdf
Con lo cual para poder verlo tengo que ir a la carpeta de Descargas y cambiarle el nombre manualmente agregándole .pdf

Sabés en qué me estoy equivocando?
Muchas gracias

Re: A Beginner's Guide for ProcessMaker

Posted: Tue Jul 02, 2019 10:03 pm
by amosbatto
huuanh2811 wrote: Tue Jul 02, 2019 4:08 am Un proceso genera el archivo de salida pdf, pero cuando lo graba lo guarda lo hace con el nombre cases_ShowOutputDocument sin agregarle la extensión .pdf
Con lo cual para poder verlo tengo que ir a la carpeta de Descargas y cambiarle el nombre manualmente agregándole .pdf
He traslado tu pregunta al foro de Español:
viewtopic.php?f=19&t=736895