Univention Bugzilla – Bug 24236
Dokumentation zu Erstellung eigener Syntax-Definitionen
Last modified: 2013-08-16 15:00:43 CEST
Die Dokumentation zum Anlegen neuer Syntax-Definitionen ist sehr speziell und wurde zu 3.0 aus dem Handbuch entfernt. Sie sollte in die Entwickler-Doku im Wiki migriert werden.
Created attachment 3701 [details] Zu migrierende Dokumentation
*** Bug 12696 has been marked as a duplicate of this bug. ***
Überwiegend umgesetzt: svn40498 <http://jenkins.knut.univention.de:8080/job/UCS-3.1-2%20Handbook%20Developer/lastSuccessfulBuild/artifact/webroot/developer-reference-3.1.html#udm:syntax>
Suggestions for minor changes: * "check the valu for correctness" * "it is recommended to directly look at this file" -> "the file should be consulted directly" * "allowed characters set" -> "allowed character set" * "Syntax Overwrite" -> "Syntax Override" * "Some times" -> "Sometimes" * "The latest case might require an change" -> "The latter case might require a change" * "the variable directory/manager/web/modules/module/properties/property/syntax" -> the variable directory/manager/web/modules/module/properties/property=syntax"? * "(see ????) " -- reference broken? * "For each found object all values of an multi-valued" -> "For each object found all values of a multi-valued" * "variables cam ne used" (two occurences) * "property, which stored the values" -> "[...] which stores [...]" * "value in inserted" -> "value is inserted" * "dependant property than" -> "dependent property then" * "selected host.. For the dependant" -> "selected host.. For this" (?) * Description of "error_message": No commas. * "This class does an UDM search" -> "[...] performs [...]" * "A Python format string, which is used to generate a label display" -> "A Python format string generating a display label" * "property definitions like shares/share: dn" -> some quotes might clarify things here. * "descriptive text. Mostly unused." -> "descriptive text." * Maybe there should be a note explaining the difference between "program API" and "UDM API".
(In reply to comment #4) > Suggestions for minor changes: svn40902 > * "the variable > directory/manager/web/modules/module/properties/property/syntax" > -> the variable > directory/manager/web/modules/module/properties/property=syntax"? No, that's the name of the UCRV. Instead of "syntax" all other properties can be overridden as well, e.g. editable, multivalued, ... > * "(see ????) " -- reference broken? Yes, broken because the <olink>-database did not exist back than and still does not work as expected. See svn17323 for a start. > * Maybe there should be a note explaining the difference between "program API" > and "UDM API". Added. "program API" renamed to "Python API".
> No, that's the name of the UCRV. Instead of "syntax" all other properties can > be overridden as well, e.g. editable, multivalued, ... Then I would recommend elaborating this a bit, as the given example directory/manager/web/modules/users/user/properties/username=uid would seem to be lacking the "/syntax" part to the uninitiated reader?
(In reply to comment #6) > > No, that's the name of the UCRV. Instead of "syntax" all other properties can > > be overridden as well, e.g. editable, multivalued, ... > > Then I would recommend elaborating this a bit, as the given example > directory/manager/web/modules/users/user/properties/username=uid > would seem to be lacking the "/syntax" part to the uninitiated reader? Yes, that example is wrong and is missing the /syntax suffix. Fixed in svn40933
http://docs.univention.de/developer-reference-3.1.html#udm:syntax