Importing and Exporting Custom Field Files

Starting in FileWave version 13.1 you can import and export custom field definitions. This is ideal for sharing powerful fields not built into standard inventory.

Always check a script before deploying to all devices. No, really, always!

Exporting:

  1. Open your (Assistance → Custom Fields → ) "Edit Custom Fields" UI

  2. Select one or more custom fields

  3. Press "Export" 

  4. Save the "FileWave Custom Fields.customfields" file

  5. Share online, or store for later

Importing:

  1. Download the custom field file

  2. Open your (Assistance → Custom Fields → ) "Edit Custom Fields" UI

  3. Press "import" Browse for file

  4. If the fileset contains a script, verify it is safe for your environment

  5. Associate the field with the needed device(s)

  6. You may also want to import custom field values 

See Custom Fields for more on assigning fields to devices, and importing custom field values.

Conflicts:

Custom vs Internal

FileWave will let you re-use an internal name that is the same as another inventory element.  If a Custom Field were added with an internal name of 'location', two 'location' internal names would co-exist the built-in internal name and the added Custom Field.

A prefix may be added to avoid confusion on matching inventory names.  The prefix varies depending upon the method being used to reference the internal name.

Method Prefix Example
MDM Profile custom_field %custom_field.location%
Scripted (Launch Argument or Environment Variable) CustomFields %CustomFields.location%


Custom vs Custom

If you are importing a custom field with an internal name that is the same as an existing custom field internal name you will see: 

custom field exists error.png

Just because you CAN overwrite an existing custom field doesn't mean that is a good idea. Best practice would be to import it as an additional field and resolve the conflict manually.

If the internal names are in use (Smart Groups, Inventory Queries , DEP auto) when you press "overwrite existing" you will see this telling you where it is in use:

internal_name-inuse.png


Revision #3
Created 2 July 2023 14:16:24 by Josh Levitsky
Updated 19 June 2024 09:41:46 by Sean Holden