SharePoint Online: Keresési oszlop hozzáadása a listához a PowerShell segítségével

Követelmény: Hozzon létre egy új keresőoszlopot egy SharePoint Online-listához.

Hogyan hozhatunk létre keresőoszlopot a SharePoint Online listában?

A SharePoint Online Keresés oszlopa lehetővé teszi, hogy az oszlopértéket egy másik oszlop értéke alapján töltse fel ugyanazon a webhelyen egy másik listából. Ha PowerShell-el felvesz egy keresőoszlopot, akkor ez hatékony módszer a SharePoint-lista oszlopainak hatékonyabb automatizálására és kezelésére. A CSOM vagy PnP PowerShell modult kihasználva létrehozhatjuk a keresett oszlopot a kívánt tulajdonságokkal. Ez a módszer hatékony és szkriptezhető megoldást kínál a SharePoint oszlopok kezelésére, ahol a felhasználói felületen keresztüli kézi konfigurálás nehézkes vagy időigényes lehet.

Keresőmező hozzáadásához kövesse az alábbi lépéseket:

1. Böngésszen a SharePoint Online webhelyére, és navigáljon ahhoz a céllistához, amelyhez egy keresőoszlopot szeretne hozzáadni.
2. A Lista lapon kattintson az „Oszlop létrehozása” gombra a szalagon.

3. Adja meg az új oszlop nevét, adja meg a típust „Keresés”

   

4. Válassza ki a forráslistát és a keresési mezőt, adjon meg további opcionális értékeket, például oszlopleírást, kötelező mezőértéket stb., majd kattintson az „OK” gombra, hogy létrehozzon egy keresési mezőt a SharePoint Online listában.

PowerShell keresési oszlop hozzáadásához a listához a SharePoint Online-ban:

A keresőoszlopok akkor hasznosak, ha egy listát egy másik listához szeretne társítani, vagy ha egy másik listából szeretne értékeket kikeresni. Nézzük meg, hogyan vehet fel keresőoszlopot egy listához a SharePoint Online-ban a PowerShell használatával.

#Load SharePoint CSOM Assemblies
Add-Type -Path "C:\Program Files\Common Files\Microsoft Shared\Web Server Extensions\16\ISAPI\Microsoft.SharePoint.Client.dll"
Add-Type -Path "C:\Program Files\Common Files\Microsoft Shared\Web Server Extensions\16\ISAPI\Microsoft.SharePoint.Client.Runtime.dll"

#Custom function to add column to list
Function Add-LookupColumnToList()
{ 
    param
    (
        [Parameter(Mandatory=$true)] [string] $SiteURL,
        [Parameter(Mandatory=$true)] [string] $ListName,
        [Parameter(Mandatory=$true)] [string] $Name,
        [Parameter(Mandatory=$true)] [string] $DisplayName,
        [Parameter(Mandatory=$false)] [string] $Description=[string]::Empty,
        [Parameter(Mandatory=$false)] [string] $IsRequired = "FALSE",
        [Parameter(Mandatory=$false)] [string] $EnforceUniqueValues = "FALSE",
        [Parameter(Mandatory=$true)] [string] $LookupListName,
        [Parameter(Mandatory=$true)] [string] $LookupField
    )

    #Generate new GUID for Field ID
    $FieldID = New-Guid

    Try {
        $Cred= Get-Credential
        $Credentials = New-Object Microsoft.SharePoint.Client.SharePointOnlineCredentials($Cred.Username, $Cred.Password)

        #Setup the context
        $Ctx = New-Object Microsoft.SharePoint.Client.ClientContext($SiteURL)
        $Ctx.Credentials = $Credentials
        
        #Get the web, List and Lookup list
        $Web = $Ctx.web
        $List = $Web.Lists.GetByTitle($ListName)
        $LookupList = $Web.Lists.GetByTitle($LookupListName)
        $Ctx.Load($Web)
        $Ctx.Load($List)
        $Ctx.Load($LookupList)
        $Ctx.ExecuteQuery()

        #Check if the column exists in list already
        $Fields = $List.Fields
        $Ctx.Load($Fields)
        $Ctx.executeQuery()
        $NewField = $Fields | where { ($_.Internalname -eq $Name) -or ($_.Title -eq $DisplayName) }
        if($NewField -ne $NULL)  
        {
            Write-host "Column $Name already exists in the List!" -f Yellow
        }
        else
        {
            #Get IDs of Lookup List and Web
            $LookupListID= $LookupList.id
            $LookupWebID=$web.Id
            
            #sharepoint online powershell create lookup field
            $FieldSchema = "<Field Type='Lookup' ID='{$FieldID}' DisplayName='$DisplayName' Name='$Name' Description='$Description' Required='$IsRequired' EnforceUniqueValues='$EnforceUniqueValues' List='$LookupListID' WebId='$LookupWebID' ShowField='$LookupField' />"
            $NewField = $List.Fields.AddFieldAsXml($FieldSchema,$True,[Microsoft.SharePoint.Client.AddFieldOptions]::AddFieldInternalNameHint)
            $Ctx.ExecuteQuery()    

            Write-host "New Column Added to the List Successfully!" -ForegroundColor Green  
        }
    }
    Catch {
        write-host -f Red "Error Adding Column to List!" $_.Exception.Message
    }
} 

#Set parameter values
$SiteURL="https://crescent.sharepoint.com"
$ListName="Project Milestone"
$Name="ParentProject"
$DisplayName="Parent Project"
$Description="Select the Parent Project from the List"
$LookupListName="Projects" #Parent List to Lookup
$LookupField="Title"

#Call the function to add column to list
Add-LookupColumnToList -SiteURL $SiteURL -ListName $ListName -Name $Name -DisplayName $DisplayName -Description $Description -LookupListName $LookupListName -LookupField $LookupField

PnP PowerShell keresőoszlop hozzáadásához a SharePoint Online listához

A keresési oszlopok lehetővé teszik, hogy kapcsolatokat hozzon létre a SharePoint listái között úgy, hogy az egyik listaelemet egy másik listaelemhez kapcsolja. Hadd mutassam meg, hogyan vehet fel gyorsan egy keresőoszlopot egy SharePoint-listához a PnP PowerShell használatával.

#Parameters 
$SiteURL = "https://crescent.sharepoint.com/sites/PMO"
$ListName= "Projects"
$DisplayName = "Parent Project"
$InternalName = "ParentProject"

$ParentListName="Parent Projects"
$LookupField = "Title" #Internal Name

#Connect to the site
Connect-PnPOnline -Url $SiteURL -Interactive        

#Add Lookup Field to the List    
Add-PnPField -List $ListName -Type Lookup -DisplayName $DisplayName -InternalName $InternalName -AddToDefaultView

#Set Field Properties
Set-PnPField -List $ListName -Identity $InternalName -Values @{LookupList=(Get-PnPList $ParentListName).Id.ToString(); LookupField=$LookupField}

Hozzáadhatunk egy keresési oszlopot is a Field séma XML-lel:

#Config Variables
$SiteURL = "https://Crescent.sharepoint.com"
$ListName= "Projects"
$ParentListName="Parent Projects"

#Connect to PnP Online
Connect-PnPOnline -Url $SiteURL -Credentials (Get-Credential)

#Get the ID of the Parent List
$LookupListID = (Get-PnPList -Identity $ParentListName).ID

#Define XML Schema for URL Field
$FieldXML= "<Field Type='Lookup' Name='ParentProject' ID='$([GUID]::NewGuid())' DisplayName='Parent Project' List='$LookupListID' ShowField='Title'></Field>"

#Add Lookup Field to list
Add-PnPFieldFromXml -FieldXml $FieldXML -List $ListName