Merge pull request #474 from ritza-co/19.07.05

Docs 19.07.05 release (Week 38, 2025)

Author: sixhobbits

docs/auto-discovery/database-discovery/index.mdx

@@ -7,7 +7,7 @@ import useBaseUrl from '@docusaurus/useBaseUrl'
 
 ## About Database Discovery
 
-Database (DB) discovery currently supports Windows and \*nix-based discovery jobs detecting Microsoft SQL (aka MSSQL), Oracle, Postgres SQL, and DB2 databases.
+Database (DB) discovery currently supports Windows and \*nix-based discovery jobs detecting Microsoft SQL (aka MSSQL), Oracle, PostgreSQL, and DB2 databases.
 
 :::note
 Database discovery requires an **Application Dependency Mapping** license. Go to **Tools > Settings > Licensing** to see if the license is enabled. Contact [[email protected]](mailto:[email protected]) for licensing assistance.
@@ -453,22 +453,22 @@ We've made the following changes to the UI:
 
 We previously gathered all Oracle users and collected them as "Device42 Databases." Then, we only retrieved Oracle users that had at least one associated database object, and from there, we implemented changes to ignore user schemas. As a result, some Oracle database connections may no longer show under specific user schemas. These 'orphaned' database connections now map to the main database instance, instead of mapping to a specific **Database/Schema** resource. While they’re not linked to individual schemas anymore, key details like the user login and schema names are still preserved in the database instance details.
 
-## Postgres SQL Database Discovery (on \*nix targets)
+## PostgreSQL Database Discovery (on \*nix targets)
 
-Device42 offers Postgres SQL database discovery for \*nix discovery targets, although it requires a separate set of credentials to authenticate to the database instance itself. Ensure these additional credentials have the appropriate permissions for viewing the databases you are interested in discovering.
+Device42 offers PostgreSQL database discovery for \*nix discovery targets, although it requires a separate set of credentials to authenticate to the database instance itself. Ensure these additional credentials have the appropriate permissions for viewing the databases you are interested in discovering.
 
-### Minimum Permissions Requirements for Postgres SQL Discovery
+### Minimum Permissions Requirements for PostgreSQL Discovery
 
 For discovery to return detailed information about your database instance, you will need access to the following tables:
 
-* `pg_database`
-* `pg_tablespace`
-* `pg_stat_activity`
-* `init_server_addr` (function)
+* `pg_database` (table)
+* `pg_tablespace` (table)
+* `pg_stat_activity` (table)
+* `⁠inet_server_addr()` (function)
 
-### Set Up Your Postgres SQL Discovery Job
+### Set Up Your PostgreSQL Discovery Job
 
-To begin discovering your Postgres SQL databases, create a new discovery job for \*nix targets, and be sure to enable database discovery by checking the **Collect database server information** checkbox.
+To begin discovering your PostgreSQL databases, create a new discovery job for \*nix targets, and be sure to enable database discovery by checking the **Collect database server information** checkbox.
 
 Fill out both sets of credentials:
 
@@ -503,7 +503,7 @@ sources={{
 }}
 />
 
-### View Postgres SQL Database Discovery Job Results
+### View PostgreSQL Database Discovery Job Results
 
 When the job finishes, the most direct way to view the results of your database discovery is via the discovered Postgres application components themselves. On the Device42 main menu, select **Applications > Application Components**. If you don’t see your Postgres DB instances at the top of the list, you can search for "Postgres" to narrow down the list, or filter the list **By Category > Database**.
 

docs/auto-discovery/warranty-autodiscovery.mdx

@@ -25,7 +25,7 @@ To configure automatic warranty discovery, you need to request API keys from the
 
 ### Detailed Warranty Sync Instructions
 
-Device42 supports warranty autodiscovery for the following vendors:**
+Device42 supports warranty autodiscovery for the following vendors:
 
 - Dell
 - IBM

docs/getstarted/installation/security-posture-and-high-level-permissions.mdx

@@ -15,4 +15,4 @@ The section outlines how Device42 ensures data security in transit and at rest,
 
 Device42 uses the principle of least privilege in its agentless discovery.
 
