Capture business data
Business data are exchanged between applications and their technical components by means of information flows.
A business data is the concrete instantiation of a data category, which represents an abstract entity that is relevant to the company's business. A data category is typically not versioned and represents, for example, Product Data or Master Data. Business data, on the other hand, represents the concrete instances that are used by an application and typically are versioned. A data category Master Data, for example, could have the business data Master Data Account, Contract, etc.
In the navigation panel, click Information Architecture > Business Data to open the data workbench for business data.
Add a new business data. Click the New button to open the wizard.
Edit an existing business data. Select the checkbox for the business data you want to edit and click the Edit button to open the wizard. The Go to Step field displayed at the bottom of the wizard should show Basic Data so that you can capture the mandatory information about the business data.
Define the business data's basic data. Define the following fields in the wizard and click OK or Next to save your data. All mandatory fields must be defined to create the business data and save it.
- Name: (Mandatory) Enter a unique name for the business data. The use of a comma (,) in the name business data is not recommended. To assure correct handling, the comma (,) will be replaced by a period (.) in conjunction with the display of business data in the CRUD matrices.
- Version: (Mandatory) Enter a version number for the business data. The name and version number of the business data should be unique.
- Data Category: (Mandatory) Assign the business data to a data category. The business data is typically the instantiation of the data category.
- Business Capability: (Recommended) Select the business capability that the business data is relevant for.
- Data Classification: Classify the business data based on data protection requirements. Possible options are: Confidential - Non-Personal Data, Confidential - Personal Data, Restricted, Unrestricted, and Unknown
- Description: Enter a meaningful description that will clarify the purpose of the business data.
Ideally your company has documented its information flows . Information flows should already be in the repository in order to define the business data that is transferred. Some analytics in Alfabet can only be understood if the relationships between information flows and business data are defined.
An application can be a source of an outgoing information flow and the target of an incoming information flow. The information flows transfer the business data that applications either create, read, update, or delete (CRUD).
- In the navigation panel, click Information Architecture > Information Flows to open the data workbench for information flows. The syntax of the information flow name is: <Source Application> > <Target Application>.
- In the data table, click the navigate button of the information flow you want to define. Go to the Overview tab and open and scroll to the Business Data page and open it.
- Click New > Create Business Data and define the business data's basic information or click Add Existing Business Data to select a business data that is in the repository. Click OK or Next to save the data.
An application can be a source of an outgoing information flow and the target of an incoming information flow. The information flow transfers the business data that applications operate on. The application can create, read, update, delete (CRUD), or process the business data. The application's information flows may also use the business data.
In the navigation panel, click Application Architecture > Applications to open the data workbench for applications. In the data table, click the navigate button of the application whose use of business data you want to define. Go to the Overview tab and open and scroll to the Business Data page and open it.
Select the checkbox for the business data you want to edit and click the Business Data Usage button to open the editor to define how the application operates on the business data. Select all checkboxes that are relevant for the application and click OK to save the specification.
Specify the usage of the business data by the source or target application or the information flow. In the Overview tab of the application, click either the application displayed in either the From (Source) Owner attribute or To (Target) Owner attribute to navigate to the application. In the Information Context tab, scroll to the Business Data page to open it. Select the checkbox for the information flow you want to edit and click the Business Data Usage button to open the editor to define how the application operates on the business data. Select all checkboxes that are relevant for the application and click OK to save the specification.
- Create: Select if the business data can be created by the application.
- Is Input: Select if the business data can be used by any of the application's incoming information flows.
- Read: Select if the business data can be read by the application.
- Is Output: Select if the business data can be used by any of the application's outgoing information flows.
- Update: Select if the business data can be updated by the application.
- Delete: Select if the business data can be deleted by the application.
-
Processing: Select if the application processes information pertaining to the business data. Processing indicates that the business data is handled in the context of the relevant object without the data being altered, created or deleted. The data is typically kept locally so that a desynchronization results between the processed business data and the system(s) of records for the business data.
Typically, it is not the raw data that is processed but some aggregation or abstraction of the business data (for example, data in an operational data store or an OLAP-based reporting solution).
- Business Data Usage Comments: If required, provide additional information about the business data usage.
In Alfabet, responsibilities are documented via the concept of roles , whereby each role is based on a preconfigured role type or a custom role type defined by your company. In contrast to an authorized user who has read/write permissions, a person assigned a role for an asset will not have read/write permissions based on the role definition. The role is primarily for documentation purposes to provide information about stakeholders interested or responsible for the asset. If the user should have read/write permissions, they must either be the authorized user of the asset or assigned to an authorized user group associated with the asset.
Alfabet provides out-of-the-box role types that enable you to understand who is responsible for your IT assets in your IT portfolio. Additional role types that are relevant for your company can also be added.
Assigning users and organizations to roles is critical to understanding responsibility for assets in the IT and is required to answer the business question Who is responsible for our assets?
To define the users and organizations that have a role for an asset, click the navigate button of the asset you want to define. Go to the Overview page and scroll to the Responsibilities view and open it. Click in a column cell to open a selector to define a role for the asset. Depending on the role column, you may be able to select a person or an organization. Switch between Person or Organization in the selector.
A person can have one of the following roles or a custom role added by your company:
- Architect: A person who is responsible for the governance of the asset.
- Business Owner: A person or organization that owns the asset and is responsible for managing the functional requirements.
- IT Owner: A person or IT organization that owns the asset and thus typically responsible for approval decisions.
- Stakeholder: A person or organization that has an interest in the asset and therefore requires read-only access permissions.
An organization can have one of the following roles or a custom role added by your company:
- Business Owner: A person or organization that owns the asset and is responsible for managing the functional requirements.
- IT Owner: A person or IT organization that owns the asset and thus typically responsible for approval decisions.
- Operations: An IT organization responsible for the operations of the asset.
- Stakeholder: A person or organization that has an interest in the asset and therefore requires read-only access permissions.
An evaluation is a measurement of the performance of an asset. The evaluation of applications is relevant for many business questions in Alfabet and is critical to have meaningful results in these analyses.
Evaluation types are preconfigured by Software GmbH. Each evaluation type bundles a set of indicator types that are assigned values. Your company may also configure custom evaluation types.
Any indicators that are colored orange are computed by the system and cannot be manually edited. The computed value is based on other indicators or attributes, therefore it is important to specify values for all of an asset's indicators. To display the indicators that are automatically calculated in the Evaluation view, click the three-dots button > Show Computed Indicators.
To hide the orange rows so that you can focus on only the indicators that need to be manually specified, click the three-dots button > Hide Computed Indicators.
Define the asset's indicators. Click the navigate button of the asset to open the content area. Go to the Overview page and scroll to the Evaluations view and open it. Click in the Value column for an indicator type and specify the value.
Update computed indicators. Click three-dots button > Compute Indicators to update the indicators that are automatically calculated based on the values of other indicators and attributes. The computed indicators will be updated based on the current data.
Set all undefined values to the default value. The portfolio administrator who has configured the indicator types may specify default values for the indicators. You can update indicators that have no values defined with the predefined default values.
To enter the default values for all undefined indicator types, click Action > Set Undefined Values to Default. Please note that the updated values will not be reflected in the Last Update field.
You can attach documents to objects in Alfabet in the Attachments view available in object profiles.
To define document or URL for an asset, navigate to the data workbench where the asset is defined. In the data table, click the navigate button of the asset you want to define. Go to the Overview page and scroll to the Attachments view and open it.
Upload a document to the asset. Click New > Add Document. Select the file from your local drive and click Upload. The document is displayed in the data table.
- Note that when you upload a document, you must ensure that the document is not encrypted. Encryption might be caused by Microsoft™ Information Protection. Only documents with the sensitivity label "Public" can be uploaded. Other reasons for encryption might also apply due to your company's security policies.
- The following file types are allowed: .xlsx, .doc, .docx, .ppt, .pptx, .pdf, .zip, .png, .jpg, and .json
The following file types are not allowed: .exe, .bat, .cmd, .ps1, .txt, .xml, .wsdl, .html, .svg
Add a URL to the asset. You can define a URL for the selected object. The user must have access permissions to the document and have access to the network path specified in the link and, typically, be in the same network domain.
- Title: Enter a meaningful title for the URL link to help users understand why you included this URL with the selected object.
- URL: Enter a valid URL starting with the prefix https://www. or http://www. The URL link may contain up to 511 characters. The user’s Windows® environment must be able to identify the document extension and identify the correct asset to open the document. A validation will be executed to ensure that a new URL is well-formatted and does not contain a period <.> without a leading or trailing blank space.
The following browsers support opening the files via the Web link definition in Alfabet: Microsoft® Internet Explorer® 11.0 and Microsoft® Edge® in conjunction with Windows® 10. Mozilla® Firefox® 24.0 or higher including Mozilla® Firefox® Quantum are also supported but require additional configuration in the browser settings.