Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Corrected links that should have been relative instead of absolute.

Anchor
_Toc240804619
_Toc240804619
Anchor
_Toc293928957
_Toc293928957
Anchor
_Viewing_EDI_Logs
_Viewing_EDI_Logs
You can use a schema to parse data from all the supported data type formats and transform it into any of the supported data types. What a schema actually does is that, it apprehends data reads the data from the source, transforms it into XML, and then commits it to the source in the requested format. If you want data transformation then you need to use different types type of schemas schema both at the source and target end of your Process flow. Please see the figure (see Figure 196) to get more information on how a schema works.

...

Flow.

The working of schema is depicted in the below diagram.


Image Added

Business Example
Your organization has asked you to compile all the information, that is saved on a common server, about their inactive users and convert it into database entries which they will use for archiving. Your job is to fetch all the relevant data from this stack of information and convert it into acceptable database entries. For this reason you need the following knowledge:

  • An understanding of fetching data from different file types
  • An understanding of converting that fetched data into target file format

...

Adeptia Suite provides the following type of schema activities:

Adeptia Suite allows you to create schemas schema in two ways:

  • Using Definition File
  • Entering the Fields Sequentially


Anchor
usingdefinitionfile
usingdefinitionfile
Anchor
_Hlt185610484
_Hlt185610484
Anchor
_Hlt239858252
_Hlt239858252
Using Definition File
You can create a schema using a Definition File in three ways:

...


Anchor
usingdatafile
usingdatafile
Anchor
_Hlt185500653
_Hlt185500653
Using Data File
A data file contains the actual data which we use as source or target during the execution of a process flow. It can be the same file that is used in the process flow or another sample file of same format.


Anchor
usingfieldfile
usingfieldfile
Anchor
_Hlt185500657
_Hlt185500657
Using Field File
A field file is a Comma Separated Values (CSV) file that contains the name of the fields and their definitions which are separated by comma. This option is helpful in case the number of fields in the source or target data file is very large. All the field names are picked up from this CSV file. If the data type is Date then, format of the date must be specified after the data type, separated by comma.

...


Anchor
definitionfile_advpositionalschema
definitionfile_advpositionalschema
Field File format for Advance Positional Schema
The Field file format for Advance Positional Schema can be of two types:

  • Based on Start Position and End Position
  • Based on Field Length


Field File format for Advance Positional Schema based on Start and End Position
<Record Identifier1>:<Value>,<Record Identifier2>:<Value>
<RecordIdentifier Value>,<FieldName>,<Description>,<DataType>,[DateFormat],[TimeFormat],<Start
Position>,<EndPosition>,<Alignment>,<Skip>
In case of Advance Positional Schema, Record Identifier, and Value should be specified at the beginning of the CSV file as displayed below:

...

Using XSD File
The XML Schema Definition (XSD) file describes the elements in an XML document. The XSD file that you will use to create a schema must be compliant to the Adeptia-Suite's format. To get an Adeptia-Suite compliant XSD file, you can edit any existing schema and download its XSD file. You can also edit the fields in that XSD file and use it to create the schema. For example, you have created a schema of 100 fields and you want to create another schema of only 90 fields by using the existing 100 field schema. You can download the XSD file of the existing schema, delete 10 additional field by editing the XSD file, and use that XSD file to create another schema of just 90 fields.

...

Info

In case the schema definition contain characters which do not fall in the default character set encoding then, before uploading the XSD file you should first define the character set encoding to be used at the schema creation level. For details, refer to the Setting Character Set Encoding While Designing Schema section.


Entering Fields Sequentially
This is a manual way of creating a schema. If you select this option, you will then have to manually enter the field's name and their data type in the correct sequence.
When creating a schema (except XML schema), the schema automatically creates a Record Number attribute at the record level. It is available for each record. If you use a schema at the source level, then the schema will populate this attribute in the intermediate XML file at the record level. The Record Number attribute always starts at 1. If the schema detects an error, then it will generate this attribute in the Error File. For example, if an error is found at record number 5 in the source file, then the Error File will display Record Number 5.

Error Records
On execution of a process flow, there is a possibility that some of the records in the source file are not according to the schema definition. The schema treats them as error records when the schema parses the source data. Consider an excel schema whose field format is as shown in the figure (see Figure 209):

...


As you can note that in the schema definition, the data type of the Account_Number field is Number. However, in the source data file, there are two records where the Account_Number field contains a string data type. Now, when the schema will parse this file, the data for these two records will not match as per the schema definition and hence these two records will be treated as error records.
Similarly when you use a schema at the target side then also the schema can generate error records.
In this scenario, you may want to handle these error records as per your requirement. You can do this while creating the Process Flow, where you will be actually using this schema.

Info

To know, For information on how to handle these error records, refer to the Handling Error Records sectionHandling Error Records.


Following are the major subsections:

Section NameDescription

Advance Database Schema

Introduces Advance Database Schema concept. Instructions to create Advance Database Schema and to enable RollBackOn Error attribute are also provided.

Advance Positional Schema

Introduces Advance Positional Schema concept. Instructions to create Advance Positional Schema, use hierarchy at root level, use record at child level, define field positions non-sequentially, and view print page are also provided.

Advance Text Schema

Introduces Advance Text Schema concept. Instructions to create Advance Text Schema and use record at child level are also provided.

Database Schema

Introduces Database Schema concept. Instructions to create Database Schema are also provided.

Excel Schema

Introduces Excel Schema concept.

Positional Schema

Introduces Positional Schema concept. Instructions to create Positional Schema are also provided.

Text Schema

Introduces Text Schema concept. Instructions to create Text Schema are also provided.

XML Schema

Introduces XML Schema concept. Instructions to create XML Schema and to use Easy Schema Parser for Existing XML Schema Activity are also provided.

JSON Schema

Introduces JSON Schema concept. Instructions to create JSON Schema are also provided.

XML Validator

Introduces XML Validator concept. Instructions to create XML Validator are also provided.

EDI Schema

Introduces EDI Schema concept. Instructions to create EDI Schema are also provided.
Testing SchemaLearn how to test the schema.