راهنمای مهندسی داشبوردهای مدیریتی، شاخص‌های KPI و فرآیندهای واکنشی با Infowise و نینتکس در شیرپوینت

       ┌────────────────────────────────────────────────────────┐
       │     تغییر مقدار در لیست (مانند ثبت گزارش پیشرفت کار)    │
       └──────────────────────────┬─────────────────────────────┘
                                  │
                   رویداد همگام (ItemUpdated Event)
                                  │
                                  ▼
       ┌────────────────────────────────────────────────────────┐
       │          موتور پردازش آنی Infowise Actions             │
       │  - محاسبه مجدد درصد پیشرفت پروژه (Progress Bar)        │
       │  - به‌روزرسانی رنگ شاخص KPI (سبز / زرد / قرمز)          │
       │  - بررسی سررسید SLA با ستون شمارش معکوس پویا           │
       │  - ثبت تغییر در لیست تجمیعی داشبورد بدون تاخیر         │
       └──────────────────────────┬─────────────────────────────┘
                                  │
                 شرط بحران: SLA سررسید گذشته (Breached)
                                  │
                                  ▼
       ┌────────────────────────────────────────────────────────┐
       │          موتور ناهمگام نینتکس (Nintex Workflow)        │
       │  - شروع فرآیند اخطار به سرپرست کارگاه و مدیر پروژه     │
       │  - اخذ گزارش علت تاخیر در قالب Flexi-Task              │
       │  - ارسال پیامک هشداری از طریق وب‌سرویس درگاه پیامکی    │
       └────────────────────────────────────────────────────────┘

<!-- پیکربندی ستون شاخص KPI با قوانین رنگ‌بندی شرطی -->
<InfowiseKPIColumn Title="وضعیت پیشرفت پروژه" InternalName="ProjectProgressKPI">
  <Thresholds ValueType="Percentage">
    <Range Min="0" Max="49" Color="#EF4444" Label="تاخیر بحرانی" Icon="AlertTriangle" />
    <Range Min="50" Max="79" Color="#F59E0B" Label="در حال پیشرفت" Icon="Clock" />
    <Range Min="80" Max="100" Color="#10B981" Label="منطبق بر برنامه" Icon="CheckCircle" />
  </Thresholds>
  <CalculationExpression>
    ([ActualCompletedTasks] / [TotalPlannedTasks]) * 100
  </CalculationExpression>
</InfowiseKPIColumn>

<!-- اکشن همگام‌سازی سریع اینفوایز در زمان اتمام وظیفه -->
<InfowiseAction Title="ثبت اتمام تسک" Type="UpdateListItems" Event="ItemModified">
  <Conditions>
    <Condition Field="TaskStatus" Operator="Equal" Value="Completed" />
    <Condition Field="CompletionDate" Operator="IsNull" />
  </Conditions>
  <ActionSettings>
    <FieldAssignment Field="CompletionDate" Value="[Today]" />
    <FieldAssignment Field="ClosedBy" Value="[Current User]" />
  </ActionSettings>
</InfowiseAction>

<#
.SYNOPSIS
    Deploy and Configure Infowise and Nintex Suite on SharePoint Farm
#>
$ErrorActionPreference = "Stop"

Add-PSSnapin Microsoft.SharePoint.PowerShell -ErrorAction SilentlyContinue

Write-Host "[DEPLOY] Checking Infowise Ultimate Forms WSP..." -ForegroundColor Cyan

$infowiseWsp = "C:\Deploy\Infowise.UltimateForms.wsp"
if (-not (Test-Path $infowiseWsp)) {
    throw "[FATAL] Infowise WSP package missing at $infowiseWsp"
}

$solution = Get-SPSolution -Identity "Infowise.UltimateForms.wsp" -ErrorAction SilentlyContinue
if (-not $solution) {
    Write-Host "[ADD] Adding Infowise package to Farm..." -ForegroundColor Yellow
    Add-SPSolution -LiteralPath $infowiseWsp
}

Write-Host "[INSTALL] Deploying Infowise globally..." -ForegroundColor Green
Install-SPSolution -Identity "Infowise.UltimateForms.wsp" -GACDeployment -AllWebApplications -Force

# Activate Site Collection Features
$siteUrl = "https://portal.licentra.lan"
Write-Host "[FEATURE] Activating Infowise & Nintex features on $siteUrl..." -ForegroundColor Cyan
Enable-SPFeature -Identity "Infowise.UltimateForms.Core" -Url $siteUrl -Force

Write-Host "[SUCCESS] Farm dashboard infrastructure successfully activated." -ForegroundColor Green