You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: README.md
+9-9
Original file line number
Diff line number
Diff line change
@@ -1,7 +1,7 @@
1
1
[Device42](http://www.device42.com/) is a Continuous Discovery software for your IT Infrastructure. It helps you automatically maintain an up-to-date inventory of your physical, virtual, and cloud servers and containers, network components, software/services/applications, and their inter-relationships and inter-dependencies.
2
2
3
3
4
-
This repository contains script that helps you sync data from Device42 to FreshService.
4
+
This repository contains script that helps you sync data from Device42 to Freshservice.
5
5
6
6
### Download and Installation
7
7
-----------------------------
@@ -44,26 +44,26 @@ Once the packages are installed and the script is configured, the script can be
44
44
45
45
### Configuration
46
46
-----------------------------
47
-
Prior to using the script, it must be configured to connect to your Device42 instance and your FreshService instance.
47
+
Prior to using the script, it must be configured to connect to your Device42 instance and your Freshservice instance.
48
48
* Save a copy of mapping.xml.sample as mapping.xml.
49
-
* Enter your URL, User, Password, API Keyin the FreshService and Device42 sections (lines 2-10).
50
-
API Key can be obtained from FreshService profile page
49
+
* Enter your URL, User, Password, API Key, and default approver email address in the Freshservice and Device42 sections (lines 2-11).
50
+
API Key can be obtained from Freshservice profile page
51
51
52
52
Below the credential settings, you’ll see a Tasks section.
53
-
Multiple Tasks can be setup to synchronize various CIs from Device42 to FreshService.
53
+
Multiple Tasks can be setup to synchronize various CIs from Device42 to Freshservice.
54
54
In the <api> section of each task, there will be a <resource> section that queries Device42 to obtain the desired CIs.
55
55
Full documentation of the Device42 API and endpoints is available at https://api.device42.com.
56
56
Individual tasks within a mapping.xml file can be enabled or disabled at will by changing the `enable="true"` to `enable="false"` in the <task> section.
57
57
58
-
Once the Device42 API resource and FreshService Target are entered, the <mapping> section is where fields from Device42 (the `resource` value) can be mapped to fields in FreshService (the `target` value).
58
+
Once the Device42 API resource and Freshservice Target are entered, the <mapping> section is where fields from Device42 (the `resource` value) can be mapped to fields in Freshservice (the `target` value).
59
59
It is very important to adjust the list of default values in accordance between freshservice and device 42 (for example, service_level).
60
60
61
61
After configuring the fields to map as needed, the script should be ready to run.
62
62
63
63
### Gotchas
64
64
-----------------------------
65
-
*FreshService API Limit is 1000 calls per hour (https://api.freshservice.com/#ratelimit)
66
-
* Due to the nature of FreshService rate limits, large inventories may take extended periods of time to migrate
65
+
*Freshservice API Limit is 1000 calls per hour (https://api.freshservice.com/#ratelimit)
66
+
* Due to the nature of Freshservice rate limits, large inventories may take extended periods of time to migrate
67
67
68
68
Please use the following table as a reference only, actual times may vary due to request limit cooldowns and other internal API calls
69
69
@@ -82,7 +82,7 @@ Please use the following table as a reference only, actual times may vary due to
82
82
83
83
### Info
84
84
-----------------------------
85
-
* mapping.xml - file from where we get fields relations between D42 and FreshService
85
+
* mapping.xml - file from where we get fields relations between D42 and Freshservice
86
86
* devicd42.py - file with integration device42 instance
87
87
* freshservice.py - file with integration freshservice instance
88
88
* d42_sd_sync.py - initialization and processing file, where we prepare API calls
0 commit comments