Risoluzione dei problemi dell'app

Questo articolo riguarda i malfunzionamenti dell'app stessa: non si carica, dà errore, si blocca o mostra numeri diversi sul telefono rispetto al laptop. Se prezzi, saldi, numero di azioni o dividendi sembrano sbagliati su ogni dispositivo, si tratta di un problema di dati — vai invece a Risoluzione dei problemi di dati.

Quasi tutti i problemi a livello di app derivano dallo stato locale su un dispositivo: dati di mercato in cache, una build obsoleta o un browser che non consente a Capitally di scrivere nel proprio database locale. Capitally esegue tutti i calcoli sul tuo dispositivo e conserva una copia cifrata del tuo progetto sui nostri server, quindi cancellare lo stato locale è sicuro — il progetto torna al successivo accesso.

Prova queste cinque cose, in ordine

Procedi lungo questa lista. Ogni passo costa più del precedente, e la maggior parte dei problemi si risolve al primo o al secondo. Nessuno di essi tocca la copia cifrata del tuo progetto sul server. Un'eccezione all'ordine: se il problema è iniziato nel momento in cui hai modificato qualcosa nel progetto, salta la lista e annulla quella modifica — vedi Quando l'app si blocca o un progetto smette di rispondere.

1. Ricarica la pagina o riavvia il browser. Chiudi completamente l'app e riaprila. Se hai installato Capitally come app sul desktop o sul telefono, chiudila e riavviala invece di limitarti a cambiare finestra. Questo risolve la maggior parte dei problemi temporanei, incluso un dispositivo bloccato su una versione precedente.
2. Reimposta la cache dati e prezzi. Vai su Impostazioni → Analisi e clicca Reimposta cache dati e prezzi sotto Cache dati di mercato. Questo forza l'app a riscaricare i dati di mercato e ricalcolare ogni valore da zero. Eseguilo sul dispositivo che mostra i numeri sbagliati.
3. Rimuovi tutti i dati da questo dispositivo. Vai su Impostazioni → Privacy e clicca Rimuovi tutti i dati da questo dispositivo sotto Dati del dispositivo. Questo cancella tutto ciò che è memorizzato localmente e forza una risincronizzazione completa. Dovrai effettuare nuovamente l'accesso. Usalo per uno stato locale corrotto, o quando il browser ha esaurito lo spazio di archiviazione.
4. Prova un browser diverso. Chrome e Microsoft Edge sono i più sicuri per fare test. Se il problema scompare lì, la causa è il tuo browser o una delle sue estensioni — vedi la prossima sezione.
5. Esporta e reimporta in un nuovo progetto. L'ultima spiaggia, e quella che risolve gli errori persistenti che sopravvivono a tutto il resto. Vai su Impostazioni → Esporta e salva un backup completo. Crea un nuovo progetto da Cambia progetto → Aggiungi nuovo progetto, poi vai su Importa e scegli il modello predefinito Capitally. Una volta verificato il nuovo progetto, elimina quello vecchio.

Perché l'app non si carica o mostra un errore

Quattro cause spiegano la maggior parte dei problemi di caricamento, e tutte e quattro riguardano il browser piuttosto che i tuoi dati. Capitally memorizza la tua copia di lavoro nel database locale del browser (IndexedDB), quindi qualsiasi cosa blocchi o riempia quel database ferma l'app.

• Modalità privata / in incognito. La navigazione privata di solito limita o disabilita IndexedDB, di cui Capitally ha bisogno per funzionare. Usa una finestra normale.
• Estensioni per la privacy. Le estensioni che bloccano cookie, storage o script possono impedire a Capitally di scrivere nel proprio database locale. Disabilitale per app.mycapitally.com e ricarica.
• Un browser obsoleto. Capitally ha bisogno di un browser ragionevolmente aggiornato; le versioni più vecchie falliscono in modi che non sembrano affatto un problema di versione. Aggiorna il browser, poi ricarica.
• Quota di archiviazione esaurita. Capitally conserva molti dati localmente. Quando l'allocazione di archiviazione del browser si esaurisce, le scritture iniziano a fallire. Il passo 3 sopra — Impostazioni → Privacy → Rimuovi tutti i dati da questo dispositivo — libera spazio.

Quando l'app si blocca o un progetto smette di rispondere

