DOC: enhance sss documentation

Summary

docs only

Focus

track https://gitlab.indiscale.com/caosdb/customers/3dmmto/management/-/issues/31

Test Environment

none

Check List for the Author

Please, prepare your MR for a review. Be sure to write a summary and a focus and create gitlab comments for the reviewer. They should guide the reviewer through the changes, explain your changes and also point out open questions. For further good practices have a look at our review guidelines

• All automated tests pass
• Reference related issues
• Up-to-date CHANGELOG.md (or not necessary)
• Up-to-date JSON schema (or not necessary)
• Appropriate user and developer documentation (or not necessary)
  • How do I use the software? Assume "stupid" users.
  • How do I develop or debug the software? Assume novice developers.
• Annotations in code (Gitlab comments)
  • Intent of new code
  • Problems with old code
  • Why this implementation?

Check List for the Reviewer

• I understand the intent of this MR
• All automated tests pass
• Up-to-date CHANGELOG.md (or not necessary)
• Appropriate user and developer documentation (or not necessary)
• The test environment setup works and the intended behavior is reproducible in the test environment
• In-code documentation and comments are up-to-date.
• Check: Are there specifications? Are they satisfied?

For further good practices have a look at our review guidelines.

src/doc/administration/server_side_scripting.rst

@@ -83,3 +83,44 @@ An invocation via a button in javascript could look like:
 
 For more information see the :doc:`specification of the API <../specification/Server-side-scripting>`
 
+Calling from the webui
+---------------------
+Refer to  `webui documentation <https://docs.indiscale.com//caosdb-webui/extension/forms.html#calling-a-server-side-script>`_ to learn how to setup the webui side of this interaction.
+
+The following example assumes that the form in the webui has only one filed
+which is a file upload with the name ``csvfile``.
+
+
+.. code-block:: python
+
+   import os
+   import linkahead as db
+   from caosadvancedtools.serverside import helper
+   from caosadvancedtools.serverside.logging import configure_server_side_logging
+
+   def main():
+       parser = helper.get_argument_parser()
+       args = parser.parse_args()
+       db.configure_connection(auth_token=args.auth_token)
+       # setup logging and reporting if serverside execution
+       userlog_public, htmluserlog_public, debuglog_public = configure_server_side_logging()
+
+       if not hasattr(args, "filename") or not args.filename:
+           raise RuntimeError("No file with form data provided!")
+
+       # Read the input from the form (form.json)
+       with open(args.filename) as form_json:
+           form_data = json.load(form_json)
+
+       # files are uploaded to this dicectory
+       upload_dir = os.path.dirname((args.filename))
+       # Read content of th uplaoded file
+       csv_file_path = os.path.join(upload_dir, form_data["csvfile"])
+
+       # Do something with the upload csv file...
+
+
+   if __name__ == "__main__":
+       main()
+
+