راهنمای فنی اتوماسیون داده‌های اکسل، امنیت ستونی پیشرفته و گردش‌کارهای دسته‌ای با BoostSolutions و نینتکس در شیرپوینت

       ┌────────────────────────────────────────────────────────┐
       │             فایل اکسل داده‌ها (Excel / CSV)             │
       │       [۵۰,۰۰۰ ردیف صورت‌وضعیت مالی و کارکرد]           │
       └──────────────────────────┬─────────────────────────────┘
                                  │
                                  ▼
       ┌────────────────────────────────────────────────────────┐
       │      موتور BoostSolutions Excel Import (Background)    │
       │  - اعتبارسنجی مقادیر ستون‌ها با شروط لیست مقصد         │
       │  - درج دسته‌ای (Batch Insert) در بسته‌های ۵۰۰ تایی      │
       │  - درج فیلد وضعیت: Status = "ImportedPendingApproval"   │
       └──────────────────────────┬─────────────────────────────┘
                                  │
             تزریق آرام به صف (Throttled Queue Ingestion)
                                  │
                                  ▼
       ┌────────────────────────────────────────────────────────┐
       │             تایمر جاب زمان‌بندی‌شده نینتکس              │
       │  - انتخاب ۵۰ آیتم در هر چرخه اجرای جاب                 │
       │  - شروع State Machine فرآیند تاییدیه مالی               │
       │  - جلوگیری از ایجاد قفل در جدول NintexWorkflowProgress │
       └────────────────────────────────────────────────────────┘

<!-- پیکربندی قانون دسترسی ستونی با BoostSolutions Column Permission -->
<ColumnPermissionSetting ListName="VendorQuotations">
  <Column Name="EstimatedBudget">
    <PermissionPolicy Type="DenyView">
      <Principal Target="AllUsers" />
    </PermissionPolicy>
    <PermissionPolicy Type="AllowViewAndEdit">
      <Principal Target="FinanceDirectors" />
      <Principal Target="ProcurementManagers" />
    </PermissionPolicy>
  </Column>
  <Column Name="VendorProposedPrice">
    <PermissionPolicy Type="ReadOnly">
      <Condition Field="QuotationStatus" Operator="Equal" Value="LockedForEvaluation" />
    </PermissionPolicy>
  </Column>
</ColumnPermissionSetting>

<#
.SYNOPSIS
    Optimize Nintex Timer Jobs and BoostSolutions Batch Integration
#>
$ErrorActionPreference = "Stop"

Add-PSSnapin Microsoft.SharePoint.PowerShell -ErrorAction SilentlyContinue

Write-Host "[CONFIG] Optimizing Nintex Engine for Bulk Excel Imports..." -ForegroundColor Cyan

# 1. Adjust Workflow Timer Job Schedule to run smoothly
$timerJob = Get-SPTimerJob | Where-Object { $_.Name -eq "job-workflow" }
if ($timerJob) {
    Write-Host "[SCHEDULE] Setting Workflow Timer Job to execute every 1 minute..." -ForegroundColor Yellow
    Set-SPTimerJob -Identity $timerJob -Schedule "every 1 minutes between 0 and 59"
}

# 2. Check Throttling on High-Volume Import Lists
$web = Get-SPWeb "https://portal.licentra.lan"
$list = $web.Lists["صورت‌وضعیت‌های پیمانکاران"]

if ($list) {
    Write-Host "[LIST-OPT] Configuring List Indexing and Threshold Overrides..." -ForegroundColor Cyan
    $list.EnableThrottling = $true
    
    # Ensure Key Column is Indexed for Fast Upserting
    $keyField = $list.Fields["ContractID"]
    if (-not $keyField.Indexed) {
        $keyField.Indexed = $true
        $keyField.Update()
        Write-Host "[INDEX] Indexed ContractID for high-speed Excel Lookups." -ForegroundColor Green
    }
}

Write-Host "[SUCCESS] Farm parameters tuned for massive batch workflows." -ForegroundColor Green