Med MessageLog-endepunktet kan du sende informasjon fra hendelser i integrasjonen din slik at det blir synlig i Handyman Office. Dette kan være feilmeldinger fra integrasjonen eller logging av hendelser for dataoverføring. Dette vil være verdifull informasjon for supportpersonell og kunder for å evaluere dataflyten i en integrasjon.
Introduction
Meldingsloggen kan bestå av enkeltmeldinger eller flere meldinger koblet i en "økt". Den grunnleggende strukturen for en loggingsøkt er:
- Header record
- This is a record with “sequence” = 0
- The “sessionid” used for this record must also be used in the subsequent messages
- n messages connected to the same session
- “sequence” > 0 (Vanligvis øker den med 1 for hver melding. Dette brukes for å sortere meldingene i brukergrensesnittet)
- If we get an error from HMAPI or CW API we must log them as errors or warnings.
SessionID format
SessionID can be any numeric decimal value, but we are using this format internally to make a unique value:
-<yy><MM><dd>.<HH><mm><ss><fff> (fff is milliseconds)
Example: -221009.122455879
Example code in C#
string sessionId = DateTime.Now.ToString("-yyMMdd.HHmmssfff");
return double.Parse(sessionId, CultureInfo.InvariantCulture)
MessageLog-endepunktet tar en matrise med meldinger. Hvis du ikke oppgir en økt-ID, vil API-en opprette en og bruke den på alle elementene i matrisen. Hvis du vil logge ekstra feilmeldinger til samme økt, må du opprette din egen økt-ID som beskrevet ovenfor og sende den med alle meldingene.
Values in MessageID field
The message id has en enum that will result in different icons connected to the message in the Handyman Office UI.
ProgramError = 1
Warning = 2
OrderEvent = 3
Communication = 4
DebugMessage = 5
SyncOk = 6
Store = 7
Database = 8
ProgramErrorInfo = 9
Customer = 10
SalaryCode = 11
ItemPackage = 12
Wholesaler = 13
PurchaseOrder = 14
Employee = 15
Settings = 16
Groups = 17
Dictionaries = 18
CheckLists = 19
Printouts = 20
ToBackoffice = 21
FromBackoffice = 22
Appointment = 23
ItemNumberType = 24
TimerEvent = 25
Quote = 26
AutomaticCopy = 27
AutomaticEmail = 28
AutomaticPrint = 29
PDFGenerated = 30
The most common for header records is 21 and 22 (Export, Import)