In questa pagina
Il modello di progetto map.army — Progetti, livelli, simboli
La maggior parte delle pagine di questo sito descrive un pezzo del flusso di lavoro — posizionare un simbolo, esportare un livello, creare una condivisione. Questa pagina fa un passo indietro e mostra come questi pezzi si incastrano. Conoscere il modello in anticipo rende la lettura del resto della documentazione più chiara.
Tre concetti, dall’alto verso il basso
map.army organizza una situazione tattica in tre concetti annidati:
| Concetto | Cos’è | Dove vive |
|---|---|---|
| Progetto (1) | La sessione di lavoro — la vista mappa corrente, l’insieme dei livelli aperti e le impostazioni dell’applicazione intorno ad essi. | Nel browser, mentre la scheda è aperta. L’app ospitata non memorizza nessuno stato per utente sul server. |
| Livello (2) | Un contenitore nominato per simboli e grafiche tattiche. Un progetto di solito ha diversi livelli (forze blu, forze rosse, linee di fase, …). | Salvato come file MilX (.milxlyz o .milxly) quando si esporta. |
| Simbolo / Grafica tattica (3) | Un singolo posizionamento MIL-STD-2525 su un livello: simbolo di unità, linea di fase, anello di portata, ecc., con la sua posizione, atteggiamento, stato e modificatori. | All’interno del livello a cui appartiene. |
La gerarchia è rigida: ogni simbolo appartiene esattamente a un livello; ogni livello appartiene al progetto corrente. Spostare un simbolo tra livelli è supportato (vedere Simboli sui livelli — Spostare simboli tra livelli); un simbolo che non appartiene ad alcun livello non è uno stato che l’applicazione può rappresentare.
Il progetto è la scheda del browser aperta
Non esiste un menu “Nuovo progetto” o “Apri progetto”. Il progetto è implicito — è ciò che si ha sullo schermo in questo momento: la vista mappa, la mappa di base attiva, l’impostazione della griglia di coordinate, i livelli aperti e i simboli su di essi. Chiudere la scheda senza esportare e il progetto è perso.
Nel diagramma: 1 chiudere la scheda senza esportare fa perdere il progetto; 2 l’esportazione in un file .milxlyz lo conserva.
Due conseguenze pratiche:
- Salvare esportando. L’azione supportata “salva il tuo lavoro” è Esporta livelli →
.milxlyz. Trattarla come un comando Salva con nome… in un’applicazione desktop. Vedere Esportare i livelli. - Le impostazioni persistono; il lavoro no. Le preferenze memorizzate nel browser (lingua, unità, formato simbolo predefinito) sopravvivono a un ricaricamento. Il contenuto dei livelli non viene mai scritto nel browser storage, quindi non esiste uno «stato di cache» su cui sperare — ciò che l’applicazione può invece ricordare è un puntatore al punto da cui proveniva il lavoro. Vedere Persistenza della sessione di seguito.
I livelli sono MilX
Un livello in map.army è un livello MilX. L’applicazione li tratta in modo identico internamente ed esternamente — il file che si esporta (.milxlyz) è lo stesso contenuto che l’applicazione sta modificando. Per questo motivo la maggior parte delle pagine relative ai livelli parla di “livelli MilX” in modo intercambiabile con “livelli sovrapposti”.
Sono supportati anche due tipi di livelli non-MilX ma si comportano diversamente:
| Tipo di livello | Porta simbologia MilX? | Salvato in .milxlyz? |
|---|---|---|
| Livello MilX | Sì | Sì |
| Immagine sovrapposta | No — è un file immagine fissato a coordinate | No — map.army scrive un file di impostazioni chiamato come il file del livello, accanto a esso (Bern.png → Bern.png.json), vedi Importare livelli |
| Livello vettoriale | No — è geometria KML / GPX / GeoJSON / SHP | No — aggiungerlo di nuovo dopo un ricaricamento, a meno che non provenga da un indirizzo web |
Quando la documentazione dice “salvare un livello” senza qualificazione, intende un livello MilX.
Una condivisione esternalizza un progetto
Una Condivisione MilX è l’equivalente lato server di un .milxlyz esportato: il backend di gs-soft mantiene il contenuto MilX sotto un URL pubblico in modo che altri utenti possano aprirlo (sola lettura o modifica, a seconda del tipo di condivisione). Le immagini sovrapposte e i livelli vettoriali non viaggiano con una condivisione — viaggia solo la simbologia MilX.
Una condivisione è un modo per pubblicare il progetto esternamente; non è “il progetto stesso”. È possibile:
- Esportare un
.milxlyze non creare mai una condivisione — il lavoro rimane locale. (1) - Creare una condivisione e non esportare mai — il lavoro vive sui server di gs-soft sotto l’URL della condivisione. (2)
- Fare entrambe le cose — la condivisione è una copia pubblicata; il file locale è l’archivio. (3)
Vedere Come creare una condivisione per i tre tipi di condivisione (Sola lettura, Modifica e copia, Modifica e sovrascrivi).
Persistenza della sessione — cosa sopravvive a un ricaricamento
map.army conserva tre tipi diversi di cose, e si comportano in modo diverso. Sapere quale è quale è tutto ciò che serve.
Le impostazioni vengono conservate. (1) Lingua, unità, formato simbolo, vista mappa, i preferiti della galleria — tutto nel browser storage, tutto di nuovo disponibile dopo un ricaricamento.
Il lavoro no. (2) I simboli e i livelli che disegnate non vengono mai scritti nel browser storage. Non esiste salvataggio automatico né bozza locale: chiudete o ricaricate la scheda e il contenuto sparisce, a meno che non abbiate salvato un .milxlyz o non l’abbiate messo in una condivisione. Questa è la regola su cui pianificare.
Ciò che sta nel mezzo è un puntatore. (3) map.army non conserva il vostro lavoro, ma può conservare da dove proveniva, e poi offrirsi di recuperarlo di nuovo:
- L’ultima condivisione aperta. Il suo link viene ricordato, e al successivo avvio map.army chiede se caricare l’ultima MilX Share utilizzata. I livelli tornano dal server di condivisione, non dal browser. Se spuntate Non mostrare più questo messaggio su quella richiesta, l’app smette di chiedere e carica l’ultima condivisione automaticamente a ogni avvio — l’applicazione ve lo comunica, e offre di interrompere questo comportamento, in una notifica.
- Una cartella a cui avete concesso l’accesso. Se avete aggiunto livelli immagine o vettoriali scegliendo una directory di lavoro — offerta solo dove il browser fornisce il selettore di cartella del file system, il che oggi significa Chrome ed Edge su desktop — map.army ricorda quella cartella e al successivo avvio chiede “Vuoi ricaricare gli ultimi livelli immagine utilizzati?” (e lo stesso per i livelli vettoriali). Rispondete sì e i livelli tornano con la loro posizione, opacità, colore e visibilità. Rispondete no e l’app dimentica la cartella.
Nessuno dei due puntatori conserva un solo simbolo. Una condivisione viene recuperata di nuovo dal server; una cartella viene riletta dal vostro disco, con il vostro permesso.
| Elemento | Sopravvive al ricaricamento? |
|---|---|
| Impostazioni dell’applicazione (lingua, unità, formato simbolo) | Sì — conservate nel browser storage. |
| Livelli MilX che avete disegnato | No. Il contenuto dei livelli non viene mai memorizzato nel browser. Caricate di nuovo il vostro .milxlyz salvato. |
| Livelli MilX aperti da un link di condivisione | Il link viene ricordato: map.army offre di ricaricare la condivisione, e lo fa senza chiedere una volta che spuntate Non mostrare più questo messaggio. I livelli provengono dal server di condivisione. |
| Livello immagine o vettoriale da un singolo file | No — aggiungete di nuovo il file. |
| Livello immagine o vettoriale da una cartella concessa (dove esiste il selettore di cartella) | L’applicazione offre di ricaricarli, con posizione e stile. |
| Livello immagine o vettoriale da un indirizzo web | Sì — l’indirizzo viene ricordato e il contenuto recuperato di nuovo. Non mentre state lavorando dentro una condivisione, dove questo è sospeso. |
| L’indicatore “matita” del livello attivo | No. |
.milxlyz salvato che ricaricate, oppure da un link di condivisione, che la recupera di nuovo dal server di condivisione.La stessa situazione vista dal lato dei livelli è in Livelli MilX. La regola segue dalla tabella: esportate i vostri livelli MilX prima di chiudere la scheda, perché chiuderla li elimina.
Cosa questo modello non è
Alcune cose che map.army deliberatamente non fa, poiché la versione ospitata non ha stato per utente:
- Nessun elenco progetti per i file locali — non esiste un elenco dei file
.milxlyzche avete aperto, né un modo per riaprirne uno dall’interno dell’applicazione. (Una condivisione è diversa: l’ultima viene ricordata e riproposta — vedere sopra.) - Nessun salvataggio automatico su un server. La cache del browser è best-effort.
- Nessuno spazio di lavoro multi-progetto. Si lavora su un insieme di livelli alla volta. Per cambiare progetto, esportare il lavoro corrente, poi importare l’altro
.milxlyz.
L’offerta professionale (Gratuito vs Pro) rimuove alcuni di questi vincoli — account utente, progetti lato server, accesso basato sui ruoli — ma si tratta di distribuzioni adattate a progetti, non parte della demo gratuita ospitata.
Ultimo aggiornamento: