Usare PowerShell per richiedere l'elaborazione da parte di un modello personalizzato

^{Si applica a: ✓ Tutti i modelli personalizzati | ✓ Tutti i modelli predefiniti}

Importante

I Microsoft Syntex cmdlet di PowerShell e tutti gli altri componenti PnP sono strumenti open source supportati da una community attiva che fornisce supporto. Non è disponibile alcun contratto di servizio per il supporto degli strumenti open source da canali di supporto Microsoft ufficiali.

I modelli personalizzati eleboreranno i file appena caricati in una libreria. È anche possibile richiedere manualmente l'elaborazione nell'interfaccia utente. Tuttavia, potrebbero esserci scenari in cui è più efficiente attivare l'elaborazione tramite PowerShell.

Richiedere l'elaborazione di tutti gli elementi che non sono stati classificati in precedenza

È possibile richiedere l'elaborazione per tutti gli elementi della libreria che non sono stati classificati in precedenza usando questo comando:

#Note: you're connecting here to the site that holds the document library you want to process
Connect-PnPOnline -Url "https://contoso.sharepoint.com/sites/finance"

Request-PnPSyntexClassifyAndExtract -List "Documents"

Per l'elaborazione con priorità inferiore, è anche possibile usare il parametro -OffPeak, che accoderà i file per l'elaborazione al di fuori dell'orario di ufficio in cui si trova il tenant. Per altre informazioni, vedere Request-PnPSyntexClassifyAndExtract.

Richiedere l'elaborazione di tutti gli elementi in una raccolta

È possibile richiedere l'elaborazione di tutti i file nella libreria, anche se sono stati classificati in precedenza. Questo passaggio può essere utile se è stato aggiornato un modello o è stato aggiunto un altro modello alla libreria.

#Note: you're connecting here to the site that holds the document library you want to process
Connect-PnPOnline -Url "https://contoso.sharepoint.com/sites/finance"

Request-PnPSyntexClassifyAndExtract -List "Documents" -Force

Nota

L'uso dell'opzione -Force con più di 5000 elementi consentirà automaticamente l'elaborazione non di picco.

Richiedere l'elaborazione di tutti gli elementi in base a una proprietà

Se si vuole limitare l'elaborazione a un subset specifico di elementi in una libreria, è possibile usare uno script per selezionare un gruppo specifico di file. Nell'esempio seguente lo script consente di selezionare un campo e di filtrare un valore di campo in base a . È possibile completare query più complesse usando Get-PnPListItem.

#Note: you're connecting here to the site that holds the document library you want to process
Connect-PnPOnline -Url "https://contoso.sharepoint.com/sites/finance"
$list = Get-PnPList -Identity "Documents"
# Set the field name to filter items by
$fieldName = "Vendor"
# Set the field value to filter by
$fieldFilter = "Fabrikam"

$listItems = (Get-PnPListItem -List $list -fields $fieldName).fieldValues
$targetItems = $listItems | Where-Object -Property Provider -EQ -Value $fieldFilter

# Create a new batch
$batch = New-PnPBatch

# Add files to classify to the batch
foreach ($listItem in $targetItems) {
    Request-PnPSyntexClassifyAndExtract -FileUrl $listItem.FileRef -Batch $batch
}

# Execute batch
Invoke-PnPBatch -Batch $batch

Richiedere l'elaborazione di file specifici

L'elaborazione può essere richiesta anche per file specifici.

#Note: you're connecting here to the site that holds the document library you want to process
Connect-PnPOnline -Url "https://contoso.sharepoint.com/sites/finance"

Request-PnPSyntexClassifyAndExtract -FileUrl "/sites/finance/documents/contoso contract.docx"

Il modello file per file supporta anche l'invio in batch:

#Note: you're connecting here to the site that holds the document library you want to process
Connect-PnPOnline -Url "https://contoso.sharepoint.com/sites/finance"

# Create a new batch
$batch = New-PnPBatch

# Add files to classify to the batch
Request-PnPSyntexClassifyAndExtract -FileUrl "/sites/finance/documents/contoso contract.docx" -Batch $batch
Request-PnPSyntexClassifyAndExtract -FileUrl "/sites/finance/documents/relecloud contract.docx" -Batch $batch

# Execute batch
Invoke-PnPBatch -Batch $batch