Updated on 2024-11-25 GMT+08:00

WJX Questionnaire

The WJX connector allows you to use WJX Questionnaire functions in a workflow after a few configurations.

WJX is a professional online platform for questionnaires, exams, assessments, and voting. It offers users intuitive tools for designing surveys, collecting data, customizing reports, and analyzing results.

Creating a WJX Connection

  1. Log in to the new ROMA Connect console.
  2. In the navigation pane on the left, choose Connector. On the page displayed, click New Connection.
  3. Select the WJX connector.
  4. In the dialog box displayed, configure the connector and click OK.

    Parameter

    Description

    Name

    Enter the connector instance name.

    AppID

    Enter the AppID of WJX.

    AppKey

    Enter the AppKey of WJX.

    Description

    Enter the description of the connector to identify it.

Action

  • Update the questionnaire status
  • Listing questionnaires
  • Querying questionnaire details

Configuring Parameters

Table 1 Update the questionnaire status

Parameter

Description

Questionnaire No.

Enter the questionnaire number.

Unix Timestamp

Used to check the validity period of a request, which is limited to 30 seconds after it is sent. Enter the Unix timestamp when the request is called. The Unix timestamp is the total number of seconds from 1970-01-01 00:00:00 GMT to the time when the request is called.

Whether to use the cache

Whether to use the cache for query APIs. The default value is Yes.

  • Yes
  • No

Questionnaire Status

Select a questionnaire status.

  • Publish or run
  • Paused
  • Removed
Table 2 Listing questionnaires

Parameter

Description

Unix Timestamp

Used to check the validity period of a request, which is limited to 30 seconds after it is sent. Enter the Unix timestamp when the request is called. The Unix timestamp is the total number of seconds from 1970-01-01 00:00:00 GMT to the time when the request is called.

Whether to use the cache

Whether to use the cache for query APIs.

  • Yes (default)
  • No

Questionnaire Publisher

If this parameter is left blank, the questionnaire published by the main account is obtained. The WeCom subaccount must be prefixed with qw$.

Questionnaire No.

Enter the questionnaire number.

Folder Name

Get questionnaires in the folder.

Keyword for fuzzy query of a questionnaire name

The value must not contain Chinese or special characters and cannot exceed 10 letters. For questionnaires with names that include fuzzy keywords, an exact match is required.

Query Start Timestamp

Queries questionnaires created on and after the specified timestamp (in Unix format, representing the total milliseconds since January 1, 1970, 00:00:00 GMT).

Query End Timestamp

Queries questionnaires created before the specified timestamp (in Unix format, representing the total milliseconds since January 1, 1970, 00:00:00 GMT).

Paging page number

The default value is 1, indicating that the first page is returned.

Page Size

Default: 10; maximum: 300. If the value exceeds the maximum, the default value will be used.

Obtain all questionnaires of the enterprise

Yes

No (default): Only questionnaires of the main account will be obtained. This parameter is valid only when the creator is the main account.

Only obtain the starred questionnaire

Yes

No (default): Both star-mark questionnaires and non-star-mark questionnaires will be obtained.

Query by time

Select a query type.

  • Query not by time
  • By questionnaire start time
  • By questionnaire creation time

Sorting Rules

Select a sorting rule.

  • Ascending by Questionnaire No.
  • Descending by Questionnaire No.
  • Ascending by questionnaire start time
  • Descending by questionnaire start time
  • Ascending by questionnaire creation time
  • Descending by questionnaire creation time

Questionnaire Status

Get questionnaires in a specified state.

  • Not released
  • Released
  • Paused
  • Deleted
  • Complete Delete
  • Audited

Questionnaire Review Status

Get questionnaires in the specified review state.

  • Passed
  • Under review
  • Not Passed
  • Waiting for real name
Table 3 Querying questionnaire details

Parameter

Description

Questionnaire No.

Enter the questionnaire number.

Unix Timestamp

Used to check the validity period of a request, which is limited to 30 seconds after it is sent. Enter the Unix timestamp when the request is called. The Unix timestamp is the total number of seconds from 1970-01-01 00:00:00 GMT to the time when the request is called.

Whether to use the cache

  • Yes (default)
  • No

Obtain the question information

  • Yes (default)
  • No

Obtain the question option information

  • Yes (default)
  • No

Obtain the question and answer option list

  • Yes
  • No (default)

Obtain the question setting information

  • Yes
  • No (default)

Obtain the pagination information

  • Yes
  • No (default)

Simple data is returned

Whether to return simple data

  • Yes (Obtain the question information, Obtain the question option information, Obtain the question and answer option list, Obtain the question setting information, Obtain the pagination information do not take effect)
  • No (default)

Whether the data is in JSON format

This parameter is valid only when Whether to return simple data is set to Yes.

Whether to return data in JSON format.

  • Yes
  • No (default)

Return the questionnaire title

This parameter is valid only when Whether the data is in JSON format is set to Yes.

  • Yes
  • No (default)