Subroutine Name | Executable Example | Viewable Example |
---|---|---|
W3TAGGER |
E3TAGGER |
E3TAGGER |
- Description
Process user-defined tags in any text such as standard text, XML, HTML, program source etc. In special, it can be used to create a variable table in a template HTML file.
The dynamic alpha variable
W3TEXT
is inspected for the tag namedW3NAME
. All characters between the corresponding start and end tag (the 'tag content') are returned inW3VALUE
. The option fieldW3OPTION
specifies whether the current tag content should be kept or if the valueW3NEWVAL
should be added. TheW3TAG-OPTION
option specifies whether the start and end tag should be deleted fromW3TEXT
or not.- Usage
Create a template member with any tool, for example an HTML file with Microsoft Expression Web.
Add user-defined tags around the parts which you want to process further. For example around a table row:
<MY-TAG><tr><td>$NAME$</td></tr></MY-TAG>Read the template into a Natural A-dynamic variable with the Natural Web module
W3READ-RESOURCE
.Process the user-defined tags in the template with
W3TAGGER
.Write the modified template to the output page with the Natural Web module
W3TEXTDYNAMIC
.- Parameters
1 W3TEXT (A) DYNAMIC /* io/m : Text which contains the user-defined tags. 1 W3VALUE (A) DYNAMIC /* o/m : Tag content 1 W3NAME (A) DYNAMIC BY VALUE /* i /m : Tag name 1 W3TAG-OPTION (A) DYNAMIC BY VALUE OPTIONAL /* i /o : Tag-Option; possible values are: * /* 'DELETE-TAG' Delete the tag from the text (default) * /* 'KEEP-TAG' Keep the tag in the text 1 W3OPTION (A) DYNAMIC BY VALUE OPTIONAL /* i /o : Option; possible values are: * /* 'DELETE' Delete the tag content from the text (default) * /* 'KEEP' Keep the tag content in the text * /* 'REPLACE' Replace the tag content with W3NEWVAL * /* 'INSERT' Insert W3NEWVAL in front of the tag content * /* 'ADD' Add W3NEWVAL behind the tag content 1 W3NEWVAL (A) DYNAMIC BY VALUE OPTIONAL /* i /o : New tag content for W3OPTION='REPLACE', 'INSERT' or 'ADD' 1 W3MSG (A) DYNAMIC /* io/m : Message. New messages are added to the end of W3MSG. 1 W3RESPONSE (I4) /* o/m : Response code; possible values are: * /* 0 ok * /* 1 Invalid option W3OPTION * /* 2 Tag not found * /* 3 End tag not found * /* 4 End tag before start tag * /* 5 No input text (W3TEXT) given * /* 6 No tag name (W3NAME) given * /* 7 Invalid tag option (W3TAG-OPTION)- How To Invoke
CALLNAT 'W3TAGGER' W3TEXT W3VALUE W3NAME W3TAG-OPTION W3OPTION W3NEWVAL W3MSG W3RESPONSE CALLNAT 'W3TAGGER' W3TEXT W3VALUE 'MY-TAG' 'KEEP-TAG' 'DELETE' 1X W3MSG W3RESPONSE