Uppdaterad: 19.11.2020
I Studieinfo är det nu möjligt att överföra sökandena till Primus via gränssnittet JSON. För tillfället är det också möjligt att använda de tidigare överföringssätten för registren Sökande och Studerande, men i framtiden kommer de att tas bort, och de kommer inte heller längre att underhållas från och med juni 2016. Med de gamla överföringssätten går det t.ex. inte att importera information om vårdnadshavaren till Primus. JSON-överföringen kräver förberedelser i Loaders-registret för att informationen ska kunna hämtas till Primus.
Loaderit-rekisterin kentät
Ta fram och fyll i följande fält i Loaders-registret:
| Fält i Primus Beskrivning | Fält i Primus Beskrivning |
|---|---|
| Namn | Ett beskrivande namn. |
| Databas | Den Primus-databas dit informationen från gränssnittet ska hämtas. Om informationen importeras till Sökande-registret, är det sökande-databasen som ska användas. Om importen sker till Studeranderegistret ska databasen vara opphenk. |
| Filtyp | "REST/JSON" som filtyp när du överför infon från JSON-gränssnittet. |
| Definition | Loaderns inställning för uppgifterna, och till vilka fält infon ska överföras i respektive register. Ställ in uppgifterna på följande sätt: ange som första del den info som ska importeras till Primus. Skriv efter denna del det Primus-fält dit informationen ska överföras i den mottagande databasen. Separera uppgiften och fältet med ett kommatecken och lägg citattecken runt Primus-fältnamnet. Om det är sökandens personbeteckning som ska importeras från gränsnittet, skriv då: personbeteckning,”Personbeteckning”. |
| Servicens adress | Den URL-adress från vilken informationen hämtas till Primus. |
| InloggningsURL | Den URL-adress till vilken Primus loggar in för att hämta information från gränssnittet efter att ha fått en ticket från ticketsystemet. |
| Ticketsystemets URL | Den URL-adress som Primus kontaktar för att få en ticket för att hämta informationen. |
| GET/POST | Ett valfält där du ska välja "GET" när du importerar info till Primus. |
| REST användarnamn | Högskolespecifikt användarnamn för inloggning i Studieinfo-systemet. |
| REST lösenord | Det lösenord som är kopplat till REST användarnamnet. |
| REST parametrar | De parametrar som används för att begränsa den data man hämtat från gränssnittet. I loadern ska finnas åtminstone parametrarna "sökning" och "organisation". Du kan även använda ansökningsobjektskoden om du vill importera sökandena för en viss utbildning till Primus, men det är ingen obligatorisk uppgift. Om du anger en färdig ansökningsobjektskod för loadern måste du komma ihåg att byta den varje gång du vill hämta sökandena för ett annat ansökningsobjekt till Primus. Alternativt kan du göra färdiga loaders för respektive ansökningsobjekt. Dessutom ska parametrarna vara "sökvillkor" och "typ". |
| REST parametrarnas standardvärden | Standardvärdena för parametrarna "ansökning", "organisation" och "ansökningsobjektskod". Dessa standardvärden borde finnas t.ex. i Administratörens arbetsbord i Studieinfo. Parametrarnas värden är specifika för varje läroanstalt. Standardvärdet för sökvillkoret i loader-filerna är "Alla" (Kaikki), men du kan också använda följande sökrutiner för att avgränsa vilka studerande du vill flytta: "Antagna" (Hyvaksytyt), "Tagit emot" (Vastaanottaneet) eller "Ej antagna" (Hylatyt). Om du till Primus vill importera t.ex. enbart de studerande som mottagit studieplatsen, kan du göra detta genom att anända värdet "Tagit emot". Standardvärdet för typen är "Json". |
Nere i denna anvisning finns två exempelloaders som läroanstalten kan ladda ner och spara i Primusregistret Loaders via Dataöverföring till Primus (välj Överföring från annan Primus som typ och hämta informationen som ny). För att detta ska fungera i Loaders-registret måste de ovan nämnda fälten vara framme.
Filen "Överföring från Studieinfo (JSON-gränssnittet)" är avsedd för direkt JSON-gränssnittsöverföring till Sökanderegistret, medan "Överföring från Studieinfo (JSON-gränssnittet)_studerande" ska användas för Studeranderegistret. OBS! Byt ut användarnamnet och lösenordet som finns i loadern, och ange standardvärden för parametrarna så att de motsvarar läroanstaltens ansökningsobjekt. Om du inte vill spara inloggningsuppgifterna för Studieinfo direkt i loadern, kan du också fylla i dem först när du gör dataöverföringen. Lämna då fälten för användarnamnet och lösenordet tomma.
Närliggande teman