Un blocco subito dopo aver modificato qualcosa di solito significa che la modifica ha generato molti più dati del previsto. Impostare, ad esempio, la frequenza di pagamento degli interessi di un mutuo su giornaliera produce migliaia di transazioni di interessi e può bloccare il progetto. La soluzione è annullare quella modifica.

1. Esporta prima il progetto da Impostazioni → Esporta, come rete di sicurezza.
2. Clicca Annulla nel menu in alto a destra e continua ad annullare finché l'app non torna reattiva. Ripristina rimette tutto a posto se esageri.
3. Se l'app si blocca prima che tu possa aprire il menu, vai direttamente su https://app.mycapitally.com/start/history/. Questo apre direttamente la cronologia progetto, dove puoi annullare o eliminare la modifica che causa il problema. Questa procedura funziona per qualsiasi modifica che ha reso il progetto non rispondente.

Se invece l'app genera errori JavaScript — Cannot read properties of undefined e simili — reimposta prima la cache dati e prezzi (passo 2 sopra). Se l'errore sopravvive, esporta e reimporta in un nuovo progetto (passo 5). Un progetto pulito di solito risolve gli errori che continuano a ripresentarsi.

Valori diversi su dispositivi o browser diversi

La causa abituale sono dati di prezzo obsoleti o caricati in modo errato nella cache di un dispositivo, non un fallimento di sincronizzazione. Spesso si manifesta prima nei grafici — una linea di benchmark che appare diversa sul tablet rispetto al laptop — o come un singolo strumento che ha smesso di aggiornarsi su un solo dispositivo.

1. Sul dispositivo che mostra i numeri sbagliati, vai su Impostazioni → Analisi e clicca Reimposta cache dati e prezzi.
2. Se la differenza sopravvive, vai su Impostazioni → Privacy → Rimuovi tutti i dati da questo dispositivo su quel dispositivo, poi effettua nuovamente l'accesso e lascia che il progetto si risincronizzi dal server.
3. Per una divergenza grave — transazioni mancanti, uno split che esiste su un dispositivo ma non sull'altro — esporta da entrambi i dispositivi prima di toccare qualsiasi cosa, così puoi confrontare. Usa Impostazioni → Esporta per l'intero progetto, oppure seleziona le righe interessate nella scheda Posizioni in Portafoglio e scegli Esporta → Esporta elementi per un singolo strumento o conto. Poi ripulisci il dispositivo problematico, accedi e verifica. Se sembra ancora sbagliato, importa l'esportazione dal dispositivo che aveva lo stato più completo.

«Si sono verificati problemi durante il calcolo delle metriche»

Questo avviso — per esteso, Si sono verificati problemi durante il calcolo delle metriche. I numeri visualizzati potrebbero non essere accurati! — significa che una o più posizioni non hanno potuto essere valutate, e dove lo vedi ti dice di che tipo di problema si tratta. Se appare su un dispositivo ma non su un altro, si tratta di dati di prezzo in cache — reimposta la cache dati e prezzi sul dispositivo interessato. Se appare ovunque, il problema è nei dati sottostanti.

Espandi l'avviso per vedere i singoli messaggi sottostanti. Se invece di un elenco ottieni un invito all'upgrade — Hai superato il limite di strumenti che puoi tenere sotto controllo, o Il tuo piano non include le stock option — non c'è nulla di rotto: le posizioni ci sono, ma il tuo piano non le copre. Vedi Abbonamento e fatturazione.

Per un problema su un singolo strumento che non se ne va, la fonte dei prezzi potrebbe essersi scollegata. Modifica lo strumento, apri la scheda Prezzi e riseleziona il ticker corretto dall'elenco sotto Recupera i prezzi usando questo simbolo di mercato.

Se l'avviso persiste su ogni dispositivo, il messaggio sottostante dice quale problema affrontare: We couldn't fetch price for X, We couldn't resolve currency pair X e i casi di simbolo delistato sono in Prezzi, simboli e dati di mercato; There is a negative balance since X è in Saldi e liquidità non corrispondono.

«Failed to fetch» e «Positions failed to resolve»

Significa che Capitally non è riuscita temporaneamente a recuperare i prezzi di mercato per la vista posizioni. Di solito è causato da un grande volume di richieste di prezzi partite contemporaneamente — comune con portafogli grandi, e specialmente dopo un periodo di inattività — con una di esse che va in timeout. Clicca Riprova e normalmente si risolve.

