Canvas is simple to use, but before diving in it can be a good idea to get to you should know some of the key concepts involved.
In this article we will describe three central concepts for Canvas: apps, blocks, and workflows.
Panel
Canvas simplifies interaction with APIs
| Tip |
|---|
Summary:
|
| Table of Contents | ||||
|---|---|---|---|---|
|
>>>>>Illustration<<<<<< How apps blocks and wfs relate
Applications
In short, workflows are made up of blocks which fetch data using apps registered in the user account. API calls on Canvas are (usually) not made to the external APIs directly; instead a simplified internal API is used for each app, which forwards the request to the external API. |
Topics covered:
| Table of Contents |
|---|
Applications
If you have worked with APIs before, you will know that it can be challenging to manually handle API authentication, safe storage of credentials for multiple clients, refreshing of session tokens, API changes, OAuth, etc.
Canvas simplifies all this by letting you register applications.
...
When you register a new application on (“app”) in a user account you will be asked to provide the necessary API credentials (usernames, passwords, API keys, etc) for the app. These details are then stored safely encrypted in the user account , and can then be used by the integrations (“workflows”) that you createset up.
...
If you have worked with APIs beforeFor example, if you register Azure AD as an app in an account, you will know that it can be challenging to manually handle API authentication, safe storage of API credentials, refreshing of session tokens, API changes, OAuth, etc.Canvas simplifies all this by handling authentication and querying for you. then be able to use the stored credentials to set up integrations towards Azure AD:
...
This ensures safe storage and handling of API credentials. Session tokens are automatically refreshed, so you can build your integrations and interact with the API without having to think about authentication.
When you register an application you will also unlock a library of ready-made blocks for the app.
Blocks
Blocks are modular, ready-made pieces of code.
The applications in Canvas also have their own APIs, and thus work as a middle layer - simplifying and unifying the process of working with several external APIs. This means that you would (normally) not query external APIs directly. Instead you would query the app you registered:
...
The app APIs in Canvas will have similar endpoints to the external APIsYou can easily build a new workflow by drag-and-dropping blocks onto the canvas, with little configuration needed.
...
ConnectMyApps offers a wide range of ready-made blocks for each app, called “block templates”.
The code for these can easily be viewed, changed and customized, if needed. You may also create your own blocks, and turn those into block templates for easy reuse later.
In the previous example we added the Azure AD application to the user account, which unlocked the following blocks for use in workflows:
...
Workflows:
“Workflow” is the term used for integrations in Canvas.
A workflow is made up of blocks, and can be scheduled to run at specific times or intervals.
Workflows can also be turned into templates for easy reuse.
Here is an example of a workflow which updates employees and agreements in Quinyx using data fetched from a FTP server:
...
Here you see the blocks this workflow consists of:
...
About the middle layer API
It is important to know that blocks on Canvas (usually) do not query external APIs directly; instead they query an internal wrapper/middle layer API which is part of Canvas' backend. The middle layer API forwards requests to the external API, using the credentials from the registered application in the user account.
This simplifies and unifies the process of working with several external APIs, while ensuring secure handling of authentication.
...
The apps in Canvas have their own endpoints in the wrapper/middle layer API, which closely resemble endpoints you will find in the external APIs' documentation, but will be much easier to work with .For example, if you register Azure AD as an app on an account, then you will be able to set up integrations towards Azure AD using the stored credentials. Instead of querying the Azure AD API directly, you can query the app you registered (without having to manage aspects such as authentication, etc).
...
This simplifies the process of building integrations while ensuring safe handling of sensitive data.
Blocks
Workflows:
Canvas philosophy
Legos for in the Canvas context.
In general, you will find ready-made blocks for these endpoints, but feel free to contact us if you need further support or an overview over available endpoints.
It is also worth mentioning that there is a generic REST connector, which can be used to query any external REST API. But in most cases it will be preferable to use the non-generic apps with pre-made blocks if the app is supported.
...