HMS - Hogiahmsdownload.hogia.se/files/HMS/2012.2/HMS2011.pdf · HMS övertar nu ansvaret för att...

HMSHogia Messenger Service

InnehållsförteckningHMS - Hogia Messenger Service . . . . . . . . . . . . . . . . . . . . .3HMS - Hogia Messenger Service . . . . . . . . . . . . . . . . . . . . .4Systemkrav . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4Översikt . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5Huvudfunktioner i HMS . . . . . . . . . . . . . . . . . . . . . . . . . . .5Arkitektur . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6Flöde . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .7

Ordlista . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .8Uppgradera från en äldre version . . . . . . . . . . . . . . . . . . . . 9

Börja använda programmet . . . . . . . . . . . . . . . . . . . . . . . .11

HMS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .14Parter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .16Egenskaper . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .19Kommunikationssätt till parten . . . . . . . . . . . . . . . . . . . . .19Kommunikationssätt från parten . . . . . . . . . . . . . . . . . . . .23Distributionslistor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .30Synkronisering . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .31Avancerat . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .33Översikt . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .34Meddelanden . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .37

Driftslogg (avancerad) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .42

Arkiv . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .43Ny part . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .43Nytt meddelande . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .43Spara . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .43Inställningar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .44

Övervakningstjänst . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .44Minnesutnyttjande . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .46

Backup/Återställ databas . . . . . . . . . . . . . . . . . . . . . . . . . .50

Redigera . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .51Ta bort part . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .51Konverteringsmoduler . . . . . . . . . . . . . . . . . . . . . . . . . . . .51Kommunikationsmoduler . . . . . . . . . . . . . . . . . . . . . . . . .51Hjälp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .52

Innehåll och index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .52Bruksanvisning PDF . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .52Licens och support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .52Om Hogia Messenger Service… . . . . . . . . . . . . . . . . . . . . . . . . . . .53

Hogia bedriver kontinuerlig utveckling av programmet och reserverar sig för avvikelse mellan program och handbok.

Version 2011.1© Hogia Service AB, oktober 2011

- 3

HMS - Hogia Messenger Service

Välkommen som HMS-kund. Vi hoppas att Hogia Messenger Service ska vara till er belåtenhet.

Leveransen sker via nedladdning från internet eller på DVD. På följande sidor får du installationsanvisning för programmet.

� OBS! Programmet är utvecklat för de operativsystem som specificeras i systemkraven för programmet. I denna installationsanvisning benämner vi alla typer av SQL installationer som SQL eller Databasmotor. I sys-temkraven kan ni läsa om vilka SQL-versioner programmet kan köras på. Installerar du på annat operativ-system kan Hogia inte garantera att ekonomisystemet kommer att fungera eller att andra program på datorn kommer att fungera efter installation.

Installationen innehåller SQL Server 2008 Express.

4 -

HMS - Hogia Messenger Service

Vad HMS är och inte ärHogia Messenger Service är en programvara som är framtagen för att hantera kommunikation mellan fri-stående program, t ex Hogias ekonomisystem och en webbshop. Programmen som deltar kallas i HMS för parter och informationen utbyts i form av meddelanden.

Dessa meddelanden kan till exempel innehålla information om nya artiklar, kunder som bytt adress eller frågor om en viss leverantör finns. Att analysera vad som kommuniceras ligger utanför HMS ansvarsområ-de, styrkan ligger istället i att säkerställa att informationen går fram och på det sätt som avsändande och mottagande program önskar. Alla meddelande sparas i HMS databasen, det innebär att du kan se de med-delanden som hanterats och i de fall något fel uppstått vari felet består.

KopplingarFör att ett program ska kunna kommunicera med ett eller flera andra program via HMS krävs att vissa vill-kor uppfylls och att kopplingar mellan programmet och HMS ställs in. För att underlätta för dig som kund medföljer ett antal färdiga kopplingar till olika program redan från början. Fler färdiga kopplingar kan tas fram efterhand och importeras till HMS. Möjlighet att göra helt egna kundunika kopplingar i HMS finns också.

Om du som programvaruleverantör eller en kund vill ta fram en ny färdig koppling hänvisar vi till support-avdelningen på det Hogiabolag där du är kund. De ser till att du blir kontaktad av en integratör som tar fram de dokument och kod-exempel du behöver.

Mer informationDetta dokument täcker enbart själva installationsfasen av HMS. Hur HMS sedan ska användas framgår av de hjälpfiler som nås från HMS-programmet under menyalternativet Hjälp.

För information om hur andra program skall installeras och användas hänvisar vi till respektive handbok.

Mer information om integrationer mellan programvaror, programuppdateringar med mera kontaktar du din integratör/supportavdelning.

SystemkravProgrammets systemkrav hittar du på Hogias kundtorg (www.kundtorg.hogia.se), där du logga in med kundnummer och de tre första bokstäverna i kundnamnet, eller genom din integratör på Hogia.

Hogia Messenger Service består av följande delar:

• Installation för server (meddelandetjänst och administratörsgränssnitt)

• Installation för eventuella klienter (enbart administratörsgränssnitt)

• Anpassad installation

- 5

ÖversiktBehovet av att förmedla information mellan två programvaror ökar stadigt. Register ska synkroniseras, pos-ter ska överföras när de har förändrats, program ska besvara förfrågningar om tillgänglig information m m.

HMS (Hogia Messenger Service) är en produkt som förenklar denna kommunikation. Dess roll är att agera osynlig växel mellan programvaror. Programvarorna behöver inte själva ha funktionalitet för att transpor-tera meddelanden och behöver inte heller kunna hantera på vilket sätt som mottagaren önskar få informa-tionen till sig. HMS garanterar också att meddelande alltid kommer fram utan att avsändaren behöver bygga in stöd för det.

Genom att använda HMS kan respektive program fokusera på det som ger den verkliga affärsnyttan, dvs de olika meddelande som ska skickas mellan de olika systemen.

HMS hanterar både den fysiska meddelandeöverföringen och översättning mellan olika typer av medde-landeformat. Det ger stöd för de vanligaste kommunikationssätten, för mellanlagring, översättning med hjälp av översättningsmoduler, loggning och distributionslistor.

Huvudfunktioner i HMS• Hanterar flera olika kommunikationssätt

• Synkron och asynkron meddelandeförmedling. Synkron innebär att avsändaren inväntar svaret innan den tar itu med att bearbeta nästa meddelande. T ex en kontoförfrågan. Asynkron tillåter HMS att bearbeta andra meddelanden under tiden det första meddelandet bearbetas. T ex en överföring av leverantörsfakturor till ena parten som ska resultera i att ett meddelande om verifikationsnummer skickas tillbaka till avsändaren.

• Mellanlagring

• Tidsstyrd aktivering

• Multipla mottagare

• Loggning

• Översättning mellan olika typer av meddelandeformat

6 -

ArkitekturBilden nedan visar schematiskt hur HMS - Hogia Messenger Service kan integrera t ex ett ekonomisystem med ett annat program. De blå, gröna och lila boxarna visar vilka möjligheter som finns att fördela programmen på olika maskiner.Att göra en sådan uppdelning är emellertid inte nödvändigt eller alltid önskvärt - samtliga delar går (möjligen med undantag av den okända "Program X") att drifta på samma maskin om man så önskar.

- 7

FlödeNär två system ska utbyta information sker detta genom att man lämnar över information till ett annat sys-tem eller att man begär information från ett system.

Användaren inväntar inte svaretAnvänds oftast när en part har förändrat en post i sitt register som han vill delge en eller flera andra parter. Avsändaren paketerar informationen i ett meddelande och skickar detta. Avsändaren förväntar sig i detta fall inget svar från mottagaren.

