Import
Description
This component can be used to let your customers import data into Via directly from your website without requiring a login.
Usage
First, you will need to create a Import instance. The import constructor takes 4 parameters.
const importer = new Extend.import(boardId, listId, companyId, embedToken);
boardId* (string) | listId* (string) | companyId* (string) | embedToken* (string) |
---|---|---|---|
The Board ID on which you want the cards to be imported to. | The List ID on which you want the cards to be imported to. | Your Company ID | The embed token you obtained from the ‘API Settings’ in your admin dashboard |
With the Import component fully configured, now call open
on the importer to start the import process.
importer.open();
Basic example
<script
type="text/javascript"
src="https://attachments.viaboards.io/embed/embeds-prod.js"
></script>
<script type="text/javascript">
const boardId = "YOUR_BOARD_ID";
const listId = "YOUR_LIST_ID";
const companyId = "YOUR_COMPANYID";
const embedToken = "YOUR_EMBED_TOKEN";
const importer = new Extend.import(boardId, listId, companyId, embedToken);
importer.onSuccess((message) => {
// Do something
return "Done!";
});
</script>
<div id="root">
<button onclick="importer.open()">Open Importer</button>
</div>
Callbacks
onClosed
This will get called anytime the importer is closed by the user or another process.
onLoaded
This is fired after the importer iFrame is fully loaded and ready to be displayed to the user.
onError
Any and all errors will be routed to this callback.
onProccessing
Fired when a import process is started.
onSuccess
When the import process is complete we will respond here.