Creating a Custom/Source Only Packages ACE
AdminStudio 2022 | 23.0 | Application Manager
Edition:This functionality is included in the AdminStudio Professional and Enterprise Editions.
You can create a user-defined ACE to apply to Source Only Packages. One common task you may want to create a Source Only Packages ACE to handle is to identify packages which create a desktop icon.
Application Catalog supports external package conflict checking for Custom - Source Only Packages ACEs. The Source package can be selected from the Application Catalog database or from an external package.
To create a Source Only Packages ACE that identifies desktop icon creation:
| 1. | Launch Application Catalog. |
| 2. | On the Application Catalog tab menu, click Options. The Options dialog box opens. |
| 3. | On the ACE Tests tab, click the View Rules button. The Rules Viewer dialog box opens. |
| 4. | Click the New button. The Rules Wizard opens. |
| 5. | Complete the wizard panels to create your ACE: |
| a. | On the General Information panel, enter the following values: |
|
Option |
Value |
|
Name |
MYACE |
|
Associated Table |
csmsiShortcut |
|
Package Type |
MSI |
|
Brief Description |
MYACE - Find desktop icons |
|
Description |
Locates package that create desktop icons. |
|
Information URL |
http://www.yourcompany.com/MYACE.htm |
| b. | On the Additional Information panel, enter the following values: |
|
Option |
Value |
|
Category |
Shortcuts |
|
Rule Type |
Custom - Source Only Packages |
| c. | On the Custom Options panel, enter the following values: |
|
Option |
Value |
|
Error String |
Desktop icons [Name] are not allowed. |
|
Display String |
A desktop icon called [Name] is created. |
|
Severity |
Warning |
|
Report ‘No’ Results |
Deselected |
In the example above, [Name] is a token. Tokens allow you to insert values at run-time from the internal Application Catalog Database or from an external MSI package into the Error or Display string. To use token replacement in a string, click the arrow to the right of the Error String and Display String text boxes and select a column name from the list. The column name is then inserted into the string in the following format: [ColumnName].
The Token list is provided for your convenience; if you prefer, you can type the tokens directly in the text boxes. You could also use the [ProductName] pseudo-token to insert the name of the package in a message, even though ProductName is not a table column name.
Note:For more information, see Token Grammar
| d. | On the Where Clause panel, in the Where Clause panel, click Build Expression. The Expression Builder dialog box opens. |
| e. | In the Expression Builder, enter the following values: |
|
Option |
Value |
|
Table Columns |
[Directory_] |
|
Comparison Operator |
= (Equal To) |
|
String Constant |
DesktopFolder |
| f. | Click OK to close the Expression Builder and return to the Where Clause panel. The expression that you just built is now displayed in the Where Clause text box: |
[Directory_] = 'DesktopFolder'
When you are constructing simple expressions, it is helpful to use the Expression Builder dialog box, but you are not limited to the formatting options that the Expression Builder provides to you. If you know how to write Where clauses in SQL, you can use significantly more powerful expressions by entering them directly in the Where Clause text box on the Where Clause panel or on the Where Clause tab of the ACE Rule Properties Dialog Box.
| g. | Click the Test button to validate the expression. |
| h. | On the Summary panel, review the summary of your new ACE and click the Finish button. |
| 6. | Click the Close button. The Rules Viewer dialog box closes. |
This new user-created ACE is now available for use in subsequent testing.
See Also