Ensemble EDIFACT Development Guide
This chapter provides an overview of the Ensemble tools that you can use to work with EDIFACT schemas and documents. It contains the following sections:
Using the EDIFACT Schema Structures Page
The [Ensemble] > [EDIFACT Schemas]
page enables you to import and view EDIFACT schema specifications.
On this page, you can do the following:
View the EDIFACT schemas that have been loaded into this Ensemble namespace. To do so, click View All Schemas
The schema is immediately removed.
You cannot undo the Remove
The table on this page shows the following information:
In each row, the two columns at far left uniquely identify the schema definition in this row:
The document structure
Table rows are sorted according to the numbers and characters in the Category
Each value in the Name
column is a link. When clicked, this link displays a table that outlines the EDIFACT document structure in this schema definition, showing all of its segments and fields. You can click on any of the links in this display to drill down for more details about any item. Ensemble extracts these details from the .SETS, .SEGS, .COMS, .ELMS, and .CODES sections of the SEF file that you import to define the structure of this EDIFACT document.
For a custom EDIFACT document structure, this column identifies the standard EDIFACT document structure on which this custom structure is based.
A title that describes the contents of the EDIFACT document. This Description
is not a string that you enter as a comment or annotation. Ensemble extracts the text from the .INI section of the SEF file that you import to define the structure of this EDIFACT document.
Using the EDIFACT Document Viewer Page
The [Ensemble] > [EDIFACT Document]
page enables you to display EDIFACT documents, parsing them in different ways, so that you can determine which DocType to use. You can also test transformations. The documents can be external files or documents from the Ensemble message archives.
Importing SEF Files Programmatically
You can load SEF files programmatically as follows:
Start a Terminal session.
Change to an Ensemble namespace and issue the following command:
is the full pathname of the SEF file and EDIFACT
is needed to override the class default value for filetype
This command imports the data from the SEF file and makes it available as a schema definition in Ensemble.
Ensemble creates a name for the new schema category from the first piece of the first line in the .INI section of the SEF file. For example, in the file D96A.sef
you might see this:
D96A,,D 96A,UN,D96A,D96A schema
The extracted schema category has the name D96A
Due to the schema naming convention, if you want to edit a SEF file to customize it, InterSystems suggests you first change the text in the SEF file that provides its category name, so that you can distinguish your version from any other SEF file that you also import into Ensemble.
A SEF file may contain syntax errors. If so, Ensemble issues an error message and identifies the location of the error in the SEF file.
For reference, this section lists the classes that Ensemble provides to enable you to work with EDIFACT documents.
You can also create and use subclasses of these classes.
The business host classes include configurable targets. The following diagram shows some of them: