Fase 5: Inserimento dei file della guida nel pacchetto di registrazione

Per un esempio della procedura da seguire per aggiungere file della guida a un pacchetto di registrazione, vedere "Esempio di creazione di un pacchetto di registrazione".

Se l'applicazione comprende un volume della guida del desktop (cioè un volume creato con l'Help Developer's Kit del desktop), il file fondamentale del volume della guida (*.sdl) dovrà essere collocato nella directory radice_app/appconfig/help/lingua.

I file grafici usati dai file della guida vengono solitamente collocati nella directory secondaria graphics. I grafici devono mantenere la stessa posizione rispetto al file principale del volume della guida (*.sdl) in cui si trovavano quando è stato creato il volume.

Se l'applicazione non comprende un volume di guida, l'Help Developer's Kit permette di crearne uno.

Per un volume della guida sono possibili due livelli di integrazione:

• Integrazione completa

  Quando la guida del desktop è integrata in modo completo, il volume è accessibile dall'applicazione, ad esempio, attraverso la guida associata al contesto o il menu Guida. L'integrazione completa richiede la modifica degli eseguibili dell'applicazione.

• Integrazione parziale

  Quando l'aiuto del desktop è integrato in modo parziale, esso è disponibile dal livello più elevato della Gestione della guida, ma non dalle finestre dell'applicazione. È comunque possibile creare un'azione che consenta di accedere al volume della guida dal gruppo dell'applicazione. L'azione dell'esempio seguente visualizza il volume della guida del file principale MiaApp.sdl:

  	ACTION ApriMiaGuida
   	{
   		LABEL           MiaGuida
   		ARG_COUNT       0
   		TYPE            COMMAND
   		WINDOW_TYPE     NO_STDIO
   		EXEC_STRING     /usr/dt/bin/dthelpview -helpVolume MiaApp
   		DESCRIPTION     Visualizza la guida per l'applicazione MiaApp.
   	}