Gå til hovedinnhold

Feilsøking av Desktop Connector

Skrevet av Sjaak Velthoven

Denne artikkelen er i sin helhet maskinoversatt.

 

Følgende saker beskrives i denne artikkelen:

 

 

1. Navnekonvensjon

Hvis en navnekonvensjon er aktivert på opplastingsmappen eller en overordnet mappe til opplastingsmappen, må det lokale filnavnet følge konvensjonen for at opplastingen skal gjennomføres.

Hvis filnavnet ikke følger konvensjonen, vises følgende feil.

 

<Filename> samsvarer ikke med navnekonvensjon

 

Vennligst last opp filen manuelt via nettleseren for å se hvilke deler av filnavnet som mangler.

 

 

2. Serverprosjektplassering

Flere feil kan oppstå når du åpner serverprosjektplasseringen.

 

2.1 Prosjektplassering tom

For å synkronisere dine lokale filer til et prosjekt må du ha minst én mappe i dokumentseksjonen av prosjektet på Catenda Hub.

 

2.2 Prosjekt ikke funnet

Når Desktop Connector åpnes for første gang, lastes alle prosjekter som brukeren har tilgang til.

Uten å oppdatere vises de samme prosjektene neste gang.

Hvis brukeren har mistet tilgang til prosjektet, vises følgende melding når du forsøker å angi serverplassering i en opplastings- eller nedlastingsoppgave for prosjektet.

 

 

Vennligst spør en prosjektadministrator om tilgang til prosjektet.

For å finne ut hvem du skal kontakte for prosjekttilgang, kan du kontakte Catenda-support.

 

 

3. Dokumentutseende

 

Følgende saker beskrives i denne delen:

 

 

3.1 Mappeplassering

Dokumentnavn kan være begrenset med en navnekonvensjon i Catenda.

Mapper kan ikke være begrenset.

Uten bruk av en navnekonvensjon kan dokumenter med ethvert navn lastes opp.

I dette tilfellet kan det hende at Catenda ikke kunne registrere filtypen til dokumentet.

Mapper med ethvert navn kan opprettes.

Det kan derfor være at Desktop Connector støter på problemer med tegn i navn som er reservert for Windows-funksjoner.

 

Typiske problemer oppstår med følgende tegn: / - Skråstrek fremover \ - Skråstrek bakover Disse tegnene brukes i filstigarkitekturen i Windows, noe som fører til at dokumentet havner på feil sted.

 

Se her for en omfattende liste over hva som er reservert i Windows: https://learn.microsoft.com/en-us/windows/win32/fileio/naming-a-file

 

3.2 Feil dokument- eller mappenavn

Dokumentnavn kan være begrenset med en navnekonvensjon i Catenda.

Mapper kan ikke være begrenset.

Uten bruk av en navnekonvensjon kan dokumenter med ethvert navn lastes opp.

I dette tilfellet kan det hende at Catenda ikke kunne registrere filtypen til dokumentet.

Mapper med ethvert navn kan opprettes.

 

Det kan derfor være at Desktop Connector støter på problemer med tegn i navn som er reservert for Windows-funksjoner.

 

Typiske problemer oppstår med følgende tegn: . - Periode

 

Siden mapper og filer som ender med en periode ikke er tillatt i Windows, fjernes perioden på slutten av mappen eller filen i dokumentet som opprettes fra en nedlastingsoppgave.

Ved opplasting fjernes perioden i prosessen med å finne riktig mappe å laste opp til, slik at det nedlastede dokumentet havner på rett sted ved to-veis synkronisering.

 

- Mellomrom

 

I Catenda er det mulig å manuelt legge til mellomrom på slutten av et dokument- eller mappenavn, mens mellomrom på slutten av dokument- og mappenavn fjernes i Windows.

Hvis det inkluderes mellomrom på Catenda, er navnet på den nedlastede mappen forskjellig fra navnet på mappen i Catenda som kan inneholde mellomrom.

Når en opplastingsoppgave opprettes for den samme mappen, vil en ny mappe bli opprettet fordi fil- eller mappenavnet i Windows ikke har mellomrom på slutten.

 

 

4. Ingen opplasting eller nedlasting

 

Følgende saker beskrives i denne delen:

 

 

4.1 Dokumentet finnes allerede

Når importsystemet ikke kan behandle en gjenstand som ble opprettet tidligere, oppstår følgende feil.

 

Desktop Connector Dokumentet finnes allerede (kode: 25)

 

Loggfil

 

||ERROR|1|BimRequestProviderService|Call API error status code Conflict reason: {"error":{"code":25,"message":"Document already exists"}}.url: https://api.bimsync.com/v2/projects//libraries//items? | Data: {"parentId":"","name":"","document":{"type":"","filename":""}} 

 

