Copyright

Copyright © 2022-2025 Biometria ekonomisk förening, which is “Copyright Owner” below.

All rights reserved by the Copyright Owner under the laws of the United States, Sweden, the European Economic Community, and all states, domestic and foreign.This document may be downloaded and copied provided that all copies retain and display the copyright and any other proprietary notices contained in this document.

This document may not be sold, modified, edited, or taken out of context such that it creates a false or misleading statement or impression as to the purpose or use of the specification.

In no event shall Presenters be liable to user (or other person) for direct, indirect, special or consequential damages arising from or related to any use of this document, including, without limitation, lost profits, business interruption, loss of programs, or other data on your information handling system even if Presenters are expressly advised of the possibility of such damages.

Översikt

Detta Use case beskriver hur Biometrias system VIOL 3 erbjuder gränssnitt för utskick av vissa typer av befintliga data till externa parter, till exempel utskick av viss uppsättning av lagrade masterdata. Syftet med detta gränssnitt är ge kunder möjligheten att utanför affärstransaktioner kunna begära att få viss typ av befintliga data utskickade från VIOL 3 systemet.

Situationer när kund kan ha behov av detta är till exempel:

• Efter en återhämtning av inträffad systemkrasch hos kund finns behovet av att synkronisera och uppdatera eventuellt förändrade tillstånd/data med det som finns tillgängligt i VIOL 3 systemet vid den tidpunkten.
• Ett ”tomt” nystartat IT-system där kunden inte har Integrationskontrakt med Biometria sedan tidigare.
• Om en kund med Integrationskontrakt sedan tidigare byter ut sitt IT-system.

Den tillgängliga systeminformationen som extraheras ur Biometrias system förmedlas med samma typ av dokument och meddelanden som används i affärstransaktioner. Dessa dokument och meddelanden följer standarder som papiNet®, StanForD eller andra standarder och format.

Skillnaden är i detta Use case att dessa dokument och meddelanden som bär extraherad information skickas till andra transportdestinationer än de transportdestinationer affärstransaktioner använder. Format på dokument/meddelande ska följa det som används i de respektive Integrationsfunktioner som används för affärstransaktioner där dokument/meddelande ingår.

Om det finns kvittens specificerad i Integrationsfunktionen där dokumentet/meddelandet ingår, kvitteras varje utskickat dokument/meddelande av External system administrator. Samma typ av kvittens används som finns definierad i integrationsfunktionen där dokumentet/meddelandet ingår.

Läsanvisning

Denna beskrivning läses med fördel tillsammans med Process and Transaction overview (PTO) med dokumentet SDC Use Case Q – Provisioning of data to administrators of external business systems, härefter refererat som PTO SDC Use Case Q i det här dokumentet.

Begrepp

Då det står dokument eller meddelande i det här dokumentet kan dessa vara av olika format vilka förmedlas mellan Biometria och kund. De format som används vid ett givet tillfälle finns angivet i den version av VIOL 3 systemutgåvan som används i exekveringsmiljön och de Integrationsfunktioner som den stödjer. Format på dokument och meddelande som skickas ut ska baseras på de integrationsfunktioner där de används för affärstransaktioner.

Roller

Tabell 1 visar de roller som kan användas för involverade aktörer (parter) i detta use case. Med papiNet-roll avses den PartyType i papiNet som motsvarar en Biometria verksamhetsroll.

Tabell 1

Biometria agerar i rollen Tjänsteleverantör (ServiceProvider) och realiserar sina tjänster i systemet VIOL 3.

External system administrator representerar den av kund utsedde part som Biometria interagerar med.

En förutsättning för att External system administrator ska kunna beställa utskick är att kunden som den representerar är en registrerad aktör hos Biometria samt har avtalat om ’Utskick’ i sitt Integrationskontrakt med Biometria.

Transaktioner och kvittenser

Samarbete mellan processer sker i form av transaktioner för att uppnå en kontrollerad överlämning av ansvar vid övergång mellan olika processer.

Format på dokument/meddelande ska följa det som används i de respektive Integrationsfunktioner som används för affärstransaktioner där dokument/meddelande ingår.

Om det finns kvittens specificerad i Integrationsfunktionen där dokumentet/meddelandet ingår, kvitteras varje utskickat dokument/meddelande av External system administrator. Samma typ av kvittens används som finns definierad i integrationsfunktionen där dokumentet/meddelandet ingår.

Beskrivning av processer och deras samverkan via transaktioner