Avsändaren och mottagaren etablerar i det här fallet ingen förbindelse, respektive part har endast förbin-delse med HMS. Så snart avsändaren har fått klartecken från HMS att meddelandet har anlänt kan han släppa sin förbindelse. HMS övertar nu ansvaret för att meddelandet skickas vidare till mottagaren.

Under en viss tid och med ett visst antal max antal sändningsförsök kommer HMS att försöka skicka med-delandet till mottagaren. Varje försök loggas med tidpunkt, eventuellt fel som uppträdde osv. Om max antal sändningsförsök uppnåtts utan att meddelandet kunnat levereras markeras det som felaktigt och inga fler sändingsförsök kommer att göras.

Användaren inväntar svaretBegäran används när en part har behov av information som finns tillgänglig hos en annan part. En begä-ran paketeras därför i ett meddelande och skickas till HMS. HMS upprättar omedelbart en förbindelse med mottagaren och väntar på ett svar. När svaret kommer vidarebefordras det till frågeställaren.

Här finns följaktligen två öppna förbindelser, dels mellan den som begär information och HMS, dels mellan HMS och den som besvarar begäran. Detta innebär att endast de kommunikationssätt som stöder syn-krona förbindelser, Web Service eller COM, kan användas. En begäran kan endast skicka till unika motta-gare eller till distributionslistor som innehåller en mottagare.

Adressering av meddelandeAdressering av avsändare och mottagare kan ske på två olika sätt:

1. Meddelandet är förpackat i ett kuvert där identiteterna för avsändaren och mottagaren framgår.

2. Alla meddelanden som läggs i en viss katalog antas komma från en viss avsändare och till en viss motta-gare.

ParterEn part är en aktör som är delaktig i informationsöverföringen mellan programvaror. Den representerar ofta just en viss programvara, men behöver inte göra det. En part kan vara avsändare och/eller mottagare av meddelande.

SubpartEn subpart är en intern delmängd av en part, t ex ett företag i ett ekonomisystem. Vilka subparter som finns ändras betydligt oftare än vilka parter som finns.

DistributionslistaHMS stöder även möjligheten att distribuera ett meddelande till flera mottagare. Det möjliggörs via distri-butionslistor. En distributionslista knyts till en part och innehåller referenser till alla de parter som du vill sprida ett meddelande till. När du i ett meddelande anger en distributionslista som mottagare kommer HMS att duplicera meddelandet för varje part som ingår i listan och därefter vidarebefordra dessa till res-pektive mottagare.

Kommunikationssätt

Meddelande till HMS / Meddelande från HMSDet är möjligt att välja mellan Fil, COM, Web Service, E-post, FTP och MSMQ.

8 -

OrdlistaAvsändare Program eller del av program som skickar meddelande via HMS.

Mottagare Program eller del av program som tar emot meddelande via HMS.

Part Avsändare och/eller mottagare. Oftast ett gränssnitt mot en programvara.

Subpart En del av en part, t ex ett företag i ett ekonomiprogram.

Parttyp Alla parter som t ex är Hogias ekonomisystem har samma parttyp. Parttypen definieras i en speciell XML-fil som bl a innehåller beskrivning av parten, hur kommunikation normalt sker osv. Flera parttyper finns klara för användning direkt och nya kan enkelt läggas till efterhand som Hogia eller olika programvaruleverantörer gör dem tillgängliga.

Meddelandeformat HMS hanterar i princip vilka XML- och textformat som helst. Nya format läggs till i och med att nya parttyper importeras.

Kuvert Många meddelanden som skickas via HMS paketeras i ett kuvert där avsändande och mottagande part framgår. Finns inget kuvert måste t ex alla meddelanden som läggs i en viss filkatalog vara från och till en viss part. För närvarande stöds kuvertformatet Hogia_Message.

Avsändaren inväntar Ett meddelande innehållande information som ska förmedlas till angiveninte svar (asynkron) mottagare.

Avsändaren inväntar Ett meddelande som innehåller en begäran om information. En direktför-svar (synkron) bindelse öppnas mellan avsändare och mottagare via HMS. Avsändaren

förväntar sig ett omedelbart svar från mottagaren med önskad information.

Kommunikationssätt Hur HMS anropar en part t ex via fil eller Webservice.

Konverteringsmodul En plugin (zip-fil) som hanterar översättning mellan olika meddelandeformat. Några konverteringsmoduler finns klara för användning direkt och nya kan enkelt läggas till efterhand som Hogia eller olika programvaruleverantörer gör dem tillgängliga.

Kommunikationsmodul En plugin (zip-fil) som utökar kommunikationsfunktionaliteten i HMS. Kommu-nikationsmoduler tillhandahålls av Hogia eller programvaruleverantörer.

- 9

Uppgradera från en äldre version1. Installerar du från en DVD startar installationsprogrammet automatiskt när du sätter in en DVD i CD-

facket. Sker inte detta klickar du på "Den här datorn" på skrivbordet. Välj Öppna eller Utforska CD-enheten och dubbelklicka sedan på filen HogiaMessengerServiceSetup.exe.

2. Installerar du via Internet loggar du in på Hogias kundtorg (www.kundtorg.hogia.se) genom att ange ditt kundnummer och de tre första bokstäverna i ert kund-namn.

Gå till Nedladdningar och klicka på installationsfilen för HMS. Du kan köra installationen direkt eller spara filen på din hårddisk och starta installationen när du sparat filen.

3. Installationen börjar med att packa upp installationen och kontrollera komponenter på din dator.

4. Ett fönster med möjlighet att välja vad som ska installeras visas nu.

Här kan du välja att Uppgradera Hogia Messenger Service med samma inställningar som nuva-rande installation.

10 -

Alternativt kan du välja att Anpassa och uppgradera Hogia Messenger Service. Det här valet ger dig möjlighet att i samband med uppdateringen förändra installationen av HMS. Se flödet under Installation av Hogia Messenger Service från och med bild 2.

5. Har du valt att uppgradera med samma inställningar får du som nästa steg godkänna licensavtalet.

6. Därefter startar uppgraderingen.

7. När uppgraderingen är klar bör du starta HMS och se till att meddelandetjänsten är startad.

8. Om databasen behöver uppgraderas visas information om detta nu. Tryck i så fall på Nästa>> för att starta uppgraderingen.

9. När uppgraderingen är klar visas information om resultatet. Om någon guide för att skapa en ny koppling (parttyp) eller någon konverterare mellan olika meddelandeformat inte gick att uppgradera automatiskt visas information om detta. Detaljerad information om vilka problemen var kan du hitta under fliken Driftslogg (avancerat) i HMS. Mer information om hur parttyper och konverterare istället kan importeras/uppgraderas manuellt från administratörsverktyget framgår av handboken.

HMS - Börja använda programmet 11

Börja använda programmet

Starta administratörsverktyget första gångenStarta administratörsverktyget för Hogia Messenger Ser-vice genom att dubbelklicka på ikonen på skrivbordet. Den användare du använder första gången du startar HMS kommer att bli administratör för programmet.

Nu skall databasen skapas, i samband med detta anger du lösenordet du lade in för sa när databasmotorn instal-lerades. När du angivit det klickar du på Nästa.

12 HMS - Börja använda programmet

När databasen är skapad går du vidare. Det är dags att hämta din licens.

Fyll i dina uppgifter och klicka på knappen Registrera. I fönstret är samtliga fält obligatoriska och måste fyllas i. Notera att det är viktigt att Licensnum-mer och företagsnamn fylls i korrekt. Korrekta uppgifter hittar du på senaste följesedeln du fått från oss.

