Med MessageLog-endepunktet kan du sende information fra hændelser i din integration, så det er synligt i Handyman Office. Dette kan være fejlmeddelelser fra integrationen eller logning af dataoverførselshændelser. Dette vil være værdifuld information for supportpersonale og kunder til at evaluere dataflowet i en integration.
Introduction
Meddelelsesloggen kan bestå af enkeltmeddelelser eller flere meddelelser forbundet i en "session". Den grundlæggende struktur for en logningsession 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 (Normalt øges den med 1 for hver meddelelse. Dette bruges til at sortere meddelelserne i brugergrænsefladen)
- 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 tager en array af meddelelser. Hvis du ikke angiver en sessionId, vil API'en oprette en og bruge den på alle elementer i arrayet. Hvis du vil logge yderligere fejlmeddelelser til den samme session, skal du oprette din egen sessionId som beskrevet ovenfor og sende den med alle meddelelserne.
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)