Differenze tra le versioni di "Metadata"

Versione attuale delle 21:03, 9 nov 2009

Formato del file metadata

Il file del metadata deve essere informato csv (comma separated values), con il punto e vergola ';' come separatore tra i campi, i campi di testo devono essere racchiusi tra virgolette '"'

Colonne del metadata

Il nuovo sistema di importazione acquisisce i campi del database in cui i dati devono essere inseriti direttamente dal metadata; di seguito riportiamo i campi che possono essere presenti nel metadata, in grassetto i campi obbligatori, in corsivo i campi del database, ovviamente in grassetto corsivo i campi del database obbligatori e in grassetto e basta i campi obbligatori, ma che non hanno dei corrispettivi nel database:

code: è il codice della foto, il sistema controlla che il valore immesso inizi con "SIS-"
keywords: elenco delle parole chiave che descrivono la foto
description: breve descrizione della foto
copyright: credit della foto, la convenzione per la SIS è (C) SIS Images/<agenzia>/<fotografo>
orientation: orientamento della foto il sistema se lo calcola a partire dalle dimensioni delle immagini, viene inserito automaticamente
inDate: data di inserimetno dell'immegine, viene inserito automaticamente
modDate: data dell'utlima modifica dell'immagine, viene inserito automaticamente
notes: eventuali note legate all'immagine
availability: tipo di disponibilità dell'immagine: può essere "Tradizionale" o "RoyaltyFree"
availNotes: note legate alla disponibilità, per esempio se una foto è disponibile solo per uso editoriale o non è disponibile per alcuni paesi
availDays: numero di giorni entro cui la foto può essere disponibile
model_release: il modello ha rilasciato il permesso di utilizzo
property_Release: la proprietà ha rilasciato il permesso di utilizzo
price_ID: identificativo del prezzo nella tabella dei prezzi
price_txt: (obsoleto, non utilizzare) descrizione del prezzo, adesso la descrizione si mette nella tabella dei prezzi
photographer: fotografo
agency: agenzia
collection: collezione, si usa solo per le collezioni di CD (es. Royalty Free)
category: categoria, la cartella in cui l'immagine è memorizzata
resolutions: risoluzioni disponibili per un'immagine in alta vale "a:A4,c:A5,b:A6,w:A6"
old_filename: nome del file del fornitore, serve per recuperare il file dalla cartella di origine

Le colonne possono essere in ordine sparso e il sistema mette i dati al posto giusto lo stesso. In alcuni casi sono possibili il nome delle colonne non sia troppo rigido.

Controlli sui campi

Il sistema fa un buon numero di controlli e correzioni sui campi, eccone alcuni.

A tutti i campi vengono tolti gli spazi iniziali e finali (trim).

I campi che hanno un underscore "_" nel nome possono avere anche uno spazio al suo posto (es. "model_release" è equivalente a "model release").

code

Deve iniziare per SIS-.

keywords

Questo campo può chiamarsi così oppure anche tags.

Separa le parole chiave con virgola e spazio.

ATTENZIONE: le parole chiave DEVONO essere separate da virgola, il sistema NON fa questo controllo

description

Questo campo può chiamarsi così oppure anche caption.

copyright

Controlla che inizi con (c) SIS.

availability

Controlla che sia Tradizionale o RoyaltyFree

availNotes

Questo campo può chiamarsi così oppure anche restrictions.

model_release e property_release

Questo campo può essere vuoto, se non si hanno informazioni sui release.

Il sistema controlla se è "N/A" o "NA", in questo caso viene considerato un campo vuoto.

Poi se il campo inizia con "N" viene impostato a "N" per "no".

In tutti gli altri casi viene impostato a "Y" per "Yes".

resolutions

Se non è presente se lo calcola in base ai file che trova; restituisce qualcosa del tipo "d:A3,a:A4,c:A5,b:A6,w:A6" a seconda delle dimensioni dell'immagine in archivio.

La codifica della risoluzione è definita in base alla dimensione del lato maggiore:

d: >3500px
a: 3500px
c: 1024px
b: 650px
w: 650px
t: 170px

Posizione e nome del file metadata

Il metadata si deve trovare nella cartella in cui si trovano le foto da importare e deve chiamarsi preferibilmente metadata.csv. Può chiamarsi anche in altro modo ma in questo caso il suo nome deve essere passato come parametro nello Statement di avvio.