Om du är uppkopplad mot Internet kommer registreringen att ske automatiskt. Är alla uppgifter korrekt ifyllda skickas en licensnyckel tillbaka och programmet registreras. Om uppgifterna skulle vara felaktigt ifyllda kommer du att få ett felmeddelande och vår leveransavdelning kommer att meddelas om detta. De tar då hand om registreringen manuellt.

Vid kommunikationsproblem (t ex då uppkoppling mot Internet saknas) i samband med registre-ringen kommer två nya knappar att visas. Dessa ger dig möjlighet att utföra registrering via E-post eller Fil. Klickar du på E-post skapas ett e-postmeddelande som innehåller registreringsupp-gifterna.

Trycker du på Fil skapas en textfil med samma uppgifter. Denna fil kan sedan föras över till en anna dator via ett usb-minne och därefter skickas till oss så att vi manuellt kan ta hand om regist-reringen och skicka tillbaka en licensfil. Denna fil får ni sedan flytta till datorn där HMS är installe-rat via usb-minnet.

När vi mottagit e-postmeddelandet från er skickar vi tillbaka en licensfil. Om du har e-post på datorn där du har Hogia Admin lägger du den fil vi skickat i en mapp på hårddisken eller på skriv-bordet. För att läsa in filen klickar du på knappen Importera licens och du får upp ett fönster där du får möjlighet att hämta filen där du sparade ner den.

Har du inte e-post på den dator där Hogia Admin finns installerat får du kopiera ner filen på ett USB-minne eller liknande för att sedan kunna kopiera in den till datorn och därefter importera den.


Du kommer nu till den inloggning som sedan kommer att gälla i fortsättningen.

Ange lösenordet och logga in genom att trycka på OK.

I vissa fall, till exempel då HMS tidigare varit installerat och databasen HogiaMessengerService manuellt tagits bort, syns inloggningsdialogen med en gång. Tryck då på knappen Byt... och välj att skapa en ny databas.

Även i andra fall då inloggningen behöver ändras löser man ofta problemet genom att trycka på knappen Byt.... Exempel på sådana fall är:

• Databasen har flyttats till en annan dator

• Lösenordet för administratörsanvändaren har glömts bort.


HMS

VerktygsfältRaden med ikoner underlättar för dig som användare att snabbt komma åt de olika funktionerna i Hogia Messenger Service.

Disketten står för Spara ändringar.

Den här ikonen står för Ångra ändringar på parten.

Lägg till en ny part. En part kan vara en avsändare av ett meddelande eller en mottagare av ett meddelande eller både och. När du klickar på ikonen startar en guide som hjälper dig att lägga upp parten på ett korrekt sätt. Här kan du också importera guider och standardinställningar för parter utan att en ny version av HMS behöver installeras.

Ta bort parten. Markera parten i listan och klicka på ikonen.

Lägg till ett nytt meddelande.

Generella inställningar.


Importera och granska konverteringsmoduler. En konverteringsmodul översätter mellan två meddelandeformat. När du klickar på ikonen kan du granska vilka översättningar som hanteras och få möj-lighet att lägga till nya moduler för översättningar.

Spara/Hämta kopia på databasen. Ta för vana att regelbundet ta backup på HMS-databasen för att arkivera meddelanden som skickats eller innan större förändringar som görs. Observera att vid återställ-ning försvinner alla inställningar och alla meddelanden som tagits emot av HMS sedan backupen togs. Använd alltså återställning endast i nödfall!

Visa hjälpfil.

I fältet Parter till vänster i fönstret ser du vilka Parter som finns upplagda i HMS. Vill du se information om en part markerar du parten i fältet och kan sedan genom att klicka på de olika flikarna för att se vad som gäller för just den här parten.

Längst upp i fönstret finns tre menyer och ett antal ikoner som du använder för att göra inställningar, läg-ga upp nya parter m m.

Längst ner finns flikarna Översikt, Meddelanden och Driftslogg.


ParterUnder Parter lägger du upp och konfigurerar de parter som ska vara delaktiga i ett informationsutbyte. En part kan vara en avsändare av ett meddelande eller en mottagare av ett meddelande eller både och.

Ny part Klicka på ikonen Lägg till ny part (se bilden ovan) för att lägga upp en helt ny part. En guide startar som hjälper dig att lägga upp parten på ett korrekt sätt. Tillsammans med programmet levereras färdiga guider. Allteftersom nya guider tas fram av Hogia eller din programvaruleverantör kan dessa enkelt läggas till HMS.

Börja med att välja Typ av part. Du har flera färdiga kopplingar att välja bland till exempel Hogias Ekono-misystem, Itella, Kats, Svea Ekonomi, Svea Inkasso och Övriga.

Valet Övriga skiljer sig från de andra genom att samtliga kommunikationssätt etc måste anges manuellt. För de andra vägleds du av en guide och standardinställningar för kommunikationen fylls i.

Beroende på vilken part du väljer att lägga upp kommer du att få ett antal frågor att besvara.

Har det nyligen tillkommit en guide har du möjlighet att hämta in denna genom att klicka på knappen Importera guide. Du kan då hämta upp guiden som du har sparat på din hårddisk eller som du har lig-gande på en cd eller dylikt.


Har du valt t ex Hogia Ekonomisystem och trycker på Nästa visas först en dialogruta för att hämta eller ange giltig licens att skapa denna typ av part. Därefter visas fönstret nedan:

Acceptera den föreslagna datorn genom att gå vidare med Nästa eller skriv in namnet på en annan dator innan du klickar på Nästa. I nästa steg får du klicka på Slutför för att parten ska läggas upp.

Du har nu lagt in en part och kopplingar till denna. Du kommer tillbaka till huvudfönstret och kan se att parten finns upplagd.

Uppgifterna om parten finns samlade på ett antal flikar: Egenskaper, Meddelande till parten, Meddelan-den från parten, Dist-listor, Synkronisering och Avancerat.

För att spara inställningarna för parten klickar du på knappen Spara.


ÖvrigOm du istället väljer att lägga in en Övrig part, där det inte finns en färdig guide du kan använda, kommer du när du klickat på OK till fönstret nedan:

Klicka på Slutför för att parten ska läggas upp.

Åter i huvudfönstret kan du se att det har lagts upp en ny part i fältet Parter.


Egenskaper

Under fliken Egenskaper har du möjlighet att ändra det föreslagna namnet och beskrivningen av kopp-lingen mot parten.

Kommunikationssätt till parten

Här kan du ange vilket eller vilka kommunikationssätt du vill använda för att skicka meddelanden till par-ten. Flera kommunikationssätt kan läggas upp och vara aktiva samtidigt, dessa kommer att användas av HMS i prioriteringsföljd där prio 1 kommer att användas först. Vid kommunikationsproblem kommer HMS automatiskt att försöka med nästa aktiva kommunikationssätt i prioriteringsordning.

� Observera att varje part bör ha egna unika kommunikationssätt (filkataloger etc). Vissa typer av parter tillå-ter inte att kommunikationssätt läggs till eller tas bort eftersom de angivna kommunikationssätten är precis de som parten kräver och hanterar.

Då flera alternativa kommunikationssätt finns till parten kan du välja vilka som ska användas genom att markera dem och trycka på Aktivera.

Markera ett kommunikationssätt och klicka på knappen Flytta upp eller Flytta ned för att ändra ett kom-munikationssätts prioritering i listan.

Klicka på pilknappen vid fältet Nytt kommunikationssätt (i det fall nya kommunikationssätt får läggas till på parten) och du får upp följande alternativ:

.Net Reflection/RemotingDenna funktion är ännu ej implementerad och kommer i en senare version av HMS.


Com

Komponentens namnAnge komponentnamnet (prog-id) för den komponent som ska ta emot meddelanden från HMS.

