Creating Other Custom Properties
Execute the following in SQL Server Management Studio against your FNMSCompliance database. The relative anchor from which positioning is determined must already be defined.
EXEC dbo.AddPropertyToWebUIPropertiesPage
@TargetTypeID = TargetTypeID,
@ExcludeTargetSubTypeIDs = 'TargetSubTypeID,TargetSubTypeID,...',
@Name = 'InternalFieldName',
@CultureType = 'ISOCultureCode',
@DisplayNameInPage = 'Prompt value',
@DisplayNameInReport = 'Column heading',
@TabName = 'MyTabName',
@UIInsertTypeID = UIFieldTypeID,
@UIFieldTypeID = UIFieldTypeID,
@RelativePositionTo = 'RelativePositionTo',
@SequenceNumber = 'IntegerCount',
@Position = Position,
@Width = Width,
@DataSource = 'List, Of, Values',
@DataSourceDelimiter = ',',
@Required = 0,
@StringLength = IntegerMaxLength,
@ReadOnly = 0
Type | Description |
---|---|
@TargetTypeID | Mandatory. Integer that identifies the type of object to which you are
adding a custom property. For supported objects and their integer equivalents
for TargetTypeID , see Objects You Can Customize. |
@ExcludeTargetSubTypeIDs |
Mandatory. A comma-separated list (enclosed in single quotation marks)
of integer subtype IDs. For the default case of no exclusions, give this
parameter an empty
list:
Many
types of target objects have subtypes (for example, assets may be
workstations, routers, and so on). By default, a custom property added to an
object (identified by its TargetTypeID ) is added to all
subtypes of that object. However, you can exclude any subtypes you choose
with this parameter. For supported subtypes and their integer equivalents
for TargetSubTypeID , see Objects You Can Customize. |
@Name | Mandatory. The internal name (used in code and database) of the new custom
property you are adding. This name must be unique across all properties in the
system (including the factory-supplied properties, across all database objects).
For this reason, it is strongly recommended that you adopt a stringent naming
convention, such as a company name space, an object type, and a property name,
(example: MyCoLicenseDailyCharge ). The name is limited to 256
characters, and only alphanumeric ASCII characters
(A-Z, a-z, and
0-9) are acceptable. Using any other characters
results in an error
message:
Tip: Keep in mind that this name is internal, and not displayed to
operators. For names visible to others, see
@DisplayNameInPage and
@DisplayNameInReport below, both of which support a
wider range of characters.
|
@CultureType | Default value is en-US . Value is a five-character ISO
code for culture (enclosed in single quotation marks). The permitted values are
available at http://msdn.microsoft.com/en-us/goglobal/bb896001.aspx. |
@DisplayNameInPage | Mandatory. This is the label (enclosed in single quotation marks)
displayed as a prompt in the web interface for FlexNet Manager Suite when the culture setting for the interface matched the one
you declare in CultureType . You can also provide localized
values for this label using different culture settings, for which see Localizing Display Names of Custom Properties. |
@DisplayNameInReport | Mandatory. This is the label (enclosed in single quotation marks)
displayed as a column heading in custom reports you prepare, when the culture
setting for the interface matched the one you declare in
CultureType . You can also provide localized values for this
label using different culture settings, for which see Localizing Display Names of Custom Properties. |
@TabName |
Optional when |
@UIInsertTypeID | Mandatory. An integer indicating the position of this new section relative
to the control identified in RelativePositionTo . For integer
values and their meaning, see Positioning Your Custom Control. Note that in this case
of creating a new section, the value 3 means at the start of
the tab identified in TabName , meaning that
RelativePositionTo is irrelevant in that case. |
@UIFieldTypeID | Mandatory. An integer indicating the kind of control used to display your custom property. For integer values and their meaning, see Controls You Can Add. |
@RelativePositionTo | Mandatory. The internal name of the anchor control relative to which you are positioning your new custom section. For internal names of factory-supplied controls, see the subtopics under Positioning Your Custom Control. |
@SequenceNumber |
Optional (when omitted, the default value is null). Where two or more custom properties are declared with the same anchor in their @RelativePositionTo parameters, they are ordered by the sequence number. If there is no sequence number declared, they are ordered by the execution order of the SQL commands. |
@Position | Optional (when omitted, the default value is 0 ). The
alignment of your custom control within the two-column layout of a properties
page. For the integer values and their meanings, see Positioning Your Custom Control. |
@Width | Optional (when omitted, the default value is 1 ). The
number of columns spanned by this control in the two-column layout of a
properties page. For more information, see Positioning Your Custom Control. |
@DataSource | Mandatory when UIFieldTypeID = 8 , and otherwise ignored.
Within single quotes, this is an ordered list of the values to be displayed
within the option list. By default, the list is comma-separated, but see
@DataSourceDelimiter. Values (between delimiters) may
include white space, and leading white space on a value is ignored. Every value
must be unique. One of the values may be a null, creating a blank row in the
drop-down list in the web interface. Example:
This example creates a drop-down list with the first position blank (this
displays an empty value until the operator selects another value from the
list).Restriction: When you add a custom drop-down list (when
UIFieldTypeID = 8 ), it is not possible to localize the
values for the individual options within the custom drop-down list. (This is
in contrast to adding a custom option within a drop-down list included in
the standard product: the standard lists allow for customization of any
options, including added custom options; whereas drop-down lists that are in
entirety custom cannot be localized.) |
@DataSourceDelimiter |
Optional (when omitted, the default value is the comma
,). A single ASCII character (a punctuation
character is expected) that does not occur in your data set and is used as a
delimiter between values in @DataSource. The separator
character must be enclosed in single quotation marks. If
|
@Required |
Optional (when omitted, the default value is zero). May have the following
values:
Note: This parameter affects only data input through the web interface of FlexNet Manager Suite. It does not have any
effect, for example, on data imports using the Business Importer.
|
@StringLength |
Optional (when omitted, the default value is |
@ReadOnly |
Optional (when omitted, the default value is zero). May have the following
values:
|
FlexNet Manager Suite (On-Premises)
2023 R2