GetFieldsOnLayout

Restituisce un elenco dei campi di un formato come dati JSON.

Formato 

GetFieldsOnLayout ( nomeFormato )

Parametri 

nomeFormato - un'espressione di testo che rappresenta il nome del formato. Se nomeFormato è una stringa vuota (""), viene utilizzato il formato corrente.

Tipo di dati riportato 

Testo

Creata nella versione 

22.0

Descrizione 

Questa funzione restituisce un oggetto JSON contenente informazioni sui campi del formato specificato accessibili a una ricerca.

Sono esclusi i campi che soddisfano uno dei seguenti criteri:

• L'oggetto campo si trova al di fuori dell'area del formato (vedere Posizionamento e rimozione dei campi da un formato).

• La condizione Nascondi oggetto se è soddisfatta e Applica nel modo Trova è selezionato (vedere Nascondere o visualizzare oggetti del formato).

• Per Accesso campo, il modo Trova è deselezionato (vedere Consentire o impedire l'accesso ai campi).

• Includi campo per la ricerca rapida non è selezionato (vedere Configurazione della ricerca rapida).

• Il set di privilegi dell'account corrente non ha accesso in lettura (Modifica dei privilegi di accesso ai record).

• Il campo è un campo Riassunto, Globale o Contenitore (vedere Definizione dei campi Riassunto, Definizione di campi globali (campi con memorizzazione globale) e Informazioni sui campi Contenitore).

L'oggetto JSON restituito ha la seguente struttura:

{
    "nome_formato": "NomeFormato",
    "campi": {
        "RicorrenzaTabella::NomeCampo1": {
            "tipo": "stringa",
            "descrizione": "Commento Campo (opzionale)"
        },
        "RicorrenzaTabella::NomeCampo2": {
            "tipo": "numero"
        }
    }
}

• La chiave nome_formato contiene il nome del formato.

• L'oggetto campi contiene coppie chiave-valore per ogni campo accessibile.

• La chiave di ogni campo è il suo nome completamente qualificato (ad esempio, RicorrenzaTabella::NomeCampo).

• Il valore di ogni campo è un oggetto con una chiave tipo (numero se il tipo di dati del campo è numero; altrimenti, stringa).

• Una chiave descrizione opzionale è inclusa se il campo ha un commento nella finestra di dialogo Gestisci database. Se un commento campo nella tabella inizia con [LLM], vengono visualizzati solo i commenti che iniziano con [LLM]. Il prefisso [LLM] viene rimosso dal valore descrizione.

Note 

• Questa funzione utilizza gli stessi criteri per determinare quali campi sono accessibili a una ricerca e quali informazioni del campo vengono restituite come fa l'istruzione di script Esegui ricerca per linguaggio naturale.

Esempio 1 

Restituisce un oggetto JSON che descrive i campi accessibili a una ricerca nel formato Prodotti.

JSONFormatElements ( GetFieldsOnLayout ( "Prodotti" ) )

Se il formato Prodotti ha questi campi:

La funzione restituisce:

{
    "campi" : 
    {
        "Prodotti::DataCreazione" : 
        {
            "descrizione" : "Data di creazione del prodotto",
            "tipo" : "stringa"
        },
        "Prodotti::Prezzo" : 
        {
            "descrizione" : "Prezzo del prodotto in USD",
            "tipo" : "numero"
        },
        "Prodotti::IDProdotto" : 
        {
            "descrizione" : "Chiave primaria che identifica in modo univoco un prodotto",
            "tipo" : "numero"
        },
        "Prodotti::NomeProdotto" : 
        {
            "descrizione" : "Nome descrittivo del prodotto",
            "tipo" : "stringa"
        },
        "Prodotti::Stato" : 
        {
            "tipo" : "stringa"
        }
    },
    "nome_formato" : "Prodotti"
}

Si noti che poiché almeno un commento campo inizia con il tag [LLM], solo i campi con il tag [LLM] includono una descrizione. Il campo g_PreferitiUtente è completamente omesso perché è un campo Globale non accessibile a una ricerca.

Esempio 2 

Restituisce un elenco di tutti i campi del formato corrente e un elenco di tutti i campi del formato corrente che sono accessibili a una ricerca. Questo può segnalare campi la cui non accessibilità a una ricerca non era nota.

Dichiara (
[
    campiFormato = NomiCampo ( Get ( NomeFile ) ; Get ( NomeFormato ) ) ;
    campiRicerca = JSONListKeys ( GetFieldsOnLayout ( Get ( NomeFormato ) ) ; "campi" ) ;

     campiFormatoOrdinati = SortValues ( campiFormato ; 1 ) ;
    campiRicercaOrdinati = SortValues ( campiRicerca ; 1 ) ;

    $$risultato = "Tutti i campi del formato corrente:" & ¶ & campiFormatoOrdinati & ¶ & 
    "Di questi, i campi accessibili a una ricerca sono:" & ¶ & campiRicercaOrdinati
] ;
$$risultato
)

Possibile output memorizzato in $$risultato per il formato Prodotti:

Tutti i campi del formato corrente:
Data di creazione
Foto
Prezzo
IDProdotto
NomeProdotto
Stato

Di questi, i campi accessibili a una ricerca sono:
Prodotti::DataCreazione
Prodotti::Prezzo
Prodotti::IDProdotto
Prodotti::NomeProdotto
Prodotti::Stato

Argomenti correlati 

• Funzioni

• Informazioni sulle funzioni

• Informazioni sulle formule

• Istruzione di script Esegui ricerca per linguaggio naturale