Application Management
An application represents the link between what your team is actually developing and all the information that can be provided. You’ll generally want this to be one-to-one. That is for every application your team is developing, you should create an application via the IQ Server. While this application is merely a representation of the real thing, it’s no less important.
At the application level, you can do nearly everything you can for an organization. This includes creating policies and all the associated details. Additionally, whenever you perform an evaluation, and a report is generated, all that information will be associated to a specific application.
Creating an Application
As a general rule with any activity, make sure you have proper access to the IQ Server. In the case of application creation, you will need to be a member of a role that has been granted the Edit IQ Elements permission. In the roles provided by default, this would be the Owner role for an organization.
When you create an application, you can assign the following items for identifying it:
- Application Name - The name that appears in the sidebar and at the top of the Organization & Policies area when the application is selected.
- Application ID - A unique identifier that’s used by integration tools (e.g. Lifecycle for Bamboo, Lifecycle for IDEA, REST APIs and more) when performing component evaluations.
- Icon - A graphical representation of the application that appears at the top of the Organization & Policies area (when the application is selected in the sidebar) and in Reporting. You can select from the default icon, a robot icon, or a custom icon.
To create an application:
1. Click the Organization & Policies icon
on the IQ Server toolbar.2. Click the organization to which you want to attach an application. A New Application button is displayed.
3. Click the New Application button.
4. In the New Application dialog, set the following attributes:
- Application Name - Enter a name into the text box.
- Application ID - Enter an identifier into the text box.
- Icon - Select from three options:
- Default - Uses the default image.
- Upload a custom icon - Click the Upload icon image button to navigate to an image file in PNG format and click Open. The image should be sized to 160 x 160 pixels. Images with different sizes will be scaled.
- Get a robot - Click the Get Another Robot button to cycle randomly through a variety of robot images.
5. Click the Create button.
Editing an Application
- Click the Organization & Policies icon on the IQ Server toolbar.
- In the sidebar, select the application you want to edit.
- In the Organization & Policies Management area, go the Actions menu and click Edit App Name / Icon.
- In the Edit Application dialog, edit any of the following attributes:
- Application Name - Enter a different name into the text box.
- Icon - Select from three options:
- Use existing icon - To use the current image.
- Upload a custom icon - Click the Upload Icon Image button to navigate to an image file in PNG format and click Open. The image should be sized to 160 x 160 pixels. Images with different sizes will be scaled.
- Get a robot - Click the Get Another Robot button to cycle randomly through a variety of robot images.
- Click the Update button to save changes.
Selecting an Application Contact
Optionally, you can select a contact person for an application. The contact is displayed at the top of the Organization & Policies page, as well as in the reporting area, and the PDF version of the report.
To select a contact:
- Click the Organization & Policies icon on the IQ Server toolbar.
- Select an application in the sidebar.
- Go to the Actions menu and click Select Contact.
- In the Select Contact box, search for a user by entering a full name or part of name with an asterisk, then click Search. You can use an asterisk as a wildcard at the beginning or end of a character string. For example, isa*, *mov, and *asi* will all match the name, "Isaac Asimov." Any matching names are displayed below the search box.
- Select a user in the results list and click Select. The user’s name is displayed at the top of the page below the application name.
NEW IN RELEASE 158 SAML users and groups can be added as application contacts, by searching on name or wildcard. A SAML user has to log in at least once (so IQ Server can store information about them and their groups) before the user name/group name appears in UI search results.
Removing an Application Contact
To remove a contact:
- Click the Organization & Policies icon on the IQ Server toolbar.
- Select an application in the sidebar.
- Go to the Actions menu and click Select Contact.
- In the Select Contact box, click the Clear Contact button. In the alert box, click Continue.
The user’s name is removed from the top of the page.
Copying the Application ID to Clipboard
External tools integrated with IQ Server need to be configured with a public Application ID that identifies which application to use when evaluating components. You can speed the configuration process by copying the Application ID to the clipboard using the steps below.
To copy the Application ID to the clipboard:
- Click the Organization & Policies icon on the IQ Server toolbar.
- Select an application in the sidebar.
- Go to the Actions menu and click App ID to Clipboard.
Changing an Application ID
The Application ID is a unique identifier used by external tools to integrate with IQ Server (e.g. Lifecycle for Bamboo, Lifecycle for IDEA, REST APIs, etc.) for performing component evaluations. If you change the Application ID, you must also reconfigure the external tool(s).
To change the Application ID for an application:
- Click the Organization & Policies icon on the IQ Server toolbar. Select an application in the sidebar.
- Go to the Actions menu and click Change App ID.
- In the Change Application ID dialog, enter a unique identifier in the New Application ID text box.
- Click Change to save the new Application ID.
Remember to reconfigure your external tools to use the updated Application ID.
Moving an Application
At some point, you may want to move an application to a different organization. When moving an application, it’s not just the entity that moves, but also its configuration (i.e. policies, component labels, and waivers). If the application has any local configuration settings, those settings are unaffected and remain unchanged by a move. However, if the application has inherited any organization-level configuration, there is the potential for incompatibility between the application’s source organization and the destination organization.
During a move, IQ Server compares the configuration of the source organization to the destination organization, and looks for matches by name. If the destination has configuration settings that match all the source’s configuration, then the application’s parent reference is changed to the destination organization. If the source configuration is not matched in entirety, then IQ Server displays an error message with information about the missing configuration in the destination organization. You need to fix any discrepancy to ensure the source configuration is matched in the destination.
To move an application:
Permissions to Move Applications
Make sure you have the Edit IQ elements permission to modify the application in its original parent organization and Add Applications permission to create the application in the destination organization.
Policies are mapped by name between the source organization and target organization. If a policy has the same name in both organizations but has been configured differently in each organization, fine-grained waivers will no longer behave as expected after the application has been moved. Fine-grained waivers capture details regarding a policy violation in order to determine when the waiver is applicable, so if the policy violations do not contain the same information, then the fine-grained waivers will not apply.
- Click the Organization & Policies icon on the IQ Server toolbar. Select an application in the sidebar.
- Select an application in the sidebar.
- Go to the Actions menu and click Move <application name>.
- In the Move Application dialog, select an organization from the New Parent Organization list and click Move.
A Success message is displayed. If you get an error instead, the message lists the configuration discrepancies between the source and destination organizations that need to be resolved before the application can be moved.
The user who moves an application is assigned to the Owner role for the moved application. After a move, you may want to review user role assignments and notification settings, and adjust them as desired.
Deleting an Application
To delete an application:
- Click the Organization & Policies icon on the IQ Server toolbar. Select an application in the sidebar.
- In the sidebar, select the application you want to delete.
- In the Organization & Policies area, click the Actions menu and choose Delete <application name>.
- In the Delete <application name> dialog, click Continue to permanently delete the application or click Cancel to keep the application. Deleting and application cannot be undone.