Spesifikt kan dette skje når du forsøker å laste opp en mappe med tittelen "A" for andre gang hvor en mappe med den tittelen allerede finnes.

Det anbefales å endre hver lokale mappe med navnet "A" til noe som "A_".

På denne måten vil oppgaven ikke støte på problemer.

Etter at opplastingsoppgaven er ferdig, endrer du den synkroniserte versjonen tilbake til "A" på Catenda slik at begge sidene forblir den samme.

 

4.2 Ikke alle mapper er nedlastet

I selve oppgaven kan du se følgende:

 

 

Ikke alle mapper er nedlastet, klikk for å vise feil.

 

Klikk her for å lese mer om hva problemet kunne være med denne feilen.

 

 

5. Siste revisjon trukket tilbake

Siste revisjon for et av dokumentene har blitt trukket tilbake.

I dette tilfellet er det ingen feilmelding i loggfilen.

 

 

6. Samtidig synkronisering

For at Desktop Connector skal kunne hente data fra et dokument for å laste opp eller oppdatere et dokument med nedlastede data, trenger den tilgang til dokumentet.

Hvis dokumentet er i bruk av en annen prosess, kan den ikke få tilgang til dokumentet.

Hvis dokumentet er i bruk, kan følgende feil vises:

 

Desktop Connector Prosessen har ikke tilgang til filen '<File path>' fordi den brukes av en annen prosess.

 

Loggfil

 

||ERROR|1|ExceptionHandleExtension|Some error happen --> System.IO.IOException: The process cannot access the file '' because it is being used by another process.

 

Prosesser som kan ha filer i bruk, inkluderer: En annen oppgave fra Desktop Connector selv Filsynkroniseringstjenester som Dropbox, OneDrive eller Google Drive Andre CDE-synkroniseringsverktøy.

Programmer som har filen åpen for redigering.

 

Hvis dokumentet er i bruk, stoppes oppgaven og vil ikke fortsette hvis den ikke kan få tilgang til en av filene.

Hvis flere oppgaver er planlagt, vil den prøve igjen til neste planlagte tid.

 

 

7. Aktivitetsovervåking

 

Følgende saker beskrives i denne delen:

 

 

7.1 Oppgave startet

Oppgaver som er manuelt startet ved å klikke på Last opp/Last ned nå i oppgaven, viser en status for Last opp eller Last ned så snart oppgaven er startet.

For både oppgaver som er manuelt startet og oppgaver som er startet etter tidsplan, vises en melding som ser slik ut i loggfilen når en oppgave starter:

 

Loggfil <Message number>|<Date/time>|INFO|1|LoggingExtension|start logging

 

7.2 Oppgave kjører

Oppgaver som er manuelt startet ved å klikke på Last opp/Last ned nå i oppgaven, viser en status for Last opp eller Last ned så lenge oppgaven kjører.

For både oppgaver som er manuelt startet og oppgaver som er startet etter tidsplan, kan tilstanden som oppgaver som kjører er i, ses ved å overvåke nettverksutnyttelsen av programmet.

 

Innledende oppstartsfase

En Desktop Connector-oppgave er i innledende oppstartsfase når den bruker mellom 1 kilobyte per sekund og 1 megabyte per sekund.

I løpet av denne fasen er nettverksutnyttelsen av oppgaven minimal.

 

Nedlastingsoppgave Under innledende oppstartsfase sjekkes dokumenter på serverplasseringen mot de lokale filene for å se om det finnes noen serverfiler som har endret seg og som en ny revisjon skal lastes ned for, eller om det finnes nye filer på serversiden som skal lastes ned til det lokale systemet.

 

Opplastingsoppgave Under innledende oppstartsfase sjekkes dokumenter på serverplasseringen mot de lokale filene for å se om det finnes noen lokale filer som har endret seg og som en ny revisjon skal lastes opp for, eller om det finnes nye lokale filer som skal lastes opp til Catenda.

 

Aktiv fase

En Desktop Connector-oppgave er i aktiv fase når den bruker mer enn 1 megabyte per sekund.

I løpet av denne fasen kan nettverksutnyttelsen av oppgaven ha en effekt på resten av systemet.

 

Nedlastingsoppgave I løpet av den aktive fasen laster Desktop Connector aktivt ned fil for fil fra Catenda til det lokale systemet.

 

Opplastingsoppgave I løpet av den aktive fasen laster Desktop Connector aktivt opp fil for fil fra det lokale systemet til Catenda.

 

7.3 Oppgave stoppet

Oppgaver som kjøres manuelt ved å klikke på Last opp/Last ned nå i oppgaven, viser en statusmelding innenfor oppgaven når oppgaven stoppes hvis enten når oppgaven er ferdig eller når en feil har oppstått.

 

Oppgave ferdig