-For a detailed overview of permissions, please reference our prerequisites guide or use the **Discovery** section on our website to locate the relevant jobs and view their required permissions.
+For a detailed overview of permissions, please refer to the [**Discovery** section](/auto-discovery/index.mdx) to locate the relevant jobs and view their required permissions.

docs/infrastructure-management/mobile-inventory/printing-qr-codes-from-firefox.mdx

@@ -1,27 +1,39 @@
 ---
-title: "Printing QR Codes from firefox"
+title: "Printing QR Codes from Firefox"
 sidebar_position: 5
 ---
 
-Printing from firefox is mostly straight forward with a few required margin and format settings as shown below.
+import ThemedImage from '@theme/ThemedImage';
+import useBaseUrl from '@docusaurus/useBaseUrl';
 
-### Print dpi should match the dpi in printer settings.
+Printing from Firefox is straightforward, with a few recommended margin and format settings, as shown below.
 
-![wpid934-Print_dpi_should_match_the_dpi_in_printer_settings.png](/assets/images/wpid934-Print_dpi_should_match_the_dpi_in_printer_settings.png)
+## DPI Settings in QR Code Profile and Printer
 
-![wpid931-media_1341526292540.png](/assets/images/wpid931-media_1341526292540.png)
+The **Print DPI** of the QR Code Profile used to generate the QR code should match the DPI in your printer settings.
+
+<ThemedImage
+  alt="Print DPI settings"
+  sources={{
+    light: useBaseUrl('/assets/images/printing-qr-codes-from-firefox/print-dpi-settings-light.png'),
+    dark: useBaseUrl('/assets/images/printing-qr-codes-from-firefox/print-dpi-settings-dark.png'),
+  }}
+/>
 
-### Page Setup
+![wpid931-media_1341526292540.png](/assets/images/wpid931-media_1341526292540.png)
 
-![wpid932-Page_Setup.png](/assets/images/wpid932-Page_Setup.png)
+## Firefox Print Page Setup
 
-![wpid930-media_1340198201622.png](/assets/images/wpid930-media_1340198201622.png)
+In Firefox, you can choose **File > Print...** or click the **Print** button on the QR code page to print the label.
 
-From Menu > Print > Page Setup, choose settings as shown in images above.  
-Landscape mode. Empty out headers and footers. Print background colors and images. Enable shrink-to-fit. Zero margins.
+![QR codes with print label](/assets/images/printing-qr-codes-from-firefox/qr-code-example.png)
 
-### Printing
+Set up the print page with the following recommended settings:
 
-![wpid933-Printing.png](/assets/images/wpid933-Printing.png)
+- Landscape mode
+- Enable **Fit to page width** (shrink-to-fit)
+- No margins
+- Deselect the **Print headers and footers** option
+- Select **Print backgrounds** 
 
-You can choose Menu > Print or print from the QR code page to print the label.
+![Print settings for QR codes in Firefox](/assets/images/printing-qr-codes-from-firefox/printer-settings.png)

docs/infrastructure-management/mobile-inventory/understanding-qr-and-bar-codes-in-device42.mdx

@@ -1,54 +1,107 @@
 ---
-title: "Understanding QR and Bar Codes in Device42"
+title: "Understanding QR and Barcodes in Device42"
 sidebar_position: 6
 ---
 
-QR codes printed by device42 contain a mobile friendly url to the object in question. You can choose to also print text with the QR code for easier inventory.
+import ThemedImage from '@theme/ThemedImage';
+import useBaseUrl from '@docusaurus/useBaseUrl';
 
-### QR Code profiles
+QR codes printed by Device42 contain a mobile-friendly URL linking to the object in question. You can also choose to print text with the QR code for easier inventory.
 
-![QR Code profiles](/assets/images/wpid5886-QR_Code_profiles.png)
+You can create multiple QR code and barcode profiles. You can then either assign one profile per device or asset, or you can assign QR profiles in bulk from the device and asset list pages under the **Resources** menu.
 
-You can create multiple QR code and bar code profiles. You can then either assign one profile per device / asset or you can assign QR profiles in bulk in the Device and Asset List Pages.
+## Creating a QR Code Profile
 
