6.16 BOSS: Immediate Execution

This chapter contains the guidelines you must comply with if your application uses immediate execution for its SpotPass tasks. If your application performs immediate execution, you must comply with this chapter as well as with chapter 6.14 BOSS: Common Items.

As much as possible, avoid using the term "SpotPass" in regard to immediate-execution NADL tasks.

It is possible to receive only notifications using an immediate-execution task, but Nintendo does not recommend doing so, as this might cause problems such as duplicate distribution.

6.16.1 Supporting One-time Immediate-Execution Download Tasks

Nintendo strongly recommends against using the term SpotPass in any messages displayed when running a one-time download task where you do not intend to periodically perform the download again. Instead, Nintendo recommends simply calling it a download, with phrasing such as “Download this content?” or “Could not download due to X.”

No required guideline items.

6.16.2 Task Settings for Immediate Execution

Use the following settings for immediate-execution tasks (including FGONLYT tasks).

Table 6-5 Task Settings for Immediate Execution

Execution priority

Use the default value of PRIORITY_MEDIUM.

Contact Nintendo at support@noa.com before setting any other value.

Access point information

Do not provide this information.

Contact Nintendo at support@noa.com in advance if you plan to use immediate-execution tasks that provide access point information.

Task permissions

Set a value of TASK_PERMISSION_IN_PARENTAL_CONTROL.

Although this is the default value, set it explicitly using the SetProperty function of the nn::boss::TaskPolicy class.

Task ID Use FGONLYT or the task ID that you used on your application to Nintendo.

6.16.2.1 Compliance with Task Settings for Immediate Execution

Guideline Item
The settings for immediate-execution tasks (including FGONLYT tasks) must follow the standards established by Nintendo.
Software to Be Tested
Applications that register immediate-execution tasks.
Test Method
Check the source code.
Pass/Fail Determination

Passes if all of the following conditions are met.

  • The execution priority is PRIORITY_MEDIUM.
  • No access point information is specified in the task.
  • The task permissions are set to TASK_PERMISSION_IN_PARENTAL_CONTROL.
  • The task ID in use is either FGONLYT or the ID applied for on the form submitted to Nintendo.

6.16.3 Displaying Errors during Immediate Execution

If an error occurs when the user executes an NADL task or a DataStore download or upload task, display the error code and a message on-screen. However, you do not need to display this if the application automatically retries and successfully completes the task. See section 6.3.1 Displaying Errors During Internet Communication for details on displaying errors.

6.16.3.1 Error Handling during Immediate Execution

Guideline Item

The application must implement error handling when using immediate execution for downloads that are actively initiated by the user.

Software to Be Tested

Applications which use the BOSS API to allow users to actively initiate downloads or uploads.

Exceptions

When the application automatically retries an operation and completes it without any problems.

Test Method
  1. Launch the application and register an immediate-execution NADL task or an immediate-execution DataStore download or upload task.
  2. Induce a state in which an error will occur, as described in the Error Code List and the Network Error Simulation Manual.
  3. Run an immediate-execution NADL task or an immediate-execution DataStore download or upload task.
  4. If the error/EULA applet is used:
    1. Check the error code and error message. (You do not need to check the error message if the application does not change the error message.)
  5. If the error is displayed independently by the application:
    1. Check the error code and error message.
Pass/Fail Determination

Passes if errors are displayed correctly using all of the below criteria.

  • The error is displayed promptly after the error occurs.
  • The error code is displayed in the format "XXX-YYYY", where "XXX" represents the upper three digits and "YYYY" represents the lower four digits.
  • The application displays the error message corresponding to the error code as listed in the Error Code List.

 


CONFIDENTIAL