Statement di avvio

php-cgi <site_root>/mod/imageArchive/classes/metadata_import.php -- path=<percorso della cartella da indicizzare> [metadata=<nome del file con il metadata>]

<percorso della cartella da indicizzare> è la cartella in cui si trovano le immagini da inserire nel Database, è obbligatorio

<nome del file con il metadata> è il nome del file del metadata, è opzionale: se non viene passato il sistema cerca "metadata.csv"

Roll Back e gestione delle righe con errori

Ha un sistema di roll back veramente buono: registra tutte le operazioni che fa e prepara un file per annullarle, nel caso di errore con quel file è possibile cancellare tutto quello che si è fatto. I files di rollback sono

rollback_DB_YYYYmmddHHiiss.sql.log : contiene i comandi per cancellare i record dal database
rollback_FS_YYYYmmddHHiiss.sh.log : contiene i comandi per cancellare i files dal filesiystem
bugged_YYYYmmddHHiiss.csv.log : è un file simile al metadata, contiene le righe che per qualche ragione non sono state caricate, se tutte le righe sono state caricate, non viene creato, è possibile passarlo come metadata dopo aver corretto gli errori che ne hanno impedito il caricamento, tale motivo è inserito nell'ultima colonna del file

YYYYmmddHHiiss è il datetime dell'istante in cui viene creato il file

@@ Riga 1: / Riga 1: @@
+== Formato del file metadata ==
+Il file del metadata deve essere informato csv (comma separated values), con il punto e vergola ';' come separatore tra i campi, i campi di testo devono essere racchiusi tra virgolette '"'
-== Formato del file metadata ==
+== Colonne del metadata ==
-Il nuovo sistema di importazione acquisisce i campi del database in cui i dati devono essere inseriti direttamente dal metadata; di seguito riportiamo i campi che possono essere presenti nel metadata, in '''grassetto''' i campi obbligatori, in ''corsivo'' i campi del database, ovviamente in '''''grassetto corsivo''''' i campi del database abbligatori e in '''grassetto''' e basta i campi obbligatori, ma che non hanno dei corrispettivi nel database:
+Il nuovo sistema di importazione acquisisce i campi del database in cui i dati devono essere inseriti direttamente dal metadata; di seguito riportiamo i campi che possono essere presenti nel metadata, in '''grassetto''' i campi obbligatori, in ''corsivo'' i campi del database, ovviamente in '''''grassetto corsivo''''' i campi del database obbligatori e in '''grassetto''' e basta i campi obbligatori, ma che non hanno dei corrispettivi nel database:
 * '''''code''''': è il codice della foto, il sistema controlla che il valore immesso inizi con "SIS-"
 * '''''keywords''''': elenco delle parole chiave che descrivono la foto
 * ''description'': breve descrizione della foto
 * '''''copyright''''': credit della foto, la convenzione per la SIS è (C) SIS Images/<agenzia>/<fotografo>
-* ''orientation'': orientamento della foto i lsitema se lo calcola a partire dalle dimensioni delle immagini
+* ''orientation'': orientamento della foto il sistema se lo calcola a partire dalle dimensioni delle immagini, viene inserito automaticamente
-* ''inDate'': data di inserimetno dell'immegine
+* ''inDate'': data di inserimetno dell'immegine, viene inserito automaticamente
-* ''modDate'': data dell'utlima modifica dell'immagine
+* ''modDate'': data dell'utlima modifica dell'immagine, viene inserito automaticamente
 * ''notes'': eventuali note legate all'immagine
 * '''''availability''''': tipo di disponibilità dell'immagine: può essere "Tradizionale" o "RoyaltyFree"
@@ Riga 22: / Riga 25: @@
 * ''collection'': collezione, si usa solo per le collezioni di CD (es. Royalty Free)
 * '''''category''''': categoria, la cartella in cui l'immagine è memorizzata
-* '''''resolutions''''': risoluzioni disponibili per un'immagine in alta vale "a:A4,c:A5,b:A6,w:A6"
+* ''resolutions'': risoluzioni disponibili per un'immagine in alta vale "a:A4,c:A5,b:A6,w:A6"
 * '''old_filename''': nome del file del fornitore, serve per recuperare il file dalla cartella di origine
 Le colonne possono essere in ordine sparso e il sistema mette i dati al posto giusto lo stesso.
 In alcuni casi sono possibili il nome delle colonne non sia troppo rigido.
