After a lot of thought, I am starting my journey into sub-flows.
I get that it can only have one input and have multiple outputs.
So putting aside the "problem" with only 1 input as that is true with all other nodes, so really it just gets down to structuring this node as any other node.
So, I see there is an option to add comments for the node if you double click on the tab at the top of the screen.
To set the input/output(s) you click at the top of the screen and you get input and output nodes appear to connect to the flow.
Again: Ok.
I was thinking to do like other well built nodes and put a description on the output pins explaining their function.
Alas I don't think that is supported.
(Same for the input node I just realised.)
Just wanting to check before I submit a request for that.
Am I missing anything about the comments and how you can not set separate ones for input and output?
(Via edit)
Oh, I also see that you can't use node.status in the sub nodes and see what is going on.
That is a bit annoying.
Is this also something I am missing in how to implement?
I put comment nodes inside the subflow against the input and outputs to describe what they are. That is much easier to see than comments inside the subflow config.
You can also use node.status - and use a status node outside to catch that status (it just doesn't show underneath like other nodes... - but as Colin says that is coming in 0.20)
If you double-click on any of the Input or Output nodes inside a subflow it will open the Edit Properties dialog (the same one if you click the 'edit properties' button in the toolbar.
As with other nodes, you can go to the 'Appearance' tab and set labels for the inputs and outputs.
These are the labels that appear when you hover the mouse over the input/output ports of the node in the main workspace.
You do not currently get to see these labels when editing the subflow itself - that isn't something I'd thought of but will look at adding as it makes sense to do so.
You can use node.status() in nodes within the subflow. The status event can be handled by a Status node however the status event will not appear against the subflow instance node - in otherwords, you won't get the text appearing below subflow instance node.
As @colin mentioned, we just released the next beta of 0.20 which adds some new subflow capabilities, including better handling of status.
I got the stuff you posted. As I explained: I seldom look at that part. Sorry. (My favourite word, it seems.)
While doing some testing, I got an error 401. Shall post when I get time.
It got parked when I got that and I am looking at some other logic I need to implement in different parts of the flow.
@Trying_to_learn one quick word of caution before you delve too deep.
You cannot use dashboard nodes inside a subflow. Won't get into all the details of why, but just don't try it. It leads to unexpected layouts and you'll waste a lot of time trying to figure it out.