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
TL;DR
-----
Adds the new types of custom license fields
Details
-------
Updates the docs on custom license fields to include the "Password"
and "Enum" types. Passwords are eseentially strings that are
considered sufficiently sensitive to be masked in the UI, while enums
allow you to specify a list of options for the users to choose from.
Provides more description of each type by moving the list of types
into its own section and putting the types in a table with the name,
an explanation, and the type of widget used on the "Manage Customer"
screen.
| Field | The name used to reference the field. This value cannot be changed. |
82
82
| Title| The display name for the field. This is how the field appears in the Vendor Portal and the Admin Console. You can change the title in the Vendor Portal. |
83
-
| Type| The field type. Supported formats include integer, string, text (multi-line string), and boolean values. This value cannot be changed. |
83
+
| Type| The field type. This value cannot be changed. See [Understanding
84
+
Custom License Field Types](#understanding-custom-license-field-types) for more information.
84
85
| Default | The default value for the field for both existing and new customers. It is a best practice to provide a default value when possible. The maximum size for a license field value is 64KB. |
85
86
| Required | If checked, this prevents the creation of customers unless this field is explicitly defined with a value. |
86
87
| Hidden | If checked, the field is not visible to your customer in the Replicated Admin Console. The field is still visible to you in the Vendor Portal. **Note**: The Hidden field is displayed only for vendors with access to the Replicated installers (KOTS, kURL, Embedded Cluster). |
87
88
89
+
#### Understanding Custom License Field Types
90
+
91
+
Each custom license field has a type that is used to validate its value. Some types change the widget used to edit the field when managing the customer.
| Integer | A whole number numeric value | text field |
96
+
| String | Short form text that generally fits on a single line | text field |
97
+
| Text | Longer form text that may contain multiple lines | text area |
98
+
| Boolean | True or false | checkbox |
99
+
| Password | A short string of text that is masked on display | password ||
100
+
| Enum | Provides a list of possible values | dropdown |
101
+
102
+
String, Text, Password, and Enum types are all represented as strings in the license.
103
+
88
104
### Update Custom License Fields
89
105
90
106
To update a custom license field:
@@ -138,4 +154,4 @@ To delete a custom license field:
138
154
If you enable **Preserve License Values**, you can create a new field with the same name and `type` as the deleted field to reinstate the preserved values.
139
155
:::
140
156
141
-
1. Follow the instructions in the dialog and click **Delete**.
157
+
1. Follow the instructions in the dialog and click **Delete**.
0 commit comments