För varje diagrambild i PTO SDC Use Case Q finns här ett motsvarande kapitel som textuellt förtydligar bilden samt refererar till den/de integrationsfunktion(er) som där kan medverka.

Beställning

Integrationssekvensen visas i dokumentet PTO SDC Use Case Q i diagrambilden med underrubriken Extract of Biometria business system data.

External system administrator initierar sekvensen i processen Initiate order for extract of business system data och kontaktar Biometria för beställning av utskick. Kontakten kan till exempel ske via e-post, telefon till kundsupport eller via särskilt framtagen Biometria-klient om sådan finns.

Därefter verifierar Biometria i processen ”Verify request” att beställningen innehållsmässigt är korrekt och bekräftar detta genom att meddela External system administrator huruvida beställningen kan utföras eller ej. Om beställningen kan utföras utfärdar Biometria en unik referens till beställningen som inkluderas i bekräftelsen.

Denna referens används senare för att hantera och hålla samman det beställda utskicket mellan Biometria och External system administrator. OBS! Notera att en beställning kan resultera i att ett flertal dokument/meddelanden skickas ut från Biometria, till exempel ett dokument för varje registrerad aktör eller plats.

Transaktionerna mellan processerna Initiate order for extract of business system data till Follow-up of extract activities stöds av integrationsfunktionen Begärt utskick av befintliga data UT (se vidare kapitel: Integrationsfunktioner).

Beställning av utskick masterdata

Masterdata är en typ av information som är oberoende av typ av affär och som används i en affärstransaktion, men som inte ändrar värde under själva affärstransaktionen. De alternativ som är valbara (individuellt eller fler) vid beställning är Aktör, Plats & Sortimentstruktur.

Det finns inte några särskilda urvalskriterier, utan det är endast möjligt att beställa hela beståndet per integrationsfunktion, till exempel att alla platser skickas ut vid beställning.

Utskick

Efter att en beställning är registrerad, skapar och paketerar Biometria i processen Extract business system data de dokument/meddelande som finns definierade i beställningen.

Därefter utförs utskicket i processen Issue extract of business system data enligt avtalade slutpunkter (transportdestinationer) i Integrationskontraktet. Ett utskickat meddelande/dokument överförs i transportmeddelanden till transportdestinationen och kommer slutligen att terminera i det mottagande systemets transportlager. Med terminera avses att meddelandet/dokumentet blir tillgängligt för det mottagande systemet. Notera att transportdestinationer som används för utskick är helt skilda från de transportdestinationer som används för affärstransaktionerna.

De transportmeddelanden som överför de utskickade dokumenten/meddelanden förmedlar den unika referensen i form av en egenskap på själva transportmeddelandet, till exempel i en header. Detta för att skilja överföring mellan olika beställningar.

External system administrator mottager dokument/meddelanden i processen Update system with received business data. Om kvittens ingår för dokument/meddelade, förmedlas den unika referensen till beställningen i transportmeddelandet som bär kvittensen till Biometria. Detta för att Biometria ska kunna relatera kvittensen till det tidigare utskickade dokumentet/meddelandet.

Därefter behandlar External system administrator själv innehållet i dokumentet/meddelandet enligt den aktivitet som den ämnar utföra.

Utskick av masterdata

Utskick sker med ett individuellt dokument per aktör/ plats eller sortimentstruktur tillgänglig i VIOL 3 systemet vid tillfället. Varje av Biometria utskickat masterdata- dokument kvitteras av External system administrator.

Uppföljning av beställning

Uppföljning av en beställning utförs av Biometria i processen Follow-up of extract activities och av External system administrator i processen Update order status. I dessa processer övervakas att utskickade dokument/meddelande mottages och kvitteras på ett korrekt sätt när utskick hanteras av respektive system. Beställning anses som avslutad när Biometria har mottagit kvittens för varje utskickat dokument/meddelande eller att External system administrator har meddelat Biometria om utskickade dokument/meddelande är mottagna eller ej i dennes system. Oavsett om beställningen kunnat genomföras eller ej, avslutar Biometria beställningen och resultatet (positivt eller negativt) förmedlas till External system administrator.

Integrationsfunktioner

I detta kapitel summeras och listas den integrationsfunktion som används i detta use case. Användning av denna finns omnämnd i föregående kapitel Beskrivning av processer och deras samverkan via transaktioner.

Mer detaljerad beskrivningar av denna integrationsfunktion finns i respektive integrationsfunktions specifikationer.

Use case integrationsfunktion;

• Begärt utskick av befintliga data UT.