Developing codeunits - Revision history

Nun: uddybning af beskrivelser og stavevejl.

2025-04-08T12:47:24Z

uddybning af beskrivelser og stavevejl.

← Older revision		Revision as of 14:47, 8 April 2025
Line 105:		Line 105:
	We provide a ready-to-go image of a virtual machine, running Debian 12, for [https://www.virtualbox.org/wiki/Downloads VirtualBox].		We provide a ready-to-go image of a virtual machine, running Debian 12, for [https://www.virtualbox.org/wiki/Downloads VirtualBox].

	The machine is ~~setup~~ with all the required software and helper scripts, to enable development of custom codeunits.		The machine is set up with all the required software and helper scripts, to enable development of custom codeunits.

	=== Getting the image running ===		=== Getting the image running ===
	The image is ~~build~~ for VirtualBox, so install that.		The image is buildt for VirtualBox, so install that.

	Once you have the image downloaded, start the import wizard in VirtualBox (ctrl + i) and follow it.		Once you have the image downloaded, start the import wizard in VirtualBox (ctrl + i) and follow it.
Line 121:		Line 121:

	=== Deploying codeunits ===		=== Deploying codeunits ===
	To deploy ~~you~~ code to the local Tomcat instance do the following:		To deploy your code to the local Tomcat instance do the following:

	# ~~build~~ the project (right-click it in the project-browser on the left and select build)		# Open Netbeans
	# ~~copy~~ the generated .jar file from <code>/home/developer/NetBeansProjects/[ApplicationName]/dist</code> to <code>/mnt/sda/deploy</code>		#Build the project (right-click the project in the project-browser on the left and select build)
	# Clear the cache (open http://localhost:8080/app/service?CacheClear)		# Copy the generated .jar file from <code>/home/developer/NetBeansProjects/[ApplicationName]/dist</code> to <code>/mnt/sda/deploy</code>
			# Clear the cache (open http://localhost:8080/app/service?CacheClear) or go back to the app in firefox and select Administrator -> Services -> Cache control -> Cache clear

	=== Debugging codeunits ===		=== Debugging codeunits ===
Line 132:		Line 133:
	Click "debug" in the top-left menu -> click "attach debugger" -> click "OK", the default settings should work		Click "debug" in the top-left menu -> click "attach debugger" -> click "OK", the default settings should work

	Add a breakpoint to ~~you~~ code and try to invoke it from the browser.		Add a breakpoint to your code by selecting the line number and try to invoke it from the browser.

	=== Updating the API and platform ===		=== Updating the API and platform ===

Tvi: /* Using the provided Dev-image */

2025-04-01T13:36:39Z

Using the provided Dev-image

← Older revision		Revision as of 15:36, 1 April 2025
Line 103:		Line 103:

	== Using the provided Dev-image ==		== Using the provided Dev-image ==
	We provide a ready-to-go image of a virtual machine, running Debian 12.		We provide a ready-to-go image of a virtual machine, running Debian 12, for [https://www.virtualbox.org/wiki/Downloads VirtualBox].

	The machine is setup with all the required software and helper scripts, to enable development of custom codeunits.		The machine is setup with all the required software and helper scripts, to enable development of custom codeunits.

Tvi: Added section about dev-vm

2024-12-10T15:53:21Z

Added section about dev-vm

@@ Line 20: / Line 20: @@
 # Returns a standard error page to the user
-Other debugging options include log4j and specialized TempusServa '''Systemout.print''' functions (yes, the class name is "Systemout").
+Other debugging options include log4j and specialized TempusServa '''Systemout.print''' functions (yes, the class name is "Systemout").<syntaxhighlight lang="java">
 Systemout.println("hello world");
-  Systemout.println( "hello world" );
+Systemout.printSql(myStatment);
-  Systemout.printSql( myStatment );
+</syntaxhighlight>
 == Configuration / parameters ==
@@ Line 29: / Line 29: @@
 Parameters are delivered through the method call, packed in a nice <String> Hashtable for easy access.
-Please note that values are sent as-is, so make sure to escape values before DB operations using
+Please note that values are sent as-is, so make sure to escape values before DB operations using <syntaxhighlight lang="java">
 DbConnection.escapeSql(String s);
-  DbConnection.escapeSql(String s);
+</syntaxhighlight>Configurations can be stored using the getConfiguration methods of the command object. These values can be editedthrough the designer, depending on the Codeunit type
 * System configurations: Designer > Modules > Static content
@@ Line 40: / Line 38: @@
 Value names will be prefixed with Class simple name - example + "."
-   '''dk.tempusserva.MyExampleCodeunit.'''myParameter
+   com'''.tsnocode.MyExampleCodeunit.'''myParameter
 == Variables ==
@@ Line 103: / Line 101: @@
 * DbConnection
 * EventHandler

Tvi: 36 revisions imported

2021-12-10T10:51:22Z

36 revisions imported

← Older revision	Revision as of 12:51, 10 December 2021
(No difference)

old>Admin: /* Configuration / parameters */

2018-09-15T17:40:22Z

Configuration / parameters

← Older revision		Revision as of 19:40, 15 September 2018
Line 28:		Line 28:

	Parameters are delivered through the method call, packed in a nice <String> Hashtable for easy access.		Parameters are delivered through the method call, packed in a nice <String> Hashtable for easy access.

	Please note that values are sent as-is, so make sure to escape values before DB operations using		Please note that values are sent as-is, so make sure to escape values before DB operations using

old>Admin: /* >Variables */

2018-09-15T17:39:39Z

>Variables

← Older revision		Revision as of 19:39, 15 September 2018
Line 41:		Line 41:
	'''dk.tempusserva.MyExampleCodeunit.'''myParameter		'''dk.tempusserva.MyExampleCodeunit.'''myParameter

	== >Variables ==		== Variables ==

	Variables can have a scope of either		Variables can have a scope of either

old>Admin: /* Session variables */

2018-09-15T17:39:31Z

Session variables

← Older revision		Revision as of 19:39, 15 September 2018
Line 41:		Line 41:
	'''dk.tempusserva.MyExampleCodeunit.'''myParameter		'''dk.tempusserva.MyExampleCodeunit.'''myParameter

	== ~~Session variables~~ ==		== >Variables ==

	Variables can have a ~~cope~~ of either		Variables can have a scope of either
	* Request		* Request
	* User session		* User session

old>Admin: /* User session variables */

2018-09-15T15:52:34Z

User session variables

← Older revision		Revision as of 17:52, 15 September 2018
Line 67:		Line 67:

	All variables her are serilizable and will survive server restarts.		All variables her are serilizable and will survive server restarts.

	~~It is also possible to store objects in the Hashtable '''sessionObjects''' in the '''Security''' object, but be aware that data are transient and '''will not survive server restarts'''.~~

	Certain special user properties can also be accessed from the '''Security''' object		Certain special user properties can also be accessed from the '''Security''' object
	* boolean hasProperty(String name)		* boolean hasProperty(String name)
	* String getProperty(String name)		* String getProperty(String name)

			Finally it is possible to store objects in the Hashtable '''sessionObjects''' in the '''Security''' object, but be aware that data are transient and '''will not survive server restarts'''.

	=== Application variables ===		=== Application variables ===

old>Admin: /* User session variables */

2018-09-15T15:52:02Z

User session variables

← Older revision		Revision as of 17:52, 15 September 2018
Line 68:		Line 68:
	All variables her are serilizable and will survive server restarts.		All variables her are serilizable and will survive server restarts.

	It is also possible to store objects in the '''sessionObjects''' in the '''Security''' object		It is also possible to store objects in the Hashtable '''sessionObjects''' in the '''Security''' object, but be aware that data are transient and '''will not survive server restarts'''.
	* Methods as per Hashtable
	* Data are transient and will not survive server restarts

	Certain special user properties can also be accessed from the '''Security''' object		Certain special user properties can also be accessed from the '''Security''' object

old>Admin: /* User session variables */

2018-09-15T15:50:57Z

User session variables

← Older revision		Revision as of 17:50, 15 September 2018
Line 56:		Line 56:

	=== User session variables ===		=== User session variables ===
	Acces the '''~~sessionValue~~''' attribute in the '''Security''' object		Acces the '''sessionValues''' attribute in the '''Security''' object
	* boolean hasSessionValue(String name)		* boolean hasSessionValue(String name)
	* void setSessionValue(String name, boolean value)		* void setSessionValue(String name, boolean value)
Line 67:		Line 67:

	All variables her are serilizable and will survive server restarts.		All variables her are serilizable and will survive server restarts.

			It is also possible to store objects in the '''sessionObjects''' in the '''Security''' object
			* Methods as per Hashtable
			* Data are transient and will not survive server restarts

	Certain special user properties can also be accessed from the '''Security''' object		Certain special user properties can also be accessed from the '''Security''' object