Help Manual for a specific Question

Discussions about CSEntry
Post Reply
samuelhaniel
Posts: 17
Joined: August 4th, 2023, 11:13 am

Help Manual for a specific Question

Post by samuelhaniel »

Dear all,

I would like to display a detailed information for that specific question. For example when the interviewer is asking about age, when i tab F1 or help on cspro capi, detailed info pops up about that particular question. How you i go about it?

Thank you,
Samuel
samuelhaniel
Posts: 17
Joined: August 4th, 2023, 11:13 am

Re: Help Manual for a specific Question

Post by samuelhaniel »

Incorporating it with Multi-Language Support – Automatically displays the correct help text when switching languages when pressing help
Gregory Martin
Posts: 1882
Joined: December 5th, 2011, 11:27 pm
Location: Washington, DC

Re: Help Manual for a specific Question

Post by Gregory Martin »

Are you wanting to add help text that is different from the question text? If so, this is a feature that exists:

https://www.csprousers.org/help/CSPro/c ... tures.html
Help text: A help shortcut (F2 on desktop or the ? button on mobile) can bring up customized help information for each field.
Multiple languages are supported for both question and help text.
samuelhaniel
Posts: 17
Joined: August 4th, 2023, 11:13 am

Re: Help Manual for a specific Question

Post by samuelhaniel »

Thanks Gregory,
Where do i write those help text and how can i invoke the text using logic?
Gregory Martin
Posts: 1882
Joined: December 5th, 2011, 11:27 pm
Location: Washington, DC

Re: Help Manual for a specific Question

Post by Gregory Martin »

To learn more about question text, I suggest that you look at the workshop materials, specifically the CAPI Features section:

https://csprousers.org/mobile-workshop/05-capi.html

Note that the workshop materials are a bit old and fills now use ~~ instead of %. For example, where it says:
Est-ce que %NAME% est masculin ou feminin?
With the latest versions of CSPro, it should be:
Est-ce que ~~NAME~~ est masculin ou feminin?
samuelhaniel
Posts: 17
Joined: August 4th, 2023, 11:13 am

Re: Help Manual for a specific Question

Post by samuelhaniel »

Thanks,
I know to use question text with Instructions in cspro. I am saying How do you put some additional(from Interviewer's manual) a little bit details about the specific question. Do i need to add as a separate language say Help_manual in the capi language. when interviewers want to read some info about the specific question, they just change the language to Help_manual...is it? Is there a better way using onkey...

Thanks,
Samuel
Gregory Martin
Posts: 1882
Joined: December 5th, 2011, 11:27 pm
Location: Washington, DC

Re: Help Manual for a specific Question

Post by Gregory Martin »

I'm personally still confused about what you're trying to do. You mention using OnKey, but the default "help text" functionality already basically handles this, though linked to the F2 shortcut. If you want to connect this with F1 instead (as you mentioned in the initial post), you can remap the keystroke:
function OnKey(keystroke)

    recode keystroke -> OnKey;
        112 -> 113;       // map F1 -> F2 to bring up the help entry
           
-> keystroke; // keep every other keystroke the same
   
endrecode;
   
end;
Post Reply