Matics - XML (Magic xpi 4.14)
The component allows the user to invoke Matics REST APIs from the Magic xpi flow to read the data from the Matics server using the Interface APIs given by the Matics server. The user can also write data to Matics server with the help of these Interfaces.
To configure the connector, double-click or right-click on the step and select Configuration from the context menu to open the Matics Configuration dialog box.
This dialog box contains the following fields:
|
|
|
|
Connection
|
|
Resource Name
|
The name of the resource that you selected in the connector's Properties pane. The resources are defined in the Settings dialog box's Resources section.
|
|
Operation
|
|
Mode
|
Select one of the modes from the drop-down list.
The possible operations are:
This will let the user fetch the data for the selected Interface from the Matics server. The user can give additional configuration to fetch the data for the defined date range and can also fetch based on Job ID.
|
|
The Read operation returns an empty response if the value for the fields is not specified in the Data Mapper.
|
This will let the user push the data for the selected Interface to the Matics endpoint.
|
|
Interface
|
Click  (ellipsis button) to load the Interface list dialog. This dialog will display the list of Interfaces available with the Matics server. Select an Interface from this list.
|
|
Result
|
|
Store Result In
|
This is the result sent by Matics API.
Defines whether you want to store the result in file or variable. Select one of the following from the drop-down list:
-
File: Select a file to hold the object data that is returned by the Matics server. Click  to open the Expression Editor or click  and enter the file path where this information is to be stored.
-
Variable (default is C.UserBlob): Select a variable to hold the object data that is returned by Matics server.
Click to open the Variables List. Select a variable where this information is to be stored.
|
|
Operation Success
|
This field lets you easily determine if the request to Matics server is successful. Select one of the following from the drop-down list:
-
None (default): Select this option if you do not want to save the connector’s success or failure status.
-
Variable: Select the variable where you want to store the connector's success or failure status.
|
The Matics Configuration dialog box contains the following additional button:
|
|
|
|
Refresh XSD
|
Refreshes the current schema.
When you click Refresh XSD, the current schema is overwritten. A message dialog opens, and clicking OK confirms the update and the overwrite. Clicking Cancel exits the process without updating the schema.
|
|
|
When performing the Post/Write operation for an interface (for example. Product), the reference field value should be sent as type/code/ID instead of the name. For example, for the parameter FK_MachineType the value should be sent as 40 instead of Assembly.
The reference field values can be checked on the Matics connector website.
|
(Since version: 4.13.1)