I tuoi dati memorizzati non sono interessati. Transazioni e cronologia sono salvate così come sono indipendentemente da questo errore; fallisce solo il caricamento dei prezzi live per la vista posizioni. Se inizia a succedere costantemente invece che occasionalmente, segnalalo al supporto.

«User not authorized to access project»

Esci e rientra. Questo errore — spesso visto come Failed to fetch. User not authorized to access project — segue quasi sempre una modifica di abbonamento, piano o prova che la tua sessione in esecuzione non ha ancora recepito. Il testo sembra un errore di permessi, ma il tuo progetto e i tuoi dati sono integri.

Se un nuovo accesso non lo risolve, vai su Impostazioni → Privacy → Rimuovi tutti i dati da questo dispositivo e accedi di nuovo. Se appare ancora dopo, non è una sessione obsoleta: controlla Abbonamento e fatturazione per lo stato del piano, e Il tuo account e l'accesso se non riesci proprio a superare la schermata di login.

Prestazioni con portafogli grandi

Capitally esegue ogni calcolo sul tuo dispositivo, quindi è la dimensione del portafoglio a dettare il ritmo — non c'è un server che fa il lavoro per te, ed è la stessa architettura che mantiene privati i tuoi dati. Come regola pratica, circa 400 strumenti e diverse migliaia di transazioni è il punto in cui inizi a notarlo. Non è un limite: progetti più grandi funzionano comunque, impiegano solo più tempo a caricare e ricalcolare.

• Il primo caricamento è il più lento. I dati storici dei prezzi devono essere recuperati per ogni strumento. I caricamenti successivi leggono dalla cache locale e sono molto più veloci.
• Caricamento di molti nuovi simboli in una volta. Oltre circa 200–250 nuovi simboli in una sola volta, il fornitore di dati di mercato inizia a rifiutare le connessioni. Clicca Riprova — potrebbero servire un paio di tentativi, e i simboli rimanenti di solito si caricano entro circa un minuto. Non dovrebbe ripetersi nei giorni successivi a meno che tu non detenga centinaia di simboli scambiati attivamente.
• Navigazione lenta dopo il primo caricamento. Passare da una schermata all'altra dovrebbe essere veloce. Se noti rallentamenti, riduci la visualizzazione con i filtri Conto o Tag ed esplora il portafoglio in blocchi più piccoli.
• I numeri che arrivano in ritardo non sono un blocco dell'app. Il motore di calcolo viene eseguito in background e non direttamente sulla pagina; pertanto, dopo un'importazione massiva o una modifica che interessa molte posizioni, vedrai i valori aggiornarsi progressivamente mentre l'app rimane utilizzabile. Una finestra che smette effettivamente di rispondere è un problema diverso — vedi Quando l'app si blocca o un progetto smette di rispondere sopra.

Verificare quale versione stai utilizzando

Capitally è una web app che si aggiorna automaticamente: non c'è nulla da scaricare. Quando viene rilasciata una nuova versione, appare un avviso che dice È disponibile una nuova versione - clicca per aggiornare e il numero della versione attuale si trova in fondo al menu in alto a destra.

Questo numero di versione è il primo elemento da confrontare quando due dispositivi mostrano dati discordanti, o quando una modifica al piano o una nuova funzionalità non risultano visibili. Se un dispositivo è rimasto indietro, ricarica la pagina. Se ricaricando non cambia nulla, rimuovi tutti i dati da quel dispositivo (Impostazioni → Privacy) ed effettua nuovamente l'accesso.

Problemi persistenti

Cattura l'errore prima di contattarci. Apri la console per sviluppatori del browser con Cmd + Option + J su macOS o Ctrl + Shift + J su Windows e Linux, quindi copia tutti i messaggi di errore visualizzati.

All'interno dell'app, nella parte inferiore del menu in alto a destra, è presente un piccolo link alle Informazioni diagnostiche, accanto a privacy, termini e al numero di versione. Si aprirà una finestra con:

• Scarica i log diagnostici: un report anonimizzato contenente identificatori interni, le tue azioni recenti e i dettagli di ogni errore riscontrato.
• Esporta progetto anonimo: una copia del progetto con nomi e valori randomizzati, utile per i problemi che dobbiamo riprodurre internamente.

Gli errori mostrati nell'app hanno anche un piccolo pulsante copia accanto, che permette di copiare tutti i dettagli dell'errore.

Invia quanto raccolto a support@mycapitally.com con una descrizione dei passaggi che causano il problema. Richiedere assistenza descrive l'intera gamma di strumenti diagnostici.