DatornamnAnge namnet på den dator där komponenten är registrerad. Om fältet lämnas tomt antar programmet att komponenten är installerad på samma dator som HMS.

FormatSe “Meddelandeformat, filkodning och mottagande part/distributionslista (gäller för samliga kommunika-tionssätt)” på sidan 30.

E-post

Ska informationen skickas via e-post skriver du här in den e-postadress som är mottagarens respektive avsändarens.

PortNormalt används TPC-port nummer 25. Om annan port används måste denna öppnas upp i brandväggen om sådan finns.



Fil

Sökväg till katalogSkriv in sökvägen på datorn där HMS är installerad, alternativt nätverkssökvägen, till den katalog där filerna ska placeras.

Lägg varje meddelande i en egen katalogOm denna ruta är förbockad läggs varje meddelande och tillhörande bilagor från HMS i en egen underka-talog.


FTP

ServerHär skriver du in namnet på FTP-servern.

KatalogAnge sökvägen till FTP-servern. Denna kan vara Windows- eller Unix-baserad. Observera att servern kan skilja mellan gemener och versaler i sökvägen till katalogen.

Temp katalogKatalog som HMS använder för att temporärt lagra meddelanden medan överföring sker.

Användarnamn och LösenordSkriv in namn och lösenord på den användare som ska logga in på FTP-servern.


Lägg varje meddelande i en egen underkatalogÄr rutan förbockad läggs varje meddelande och tillhörande bilagor från HMS i en egen underkatalog.

Använd temporär katalogNär denna ruta är förbockad så används en temporär katalog vid uppladdning av meddelanden till parten. När uppladdningen av filen är klar kommer HMS att flytta filen ifrån den temporära katalogen till den slut-giltiga destinationen.

MSMQ

ServerAnge sökvägen till MSMQ-servern där den aktuella kön finns.

KöSkriv in namn på den kö som meddelandena skall skickas till. Privata köer definieras enligt följande: pri-vate$\könamn.

� Observera att när du testar kommunikationen är det konto du är inloggad med som autentiserar mot kön, detta konto behöver inte vara samma konto som kör Meddelandetjänsten vilket kan resultera i rättighetsfel!


Web Service

URLAnge sökvägen till den fil som innehåller servicedefinitionen.

KomponentSkriv in namn på den komponent som anropas. Normalt är detta HMS. Observera att skillnad görs mellan gemener och versaler!

FormatSe “Meddelandeformat, filkod-ning och mottagande part/distri-butionslista (gäller för samliga kommunikationssätt)” på sidan 30.


Kommunikationssätt från parten

På samma sätt kan du här ange på vilket sätt kommunikationen ska ske från parten till HMS.

Nytt kommunikationssättHär kan du ange på vilka sätt HMS ska hämta meddelanden från parten via E-post, fil eller FTP. Om parten skickar meddelanden till HMS via COM eller webservice behöver inga inställningar för dessa göras.

Till skillnad från kommunikationssätten till parten kan flera vara aktiva samtidigt, dvs HMS kan hämta med-delanden från samma part på flera olika sätt.

E-post

Från parten

E-postserver (POP3)Sökväg till e-postservern, t ex Exchange.Company.Com

PortNormalt används TCP-port 110. Om en annan port används måste denna öppnas upp i brandväggen om sådan finns.


Inloggningsnamn / LösenordInloggningsnamnet hämtas från den inloggning som finns på datorn. Lösenordet är det som används vid denna inloggning.

Använd SSL-krypteringOm kryptering ska användas. Vanligtvis avslaget.

MeddelandeformatSe “Meddelandeformat, filkodning och mottagande part/distributionslista (gäller för samliga kommunika-tionssätt)” på sidan 30.

Mottagare

Hämta meddelande

Nästa anropHär kan du se och ställa in när nästa anrop ska ske.

IntervallAnge hur ofta HMS ska kontrollera om nya meddelande anlänt.

Fil

Hitta fil

SökvägSkriv in sökvägen på datorn där HMS är installerad, alternativt nätverkssökvägen, till den katalog där filerna ska hämtas.

Varje meddelande finns i en egen katalogOm denna ruta är förbockad hämtas meddelanden i underkatalogerna en nivå ner i förhållande till sökvä-gen.


FilnamnsfilterAnger ett filter på vilka filer som ska hämtas. Stjärna betecknar inga, ett eller flera valfria tecken. Till filtret läggs automatiskt den filändelse som anges av filformatet. Ett tomt fält är likvärdigt med en stjärna (alla filer som har rätt filändelse). Exempel:

Filformatet: Hogia.Economy.XML (använder filändelsen XML)Filnamnfilter:. *Kmatchar STORK.xml och K.xml.


Mottagare

HämtningsintervallAnge hur ofta HMS ska kontrollera om nya meddelande anlänt och när en sådan kontroll ska ske för första gången.

FTP

FTP-inställningar

ServerHär skriver du in namnet på FTP-servern.

KatalogAnge sökvägen till FTP-servern. Den kan t ex vara Windows- eller Unix-baserad. Observera att servern kan skilja mellan gemener och versaler i sökvägen.


Användarnamn och lösenordSkriv in namn och lösenord på den användare som ska logga in på FTP-servern.

Varje meddelande finns i en egen underkatalogOm rutan är förbockad hämtas meddelanden i underkatalogerna en nivå ner i förhållande till sökvägen.

FilnamnsfilterAnger ett filter på vilka filer som ska hämtas. Stjärna betecknar inga, ett eller flera valfria tecken. Till filtret läggs automatiskt den filändelse som anges av filformatet. Ett tomt fält är likvärdigt med en stjärna (alla filer som har rätt filändelse). Exempel:

Filformatet: Hogia.Economy.XML (använder filändelsen XML)Filnamnfilter:. *K

matchar STORK.xml och K.xml.


Hämtningsintervall

Nästa anrop / IntervallAnge hur ofta HMS ska kontrollera om nya meddelande anlänt och när en sådan kontroll ska ske för första gången.


MSMQ

MSMQ-inställningar

ServerAnge sökvägen till MSMQ-servern där den aktuella kön finns.

KöSkriv in namn på den kö som meddelandena skall hämtas ifrån. Privata köer definieras enligt följande: private$\könamn.

EtikettfilterEtikettfilter använder sig av så kallade reguljära uttryck för att filtrera meddelanden på etikettnivå. För att exempelvis hämta enbart meddelanden vars etikett börjar på "HMS" ange "^HMS".

Max antal meddelandenHär definieras hur många meddelanden som maximalt skall hämtas vid varje meddelandehämtning. Tillåtna värden är 1-1000.

Skapa kön om den inte existerarOm detta är förbockat kommer HMS, om kön inte finns, att skapa den.

Använd journalköOm Använd journalkö är förbockat kommer HMS att lägga hämtade meddelanden i journalen för kön. Denna inställning förutsätter att journalkö är aktiverat för den aktuella kön.

MeddelandeformatSe Meddelandeformat, filkodning och mottagande part/distributionslista (gäller för samliga kommunika-tionssätt).


Meddelandeformat, filkodning och mottagande part/distributionslista (gäl-ler för samliga kommunikationssätt)

Format

Ange det meddelandeformat som parten tar emot eller skickar meddelanden i. Nya meddelandeformat läggs normalt upp samtidigt som nya parttyper importeras. Genom att klicka på symbolen visas en kortfattad sammanfattning av några viktiga egenskaper för det valda formatet:

Typ kan vara Text eller XML.Om meddelandeformatet förpackas i ett Hogia_Message-kuvert framgår bl a vem som är avsändande och mottagande part.

