Redigering av dokumenter i Vortex over WebDAV med Contribute
Site-administrasjon ved hjelp av Contribute fungerer ikke som beskrevet i denne guiden for de tidlige versjonene av Contribute (versjon 3.0 og tidligere), og det anbefales at du oppgraderer til Contribute 3.11 eller senere versjon før du begynner å administrere ressurser i Vortex ved hjelp av Contribute.
Innholdsfortegnelse
Opprette forbindelse til et Vortex-område
Når du har startet Contribute kan du enten trykke på knappen "Create Connection" (denne er tilgjengelig hvis du ennå ikke har satt opp noen forbindelser i Contribute) eller åpne "Edit" på fil-menyen, velge "My connections..." på menyen og deretter trykke knappen "Create..." i 'My Connections'-dialogboksen.
Du vil da få opp "Create Connection"-wizard'en.
Det første du må sette opp er URL'en til Vortex-området du skal redigere.
Her skriver du inn adressen til Vortex-katalogen hvor du skal redigere dokumentene. (Dersom denne inneholder en index-fil vil Contribute automatisk finne denne når du senere skal til å redigere.) Dersom du er usikker på URL'en, kan du bruke "Browse.."-knappen for å se en fohåndsvisning av siden.
Neste punkt er å sette opp WebDAV-forbindelsen:
- For "How do you connect to your web server" skal du velge WebDAV.
- WebDAV-URL er den WebDAV-spesifikke adressen til Vortex-området hvor du skal redigere.
Normalt vil denne være lik som URL'en i forrige vindu, bortsett fra at protokollen er https og "-dav" legges til i host-navnet. For mere informasjon om oppbygning av WebDAV-adresser i Vortex, se her. - For "username" og "password" skriver du inn ditt vanlige UiO-brukernavn og passord.
Merknad om sikkerhet
Fordi Contribute 3 krever at du skriver inn WebDAV-brukernavn og -passord for å klare å kople seg til Vortex-området du vil redigere, skal du kryptere oppkoplingsparametrene du har satt opp her. Det gjør du ved å klikke på "Advanced..."-knappen og velge "Encrypt connection information for all websites":
Du blir da sendt til security-oppsettet i Contribute (kan også nås ved å velge "Edit" på fil-menyen, deretter "Preferences" og så klikke "Security" i listen på dialogboksen som kommer opp). Her skal du velge "Encrypt connection information for all websites" igjen, og skrive inn et passord som du bruker for å få tilgang til områder du har satt opp i Contribute. I tillegg haker du av "Require password at startup". Disse tiltakene hindrer uatoriserte personer fra å kunne få tilgang til Vortex-områder gjennom din datamaskin.
Det er viktig å bruke et passord her som du er sikker på å huske! Ellers vil du risikere å måtte slette alle oppkoplingene du har satt opp i Contribute for å kunne nullstille sikkerhets-passordet, om du skulle glemme det.
Det siste du trenger å sette opp er person-informasjonen Contribute bruker for å identifisere deg når du redigerer dokumenter i Vortex. Her fyller du inn navn og epost-adresse:
Dette blir blant annet bruk ved WebDAV-låsing av ressurser du redigerer på, slik at ikke flere brukere uforvarende redigerer på de samme dokumentene samtidig.
Merk: Dersom det går lang tid uten at denne dialogboksen kommer opp, kan det hende Contribute har problemer med å opprette WebDAV-forbindelsen. Les da gjennom dette for mulige løsninger på problemer med WebDAV-forbindelse i Contribute.
Dersom forbindelsen din er satt opp riktig vil du nå komme til en dialogbok som oppsummerer de data du har lagt inn:
Mulige feilsituasjoner
Finner ikke nettsted
Dersom URL'en du oppgir som adresse til nettstedet ditt ikke eksisterer vil du få følgende feilmelding:
Du vil likevel kunne forsette å kople opp webområdet over WebDAV (hvis det eksisterer).
Finner ikke mappe
Dersom WebDAV-adressen du oppgir ikke er gyldig vil du få følgende feilmelding:
Problemer med å kople til WebDAV-serveren
Når du setter opp en WebDAV-forbindelse, f.eks. etter at du har fylt inn "Connection Information" for å sette opp en ny forbindelse til et Vortex-område, vil Contribute automatisk teste denne. Dersom ting forløper slik de skal tar dette kort tid, og du blir sendt direkte til neste dialog.
Skulle det derimot være en feil med oppkoplingen, vil du normalt få opp følgende dialog mens den forsøker å kople deg opp:
Etter en stund vil du få en feilmelding som forteller at du ikke kan koples opp. Den kan se slik ut:
(I noen tilfeller vil du få denne med en gang.)
Dette kan være på grunn av en eller flere av de følgende problemene:
- Feil utfylt informasjon for oppkopling til Vortex-området:
-
- Skrivefeil i brukernavnet ditt.
- Skrivefeil i passordet ditt.
- Du har glemt å skrive inn brukernavn og/eller passord. (Begge må være lagt inn for at Contribute skal kunne kople deg opp.)
- Manglende internettforbindelse på datamaskinen din.
- Det er feil på Vortex-serveren du prøver å kople deg opp mot, eller den er nede. (Dette er lite sannsynlig, med mindre vedlikehold på Vortex-serveren har blitt varslet.)
MERK:
Hvis Contribute feiler i å kople deg opp mot WebDAV-området, hender det at feilen vedvarer selv om du prøver på nytt med riktig utfylte data. Du må da lukke dialogen for å opprette en ny forbindelse, og starte redigeringen av oppsettet på nytt!
Satt opp feil type oppkopling
Dersom du har valgt feil type oppkoplingstype: FTP, Secure FTP eller Local/Network i stedet for WebDAV, vil følgende feilmelding opp når Contribute forsøker å etablere forbindelsen til Vortex-mappen:
Gå tilbake og velg WebDAV for hvordan du vil kople opp mot web-serveren.
Manglende leserett og/eller skriverett på mappen
Dersom du mangler leserett på Vortex-mappen du forsøker å kople opp vil Contribute gi følgende feilmelding når du forsøker å sette opp forbindelsen:
På samme måte vil du få denne feilmeldingen dersom du mangler skriverett på mappen:
Hvis det er meningen du skal ha tilgang til mappen blir du nødt til å endre rettighetene på mappa som inneholder dokumentene (eller eventuelt på de enkelte dokumentene) du skal redigere i Vortex. Administrering av rettigheter i Vortex kan du lese mer om her. Dersom du ikke har tilgang, må du nødvendigvis få en administrator til å endre rettighetene for deg.
Generelle "misvisende" feilmeldinger
Om du har oppgitt adresse til webområde og WebDAV-område som ikke korresponderer med hverandre (f.eks. hvis WebDAV-URL du setter opp er en underkatalog for nettsted-URL'en du oppga), vil du få følgende feilmelding:
Se da til at begge adressene peker til korrespnderende HTTP- og WebDAV-område.
Dersom du forsøker å klargjøre en fil på webområdet for redigering i Contribute, forsøker å legge opp en fil som du har redigert eller laste opp en ny fil du har laget, men du mangler nødvendige rettighetr skriverett i Vortex til det du forsøker vil du kunne få en av følgende feilmeldinger:
- Ved forsøk på redigere fil du ikke har skriverett til (selv om du har skriverett på mappa og leserett på fila):
- Du har ikke lenger skrivetilgang på området du har fått koplet deg opp mot, og du forsøker å laste opp en ny fil:
- Du har nylig fått skrivetilgang til Vortex-området og prøver å laste opp en fil:
(Merk - Denne feilen blir som oftest borte hvis du prøver å publisere på nytt etter en kort stund.)
- Du forsøker å redigere en fil som er låst:
(Hvis filen er låst i Vortex, i motsetning til låser fra Contribute, vil navnefeltet være tomt. Låsen frigis normalt i Vortex etter 30 minutter.)
Siden feilmeldingene helt eller delvis indikerer andre situasjoner enn det som faktisk er problemet, anbefales det å gå inn i administrasjonsgrensesnittet i Vortex og gjøre videre debugging med tanke på låste filer, manglende tilgang o.l. der.
Dersom du opplever feilsituasjoner som ikke er beskrevet her, send en e-post til vortex-feil@usit.uio.no, med beskrivelse av feilen og utfyllende informasjon om bruken av Contribute som uløste problemet, slik at vi kan kikke nærmere på som skjer galt.
Filen blir ikke oppdatert, uten at Contribute gir feilmelding
I det sjeldne tilfellet at man forsøker å legge opp en oppdatert fil som man har skriverett til, men noen andre har låst filen (f.eks ved å web-redigere denne filen), vil man ikke få oppdatert filen som ligger i Vortex. Men Contribute vil i noen tilfeller likevel ikke gi feilmelding eller annen indikasjon på at skrivingen gikk galt, snarere vil dialogvinduet som kommer opp i bakgrunnen si at oppdateringen over WebDAV var suksessfull. (Merk: Dette dialogvinduet blir automatisk lukket når Contribute antar at skrivingen til Vortex var vellykket.)
Dersom du skulle komme ut for at Contribute tilsynelatende oppdatere filen(e) i Vortex, men forandringene dine ikke blir synlige på nett, undersøk da følgende:
Bruk en nettleser og gå til dokumentet, velg så "Administrer dette dokumentet". (Dersom du ikke allrede er logget inn må du også gjøre dette.) I administrasjonsgrensesnittet vil du se et hengelås-ikon og teksten "Låst av <brukernavn>" dersom ressursen er låst av en annen bruker.
Dersom filen var låst, har noen nylig oppdatert filen eller er i ferd med å oppdatere den. Pass da på at du tar hensyn til disse forandringene dersom du senere skal legge opp ditt arbeid.
Tøm cache i nettleseren din, og forsøk å laste siden på nytt. Noen ganger kan nettleserha lagret den gamle versjonen i cache og vise denne i stedet for den nye versjonen av filen.
Dersom ingen av disse diagnosene ser ut til å være tilfelle, kan det hende at de gamle sidene er cachet på serveren. Av og til skjer det at Vortex-serveren beholder gamle sider i cache, selv om de nylig har blitt oppdatert. I såfall vil det ta litt tid før din oppdatering blir synlig på nett.
Er slik for Dreamweaver, men ikke lenger for Contribute. Tvert imot gir Contribute brukbare tilbakemeldinger når dokumenter er låst, har vært redigert av andre (f.eks. deg selv, i Vortex-redigeringsgrensesnittet) e.l.
Øvrige kommentarer
Oppbygning av WebDAV-adresser for Vortex-områder
- URL'en starter med https fordi kommunikasjonen må være kryptert.
- Resten av adressen er den samme som den vanlige www-adressen til Vortex-området, bortsett fra at "-dav" er lagt til host-navnet.
Eksempler på WWW-adresse og WebDAV-adresse til det samme området
- WWW-adresse: http://www.hf.uio.no/
WebDAV-adresse: https://www-dav.hf.uio.no/ - WWW-adresse: http://vortex.uio.no/
WebDAV-adresse: https://vortex-dav.uio.no/
I noen få tilfeller vil også WWW-adressen starte med https. Dette gjelder dersom aksess til siden er kryptert for vanlig nettilgang.
NB: Dersom du kun skal redigere innholdet i en bestemt mappe på Vortex-området (f.eks. din egen undermappe), må du legge inn den komplette WebDAV-adressen til denne mappen. (Ellers vil naturlig nok hele Vortex-strukturen på serven du kopler mot bli satt opp i Contribute.)
Eksempel-URL: https://vortex-dav.uio.no/brukere/brukernavn/mine-dreamweaver-dokumenter/
Tilkobling av webområder som har begrenset lesetilgang
Contribute klarer ikke å automatisk sette opp connection til et web-område som krever autentisering for visning (dvs. som områder som har begrenset lesetilgang), fordi programmet automatisk forsøker å kople opp en site over både browse-URL og WebDAV-URL for å sikre at disse to samsvarer med hverandre samtidig som Vortex sender brukeren til en ny side (Feide-innlogging) på browse-URLen. Dermed vil du få en feilmelding i det brukerdialogen for oppsett av WebDAV er ferdig, og Contribute prøver å teste forbinelsen: "Contribute couldn't find your website files using the WebDAV URL you entered...", jf. manglende skriverett.
For å unngå at redirect på visning skal skape problemer for oppkoplingen kan man cache siden i Contribute når man setter opp siten. Det gjøres ved å trykke "Browse"-knappen etter å ha lagt inn webadressen:
Da får man opp forhåndsvisning, som for sider med begrenset lesetilgang gir videresending til Feide. Der skal man logge inn på vanlig måte:
Man får da opp korrekt visning av siden, og denne blir cachet av Contribute slik at innholdet over HTTP og WebDAV korresponderer:
Når man først har satt opp webområdet vil man kunne autentisere seg gjennom det vanlige browse-grensesnittet i Contribute, på samme måte som ved redigering i en vanlig nettleser.
Eventuelt kan man kople opp et område uten begrenset lesetilgang først, deretter redigere en side under dette området slik at Contribute setter opp autentisering for den gjeldende brukeren. Det blir deretter bli mulig å kople opp mot et område som krever innlogging for lesing (siden man da ikke lenger blir redirected til Feide / autentisering).
Dette fungerer derimot automatisk i Dreamweaver, og den editoren er derfor bedre egnet for Vortex-områder med begrenset lesetilgang.