Home > Riferimento > Funzioni > Funzioni Get

Funzioni Get

Utilizzando le funzioni di ricavo (Get) negli script per il controllo e la prevenzione degli errori è possibile reperire informazioni sullo stato del file di database o degli elementi al suo interno, o su un'azione in corso di esecuzione.

Molte funzioni Get riportano informazioni che variano regolarmente. Ad esempio, quando la funzione Get(Ora corrente) viene messa in un Campo Calcolo memorizzato, l'ora si aggiornerà solo quando verrà creato un nuovo record. Se il calcolo ha altri campi al suo interno, ma il risultato del calcolo restituisce sempre l'ora corrente, allora il risultato del calcolo memorizzato si aggiornerà solo quando quegli altri campi saranno modificati nel record corrente. Se uno di questi calcoli non è memorizzato, l'ora si aggiornerà come desiderato. Per motivi di prestazioni, rendere un campo Calcolo non memorizzato non è sempre l'idea migliore. Le funzioni Get sono utilizzate soprattutto in uno script in cui le informazioni di stato della funzione Get sono aggiornate nel momento in cui il calcolo viene eseguito.

Per accedere alla lista di funzioni di ricavo, nella finestra di dialogo Specifica il calcolo, scegliere Mostra: tutte le funzioni per tipo oppure Mostra: Funzioni di ricavo. Quando si sceglie Mostra: tutte le funzioni per nome, si vede solo Get ( flag ).

Nota  Per informazioni su come le funzioni eseguono valutazioni sull'host in modo diverso rispetto al client, consultare la Knowledge Base FileMaker disponibile sul sito http://filemaker-it.custhelp.com.

"Per maggiori dettagli, fare clic sul nome di una funzione."

 

