Create and use a script for a custom Visio mapping

You can use custom scripts to import Microsoft® Visio contents adequately into ARIS.

Prerequisite

You are script administrator for this tenant.

The administrator roles described in the following are defined via various privileges at the server and database level. Depending on the roles assigned to the administrators they can carry out specific functions.

superuser

The user superuser is created automatically. By default, this user is assigned the User management, License management, and Configuration administrator function privileges. This user can also enable this function privilege for other users. Users of the superuser type do not use up a license. They manage the system administration, but cannot use ARIS products due to license restrictions. The default password is superuser. You should change the default password to prevent unauthorized access. The password of the superuser is very important, as it is the only user who cannot be deleted. You can change all user data except for the user name. The superuser can recreate the other default users (system, arisservice, guest) if they were deleted.

system

The system user system assumes the administrator role of the system administrator and has all function and access privileges in all databases of a tenant. Authorized persons can use this emergency user to log in to any database, even if you are using an external system, such as LDAP, for authentication.

The name system cannot be changed. The System user check box for this user (Function privileges properties page in ARIS Architect) cannot be disabled either. You should immediately change the password manager to prevent unauthorized access.

To avoid problems, you should create additional system users. Having more than one system user can avoid problems, for example, if one system user has forgotten his password. If you forgot the passwords of all your system users, the full range of functions is no longer available and full data access is no longer possible.

The following administrator roles are defined:

Database administrators

Database administrators require the Database administrator function privilege in ARIS Administration. Users with this role have all function and access privileges and can edit data of all databases of the client.

Database administrators perform the following tasks at the server level:

Users with defined function privileges can perform additional actions at the database level.

Configuration administrators

A Configuration administrator requires the Configuration administrator function privilege in ARIS Administration.

They perform the following tasks:

Script administrators

Script administrators require the Script administrator function privilege in ARIS Administration.

Script administrators perform the following tasks:

Analysis publisher

Analysis publishers require the function privilege of the same name in ARIS Administration.

Analysis publishers perform the following actions:

Analysis administrators

Analysis administrators require the function privilege of the same name in ARIS Administration.

Analysis administrators perform the following actions:

Procedure

  1. In ARIS Architect, click ARIS > Show Administration Administration.

  2. Click Evaluations > Reports > Visio import in the Navigation bar. The associated script files and XML files are displayed in the details view on the right.

  3. Select the script user_defined_steps_default.js and click Export Export in the tab bar. The Save dialog opens.

  4. Enter the name you want to export the script with, such as, my_visio_import_steps.js.

  5. Click Save and close the completion message by clicking OK.

  6. Select the entry Visio import in the Navigation bar.

  7. Click Import Import script in the tab bar. The Open dialog opens.

  8. Navigate to the directory into which you exported the script.

  9. In the Files of types field, select the JS data type, select the exported script, and click Open. The script is imported and added to the script list.

  10. Open the script and adapt it. The script is documented comprehensively so that you know which functions perform which actions and which values they return.

  11. Open the properties of the JavaScript report Visio import after you adapted the script.

  12. Click the Advanced button on the General page. The Import Visio files - Advanced options dialog opens.

  13. Navigate to the entry user_defined_steps_default.js and disable its check box.

  14. Navigate to the entry my_visio_import_steps.js and enable its check box.

  15. Click OK. The Import Visio files - Advanced options dialog closes.

  16. Click OK. The properties of the report Import Visio files close.

You have integrated your JavaScript file my_visio_import_steps.js into the Visio import report, You can now import your Visio drawing types based on your newly created JavaScript file into ARIS.