FAQ

With the new bundled license option, you can configure license limits, assign licenses to users, and control and report license consumption in alignment with how user licenses were purchased. You do not need to manually map the new pricing models to the old pricing models and then apply the licenses in the system.

The License usage report gets updated in every 45 minutes. The Admin Manage User licenses screen displays two new options, bundled - current users and bundled - registered users, to display the consumption of bundled licenses along with the existing granular license consumption options.

When you first request a Sandbox (on the Developer Portal), you are provisioned two accounts, developer account and administrator account. By default, the developer account is developer and administrator is admin (as shown in the image below). You can specify the account names and passwords.

You can changes the usernames for these accounts and specify the passwords for these accounts. The passwords you specify must meet the following criteria:

• Passwords must consist of at least one uppercase character and at least one lower case character.
• Passwords must consist of at least one numeric value.
• Passwords must consist of at least one special character (any of the following special character ~!@#$%^&*_-).
• The length of the passwords must be between 8 to 30 characters.

Yes, you still need to sign-up for the program to ensure you benefit from the exclusive Developer content and the Personal Sandbox that will be available only as part of the program.

No, that is not a pre-requisite to sign up for the program.

The personal sandbox you get is only a Development Environment. This does not have a Production Environment with a run-time available to deploy applications in the cloud at this time. 

You have unlimited access to the sandbox as long as you use it. The sandboxes will be reclaimed by BMC if there is a week's worth of inactivity. You will have to request a new sandbox once your sandbox has been reclaimed.

You can reset the developer password by using Sandbox details page.

1. On the Sandbox details page, navigate to Manage Your Sandbox > RESET PASSWORD, click RESET PASSWORD.

2. Select Innovation Suite Developer, enter the new password, and reset the password.

The following image shows the Manage Your Sandbox section:

BMC Helix Innovation Studiosupports the following languages:

• German (de)
• Japanese (ja)
• Russian (ru)
• Spanish (es)
• French (fr)
• Italian (it)
• Korean (ko)
• Brazilian Portuguese (pt-br)
• Chinese (zh-cn)
• Swedish (sv)
• Dutch (nl)

The following table describes how users can select the required language from various browsers:

BMC Helix Innovation Studioalso provides localized error messages in the supported locales.

If you encounter the error ERROR 624 User account locked, when you login to BMC Helix Innovation Studio, review the following knowledge article for steps on how to unlock the account:

BMC Helix ARSystem - ARSystem administrator cannot login.

Example of how cognitive test metrics are calculated

You have created a data set to test whether BMC Helix Innovation Studio Cognitive Service can categorize appropriate service requests in Category A and Category B. The following table indicates the number of expected and predicted categories:

Based on the above results, the accuracy, precision, recall, and F-score for Category A and Category B are calculated as shown in the following table:

The consolidated results for BMC Helix Innovation Studio Cognitive Service for Category A and Category B are calculated by using the weighted macro average as shown in the following table:

If you encounter the error You are not authorized to access BMC Helix Innovation Studio when you log in to BMC Helix Innovation Studio, use your developer account to log in. This error occurs when you try to log in to BMC Helix Innovation Studio by using an administrator account.

If you encounter the following error even if you do not have any failed login attempts:

In this case, you should create a new account in BMC Helix Innovation Studio and use the account for development. To create a new account, perform the following steps:

1. Log in to BMC Helix Innovation Studio.
2. Navigate to Administration > Configure My Server > People > Manage User Accounts.
3. Create a user with Administrator permissions and a fixed license.

In rule qualification, you can use the function NEWVALUE() for TR field and the function OLDVALUE() for DB field. See Working with rules.

You do not need the display only field to store the activity results. In a process, you can get the activity results in the following ways:

• You can use the expression ${activityResults.<activityGUID>.xxx> to access an activity output.
  All activity results are stored in the process context and can be accessed anywhere.
• If an activity is not executed, you get an empty value.
• If an activity returns a record (that is Get Record Service Task), only the record identity (record ID and record definition name) is persisted to the process context. Record field values are not persisted to the process context.
• If you access field values of Get Record Service Task, you get the latest database value of the record. See Get Record.
• You can use the activity Output Map to store activity result in a process variable.

• To access the transaction record of a rule, you can use record as the process input, and have rule call process and pass the transaction record. See Working with rules.
• To get the database value of a record, you can use Get Record action, and access the database value using the activity results of the Get Record action. See Get Record action.

The condition to resume a process instance from User Task is specified in the Completion Criteria property of User Task (process designer element).  Completion Criteria specifies the condition when the user task is considered as complete. The condition is an expression that evaluates fields of a task record.

• The platform service EntryEventNotificationService is used to monitor registered record events. User Task uses EntryEventNotificationService to monitor the task completion. Records that need to be monitored are registered in the Entry Event Registration system form and the Notifier Listening field is set to true.
  
  

• When a record event occurs, the EntryEventNotificationService evaluates the record instance condition and if the condition is true, the Pending Notification flag is set.
• A background thread notifies event listeners of all pending notification records with the Notification Information provided by the record event register. When the listener is notified, the record event is cleaned up from the registration form and the Notifier Listening flag is reset. Event listeners are notified by a separate pool of threads where the pool size can be configured.

Process instances are managed by the platform and third party process engine Activiti. The platform manages process context and Activiti engine manages process instance state information.

• Process context consists of process variables and process activity results.
• Process instance state information consists of process current activity, start time of a process, and end time of completed process activities.

For process context, there is a form to store active process instances, and a form to store completed process instances. The archive policy of completed process instances is that all completed process process instances are moved to an archive form after three months. Process instance state information follows the similar pattern.

When a process is started through an API (Record API triggers rule, which starts the process or Start Process API), process transaction starts at the REST APIs.

The process transaction joins the API transaction and the process runs till its completion or it is goes to a wait step. Wait steps are User Tasks or Receive tasks. When the process reaches a wait step, it persists all the transaction values and returns from the wait state. When the process resumes the execution from a wait step, the process transaction continues till it completes or reaches the next wait step. The records, signal inputs, process operations, process context, and the wait state information are all persisted in one transaction.

For more information on APIs, see PDFs-videos-and-API-documentation.

For more information on User Tasks and Receive tasks, see Activities.

To make the platform operational in varied customer environments, the way you customize objects in core BMC applications has changed from 17-02 onwards. You can customize the objects developed in your own applications, but you cannot customize the objects developed in com.bmc.arsys. For example, objects in core BMC applications like Foundation, Approval, and Assignment cannot be customized. You cannot customize the record definitions by updating the permissions or adding security labels, adding or updating record fields, and so on. Therefore, you must delete the customizations and then perform the upgrade the BMC Helix Innovation Studio. If you attempt to customize any objects developed in core BMC applications, you encounter the following error message:

If you attempt to customize any objects developed in core BMC applications, you encounter the following error message:

In BMC Helix Innovation Suite, you may find the required fields of the Default Tenant (Administrator > Configure My Server > Manage Tenants) such as Domain Identifier and Virtual Host Name are empty. This is because the default tenant fields are imported during the platform creation and when you use tools such as data import there is an option to not trigger the required field check.

If you are working on a dedicated system, ensure that you have assigned the application license to yourself using the Foundation Person UI. For more information, see Setting up Foundation data.

To see a licensed application, you must have that application license assigned to you using the Foundation Person UI. For more information, see Setting up Foundation data.

While AngularJS is a powerful framework, it has reached its end of life (EOL) and is no longer actively maintained by Google. This EOL status has implications for the security, stability, and long-term viability of applications built on this technology stack. Starting with 25.3.00 release, the default choice for new custom applications is Angular.   

Perform the following steps to determine the applications and libraries that are built by using AngularJS:

1. Log in to the BMC Helix Innovation Studio by using the Google Chrome browser.
2. Open the browser developer tools by pressing F12. 

3. On the Console tab, paste and run the following code:

   fetch('/api/rx/application/datapage?dataPageType=com.bmc.arsys.rx.application.bundle.datapage.BundleDescriptorDataPageQuery&pageSize=
   -1&startIndex=0&includeNonLicensedBundles=true')
     .then(response => response.json())
     .then(dataPage => {
        console.log(dataPage.data.filter(x => x.containsJavaScript
   && !x.id.match(/^com.bmc./) && x.id != 'standardlib').map(x => x.id));
     })
     .catch(error => {
      console.error('Error:', error);
     });

   The following screenshot shows the code snippet in the browser console. The output is a list of IDs of the coded applications and libraries that use AngularJS.
   

    

Starting with the 25.3.00 release of BMC Helix Innovation Suite, running AngularJS applications will no longer be feasible. With the withdrawal of support for AngularJS, BMC Helix will not incorporate the AngularJS runtime, and the following changes will take effect:

• All the application links in the application switcher and the Visit deployed application will point to Angular in runtime.
• If you try to access a URL for an AngularJS application, you will be redirected to the Unknown application page. 
• In your application, if you are using an AngularJS-based view component that has not been converted to Angular, that component will not be displayed in the view. In addition, the view's behavior will be undefined.
• If you try to access the View designer for an AngularJS application, you will be redirected to the Workspace page. 

Yes, BMC Helix continues to support the custom applications built on AngularJS for versions earlier than the 25.3.00 release of BMC Helix Innovation Suite in accordance with our support policy guidelines. 

Contact BMC Helix Support to update your applications from AngularJS to Angular. For more information about contacting BMC Helix Support, see Support information. 

You can use the JSP servlets to make the Mid Tier scalable. For more information, see Mid Tier scalability.

For Mid Tier caching recommendations, see Best practices for configuring mid tier cache.

For information about PDFs, see PDFs and videos.