Overview and basics about about EDIFECS SPEC BUILDER

 Overview About Spec Builder :

I am going to explain about capabilities of spec builder and let's get started with

the general overview on your screen you see the main spec doodle UI I'm

currently using version 8.4 as you can tell from the title bar your version of

spec duder may be slightly different please reach out to us in case you need

some details of how to obtain the most recent version so let's get started on

your screen you see a left ribbon with the major spec doodle functions or spec

builder modules and there is a top ribbon which allows you to get a quick

access to the features of specular or to customize the views or to do some basic

operations there are several main modules we'll go over them one by one at 

a very high level

a new guideline allows you to create a new guideline from one of our standard 

databases here I have installed just a few of them but there are much more 

available and provided out of the box by artifacts when I say standard database 

that literally means the out-of-the-box package which contains all versions and 

all transactions for the certain standard now I'm browsing x12 but we 

have also hl7 NCPDP we have a defect available and many more so when getting 

spec builder you can also get out-of-the-box pre-built specifications 

for the particular standard and as you can see we have all versions from the 

very old up to the most recent ones. 

the new map allows you to build the map or the transformation

logic between two we call them guidelines between two specifications

will again talk about the mapping.

open this just gives you access to the pre-saved guideline which you created before. 

spec generator is the tool which allows you to generate the specification or the

guideline from your existing data file it is kind of reverse engineering again.

data generator is a reverse to generate the data out of the out of the

specification so basically it gives you ability to generate some test data and

you define the way how you want this test data to be generated how many

optional segments how many transactions how many inner changes and so forth.

analyzer is the module which analyzes the data it verifies that the data

compliance to the specification it gives all the errors if there are any in the

data file and you can very easily and intuitively navigate through between the

data and the place in the specification which causes some particular error

migrator this tool allows you to solve the following problem this is the most

typical use case imagine there is a existing version of let's say x12

guideline which is forty ten you apply some customization to that guideline you

exclude certain segments you remove or add your segments based on your trading

partner agreement and tomorrow there is a new version of x12 let's say 60 20 so

you cannot just take the 60 20 out of the box and use it because for that

trading partner you already agreed that segments would be excluded or deleted or

edit so what you have to do is you have to take all those edits that you've done

4010 term guideline and now redo them on the 60 20 Wow that may sound like a lot

of work so in order to automate that we created this module what it has it

compares side-by-side to guidelines the user guideline we call it user guideline

which means the guideline with custom user modifications and the new standard

guideline and then it understands all the differences and it will prompt you

to either automatically migrate everything which means it knows the

structure it knows that these changes have been made by user so they will take

those changes and migrate over to the new version so really in couple of

clicks you would get this 6020 with all your custom modifications 

data comparator is pretty much the tool which allows you to see side by side to their files see

the differences and if needed move the differences from one file to another kind of similar to Migrator but it solves the problem of comparing of two data files 

data Explorer is a very powerful and new module with the inspect builder which allows you to do a lot with data modification it is very lightweight but yet very powerful to to

edit data to do the identification and a lot lot of other tasks that you can do

with the data 

standard reference this is pretty much the like the reference book for x12

transaction you can pick any version and you will see the all the segments which

are included in this version grouped by control segments and other logical

distribution these are the transactions you can browse this structure you can

see what each segment means and so forth similar ability you would get with

creating the guideline and even more let me show you how that looks

for example let's pick 50 10 guideline get in that line and I'm gonna start

with purchase order so I will create a purchase order so this is the document

editing for the specification we call the specification a guideline physically

this guideline will be stored in the file code in this case spec 1 dot ETS

and as you can see you can very quickly learn a lot about your structure you can

see all the segments all the loops you can expand the loops expand the segments

traverse through the elements you can see what code lists are the elements on

the right side there is a property property step and it gives you all the

information but even just looking at a glance at this guideline you can see in

the columns all the key data that you need for example this is there this is

the decimal decimal point field which has a land from 1 to 6 it has the

relational standard option and it is marked as used this is mandatory must

use type ID and so on so even without looking at the properties pane at the

right you can just traverse your structure and see all the details about

the specification and of course that's not all you can for example exclude

certain segments you do some changes to the segment structure for instance you

may choose to remove certain fields if you do not need those and you can for

example apply the user nodes user nodes are mechanism to communicate

certain information from the guideline creator to somebody who would use that

guideline or that implementation guide in the future for example we can type

something like please perform custom verification vacation of this data using

the state database information information for the customer called grade food supplies 

so we can say that now what you can do with that is you can go ahead and print

that out we can just check the print preview to see how that looks

you pretty much have all the segments all the elements you can traverse them

in here this is the summary for the entire transaction it outlines all

segments and all the key information about them including the loops and the

nested living structure after that we publish the segment's one by one giving

all the details about the segment itself about all the fields all the

descriptions the content which is published here is customizable so you

can choose to publish or not to publish certain information if we traverse to

our PR segment then we can see all the IDs in here now what we can do is we can

close that out we can go to document options these section controls the

settings of this document defines what you print how certain things must be

printed so for example I will enable printing the cover page indicating I

want to have all these information to be there I can go to segment and I can enable

printing the user notes let's say we just print the user Note one because we

just have this one user note in here we can click OK

and now if you go to the print preview then we see this cover page and this

cover page is customizable you can add the logo here or customize the overall

look and feel of this page the rest is pretty much as it used to be we can

quickly jump to our PR segment and now you can see that there is a user

node which we created so whenever you print out this document that user node

will be in here and whoever reached the document besides the general standard

information they can also read your custom custom message which you needed

to communicate to them so this is and you may have multiple user nodes

depending on the usage you can choose to define let's say you can reserve the

user node for the general information user no two may stand for some technical

data for example if your developer needs to build some edit you can just type it

here logic goes here you can save and again that can be published this is free

form you can use the rich text like you can make certain things bold or

highlight stuff so whatever is needed in terms of formatting and again all that

will be saved into the document whenever you publish the document so let's

conclude this overview by saving the guideline on disk so we can give it some

name the old custom and we hit save and the file is stored it is ready for later

use thanks for listening to this video and we'll see you shortly

                                         *******The End *******