Layout models using default palette (extended)

You can automatically adapt the layout of models created based on the classic default symbol palette to the current symbol palette.

The macro Layout models using default palette enables you to perform this operation automatically for individual models, groups, or the entire ARIS database. The size of objects, connections, graphic objects, free-form texts, and COM objects is automatically adjusted, and the items are moved in order to prevent overlapping. Operations are logged depending on your settings.

Prerequisites

Procedure

  1. Define a Boolean attribute to be used to identify all models whose layout is to be changed.

    Define an attribute that the macro uses to identify all models whose layout has been adapted. This enables the macro to be run any number of times without influencing the layout of models that have already been changed.

    Prerequisite

    You are a configuration administrator for this tenant.

    Procedure

    1. In ARIS Architect, click ARIS > Show Administration Administration. The Administration tab opens.

    2. Click Navigation Navigation in the bar panel if the Navigation bar is not activated yet.

    3. In the navigation, click Configuration Configuration > Method Method.

    4. Click the Method Attribute types folder.

    5. Click New New > Attribute Attribute type in the Start tab bar. The wizard opens.

    6. Select the Boolean data type.

    7. Enter a name, for example, Change layout using macro.

    8. If necessary, enter a descriptive text and click Next.

    9. Select the attribute type group in which the attribute is managed. If you skip this step, the main group is used automatically.

    10. In the next step, select the symbol to identify the set Boolean value. For example, if you select the Enabled Specified attribute (small) symbol in the Specified field, you can set the value by enabling this check box in attribute editing for the relevant models.

    11. Click Save Save. The new attribute type is displayed on the tab of the same name.

    12. Double-click the entry. The Edit attribute type dialog opens.

    13. Copy the entry from the GUID field.

    14. Save the copied GUID, for example, in a text file. You need to insert the GUID into the script code for the macro later.

  2. Identify the model types used, for example, using a query.

    You can use this query to identify which model types are used in the database. You then assign the Boolean attribute to these model types.

    Procedure

    1. Click New New > Query Query. The Query Wizard opens.

    2. Select the database for which you want to define the query and, if necessary, log in using the relevant method filter. The Query 1 tab opens.

    3. Click Ad hoc analysis Query in the bar panel if the bar is not activated yet.

    4. In the Start field, enter the word Database for the item.

      A list of suggestions is displayed during input. Click Database (ARISROOT). This defines the database as the start point for the query.

      In the Successors box all of the possible successors for the start item are listed in a bulleted list. You can Right arrow expand and Down arrow collapse the bullets.

    5. Click contains > Model in the list. The successor is added to the query.

    6. Click Create table view Create table view in the Start tab bar. The Table 1 tab is created in the Output Output bar.

    7. Click Template below the table.

    8. On the Definition tab, select the Model query item and drag it into the cell A1.

    9. Click in cell B1.

    10. Click Formula Formulas > Insert formula in the Data tab bar. The dialog opens.

    11. Double-click the formula QUERY_ITEM_TYPE. The following expression is displayed for the cell:

      =QUERY_ITEM_TYPE(

    12. Complete the expression by adding A1).

    13. Click Result below the table.

    14. Click Start simulation run Start query on the Query tab bar.

    All models and their model types are displayed.

  3. Assign the Boolean attribute to all model types on which the models to be changed are based. This attribute is then available in all models.

    To ensure that the defined attribute is available to all relevant models, assign it to the model types used.

    Prerequisite

    You are a configuration administrator for this tenant.

    Procedure

    1. In ARIS Architect, click ARIS > Show Administration Administration. The Administration tab opens.

    2. Click Navigation Navigation in the bar panel if the Navigation bar is not activated yet.

    3. In the navigation, click Configuration Configuration > Method Method.

    4. Click the Method Model types folder.

    5. Select the first model type to which you want to assign the attribute and click Edit Edit in the Start tab bar. The wizard opens.

    6. Click Select attributes on the Selection tab.

    7. Click Add. The Add attributes dialog opens.

    8. Enter the name of the Boolean attribute in the Filter field, for example, Change layout using macro. The attribute is listed.

    9. Click the attribute in the Available attributes field and then click Add. The dialog closes.

    10. In the Edit model type dialog, click OK.

    11. Add the attribute to all model types in use in the same way.

    The macro can be used to assign the Boolean attribute to all models of these model types.

  4. Adapt the macro.

    Adapt the macro so that it is not run in default mode. This identifies changed models by the defined attribute. You have the option of refining the logging level.

    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 Navigation Navigation in the bar panel if the Navigation bar is not activated yet.

    3. In the Explorer tree, double-click the Evaluations Evaluations folder.

    4. Double-click a macro. The macro categories are displayed.

    5. Click the Administration category.

    6. Double-click the macro Layout models using default palette. The macro opens for editing.

    7. Search for var bProtocolAll in the code and set the value to true.

      This means that, in addition to errors, all models that have been changed or skipped will be logged.

    8. Search for var bUseLayoutFlag in the code and set the value to true.

      This specifies the attribute whose GUID you enter in the next step.

    9. Search for var LAYOUT_FLAG in the code and set the value to the GUID of the Boolean attribute you have assigned to the models. for example,

      "2807bae1-89fb-11e5-7bde-782bcb20a248".

      If you have followed the procedure description, enter the value you saved in a text file when creating the Boolean attribute.

    10. Save the changes and close the Layout models using default palette tab.

    The macro is adapted.

  5. Change the default symbol palette and run the macro.

    1. Log in to the database in which you want to assign the current default palette to models. Use a method filter that allows all the required items.

    2. Click ARIS > Show Administration Administration or ARIS > Explorer Explorer.

    3. Click Navigation Navigation in the bar panel if the Navigation bar is not activated yet.

    4. Make sure that the name of the database is selected.

    5. Click Properties Properties in the Start tab bar.

    6. Click Palette and method filter on the Selection tab.

    7. Select the ARIS default palette symbol palette and click OK.

    8. Log out of the database and then log in again. The ARIS default palette has been assigned.

    9. Search for models whose layout you want to adapt.

    10. Select the relevant models or select the database or groups. In this example the macro for the database is started to edit all models.

    11. Click Start macro Start macro in the Evaluate tab bar. The macro Layout models using default palette opens in the wizard.

    12. Click Next.

    13. Select the settings for the log file. Errors will be listed there later.

    14. Click Finish.

The layout of the models has been adapted. All changed models are listed in the log file.

If any models could not be changed, for example, because they were being edited or because errors occurred, these are also listed. If you have defined a Boolean attribute, you can run the macro again later.

See also

Layout models using default palette (default)