Home > Riferimento > Funzioni > Funzioni di ricavo

Funzioni di ricavo

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 la barra di formattazione è visibile.
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(AttributiConnessione)	Il nome dell'host del file corrente e il nome dell'autorità di certificazione che ha emesso il certificato SSL utilizzato per garantire la connessione.
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(MillisecondiUTCOraCorrente)	L'ora corrente nell'Ora Universale Coordinata approssimata al millisecondo più vicino.
Get(NomeGruppoMenuPersonalizzato)	Il nome del set di menu personalizzato attivo.
Get(PercorsoDesktop)	Il percorso per la cartella sul desktop per l'utente corrente.
Get(Dispositivo)	Un numero che indica il tipo di computer o dispositivo iOS su cui è attualmente in esecuzione un prodotto FileMaker.
Get(PercorsoDocumenti)	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(StatoCrittografia)	Un valore che rappresenta lo stato attuale della crittografia.
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 dell'attuale schema di colore predefinito a contrasto elevato se è selezionato Usa Contrasto elevato nella finestra di dialogo Accesso facilitato del sistema operativo di Windows.
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(CampiModificati)	Una lista di campi modificati nel record attuale dell'attuale tabella.
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 utilizza nel computer.
Get(TipoRete)	Un numero che rappresenta il tipo di rete in uso da FileMaker Pro per accedere al file che esegue l'attuale script.
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)	L'altezza, in punti, dello schermo su cui viene visualizzata la finestra del file corrente.
Get(LarghezzaSchermo)	La larghezza, in punti, dello schermo su cui viene visualizzata la finestra del file corrente.
Get(StatoAnimazioneScript)	Un numero che indica se le animazioni sono abilitate per lo script attualmente in esecuzione.
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 (OS X) in cui si trova il sistema operativo attualmente in esecuzione.
Get(IndirizzoIPSistema)	Gli indirizzi IP di tutte le macchine collegate ad una 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(TriggerPannelloCorrente)	Il numero di indice e il nome oggetto del pannello struttura a schede o del pannello slide di partenza quando è attivato il SuCambiamentoPannello trigger di script.
Get(TriggerInfoGesto)	Dettagli sul gesto che ha attivato un SuGestureTocco trigger di script.
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(TriggerPannelloTarget)	Il numero di indice e il nome oggetto del pannello struttura a schede o del pannello slide di partenza quando è attivato il SuCambiamentoPannello trigger di script.
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)	L'altezza, in punti, dell'area del contenuto di FileMaker Pro.
Get(LarghezzaContenutoFinestra)	La larghezza, in punti, dell'area del contenuto di FileMaker Pro.
Get(AltezzaDesktopFinestra)	L'altezza, in punti, dello spazio sul desktop.
Get(LarghezzaDesktopFinestra)	La larghezza, in punti, dello spazio sul desktop.
Get(AltezzaFinestra)	L'altezza, in punti, della finestra su cui agisce lo script (non necessariamente la finestra in primo piano).
Get(SinistraFinestra)	La distanza orizzontale, in punti, del margine esterno della finestra su cui agisce lo script (non necessariamente la finestra in primo piano) rispetto al bordo 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(OrientamentoFinestra)	Un numero che indica l'orientamento della finestra su cui agisce lo script attuale.
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(AltoFinestra)	La distanza verticale, in punti, del margine esterno della finestra su cui agisce lo script (non necessariamente la finestra in primo piano) rispetto al margine inferiore della barra dei menu.
Get(FinestraVisibile)	Un valore booleano che indica se la finestra corrente è visibile o no.
Get(LarghezzaFinestra)	La larghezza, in punti, della finestra su cui agisce lo script (non necessariamente la finestra in primo piano).
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). Dopodiché, in base alla risposta dell'utente, lo script esegue un'azione: 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]

      Arresta Script

    Else If [Get(SceltaUltimo Messaggio) = 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]

Argomenti correlati 

Funzioni

Informazioni sulle formule