n8n-nodes-exact-online 0.1.8 → 0.2.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE.md +64 -64
- package/README.md +112 -112
- package/dist/credentials/exactOnline.svg +1080 -1080
- package/dist/nodes/ExactOnline/ExactOnline.node.js +1 -3
- package/dist/nodes/ExactOnline/ExactOnline.node.js.map +1 -1
- package/dist/nodes/ExactOnline/exactOnline.svg +1080 -1080
- package/dist/package.json +1 -1
- package/package.json +1 -1
package/LICENSE.md
CHANGED
|
@@ -1,64 +1,64 @@
|
|
|
1
|
-
Copyright (c) 2022, Knitco
|
|
2
|
-
All rights reserved.
|
|
3
|
-
|
|
4
|
-
Chicken Dance License v0.2
|
|
5
|
-
http://supertunaman.com/cdl/
|
|
6
|
-
|
|
7
|
-
Redistribution and use in source and binary forms, with
|
|
8
|
-
or without modification, are permitted provided that the
|
|
9
|
-
following conditions are met:
|
|
10
|
-
|
|
11
|
-
1. Redistributions of source code must retain the
|
|
12
|
-
above copyright notice, this list of conditions and
|
|
13
|
-
the following disclaimer.
|
|
14
|
-
2. Redistributions in binary form must reproduce the
|
|
15
|
-
above copyright notice, this list of conditions and
|
|
16
|
-
the following disclaimer in the documentation and/or
|
|
17
|
-
other materials provided with the distribution.
|
|
18
|
-
3. Neither the name of the Knitco nor the names
|
|
19
|
-
of its contributors may be used to endorse or promote
|
|
20
|
-
products derived from this software without specific
|
|
21
|
-
prior written permission.
|
|
22
|
-
4. An entity wishing to redistribute in binary form or
|
|
23
|
-
include this software in their product without
|
|
24
|
-
redistribution of this software's source code with the
|
|
25
|
-
product must also submit to these conditions where
|
|
26
|
-
applicable:
|
|
27
|
-
* For every thousand (1000) units distributed, at
|
|
28
|
-
least half of the employees or persons
|
|
29
|
-
affiliated with the product must listen to the
|
|
30
|
-
"Der Ententanz" (AKA "The Chicken Dance") as
|
|
31
|
-
composed by Werner Thomas for no less than two
|
|
32
|
-
(2) minutes
|
|
33
|
-
* For every twenty-thousand (20000) units distributed,
|
|
34
|
-
one (1) or more persons affiliated with the entity
|
|
35
|
-
must be recorded performing the full Chicken Dance,
|
|
36
|
-
in an original video at the entity's own expense,
|
|
37
|
-
and a video encoded in OGG Theora format or a format
|
|
38
|
-
and codec specified by Knitco, at least three (3)
|
|
39
|
-
minutes in length, must be submitted to Knitco,
|
|
40
|
-
provided Knitco's contact information. Any and all
|
|
41
|
-
copyrights to this video must be transfered to
|
|
42
|
-
Knitco. The dance featured in the video
|
|
43
|
-
must be based upon the instructions on how to perform
|
|
44
|
-
the Chicken Dance that you should have received with
|
|
45
|
-
this software.
|
|
46
|
-
* Any employee or person affiliated with the product
|
|
47
|
-
must be prohibited from saying the word "gazorninplat" in
|
|
48
|
-
public at all times, as long as distribution of the
|
|
49
|
-
product continues.
|
|
50
|
-
|
|
51
|
-
THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
|
|
52
|
-
"AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
|
|
53
|
-
LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
|
|
54
|
-
FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE
|
|
55
|
-
COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
|
|
56
|
-
INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
|
|
57
|
-
BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
|
|
58
|
-
LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
|
|
59
|
-
CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
|
|
60
|
-
LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
|
|
61
|
-
ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
|
|
62
|
-
POSSIBILITY OF SUCH DAMAGE. Knitco ACCEPTS NO LIABILITY FOR
|
|
63
|
-
ANY INJURIES OR EXPENSES SUSTAINED IN THE ACT OF FULFILLING ANY OF
|
|
64
|
-
THE ABOVE TERMS AND CONDITIONS, ACCIDENTAL OR OTHERWISE.
|
|
1
|
+
Copyright (c) 2022, Knitco
|
|
2
|
+
All rights reserved.
|
|
3
|
+
|
|
4
|
+
Chicken Dance License v0.2
|
|
5
|
+
http://supertunaman.com/cdl/
|
|
6
|
+
|
|
7
|
+
Redistribution and use in source and binary forms, with
|
|
8
|
+
or without modification, are permitted provided that the
|
|
9
|
+
following conditions are met:
|
|
10
|
+
|
|
11
|
+
1. Redistributions of source code must retain the
|
|
12
|
+
above copyright notice, this list of conditions and
|
|
13
|
+
the following disclaimer.
|
|
14
|
+
2. Redistributions in binary form must reproduce the
|
|
15
|
+
above copyright notice, this list of conditions and
|
|
16
|
+
the following disclaimer in the documentation and/or
|
|
17
|
+
other materials provided with the distribution.
|
|
18
|
+
3. Neither the name of the Knitco nor the names
|
|
19
|
+
of its contributors may be used to endorse or promote
|
|
20
|
+
products derived from this software without specific
|
|
21
|
+
prior written permission.
|
|
22
|
+
4. An entity wishing to redistribute in binary form or
|
|
23
|
+
include this software in their product without
|
|
24
|
+
redistribution of this software's source code with the
|
|
25
|
+
product must also submit to these conditions where
|
|
26
|
+
applicable:
|
|
27
|
+
* For every thousand (1000) units distributed, at
|
|
28
|
+
least half of the employees or persons
|
|
29
|
+
affiliated with the product must listen to the
|
|
30
|
+
"Der Ententanz" (AKA "The Chicken Dance") as
|
|
31
|
+
composed by Werner Thomas for no less than two
|
|
32
|
+
(2) minutes
|
|
33
|
+
* For every twenty-thousand (20000) units distributed,
|
|
34
|
+
one (1) or more persons affiliated with the entity
|
|
35
|
+
must be recorded performing the full Chicken Dance,
|
|
36
|
+
in an original video at the entity's own expense,
|
|
37
|
+
and a video encoded in OGG Theora format or a format
|
|
38
|
+
and codec specified by Knitco, at least three (3)
|
|
39
|
+
minutes in length, must be submitted to Knitco,
|
|
40
|
+
provided Knitco's contact information. Any and all
|
|
41
|
+
copyrights to this video must be transfered to
|
|
42
|
+
Knitco. The dance featured in the video
|
|
43
|
+
must be based upon the instructions on how to perform
|
|
44
|
+
the Chicken Dance that you should have received with
|
|
45
|
+
this software.
|
|
46
|
+
* Any employee or person affiliated with the product
|
|
47
|
+
must be prohibited from saying the word "gazorninplat" in
|
|
48
|
+
public at all times, as long as distribution of the
|
|
49
|
+
product continues.
|
|
50
|
+
|
|
51
|
+
THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
|
|
52
|
+
"AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
|
|
53
|
+
LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
|
|
54
|
+
FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE
|
|
55
|
+
COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
|
|
56
|
+
INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
|
|
57
|
+
BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
|
|
58
|
+
LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
|
|
59
|
+
CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
|
|
60
|
+
LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
|
|
61
|
+
ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
|
|
62
|
+
POSSIBILITY OF SUCH DAMAGE. Knitco ACCEPTS NO LIABILITY FOR
|
|
63
|
+
ANY INJURIES OR EXPENSES SUSTAINED IN THE ACT OF FULFILLING ANY OF
|
|
64
|
+
THE ABOVE TERMS AND CONDITIONS, ACCIDENTAL OR OTHERWISE.
|
package/README.md
CHANGED
|
@@ -1,112 +1,112 @@
|
|
|
1
|
-
|
|
2
|
-
|
|
3
|
-
# n8n-nodes-exact-online
|
|
4
|
-
|
|
5
|
-
This node was developed during the n8n node-athon. This is version one with a basic CRUD implemented.
|
|
6
|
-
During the development the API reference docs were scraped with a n8n workflow. This Workflow was also included in the repo.
|
|
7
|
-
There were 396 pages scraped and processed into a config file.
|
|
8
|
-
|
|
9
|
-
The node is usable with a Developer account which can be created for free at Exact Online's website. This way you can test the node however you like it without compromising your production environment.
|
|
10
|
-
After you can easily connect it with a production environment and automate your workflows.
|
|
11
|
-
|
|
12
|
-
## Exact Online
|
|
13
|
-
|
|
14
|
-
Exact Online is an ERP solution that is offered as a cloud service. Most companies that use exact use it as their main application and have all kinds of applications they use around that. Exact has been expanding over the years and they now offer Exact Online internationally.
|
|
15
|
-
|
|
16
|
-
## Install instructions
|
|
17
|
-
|
|
18
|
-
The node can be installed with the community package feature. It can also be installed manually.
|
|
19
|
-
If you need more information on that, please refer to the n8n docs.
|
|
20
|
-
|
|
21
|
-
Make sure to restart n8n when you have installed the node.
|
|
22
|
-
> :warning: **Make sure to restart n8n when you have installed the node.**
|
|
23
|
-
|
|
24
|
-
## Setup instructions
|
|
25
|
-
|
|
26
|
-
> :warning: **You need a HTTPS callback url for it to function. Exact Online does not allow you to use HTTP. Make sure you have this before starting the setup.**
|
|
27
|
-
|
|
28
|
-
> **_NOTE:_** Some of the documentation was rewritten because the production app setup is a bit different from the development app. That is also why some names and urls arent the same everywhere, I hope it is clear enough not to get you confused about changing names and such.
|
|
29
|
-
|
|
30
|
-
To setup this node you will have to create an App in Exact online. Below there is a step by step guide on how to do this.
|
|
31
|
-
In the future there might be a possibility to simply select it from the app store of Exact Online. I will be looking into getting it approved at a later date.
|
|
32
|
-
|
|
33
|
-
The Images should be clear enough for you to follow along.
|
|
34
|
-
|
|
35
|
-
Login into Exact Online by clicking on the marked button
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
Click on appcenter button to open the app center, this where you can connect apps.
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
At this point it will forward you to all the apps you can browse. You probably need to click on login in the top right again to actually login on this page.
|
|
44
|
-
|
|
45
|
-
After that you will see the manage apps button
|
|
46
|
-
Click on the manage apps button
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
You will then see your apps. There is a choice between production and test. Click on register an app.
|
|
51
|
-
If you do not have a choice simply click on the big + to register an app.
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
Open a tab with n8n and go to the Exact Online Node, if you do not have it open already.
|
|
56
|
-
Create a new credentials entry or modify an existing one in the app.
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
You should see the credential information. You need to fill this in, but first you need the Callback URL to be filled in into the app setup in Exact Online.
|
|
61
|
-
Copy the callback URL from n8n into Exact Online.
|
|
62
|
-
If you are registering a production app you will need to do this in this first screen that pops up. If it is a testing app this pop-up is skipped. (fill in the name and the callback url in the following screen if this step is skipped)
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
Fill in the rest of the information in the credentials of n8n.
|
|
67
|
-
Should look a bit like this:
|
|
68
|
-
|
|
69
|
-
Exact Online:
|
|
70
|
-
|
|
71
|
-
|
|
72
|
-
n8n:
|
|
73
|
-
|
|
74
|
-
|
|
75
|
-
After you can Click connect / reconnect and it might give you a pop-up to login to exact online if you aren't logged in yet or you need to confirm the connection / approve some terms.
|
|
76
|
-
|
|
77
|
-
## Features v1.0
|
|
78
|
-
|
|
79
|
-
All posible API requests were scraped from the Exact Online docs. This was used to create a config file. some quality of life features were added and more will be added in the future.
|
|
80
|
-
|
|
81
|
-
You can choose al Devisions your account has access to. And all data you have access to will be able to be retrieved.
|
|
82
|
-
Somtimes you do not retrieve any data that is because there is non or you do not have access.
|
|
83
|
-
|
|
84
|
-
you can use the dropdowns to select what you want to do.
|
|
85
|
-
|
|
86
|
-
|
|
87
|
-
|
|
88
|
-
when retrieving data you can add filters and choose what fields you want to include. You can both name field to be included and excluded. Some Api endpoints allow you to retrieve all fields when not selecting any and some require you to select the fields you want to include. By setting the slider to exclude the selected fields and not selecting any fields the node will automatically fetch all fields available.
|
|
89
|
-
|
|
90
|
-
|
|
91
|
-
|
|
92
|
-
|
|
93
|
-
when you want to create a new record or edit it, you will be able to add fields and select fields from a list of options for that specific resource.
|
|
94
|
-
|
|
95
|
-
|
|
96
|
-
|
|
97
|
-
## Using the scraper
|
|
98
|
-
|
|
99
|
-
- You do not need an account for the scraper.
|
|
100
|
-
- Paste the JSON into an n8n workflow.
|
|
101
|
-
- Set the Github Authorization
|
|
102
|
-
- The first time you might want to set the Github node to create the file.
|
|
103
|
-
- Start
|
|
104
|
-
- Done -> make sure to format the output file as this will improve the readability ;-)
|
|
105
|
-
|
|
106
|
-
## More info on the API
|
|
107
|
-
|
|
108
|
-
[Exact Online ref](https://start.exactonline.nl/docs/HlpRestAPIResources.aspx?SourceAction=10)
|
|
109
|
-
|
|
110
|
-
## License
|
|
111
|
-
|
|
112
|
-
[ChickenDance](https://github.com/bramkn/ExactOnline/blob/master/n8n-nodes-exact-online/LICENSE.md)
|
|
1
|
+
|
|
2
|
+
|
|
3
|
+
# n8n-nodes-exact-online
|
|
4
|
+
|
|
5
|
+
This node was developed during the n8n node-athon. This is version one with a basic CRUD implemented.
|
|
6
|
+
During the development the API reference docs were scraped with a n8n workflow. This Workflow was also included in the repo.
|
|
7
|
+
There were 396 pages scraped and processed into a config file.
|
|
8
|
+
|
|
9
|
+
The node is usable with a Developer account which can be created for free at Exact Online's website. This way you can test the node however you like it without compromising your production environment.
|
|
10
|
+
After you can easily connect it with a production environment and automate your workflows.
|
|
11
|
+
|
|
12
|
+
## Exact Online
|
|
13
|
+
|
|
14
|
+
Exact Online is an ERP solution that is offered as a cloud service. Most companies that use exact use it as their main application and have all kinds of applications they use around that. Exact has been expanding over the years and they now offer Exact Online internationally.
|
|
15
|
+
|
|
16
|
+
## Install instructions
|
|
17
|
+
|
|
18
|
+
The node can be installed with the community package feature. It can also be installed manually.
|
|
19
|
+
If you need more information on that, please refer to the n8n docs.
|
|
20
|
+
|
|
21
|
+
Make sure to restart n8n when you have installed the node.
|
|
22
|
+
> :warning: **Make sure to restart n8n when you have installed the node.**
|
|
23
|
+
|
|
24
|
+
## Setup instructions
|
|
25
|
+
|
|
26
|
+
> :warning: **You need a HTTPS callback url for it to function. Exact Online does not allow you to use HTTP. Make sure you have this before starting the setup.**
|
|
27
|
+
|
|
28
|
+
> **_NOTE:_** Some of the documentation was rewritten because the production app setup is a bit different from the development app. That is also why some names and urls arent the same everywhere, I hope it is clear enough not to get you confused about changing names and such.
|
|
29
|
+
|
|
30
|
+
To setup this node you will have to create an App in Exact online. Below there is a step by step guide on how to do this.
|
|
31
|
+
In the future there might be a possibility to simply select it from the app store of Exact Online. I will be looking into getting it approved at a later date.
|
|
32
|
+
|
|
33
|
+
The Images should be clear enough for you to follow along.
|
|
34
|
+
|
|
35
|
+
Login into Exact Online by clicking on the marked button
|
|
36
|
+
|
|
37
|
+
|
|
38
|
+
|
|
39
|
+
Click on appcenter button to open the app center, this where you can connect apps.
|
|
40
|
+
|
|
41
|
+
|
|
42
|
+
|
|
43
|
+
At this point it will forward you to all the apps you can browse. You probably need to click on login in the top right again to actually login on this page.
|
|
44
|
+
|
|
45
|
+
After that you will see the manage apps button
|
|
46
|
+
Click on the manage apps button
|
|
47
|
+
|
|
48
|
+
|
|
49
|
+
|
|
50
|
+
You will then see your apps. There is a choice between production and test. Click on register an app.
|
|
51
|
+
If you do not have a choice simply click on the big + to register an app.
|
|
52
|
+
|
|
53
|
+
|
|
54
|
+
|
|
55
|
+
Open a tab with n8n and go to the Exact Online Node, if you do not have it open already.
|
|
56
|
+
Create a new credentials entry or modify an existing one in the app.
|
|
57
|
+
|
|
58
|
+
|
|
59
|
+
|
|
60
|
+
You should see the credential information. You need to fill this in, but first you need the Callback URL to be filled in into the app setup in Exact Online.
|
|
61
|
+
Copy the callback URL from n8n into Exact Online.
|
|
62
|
+
If you are registering a production app you will need to do this in this first screen that pops up. If it is a testing app this pop-up is skipped. (fill in the name and the callback url in the following screen if this step is skipped)
|
|
63
|
+
|
|
64
|
+
|
|
65
|
+
|
|
66
|
+
Fill in the rest of the information in the credentials of n8n.
|
|
67
|
+
Should look a bit like this:
|
|
68
|
+
|
|
69
|
+
Exact Online:
|
|
70
|
+
|
|
71
|
+
|
|
72
|
+
n8n:
|
|
73
|
+
|
|
74
|
+
|
|
75
|
+
After you can Click connect / reconnect and it might give you a pop-up to login to exact online if you aren't logged in yet or you need to confirm the connection / approve some terms.
|
|
76
|
+
|
|
77
|
+
## Features v1.0
|
|
78
|
+
|
|
79
|
+
All posible API requests were scraped from the Exact Online docs. This was used to create a config file. some quality of life features were added and more will be added in the future.
|
|
80
|
+
|
|
81
|
+
You can choose al Devisions your account has access to. And all data you have access to will be able to be retrieved.
|
|
82
|
+
Somtimes you do not retrieve any data that is because there is non or you do not have access.
|
|
83
|
+
|
|
84
|
+
you can use the dropdowns to select what you want to do.
|
|
85
|
+
|
|
86
|
+
|
|
87
|
+
|
|
88
|
+
when retrieving data you can add filters and choose what fields you want to include. You can both name field to be included and excluded. Some Api endpoints allow you to retrieve all fields when not selecting any and some require you to select the fields you want to include. By setting the slider to exclude the selected fields and not selecting any fields the node will automatically fetch all fields available.
|
|
89
|
+
|
|
90
|
+
|
|
91
|
+
|
|
92
|
+
|
|
93
|
+
when you want to create a new record or edit it, you will be able to add fields and select fields from a list of options for that specific resource.
|
|
94
|
+
|
|
95
|
+
|
|
96
|
+
|
|
97
|
+
## Using the scraper
|
|
98
|
+
|
|
99
|
+
- You do not need an account for the scraper.
|
|
100
|
+
- Paste the JSON into an n8n workflow.
|
|
101
|
+
- Set the Github Authorization
|
|
102
|
+
- The first time you might want to set the Github node to create the file.
|
|
103
|
+
- Start
|
|
104
|
+
- Done -> make sure to format the output file as this will improve the readability ;-)
|
|
105
|
+
|
|
106
|
+
## More info on the API
|
|
107
|
+
|
|
108
|
+
[Exact Online ref](https://start.exactonline.nl/docs/HlpRestAPIResources.aspx?SourceAction=10)
|
|
109
|
+
|
|
110
|
+
## License
|
|
111
|
+
|
|
112
|
+
[ChickenDance](https://github.com/bramkn/ExactOnline/blob/master/n8n-nodes-exact-online/LICENSE.md)
|