Mapinhoud uploaden in Three Shipsproducten Batchuploader 28-3-2011
Aan de gebruiker Wij stellen uw terugkoppeling zeer op prijs. Voor vragen en opmerkingen over Three Ships N@Tschool! en de documentatie kunt u terecht bij uw supportafdeling. Rotterdam, 28 maart 2011 Three Ships enterprises B.V. DISCLAIMER Three Ships enterprises werkt volgens vaste procedures om ervoor te zorgen dat de informatie in de documentatie correct en up-to-date is. Three Ships enterprises kan echter niet aansprakelijk worden gesteld voor mogelijke onvolkomenheden in dit document of voor ongewenste resultaten of schade die voortkomt uit het gebruik van de informatie die dit document biedt. Three Ships enterprises B.V., 2011 Niets uit deze uitgave mag worden verveelvoudigd en/of openbaar gemaakt door middel van druk, fotokopie, microfilm, of op enige andere wijze, zonder voorafgaande schriftelijke toestemming van Three Ships enterprises B.V. MapinhUploadInTS-prod doc2.0 ii
Inhoudsopgave Aan de gebruiker... ii Inhoudsopgave... iii Notatie... iv 1 Inleiding...5 2 Upload uitvoeren...6 3 Upload-instellingen bewaren...8 4 Algemene instellingen wijzigen (geavanceerd)...9 5 Batchuploader uitvoeren vanaf een commandline... 11 MapinhUploadInTS-prod doc2.0 iii
Notatie Dit document hanteert de volgende symbolen en tekstconventies: Verwijst naar een andere locatie in dit document waarin u gedetailleerde informatie kunt vinden over het onderwerp. Vestigt uw aandacht op een belangrijk gebruiksaspect of een andere bijzonderheid. Geeft een tip. Vetgedrukte tekst Vetgedrukte tekst met haken Tekst in Courier New Schuingedrukte tekst in Courier New Geeft vaste programmaonderdelen aan, zoals velden, tabbladen en menuopties. Bijvoorbeeld: Kies Automatic rename om het nieuwe bestand te uploaden met een andere naam. Duidt een reeks handelingen aan die u in het programma uitvoert. Bijvoorbeeld: Klik in Windows op Start > Run. Geeft variabelen aan, zoals bestandsnamen en URL s. Bijvoorbeeld: Geef bij Destination Site URL de URL op van de doelsite, bijvoorbeeld: http://threeships.natschool.com. Duidt de omschrijving van een waarde aan die vervangen moet worden door een instantie van de waarde. Bijvoorbeeld: Vervang pad in pad\batchuploader.exe door het pad naar de Batchuploader. De instructie Klik met de rechtermuisknop wordt gebruikt om aan te duiden dat u met uw secundaire muisknop moet klikken om het contextmenu te openen. Als u de muis hebt ingesteld voor linkshandig gebruik, leest u hier dus Klik met de linkermuisknop. MapinhUploadInTS-prod doc2.0 iv
1 Inleiding Met Batchuploader kunt u de hele inhoud van een map van uw lokale schijf uploaden in een Three Ships-product, dit kan met of zonder de eventuele submappen. U doet dit door Batchuploader te starten, de benodigde gegevens op te geven en de upload uit te voeren. U hoeft hiervoor niet te zijn ingelogd in het Three Ships-product. Dit document geeft instructies voor het gebruik van Batchuploader: hoofdstuk 2 geeft de stappen voor het uploaden; hoofdstuk 3 beschrijft hoe u uw upload-instellingen in een configuratiebestand kunt bewaren, om ze een volgende keer weer te gebruiken; hoofdstuk 4 geeft instructies voor het wijzigen van de algemene instellingen voor het uploaden; hoofdstuk 5 tenslotte, behandelt hoe u Batchuploader kunt uitvoeren vanaf een commandline. Tips Batchuploader kan worden gebruikt bij N@Tschool! versie 11 en CDS versie 1.5, en is gratis beschikbaar voor alle N@Tschool!- en CDS-gebruikers. Om te kunnen uploaden is in het Three Ships-product de functie USER_ALLOW_BATCHUPLOADER vereist. MapinhUploadInTS-prod doc2.0 5
2 Upload uitvoeren Dit hoofdstuk geeft de stappen voor het uitvoeren van een upload. Verwijzing Wilt u een beschrijving opgeven voor mappen en bestanden die u uploadt, de standaardinstellingen bij naamconflicten wijzigen of het materiaaltype bij uploaden instellen, zie dan voor instructies: hoofdstuk 4 Algemene instellingen wijzigen (geavanceerd). 1. Start BatchUploader.exe. Het volgende venster verschijnt: Vul nu alle gegevens in voor de upload. Tip Beschikt u over een configuratiebestand met de upload-instellingen, dan kunt u ook dit bestand laden: klik op Load Config, selecteer het bestand en klik op Open. Wijzig eventueel nog instellingen en ga daarna verder met stap 7. Verwijzing Zie voor het maken van bestand met upload-instellingen: hoofdstuk 3 Upload-instellingen bewaren. 2. Geef bij Destination Site URL de URL op van de doelsite, bijvoorbeeld: http://threeships.natschool.com. 3. Geef bij Login de inlognaam voor de doelsite op. 4. Geef bij Password het wachtwoord bij de inlognaam op. 5. Klik achter Folder to Upload op het icoon, selecteer op uw lokale schijf de bronmap waarvan u de inhoud wilt uploaden en klik op OK. MapinhUploadInTS-prod doc2.0 6
Tips Vink Recursive uit, als u alleen de bestanden en geen submappen uit de bronmap wilt uploaden. Wilt u in het doelprogramma achter websites en andere zipbestanden die u uploadt de extensie.zip tonen, vink dan Preserve.zip extension aan. 6. Geef bij Destination CMS Folder de doelmap in de materialenbank van het Three Ships-product op, bijvoorbeeld /Bovendijkcollege/Aardrijkskunde. Tips U dient hier een al bestaande map op te geven, anders wordt er niets geüpload. Om het pad van een map in N@Tschool! of het CDS te achterhalen: klik met de rechtermuisknop op de map, kies Eigenschappen, selecteer het pad achter Pad, kopieer het met Ctrl-c en plak het vervolgens met Ctrl-v in Batchuploader. Let op: er mogen geen spaties achter de padnaam staan. Let op Zorg ervoor dat u de juiste permissies op de doelmap en de erbovenliggende mappen hebt. U hebt in elk geval nodig: Materialen toevoegen en wijzigen op de doelmap Map inzien op de erbovenliggende mappen En optioneel (afhankelijk van uw instellingen op het tabblad Options en of u ook submappen uploadt): Submappen toevoegen en wijzigen op de doelmap Submappen verwijderen op de doelmap Materialen verwijderen op de doelmap. 7. Klik op Start Upload. De bestanden worden geüpload in het Three Ships-product. Tip Na het uploaden wordt er een log van het uploaden getoond. Wilt u dit bewaren, klik dan op Save log, selecteer een map op uw lokale schijf, geef een naam op voor het bestand en klik op Save. MapinhUploadInTS-prod doc2.0 7
3 Upload-instellingen bewaren In dit hoofdstuk staat beschreven hoe u uw upload-instellingen kunt bewaren in een configuratiebestand, om ze een volgende keer weer te gebruiken. 1. Start BatchUploader.exe. 2. Geef op de tabbladen General en Options uw instellingen op. Verwijzing Zie voor instructies: hoofdstuk 2 Upload uitvoeren (het tabblad General) en hoofdstuk 4 Algemene instellingen wijzigen (geavanceerd) (tabblad Options). 3. Klik op Save Config. 4. Geef een naam op voor het bestand. 5. Klik op Save. MapinhUploadInTS-prod doc2.0 8
4 Algemene instellingen wijzigen (geavanceerd) Dit hoofdstuk geeft instructies voor het wijzigen van de algemene instellingen voor het uploaden. 1. Start BatchUploader.exe. 2. Selecteer het tabblad Options. 3. Geef in het veld Description eventueel een beschrijving op voor alle mappen en bestanden die u uploadt. Tips In het Three Ships-product is de beschrijving beschikbaar in de eigenschappen van de map of het document. Bij het uploaden wordt het materiaaltype van een bestand standaard automatisch gedetecteerd. In bepaalde situaties kan dit onwenselijk zijn (bijvoorbeeld als u een zip-bestand als zip-bestand wilt uploaden in plaats van als website). Om zelf het materiaaltype te bepalen, kunt u bij Type het gewenste materiaaltype kiezen. Voor het uploaden van een zip-bestand als zip-bestand, kiest u File als materiaaltype. Stel nu onder Name conflict resolution in wat er moet gebeuren bij naamconflicten tijdens het uploaden. 4. Kies onder File with File/Package welke actie moet worden uitgevoerd als een te uploaden bestand dezelfde naam heeft als een bestand in de doelmap. Tips Add as new version: voegt het nieuwe bestand als nieuwe versie aan het bestaande bestand toe (het bestaande bestand wordt hiermee vervangen). Automatic rename: uploadt het nieuwe bestand met een andere naam (achter de huidige naam wordt een versienummer MapinhUploadInTS-prod doc2.0 9
toegevoegd) en behoudt het bestaande bestand. Skip: uploadt het nieuwe bestand niet en behoudt het bestaande bestand. Abort: breekt het uploaden af (er wordt niets geüpload). 5. Kies onder File with Folder welke actie moet worden uitgevoerd als een te uploaden bestand dezelfde naam heeft als een map in de doelmap. Tips Automatic rename: voegt het bestand toe met een andere naam (achter de huidige naam wordt een versienummer toegevoegd) en behoudt de bestaande map. Skip: voegt het bestand niet toe en behoudt de bestaande map. Abort: breekt het uploaden af (er wordt niets geüpload). 6. Kies onder Folder with File/Package welke actie moet worden uitgevoerd als een te uploaden map dezelfde naam heeft als een bestand in de doelmap. Tips Automatic rename: voegt de map toe met een andere naam (achter de huidige naam wordt een versienummer toegevoegd) en behoudt het bestaande bestand. Skip: voegt de map niet toe en behoudt het bestaande bestand. Abort: breekt het uploaden af (er wordt niets geüpload). MapinhUploadInTS-prod doc2.0 10
5 Batchuploader uitvoeren vanaf een commandline Het is ook mogelijk Batchuploader vanaf een commandline uit te voeren, bijvoorbeeld via Start > Run in Windows (hieronder beschreven). De interface wordt dan niet geladen. 1. Klik in Windows op Start > Run. 2. Typ het commando direct in het veld achter Open, of (voor meer ruimte) typ cmd, klik op OK en typ of plak het commando in het DOS-venster. Tip Om te plakken in een DOS-venster: klik met de rechtermuisknop in het venster en kies Paste. 3. Voeg het pad inclusief bestandsnaam van de Batchuploader toe. Tip In het veld Open: klik op Browse, blader naar BatchUploader.exe, selecteer het bestand en klik op Open. 4. Voeg de parameters met hun waarden toe. Gebruik hiervoor het volgende formaat: pad\batchuploader.exe parameter=waarde parameter=waarde (...) Voorbeelden: C:\BatchUploader.exe config= C:\configbestand.xml C:\BatchUploader.exe config= C:\configbestand.xml url= http://threeships.natschool.com login= jjansen passwordplain= welkom123 diskfolderpath= c:\bronmap destinationcmsfolder= /Bovendijkcollege/Aardrijkskunde C:\BatchUploader.exe url= http://threeships.natschool.com login= jjansen passwordplain= welkom123 diskfolderpath= c:\bronmap destinationcmsfolder= /Bovendijkcollege/Aardrijkskunde De onderstaande tabel geeft een beschrijving en voorbeeld van elke parameter die u kunt gebruiken. Parameters aangeduid met een * zijn verplicht als er geen configuratiebestand wordt gebruikt. Parameter config Beschrijving Duidt het pad inclusief bestandsnaam van het configuratiebestand aan. Bijvoorbeeld: config= c:\configbestand.xml url * Tip Bij gebruik van andere parameters naast deze parameter, overschrijven de waarden van de andere parameters de waarden uit het configuratiebestand. Duidt de URL van de doelsite aan. MapinhUploadInTS-prod doc2.0 11
Parameter login * passwordplain * diskfolderpath * uploadrecursive destinationcmsfolder * type filepackageconflict filefolderconflict Beschrijving Bijvoorbeeld: url= http://threeships.natschool.com Duidt de inlognaam voor de doelsite aan. Bijvoorbeeld: login= jjansen Duidt het wachtwoord bij de inlognaam aan. Bijvoorbeeld: passwordplain= welkom123 Duidt het pad van de map die u wilt uploaden aan. Bijvoorbeeld: diskfolderpath= c:\bronmap Duidt aan of u zowel de bestanden als de submappen uit de bronmap wilt uploaden (standaardinstelling) of alleen de bestanden. Om zowel de bestanden als de submappen (inclusief bestanden) te uploaden, gebruik: uploadrecursive=true Om alleen de bestanden te uploaden, gebruik: uploadrecursive=false Duidt de doelmap in de materialenbank van het Three Ships-product aan. Bijvoorbeeld: destinationcmsfolder= /Bovendijkcollege/ Aardrijkskunde Duidt aan of u het materiaaltype automatisch wilt detecteren (standaardinstelling), wilt uploaden als bestand of wilt uploaden als website. Om het materiaaltype automatisch te detecteren, gebruik: type=0 Om te uploaden als bestand, gebruik: type=1 Om te uploaden als website, gebruik: type=2 Duidt aan welke actie moet worden uitgevoerd als een te uploaden bestand dezelfde naam heeft als een bestand in de doelmap: toevoegen als nieuwe versie (standaardinstelling), naam wijzigen van het te uploaden bestand, het bestand niet uploaden, het uploaden afbreken. Om het bestand toe te voegen als nieuwe versie, gebruik: filepackageconflict=0 Om de naam van het te uploaden bestand te wijzigen, gebruik: filepackageconflict=1 Om het bestand niet te uploaden, gebruik: filepackageconflict=2 Om het uploaden af te breken, gebruik: filepackageconflict=3 Duidt aan welke actie moet worden uitgevoerd als een te uploaden bestand dezelfde naam heeft als een map in de doelmap: naam wijzigen van het te uploaden bestand (standaardinstelling), het bestand niet uploaden, het MapinhUploadInTS-prod doc2.0 12
Parameter folderpackageconflict Savelogto Beschrijving uploaden afbreken. Om de naam van het te uploaden bestand te wijzigen, gebruik: filefolderconflict=0 Om het bestand niet te uploaden, gebruik: filefolderconflict=1 Om het uploaden af te breken, gebruik: filefolderconflict=2 Duidt aan welke actie moet worden uitgevoerd als een te uploaden map dezelfde naam heeft als een bestand in de doelmap: naam wijzigen van de te uploaden map (standaardinstelling), de map niet uploaden, het uploaden afbreken. Om de naam van de te uploaden map te wijzigen, gebruik: folderpackageconflict=0 Om de map niet te uploaden, gebruik: folderpackageconflict=1 Om het uploaden af te breken, gebruik: folderpackageconflict=2 Duidt het pad inclusief bestandsnaam van het logbestand aan. Bijvoorbeeld: savelogto= c:\logbestand.txt Tip Als deze parameter niet wordt gebruikt, wordt het logbestand in dezelfde map als de Batchuploader opgeslagen als log.txt. MapinhUploadInTS-prod doc2.0 13