1
 Follower
1
 Like

OutSystems 10 Documentation bug: input parameters on human activities and wait action

Documentation
On our radar

According to the documentation of OutSystems 10 (see: https://success.outsystems.com/Documentation/10/Developing_an_Application/Use_Processes/Use_Process_Extended_Actions/Close_Human_Activity_Action and https://success.outsystems.com/Documentation/10/Developing_an_Application/Use_Processes/Use_Process_Extended_Actions/Close_Wait_Action) it should be possible to add input parameters to a human activity in a process or to a wait action. In Service Studio, it is only possible to add output parameters to both of them. It looks like a bug in the documentation.

Created on 26 Apr
Comments (3)

Hello Pedro,

The documentation pages that you mention are about two special actions (Process Extended Actions) that allow you to close Human Activities and Wait Activities. They are specific to each Human or Wait Activity and because of this they are called Close<Human Activity Name> or Close<Wait Activity Name>.

These actions have input parameters, but they are all automatically defined by the platform.

The first one is the Activity ID, which allows you to identify the Human Activity or Wait Activity that you are going to close.

The other input parameters correspond to the output parameters of their corresponding Human or Wait Activity. So, if you define a Human Activity with two Output Parameters Out1 and Out2, the Close Action will have two input parameters with the same name and type:

When you call the Close action, you need to the define the value of these input parameters in the Properties pane.  This is the mechanism that allows you to define the outcome of the activities when you close them:

So, indeed, the documentation can be a bit confusing if you only read about the Close Actions without having read about the Activities and how this mechanism works. We thank you for your feedback and will take it into account when we improve this area of the documentation.

Do let us know if this makes more sense now or if you still have any questions!

Changed the category to Documentation and the status to

On our radar


Hi Pedro,

Thank you so much for your idea. I am marking this as "on our radar" since we have plans to improve this area of documentation (still no date for a delivery, though). While this topic isn't improved, I hope you find Paulo's reply useful already.

We also have a submit feedback option at the bottom of our documentation pages. We often give an eye on it there too, so keep the feedback coming :)

Thanks again!

Hi Paulo and Ângela, thanks for your messages. 

@Paulo: your explanation is "crystal clear". To clarify matters in the documentation, I would suggest the following:

1) Rephrase the explanation in the documentation. Instead of having "Human Activity Input Parameters: one parameter for each input parameter in the human activity definition.", write down the following "Human Activity Output Parameters: one parameter for each output parameter in the human activity definition."

2) Under this statement, you could add the example presented in here by Paulo.


Thanks again for the time taken clarifying this issue.


Greetings, Pedro

views
471
Followers
1