始める 最初にASDをインストールしてください。 https://github.com/koriym/app-state-diagram#run-with-docker 次にスケルトンファイルprofile.xmlを作成します。 <?xml version="1.0" encoding="UTF-8"?> <alps xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"

Getting started Install ASD utility. https://github.com/koriym/app-state-diagram#run-with-docker Then create a skeleton file profile.xml. <?xml version="1.0" encoding="UTF-8"? > <alps xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"

ALPSドキュメント 後述のセマンティックディスクリプタの集合がALPSドキュメントです。XMLまたはJSONで記述します。 <alps> <descriptor ...> <descriptor ...> </alps> ALPSメタ情報 ALPSドキュンメントにはtitle、doc、linkなどのメタ情報を付加できます。

ALPS documentation The set of semantic descriptors described below is the ALPS document, written in XML or JSON. It can be written in XML or JSON. <alps>. <descriptor ... > <descriptor ... > </alps>

ALPSとは Application-Level Profile Semantics (ALPS)は、アプリケーションレベルのセマンティクス（語句の意味や構造）を表現するフォーマットです。JSON、HTMLなど汎用メディアにアプリケーション固有のセマンティックスを加え、情報の説明や操作の理解に役立てます。 ASDとは ASD(Application State Diagram)とはALPSドキュメントから生成されるアプリケーション状態遷移図、およびその遷移図を含むドキュメンテーション生成ツールの名前です。RESTアプリケーションを純粋な情報設計の視点で俯瞰する事ができ、状態の詳細ドキュメントが遷移図からリンクされます。 用途 RESTアプリケーション(APIやWebサイト）からUI/UXを排した純粋な情報設計の視点で設計を書式化する事ができます。整理された情報でサイト設計を行う事や、開発やメンテナンスの時に情報定義のSSOTとして用いる事ができます。 ALPSドキュメントは相互にリンク可能なハイパーメディアです。複数の部分設計をリンクする事で全体の設計を構成する等、設計の再利用が可能です。

スケルトンファイルの作成 New Projectを選んでmy-first-alpsフォルダを作成します。 alps.xmlを作成してスケルトンコードを貼り付けると、httpで始まるスキーマのURLがまだインポートされていないので(URI is not registered)と赤字になります。 URLをポイントして、コンテキスチャルメニューからFetch external resourceを選び、スキーマをインポートします。 これでスキーマによる補完とバリデーションが有効になります。

技術 PHP8 BEAR.Sunday チュートリアル2 ベース ハイパーメディアAPI APIドキュメント　(自動) TDD