Das Notes Forum

Domino 9 und frühere Versionen => ND9: Entwicklung => Thema gestartet von: PLi am 21.01.18 - 15:40:10

Titel: [gelöst] Beschreibungen zu Funktionen im Designer Client anzeigen
Beitrag von: PLi am 21.01.18 - 15:40:10

Hallo zusammen,

ich bin heute wieder einmal über diesen Blogpost gestolpert: Documenting Your LotusScript Classes (http://www.codestore.net/store.nsf/unid/BLOG-20130327-0346).

Dort ist beschrieben, wie man seine eigenen Script-Klassen mit REM-Blocks kommentieren sollte.

Ich weiß auch, dass ich dies schonmal bei mir im Domino Designer gesehen hatte, dass es funktioniert. Ich denke es war im 8.5er Designer.

Seitdem habe ich auf dem Domino Designer 9.0.1FP6 geupdated und da wird mir leider kein REM-Block mehr angezeigt.

Lt. dem Blogpost oben sollte aus diesem Code
%REM
        Property Get Action
        Description: Value of the "Action" field, which is used by the
        workflow associated with most documents
        
        Value is only available when editing/saving
        (not stored on document)!
%END REM
Property Get Action As String
        Action = GetFieldValue("Action")
End Property
dieser grüne Text angezeigt werden:
(http://www.codestore.net/store.nsf/rsrc/464C4175A6E0D17286257B3B0030384B/$file/image_3.png)

Wer kennt den Haken, den ich wohl versehentlich irgendwo entfernt habe, der dafür verantwortlich ist, dass mir der REM-Block nicht mehr angezeigt wird?

Vielen Dank im voraus!

Titel: Re: Beschreibungen zu Funktionen im Designer Client anzeigen
Beitrag von: Tode am 22.01.18 - 09:34:44

Wenn der REM- Block an der richtigen Stelle steht, dann wird der auch angezeigt: Er muss direkt über dem Sub- oder Funktionsnamen angezeigt werden. Ich habe mir übrigens im Designer unter Vorgaben - Domino Designer - LotusScript Editor entsprechende Kommentarschablonen angelegt. da wird dann der Kommentar genau an die richtige Stelle geschrieben. Das sieht dann so aus:

Code

	'================================================
	' ${element_type}:			${element_name}
	' Purpose:			
	'--------------------------------------------------------------------------------
	' Arguments:	
	'				
	'				
	'--------------------------------------------------------------------------------
	' Returns:		Nothing
	'--------------------------------------------------------------------------------
	' Created by: 	Torsten Link on ${date}					Modified by: 
	'--------------------------------------------------------------------------------
	' Changes:		
	'============================================

Mir wäre keine Option bekannt, womit man das ausschalten könnte...

Titel: Re: Beschreibungen zu Funktionen im Designer Client anzeigen
Beitrag von: PLi am 23.01.18 - 11:16:04

Danke Tode, aber funktioniert bei mir leider nicht.

Egal ob ich direkt über der Funktion %REM-Blocks oder Kommentare mit Hochkommas wie bei Dir gezeigt einfüge, wenn ich die ScriptLib mit der Klasse dann in einem Agenten nutze und eine Funktion daraus aufrufe, dann wird mir dieser Kommentartext in der Popup-Hilfe nicht angezeigt.
Auch die Tabs vor dem REM-Block habe ich schon entfernt, in der Hoffnung, dass der Designer den Kommentar dann findet, aber auch das leider ohne Erfolg.

Liegt es evtl. am Domino Designer 9.0.1FP6? Welche Designer Version hast Du?

Titel: Re: Beschreibungen zu Funktionen im Designer Client anzeigen
Beitrag von: PLi am 23.01.18 - 14:29:45

Also ich habe es jetzt auch mal in einem 8.5.3er Designer testen können.

Der REM-Block steht wie in der Kommentarschablone (IBM Default) über der function, aber im Popup, also wenn ich mich mit dem Mauszeiger auf den Funktionsnamen stelle, wird er nicht angezeigt...

Titel: Re: Beschreibungen zu Funktionen im Designer Client anzeigen
Beitrag von: Tode am 23.01.18 - 15:35:20

Das ist seltsam, bei mir hat das schon immer bei allen Fixpackständen 8.5.3 und 9.0.1 funktioniert. Wüsste nicht, wo man das ausschalten kann. Hast Du die ganzen Designer- LotusScript- Vorgaben schon mal durchprobiert?

Titel: Re: Beschreibungen zu Funktionen im Designer Client anzeigen
Beitrag von: jBubbleBoy am 23.01.18 - 21:27:56

Verwendest du den Eclipse-basierten LotusScript-Editor?
Zu finden bei den Designer-Vorgaben.

Titel: Re: Beschreibungen zu Funktionen im Designer Client anzeigen
Beitrag von: PLi am 24.01.18 - 09:51:44

Zitat von: jBubbleBoy am 23.01.18 - 21:27:56

Verwendest du den Eclipse-basierten LotusScript-Editor?
Zu finden bei den Designer-Vorgaben.

In den Vorgaben unter "Domino Designer\LotusScript-Editor" ist bei "Eclipse-basierten LotusScript Editor verwenden" ein Haken gesetzt.
Mein Test gestern war auf einer anderen Maschine mit anderen Windows Betriebssystem und anderem privatem names.nsf, Nur meine Notes-ID ist die gleiche.
Seltsamerweise funktioniert es auch hier nicht.

Titel: Re: Beschreibungen zu Funktionen im Designer Client anzeigen
Beitrag von: jBubbleBoy am 24.01.18 - 16:45:06

Geht ja auch nur bei Agenten und LS-Libs, weitere Einschränkungen sind mir nicht bekannt.
Gibt es denn einen Notes-Client wo es funktioniert?

Titel: Re: Beschreibungen zu Funktionen im Designer Client anzeigen
Beitrag von: PLi am 25.01.18 - 07:25:44

Zitat von: jBubbleBoy am 24.01.18 - 16:45:06

Gibt es denn einen Notes-Client wo es funktioniert?

Ich konnte bisher leider noch keinen finden.
Habe inzwischen auch 9.0.1FP5 und FP7 ausprobiert,aber damit geht es auch nicht. FP8 und 9 kann ich nicht testen, da unsere Anwendung noch nicht dafür freigegeben ist.

Titel: Re: Beschreibungen zu Funktionen im Designer Client anzeigen
Beitrag von: jBubbleBoy am 25.01.18 - 08:12:25

strange ;)

Nur um sicher zu gehen, in einer ScriptBibliothek kannst du Klassen im linken Navigator (Objekte) auswählen? Die Maus im Code-Fenster, über einen Klassen-/Funktions-Namen für 1-2 Sekunden ohne Bewegung, bringt keinen Hilfetext?
Ich kenne es nicht anders, seit es diesen Eclipse-basierten LS-Editor gibt.

Titel: Re: Beschreibungen zu Funktionen im Designer Client anzeigen
Beitrag von: PLi am 01.02.18 - 07:46:51

Zitat von: jBubbleBoy am 25.01.18 - 08:12:25

Nur um sicher zu gehen, in einer ScriptBibliothek kannst du Klassen im linken Navigator (Objekte) auswählen? Die Maus im Code-Fenster, über einen Klassen-/Funktions-Namen für 1-2 Sekunden ohne Bewegung, bringt keinen Hilfetext?

Also das Fenster geht schon auf.
Wenn ich über einem Funktionsnamen aus einer IBM-Klasse den Mauszeiger stehen lasse, dann erscheint ein Popupfenster mit der passenden ausführlichen Hilfe dazu.
Stelle ich aber den Mauszeiger auf eine Funktion meiner eigenen Klasse, dann erscheint zwar auch dieses Popup-Fenster, aber es steht nur eine Zeile darin:

Zitat

Funktionsname(Parameter1 As String, Parameter2 As String, Parameter3 As String) As Variant - Klassenname - ScriptBibliothe

Beim Namen der ScriptBibliothek fehlt allerings der letzte Buchstabe.
Also all das, was im Screenshot oben unter der Linie steht erscheint. Der Kommentar darüber aber nicht.

Titel: Re: Beschreibungen zu Funktionen im Designer Client anzeigen
Beitrag von: PLi am 06.02.18 - 16:25:01

Ich denke ich habe mein Problem lokalisiert.

Ich habe kommentierte Funktionen in ScriptLibrary "A".
Diese ScriptLibrary "A"verwende ich (Use "A") in ScriptLibrary "B". Diese Feinheit hatte ich vergessen zu erwähnen.

Wenn ich nun in ScriptLibrary "B" eine kommentierte Funktion aus ScriptLibrary "A" aufrufe, erscheint kein Kommentar.
Rufe ich aber in ScriptLibrary "B" eine kommentierte Funktion aus der gleichen ScriptLibrary "B" auf, dann wird mein Kommentar sauber angezeigt.

Scheinbar funktioniert es also offenbar nur über ScriptLibraries hinweg nicht.

Kann das sein?

Titel: Re: Beschreibungen zu Funktionen im Designer Client anzeigen
Beitrag von: PLi am 25.05.18 - 08:12:07

Die Lösung für mein Problem habe ich gemeinsam mit Tode gefunden, den ich auf dem Entwicklercamp in Gelsenkirchen getroffen habe.

Die Ursache war eine korrupte ScriptLib.

Ich habe den kompletten Inhalt der ScriptLib in einen Texteditor kopiert, dann die ScriptLib in der nsf gelöscht und mit gleichem Namen eine neue ScriptLib erzeugt. Dann habe ich in die neue den Inhalt aus dem Textfile eingefügt und frisch neu gespeichert. Danach funktionierte auch alles wieder so wie es sollte.

Titel: Re: [gelöst] Beschreibungen zu Funktionen im Designer Client anzeigen
Beitrag von: ronka am 25.05.18 - 09:16:03

ein weiteren Grund um erneut auf den EntwicklerCamp zu komen.

Dort lernt mann nicht nur wie etwas geht, sondern auch wenn es mal nicht geht, wer hilft und wie eine Lösung aussehen kann.