+== Controlli sui campi ==
+Il sistema fa un buon numero di controlli e correzioni sui campi, eccone alcuni.
+A tutti i campi vengono tolti gli spazi iniziali e finali (trim).
+I campi che hanno un underscore "_" nel nome possono avere anche uno spazio al suo posto (es. "model_release" è equivalente a "model release").
+=== code ===
+Deve iniziare per '''SIS-'''.
+=== category ===
+Se c'è una barra "/" iniziale o finale viene rimossa.
+Eventuali spazi tra la barra "/" e la categoria vengono rimossi.
+La categoria viene resa tutta maiuscola.
+=== keywords ===
+Questo campo può chiamarsi così oppure anche '''tags'''.
+Separa le parole chiave con virgola e spazio.
+'''ATTENZIONE''': le parole chiave DEVONO essere separate da virgola, il sistema NON fa questo controllo
+=== description ===
+Questo campo può chiamarsi così oppure anche '''caption'''.
+=== copyright ===
+Controlla che inizi con '''(c) SIS'''.
+=== availability ===
+Controlla che sia '''Tradizionale''' o '''RoyaltyFree'''
+=== availNotes===
+Questo campo può chiamarsi così oppure anche '''restrictions'''.
+=== model_release e property_release ===
+Questo campo può essere vuoto, se non si hanno informazioni sui release.
+Il sistema controlla se è "N/A" o "NA", in questo caso viene considerato un campo vuoto.
+Poi se il campo inizia con "N" viene impostato a "N" per "no".
+In tutti gli altri casi viene impostato a "Y" per "Yes".
+=== resolutions===
+Se non è presente se lo calcola in base ai file che trova; restituisce qualcosa del tipo "d:A3,a:A4,c:A5,b:A6,w:A6" a seconda delle dimensioni dell'immagine in archivio.
+La codifica della risoluzione è definita in base alla dimensione del lato maggiore:
+* d: >3500px
+* a: 3500px
+* c: 1024px
+* b: 650px
+* w: 650px
+* t: 170px
 == Posizione e nome del file metadata ==
-Il metadata si deve trovare nella cartella in cui si trovano le foto da importare e deve chiamarsi preferibilmente ''metadata.csv''. Può chiamarsi anche in altro modo ma in questo caso il suo nome deve essere passato come parametro nello [[#Statement di avvio]].
+Il metadata si deve trovare nella cartella in cui si trovano le foto da importare e deve chiamarsi preferibilmente ''metadata.csv''. Può chiamarsi anche in altro modo ma in questo caso il suo nome deve essere passato come parametro nello [[#Statement di avvio|Statement di avvio]].
 == Statement di avvio ==
-  php-cgi /srv/www/weblulu1/mod/imageArchive/classes/metadata_import.php -- path=<percorso della cartella da indicizzare> [metadata=<nome del file con il metadata>]
+  php-cgi <site_root>/mod/imageArchive/classes/metadata_import.php -- path=<percorso della cartella da indicizzare> [metadata=<nome del file con il metadata>]
+<percorso della cartella da indicizzare> è la cartella  in cui si trovano le immagini da inserire nel Database, è obbligatorio
-== Sistema di Roll Back ==
+<nome del file con il metadata> è il nome del file del metadata, è opzionale: se non viene passato il sistema cerca "metadata.csv"
+== Roll Back e gestione delle righe con errori ==
 Ha un sistema di roll back veramente buono: registra tutte le operazioni che fa e prepara un file per annullarle, nel caso di errore con quel file è possibile cancellare tutto quello che si è fatto.
+I files di rollback sono
+* rollback_DB_YYYYmmddHHiiss.sql.log : contiene i comandi per cancellare i record dal database
+* rollback_FS_YYYYmmddHHiiss.sh.log : contiene i comandi per cancellare i files dal filesiystem
+* bugged_YYYYmmddHHiiss.csv.log : è un file simile al metadata, contiene le righe che per qualche ragione non sono state caricate, se tutte le righe sono state caricate, non viene creato, è possibile passarlo come metadata dopo aver corretto gli errori che ne hanno impedito il caricamento, tale motivo è inserito nell'ultima colonna del file
+YYYYmmddHHiiss è il datetime dell'istante in cui viene creato il file
 [[Category:SIS Images]]