För att integrera med ett RCO passagesystem/kodlås behöver du installera ett BokaMera script på din server där du har din RCO programvara.
Scriptet kommer lägga till en schedule task som hämtar ner koderna till låset per automatik.
Systemkrav
1. .NET Framework 4.6.1 eller nyare version.
Finns att ladda ner här: https://dotnet.microsoft.com/download/dotnet-framework
2. Administrativa rättigheter för att köra Kommandotolken
Andra krav
1. Licens för att kunna använda RCO. Du lägger till licensen här (Api licens)
https://admin.bokamera.se/#/extra-licenses
2. API nyckel från BokaMera som du får genom att skicka ett mejl till support@bokamera.se med följande uppgifter;
Föreningens eller företagets namn som är registrerat hos BokaMera
Kontaktperson med Namn, mobilnummer och e-post
3. Inställning för automatisk pinkodsgenerering måste vara påslaget i admin.
Gå till Inställningar ->Bokningsinställningar (https://admin.bokamera.se/admin/#/booking-settings)
Klicka på fliken Kundbokning
Slå på Skapa en pinkod automatiskt på kunder och klicka sedan Spara.
OBS! RCO:s programvara R-Card M5 stödjer inte specialtecken som apostrofer. Detta gör att bokningar blockeras. Exempelvis; André får vara inskriven i BokaMera som Andre eftersom det kommer uppstå problem när RCO ska ta emot bokningarna. BokaMera stödjer apostrofer, men inte RCO.
4. Ett ytterligare steg är att lägga in en så kallad Översättning så att en kod genereras vid bokning. När en kund registrerar sig för första gången så skapas en unik pinkod på kunden. Denna kod blir densamma för varje bokning som görs. Koden kan ändras inne på Kunder - Kundregister- Åtkomstnycklar. Gå till Bokningar -> Meddelandemallar -> välj bokningsbekräftelse och lägg till översättningen för pinkod. Översättningen heter {{booking.codelock.pin}}
5. Lägg in behörighetsgrupp inne på varje resurs via Mina resurser på respektive Resurs. Det namnet som sätts på resursen ska vara densamma som den behörighetsgrupp inne i RCO. Längre ner i manualen kommer den beskriva hur du lägger in behörighetsgrupp i R-Card M5.
6. När du är klar med följande uppgifter så börja med att ladda ner båda paketen med kommandot som finns på sidan.
https://bmstorageproduction.blob.core.windows.net/files/v1.1.4/Setup.msi
https://bmstorageproduction.blob.core.windows.net/files/v1.1.4/Readme.txt
7. Stäng nu ner Kommandotolken och starta om den med administrativa rättigheter.
OBS: du behöver starta om den för att den har lagt till vissa variablar i environments variables.
För att brandväggen inte ska vara stängd så behöver dess port peka utåt för att kunna ta emot bokningarna från BokaMera (porten som ska användas är 80). Servern där RCO är installerat behöver även ha åtkomst till internet för att det ska fungera.
__________________________________________________________________________________________________________
Kommandoprompten
1. Sök upp Kommandotolken/Commando Promten på din enhet och klicka på Kör som administratör.
2. Leta upp BMC mappen som sparats på din dator, vanligtvis hamnar denne under hårddisken (C:)
Program (x86) - BokaMera - BMC - kopiera länken
3. Skriv in cd + Klistra in länken i kommandotolken och tryck på Enter
(Tänk på att det måste vara mellanslag mellan cd och länken)
4. När Kommandotolken hittat filen gör du nästa steg;
Kör nu följande kommando nedan, där 00000000-0000-0000-0000-000000000014 ska ersättas med ditt företags-id som du får av supporten (support@bokamera.se), tryck sedan på Enter.
bmc integration setup -i rco -c 00000000-0000-0000-0000-000000000014
5. Nu ska du få upp där du ska fylla i Username. Fyll i ditt inloggningskonto (e-posten) som admininistratör för företaget. Tipset är att lägga upp en egen systemadministratör för RCO (https://apps.bokamera.se/admin/#/administrators) - tryck Enter.
6. Nästa steg är lösenordet för användaren. Detta sparas på säkert ställe i registret, tryck Enter.
7. Fyll i API nyckeln du fått från BokaMeras support (support@bokamera.se)
8. API Endpoint ska du fylla i. Om du vill använda standardvärdet som står inom parentesen så tryck endast på Enter.
https://api.bokamera.se
9. Nu dyker TokenEndpoint upp, klicka på Enter.
10. Nu dyker TimeBefore upp. Fyll i antal minuter du vill koden ska gälla före bokad tid. Default är 10minuter. Detta kan vara bra om man vill tillåta att kunden kan öppna dörren x minuter innan bokningen gäller.
Om du vill använda standardvärdet som står inom parentesen så tryck endast på Enter.
11. Nu dyker TimeAfter upp. Fyll i antal minuter du vill att koden ska gälla efter bokad tid. Default är 10minuter. Detta kan vara bra om man vill tillåta att kunden kan öppna dörren x minuter efter bokningens sluttid.
Om du vill använda standardvärdet som står inom parentesen så tryck endast på Enter.
12. Ny dyker DaysToCollect upp. Fyll i antal dagar framåt som du vill hämta bokningarna. Eftersom bokningarna hämtas kontinuerligt är det ingen mening att hämta längre än 30 dagar.
Om du vill använda standardvärdet som står inom parentesen så tryck endast på Enter.
13. Nu kommer IntervalInMinutes upp. Fyll i antal minuter som du vill göra ett anrop för att hämta nya bokningar. OBS: Tänk på att där finns begränsningar för hur många gånger du kan hämta bokningar per timme så tipset är att låta den vara på default 5minuter eller längre.
Om du vill använda standardvärdet som står inom parentesen så tryck endast på Enter.
14. Nu kommer RcoGroup upp. Fyll i önskad behörighetsgrupp som du du vill använda dig av i RCO programvaran. Det är viktigt att du sedan lägger upp denna i RCO (kommer längre ner när vi konfigurerar RCO).
OBS: Notera att behörighetsgruppen skiljer på små och stora bokstäver så viktigt att du tänker på att du skriver exakt så som du önskar ha det i RCO.
Om du vill använda standardvärdet som står inom parentesen så tryck endast på Enter.
bokamera
15. Nu dyker RcoTimeCode upp. Fyll i parametrarna för hur du vill hantera dina koder. Detta är RCO specifika parametrar.
Om du vill använda standardvärdet som står inom parentesen så tryck endast på Enter.
120[G]kort
16. Nu dyker OutputFilename upp. Fyll i genvägen var du vill exportera filen på bokningar som hämtas. Du kommer senare peka ut denna genvägen från RCOs programvara.
Om du vill använda standardvärdet som står inom parentesen så tryck endast på Enter.
17. När guiden är klar så ska du få upp följande text:
Önskar du ändra någon parameter så kör om anropet igen i steg 1.
Den har nu skapat upp schedule tasks för hämtning av bokningar.
__________________________________________________________________________________________________________
Testköra hämtningen
För att testköra anropet så behöver du göra följande (Nästan detsamma steg som i startupen):
1. Sök upp Kommandotolken/Commando Promten på din enhet och klicka på Kör som administratör.
2. Leta upp BMC mappen som sparats på din dator, vanligtvis hamnar denne under hårddisken (C:)
Program (x86) - BokaMera - BMC - kopiera länken
3. Skriv in cd + Klistra in länken i kommandotolken och tryck på Enter
(Tänk på att det måste vara mellanslag mellan cd och länken)
4. När Kommandotolken hittat filen gör du nästa steg;
Kör nu följande kommando nedan, där 00000000-0000-0000-0000-000000000014 ska ersättas med ditt företagsid som du får av supporten (support@bokamera.se), tryck sedan på Enter.
bmc integration execute -i rco -c 00000000-0000-0000-0000-000000000014
Då kommer den hämta bokningarna och du bör få fram följande meddelande där den visar hur många bokningar som hämtats ner.
______________________________________________________________________________________________________
Konfigurera RCO programvaran
OBS! Tänk på att att nedanstående bilder från RCO:s R-Card M5 visar endast exempel. Inställningarna som görs i RCO:s programvara är något som vi inte ansvarar över. Inställningarna som görs där utförs av installatören och inte BokaMera. Vi hanterar endast synkningarna från BokaMera till RCO.
_________________________________________________________________________________________________________________
1. Vi måste öppna upp ini filen för att tillåta PINONLY (Endast pinkod).
Gå till mappen där programmet är installerat, oftast
C:\Program Files (x86)\RCO Security AB\R-CARD M5
Öppan filen RaSettings.ini
Ändra UsePinOnly till 1 och spara ändringarna.
UsePinOnly=1
2. Öppna upp R-CARD M5 Arbetsstation programvaran på servern
Logga in på servern.
Default operatörsnamn är
rcard
och standardlösenordet (om du ändrat detta så fyll i ditt eget)
1234
3. Gå till Inställningar -> Inställningar. Klicka på System -> Moduler och sedan fliken Tidbokning.
Bocka i Aktiva Tidbokning i systemet.
Fyll i sökvägen till bokningsfilen (den genvägen du satte när du konfigurerade i steg 16 när du satte upp bmc setupen.
4. Lägg till Ny behörighetsgrupp.
Fylla i Benämningen på gruppen som du skapade i steg 14, i vårt exempel bokamera
Klicka på Tidsschema-fliken och klicka Skapa alltid.
Klicka på Kortläsare/Områden och välj vilka kortläsare systemet ska ha behörighet. Man drar kortläsaren in i fältet till höger.
Spara!
Ställ även in så att du ej behöver pinkod om du använder RFID taggar. Det gör du under
Huvudmeny -> Funktioner.
Klicka på Dörr och kort för att expandera. Klicka på Enbart kort och lägg till din behörighetsgrupp där.
5. Öppna upp services och starta om servicen efter ändringarna ovan
Efter en minut nu bör du få in användarna med pinkoderna i systemet.
Nu är du redo för att få in bokningarna.
Inne på Kunder - Kundregister så har administratören möjlighet att lägga till och ändra pinkoder samt taggar för respektive kund. Det går att byta ut pinkod så att samma pinkod gäller för kunden när denne ska boka tid antingen en eller flera gånger. Detta görs via Åtkomstnycklar:
__________________________________________________________________________________________________________
Felsökning
Fel: Jag får inte in koder och det blinkar rött larm i RCO.
Nedan är exempel på hur felmeddelande uppstår.
Klicka på larmfönster knappen
Högerklicka på felet och välj Visa loggfil.
I loggfilen kan du se felet
Fel: Får du upp följande så har du inte kört med administrative rights.
Nedan är exempel på hur felmeddelande uppstår.
Fel: Får du upp följande har du inte startat om commando promten.
Nedan visar exempel hur felmeddelande uppstår.
Fel: Error exectuing command ExcecuteIntegrationCommand: Could not find a port of the path 'c:\rco\export\bokamera-rco.csv'
Detta tyder på att mappen inte finns skapad som du valde för export. Lägg till mappen.
Nedan är exempel på hur felmeddelande uppstår.