راهنمای فنی یکپارچه‌سازی تقویم شمسی جلالی با سرویس جستجوی سازمانی (Enterprise Search)، تایمر جاب‌ها و REST API شیرپوینت

       ┌────────────────────────────────────────────────────────┐
       │             اسناد، نامه‌ها و آیتم‌های شیرپوینت         │
       │   [فیلد تاریخ نامه: ۱۴۰۴/۱۲/۱۰] (ذخیره استاندارد UTC) │
       └──────────────────────────┬─────────────────────────────┘
                                  │
                                  ▼
       ┌────────────────────────────────────────────────────────┐
       │         خزنده محتوا (Search Crawler Component)         │
       │  - استخراج ویژگی تاریخ: ows_LetterDate (Crawled Prop)  │
       └──────────────────────────┬─────────────────────────────┘
                                  │
                                  ▼
       ┌────────────────────────────────────────────────────────┐
       │     پردازشگر محتوا و بومی‌ساز Licentra Jalali Suite    │
       │  - نرمال‌سازی تاریخ خورشیدی به فرمت استاندارد ایندکس    │
       │  - نگاشت به Managed Property با قابلیت RefinableDate   │
       └──────────────────────────┬─────────────────────────────┘
                                  │
                                  ▼
       ┌────────────────────────────────────────────────────────┐
       │               شاخص جستجو (Search Index)                │
       │  - قابلیت پالایش در کادر فیلتر جستجو (Search Refiner)  │
       │  - پشتیبانی از عبارات کوئری زبان KQL با بازه خورشیدی  │
       └────────────────────────────────────────────────────────┘

# جستجوی نامه‌های صادر شده در فصل زمستان ۱۴۰۴
ContentType:"نامه اداری" AND LetterDateOWSDATE>=2026-01-20 AND LetterDateOWSDATE<=2026-03-20

# جستجوی اسناد با فیلتر پالایشگر سازمانی (Search Refinement)
IsDocument:true AND RefinableDate01>=today-30

<!-- الگوی نمایش فیلتر تاریخ شمسی در وب‌پارت پالایشگر جستجو -->
<ControlTemplate>
  <div class="ms-ref-refiner">
    <div class="ms-ref-title">تاریخ ثبت سند (خورشیدی)</div>
    <ul class="ms-ref-list">
      <li><a href="?k=test&amp;r=LetterDate%3E%3D2026-02-20">ماه جاری (اسفند ۱۴۰۴)</a></li>
      <li><a href="?k=test&amp;r=LetterDate%3E%3D2025-12-22">سه ماه اخیر (زمستان ۱۴۰۴)</a></li>
      <li><a href="?k=test&amp;r=LetterDate%3E%3D2025-03-21">سال جاری (۱۴۰۴)</a></li>
    </ul>
  </div>
</ControlTemplate>

using System;
using Microsoft.SharePoint.Administration;

namespace Licentra.SharePoint.Jalali.Jobs
{
    public class EndOfYearArchiveJob : SPJobDefinition
    {
        public const string JobName = "Licentra_Jalali_EndOfYear_Archive_Job";

        public EndOfYearArchiveJob() : base() { }

        public EndOfYearArchiveJob(string jobName, SPService service) 
            : base(jobName, service, null, SPJobLockType.Job)
        {
            this.Title = "جاب آرشیو سالانه اسناد بر اساس تقویم خورشیدی";
        }

        public override void Execute(Guid targetInstanceId)
        {
            // دریافت زمان محلی با در نظر گرفتن مبدل رسمی گاه‌شماری خورشیدی
            DateTime nowUtc = DateTime.UtcNow;
            System.Globalization.PersianCalendar pc = new System.Globalization.PersianCalendar();

            int jalaliYear = pc.GetYear(nowUtc);
            int jalaliMonth = pc.GetMonth(nowUtc);
            int jalaliDay = pc.GetDayOfMonth(nowUtc);

            // بررسی رسیدن به آخرین روز سال خورشیدی (۲۹ یا ۳۰ اسفند)
            bool isLeap = pc.IsLeapYear(jalaliYear);
            int lastDayOfEsfand = isLeap ? 30 : 29;

            if (jalaliMonth == 12 && jalaliDay == lastDayOfEsfand)
            {
                // اجرای روتین بستن دفاتر و انتقال پرونده‌های جاری به آرشیو راکد
                ExecuteFiscalYearArchiving(jalaliYear);
            }
        }

        private void ExecuteFiscalYearArchiving(int year)
        {
            // منطق آرشیو اسناد و لاگین در سیستم مانیتورینگ
        }
    }
}

POST /_api/web/lists/getbytitle('مکاتبات')/items HTTP/1.1
Host: sp-farm.licentra.lan
Content-Type: application/json;odata=verbose
X-Calendar-Mode: Jalali
Accept: application/json;odata=verbose

{
  "__metadata": { "type": "SP.Data.LettersListItem" },
  "Title": "نامه ارجاع اداری",
  "LetterDate": "1404/12/15 10:30:00"
}

<#
.SYNOPSIS
    Deploy Licentra Jalali Calendar Suite to SharePoint Farm
#>
$ErrorActionPreference = "Stop"

Add-PSSnapin Microsoft.SharePoint.PowerShell -ErrorAction SilentlyContinue

Write-Host "[DEPLOY] Installing Licentra Jalali WSP Solution..." -ForegroundColor Cyan

$wspPath = "C:\Deploy\Licentra.SharePoint.Jalali.wsp"
if (-not (Test-Path $wspPath)) {
    throw "[FATAL] WSP package not found at $wspPath"
}

# Add solution to farm store
$solution = Get-SPSolution -Identity "Licentra.SharePoint.Jalali.wsp" -ErrorAction SilentlyContinue
if (-not $solution) {
    Add-SPSolution -LiteralPath $wspPath
}

# Deploy globally to all GACs and Web Applications
Write-Host "[DEPLOY] Deploying solution globally with Full-Trust..." -ForegroundColor Yellow
Install-SPSolution -Identity "Licentra.SharePoint.Jalali.wsp" -GACDeployment -AllWebApplications -Force

# Verify Timer Service restart
Write-Host "[SERVICE] Restarting SharePoint Timer Service (SPTimerV4)..." -ForegroundColor Cyan
Get-Service -Name "SPTimerV4" | Restart-Service

Write-Host "[SUCCESS] Licentra Jalali Suite deployed and initialized farm-wide." -ForegroundColor Green