Introduction

Welcome to the official documentation of the MAT Data Manager, an advanced service designed to optimize data interaction within the MAT ecosystem, a distributed architecture offering significant advantages such as scalability, flexibility, and resilience.

The MAT Data Manager enables the effective management and analysis of connected industrial asset data. Supported by a variety of data storage solutions, from InfluxDB Full Edge to Cloud services like Azure Table Storage and MindSphere Data Lake, our service adapts to multiple implementation models.

The intrinsic complexity of the MAT Data Manager stems from its powerful generalization capability and versatility in performing advanced data computations. This tool not only allows for the retrieval and processing of data from .npz files or InfluxDB but also manages files in textual or JSON formats, offering the opportunity to deeply explore the datamodel of machines. It is important to emphasize that the service works effectively with both single assets and in cross-asset mode, allowing for comprehensive data analysis that translates into increased decision-making effectiveness and operational management.

The Data Manager service has been developed with a constant commitment to security and efficiency, employing Basic or Bearer type authentication to ensure secure transactions. By using the APIs of our MAT Auth Manager service, it is possible to retrieve the tokens necessary for secure communication with the Data Manager, ensuring the confidentiality and privacy of the data. The Auth Manager service greatly simplifies user token management: in addition to allowing the retrieval of the token itself, it offers features for validating, renewing, and retrieving the permissions associated with the user. This allows users to easily check which information they will have access to, ensuring detailed and secure control of their data resources.

Key Features:

• Distributed Architecture: offers significant benefits such as scalability, flexibility, and resilience;

• Effective Data Management: allows the management and analysis of connected industrial asset data;

• Versatile Data Storage Support: compatible with solutions such as InfluxDB Full Edge, Azure Table Storage, and MindSphere Data Lake, adapting to various implementation models;

• Advanced Data Computations: capable of performing advanced computations, managing data from .npz files, InfluxDB, text, or JSON;

• Datamodel Exploration: offers the possibility to deeply explore the datamodel of machines;

• Flexible Operating Modes: works effectively with both single assets and in cross-asset mode, promoting comprehensive data analysis;

• Security and Efficiency: uses Basic or Bearer authentication to ensure transaction security;

• Integration with MAT Auth Manager: enables the retrieval, validation, renewal of tokens, and recovery of user-associated permissions, improving control and access to information.

Content Organization

This documentation is designed to provide users with a deep understanding of the functionalities offered by the MAT Data Manager. It is structured into two main sections to ensure clear and effective navigation.

In the first section, OpenAPI Specification, you will find the service specification, which includes a detailed description of each available endpoint. This part is dedicated to illustrating the purpose of each endpoint and the ways of interacting with the system, providing users with the technical knowledge necessary to fully leverage the service's capabilities.

The second section, Usage Examples and Best Practices, focuses on the most common activities that users may wish to perform through the service. Not only will the most suitable endpoints for performing various functions be specified, but practical examples and guidelines on how to effectively use the service to retrieve the necessary information will also be provided. This part is designed to transform technical knowledge into practical application, facilitating the adoption of the service in users' daily operational activities. Additionally, a dedicated section will be aimed at a detailed explanation of the authentication procedures necessary to access the service. This ensures that all users can understand how to establish a secure connection and maintain the confidentiality and privacy of the managed data.

With this structure, the documentation aims to be a comprehensive and essential tool for anyone wishing to maximize the use of the MAT Data Manager, supporting the user from understanding technical specifications to practical daily operations. Within this documentation, reference will be made to technical terms from the world of computer and architectural software. Although this is necessary to describe complex and structurally sophisticated systems, it is important to emphasize that complexity is an aspect that makes our tool powerful, effective, and secure. For those unfamiliar with certain terms or concepts, we recommend consulting additional online resources or contacting our technical support for a detailed explanation, thus ensuring a full understanding of the content.