Scope of AMM files

AMM files can include the configuration objects defined in Alfabet Expand as well as object data for various configuration related object classes. You can either select single, changed configuration items for upload or upload the complete configuration. You can only add customized configuration objects to an AMM file. Standard configuration objects are only added if they allow user configuration, like for example protected object classes which can have user defined object class properties.

The following configurations are not stored as part of the meta-model configuration:

If an object is included in an AMM file, all subordinate configuration parts are also selected. For example, if a content area is added to the AMM file, it is added with all content pages, content items, and custom button defined within the data workbench. If a configuration object with the same name exists in the target database, it is overwritten with the configuration object in the AMM file. The name comparison is case insensitive. Only for object classes subordinate configuration can be merged to an existing configuration. For example, an object class is merged into the configuration of a target database configuration via AMM based update of the meta-model and the object class in the target database has a custom object class property not available for the object class in the AMM file. You can either select to merge the object class configuration and preserve the custom object class property of the target database, or you overwrite the object class in the target database, which will remove the custom object class property.

The following table lists the configuration objects which can be uploaded to an AMM file. The table also informs about the name of the configuration objects in the functionality for selecting a customized range of configuration objects to AMM files.

Tab in Alfabet Expand  Configuration Object (Section name in Find Meta-Model Objects for Deployment table)
Meta-Model
  • Object class (Classes)
  • Property group (PropertyGroups)
  • Enumeration (Enumerations)
  • Database view (DbViews)
  • API culture (APICultures)
Presentation
  • View scheme (ViewSchemes)
  • Class setting (ClassSettings)
  • Content area (ContentAreas)
  • Guided data view (GuidedDataViews)
  • Categorized visual item (CategorizedVisualItems)
  • Condition (Conditions)
  • Monitor template (Monitors)
  • Text template (TextTemplates)
  • XML object (XMLObjects)
  • Card widgets (Widgets)
  • Selector (Selectors)

The following options are for concepts of the Alfabet 10.x. configuration which are currently still supported but should be substituted with current configuration options.

  • Custom editor (CustomEditors)
  • Editor (EditView)

    An editor is added to the configuration in the context of a survey. Surveys are currently not supported for Alfabet 11.x.

  • Wizard (Wizards)

The following options are currently not supported, not configurable, or deprecated:

  • Standard page views (Views)
  • Presentation objects (Presentations)
  • Solution manager (SolutionManagers)
  • GUI scheme (GuiSchemes)
  • Workspace (Workspaces)
Presentation > Icon Gallery
  • Icon group (IconGroups)

    If the icon group contains icons that you uploaded to the Alfabet database, you must also upload the Icons to the AMM file separately.

  • Icon (Icons)
Functions
  • Custom explorer (BusinessFunctions)
Workflows
  • Workflow template (WorkflowTemplate)

    The structuring of workflows in workflow template groups is saved in the workflow template object with the attribute Group. If you select a workflow template that is displayed in a workflow template group that is not present in the target database, the workflow template group will automatically be created in the target database and the workflow template will be displayed under the group node in the explorer.

Reports
  • Report folder (ReportFolders)

    If you select a report folder, the folder will be saved to the AMM file and created in a target database updated with the AMM file without content. The reports in the report folder must be added separately to the AMM file.

  • Report (Reports)

    If you select a report located in a report folder that is not present in the target database updated with the AMM file and also not present in the AMM file containing the solution, the report will be saved in the Reports root folder in the target database.

    If the report is located in the sub-folder of a report-folder, all report folders in the hierarchy must be present either in the target database or in the AMM file in order to save the report in the same folder hierarchy as in the source database.

Publications
  • Publication (Publications)
ADIF
  • ADIF import scheme and ADIF export scheme (ADIFSchemes)

    The structuring of ADIF schemes in groups is saved in the ADIF scheme object with the attribute Group. When you select an ADIF scheme displayed in a group that is not present in the target database updated with the solution, the group will be automatically created in the target database and the ADIF scheme is displayed under the group node in the explorer.

    After update of a target database with the AMM file, all ADIF import schemes that are available in the target database after the update and have the attribute Auto Run set to True are automatically executed.