Den eneste måten å se om oppgaver er ferdig på er å kjøre oppgaven manuelt.

Klikk på Last opp/Last ned nå innenfor oppgaven for å gjøre det.

Når oppgaven er ferdig, vises en melding om at alle dokumenter er lastet opp eller ned i oppgaven.

 

 

Merk: Det er ingen meldinger i loggfilen for ferdige oppgaver. Den eneste måten å se om oppgaver som er startet etter tidsplan er stoppet på, er ved å sjekke nettverksutnyttelsen av programmet.

 

En feil oppstod

En mer detaljert beskrivelse av feil som har oppstått, kan ses ved å sjekke loggfilen for eventuelle nylige feil.

 

Nettverksutnyttelse

Den eneste måten å se om oppgaver som er startet etter tidsplan er stoppet på, er ved å sjekke nettverksutnyttelsen av programmet.

Hvis Desktop Connector har brukt mindre enn 1 kilobyte per sekund i over 2 minutter, har oppgaver som kjørte sannsynligvis blitt stoppet og vil ikke starte igjen.

For oppgaver som er planlagt å gjentas, startes en ny oppgave hvis Desktop Connector kjører på den neste datoen og klokkeslettet oppgaven er planlagt til å begynne.

 

 

8. Tilkobling mellom koblingen og Catenda

 

Følgende saker beskrives i denne delen:

 

 

8.1 Tilkobling ved oppgavestart

Hvis det er et problem med internettilkoblingen, startes ikke opplastings- eller nedlastingsoppgaven automatisk på nytt og kjøres igjen til neste planlagte tid.

Det kan også startes manuelt ved å gå til oppgaven og klikke på opplastings- eller nedlastingsknappen.

 

Ingen tilkobling

Hvis det ikke finnes internettilkobling når du starter en opplastings- eller nedlastingsoppgave, vises følgende feil i opplastings- eller nedlastingsoppgaven.

 

Ingen slik vert er kjent

 

Tilkobling tapt under oppgavestart

Hvis tilkoblingen til internett gikk tapt eller timet ut når du forsøkte å koble til Catenda-serverne, vises følgende feil:

 

SSL-tilkoblingen kunne ikke etableres

 

Brukt tilkoblingsmetode avhenger av foretrukket metode tilgjengelig ved oppgavestart

Når en oppgave startes, opprettes en tilkobling med den foretrukne internettilkoblingsmetoden.

Hvis for eksempel en kablet tilkobling og en WiFi-tilkobling er tilgjengelig når en oppgave kjøres, foretrekkes vanligvis den kablede tilkoblingen.

Hvis bare en WiFi-tilkobling er tilgjengelig når en oppgave startes og en kablet tilkobling kobles til mens den kjører, fortsetter koblingen å bruke den innledende tilkoblingen så lenge den er tilgjengelig og bytter ikke til en foretrukket tilkobling som senere blir tilgjengelig.

 

8.2 Tilkobling under oppgave - Tilkobling til internett

Internettilkobling ikke lenger tilgjengelig uten reserve

Hvis det bare var en tilkobling tilgjengelig da oppgaven begynte, eller hvis det ikke var noen tilkobling tilgjengelig i det hele tatt (f.eks.

Flymodus), kan følgende feil oppstå.

 

En feil oppstod under sending av forespørselen.

 

Internettilkobling ikke lenger tilgjengelig med reserve

Hvis det var flere tilkoblinger tilgjengelig da oppgaven begynte og tilkoblingen som ble brukt gikk tapt, vil koblingen forsøke å bytte til en av de andre tilgjengelige tilkoblingene.

Under denne bytting kan følgende feil oppstå:

 

Feil under kopiering av innhold til en strøm

 

8.3 Tilkobling under oppgave - Desktop Connector sesjonstimeout

Catenda Desktop Connector har en hardkodet sesjonsbegrensning på 10 minutter.

Dette betyr ikke at en oppgave vil timeout etter 10 minutter siden Desktop Connector ofte fungerer med flere korte økter av gangen.

Store filer som punktskyer der opptil 25 GB kan godtas på en gang, kan føre til at en sesjon tar lengre tid enn normalt og kan timeout hvis den ikke lastes opp innen 10 minutters grensen.

 

Timeout på 600 sekunder forløper

 

Kontakt støtte i denne situasjonen.

Det finnes en Beta-versjon tilgjengelig etter forespørsel som kan hjelpe med dette.

Med Beta-versjonen økes denne grensen litt, men selv med betaversjonen kan den timeout, men i stedet etter 15 minutter.

 

Timeout på 900 sekunder forløper

 

8.4 Tilkobling under oppgave - Tilkobling til Catenda

Avhengig av hastigheten på tilkoblingen både på opplastings- eller nedlastingssiden eller på Catenda-siden kan det ta kortere eller lengre tid å laste opp filer.

