راهنمای مهندسی فرم‌های چندمرحله‌ای مالی و زنجیره مصوبات چندسطحی با BPC Power Forms و نینتکس در شیرپوینت

       ┌────────────────────────────────────────────────────────┐
       │     فرم چندمرحله‌ای مالی BPC Power Forms (Client)      │
       │  - تب ۱: اطلاعات عمومی درخواست و مرکز هزینه            │
       │  - تب ۲: جدول اقلام Master-Detail با محاسبات مالیات    │
       │  - تب ۳: پیوست فاکتورها و اعتبارسنجی سقف بودجه        │
       └──────────────────────────┬─────────────────────────────┘
                                  │
                  ذخیره اتمیک (Atomic Save Pipeline)
                                  │
                                  ▼
       ┌────────────────────────────────────────────────────────┐
       │               لایه‌های ذخیره‌سازی شیرپوینت              │
       │  [لیست سربرگ درخواست‌ها] ◄─── ارتباط کلید خارجی ───► [لیست اقلام خرید] │
       └──────────────────────────┬─────────────────────────────┘
                                  │
                         رویداد ItemAdded (Event Receiver)
                                  │
                                  ▼
       ┌────────────────────────────────────────────────────────┐
       │          موتور گردش‌کار نینتکس (Nintex State Machine)   │
       │  - وضعیت ۱: بررسی کارشناس خرید و کنترل اعتبار بودجه     │
       │  - وضعیت ۲: تاییدیه مدیر مالی و صدور حواله پرداخت      │
       │  - وضعیت ۳: امضای دیجیتال مدیریت و بایگانی سند حسابداری │
       └────────────────────────────────────────────────────────┘

// محاسبه قیمت خالص ردیف اقلام با در نظر گرفتن تخفیف و مالیات
// Row Item Formula:
var unitPrice = [ItemUnitPrice];
var quantity = [ItemQuantity];
var discountRate = [ItemDiscountPercent] / 100;
var vatRate = 0.10; // نرخ مصوب مالیات بر ارزش افزوده ۱۰٪

var rawTotal = unitPrice * quantity;
var discountedTotal = rawTotal * (1 - discountRate);
var vatAmount = discountedTotal * vatRate;
var finalRowTotal = discountedTotal + vatAmount;

return Math.round(finalRowTotal);

// محاسبه جمع کل پرداختی در سربرگ فاکتور (Master Header)
var totalInvoice = SUM([PurchaseItemsTable.FinalRowTotal]);
var costCenterLimit = [CostCenterBudgetRemaining];

if (totalInvoice > costCenterLimit) {
    SetControlError("CostCenterWarning", "مبلغ کل فاکتور فراتر از مانده بودجه مرکز هزینه انتخاب‌شده است!");
    DisableSubmitButton();
} else {
    ClearControlError("CostCenterWarning");
    EnableSubmitButton();
}

return totalInvoice;

<!-- نمونه تعریف وضعیت‌های State Machine در پایپ‌لاین نینتکس -->
<NintexStateMachine Name="InvoiceApprovalProcess">
  <State Name="DirectManagerReview">
    <Action Type="AssignFlexiTask" Approver="{Item:ManagerID}" />
    <Transition Condition="Approved" NextState="CheckFinancialThreshold" />
    <Transition Condition="Rejected" NextState="NotifyInitiatorRejection" />
  </State>
  <State Name="CheckFinancialThreshold">
    <Action Type="CalculateCondition" Expression="{Item:TotalAmount} &gt; 500000000" />
    <Transition Condition="True" NextState="CEOApproval" />
    <Transition Condition="False" NextState="FinanceDirectorPayment" />
  </State>
</NintexStateMachine>

<#
.SYNOPSIS
    Automated Deployment of BPC Power Forms and Nintex Integration to SharePoint Farm
#>
$ErrorActionPreference = "Stop"

Add-PSSnapin Microsoft.SharePoint.PowerShell -ErrorAction SilentlyContinue

Write-Host "[DEPLOY] Initializing BPC Power Forms & Nintex Suite Setup..." -ForegroundColor Cyan

$packagePath = "C:\Deploy\BPC.PowerForms.Enterprise.wsp"
if (-not (Test-Path $packagePath)) {
    throw "[FATAL] Package file not found: $packagePath"
}

# Add and install solution globally
$bpcSol = Get-SPSolution -Identity "BPC.PowerForms.Enterprise.wsp" -ErrorAction SilentlyContinue
if (-not $bpcSol) {
    Write-Host "[ADD] Adding solution to farm..." -ForegroundColor Yellow
    Add-SPSolution -LiteralPath $packagePath
}

Write-Host "[INSTALL] Deploying solution to all Web Applications..." -ForegroundColor Green
Install-SPSolution -Identity "BPC.PowerForms.Enterprise.wsp" -GACDeployment -AllWebApplications -Force

# Activate Feature on specific Portal Web App
$portalUrl = "https://portal.licentra.lan"
Write-Host "[ACTIVATE] Activating BPC Enterprise Site Collection Features..." -ForegroundColor Cyan
Enable-SPFeature -Identity "BPC.PowerForms.Features" -Url $portalUrl -Force

Write-Host "[SUCCESS] Suite deployed and verified. Offline permanent license is active." -ForegroundColor Green