#P1108
Function getCommunicationsCharter
· هدف:
این متد استاتیک برای واکشی اطلاعات اولیه و ضروری یک چارتر برای استفاده در ماژول “ارتباطات” (Communications) طراحی شده است. هدف آن، فراهم کردن یک لیست از آیتمهای محاسباتی (کلاسها/اتاقها) موجود در آن چارتر به همراه اطلاعات کلی چارتر (مانند مبدأ، مقصد و تاریخ) است. متد نوع چارتر را تشخیص داده و بر اساس آن، کوئری را به جدول محاسبات مربوطه (charter_calculations_route یا charter_calculations_accommodation) ارسال میکند. خروجی شامل اطلاعات اصلی چارتر و لیستی از شناسههای آیتمهای آن است که میتواند برای ساخت منوهای کشویی در فرمهای ایجاد ارتباط استفاده شود.
| ویژگیها | توضیحات |
| هدف کلی | واکشی اطلاعات کلی و لیست آیتمهای یک چارتر برای ماژول ارتباطات. |
| متد استاتیک | قابل فراخوانی به صورت عمومی (CharterController::getCommunicationsCharter(...)). |
| انتخاب جدول پویا | تشخیص خودکار جدول محاسبات بر اساس نوع چارتر. |
| خروجی ساده | بازگرداندن اطلاعات ضروری (information) و لیستی از شناسههای آیتمها (calculations). |
| ساختار داده پیچیده | تأمین داده برای UI ایجاد و ویرایش ارتباطات. |
· ورودیها (پارامترها):
| توضیحات | موقعیت | نوع داده | نام پارمتر |
| شناسه چارتر اصلی که اطلاعات آن مورد نیاز است. | Parameter |
integer |
mainId |
· خروجی (Return):
| توضیحات | نوع داده |
یک آرایه انجمنی با دو کلید information (شامل origin, destination, start) و calculations (مجموعهای از آبجکتها که هر کدام شناسه یک آیتم را دارند). |
array |
· مثال استفاده / سناریو:
سناریو: واکشی اطلاعات چارتر پرواز با شناسه ۱۰۱
- Call:
CharterController::getCommunicationsCharter(101) - Action:
- اطلاعات چارتر ۱۰۱ از جدول
chartersواکشی میشود. - چون نوع آن
routeاست، تمام شناسههای آیتم ازcharter_calculations_routeکهmain_id=101دارند، واکشی میشوند.
- Return:
php
[
'information' => [
"origin" => "THR",
"destination" => "MHD",
"start" => "2025-10-20 18:00:00"
],
'calculations' => [
(object)['id' => 501],
(object)['id' => 502]
]
]