Adds hidden-ifunset option to ui_visibility argument of custom_fields (#1048)

* Adds hidden-ifunset option to ui_visibility argument of custom_fields

* adding integration test for ui_visibility feature

Author: aaron-iles

docs/plugins/netbox_custom_field_module.rst

@@ -655,6 +655,7 @@ Parameters
       - :ansible-option-choices-entry:`"read-write"`
       - :ansible-option-choices-entry:`"read-only"`
       - :ansible-option-choices-entry:`"hidden"`
+      - :ansible-option-choices-entry:`"hidden-ifunset"`
 
 
       .. raw:: html

plugins/modules/netbox_custom_field.py

@@ -114,6 +114,7 @@
            - read-write
            - read-only
            - hidden
+           - hidden-ifunset
          type: str      
          version_added: "3.10.0"
       validation_minimum:
@@ -250,6 +251,7 @@ def main():
                             "read-write",
                             "read-only",
                             "hidden",
+                            "hidden-ifunset",
                         ],
                         type="str",
                     ),

tests/integration/targets/v3.5/tasks/netbox_custom_field.yml

@@ -106,3 +106,23 @@
       - test_five['diff']['after']['state'] == "absent"
       - test_five['custom_field']['name'] == "A_CustomField"
       - test_five['msg'] == "custom_field A_CustomField deleted"
+
+- name: "CUSTOM_FIELD 6: UI Visibility (hidden-ifunset)"
+  netbox.netbox.netbox_custom_field:
+    netbox_url: http://localhost:32768
+    netbox_token: 0123456789abcdef0123456789abcdef01234567
+    data:
+      content_types:
+        - "dcim.device"
+      name: A_CustomField
+      type: text
+      ui_visibility: hidden-ifunset
+    state: present
+  register: test_six
+
+- name: "CUSTOM_FIELD 6: UI Visibility (hidden-ifunset)"
+  assert:
+    that:
+      - test_six is changed
+      - test_six['custom_field']['name'] == "A_CustomField"
+      - test_six['custom_field']['ui_visibility'] == "hidden-ifunset"