Variabili di query in SharePoint Server
SI APPLICA A:
2013 2016 2019 Subscription Edition SharePoint in Microsoft 365
Nota: questo articolo non si applica alle API e alle esperienze moderne di Microsoft Search. Per informazioni sulla ricerca moderna, vedere Variabili di query del profilo.
Variabili di query
Le tabelle seguenti mostrano le variabili di query per SharePoint Server e SharePoint in Microsoft 365 ed esempi su come possono essere usate.
Proprietà del sito e della raccolta siti
| Variabile di query | Definizione |
|---|---|
| {Site} o {Site.URL} |
URL del sito da cui viene eseguita la query. È possibile utilizzare questo valore, ad esempio, per richiedere il contenuto della proprietà gestita Path. |
| {Site.ID} |
GUID del sito da cui viene eseguita la query. Questo valore corrisponde al valore della proprietà gestita WebId. |
| {Site.LCID} |
Valore numerico delle impostazioni locali specificate in Impostazioni internazionali in Impostazioni sito per il sito da cui viene eseguita la query. |
| {Site.Locale} |
Lingua del sito da cui viene eseguita la query in formato ll-pp, ad esempio it-it. |
| {Sito.<property>} |
Qualsiasi proprietà dal contenitore delle proprietà del sito (SPWeb) da cui viene eseguita la query, incluse le proprietà personalizzate. |
| {SiteCollection} o {SiteCollection.URL} |
URL della raccolta siti da cui viene eseguita la query. È possibile utilizzare questo valore, ad esempio, per richiedere il contenuto della proprietà gestita Path. |
| {SiteCollection.ID} |
GUID della raccolta siti da cui viene eseguita la query. Questo valore corrisponde al valore della proprietà gestita SiteID. |
| {SiteCollection.LCID} |
Valore numerico delle impostazioni locali specificate in Impostazioni internazionali in Impostazioni sito per la raccolta siti da cui viene eseguita la query. |
| {SiteCollection.Locale} |
Lingua della raccolta siti da cui viene eseguita la query in formato ll-pp, ad esempio it-it. |
| {SiteCollection.<property>} |
Qualsiasi proprietà dal contenitore delle proprietà del sito radice (SPWeb) nella raccolta siti (SPSite) da cui viene eseguita la query, incluse le proprietà personalizzate. |
Proprietà di pagine, token URL, stringhe di query e richieste
| Variabile di query | Definizione |
|---|---|
| {Page} o {Page.URL} |
URL della pagina da cui viene eseguita la query. È possibile utilizzare questo valore, ad esempio, per richiedere il contenuto della proprietà gestita Path. |
| {Page.UsageAnalyticsId} |
ID elemento per i dati analitici di utilizzo |
| {Pagina.<FieldName>} |
Valore di un campo nella pagina da cui viene eseguita la query. Se la pagina da cui si esegue la query contiene una colonna del sito denominata "ProprietarioContenuto", ad esempio, è possibile specificare {Page.ProprietarioContenuto} per richiedere il valore di "ProprietarioContenuto". |
| {URLToken.<integer>} |
Valore dall'URL di una pagina. Il numero intero rappresenta la posizione del valore nell'URL contando da destra a sinistra. Ad esempio, per la pagina http://www.contoso/audio/mp3/1010101, la variabile di query {URLToken.1} eseguirà una query per l'ultimo valore nell'URL, 1010101. La variabile di query {URLToken.3} richiede la terzultima proprietà nell'URL, ovvero audio. È possibile richiedere valori fino alla nona posizione da destra in un URL. |
| {QueryString.<ParameterName>} |
Valore da una stringa di query nell'URL della pagina corrente. Se l'URL della pagina corrente contiene una stringa di query come ItemNumber=567, ad esempio, si potrebbe ottenere il valore 567 specificando {QueryString.ItemNumber}. |
| {Richiesta.<PropertyName>} |
Valore dalla richiesta HTTP corrente, ad esempio {Request.Url}. |
Proprietà degli utenti
| Variabile di query | Definizione |
|---|---|
| {User} o {User.Name} |
Nome visualizzato dell'utente che esegue la query. È possibile utilizzare questo valore, ad esempio, per richiedere il contenuto della proprietà gestita Author. |
| {User.Email} |
Indirizzi di posta elettronica dell'utente che esegue la query. È possibile utilizzare questo valore, ad esempio, per richiedere il contenuto della proprietà gestita WorkEmail. |
| {User.SID} |
SID dell'utente che esegue la query. |
| {User.LCID} |
Valore numerico delle impostazioni locali definite nel profilo dell'utente che esegue la query. |
| {User.PreferredContentLanguage} |
Lingua specificata come lingua predefinita per il contenuto nel profilo dell'utente che esegue la query. |
| {User.PreferredDisplayLanguage} |
Lingua specificata come lingua di visualizzazione predefinita nel profilo dell'utente che esegue la query. |
| {Utente.<property>} |
Qualsiasi proprietà dal profilo utente dell'utente che esegue la query, ad esempio SPS-Interests, incluse le proprietà personalizzate. |
| {User.Audiences} (solo SharePoint) |
Usato con i gruppi di destinatari di SharePoint moderni destinati al filtro sulla proprietà ModernAudienceAadObjectIdsgestita . Esempio: ModernAudienceAadObjectIds:{User.Audiences}. |
Proprietà di termini e set di termini
| Variabile di query | Definizione |
|---|---|
| {Term} o {Term.ID} o {Term.IDNoChildren} |
GUID del nodo corrente della struttura di spostamento del sito con il prefisso #0, ad esempio #083e99dcb-7907-4dc9-abc8-b5614a284f1c. Questo valore può essere utilizzato, ad esempio, per richiedere il contenuto della proprietà gestita owstaxIdMetadataAllTagsInfo o owstaxIdProductCatalogItemCategory in una raccolta siti Catalogo prodotti. |
| {Term.IDWithChildren} |
GUID del nodo corrente della struttura di spostamento del sito con il prefisso #, ad esempio #83e99dcb-7907-4dc9-abc8-b5614a284f1c. Verranno restituiti tutti gli elementi contrassegnati con il termine della struttura di spostamento del sito corrente o i termini figlio di tale termine. Ad esempio, questo valore può essere usato per eseguire query sul contenuto della proprietà gestita owstaxIdProductCatalogItemCategory in una raccolta siti del catalogo prodotti. Non è possibile utilizzare questo valore per richiedere il contenuto della proprietà gestita owstaxidmetadataalltagsinfo. |
| {Term.Name} |
Etichetta del nodo della struttura di spostamento del sito, ad esempio Audio. |
| {Termine.<property>} |
Qualsiasi proprietà dal contenitore delle proprietà del termine, incluse le proprietà personalizzate. |
| {TermSet} o {TermSet.ID} |
GUID del set di termini utilizzato per la struttura di spostamento del sito corrente. |
| {TermSet.Name} |
Etichetta del set di termini utilizzato per la struttura di spostamento del sito corrente. |
Proprietà di elenchi e voci di elenco
| Variabile di query | Definizione |
|---|---|
| {Elenco} |
URL dell'elenco corrente. |
| {Elenco.<property>} |
Qualsiasi proprietà dell'elenco corrente. |
| {ListItem} |
URL della voce di elenco corrente. |
| {ListItem.<property>} |
Qualsiasi proprietà della voce di elenco corrente. |
Altre proprietà
| Variabile di query | Definizione |
|---|---|
| {Today+/- <integer value for number of days>} |
Data calcolata tramite l'aggiunta/sottrazione del numero specificato di giorni alla/dalla data di esecuzione della query. Il formato della data è AAAA-MM-GG. È possibile utilizzare questo valore, ad esempio, per richiedere il contenuto della proprietà gestita LastModifiedTime. |
| {SearchBoxQuery} |
Valore di query immesso in una casella di ricerca in una pagina. |
| {CurrentDisplayLanguage} |
Lingua di visualizzazione corrente MUI in formato ll-pp. |
| {CurrentDisplayLCID} |
Valore numerico della lingua di visualizzazione corrente MUI in formato ll-pp. |
Gestione degli spazi nei valori
Le query di ricerca utilizzano il carattere spazio per la tokenizzazione dei valori delle query eseguite dagli utenti. Quando una variabile di query viene espansa in un valore che contiene uno spazio, l'intero valore viene racchiuso tra virgolette doppie. Il valore espanso della query author:{User}, ad esempio, diventa author:"Ezio Alboni".
Se non si desidera che il valore venga racchiuso tra virgolette doppie, ad esempio per la concatenazione di più valori, è possibile utilizzare il carattere di escape nella variabile di query. Ad esempio: customProperty:"{\User.Name}; {\User.ZipCode}" diventerebbe customProperty:"John Smith; 98109".
Variabili di query con più valori
Alcune variabili di query potrebbero restituire più valori. Per questo tipo di variabili di query è necessario utilizzare la sintassi seguente: {|ProprietàGestita:{VariabileQuery}}. Tutti i valori della variabile di query verranno combinati tramite l'operazione OR bit per bit. Si supponga, ad esempio, di disporre di un set di termini utilizzato per suddividere in categorie gli interessi degli utenti. Tutti gli utenti sono configurati in modo da avere uno o più interessi tramite la proprietà multivalore SPS-Interests nell'applicazione del servizio profili utente. Per eseguire una query per recuperare gli interessi dell'utente corrente, si potrebbe utilizzare la sintassi seguente: {|owstaxIdMetadataAllTagsInfo:{User.SPS-Interests}}. Se l'utente corrente è configurato per avere due interessi: calcio (#0f95d1fdf-781f-42f4-99f9-c656c1341b2e) e basket (#0c2cff933-9377-4692-aa98-ce59768aa38b) - la query verrà trasformata in (owstaxIdMetadataAllTagsInfo:#0f95d1fdf-781f-42f4-99f9-c656c1341b2e) OR (owstaxIdMetadataAllTagsInfo:#0c2cff933-9377-4692-aa98-ce59768aa38b) .
Esistono alcune restrizioni relative all'uso di più valori. Solo l'operatore OR ({|) è supportato per più valori. L'operatore AND non è supportato. Inoltre, solo le colonne di tipo Metadati gestiti funzionano correttamente per più case di valori. Altri tipi di colonne che possono usare più valori, ad esempio colonne di tipo Person o Group o Choice, gli elementi verranno espansi in una stringa delimitata.