Hvis oppgaven tar for lang tid, kan tilkoblingen timeout.

 

Catenda timeout

Hvis overføringen har tatt for lang tid, vil den timeout og følgende feil vil vises:

 

En tilkoblingsforsøk mislyktes fordi den tilkoblede parten ikke svarte ordentlig etter en tid, eller etablert tilkobling mislyktes fordi tilkoblet vert kunne ikke reagere. (api.bimsync.com:443)

 

Kontakt støtte i denne situasjonen.

Det finnes en Beta-versjon tilgjengelig etter forespørsel som kan hjelpe med dette.

 

Catenda Service utilgjengelig

Hvis Catenda API midlertidig ikke kan motta forespørsler på brøkdelen av sekundet Desktop Connector forsøker å nå den, vises følgende melding.

 

Desktop Connector HTTP FEIL 503 Service Utilgjengelig

 

Loggfil

 

||ERROR|1|BimRequestProviderService|Call API error status code ServiceUnavailable reason: Error 503 Service UnavailableHTTP ERROR 503 Service Unavailable

URI:
/v2/projects/10005fce182e49cb91342571746cf1fc/libraries/9a90887d954a444c8ed45695707b2fbd/items


STATUS:
503


MESSAGE:
Service Unavailable


SERVLET:
-

 

Dette skyldes ofte at servere er overbelastet og mange brukere forsøker å sende forespørsler samtidig.

 

Gateway timeout

En gateway timeout betyr ofte at Catenda API kjører jevnt og at den innledende forespørselen ble mottatt ordentlig.

Tjenesten som skulle håndtere denne forespørselen svarte imidlertid ikke i tide.

 

Desktop Connector 504 Gateway Time-Out Loggfil

 

||ERROR|1|BimRequestProviderService|Call API error status code GatewayTimeout reason: 504 Gateway Time-out504 Gateway Time-out

 

Dette kan indikere at Catenda mottar forespørsler ordentlig, men at serveren som behandler forespørslene midlertidig er utilgjengelig.

Dette kan noen ganger skje når ikke nok maskiner er tilgjengelige, hvoretter flere vil starte automatisk, men dette kan ta litt tid.

 

Tilgangstoken utløpt

Catenda-tilgangstokens må oppdateres etter en time.

Når Desktop Connector navigeres, er dette vanligvis ikke et problem da tokenet oppdateres automatisk, men når en oppgave startes som tar lengre tid enn en time, kan tilgangstokenet som ble brukt for oppgaven, timeout mens oppgaven pågår.

Når dette skjer, vises følgende feil i Desktop Connector.

For oppgaver som tar lengre tid enn en time, starter du oppgaven på nytt eller venter på neste planlagte oppgave for å gjøre det gjenstående arbeidet.

 

Desktop Connector Unntak av typen 'BimsyncApp.Exceptions.BimAuthenticatorException' ble kastet.

 

Loggfil

 

||ERROR|1|BimRequestProviderService|Call API error status code Unauthorized reason: {"error":{"code":12,"message":"Access token has expired"}}.url: 

 

 

9. Denne enheten er for øyeblikket i bruk

Når du laster ned fra eller laster opp til en ekstern harddisk, gir Windows en feil som sier at enheten for øyeblikket er i bruk hvis den forsøkes frakoblet.

 

 

10. Mapperettigheter

For mapper som befinner seg på stasjonen der Windows er installert, kreves riktige mapperettigheter.

Høyreklikk mappen du prøver å laste ned til og tillat de rette rettighetene.

 

 

 

I dette tilfellet gir loggfilen følgende feil:

 

Tilgang til stien '<Selected local folder path> undermappe <Path within local folder>' er nektet

 

10.1 Tilgang nektet

Selv om en mappe i Windows kan åpnes, kan Windows håndheve en "Ingen-skriving-opp"-policy.

Desktop Connector lar deg velge denne mappen, men når oppgaven kjøres, vises følgende melding:

 

 

I dette tilfellet er Desktop Connector blokkert fra skriving, uavhengig av brukerens "Full kontroll"-rettigheter.

 

Sletting av denne mappen krever at brukeren gir administratorrettigheter.

 

 

I noen situasjoner kan mappen fremdeles åpnes, mens i andre kan følgende melding vises:

 

 

Selv ved fortsetting kan følgende melding vises:

 

 

Hvis du klikker på Last ned likevel, lastes filene ned, men de kan ikke lastes ned til den angitte mappen ettersom mappen er begrenset.

 

 

Desktop Connector Status: Omdirigering, klikk for å vise nedlastede filer

 

Loggfil Tilgang til stien '<Path>' er nektet

 

Klikk på Vis nedlastede filer for å åpne plasseringen der filene ble nedlastet.

Svarte dette på spørsmålet?