Install ASD utility.
https://github.com/koriym/app-state-diagram#run-with-docker
Then create a skeleton file profile.xml
.
An editor that supports schemas is useful. The completion works and validation is done. Let's create a skeleton
First, use WebStorm to create a skeleton file.
In ALPS, meaning is defined as ID.
Let's add dateCreated
(creation date).
Now let's try to display the ALPS file with ASD.
Let's run ASD with the following command to create an ASD document.
You will not see a diagram because you just registered a word, but you will see that a word has been registered as a dictionary.
Also, after this, when you save the file, the ASD document will be redrawn and you will not need to use the ASD tool.
You can use title
or doc
to add a description.
The ALPS document is a dictionary of terms used in the application. The ALPS application uses dateCreated
for the creation date, not created_date
or created
.
An ALPS document is a collection of semantic descriptors.
The ALPS document is a collection of them. ### Linking to word definitions
A better way than verbal descriptions is to link to standard word definitions with def
. This prevents reinventing the wheel.
Some famous vocab sites include.
One of the important roles of ALPS is to become a vocabulary dictionary for applications. Users will use the same ID and the same meaning.
Semantic descriptors may contain semantic descriptors.
For example, BlogPosting
(blog post) contains articleBody
(body) and dateCreated
. Information contains information, and the information it contains is also included in other information. Such an arrangement of information is a taxonomy. A hierarchy is represented by a <descriptor> inside a <descriptor>.
The above represents a blog post (BlogPosting
) that contains the body of the article (articleBody
), and a blog post list (Blog
) that contains the article.
In the ALPS file, the <! -- Taxonomy -->
block in ALPS file uses other semantic descriptors inline linked with href
.
You can also link other files locally or on the web.
Let's save the file and check the ASD document.
Web pages can contain not only information, but also links to other pages and forms of actions, and this kind of interaction of information is called choreography.
There are three types as follows.
safe
is the A tag in HTML, or GET in HTTP. It is a safe transition and does not change the resource state on the server side.
The idempotent
transition changes the resource state, but is power-equivalent, meaning that it can be repeated many times with the same result.
unsafe
also changes the resource state, but is not power-limited. Care should be taken when repeating it.
safe corresponds to GET
, idempotentidempotent corresponds to PUT
or DELETE
, unsafe corresponds to POST
, and so on for each HTTP method.
Include them in other descriptors
as follows.
Include any descriptor needed for the transition.
The following attributes can be used regardless of type.
Add a tag attribute.
You can filter the attributes to draw the ASD. Let's try it.
[screenshot].
Link to meta information.
You can also use href
to link to other ALPS documents.
--
Translated with www.DeepL.com/Translator (free version)