Diagrams
  • Custom diagram definitions (DiagramDefinitions)
  • Custom diagram item template (DiagramItemTemplates)

    If a custom diagram item template is configured to display icons, the icons must be separately selected for upload. Icons are not automatically included as sub-objects of the custom diagram item template.

Surveys Surveys are currently not supported.
Data Workbenches
  • Data workbench (DataWorkbenches)

    If a default view is configured for the data workbench, the default view is also stored in the AMM file.

  • Data workbench configured report group (DataWorkbenchReportGroups)
Reusable Elements
  • Event template (EventTemplates)
  • Resource bundle (ResourceBundles)
  • UI group (UIGroups)
  • UI theme (UIThemes)

In the editor for creating an AMM file, you can add objects of selected object classes of the Alfabet meta-model to the AMM file. Existing objects in the Alfabet database are overwritten if the key property for identification of the object is identical. The key comparison is case insensitive. The following table lists the object classes for which object can be migrated via AMM, the key used to identify the objects, and whether the objects can be added to the AMM file by direct selection of objects or as sub-objects of a selectable parent object.

Object Class Key Selection Additional configuration information
Class Configuration (ClassConfiguration) Class Name Directly If stereotypes are defined for an object class, each stereotype is listed in a separate row of the table with the Name defined as "Name (Stereotype)".
Color Rule Group (ColorRuleGroup) Name Directly Color rules are included if you include the parent color rule group in the AMM file.
Color Rule (ColorRule) Name Directly or included with selection of the color rule group they are assigned to. Color rules that are assigned to a color rule group cannot be included separately. You need to include the color rule group to include them. The table for color rules only displays color rules that are not assigned to a color rule group. These color rules can be selected separately.
Consistency Monitor (ConsistencyMonitor) Name Directly
Data-Triggered Action Group (DataActionGroup Name Directly If you add a data-triggered action group, the data triggered action group and all data-triggered action in the group are also added.
Data-Triggered Action (Data Action) Name Directly or with selection of the data-triggered action group it is assigned to. If the data-triggered action rule you import is part of a data-triggered action group that does not exist in the target database, you must also add the data-triggered action group.
Data-Triggered Action Rule DataActionRule Name If you add a data-triggered action rule, you must also add the data-triggered actions assigned to the rule and the data-triggered action groups which are parents of the data-triggered actions to the AMM file.
Data-Triggered Action Rule Detail (DataActionRuleDetail) Rule, Action Included with selection of the data-triggered action rule it is defined for. Data-triggered action rule details store information about the data-triggered actions assigned to the rule and the execution order defined for the actions within the data-triggered action rule.
Data Quality Rule Group (DataQualityRuleGroup) Technical Name Directly If you add a data quality rule, subordinate data quality rules will not be included automatically and must be added separately to the AMM file.
Data Quality Rule (DataQualityRule) Technical Name Directly If you add a data quality rule, you must also add the parent data quality rule group separately to the AMM file. Otherwise, the data quality rule is listed under Unassigned Data Quality Rules.
Diagram View (Diagram View) Name If you include a diagram view using color rules, you need to include the relevant color rule groups as well.
Diagram View Item (DiagramViewItem) Name Included with selection of the diagram view they are assigned to.
Evaluation Type (EvaluationType) Name Directly
Indicator Type (IndicatorType) Evaluation Type, Name Included with selection of the evaluation type they are assigned to.
External Link (ALFA_EXTERNAL_LINK) Directly If the left navigation of a user profile you added to the AMM file includes external links, those must be added separately to the AMM file.
Help Context Content (ALFA_HELPCONTEXTCONTENT) ContextID Directly Context sensitive help is provided with the standard IT Transformation Server configurations of Alfabet only. Each expandable element of the FAQ-like context sensitive help is one help context content object.
ITPortfolio Name Directly
NotificationMonitor Name Directly
Portfolio Name Directly
PrioritizationScheme Name Directly
Role Type RoleType Name Directly
System Date Monitor (SystemDateMonitor) Name Directly
User Interface Theme (ALFA_UI_THEME) Name Directly
User Profile (ALFA_USERPROFILE) Name Directly If the left navigation of a user profile you added to the AMM file includes external links, those must be added separately to the AMM file.