Dealing with errors 

 

Working with iCloud involves a network connection, the Internet, and the iCloud servers. Hence there are numerous places where errors could occur. Most of these errors are known or to be expected and Apple provides a list of them. The current release of the application split those errors into 3 categories:

 

• Applicable and processed. Those are errors that can occur during the operation of Istoriam and that Istoriam deals with more or less transparently to you. Those are:

Error Code - Error Type                                - Error Description

     3              - NetworkUnavailable                  - The network is not available.

     4              - NetworkFailure                          - The network was available but returned an error during access.

     7              - RequestRateLimited                  - Transfers to and from the server are being rate limited for the client at this time.

     9              - NotAuthenticated                      - The user is not logged into iCloud.

    21             - ChangeTokenExpired                - The reference token value is too old and the client must re-sync from scratch.

    25             - QuotaExceeded                         - Saving the record would exceed the user’s current storage quota.

    27             - LimitExceeded                          - The request to the server was too large. The record size must be reduced

 

• Applicable but not processed. Those are errors that can occur during the operation of Istoriam but with the application being unable to deal with. In this case, the iCloud operations are disabled. Most of those errors might simply ‘auto-correct’ if the iCloud operations are re-enabled after some time. Those are:

Error Code - Error Type                                - Error Description

     1               - InternalError                              - CloudKit encountered an error.

     6               - ServiceUnavailable                   - The CloudKit service is unavailable.

    11              - UnknownItem                            - The specified record does not exist.

    15              - ServerRejectedRequest             - The server rejected this request.

    23              - ZoneBusy                                  - The server is too busy to handle this zone operation.

​

• Not Applicable. Those are errors that are associated with iCloud features and functionalities that Istoriam does not use and hence are not expected to occur. This includes all the remaining errors.

 

If an error occurs that the application cannot deal with, an alert window will appear on the screen informing you of the occurrence of the error as well as the error code.