-To create or modify a QR or bar code profile, go to Tools > Templates and Bulk Operations > QR Profiles.
+To create or modify a QR or barcode profile, go to **Tools > Templates & Bulk Operations > QR Profiles**.
 
-When adding/changing a QR profile or bar code, the following options are presented:
+When adding or editing a QR profile or barcode, you have the following options:
 
-**Name** : Use a descriptive name so it will be easier to pick when editing a device or asset.
+- **Name:** Use a descriptive name for easily identifying the specific device or asset.
 
-**Base url** : This is the the base url embedded in the QR code to manage the inventory from mobile devices. The program will initially try to guess it from the current page url and you can modify it.
+- **Base URL:** This is the base URL embedded in the QR code to manage the inventory from mobile devices. The program will initially try to guess it from the current page URL, and you can modify it.
 
-**Print dpi** : This is critical for printing. Ideally this should match the print dpi for the label printer settings, but there is a glitch with IE that is discussed in one of the following sections.
+- **Print DPI:** This is critical for printing. Ideally, it should match the print DPI for the label printer settings, but there is a glitch with IE that is discussed in one of the following sections.
 
-**Include Text** : Text will only print if this is checked.
+    <ThemedImage
+    alt="QR Code profile"
+    sources={{
+        light: useBaseUrl('/assets/images/understanding-qr-and-bar-codes-in-device42/qr-code-profiles-light.png'),
+        dark: useBaseUrl('/assets/images/understanding-qr-and-bar-codes-in-device42/qr-code-profiles-dark.png'),
+    }}
+    />
 
-**Include Name in Text** : Includes the name of the device or asset in text print.
+- **Include Text:** Text will only print if this is checked.
 
-**Include Device Model in Text** : Includes the hardware model name for the device in text print.
+- **Include Name in Text:** Selecting this option includes the name of the device or asset in text print.
 
-**Include Serial # in Text** : Includes the serial # for that object in text print.
+- **Include Device Model in Text:** Selecting this option includes the hardware model name for the device in text print.
 
-**Include Hostname # in Text** : Includes the hostname for that object in text print.
+- **Include Serial # in Text:** Selecting this option includes the serial # for the device or asset in text print.
 
-**Custom Text** : You can add multiple custom text values to print with QR code label. Please note that if text overflows, all the overflow would be cutoff and not printed.
+- **Include Hostname # in Text:** Selecting this option includes the hostname for the device or asset in text print.
 
-You can also add to the QR / bar code the field names and values of any custom fields defined for the device or asset.
+    <ThemedImage
+    alt="QR Code profile checkboxes"
+    sources={{
+        light: useBaseUrl('/assets/images/understanding-qr-and-bar-codes-in-device42/qr-code-profiles-checkboxes-light.png'),
+        dark: useBaseUrl('/assets/images/understanding-qr-and-bar-codes-in-device42/qr-code-profiles-checkboxes-dark.png'),
+    }}
+    />
 
-Last you can define a Label profile and value for the QR or bar code.
+- **Custom fields:** Add the field names and values of any custom fields defined for the device or asset.
 
-### Assigning QR profiles to devices or assets.
+    <ThemedImage
+    alt="QR Code profile custom fields"
+    sources={{
+        light: useBaseUrl('/assets/images/understanding-qr-and-bar-codes-in-device42/qr-code-profiles-custom-fields-light.png'),
+        dark: useBaseUrl('/assets/images/understanding-qr-and-bar-codes-in-device42/qr-code-profiles-custom-fields-dark.png'),
+    }}
+    />
 
-![Assigning QR profiles to devices or assets.](/assets/images/wpid5882-Assigning_QR_profiles_to_devices_or_assets.png)
+- **Custom Text for QR Label Profile:** You can add multiple custom text values to print with the QR code label. Please note that if text overflows, all the overflow would be cut off and not printed.
 
