|
|
 |
Nfield update
|
3 September 2024
|
|
|
|
On Tuesday, 3 September, we will release a new version of Nfield. This update contains information about the way we distribute the CAPI app, notification about deleted endpoints from the Nfield Public API, a new NIPO DSC release, reminders about the *GETDATA command being phased out, required minimum CAPI app version and supported Android versions for the CAPI app, and some smaller improvements.
|
|
|
|
We have recently made some improvements to facilitate upgrading the CAPI app to the latest version. Within the app, the installed version number can be found under the menu option About. As of version 2.38, the app will indicate if a newer version of the app is available. If it detects a newer version is available, a link with the text “New version available: {version}” will appear directly underneath the current version info. This feature will be available to users in all regions.
The second improvement is specifically for users in China, where we unfortunately do not have the option of securely distributing the CAPI app through a central trusted platform like Google Play. Until now, updates had to be distributed through a process involving several manual interventions. To provide a better customer experience, we have now created a dedicated web page where the latest APK versions of the CAPI app can be downloaded.
To summarize:
|
|
•
|
|
For users in China:
- Clicking on the "New version available" link will direct users to a new web page hosted by NIPO (https://capi-app.nfieldcn.com) where they may download a newer version of the APK.
- Once the new APK has been downloaded to the device, it can be installed. This will overwrite the current version of the app. If an attempt is made to install an older version, it will fail unless the current version is first deleted from the device.
|
|
•
|
|
For users in all other regions:
Clicking on the "New version available" link will direct users to Google Play, where they may update to a newer version. This method will preserve any user data stored in the app. If you have enabled auto-update functionality, this behaviour will remain unchanged - the CAPI app will update automatically.
|
|
Obsolete endpoints removed from Public API
|
|
The following endpoints have been permanently removed from the Nfield Public API and will no longer work. We expect this should not present any issues for our users, since we have communicated this in several of our updates. The alternative endpoints in the table below should provide the relevant resources:
|
| Deleted endpoints |
Alternative endpoints |
GET v1/BackgroundTasks |
Use GET v1/BackgroundActivity/{activityId} |
GET v1/BackgroundTasks/{taskId} |
GET v1/Interviewers |
Use either CapiInterviewers or
CatiInterviewers endpoints, as needed |
GET v1/Interviewers/{interviewerId} |
POST v1/Interviewers |
DELETE v1/Interviewers/{interviewerId} |
PATCH v1/Interviewers/{interviewerId} |
PUT v1/Interviewers/{interviewerId} |
GET v1/Interviewers/GetByClientId/{clientInterviewerId} |
GET v1/Surveys/{surveyId}/Quota |
Use SurveyQuotaFrame endpoints |
PUT v1/Surveys/{surveyId}/Quota |
PUT v1/Surveys/{surveyId}/Quota/{eTag} |
GET v1/Surveys/{surveyId}/GeneralSettings/Owner/td>
| Use GeneralSettings endpoint |
PUT v1/Surveys/{surveyId}/GeneralSettings/Owner |
|
NIPO DSC for IBM SPSS 2.00.022
|
|
The most recent version of the NIPO DSC for IBM SPSS software, version 2.00.022, is available for download from the NIPO website.
New in this version:
|
|
•
|
|
In previous version, when the data is transformed into a metadata (mdd), helper fields were not created for the *ALPHA questions when *USEBUTTONS command was used. This issue has now been fixed.
|
|
Nfield CAPI minimum app version from 1 October 2024
|
|
From 1 October 2024 onwards the minimum version of the Nfield CAPI app that can be used for fieldwork is 2.26. Interviewing devices that are running a version of the app that is lower than 2.26 will no longer be able to synchronize with Nfield.
As a Domain Administrator it is important to share this news within your organization so it gets the attention of the people that should act. If you are working with the older Nfield CAPI app versions that stop being supported, now is the time to ensure business continuity by keeping your CAPI devices updated with at least the minimum required app version (preferably upgrading them to the latest CAPI app version).
|
Nfield CAPI: Supported Android versions changes per 1 January 2025
|
|
NIPO will raise the minimum supported Android version to Android 12 on 1 January 2025.
What does this minimum supported version mean for you? If you encounter a problem with your device, for instance, an issue with performance, and the device is running an Android version below the minimum supported version, we will always first ask you to upgrade to at least the minimum supported Android version. It also means that all future releases of the Nfield CAPI app will require at least the minimum supported Android version to be installed on your device.
As a general recommendation we advise you to update to the latest Android version on your device(s) as soon as you can.
|
Reminder: *GETDATA retiring timeline
|
|
As we have announced before, with the introduction on the *REQUEST command and the ability to configure and test this in the Nfield Manager, we consider the *GETDATA command obsolete. We strongly recommend that you upgrade your *GETDATA commands in your script if you have not done so already.
Currently, it is no longer possible to configure new *GETDATA endpoints or to change the existing ones. If you upload a script containing *GETDATA, we will show a warning.
The current timeline for next steps is:
|
|
•
|
|
Sep-Oct 2024: The use of *GETDATA in script will become an error. We will also do some planned and communicated "brownouts" where we stop the functionality temporarily.
This is to surface any unknown use of the command at our customers' level. During these brownouts, any interviews for a survey which contains *GETDATA in the script will crash.
|
|
•
|
|
Nov-Dec 2024: We will completely remove the *GETDATA command and all configured obsolete endpoints from Nfield.
|
|
|
Please note that this schedule might change. We can and will check the use of *GETDATA continuously and we might decide to postpone certain steps.
|
NIPO renews ISO 27001 certification
Following an intensive 5-day audit, we are pleased to share the news that NIPO's certification has once again been extended.
Read more
|
As always, please share this information with all relevant people in your organization.
|
|
