A Beginner's Guide for ProcessMaker

Questions and discussion about using ProcessMaker: user interface, running cases & functionality

Moderator: amosbatto

dipolediamond
Posts: 17
Joined: Fri Mar 19, 2010 7:02 am

A Beginner's Guide for ProcessMaker

Unread postby dipolediamond » Tue Aug 22, 2017 12:53 pm

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/beginnersguidetoprocessmaker/read_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.

amosbatto
Posts: 5323
Joined: Mon Jun 22, 2009 10:28 am
Country: Bolivia
Location: La Paz

Re: A Beginner's Guide for ProcessMaker

Unread postby amosbatto » Tue Aug 22, 2017 5:46 pm

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.
Amos B. Batto ♦ ProcessMaker Technical Documentation Writer & Forum Manager ♦ Cofounder of ILLA (http://www.illa-a.org)

dipolediamond
Posts: 17
Joined: Fri Mar 19, 2010 7:02 am

Re: A Beginner's Guide for ProcessMaker

Unread postby dipolediamond » Mon Aug 28, 2017 2:46 pm

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.

amosbatto
Posts: 5323
Joined: Mon Jun 22, 2009 10:28 am
Country: Bolivia
Location: La Paz

Re: A Beginner's Guide for ProcessMaker

Unread postby amosbatto » Mon Aug 28, 2017 7:00 pm

Hi Dipo,
I made this post a global announcement for the next 2 weeks, so hopefully people will notice it.
Regards,
Amos
Amos B. Batto ♦ ProcessMaker Technical Documentation Writer & Forum Manager ♦ Cofounder of ILLA (http://www.illa-a.org)

groakes
Posts: 12
Joined: Mon Apr 17, 2017 8:59 pm
Country: Australia

Re: A Beginner's Guide for ProcessMaker

Unread postby groakes » Tue Aug 29, 2017 2:24 am

Terrific! I have just purchased a copy (I couldn't resist at that price)!

Thanks
Greg

dipolediamond
Posts: 17
Joined: Fri Mar 19, 2010 7:02 am

Re: A Beginner's Guide for ProcessMaker

Unread postby dipolediamond » Tue Aug 29, 2017 6:01 pm

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.


Return to “Using ProcessMaker 3”

Who is online

Users browsing this forum: No registered users and 1 guest