Open-ILS/src/extras/ils_events.xml

   1 <ils_events>
   2         <notes>
   3                 This file describes the event codes that an ILS method might return.  Not all
   4                 methods will return event codes and it is up to each method to define which
   5                 types of events it may return.  The standard event procedure is to return an
   6                 object (JSON hash) with a field called "ilsevent" which contains the event code
   7                 below.
   8
   9                 If events need to be placed into groups for any reason, the segregation shall
  10                 be defined below with the accompanying events.
  11         </notes>
  12
  13         <event code='0' textcode='SUCCESS'>
  14                 <desc xml:lang="en-US"> </desc>
  15         </event>
  16         <event code='1' textcode='UNKNOWN'>
  17                 <desc xml:lang="en-US">Placeholder event.  Used for development only</desc>
  18         </event>
  19         <event code='3' textcode='NO_CHANGE'>
  20                 <desc xml:lang="en-US">
  21                         No change occurred
  22                 </desc>
  23         </event>
  24         <event code='1000' textcode='LOGIN_FAILED'>
  25                 <desc xml:lang="en-US">
  26                         User login failed
  27                 </desc>
  28         </event>
  29         <event code='1001' textcode='NO_SESSION'>
  30                 <desc xml:lang="en-US">
  31                         User login session has either timed out or does not exist.
  32                 </desc>
  33         </event>
  34         <event code='1002' textcode='ACTOR_USER_NOT_FOUND'>
  35                 <desc xml:lang="en-US">
  36                         Someone attempted to retrieve a user from the system and the user
  37                         was not found.
  38                 </desc>
  39         </event>
  40         <event code='1003' textcode='Z3950_SEARCH_FAILED'>
  41                 <desc xml:lang="en-US">The Z search did not succeed</desc>
  42         </event>
  43         <event code='1200' textcode='USERNAME_EXISTS'>
  44                 <desc xml:lang="en-US">
  45                         The given username already exists in the database.
  46                 </desc>
  47         </event>
  48         <event code='1201' textcode='CIRC_PERMIT_BAD_KEY'>
  49                 <desc xml:lang="en-US">
  50                         A checkout was attempted without a valid checkout permit key
  51                 </desc>
  52         </event>
  53         <event code='1202' textcode='ITEM_NOT_CATALOGED'>
  54                 <desc xml:lang="en-US">
  55                         The requested item is not cataloged in the database
  56                 </desc>
  57         </event>
  58         <event code='1203' textcode='COPY_BAD_STATUS'>
  59                 <desc xml:lang="en-US">
  60                         The given copy is not in a standard circulation status
  61                 </desc>
  62         </event>
  63         <event code='1204' textcode='CIRC_BAD_STATUS'>
  64                 <desc xml:lang="en-US">
  65                         The given circulation is not in a standard status or
  66                         the circulation was never fully closed properly
  67                 </desc>
  68         </event>
  69         <event code='1205' textcode='CARD_EXISTS'>
  70                 <desc xml:lang="en-US">The given user barcode already exists</desc>
  71         </event>
  72         <event code='1206' textcode='VOLUME_NOT_EMPTY'>
  73                 <desc xml:lang="en-US">The selected volume has copies attached</desc>
  74         </event>
  75         <event code='1207' textcode='REFUND_EXCEEDS_BALANCE'>
  76                 <desc xml:lang="en-US">A refund greater than the negative balance on a transaction was provided</desc>
  77         </event>
  78         <event code='1208' textcode='TITLE_LAST_COPY'>
  79                 <desc xml:lang="en-US">The last copy attached to a title is being removed or deleted</desc>
  80         </event>
  81         <event code='1209' textcode='Z3950_LOGIN_FAILED'>
  82                 <desc xml:lang="en-US">The login failed</desc>
  83         </event>
  84
  85
  86
  87
  88
  89         <event code='1500' textcode='CIRCULATION_NOT_FOUND'>
  90                 <desc xml:lang="en-US">
  91                         Someone attempted to retrieve a circulation object from the system and
  92                         the object was not found.
  93                 </desc>
  94         </event>
  95         <event code='1501' textcode='BIBLIO_RECORD_NOT_FOUND'>
  96                 <desc xml:lang="en-US">
  97                         Someone attempted to retrieve a biblio record entry object from the
  98                         system and the object was not found.
  99                 </desc>
 100         </event>
 101         <event code='1502' textcode='ASSET_COPY_NOT_FOUND'>
 102                 <desc xml:lang="en-US">
 103                         Someone attempted to retrieve a copy object from the
 104                         system and the object was not found.
 105                 </desc>
 106         </event>
 107         <event code='1503' textcode='HOLD_NOT_FOUND'>
 108                 <desc xml:lang="en-US">
 109                         Someone attempted to retrieve a hold object from the
 110                         system and the object was not found.
 111                 </desc>
 112         </event>
 113         <event code='1504' textcode='TRANSIT_NOT_FOUND'>
 114                 <desc xml:lang="en-US">
 115                         Someone attempted to retrieve a transit object from the
 116                         system and the object was not found.
 117                 </desc>
 118         </event>
 119         <event code='1505' textcode='BILLING_NOT_FOUND'>
 120                 <desc xml:lang="en-US">
 121                         Someone attempted to retrieve a transit object from the
 122                         system and the object was not found.
 123                 </desc>
 124         </event>
 125         <event code='1506' textcode='CONTAINER_NOT_FOUND'>
 126                 <desc xml:lang="en-US">
 127                         Someone attempted to retrieve a container object from the
 128                         system and the object was not found.
 129                 </desc>
 130         </event>
 131         <event code='1507' textcode='CONTAINER_ITEM_NOT_FOUND'>
 132                 <desc xml:lang="en-US">
 133                         Someone attempted to retrieve a container item object from the
 134                         system and the object was not found.
 135                 </desc>
 136         </event>
 137         <event code='1508' textcode='VOLUME_NOT_FOUND'>
 138                 <desc xml:lang="en-US">
 139                         Someone attempted to retrieve a volume object from the
 140                         system and the object was not found.
 141                 </desc>
 142         </event>
 143         <event code='1509' textcode='ORG_UNIT_NOT_FOUND'>
 144                 <desc xml:lang="en-US">
 145                         Someone attempted to retrieve an org unit object from the
 146                         system and the object was not found.
 147                 </desc>
 148         </event>
 149         <event code='1510' textcode='STAT_CAT_NOT_FOUND'>
 150                 <desc xml:lang="en-US"> Stat cat object does not exist </desc>
 151         </event>
 152         <event code='1511' textcode='STAT_CAT_ENTRY_NOT_FOUND'>
 153                 <desc xml:lang="en-US"> Stat cat entry object does not exist </desc>
 154         </event>
 155         <event code='1512' textcode='STAT_CAT_ENTRY_MAP_NOT_FOUND'>
 156                 <desc xml:lang="en-US"> Stat cat entry map object does not exist </desc>
 157         </event>
 158         <event code='1513' textcode='NON_CAT_TYPE_NOT_FOUND'>
 159                 <desc xml:lang="en-US"> The non cataloged type object does not exist </desc>
 160         </event>
 161         <event code='1514' textcode='CIRC_DURATION_NOT_FOUND'>
 162                 <desc xml:lang="en-US"> The circ duration object does not exist </desc>
 163         </event>
 164         <event code='1515' textcode='RECURRING_FINE_NOT_FOUND'>
 165                 <desc xml:lang="en-US"> The recurring fines object does not exist </desc>
 166         </event>
 167         <event code='1516' textcode='MAX_FINE_NOT_FOUND'>
 168                 <desc xml:lang="en-US"> The max fines object does not exist </desc>
 169         </event>
 170         <event code='1517' textcode='COPY_LOCATION_NOT_FOUND'>
 171                 <desc xml:lang="en-US"> The copy location object does not exist </desc>
 172         </event>
 173         <event code='1518' textcode='HOLD_TRANSIT_NOT_FOUND'>
 174                 <desc xml:lang="en-US"> The hold transit object does not exist </desc>
 175         </event>
 176         <event code='1519' textcode='TRANSACTION_NOT_FOUND'>
 177                 <desc xml:lang="en-US"> Requested transaction object does not exist </desc>
 178         </event>
 179         <event code='1520' textcode='WORKSTATION_NOT_FOUND'>
 180                 <desc xml:lang="en-US"> Requested workstation object does not exist </desc>
 181         </event>
 182         <event code='1521' textcode='COPY_NOTE_NOT_FOUND'>
 183                 <desc xml:lang="en-US"> Requested copy note does not exist </desc>
 184         </event>
 185         <event code='1522' textcode='VOLUME_NOTE_NOT_FOUND'>
 186                 <desc xml:lang="en-US"> Requested copy note does not exist </desc>
 187         </event>
 188         <event code='1523' textcode='TITLE_NOTE_NOT_FOUND'>
 189                 <desc xml:lang="en-US"> Requested copy note does not exist </desc>
 190         </event>
 191         <event code='1524' textcode='CARD_NOT_FOUND'>
 192                 <desc xml:lang="en-US"> Requested copy note does not exist </desc>
 193         </event>
 194         <event code='1525' textcode='BILLING_NOT_FOUND'>
 195                 <desc xml:lang="en-US"> Requested copy note does not exist </desc>
 196         </event>
 197         <event code='1526' textcode='BILLABLE_XACT_SUMMARY_NOT_FOUND'>
 198                 <desc xml:lang="en-US"> Requested transaction summary does not exist </desc>
 199         </event>
 200
 201         <event code='1527' textcode='OPEN_TCN_NOT_FOUND'>
 202                 <desc xml:lang="en-US">No TCN could be found that does not collide with existing records</desc>
 203         </event>
 204
 205
 206
 207
 208         <event code='1700' textcode='NON_CAT_TYPE_EXISTS'>
 209                 <desc xml:lang="en-US"> The non-cataloged type object already exists </desc>
 210         </event>
 211
 212         <event code='1701' textcode='COPY_LOCATION_EXISTS'>
 213                 <desc xml:lang="en-US"> The copy location object already exists </desc>
 214         </event>
 215
 216         <event code='1702' textcode='OPEN_CIRCULATION_EXISTS'>
 217                 <desc xml:lang="en-US"> There is an open circulation on the requested item </desc>
 218         </event>
 219
 220         <event code='1703' textcode='WORKSTATION_NAME_EXISTS'>
 221                 <desc xml:lang="en-US"> A workstation with that name already exists </desc>
 222         </event>
 223
 224         <event code='1704' textcode='TCN_EXISTS'>
 225                 <desc xml:lang="en-US">A record already exists with the requested TCN value</desc>
 226         </event>
 227         <event code='1705' textcode='VOLUME_LABEL_EXISTS'>
 228                 <desc xml:lang="en-US">A volume with the same label, title and owning library exists</desc>
 229         </event>
 230         <event code='1706' textcode='ITEM_BARCODE_EXISTS'>
 231                 <desc xml:lang="en-US">An item with the same barcode exists</desc>
 232         </event>
 233
 234
 235
 236         <event code='2000' textcode='BAD_PARAMS'>
 237                 <desc xml:lang="en-US">
 238                         Invalid parameters were encountered in a method
 239                 </desc>
 240         </event>
 241
 242         <event code='2001' textcode='DATABASE_UPDATE_FAILED'>
 243                 <desc xml:lang="en-US">
 244                         The attempt to write to the DB failed
 245                 </desc>
 246         </event>
 247
 248
 249         <event code='5000' textcode='PERM_FAILURE'>
 250                 <desc xml:lang="en-US">
 251                         Permission Error.  * The object returning this code shall also
 252                         contain a field "ilsperm" containing the name of the permission which failed
 253                         and a field called "ilspermloc" defining the location at which the permission
 254                         failed if available.
 255                 </desc>
 256         </event>
 257
 258
 259         <!-- ================================================================ -->
 260         <!-- CIRC EVENTS -->
 261         <event code='7000' textcode='ROUTE_ITEM'>
 262                 <desc xml:lang="en-US">
 263                         A copy needs to be routed to a different location
 264                         The destination location will be specified by an 'org' key
 265                         within the event object
 266                 </desc>
 267         </event>
 268
 269         <event code='7001' textcode='PATRON_BAD_STANDING'>
 270                 <desc xml:lang="en-US">
 271                         The patron in question is not able to check out materials because
 272                         their account is in bad standing
 273                 </desc>
 274         </event>
 275
 276         <event code='7002' textcode='PATRON_EXCEEDS_CHECKOUT_COUNT'>
 277                 <desc xml:lang="en-US">
 278                         The patron in question has the maximum number of items already checked out
 279                 </desc>
 280         </event>
 281
 282         <event code='7003' textcode='COPY_CIRC_NOT_ALLOWED'>
 283                 <desc xml:lang="en-US"> Target copy is not allowed to circulate </desc>
 284         </event>
 285
 286         <event code='7004' textcode='COPY_NOT_AVAILABLE'>
 287                 <desc xml:lang="en-US"> Copy is not available </desc>
 288         </event>
 289
 290         <event code='7005' textcode='LOCATION_CIRC_NOT_ALLOWED'>
 291                 <desc xml:lang="en-US"> Location does not allow materials to circulate </desc>
 292         </event>
 293
 294         <event code='7006' textcode='COPY_IS_REFERENCE'>
 295                 <desc xml:lang="en-US"> Copy is reference material </desc>
 296         </event>
 297
 298         <event code='7007' textcode='COPY_NEEDED_FOR_HOLD'>
 299                 <desc xml:lang="en-US"> Copy is needed to fulfil a hold </desc>
 300         </event>
 301
 302         <event code='7008' textcode='MAX_RENEWALS_REACHED'>
 303                 <desc xml:lang="en-US"> Circulation has no more renewals remaining </desc>
 304         </event>
 305
 306         <event code='7009' textcode='ROUTE_TO_COPY_LOCATION'>
 307                 <desc xml:lang="en-US">
 308                 A copy needs to be routed to a copy location.  The location
 309                 should be specified within the event with a 'location' key
 310                 </desc>
 311         </event>
 312
 313         <event code='7009' textcode='CIRC_CLAIMS_RETURNED'>
 314                 <desc xml:lang="en-US"> Requested circulation is marked claims returned </desc>
 315         </event>
 316
 317         <event code='7010' textcode='COPY_ALERT_MESSAGE'>
 318                 <desc xml:lang="en-US"> The requested copy has an alert message attached </desc>
 319         </event>
 320
 321         <event code='7011' textcode='COPY_STATUS_LOST'>
 322                 <desc xml:lang="en-US">Copy has is marked as lost</desc>
 323         </event>
 324
 325         <event code='7012' textcode='COPY_STATUS_MISSING'>
 326                 <desc xml:lang="en-US">Copy has is marked as missing</desc>
 327         </event>
 328
 329         <event code='7013' textcode='PATRON_EXCEEDS_FINES'>
 330                 <desc xml:lang="en-US">The patron in question has reached the maximum fine amount</desc>
 331         </event>
 332         <event code='7014' textcode='COPY_IN_TRANSIT'>
 333                 <desc xml:lang="en-US">Copy is in transit</desc>
 334         </event>
 335
 336         <!-- ================================================================ -->
 337
 338
 339         <event code='8000' textcode='OFFLINE_SESSION_ACTIVE'>
 340                 <desc xml:lang="en-US"> An offline session for this location is currently processing </desc>
 341         </event>
 342         <event code='8001' textcode='OFFLINE_SESSION_FILE_EXISTS'>
 343                 <desc xml:lang="en-US"> An offline file for this workstation exists within this session </desc>
 344         </event>
 345         <event code='8002' textcode='OFFLINE_FILE_ERROR'>
 346                 <desc xml:lang="en-US"> An offline file or directory could not be created or accessed </desc>
 347         </event>
 348         <event code='8003' textcode='OFFLINE_PARAM_ERROR'>
 349                 <desc xml:lang="en-US"> Missing params in offline upload </desc>
 350         </event>
 351         <event code='8004' textcode='OFFLINE_CONFIG_ERROR'>
 352                 <desc xml:lang="en-US"> Offline server is not configured properly </desc>
 353         </event>
 354         <event code='8005' textcode='OFFLINE_CHECKSUM_FAILED'>
 355                 <desc xml:lang="en-US"> Offline server is not configured properly </desc>
 356         </event>
 357         <event code='8006' textcode='OFFLINE_SESSION_NOT_FOUND'>
 358                 <desc xml:lang="en-US"> Offline server is not configured properly </desc>
 359         </event>
 360         <event code='8007' textcode='OFFLINE_SESSION_EXISTS'>
 361                 <desc xml:lang="en-US"> A session with the given name already exists </desc>
 362         </event>
 363         <event code='8008' textcode='OFFLINE_INVALID_SESSION'>
 364                 <desc xml:lang="en-US"> The session name is invalid </desc>
 365         </event>
 366         <event code='8009' textcode='OFFLINE_NO_ORG'>
 367                 <desc xml:lang="en-US"> No org id was provided </desc>
 368         </event>
 369         <event code='8010' textcode='OFFLINE_SESSION_COMPLETE'>
 370                 <desc xml:lang="en-US"> No org id was provided </desc>
 371         </event>
 372
 373         <!-- ================================================================ -->
 374
 375 </ils_events>
 376
 377
 378
 379