Autorisatie Import

Korte omschrijving

Met autorisaties kan zeer gedetailleerd worden bepaald welke artikelen klanten mogen zien in de shop. Dit gebeurt met behulp van autorisatieprofielen. Zowel klanten als artikelen worden gekoppeld aan één of meer van dergelijke profielen. Een klant ziet vervolgens uitsluitend de artikelen die zijn gekoppeld aan minstens één van de profielen waar die klant zelf ook is gekoppeld.

Wanneer autorisatie wordt geactiveerd kan er een keuze worden gemaakt tussen Basic Authorization (waarbij uitsluitend standaard systeem autorisatieprofielen worden gebruikt) en Advanced Authorization (waarin ook custom profielen kunnen worden gedefinieerd).

Het systeemprofiel met profielcode PUB is gereserveerd voor het Publieke autorisatieprofiel. Dit profiel is altijd aanwezig. Wanneer Basic Authorization actief is krijgt een niet-ingelogde gebruiker automatisch dit profiel.

Het systeemprofiel met profielcode DEB is gereserveerd voor het Debiteuren autorisatieprofiel. Wanneer Basic Authorization actief is en dit profiel is geactiveerd, krijgt een ingelogde gebruiker waaraan geen custom autorisatieprofiel is toegekend, automatisch dit profiel.

Als er gebruik wordt gemaakt van Advanced Authorization kunnen ook eigen autorisatieprofielen worden gedefinieerd. Hiermee kan worden bereikt dat verschillende groepen van ingelogde gebruikers, of zelfs individuele gebruikers, verschillende assortimenten zien.

Wanneer gebruik wordt gemaakt van Advanced Authorization moet in de klantenimport worden meegegeven aan welke autorisatieprofielen een klant is gekoppeld. Bij Basic Authorization wordt gebruik gemaakt van systeemprofielen en is dat niet nodig. In beide gevallen is het uiteraard wel noodzakelijk om met een autorisatie-import artikelen te koppelen aan autorisatieprofielen.

Als gebruik wordt gemaakt van eigen autorisatieprofielen komen deze in de plaats van de DEB en PUB systeemprofielen. Wanneer het is gewenst dat gebruikers met een eigen autorisatie-profiel ook alle artikelen zien die een niet-ingelogde gebruiker kan zien, dient het PUB profiel expliciet aan de gebruiker te worden gekoppeld.

Autorisaties worden als volgt afgehandeld in de shop:

• Een niet ingelogde gebruiker krijgt het systeemprofiel PUB

• Een ingelogde gebruiker krijgt de autorisatieprofielen die zijn gedefinieerd bij de User, of indien die er niet zijn van de Customer waartoe de User behoort

• Een ingelogde gebruiker waarvoor geen profiel is gedefinieerd krijgt het systeemprofiel DEB indien dat actief is, en anders het systeemprofiel PUB.

Onderdeel van de definitie van een autorisatieprofiel is de AccessMode. Deze laatste definieert of de in het autorisatie bestand aangeleverde artikelen default tot dit profiel behoren of niet. De Accessmode heeft twee mogelijke waardes: Allow en Deny. Accessmode Allow wordt incidenteel gebruikt voor zeer specifieke doelstellingen. Voor standaard situaties dient uitsluitend de Accessmode Deny te worden gebruikt.

Binnen een autorisatieprofiel met Accessmode Deny wordt bereikt dat artikelen niet zichtbaar zijn, totdat bij een artikel expliciet wordt aangegeven dat het artikel wél zichtbaar moet zijn voor een profiel. Door in de Allow node binnen de Authorization node van een artikel autorisatieprofielcodes op te nemen, wordt het artikel zichtbaar voor alle gebruikers waaraan die autorisatieprofielen zijn gekoppeld.

Het importbestand bevat een lijst van autorisatieprofielen, en vervolgens bij elk artikel een opsomming van de autorisatieprofielen die het artikel mogen zien.

Aanleverwijze

Update Frequentie: Batch minimaal 1x per dag Incrementeel of complete set: Incrementeel Bestandtype: Zipped XML

Bestandsbenaming: [SHOPNAME]_Authorizations_[INDEXNUMBER].xml Transport: over FTPS, FTPS Vendisto server wordt gehost door INTEGRACE, bestand wordt door ERP partij neergezet op FTPS server.

Location within FTP root: \Vendisto\Integration\

Structuur XML

<?xml version="1.0" encoding="utf-8"?>
<Import>
    <ImportSettings>
        <Importer>Authorizations</Importer>
        <Version>1.0</Version>
    </ImportSettings>
    <AuthorizationProfiles>
        <AuthorizationProfile>
            <Name> </Name>
            <Code> </Code>
            <DefaultAccess> </DefaultAccess>
        </AuthorizationProfile>
    </AuthorizationProfiles>
    <Articles>
        <Article>
            <Number></Number>
            <Authorizations>
                <Allow>
                    <Profile></Profile>
                    <Profile></Profile>
                </Allow>
                <Deny>
                    <Profile></Profile>
                </Deny>
            </Authorizations>
        </Article>
    </Articles>
</Import>

Velden XML

Import element:

Name	Description	Type	Required/Optional
ImportSettings	Container element for importsettings	Element	Optional
AuthorizationProfiles	Container element for AuthorizationProfile data	Element	Required
Articles	Container element for Article data	Element	Required

ImportSettings element:

Name	Description	Type	Required/Optional
Importer	Name of the importer. Should be Authorization.	Text, default Authorization	Optional
Version	Version of the import xml. To be used for backward compatibility issues.	Text, default 1.0	Optional

AuthorizationProfile element:

Name	Description	Type	Required/Optional
Name	Descriptive name of the authorization profile	Text	Required
Code	Code of the authorization profile	Char[3]	Required
DefaultAccess	Default behavior of authorization profile	AccessMode	Required

Article element:

Name	Description	Type	Required/Optional
Number	Article number	Text	Required
Authorizations	Container element	Element	Optional

Authorizations element:

Name	Description	Type	Required/Optional
Allow	Container for list of allowed profiles	Element	Optional
Deny	Container for list of denied profiles	Element	Optional

Allow element:

Name	Description	Type	Required/Optional
Profile	Profile code	Text	Optional

Deny element:

Name	Description	Type	Required/Optional
Profile	Profile code	Text	Optional

Types:

Type	Values
AccessMode	Allow, D