Understanding the Retrieve Message Progress Node

In this quick tutorial, we will cover “Understanding the Retrieve Message Progress Node”. The Catenis system is powerful and allows you to store and send large files asynchronously. When you are working with larger content, you may want to retrieve the progress of processing this content. The “Retrieve Message Progress” node retrieves the processing progress of an asynchronous message.

One typically uses asynchronous messaging when the content that needs to be sent or logged is above 10MB since such large files require message chunking.

In this video we will cover:

• General concepts of Retrieve Message Progress node
• Importing a working Retrieve Message Progress node flow
• Running the flow to see its results

Prerequisite

• A Free Catenis Development account or Production account
• Node-RED installed on either a local or cloud environment
• Catenis Flow Pallet installed on Node-RED
• A Catenis Virtual Device configured on Node-RED
• Basic understanding of how to use Node-RED
• Basic understanding of Bitcoin Blockchain concepts
• Basic understanding of how to handle large streaming content on the internet

Thank you for watching Understanding the Retrieve Message Progress Node in the Catenis Flow tutorial series. Watch the next video, Working With the Retrieve Message Progress Node, to further expand your knowledge.

Links from this video for easy access:

• Working with the Send Message Node: https://blockchainofthings.com/tutorials/work-with-the-send-message-node
• Retrieve Message Progress Node Documentation on our website: https://blockchainofthings.com/retrieve-message-progress-node/
• How to Configure a Virtual Device: https://blockchainofthings.com/tutorials/configure-virtual-device
• Working With the Retrieve Message Progress Node: https://blockchainofthings.com/tutorials/work-with-retrieve-message-progress-node

To sign up for your free account, head to our website www.blockchainofthings.com.

Join our community forum for the quickest response time to all your questions and concerns. This forum is our customer support. https://forum.blockchainofthings.com/

[Music]

Hi, this is Clara for Blockchain of Things.

In this tutorial, you will learn about the Retrieve Message Progress Node and how it’s used in Catenis Flow.

The Retrieve Message Progress Node retrieves the processing progress of an asynchronous message.

One typically uses asynchronous messaging when the content that needs to be sent or logged is above 10 megabytes,

since such large files require message chunking.

This node takes as input the ID of an ephemeral message

which is either a provisional or a cached message

and it returns a JSON object containing the action that was performed on the message.

Either sent, log, or read.

As well as how many bytes of the message
were processed thus far.

Whether the process has been finalized.

And an error code if an error occurred.

This node is rather simple, with only two fields in its property panel.

Add a descriptive name of your choice to the name field
that will help differentiate

this node from others of the same type
on the Node-RED workspace.

Set a previously configured Catenis Virtual Device
in the connection field,

or configure a new Virtual Device.

Now, let’s take a look at the example flow found at this link:

Copy the example flow.

Click the Node-RED hamburger menu and click import.

Paste the flow into the import box and select the import button.

This flow is a working example implementing the
Retrieve Message Progress Node.

Note, that after importing the example flow,

you will need to set the Catenis Flow Nodes to your own
previously configured virtual device.

If you don’t remember how to do this, check
out the video at this link:

Also, be aware that this node cannot take a JSON object as input.

You will also need to set the message ID payload in the Inject Node to the ID of a message you have previously logged.

Don’t have a message ID?

Complete the tutorial at this link to generate your own message ID.

You can pause this tutorial now to explore this flow on your own

and in the next video, you’ll learn how to
create this flow from scratch.

Fantastic!

Now, you should understand Retrieve Message Progress Node.

Did you know that a new block of bitcoins is
created every 10 minutes?

Catenis Flow messages can be processed faster than bitcoin transactions

because Catenis bundles messages together.

Saving time,

reducing transaction fees,

and reducing the number of Catenis Credits
required for the message.

Up next, you’ll learn how to create your own flow containing the Retrieve Message Progress Node.

[Music]