+ Rispondi
Risultati da 1 a 6 su 6

Discussione: Documentare Xml

  1. #1

    Iscritto dal
    13/12/2011
    Località
    Salento!
    Messaggi
    6,825

    Documentare Xml

    Ciao a tutti.
    Mi hanno affidato gentilmente (leggasi infilato nel baugigi) documentare degli xml.
    Di questi xml ho solo xml, nada xsd, etc. Ho ricavato attraverso dei tool online degli xsd che sembrano abbastanza affidabili.
    Ora mi serve un modo per documentarli. Un qualche tool che mi semplifichi la vita. Parlo di xml molto molto corposi ed annidati.
    Conoscete qualcosa? (non posso postare esempi, nda)

  2. #2

    Iscritto dal
    26/05/2011
    Località
    Lugano, Svizzera
    Messaggi
    21,453
    Io faccio così di solito, nel file dello schema aggiungo tag xs:annotation e xs:documentation per tutti gli elements da documentare.

    La putènza è devastante perché una volta che hai la documentazione direttamente nello schema e non in giro chissà dove dispersa, uso due diversi approcci:

    xs3p Overview se mi serve in xhtml da usare... boh, ovunque

    XML Schema Documenter - Home se serve qualcosa di un po' più standalone



    Certo a leggere il tuo post ti servirebbe piuttosto qualcosa per aggiungere eventualmente xs:annotation e xs:documentation... mmm...

    Mi chiedo quasi se non fai prima a scriverti un programmino in java sfruttando parser xml già pronti.
    Verità #10 | Viva l'unto, reale o presunto

  3. #3

    Iscritto dal
    13/12/2011
    Località
    Salento!
    Messaggi
    6,825
    xs3p l'avevo visto.
    Si il mio problema è che l'xsd che ho è ricavato in automatico. Dovrei quindi comunque mettere mano al xsd originale?
    Mi toccherà farmi il programma mannaggia la miseria lo vogliono per ieri
    xsd doc l'hai usato? L'ho provato ieri e non ci sono saltato fuori

  4. #4

    Iscritto dal
    26/05/2011
    Località
    Lugano, Svizzera
    Messaggi
    21,453


    Beh dunque, a me piace l'idea di avere la documentazione insieme allo schema ma per le cose ultra-complesse è un problema farlo in un secondo tempo, ci impieghi un anno intero ed esci scemo.
    Anche la descrizione, se deve essere particolarmente complicata o formattata, o con immagini o chissà che, è ben più difficile.

    Ma come sarà usata poi, e da chi? Perché ho visto gente fare la documentazione in file di word (no comment) e cercare con control F

    La più bella che ho visto era su una intranet, avevano fatto un database con i nomi degli elementi e una descrizione, poi era un sito in php che faceva usare il tutto.
    Verità #10 | Viva l'unto, reale o presunto

  5. #5

    Iscritto dal
    13/12/2011
    Località
    Salento!
    Messaggi
    6,825
    Quote Originariamente inviato da MainThink Visualizza il messaggio


    Beh dunque, a me piace l'idea di avere la documentazione insieme allo schema ma per le cose ultra-complesse è un problema farlo in un secondo tempo, ci impieghi un anno intero ed esci scemo.
    Anche la descrizione, se deve essere particolarmente complicata o formattata, o con immagini o chissà che, è ben più difficile.

    Ma come sarà usata poi, e da chi? Perché ho visto gente fare la documentazione in file di word (no comment) e cercare con control F

    La più bella che ho visto era su una intranet, avevano fatto un database con i nomi degli elementi e una descrizione, poi era un sito in php che faceva usare il tutto.
    Chi la usa leggendo il mio documento deve essere in grado di migrare i dati da questo xml ad un database (che io non posso conoscere ) devono quindi capire dal mio doc come mappare i dati, come interpretarli etc

  6. #6

    Iscritto dal
    26/05/2011
    Località
    Lugano, Svizzera
    Messaggi
    21,453
    ah shit, per la serie il caso peggiore.

    quindi un xml con dentro dati che devono finire in un database secondo uno "schema" (diciamo così) spiegato elemento per elemento, o comunque che non si inventano da soli... mmm.

    Eppure la xs:annotation resta ancora la migliore, perché puoi spiegare con precisione cosa è cosa e poi potrebbe anche ricadere su altri l'onere di "farci qualcosa" con gli xml annotati.

    Poi che questa gente apra il file dello schema o utilizzi un programma per guardare i dati in forma più friendly... sta a loro deciderlo.

    Sennò ti toccherebbe eventualmente importare tutti i dati in access (funziona piuttosto bene) e aggiungere una colonna descrizione e riesportare se necessario... access o excel che sia, è un casino.
    Verità #10 | Viva l'unto, reale o presunto


 

Autorizzazioni

  • Non puoi iniziare nuove discussioni
  • Non puoi rispondere alle discussioni
  • Non puoi inserire allegati
  • Non puoi modificare i tuoi messaggi
Powered by vBulletin™ Version 4.1.5
Copyright © 2019 vBulletin Solutions, Inc. All rights reserved
SEO by vBSEO ©2011, Crawlability, Inc.
Fuso orario: UTC +1, sono le 08:39.