Gå därefter igenom övriga flikar och lägg in de uppgifter som krävs. När det gäller Hogias ekonomisystem behöver du i normalfallet endast göra tillägg under fliken Synkronisering (detta för att få ekonomisyste-met att skicka meddelanden till andra parter då förändringar sker).

Glöm inte att slutligen spara alla inställningarna för parten genom att klicka på knappen Spara.

Filkodning

Då meddelanden skickas via fil är det viktigt att rätt filkodning används, annars finns det stor risk att vissa tecken (t ex de svenska tecknen åäö) blir felaktiga eller t o m att hela meddelandet blir oläsligt.

För att kontrollera om en viss filkodning är lämplig för ett visst meddelande kan du trycka på knappen Kontrollera och bläddra fram till meddelandefilen i fönstret som då visas. Lämpligen väljer du en medde-landefil med så många icke-amerikanska tecken som möjligt.

Genom att ändra filkodning kan du direkt se hur filen kommer att tolkas.


Mottagande part/distributionslista

I det fall meddelandeformatet inte använder Hogia_Message-kuvert (se Meddelandeformat på sidan 30) måste en mottagande part eller distributionslista (som tillhör parten) anges.

Om formatet använder Hogia_Message-kuvert kan du ignorera vem meddelandet anger som mottagare och istället använda den som anges här. I normala fall låter du dock meddelandet avgöra vem som ska vara mottagare.


DistributionslistorDistributionslistor används för att skicka samma meddelande till många mottagare från en part (avsända-re). Det kan jämföras med en gruppadress för e-postmottagare. I vissa fall vill man att ett visst meddelande ska uppdatera flera andra system. För att åstadkomma det lägger du upp en distributionslista och väljer de parter som meddelandet ska skickas till.

Klicka på knappen Ny dist-lista. En distributionslista skapas och i fälten ID och Beskrivning ger du distri-butionslistan ett namn och en beskrivning. Bocka för de parter som meddelandet ska skickas till. HMS kommer automatiskt att duplicera meddelandet och skicka det till alla som ingår i listan.

DistributionslistorHär kan du se de listpor som finns upplagda sedan tidigare.

Egenskaper för vald distributionslista

IDSkriv in ett namn på distributionslistan. Namnet ska vara unikt för parten. För att ett meddelande ska nå mottagarna i distributionslistan ska parten skicka ett meddelande med ToPartId satt till detta värde i det fall Hogia_Message används.

BeskrivningHär kan du skriva in en valfri beskrivning.

Från FöretagsnummerVill du att distributionslistan endast ska gälla meddelanden från en viss subpart (t ex företag) hos parten kan du ange det här Om fältet lämnas blankt gäller distributionslistan alla subparter.

Mottagande parterInnehåller alla upplagda parter (utom de som äger distributionslistan) i HMS. Bocka för de parter eller sub-parter som du vill vidarebefordra meddelanden till och som skall ingå i distributionslistan.


SynkroniseringEn synkronisering är en uppmaning till en part att skicka meddelanden om vilka förändringar som skett till andra parter. En synkronisering kan t ex gälla från företag nummer 9999 i Hogias ekonomisystem till före-tag nummer 123 hos parten X. Vilken information som ska skickas är upp till varje part att bestämma, men kan t ex styras beroende på egenskaperna på synkroniseringen.

När en synkronisering sker skickas ett meddelande till parten från HMS innehållande en uppmaning att returnera ett meddelande innehållande de förändringar som skett som berör den tänka mottagaren. Om parten då returnerar ett meddelande vidarebefordrar HMS detta.

Klicka på Ny synkronisering för att lägga upp en ny sådan koppling från parten som är markerad i listan på parter. Varje synkronisering måste ha ett unikt namn och flera kan vara aktiva samtidigt för en viss part.

Namn på synkroniseringenVarje synkronisering måste ha ett unikt namn.

Avsändare

Från FöretagsnummerAnge vilket företag som ändringsmeddelanden ska skickas från. Begreppet Företagsnummer kan variera beroende vilket begrepp parten använder.


Mottagare

Part / DistributionslistaAnge vilken part eller distributionslista som ska ta emot ändringsmeddelanden.

Synkroniseringsintervall

Nästa anrop IntervallAnger hur ofta HMS ska skicka en begäran om synkronisering till parten.

BeskrivningHär kan en valfri beskrivning av synkronkroniseringen göras.

KommandoDenna information kan t ex parten använda för att bestämma vilken information som ska skickas. I fallet Hogias ekonomisystem ignoreras informationen (vad som ska skickas anges istället i företagsinformatio-nen).

• Tryck på OK.

• Kontrollera därefter att synkroniseringen är aktiv (indikeras med en grön bock, tryck på Aktivera/Avakti-vera för att ändra).

• Tryck slutligen på Spara.

• Kontrollera att synkroniseringen nu fungerar (en grön bock syns i kolumnen Synkning och kolumnen Senast synkad visar tidpunkt då detta senast skedde). Om något fel uppstår undersöker du detta på samma sätt som då anslutning sker.


Avancerat

Meddelande till part

Accepterar meddelanden i formatet HMSFöljande meddelanden till en part kan skickas i meddelandeformatet HMS:

• Anslutningsmeddelande (SetPart). Då en part läggs upp skickas normalt ett anslutningsmeddelande att parten nu är ansluten till HMS.

• Uppmaning att synkronisera (GetChanges).

• Fråga om vilka subparter som finns (GetSubParts).

• Testmeddelande (Test).

Exakt hur dessa meddelanden är utformade framgår av XML-schemafilen Hogia_WinHMS.xsd som ingår i HMS-installationen och även finns att ladda ner på Partnerportalen (www.hogia.se/ekonomipartner).

Anslutning

Skicka anslutningsmeddelande innan anslutningEtt anslutningsmeddelande från HMS innehåller bl a information om vilken dator som HMS är installerad på och vad parten har för ID och namn.

Bilagor

Hämta bilagor i följande filformatAnge filändelser på de bilagor som ska hämtas samtidigt som meddelanden från fil, FTP eller e-post. I det fall rutan Varje meddelande finns i en egen underkatalog är förbockat på kommunikationssättet från parten antas alla filer med dessa filändelser i samma katalog som meddelandefilen tillhöra meddelandet. Är rutan inte är förbockad måste bilagsfilerna ha samma namn som meddelandefilen (bortsett från filän-delsen).

Utgående filnamnHär kan formatet på utgående filnamn ändras för den aktuella parten. Med hjälp av variabler kan en egen filnamnsstruktur byggas upp, exempelvis kan filnamnet ”ORDER_312” erhållas med hjälp av följande sträng: ORDER_*MessageId*. Följande variabler kan användas: ToPartId, ToSubPartId, FromPartId, FromSubPartId, MessageId, Subject och MailSubject. Variabler markeras med hjälp av tecknet *.


ÖversiktUnder denna flik kan du snabbt få en uppfattning om hur kommunikationen med parterna fungerar.

Är allt OK kommer du att se gröna bockar i alla kolumner (gul bock indikerar att bearbetning sker och ett rött kryss ett fel).

ÖvervakningstjänstenÖvervakningstjänsten är en tjänst som tillhandahålls och används av Hogia för att upptäcka driftsstörning-ar i HMS-installationer. Med jämna tidsintervall (normalt varannan timme) skapas en statusrapport som skickas via krypterad förbindelse över internet till Hogia. För att statusrapporter ska kunna skapas och skickas måste meddelandetjänsten vara igång. Vid kommande kända driftsstörningar kan ett meddelande till Hogias supportpersonal anges under fliken Övervakningstjänst i inställningarna (menyvalet Arkiv - Inställningar).

Symbolen indikerar att rapportering till övervakningstjänsten har skett i rätt tid (en blinkande röd figur indikerar problem).

Genom att klicka på symbolen öppnas menyvalet Arkiv - Inställning för övervakningstjänsten.

MeddelandetjänstenTjänsten Hogia.Economy.HMS.WinService hanterar bl a meddelandeskickning, felrapportering och städ-ning av gamla meddelanden. Då t ex program som tar emot meddelanden från HMS ska uppgraderas rekommenderas att meddelandetjänsten temporärt stängs av under installationen.

Knappen används för att starta och stoppa meddelandetjänsten.

Uppdatering av statusinformationKnappen till vänster styr om uppdatering av gränssnittet ska ske automatisk eller inte. Uppda-teringsintervall kan ställas in under menyvalet Arkiv - Inställningar. Den högra knappen upp-

daterar statusinformationen manuellt.

Statusinformation om parterFör varje part visas sammanfattande statusinformation:

• Ansluten. En grön bock indikerar att anslutning lyckas (anslutningsmeddelande skickats utan att parten returnerat ett felmeddelande).

• Mottagare. Om alla meddelanden som skickats till parten kunnat tas emot.

• Avsändare. Om alla meddelanden från parten kunnat levererats till mottagaren.

• Hämtning. Om hämtning av meddelanden (enligt kommunikationssätt från parten) kunnat ske enligt angivna tidsintervall.

• Synkning. Om synkroniseringsuppmaningar kunnat skickas till parten från HMS enligt angivna tidsin-tervall.

• Anslutningstid. När senaste anslutningsmeddelandet skickades till parten.

• Senast synkad. När senaste synkroniseringsuppmaningen skickades från HMS till parten (Observera att parten vid detta tillfälle kanske inte hade något nytt meddelande att leverera).

• Från part. Hur många meddelanden som skickats hittills från parten.

• Till part. Hur många meddelanden som skickats hittills till parten.


• Senast från part. När ett meddelande senast skickades från parten (inklusive synkronsieringsmeddelan-den).

• Senast till part. När ett meddelande senast skickades till parten.

För att se detaljerad information om problem med anslutning markerar man den valda parten i och klickar på knappen Visa fel.

I fönstret som visas listas de kända problem som finns på parten.

För att se exakt vilka meddelanden som är felaktiga från respektive till parten får man gå till fliken Medde-landen (bredvid Översikt). Markera önskat problem och tryck på knappen Visa fel. Ett nytt fönster med felbeskrivning visas.

Genom att trycka på knappen Visa teknisk beskrivning kan detaljerad teknisk felbeskrivning läsas.


I det här fallet framgår det t ex att problemet beror på att fel e-postserver angetts:


MeddelandenUnder denna flik kan alla meddelanden som skickats till HMS och ännu inte raderats fullständigt läsas.

Status

Ett meddelande kan ha något av följande status:

• Mottagen. Meddelandet har tagits emot och sparats i HMS databas, men avsändare och mottagare har ännu inte kontrollerats.

• Läst. Avsändande och mottagande part har kontrollerats och en översättning till det meddelandefor-mat mottagaren önskar har gjorts. Misslyckade sändningsförsök kan ha skett, men max antal försök har ännu inte nåtts.

• Skickad. Meddelandet har levererats till mottagaren och mottagaren har antingen returnerat ett kor-rekt svarsmeddelande eller inget meddelande alls.

• Läsfel. Kan bero på något av följande:

- Angiven avsändare/mottagare saknas eller är felaktig.

- Mottagaren kan inte svara på ett meddelande där avsändaren inväntar svar (t ex beroende på att mot-tagaren kommunicerar via fil).

- Översättning till det meddelandeformat mottagaren önskar kan inte ske eftersom översättningsmodul saknas eller ett fel uppstod under översättningsprocessen.

• Leveransfel. Max antal sändningsförsök har gjorts utan att meddelandet kunnat levereras till mottaga-ren eller mottagaren har returnerat ett felmeddelande (ej korrekt meddelande).

Prioritet

Ett meddelande kan ha låg, normal eller hög prioritet. Prioriteten påverkar inte på något sätt hur HMS behandlar meddelandet, utan är enbart till som indikation till mottagande part och administratören. Oav-sett prioritet levererar alltid HMS meddelanden i samma ordning som de inkommer till en viss mottagare.


Ta bort meddelande manuellt

Knappen används för att ta bort gamla meddelanden manuellt. När du trycker på den visas en ny dialog där du väljer vilka meddelanden som ska tas bort (det markerade meddelandet ligger som default).

Uppdatering av meddelandelista

Knappen till vänster styr om uppdatering av gränssnittet ska ske automatisk eller inte. Uppdateringsinter-vall kan ställas in under menyvalet Arkiv - Inställningar. Den högra knappen uppdaterar meddelandelistan manuellt.

Filtrering av meddelanden

• Välj i dropplisten hur många träffar som ska visas.

• Klicka på ett kolumnhuvud för att sortera de träffar som visas.


• Tryck på knappen Sök för att visa ett fönster där urvalskriterier kan väljas:

• Status. Se “Status” på sidan 39.

• Prioritet. Se “Prioritet” på sidan 39.

• XML-fel. Om meddelanden som innehåller XML-taggen <Error> ska tas med i listan. Dessa meddelan-den behöver inte vara felaktiga, utan kan innehålla ett meddelande till mottagaren att någonting inte är bra.

• Mottaget. Datum när HMS tog emot meddelandet.

• Del av källa. T ex del av ett filnamn eller en MSMQ-kö. Om fältet Del av källa lämnas tomt inkluderas alla källor.

• Avsändare. Vilken part + SubPartId som är avsändare. Om fältet SubPartId lämnas tomt inkluderas alla subparter.

• Mottagare. Vilken part + SubPartId som är mottagare. Om fältet SubPartId lämnas tomt inkluderas alla subparter.

• Meddelandenummer. Varje meddelande i HMS tilldelas ett meddelandenummer.

• Tråd. Ett meddelande kan själva ange namnet på en tråd den tillhör. Om en part svarar på ett medde-lande ska samma trådnamn som meddelandet har användas även på det nya meddelandet så att det enkelt ska gå att spåra vilka som hör ihop. Om meddelandet inte tilldelas ett trådnamn av parten gör HMS det (samma som meddelandenumret).

• Fritextsökning. Del av texten som ingår i meddelandet.

• Sändningsförsök. Hur många sändningsförsök som minst måste ha gjorts.

• Sorteringsordning. Om meddelanden ska sorteras på äldsta eller nyaste mottagningstid. Sortering enligt mottagningstid kan också göras genom att klicka på kolumnhuvudet efter att träffarna visas, men i detta fall sorteras bara de träffar som syns.

• Metadata. När detta är påslaget kommer filtrering att göras på så kallad metadata som skickats in i meddelandets huvud. Filtreringen kan göras antingen genom att ange en metadatanyckel manuellt i fältet Nyckel eller genom att välja ett fördefinierad metadata alias.

• Alias för metadata. För att förenkla sökningar på metadata så kan så kallade alias läggas till. Metadata alias kan sedan användas vid sökning av metadata.

Knappen Återställ standardvärden sätter sökkriteriet till att gälla alla meddelanden med de nyaste först.


Visning av meddelande

Markera önskat meddelande och tryck på knappen som visar information om meddelandet. Följande föns-ter visas:

• Meddelandenummer. Varje meddelande i HMS tilldelas ett meddelandenummer.

• Från. Avsändande part (om detta har lästs).

• Till. Mottagande part (om detta har lästs).

• Exportera original till fil. Sparar ut meddelandet i sitt originalutförande med ursprungsnamn (om sådant finns) till valfri enhet.

• Spara och stäng. Om ett meddelande har status läsfel eller leveransfel kan ändringar i ursprungliga meddelandetexten göras. Om man därefter trycker på denna knapp sparas ändringarna och meddelan-det får status mottaget med noll sändningsförsök.

• Radera. Tar bort meddelandet. Detta kan bara göras på meddelanden som har status skickad, läsfel eller leveransfel. En automatisk städning för att frigöra minne görs också enligt inställningarna under menyvalet Arkiv - Inställningar.

• Föregående/nästa. Visa föregående eller nästa meddelande enligt den sorteringsordning som visas i listan på meddelanden.

Allmänt

• Rubrik. Den eventuella rubrik avsändande part har satt på meddelandet.

• Tråd. Ett meddelande kan själva ange namnet på en tråd den tillhör. Om en part svarar på ett medde-lande ska samma trådnamn som meddelandet har användas även på det nya meddelandet så att det enkelt ska gå att spåra vilka som hör ihop. Om meddelandet inte tilldelas ett trådnamn av parten gör HMS det (samma som meddelandenumret).

• Prioritet. Låg, normal eller hög.

• Typ. Identifieringsmeddelande från HMS eller vanligt meddelande. Identifieringsmeddelanden skiljer sig från övriga meddelanden genom att:


• Obegränsat antal sändningsförsök görs.

• Inga andra meddelanden till parten skickas till parten innan dessa levererats.

• XML-fel. Om meddelandet innehåller XML-taggen <Error>. Det innebär inte att det måste vara felak-tigt, men kan vara en indikation på att någonting inte är bra.

• Källa. Sökväg till fil etc till det ursprungliga meddelandet som lästes av HMS.

• Mottagen. När meddelandet togs emot av HMS.

• Skickad. När meddelandet skickades (utan fel) till mottagaren.

• Leveransförsök. Hur många leveransförsök som gjorts hittills.

• Status. Om meddelandet är mottaget, läst, skickat eller om läsfel eller leveransfel har uppstått. Se ovan för mer information.

• Typ. Om avsändande part inväntade svaret (synkront anrop) eller inte (asynkront anrop).

• Bilagor. Lista på bilagor som medföljer meddelandet. Tryck på Visa för titta på bilagan.

Meddelande in/ut

Under fliken Meddelande in visas meddelandet som det ser ut innan HMS har bearbetat och översatt det till önskat meddelandeformat.

Under fliken Meddelande ut visas meddelandet som det ser ut när HMS har bearbetat och översatt det. Observera att då ett meddelande skickas till en distributionslista eller översätts till ett annat meddelande-format kan resultatet bli flera meddelanden. I dessa fall ser Meddelande in likadant ut för varje sådant meddelande, medan Meddelande ut skiljer sig.


Läs-/Leveransfel

Under fliken Läs-/Leveransfel visas felmeddelande vis läsning, översättning till annat meddelandeformat eller fel som uppstod vid senaste leveransförsök till mottagaren.

Driftslogg (avancerad)

Under fliken Driftslogg (avancerat) visas teknisk information från HMS meddelandetjänst. Denna används främst då man i efterhand vill se vad som hänt vid en viss tidpunkt och vid felsökning. Driftsloggen rensas automatiskt enligt reglerna som ställs in under menyvalet Arkiv - Inställningar, och behåller endast de 20 senaste posterna med likalydande beskrivning.

HMS - Arkiv 43

Arkiv

Ny partVäljer du ny part kommer du till samma guide som om du klickar på knappen Ny part. Se “Ny part” på sidan 18.

Nytt meddelande

Fyll i meddelandetexten och tryck på Spara och stäng för att skapa ett nytt meddelande.

SparaVäljer du Spara kommer de ändringar som är gjorda men inte sparade att sparas för den part som just nu är aktiv.

44 HMS - Arkiv

Inställningar

ÖvervakningstjänstUnder denna flik kan inställningar för rapportering av felrapporter till Hogia göras och den senaste felrap-porten läsas.

Kunduppgifter

Kundnummer och datornummerDetta är Hogias identifiering av HMS-installationen (samma information finns även under menyvalet Hjälp - Licens och support).

Inställningar

Skicka felrapporter till HogiaÄr denna ruta förbockad kontrollerar HMS meddelandetjänst status på driften av HMS och skickar en rap-port till Hogia med jämna tidsintervall (ofta varannan timma). Rapporten kan innehålla information om konfigureringen i HMS (parter, inställningar m m), systeminformation för felsökning (operativsystem, språk osv) och lista på felaktiga meddelanden. Informationen skickas i komprimerad och krypterad form över internet till URL:en som står angiven under Kunduppgifter. Informationen är endast tillgänglig för sup-portpersonalen på Hogia och används enbart för felsökning och för att kunna uppmärksamma dig som kund då fel uppstår. Ingen information om dig som kund sprids utanför Hogia.

Rapportera meddelanden med XML-felOm denna ruta är förbockad rapporteras även meddelanden som har kunnat skickas mellan två parter utan problem, men där meddelandetexten innehåller ett <Error>-element. I vissa fall kanske felet är förvän-tat (t ex om meddelandet är ett svar på ett annat meddelande). I sådana fall ska den avsändande parten markera detta i meddelandet så att dessa meddelanden inte rapporteras in som felaktiga till Hogia.

Bifoga meddelandetext vid felrapporterOm denna ruta är förbockad bifogas felaktiga meddelanden och deras meddelandetexter till felrapporten. Detta är en stor fördel då Hogia löser integrationsproblem mellan olika produkter som inte direkt beror på rena kommunikationsproblem, utan t ex affärslogik. Om rutan inte är förbockad bifogas bara en lista på felaktiga meddelanden utan att själva meddelandetexten ingår.

HMS - Arkiv 45

Skicka felrapport omgående vid felOm denna ruta är förbockad kommer felrapporter skickas till övervakningstjänsten så fort ett fel uppstår i stället för som normalt varannan timme. För att inte övervakningstjänsten ska bli överbelastad kommer dock meddelanden maximalt att skickas var 15:e minut vid återkommande fel.

Meddelande till supportpersonalDå ni gör planerade förändringar eller tester är vi tacksamma om ni skriver en notis om detta för att inte Hogias supportpersonal ska behöva kontakta er eller påbörja felsökning i onödan.

Skicka även felrapport till e-postadressenHär kan du fylla i mailadress till en administratör eller en partner. Denna får då mail vid problem, t ex då licensen håller på att gå ut. Mailet skickas en gång om dagen med start ca en vecka innan licensen går ut.

Under samma tidsperiod försöker HMS-tjänsten dessutom automatiskt hämta en uppdaterad licensnyckel via Cricket två gånger per dygn. När betalning för en ny serviceabonnemangsperiod inkommit och regist-rerats av Hogia hämtas nyckeln.

Rapporter

Ignorera fel äldre änDetta datum sätts av Hogias supportpersonal (som svar på en rapport till övervakningstjänsten).

Visa senaste fel/felrapportTryck på knappen för att visa senaste felrapport som skickats till Hogia eller fel som uppstod då senaste rapport (OK-rapport eller felrapport) skulle skickas.

46 HMS - Arkiv

MinnesutnyttjandeUnder denna flik kan du göra inställningar för hur databasens minne ska utnyttjas.

MeddelandenAnge hur många megabyte (Mb) som skickade+felaktiga meddelanden får ta upp innan städning görs. Meddelanden som har status mottagna eller lästa raderas aldrig från databasen. Städningen görs i följande ordning:

1. Meddelandetexten och bilagorna från gamla levererade meddelanden och gamla meddelanden med läs- eller leveransfel tas bort från Hogia Messenger Service databas. Övrig information sparas.

2. Meddelanden vars meddelandetext och bilagor raderats tas nu bort fullständigt ur Hogia Messenger Service databas.

