Egna loaders

1. Öppna Loaders-registret och välj Funktioner / Nytt registerkort.
2. Ge ett beskrivande namn i fältet Namn, t.ex. "Kursuppgifter i studiehandboken" eller "FPA:s byråer".
3. Fyll i registret där loadern används i fältet Databas. Fältet kan också lämnas tomt och då kan loadern användas i alla register. Databasernas namn och deras korrekta skrivsätt finns här.
4. I pekfältet Filtyp väljer du om överföringen är Standardiserad, Åtskild med skiljetecken (CSV), en REST/JSON-dataöverföring eller XML-dataöverföring.
5. Du kan kontrollera Teckenraden genom att titta på filen i en texteditor. Om de skandinaviska tecknen är korrekta, är teckenraden Ansi. Om de däremot skrivs ut som svarta lodräta streck, rör det sig om en MS-DOS-teckenrad. Oftast är Ansi det rätta alternativet.
6. I fältet Skiljetecken anges det tecken som skiljer åt uppgifterna för samma studerande/kurs/lärare osv. Oftast används kommatecken eller semikolon som skiljetecken. Om du gör en standardiserad, REST/JSON- eller XML-dataöverföring ska fältet lämnas tomt.
7. I rutan Definition skriver du in loaderns egentliga beskrivning/definition.

Standardiserad dataöverföring

• raderna har löpande numrering i vänsterkanten
• kommatecken, (används alltid i loaders oberoende av vilket som är filens skiljetecken)
• fältets namn inom citationstecken.

Exempel:

Primus läser tecknen 1-30 från början av filens första rad och skriver in teckenraden i fältet Efternamn. Sedan läser programmet tecknen 31-60 och skriver teckenraden i fältet Förnamn o.s.v.

Dataöverföring som åtskiljs med skiljetecken

• numret av kolumnen i överföringsfilen i vänster kant
• kommatecken (i loadern finns alltid kommatecken oberoende av filens skiljetecken)
• fältets namn inom citattecken.

Exempel:

Primus läser filens första rad fram till skiljetecknet och skriver in den lästa teckenraden i fältet Efternamn. Sedan fortsätter programmet att läsa fram till följande skiljetecken och skriver in följande teckenrad i fältet Förnamn, osv.

REST/JSON-dataöverföring

• data
• kommatecken (loadern innehåller alltid ett kommatecken oberoende av vilket skiljetecken som används i filen)
• fältets namn inom citationstecken.

Obs! Den första raden kan innehålla en ROW-definition som anger vilken dataposts uppgifter som ska läsas. Om ingen ROW-definition anges, läser programmet in alla uppgifter.

Exempeldefinition:

Med denna definition läser Primus in uppgifterna från filens Organisationer-datapost i fälten försedda med citationstecken.

XML-dataöverföring

• data
• kommatecken (loadern innehåller alltid ett kommatecken oberoende av vilket skiljetecken som används i filen)
• fältets namn inom citationstecken.

OBS! Den första raden kan innehålla en ROW-definition som anger vilken dataposts uppgifter som ska läsas. Om ingen ROW-definition anges, läser programmet in alla uppgifter.

Exempeldefinition:

Med denna definition läser Primus in uppgifterna i Sökande-dataposten i fälten försedda med citationstecken.

MERGEDATA

JSON-data i listformat kan ha en rad med definitionen MERGEDATA, som definierar att all data i listan sparas i ett fält i Primus separerade med radbyten.

Exempeldefinition:

Med denna definition sparar Primus alla värden för alla tillaggsuppgift-poster i listan tillaggsuppgifter i memofältet Tilläggsuppgifter separerade med radbyten. Utan denna definition skulle endast det senaste värdet för tillaggsuppgift-posten i tillaggsuppgifter-listan sparas i fältet Tilläggsuppgifter.

Med hjälp av en loader kan du också förena två olika uppgifter från källfilen i ett och samma Primusfält. Om till exempel postnummer och postanstalt är åtskilda i filen, kan dessa uppgifter förenas i Primus under "Postadress".

I dataöverföringen Åtskild med skiljetecken används ett plustecken för att förena fälten. Loaderns definition är då:

I en Standardiserad dataöverföring förenas fälten då det antal tecken som reserverats för dem förenas: 1-30 och 31-60 förenas till 1-60. Därefter kommer kommatecken och fältets namn. I slutet av raden skriver man in DELSPC, som raderar de onödiga mellanslag som finns mellan kolumnerna. Loaderns definition är då:

I REST/JSON- samt XML-dataöverföringar används ett plustecken för att förena olika fält. Loaderns definition är då: