Automatic skip after time limit on field

[P Sam]

Dear All

I need assistance on setting time limit on fields so the question skips automatically once the time limit per question has expired. For further clarity, I would like to set time limits on particular fields/variables e.g. set a limit of 4 minutes per question and if 4 minutes has expired without any entry in the field, the CAPI will automatically skip to the next question.

Any assistance on how to go about this would be much appreciated

[Gregory Martin]

There is no ability to set a timer using CSPro to do what you are describing. It is something that we could consider in the future, but I'd like to understand the use case for this. What is the motivation to have the data collection tool automatically skip to the next question?

[P Sam]

Thank you Gregory for the response.
We are undertaking an education survey on school children literacy and numeracy. The protocol on the section on numeracy and literacy requires that each student have 4 minutes to answer every question. If the 4 minutes expires then their chance to answer that question expires hence they move on to answer the next question. This is to ensure that every student have equal chance and opportunity in answering a question (avoid bias). The assumption is that if a student is giving more time than another, it influences the outcome of the response hence equal opportunity needs to be given to all per question for all questions in that section.

[htuser]

I thought It was possible using JS in CAPI webview part... and the new UI.postWebMessage (https://www.csprousers.org/help/CSPro/C ... ssage.html)
a) Should be possible to post a message with dictionary symbol name you want to "skip to" for triggering a JS timer in the CAPI webview. This message should be posted in the preproc of the Item.
b) You should use CSProActionInvoker.getWindowForEventListener in the CAPI's Webview to listen and activate the JS timer once the message is received;
c) Once the specified time is elapsed, you should call a CSPro user defined function in JS to skip to the specified item that the symbol name has been transmitted via the webmessage... But, because most CSPro dictionary functions don't support symbol name that are unknow until the runtime. So, I don't know if there are some workaround for skipping to a symbol name that are unknow until the runtime...

Aaron mentioned " directly call JavaScript from CSPro will likely be a feature in CSPro 8.1" (viewtopic.php?p=18011#p18011) . If implemented, it will be very simple to implement such tasks even without a native CSPro logic function.
Best,

[P Sam]

Thank you @htuser for your response. I will look into it

[htuser]

Maybe, I'll try to share a demo implementing what I shared in my previous post.

[P Sam]

Thank you once again @htuser. I will be grateful if you share a demo.

[Gregory Martin]

Ah, @htuser's mention of JavaScript makes me change my answer. This is possible in CSPro 8.0. See attached for an example, where a question is skipped if the user doesn't enter a value within five seconds.

In CSPro, I added a function that will skip to a particular field:

function SkipToField(string fieldName)
    skip to @fieldName;
end;

And then the trickier part is the JavaScript. I set a timer that, when complete, uses the Action Invoker to call into CSPro logic to execute that SkipToField function. I added this as the HTML question text for the field:

<p>Skipping to FIELD_2 in <span id="seconds">...</span> seconds.</p>

<script src="/action-invoker.js"></script>
<script>
    const secondsInterval = 1;
    let secondsRemaining = 5;

    const secondsSpan = document.getElementById("seconds");
    secondsSpan.textContent = secondsRemaining;

    const timerId = setInterval(runTimer, secondsInterval * 1000);

    function runTimer() {
        secondsRemaining -= secondsInterval;
        secondsSpan.textContent = secondsRemaining;

        if( secondsRemaining <= 0 ) {
            clearInterval(timerId);
         
            const CS = new CSProActionInvoker();

            CS.Logic.invokeAsync({
                function: "SkipToField",
                arguments: {
                    fieldName: "FIELD_2"
                }
            });
        }
    }
</script>

This is definitely for advanced users, but it is impossible.

[htuser]

Thanks @Greg for sharing. I'm very happy to see that the CSPro Development is still ongoing and I'm waiting for testing CSPro .8.1 (Eventually CAWI)...I was implementing a demo with approach I described in my previous post.
I discovered that the CAPI text Webview is not available to CSPro logic when posting a message, so CS.UI.enumerateWebViews() can't detect CAPI's webviewId.
I was trying some workaround by coding JS Action invoker in CAPI text webview and transfer it to CSPro logic using CS.Clipboard.putText...
Hopefully, you are coming with a more direct way! But, activate the timer with a message is a very good approach! And think it's also possible to share data between CSPro and JS using the CS.Clipboard.putText.

This is definitely for advanced users, but it is impossible.

Not for advanced users...Nor impossible... to CSPro, the most advanced CAPI SDK in the world!
Thanks again to the CSPro Developer Team!
Best

[P Sam]

Thank you very much @Gregory and @htuser. Exactly what I want. I have adopted it and it works perfectly