Funzione	Restituisce
Get ( PrivilegiEstesiAccount )	Una lista di parole chiave per i privilegi estesi attivati, separate da ritorni a capo. La lista restituita si basa sull'account utilizzato per aprire il file di database.
Get ( NomeAccount )	Il nome account autenticato utilizzato per il file di database attivo.
Get ( NomeSetPrivilegiAccount )	Il nome del set di privilegi usato dall'account per aprire il file di database.
Get (ContenutoCampoAttivo )	I contenuti del campo attivo.
Get ( NomeCampoAttivo )	Il nome del campo attivo.
Get ( NomeTabellaCampoAttivo )	Il nome della tabella che contiene il campo attivo (il campo su cui è posizionato il cursore).
Get ( NomeOggettoFormatoAttivo )	Il nome dell'oggetto del formato nella finestra attiva di calcolo.
Get ( TastiModificatoreAttivo )	Un numero che rappresenta i tasti di modifica (ad esempio Maiusc) premuti.
Get ( NumeroRigaPortaleAttiva )	Il numero della riga del portale attiva.
Get ( NumeroRipetizioneAttiva )	Un numero che rappresenta la ripetizione attiva di un campo multiplo (la ripetizione su cui è posizionato il cursore).
Get ( DimensioniSelezioneAttiva )	Un numero che rappresenta quanti caratteri sono selezionati.
Get ( InizioSelezioneAttiva )	Un numero che rappresenta il carattere di inizio del testo selezionato.
Get ( ConsentiStatoInterruzione )	Un valore booleano che rappresenta lo stato corrente dell'istruzione di script Consenti interruzione utente.
Get ( ConsentiStatoBarraFormattazione )	Un valore booleano che indica se le barre degli strumenti sono visibili.
Get ( LinguaApplicazione )	Testo che rappresenta la lingua corrente dell'applicazione (ad esempio Italiano).
Get ( VersioneApplicazione )	Testo che rappresenta la versione dell'applicazione FileMaker.
Get ( NumeroRipetizioneCalcolo )	Un numero che rappresenta la ripetizione del campo Calcolo che si sta calcolando.
Get ( StatoConnessione )	Un numero che rappresenta lo stato di sicurezza della connessione di rete per il file corrente.
Get ( DataCorrente )	La data corrente in base al calendario di sistema.
Get ( PrivilegiEstesiCorrenti )	Una lista di parole chiave per i privilegi estesi abilitati dell'account che vengono utilizzati per valutare il calcolo.
Get ( IndicatoreDataOraHostCorrente )	La data e l'ora corrente dell'host (approssimata al secondo più vicino) in base all'orologio di sistema).
Get ( NomeSetPrivilegiCorrente )	Il nome del set di privilegi utilizzato per valutare questo calcolo nel database.
Get ( OraCorrente )	L'ora corrente (approssimata al secondo più vicino) secondo l'orologio di sistema.
Get ( IndicatoreDataOraCorrente )	La data e l'ora corrente (approssimata al secondo più vicino) in base all'orologio di sistema.
Get ( NomeGruppoMenuPersonalizzato )	Il nome del set di menu personalizzato attivo.
Get ( PercorsoDesktop )	Il percorso per la cartella sul desktop per l'utente corrente.
Get ( PercorsoDocument i)	Il percorso per la cartella Documenti per l'utente corrente.
Get ( ElencoPercorsoDocumenti )	Una lista di tutti i file e le cartelle contenuti nella cartella Documenti restituita dalla funzione Get(PercorsoDocumenti).
Get ( StatoCatturaErrori )	Un valore booleano che rappresenta lo stato dell'istruzione di script Imposta cattura errori.
Get ( PercorsoFileMaker )	Il percorso per la cartella della copia di FileMaker Pro in esecuzione.
Get ( nomeFile )	Il nome del file di database correntemente attivo.
Get ( PercorsoFile )	Il percorso completo che indica la posizione del file.
Get ( DimensioniFile )	Le dimensioni (in byte) del file di database correntemente attivo.
Get ( ContoTrovati )	Un numero che rappresenta il numero di record nel gruppo trovato corrente.
Get ( ColoreAltoContrasto )	Il nome dello schema del colore ad alto contrasto predefinito corrente se nella finestra di dialogo Accesso facilitato del sistema operativo Windows è selezionato Usa Contrasto elevato.
Get ( StatoAltoContrasto )	Un valore booleano che rappresenta lo stato della casella di controllo Usa Contrasto elevato nella finestra di dialogo Accesso facilitato.
Get ( VersioneApplicazioneHost )	La versione di FileMaker Pro o FileMaker Server in esecuzione sul computer che ospita il database corrente.
Get ( IndirizzoIPHost )	L'indirizzo IP della macchina host per il database corrente.
Get ( NomeHost )	Il nome registrato nel computer che funge da host per il file di database.
Get ( PluginFMInstallati )	L'intervallo denominato, il numero di versione (se disponibile) e lo stato di attivazione dei plug-in installati.
Get ( UltimoErrore )	Un numero che rappresenta l'errore, se presente, nell'ultima istruzione di script eseguita.
Get ( SceltaUltimoMessaggio )	Un numero corrispondente al pulsante su cui si fa clic in un messaggio di avviso visualizzato dall'istruzione di script Mostra finestra personalizz.
Get ( UltimoErroreODBC )	Una stringa che mostra lo stato dell'errore pubblicato dagli standard ODBC, in base agli standard ISO/IEF.
Get ( AccessoFormato )	Un numero che corrisponde ai privilegi di accesso del formato assegnati attraverso la finestra di dialogo Gestisci sicurezza.
Get ( ContoFormati )	Il numero totale di formati nel file di database.
Get ( nomeFormato )	Il nome del formato correntemente visualizzato.
Get ( NumeroFormato )	Il numero del formato correntemente visualizzato, in base alla lista nella finestra di dialogo Gestisci formati.
Get ( NomeTabellaFormato )	Il nome della tabella da cui il formato sta visualizzando record.
Get ( StatoVistaFormato )	Informazioni sul modo di visualizzazione corrente del file di database.
Get ( StatoMultiUtente )	Un numero che rappresenta lo stato multiutente corrente del file di database.
Get ( ProtocolloRete )	Il nome del protocollo di rete che FileMaker Pro sta utilizzando sulla macchina.
Get ( NumeroPagina )	Un numero che rappresenta la pagina correntemente in fase di stampa o visualizzata in anteprima.
Get ( IDPersistente )	Testo che rappresenta un identificativo univoco del computer o del dispositivo sul quale FileMaker è in esecuzione.
Get ( PercorsoPreferenze )	Il percorso per la cartella preferenze per l'utente corrente.
Get ( NomeStampante )	Una stringa che identifica il nome della stampante predefinita.
Get ( TestoRicercaRapida )	Il testo che è stato inserito nella casella Ricerca rapida.
Get ( AccessoRecord )	Un numero che indica i privilegi di accesso del record corrente.
Get ( IDRecord )	L'ID univoco del record corrente.
Get ( ContoModificaRecord )	Il numero totale di modifiche del record corrente che è stato salvato.
Get ( NumeroRecord )	Il numero del record corrente nel gruppo trovato corrente.
Get ( ConteggioRecordAperti )	Il numero totale di record aperti nel gruppo trovato corrente che non sono stati ancora salvati.
Get ( StatoRecordAperti )	Un numero che rappresenta lo stato del record corrente.
Get ( ContoRichieste )	Il numero totale di richieste di ricerca definito correntemente per la tabella corrente.
Get ( StatoOmettiRichiesta )	Un valore booleano che rappresenta lo stato della casella di controllo Ometti nel modo Trova.
Get ( ProfonditàSchermo )	Il numero di bit necessari per rappresentare il colore o il livello di grigio di un pixel sullo schermo principale.
Get ( AltezzaSchermo )	Il numero di pixel visualizzati verticalmente sullo schermo in cui è aperta la finestra del file corrente.
Get ( LarghezzaSchermo )	Il numero di pixel visualizzati orizzontalmente sullo schermo in cui è aperta la finestra del file corrente.
Get ( NomeScript )	Il nome dello script correntemente in esecuzione (o in pausa).
Get ( ParametroScript )	Il parametro dello script passato allo script corrente.
Get ( RisultatoScript )	Il risultato di uno script da un subscript eseguito.
Get ( StatoOrdinamento )	Un valore numerico che rappresenta l'ordinamento corrente.
Get ( AreaStatoCorrente )	Un numero che indica se la barra degli strumenti è nascosta, visibile, visibile e bloccata o nascosta e bloccata.
Get ( DriveSistema )	La lettera dell'unità (Windows) o il nome volume (Mac OS) in cui si trova il sistema operativo in esecuzione.
Get ( IndirizzoIPSistema )	Gli indirizzi IP di tutte le macchine connesse alla scheda NIC (Network Interface Controller).
Get ( LinguaSistema )	La lingua attualmente impostata sul sistema corrente.
Get ( IndirizzoNICSistema )	Gli indirizzi hardware di tutte le schede Network Interface Controller collegate alla macchina.
Get ( PiattaformaSistema )	Un numero che indica la piattaforma corrente.
Get ( VersioneSistema )	La versione del sistema operativo della macchina su cui si sta eseguendo la funzione.
Get ( PercorsoTemporaneo )	Il percorso della cartella temporanea dell'utente attuale utilizzata da FileMaker Pro.
Get ( RighelloTestoVisibile )	Un valore booleano che indica se il righello del testo è visibile o no.
Get ( ContoRecordTotale )	Il numero totale di record nella tabella corrente.
Get ( TriggerPannelloSchedaCorrente )	Il numero di indice e il nome oggetto del pannello strutture a schede da cui partire quando si attiva il trigger di script SuCambioScheda.
Get ( PressionetastoTrigger )	Una stringa contenente i caratteri che attivavano un trigger di script SuPressioneTastoOggetto o SuPressioneTastoFormato.
Get ( ChiaviModificaTrigger )	Lo stato dei tasti di modifica dopo l'attivazione di un trigger di script.
Get ( TriggerPannelloSchedaTarget )	Il numero di indice e il nome oggetto del pannello strutture a schede da cui partire quando si attiva il trigger di script SuCambioScheda.
Get ( ContoUtenti )	Il numero di utenti che accedono correntemente al file.
Get ( NomeUtente )	Il nome dell'utente FileMaker Pro, come specificato nella scheda Generale della finestra di dialogo Preferenze.
Get ( StatoUsaFormatiSistema )	Un valore booleano che rappresenta lo stato del comando di menu Usa formattazioni di sistema.
Get ( IDUU )	Testo che rappresenta un identificativo unico universale (IDUU).
Get ( AltezzaContenutoFinestra )	Un numero che rappresenta l'altezza, in pixel, dell'area del contenuto.
Get ( LarghezzaContenutoFinestra )	Un numero che rappresenta la larghezza, in pixel, dell'area del contenuto.
Get ( AltezzaDesktopFinestra )	Un numero che rappresenta l'altezza, in pixel, dello spazio sul desktop.
Get ( LarghezzaDesktopFinestra )	Un numero che rappresenta la larghezza, in pixel, dello spazio sul desktop.
Get ( AltezzaFinestra )	Un numero che indica l'altezza, in pixel, della finestra corrente del file in cui è definito il calcolo.
Get ( SinistraFinestra )	Un numero che rappresenta la distanza orizzontale, in pixel, del margine esterno della finestra corrente rispetto al margine più a sinistra della schermata.
Get ( ModoFinestra )	Un numero che indica se FileMaker Pro si trova in Modo Usa, Modo Trova, Modo Anteprima o se sta stampando al momento della valutazione della funzione.
Get ( NomeFinestra )	Il nome della finestra corrente del file in cui è definito il calcolo.
Get ( StileFinestra )	Un numero indicante se la finestra in alto più frequentemente aperta è una finestra documento, una finestra documento mobile o una finestra di dialogo.
Get ( CimaFinestra )	Un numero che rappresenta la distanza verticale, in pixel, del margine esterno della finestra corrente rispetto al margine inferiore della barra dei menu.
Get ( FinestraVisibile )	Un valore booleano che indica se la finestra corrente è visibile o no.
Get ( LarghezzaFinestra )	Un numero che indica la larghezza, in pixel, della finestra corrente del file in cui è definito il calcolo.
Get ( LivelloZoomFinestra )	Il livello di zoom della finestra corrente.

Esempio di funzioni di ricavo

Questo script utilizza la funzione Get ( DataCorrente ) per controllare ciascun record nel gruppo trovato per vedere se un account è scaduto. Se l'account è scaduto, lo script visualizza un messaggio e richiede all'utente di fare clic su un pulsante Ignora, Invia lettera, o Invia posta (impostati attraverso l'istruzione di script Mostra finestra personalizz.). Lo script cattura la risposta dell'utente usando Get(SceltaUltimoMessaggio). Quindi, in base alla risposta dell'utente, lo script effettua un'operazione: annulla il resto dello script, stampa una lettera "pagamento in ritardo" o invia un'e-mail all'account associato.

 

Vai al formato ["NomeFormato"]

Vai a Record/Richiesta/Pagina [Primo]

Loop

  if [NomeDatabase::Data < Get(DataCorrente) - 30]

    Mostra finestra personalizz. ["30 o più giorni di ritardo"]

    If [Get(SceltaUltimoMessaggio) = 1]

      Interrompi lo script

    Else If [Get(SceltaUltimoMessaggio) = 2]

      Vai al formato ["Ultimo avviso"]

      Stampa []

    Else

      Invia posta [A: NomeDatabase::Client; Oggetto: "Ultimo avviso"; messaggio: " l'account è scaduto."]

    End If

  End If

  Vai a Record/Richiesta/Pagina [Esci dopo l'ultimo; Successivo]

End Loop

Vai al formato [formato originale]