Meddelanden som bara har tagits emot eller blivit lästa raderas aldrig från databasen innan de blivit leve-rerade eller har fått status läs- eller leveransfel.

HMS - Arkiv 47

Sändningsförsök

Under denna flik kan inställningar för hur många sändningsförsök som ska göras för varje meddelande. Ett nytt sändningsförsök görs då det inte går att upprätta kommunikation med den mottagande parten eller denna returnerar ett felaktigt meddelande. Observera att om den mottagande parten returnerar ett kor-rekt meddelande innehållande ett felmeddelande som svar betraktas det som ett lyckat sändningsförsök.

Här kan också tiden (exponentiellt tilltagande mellan varje sändningsförsök) ställas in.

Kommunikation

Använd proxyserver... Beroende på hur nätverket är konfi-gurerat behöver FTP- och webservice-anrop från HMS i vissa fall gå via proxyserver. I andra fall fungerar inte denna kommunikation via proxyser-vern.

�Ändra bara denna inställning då anrop via webservice eller FTP miss-lyckas.

Skydd mot oändliga looparHär kan du göra inställning för hur många meddelanden som får skickas i samma "tråd".

När detta antal uppnåtts stoppas tra-fiken. Detta är till för att förhindra att t ex två parter fastnar i en oändlig loop och skickar ett fel fram och till-baka mellan sig.

48 HMS - Arkiv

GränssnittUnder denna flik kan inställningar för hur ofta gränssnittet ska uppdateras göras.

FelsökningUnder denna flik kan inställningar för felsökning göras.

Under denna flik kan inställningar för felsökning göras. Administrationsverktyget och meddelandetjänsten kan logga detaljerad teknisk driftsinformation genom att du bockar för i rutan Logga till filerna…

Loggfilernas storlek kan begränsas till storlek och innehåll. För att begränsa loggfilernas storlek, bocka för rutan Begränsa loggfilernas storlek och välj önskad maxstorlek i Mb.

HMS - Arkiv 49

Det går även att låta HMS skriva ner enbart loggposter som matchar ett definierat uttryck eller låta logg-ningen börja när match av ett specifik uttryck sker. Matchningar av loggposter sker med hjälp av reguljära uttryck, för mera information se http://www.regular-expressions.info.

För att loggningen till meddelandetjänsten ska slå igenom måste denna startas och stoppas igen (t ex genom att trycka på knappen för att starta/stoppa meddelandetjänsten under fliken Översikt längst ner i HMS-fönstret).

Tryck på knappen Visa... för att visa de loggposter som hittills skapats.

� Observera att loggfilerna växer MYCKET snabbt eftersom mycket detaljerad teknisk information loggas.

Genom att ta bort bocken, trycka OK och starta om meddelandetjänsten stoppas loggningen.

Samma loggningsinformation kan också fångas upp genom att använda verktyget Debugview som är till-gängligt gratis från http://www.microsoft.com/technet/sysinternals.

Web Service

Max storlek på meddelandenHär anges den största tillåtna storleken på inkommande webservice-anrop i kilobyte, standarinställning är 4092 kb.

50 HMS - Arkiv

Backup/Återställ databas

Skapa backup

• Ange sökväg till den fil som ska skapas.

• Klicka på knappen Starta backup. Om filen redan finns kommer den att skrivas över.

Återställ backup

• Ange sökväg till den fil som innehåller backupen.

• Tryck på knappen Återställ backup. För att und-vika att detta görs av misstag måste den som är HMS-administratör logga in innan en återställning av backup kan göras. Observera att alla ändringar (inställningar för samtliga parter, meddelanden som tagits emot, lästs, skickats osv) från det tillfälle då backupen togs kommer att försvinna!.

HMS - Redigera 51

Redigera

Ta bort part

Den part som är markerad i listan över parter kommer att tas bort.

Konverteringsmoduler

Listan visar de konverteringsmoduler som har importerats i HMS mellan olika meddelandeformat. För att lägga till eller uppdatera en konverteringsmodul klickar du på Lägg till och söker dig fram till den ZIP-fil som innehåller filer för konvertering (tillhandahålls av Hogia eller programvaruleverantören).

KommunikationsmodulerDialogrutan visar en lista över de kommunikationsmoduler som har importerats i HMS. Med hjälp av kom-munikationsmoduler kan HMS kommunikationsfunktionalitet byggas ut. För att lägga till eller uppdatera en kommunikationsmodul klickar du på Lägg till och bläddrar dig fram till den zip-fil som innehåller filer för kommunikation (tillhandahålls av Hogia eller programvaruleverantör).

52 HMS - Redigera

Hjälp

Innehåll och indexGenom att välja detta menyval eller genom att trycka på F1 kommer du till hjälpfilen.

Bruksanvisning PDFMenyalternativet öppnar den handbok i PDF-format som medföljer programmet.

Licens och support

Här visas information om den aktuella licensen och hur länge den är giltig. Observera att om giltighetsti-den passeras utan att avtalet förlängs kommer HMS meddelandetjänst att stoppa.

Support-informationen visar var du vänder dig för att förlänga avtalet, ställa frågor, önska eller kanske klaga på produkten.

Knappen Registrera utvecklarlicens... används enbart för de programutvecklare som vill kunna skapa nya typer av kopplingar.

Tryck på knappen Förnya licens... för att mata in eller hämta en uppdaterad HMS-licens. Har du av något annat skäl problem med den befintliga licenshanteringen kan du också trycka på knappen för att Förnya licens....

HMS - Redigera 53

Om Hogia Messenger Service…Här visas sammanfattande information om installationen och dina kunduppgifter.

54 HMS - Redigera

Aadressering......................................... 7anropsintervall ................................. 26arkiv .................................................43asynkron ............................................8avancerat .........................................33avsändare ...........................................8

Bbackup

skapa ........................................50återställ .....................................50

begäran .............................................7

Ddistributionslista ...........................7, 30driftslogg .........................................42

Ffelsökning ........................................48fil .....................................................21filkodning .........................................28filnamnsfilter ....................................26filtrering av meddelanden ................38förmedling .........................................7FTP ...................................................21

Ggränssnitt .........................................48

Hhuvudfunktioner ................................5

Iikoner ...............................................14inställningar .....................................44

Kkommunikationsmetod ......................8kommunikationssätt

från parten ................................23Web Service ..............................22

konverteringsmodul .....................8, 51kuvert ................................................8

Lläs-/leveransfel .................................42

Mmeddelanden....................................37

filtrering.................................... 38in ..............................................41nytt ...........................................43ut ..............................................41visning ......................................40

meddelandeformat ......................8, 28meddelandetjänst ............................34minnesutnyttjande ...........................46mottagare ..........................................8MSMQ .............................................22MSMQ-inställningar .........................27

Oordlista ...............................................8

Ppart ................................................7, 8

egenskaper ...............................19kommunikationssätt ..................19ny .............................................16ta bort ......................................51övrig .........................................18

parttyp ...............................................8prioritet ............................................37

Sspara ................................................ 43status ...............................................37subpart ..........................................7, 8synkron ..............................................8synkronisering ..................................31sändningsförsök ...............................47

Uuppdatera meddelandelista ..............38uppdatera statusinformation ............34

Vverktygsfält....................................... 14

Öoöversikt ..................................5, 9, 34övervakningstjänst...................... 34, 44

HMS - Hogiahmsdownload.hogia.se/files/HMS/2012.2/HMS2011.pdf · HMS övertar nu ansvaret för att...

Documents

Transcript of HMS - Hogiahmsdownload.hogia.se/files/HMS/2012.2/HMS2011.pdf · HMS övertar nu ansvaret för att...