diff --git a/.gitattributes b/.gitattributes index ec034fcb5..6ffc663af 100644 --- a/.gitattributes +++ b/.gitattributes @@ -9,6 +9,7 @@ *.java text eol=crlf # Denote all files that are truly binary and should not be modified. +*.aasx binary *.png binary *.jpg binary *.jpeg binary diff --git a/docs/source/aas-examples/Example_AAS.aasx b/docs/source/aas-examples/Example_AAS.aasx new file mode 100644 index 000000000..a6c2a510c Binary files /dev/null and b/docs/source/aas-examples/Example_AAS.aasx differ diff --git a/docs/source/basics/usage.md b/docs/source/basics/usage.md index aa56ff826..e1566b9c0 100644 --- a/docs/source/basics/usage.md +++ b/docs/source/basics/usage.md @@ -16,6 +16,11 @@ To manually pass a model file `my-model.aasx` and a configuration file `my-confi > java -jar starter-{version}.jar --model my-model.aasx --config my-config.json ``` +An example model file can be found in the [FA³ST Github-Repository](https://github.com/FraunhoferIOSB/FAAAST-Service/blob/main/docs/source/aas-examples/example-aas.aasx). +Regarding AAS examples from other sources it is important to note that the AAS specification is not backwards compatible. Therefore, it is necessary to make sure that the model file conforms to the latest AAS specification (V3). +Passing an outdated model file will lead to an error. If a model file conforms to V3 of the Asset Administration Shell specification but has duplicate identifiers, FA³ST will not load the file. +Starting FA³ST with the `--no-validation` flag loads the file in any case but will lead to problems during runtime if there are duplicate identifiers present. + :::{table} Supported CLI arguments and environment variables. | CLI (short) | CLI (long) | Environment variable | Allowed
Values | Description | Default
Value | | ------------- | --------------------- | -------------------------------------------------------------- | --------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------- |