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 *******
