Articolo: La programmazione - le classi per la gestione documentale.
Introduzione:
Di seguito si riportano gli oggetti, le proprietà ed i metodi frequentemente utilizzati nella programmazione con filenet.
Per la gestione dei file
Classe Neighborhood:
Oggetto: Neighborhood: Gestisce tutte le librerie installate sulla workstation, per esempio indica qual’è la libreria di default. Da notare che ogni client è configurata in modo da avere una o più librerie.
Proprietà: library: Visualizza i nomi delle librerie installate sulla workstation.
Classe Library:
Oggetto: Library: E’ l’oggetto che contiene i vari documenti, essi vengono memorizzati nel database FileNet.
Proprietà: Label: La proprietà label restituisce il nome delle librerie.
Proprietà: SystemType: Identifica il tipo di sistema della libreria in cui si sta lavorando. Il tipo in cui è formato tale oggetto.
Proprietà: Name: Permette di impostare o ricavare il nome della libreria
Metodo: GetState: Il metodo GetState restituisce un valore booleana in riferimento allo stato di connessione sulla propria macchiana (utenza) con il database filenet.
Esso è seguito da una costante, per esempio per sapere se siamo già loggati bisogna usare la constante idmLibraryLoggedOn la quale restituisce true se siamo già connessi altrimenti false.
Metodo: Logon: Il metodo Logon, permette di autenticarsi passandogli come valore il nome utente, e la password inoltre tramite la idmLogonOptNoUI vietiamo al sistema fileNet di visualizzare la maschera di login, se invece la vogliamo visualizzare useremo la constante, idmLogonOptWithUI.
Metodo: GetObject Il metodo restituisce un singolo oggetto a secondo il tipo di creazione.
se viene utilizzata la costante idmObjTypeDocument seguita dal numero id del file questa ritorna un oggetto documento di quell’id.
SE è utilizzata la queue restituisce una coda.
Classe Document:
Oggetto: Document: Quest’oggetto ha il compito di manipolare gli oggetti (documenti) che si trovano o si creano nel database FileNet.
Proprietà: Properties: (Nome_Campo) Questa proprietà settandola con il nome del campo che si vuole gestire, restituisce un insieme di proprietà di quel campo, come per esempio value ossia il valore. Essa serve anche per assegnare un valore al documento che si sta creando.
Metodo:CreateObject: (Tipo di oggetto, Classe). Questo metodo crea un nuovo oggetto, inserendo un valore per tipo di oggetto, ossia che oggetto si vuole creare per esempio document, è la classe dove creare questo oggetto.
Metodo: SaveNew: (nome_Files). Il metodo SaveNew salva uno o più file nel database fileNEt. Come valore si può passare un array dei file o un solo file, naturalmente indicando il percorso e nome del file.
Per la gestione delle code:
Classe Queue:
Oggetto: QUEUE: Quest’oggetto ha il compito di registrare e visualizzare i dati che si vogliono salvare sul database FileNet.
Oggetto: QueueQuerySpecification. L’oggetto QueueQuerySpecification ha il compito di effettuare delle ricerche secondo i parametri che vengono indicati.
Proprietà. CheckUser:( true/false) La proprietà checkuser ha il compito di restituire o impostare un flag per l’accesso di sicurezza al sistema FileNEt nel user/group. Impostato.
Proprietà: EvenIfDelayed (true/false) Questa proprietà restituisce o imposta un flag per ricavare le informazioni sull’inserimento delle varie queue ossia code.
Proprietà: Incomplete (Costanti)Questa proprietà restituisce o imposta un valore in base allo stato della ricerca, i valori che si possono impostare sono:
idmIncompleteNotOK = non ritorna nessuna coda se c’è qualche entrys incompleto
idmIncompleteOK = ritorna tutti entry
idmIncompleteOnly = ritorna solo gli entry incompleti
Proprietà: Status: (Costanti) Questa proprietà restituisce gli entry in base allo stato ossia se sono bloccati (lock) o No.
I valori sono:
idmBusyNotOK = Restituisce solo i entry non bloccati (lock)
idmBusyOK = Restituisce tutti gli entry anche se sono bloccati
idmBusyOnly = Restituisce gli entry bloccati.
Classe QueueEntry:
Oggetto: QueueEntry: L’oggetto QueueEntry permette l’inserimento di nuove code.
Proprietà: Value: Assegna o restituisce un valore alla proprietà della coda.
Metodo:Insert: Inserisce una nuova coda.
Classe QueueBrowseSet:
Oggetto: QueueBrowseSet: l’oggetto QueueBrowseSet contiene i risultati della ricerca.
Proprietà: RecordCount: Restituisce il numero totale del risultato della query effettuata.
Proprietà: Entry: Restituisce una riga dell’oggetto queuentry, in particolare, della coda
Proprietà: Properties: Contiene un insieme di proprietà dell’oggetto queuentry
Proprietà: value: Restituisce o imposta il valore della proprietà.
Proprietà: Filters:(Nome_Campo) : restituisce uno o più valori qualora la condizione di ricerca sia valida.
Conclusioni
Lo scopo di questo articolo è quello di introdurre il lettore alla conoscenza delle classi, metodi e proprietà messe a disposizione da filenet per la gestione documentale.
Nel prossimo articolo vedremo come utilizzare tali classi, nella gestione dei documenti.
I siti web di riferimento:
http://www.filenet.com/Italiano/index.asp Italia
http://www.filenetinfo.com/mk/get/feis_ita_reg Per richiedere gratuitamente il cd "FileNet is Essential"
http://www.filenet.com/ (Inglese)