Skip to content

Commit c51407b

Browse files
sixhobbitssixhobbits
authored
Merge pull request #489 from ritza-co/hotfix-mapping-changes
Add mapping 5.0 and 6.0 changes
2 parents 419f645 + e372043 commit c51407b

File tree

6 files changed

+102
-6
lines changed

6 files changed

+102
-6
lines changed

‎docs/integration/external-integrations/freshservice-integration/customize-freshservice.mdx‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -14,7 +14,7 @@ This page covers advanced data mapping customization and XML file editing.
1414

1515
## Manage Customization with Newer Releases
1616

17-
The Device42-Freshservice integration ships with a default mapping file. Newer versions of the mapping file may include sending additional elements to Freshservice (such as assets, devices, CIs, and metadata). We share these new additions in the [Freshservice mapping release notes](/release-notes/freshservice-mapping/mapping-4.0).
17+
The Device42-Freshservice integration ships with a default mapping file. Newer versions of the mapping file may include sending additional elements to Freshservice (such as assets, devices, CIs, and metadata). We share these new additions in the [Freshservice mapping release notes](/release-notes/freshservice-mapping/mapping-4.0-changes).
1818

1919
If you make an adjustment and use a custom XML file, Device42 will not update the custom XML during updates.
2020

docs/release-notes/freshservice-mapping/mapping-3.0.mdx renamed to docs/release-notes/freshservice-mapping/mapping-3.0-changes.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
22
title: "Changes in Version 3.0"
3-
sidebar_position: 2
3+
sidebar_position: 3
44
---
55

66
These are the changes to the `mapping.xml` file that version 3.0 has from version 2.0

docs/release-notes/freshservice-mapping/mapping-4.0.mdx renamed to docs/release-notes/freshservice-mapping/mapping-4.0-changes.mdx

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
2-
title: "Changes in Version 4.0 (CC5.1.0)"
3-
sidebar_position: 1
2+
title: "Changes in Version 4.0 (CC 5.1.0)"
3+
sidebar_position: 2
44
---
55

66
The following changes to the `mapping.xml` file are part of the Cloud Connector 5.1.0 release.
@@ -38,13 +38,13 @@ Two changes were made within the `D42 VMware VCenter Disk to Freshservice VMware
3838
- The `item_id` value in the DOQL query was changed from the following:
3939

4040
```
41-
resource.details ->> 'uuid' AS item_id,
41+
resource.details ->> 'uuid' AS item_id,
4242
```
4343

4444
To the following:
4545

4646
```
47-
resource.identifier AS item_id,
47+
resource.identifier AS item_id,
4848
```
4949

5050
- The `WHERE` clause in the DOQL query was updated from the following:

‎docs/release-notes/freshservice-mapping/mapping-5.0-changes.mdx‎

Lines changed: 51 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,51 @@
1+
---
2+
title: "Changes in Version 5.0 (CC5.1.2)"
3+
sidebar_position: 1
4+
---
5+
6+
The following changes to the `mapping.xml` file are part of the Cloud Connector 5.1.2 release (CC 5.1.2).
7+
8+
If you are using a custom mapping.xml file, you need to manually apply these updates. See [Manage Customization with Newer Releases](/integration/external-integrations/freshservice-integration/customize-freshservice#manage-customization-with-newer-releases).
9+
10+
## Obsolete Field Attributes Removed
11+
12+
The following field element attributes were removed from all field mappings because null and blank values are no longer sent to Freshservice by default.
13+
14+
- `not-null`
15+
- `skip-if-null`
16+
- `set-space`
17+
18+
## Examples
19+
20+
The examples below show field elements with these attributes removed.
21+
22+
### Example 1: `set-space` Attribute Removed
23+
24+
- Version 4.0:
25+
26+
```xml
27+
<field resource="name" source-type="string" target="name" target-type="string" target-header="General"
28+
set-space="true" min-length="1" max-length="248" escape="true"/>
29+
```
30+
31+
- Version 5.0:
32+
33+
```xml
34+
<field resource="name" source-type="string" target="name" target-type="string" target-header="General"
35+
min-length="1" max-length="248" escape="true"/>
36+
```
37+
38+
### Example 2: `not-null` and `skip-if-null` Attributes Removed
39+
40+
- Version 4.0:
41+
42+
```xml
43+
<field resource="used_by" source-type="string" target="user_email" target-type="string"
44+
not-null="true" skip-if-null="true"/>
45+
```
46+
47+
- Version 5.0:
48+
49+
```xml
50+
<field resource="used_by" source-type="string" target="user_email" target-type="string"/>
51+
```

‎docs/release-notes/freshservice-mapping/mapping-6.0-changes.mdx‎

Lines changed: 37 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,37 @@
1+
---
2+
title: "Changes in Version 6.0 (CC 5.2.0)"
3+
sidebar_position: 0
4+
---
5+
6+
The following two changes to the `mapping.xml` file were made as part of the Cloud Connector 5.2.0 release (CC 5.2.0).
7+
8+
If you are using a custom `mapping.xml` file, you need to manually apply these updates. See [Manage Customization with Newer Releases](/integration/external-integrations/freshservice-integration/customize-freshservice#manage-customization-with-newer-releases).
9+
10+
## Change to the Azure Network Interface Task
11+
12+
Regarding this Azure Network Interface task:
13+
14+
```html
15+
<task enable="true" name="D42 Azure Network Interface to Freshservice Azure Network Interface" type="asset" description="Copy Azure Network Interface from Device42 to Freshservice" d42_min_version="19.04.00">
16+
```
17+
18+
The DOQL `SELECT` statement of the `<resource>` element was changed from:
19+
20+
```sql
21+
netport.details ->> 'mac_address' AS mac_address,
22+
```
23+
24+
To the following:
25+
26+
```sql
27+
netport.hwaddress AS mac_address,
28+
```
29+
30+
## Additional Tasks Added
31+
32+
Two tasks were added to delete software installations that no longer exist in Device42:
33+
34+
```xml
35+
<task enable="true" type="software_installation" description="Delete software installations from Freshservice that do not exist in Device42" d42_min_version="16.19.00">
36+
<task enable="true" type="software_installation" description="Delete software installations from Freshservice that do not exist in Device42" d42_max_version="16.18.02">
37+
```

‎docusaurus.config.js‎

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -63,6 +63,14 @@ const config = {
6363
'@docusaurus/plugin-client-redirects',
6464
{
6565
redirects: [
66+
{
67+
to: '/release-notes/freshservice-mapping/mapping-3.0-changes/',
68+
from: ['/release-notes/freshservice-mapping/mapping-3.0/'],
69+
},
70+
{
71+
to: '/release-notes/freshservice-mapping/mapping-4.0-changes/',
72+
from: ['/release-notes/freshservice-mapping/mapping-4.0/'],
73+
},
6674
{
6775
to: '/getstarted/getting-started-with-auto-discovery/',
6876
from: ['/getstarted/getting-started-with-a-blank-slate/'],

0 commit comments

Comments
 (0)