-Under Asset LM(meaning Asset lifecycle management) tab for devices, you will see the QR profiles as the last option.
+    <ThemedImage
+    alt="QR Code label profile"
+    sources={{
+        light: useBaseUrl('/assets/images/understanding-qr-and-bar-codes-in-device42/qr-code-profiles-label-profile-light.png'),
+        dark: useBaseUrl('/assets/images/understanding-qr-and-bar-codes-in-device42/qr-code-profiles-label-profile-dark.png'),
+    }}
+    />
 
-![](/assets/images/wpid5884-media_1343005349237.png)
+## Assigning QR Profiles to Devices and Assets
 
-![](/assets/images/wpid5885-media_1343005380574.png)
+For devices, under the **Details** information section, you can select a **QR Profile** to generate the QR code or barcode.
 
-### Bulk QR codes
+<ThemedImage
+  alt="Assigning QR profiles"
+  sources={{
+    light: useBaseUrl('/assets/images/understanding-qr-and-bar-codes-in-device42/assigning-qr-profiles-light.png'),
+    dark: useBaseUrl('/assets/images/understanding-qr-and-bar-codes-in-device42/assigning-qr-profiles-dark.png'),
+  }}
+/>
 
-![Bulk QR codes](/assets/images/wpid5883-Bulk_QR_codes.png)
+For assets, you can select a **QR Profile** under the dedicated **Asset QR/Barcode** section.
 
-We will discuss bulk QR code printing in one of next chapters in detail. You can assign QR codes in bulk to devices or assets from the device or asset view page.
+<ThemedImage
+  alt="Assigning QR profiles"
+  sources={{
+    light: useBaseUrl('/assets/images/understanding-qr-and-bar-codes-in-device42/assigning-qr-profiles-assets-light.png'),
+    dark: useBaseUrl('/assets/images/understanding-qr-and-bar-codes-in-device42/assigning-qr-profiles-assets-dark.png'),
+  }}
+/>
+
+When you save the device or asset, click the associated profile link to preview and print the QR code or barcode.
+
+![QR code generation](/assets/images/understanding-qr-and-bar-codes-in-device42/qr-code-generation.png)
+
+## Bulk Assigning QR Codes
+
+You can assign QR codes or barcodes in bulk to devices or assets from the device or asset view page. See the [Bulk QR Code Printing page](infrastructure-management/mobile-inventory/bulk-qr-printing.mdx) for more details.
+
+<ThemedImage
+  alt="Bulk QR codes"
+  sources={{
+    light: useBaseUrl('/assets/images/understanding-qr-and-bar-codes-in-device42/bulk-qr-codes-light.png'),
+    dark: useBaseUrl('/assets/images/understanding-qr-and-bar-codes-in-device42/bulk-qr-codes-dark.png'),
+  }}
+/>

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

@@ -12,6 +12,10 @@ This page covers advanced data mapping customization and XML file editing.
 - For usage and operations, see [Using the Freshservice Integration](use-freshservice-integration.mdx).
 :::
 
+If you make an adjustment and use a custom XML file, Device42 will not update the custom XML during updates. 
+
+If you want to incorporate updates, you'll need to do so manually: Download the current XML file, compare it to your customized XML file, and add in the new items as needed.
+
 ## Custom Data Mapping
 
 ### Download the `mapping.xml` File

docs/integration/imports/index.mdx

@@ -6,8 +6,6 @@ This section provides information on how to import various types of data into De
 
 - **General Import**: Refer to [Spreadsheet Import and Exports](spreadsheet-imports-and-exports.mdx) for instructions on importing, editing, and exporting data.
 
-- **Legacy Imports**: If you're working with the legacy Microsoft 97-2003 XLS format, follow the instructions in [Legacy Imports](legacy-imports/index.mdx) for importing data.
-
 - **Using the Generic Spreadsheet Import Tool**: Use the [Generic Spreadsheet Import Tool](spreadsheet-converter-tool.mdx) to load existing XLS, XLSX, and CSV data into Device42.
 
 - **Bulk Changes**: Make bulk changes to devices by utilizing the "Do a re-importable export for selected devices" option. See [Using the re-importable export feature](using-the-re-importable-export-feature.mdx) for an example of renaming multiple devices using this feature.