List of AskiaKodim Error Codes
Summary | This article details the error codes of the AskiaField API with regard to the AskiaKodim Coding Service. |
Applies to | AskiaKodim (unsupported in 5.5.2 and later) |
Written for | Users |
Keywords | error; code; kodim; askiaface; |
The PostCodingService is a web-service which acts as the intermediary between agents performing the coding and the CCA where the coding is recorded. It uses a component called the AskiaFieldAPI to communicate with the CCA. Most errors that occur will have a code returned by the AskiaFieldAPI. These codes are listed below along with resolution suggestions that are tailored for Kodim users.
Error Code | Caption | Description | Resolution |
0 | NoError | No error | None required |
-1 | SocketNotReady | The socket connection between the service and the CCA has not been established. |
Retry the operation. If it continues to fail, contact your IT support or Askia Support. |
-2 | NoReply | The CCA did not respond to the request within the time allowed. |
Check that the CCA is responsive. Increase the time allowed before abandoning a request (TimeOutFactor). |
-3 | WrongResponse | An unexpected response was received from the CCA. |
Contact Askia Support. |
-4 | EncryptError | The AskiaFieldAPI was unable to encrypt data. | Contact Askia Support. |
-5 | InvalidPassword | The password supplied when attempting to login was invalid. |
Check that the correct password is being entered. If necessary, reset the Agent's password using Supervisor. |
-6 | LoginExpired | The agent was inactive for a time period exceeding the CCA "API Disconnect time (min)" setting. |
Enable the Kodim Client setting "Keep connection from automatically ending". Increase the CCA setting API Disconnect time (min)". |
-7 | BadPointer | An unrecognised data-type was received from the CCA. |
Contact Askia Support. |
-8 | CannotCreateCOMObject | The AskiaFieldAPI was unable to create a data-type. | Contact Askia Support. |
-9 | UnknownObject | The CCA cannot find the object that it should perform an operation on. |
Check that the object (e.g. coding group, survey, etc.) has not recently been deleted. Contact Askia Support. |
-10 | CannotReadStructure | The CCA cannot get access to the object that it should perform an operation on. |
Retry the operation. Ensure that the CCA is responsive. Ensure the Agent restrictions allow access to the object. Ensure that the object is is ready for use in the CCA, for example, that a survey has been loaded. Contact Askia Support. |
-11 | NoRight | The Agent account is not a member of the coding group. |
Add the Agent account to the coding group. |
-12 | NoData | There is no data to return. |
This is not an error. The coding group simply has no interviews available for coding. This is because there are either no uncoded interviews or else another agent is currently coding all uncoded interviews. Check later for uncoded interviews. |
-13 | InvalidXML |
The CCA returned a XML survey definition that was malformed. The operation sent to the CCA XML that was malformed. |
Contact Askia Support. |
-14 | NoRightToAPI | The Agent account restrictions do not allow API usage. |
Allow the Agent account API usage in their restrictions. If trying to login simultaneously multiple times using the same Agent account, ensure that the account restriction allows this. |
-15 | AlreadyLogged | The Agent account already has a current login (session) and cannot create a new one until the old one is terminated. |
Terminate the existing login before logging in again. Allow the multiple login restriction for the account. |
-16 | ExistingObject | An object cannot be created by the CCA as it would not be unique. |
Change the object name so that it is unique. Delete the existing object that shares the same name as the object being created. |
-17 | Unknown | An unknown error occurred. |
Contact Askia Support. |
-18 | DatabaseError | The CCA could not complete the operation because a database error occurred. |
Check the CCA logs to understand the cause of the error and attempt to correct it. Contact Askia Support. |
-22 | UnknownQuestion | The CCA could not complete an operation because it involved a question that does not exist (or no longer exists). |
Abandon the operation. It cannot be completed if the question is unknown. |
-23 | NotImplementedYet | The operation has not been implemented and cannot be completed. |
Ensure all of your Askia software is up to date. Contact Askia Support. |
-24 | DefaultDirNotSetInCCA | The operation cannot be completed because the CCA default directory has not been set. |
Set the default directory in the CCA and retry the operation. |
-25 | DuplicateSurveyName | The survey cannot be created as an existing survey has the name as the survey that is being created. |
Change the name of the survey and retry the operation. Remove the existing survey with the same name and retry the operation. |
-26 | CannotUpdMetaDataInCCA | The survey definition cannot be updated. |
Check the CCA logs to understand the cause of the error and attempt to correct it. Contact Askia Support. |
-27 | CannotCreateFile | The file (resource or application) cannot be returned because a local copy cannot be saved by the AskiaFieldAPI. |
Ensure the disk containing the temporary folder location is not full. Ensure that the Coding Service has sufficient permissions to write files to the temporary folder location. |
-28 | UnknownResource | The CCA was not able to find an object required to complete the operation. |
Check the CCA logs to understand the cause of the error and attempt to correct it. Contact Askia Support. |
-29 | IncompatibleData | The coding sent to the CCA is not compatible with the current definition of the affected questions. | The survey definition must have changed without the user being notified. Logout and login and retry the coding. |
-30 | IncompatibleLevel | The coding sent to the CCA is for a question in a loop (or loops) and the coding data does not contain loop IDs. | The survey definition must have changed without the user being notified. Logout and login and retry the coding. |