به منظور آپلود قسمت جدولی (یک سند، کتاب مرجع، پردازش و غیره) در جدول مقادیرروش باید استفاده شود تخلیه (). وقتی از آن استفاده می کنید ایجاد می شود جدول مقادیربا مجموعه ای از ستون ها (انواع داده های مشابه) و با همان داده های موجود در قسمت جدولی. لازم به ذکر است که این جدول به هیچ وجه مرتبط نیست قسمت جدولیو تغییر داده های موجود در آن منجر به تغییر داده های موجود در آن نمی شود، در واقع یک کپی از آن است اما با خواص و روش های کمی متفاوت.
همچنین، اگر جدولی با مجموعه ستون‌های مشابه در قسمت جدول دارید، می‌توانید داده‌های جدول مقادیر را در قسمت جدول بارگذاری کنید. برای این منظور از روش استفاده می شود دانلود(<Таблица>) ، قسمت جدولی این ممکن است در صورتی لازم باشد که داده هایی که باید بارگذاری شوند بر اساس درخواست به دست آمده باشند. و به جای حلقه زدن نتیجه پرس و جو، به سادگی می توانید آن را در قسمت جدول بارگذاری کنید.
قسمت 1c جدولی را بارگیری کنید. مثال
دانلود قسمت جدول. مثال
فرض کنید که در متغیر یک شیشامل یک شی سند است که یک قسمت جدولی دارد خدمات. و در متغیر درخواست، حاوی یک پرس و جو است که داده ها را برای قسمت جدولی جمع آوری می کند.
این روش مبتنی بر استفاده از یک شی است گزارش سازشی ای است که بر اساس متن پرس و جو یا منبع داده مشخص شده و همچنین تنظیمات، اجازه می دهد تا نتیجه را به دست آورد و آن را در یک سند صفحه گسترده یا نمودار نمایش دهد.
شرح روش
1. مساحت سلول های سند صفحه گسترده را که باید در جدول مقادیر قرار گیرد به دست می آوریم. دریافت ناحیه باید به گونه ای مشخص شود که شامل ردیفی از سرفصل های ستون باشد (شکل 1 را ببینید)، یکی از ویژگی های شی Report Builder.
CellArea = TabDocument.Area(1, 1, LastRow, LastColumn);
2. بر اساس منطقه سلول سند صفحه گسترده، شرحی از منبع داده ایجاد می کنیم.
DataSource = NewDataSourceDescription(CellArea);
3. یک شی Report Builder ایجاد کنید، منبع داده را به جای متن پرس و جو مشخص کنید و گزارش را بسازید.
نتیجه خواندن داده ها از منبع پس از فراخوانی متد اجرا کن()در ملک است نتیجه. این ویژگی حاوی یک شی از نوع RequestResult است؛ زمانی که درخواست اجرا می شود، یک شی از همان نوع برگردانده می شود.
4. با فراخوانی متد Unload() یک شی از نوع Query Result، نتیجه را در جدول مقادیر (شکل 2 را ببینید) بارگیری کنید.
ValueTable = ReportBuilder.Result.Unload();
از معایب آشکار، مقادیر ستون ها از نوع رشته ای هستند. همچنین، شی Report Builder فقط در سرور موجود است، بنابراین شما باید سند صفحه گسترده را از مشتری به سرور منتقل کنید.
کد نهایی
تابع ConvertTabularDocumentToValueTable(TabDocument)
LastRow = TabDocument.TableHeight;
LastColumn = TabDocument.TableWidth;
CellArea = TabDocument.Area(1, 1, LastRow, LastColumn);
// شرحی از منبع داده را بر اساس ناحیه سلولی سند صفحه گسترده ایجاد کنید.
DataSource = NewDataSourceDescription(CellArea);
// ایجاد یک شی برای گزارش گیری هوشمند،
// منبع داده را مشخص کنید و گزارش را بسازید.
ReportBuilder = New ReportBuilder;
ReportBuilder.DataSource = DataSource;
ReportBuilder.Run();
// نتیجه در جدول مقدار آپلود می شود.
ValueTable = ReportBuilder.Result.Unload();
بازگشت TabValues
EndFunction
پردازش با اجرای این روش قابل دانلود است
جدول مقدار یک شی جهانی خاص است که برای ذخیره داده ها در یک نمایش جدولی طراحی شده است. تفاوت اصلی بین یک جدول و اشیاء برنامه، عدم اتصال به جداول پایگاه داده فیزیکی است. جدول مقادیر فقط در RAM وجود دارد که از یک سو فرصت های منحصر به فردی را فراهم می کند و از سوی دیگر محدودیت های خاصی را اعمال می کند. با این وجود، احتمالات تعامل با جدول با تعامل با اشیایی که در واقع در پایگاه داده وجود دارند قابل مقایسه است.
از لحاظ تاریخی، جدول مقادیر در 1C دارای هدف دوگانه است، آنالوگ مجازی جداول موجود است، اما در عین حال یک عنصر کنترل نیز می باشد. با انتقال به یک برنامه مدیریت شده، بسیاری از این عملکرد منسوخ شده است، اما اکنون می تواند یک عنصر رابط کاربری نیز باشد، اما با برخی محدودیت های قابل توجه.
ساختار جدول مقدار به عنوان یک شی
خصوصیات یک جدول مقدار با ترکیب دو مجموعه از پیش تعریف شده تعیین می شود: ستون ها و ردیف های آن.
جدول مقادیر ستون ها
ستونی از جدول مقادیر، ویژگی تعیین کننده آن است. این مجموعه ستون های جدول است که ساختار آن را تعیین می کند. ستون‌ها با فیلدهای جداول فیزیکی یا ستون‌های آشنا از رابط کاربری یک بخش جدولی یا مجله سند مطابقت دارند. یک ستون می تواند یک نام داخلی، یک نوع مقدار و عنوانی داشته باشد که هنگام کار به صورت تعاملی با جدول نمایش داده می شود.
از آنجایی که ستون ها مجموعه ای از اشیاء هستند، می توانید ستون ها را اضافه، حذف و ویرایش کنید.
ردیف جدول ارزش
از منظر رابط نرم افزاری، رشته ها مجموعه ای جداگانه هستند که در جدول مقادیر جاسازی شده اند. آنها مشابه رکوردهای جداول فیزیکی هستند، یعنی ردیف هایی که کاربر در یک بخش جدولی یا مجله سند آشنا است. هر سطر منفرد یک شی با مجموعه ای از ویژگی های نامگذاری شده است که نام آنها با نام ستون های جدول مطابقت دارد.
بنابراین، تعامل با یک رشته بسیار شبیه به تعامل با اشیاء دیگر است. می توانید ویژگی های آن را بخوانید و بنویسید، از جمله با استفاده از تابع از پیش تعریف شده "FillPropertyValues()". از آنجایی که سطرها مجموعه اصلی جدول مقادیر هستند، از روش Clear() برای حذف تمام سطرهای جدول استفاده می شود.
جدول مقادیر را ایجاد کنید
راه های زیادی برای آماده کردن جدول مقادیر برای استفاده وجود دارد. بیایید به برخی از آنها نگاه کنیم. هر نمونه به صورت فهرست کد همراه با نظرات ارائه خواهد شد.
ایجاد جدول با استفاده از سازنده
متأسفانه روش اصلی که به شما امکان می دهد دقیقاً جدولی را ایجاد کنید که توسعه دهنده به آن نیاز دارد بیشترین کار را انجام می دهد ، زیرا نیاز به تعیین دستی تمام خصوصیات جدول ضروری دارد.
DemoTable = New ValueTable; // اول از همه، TK را مقداردهی اولیه می کنیم // سپس، پارامترهای لازم برای ستون های جدید را تعیین می کنیم و به مجموعه اضافه می کنیم // ایجاد ستون "Nomenclature" Name = "Nomenclature"; ValueType = New TypeDescription("DirectoryLink.Nomenclature"); عنوان = "نامگذاری (محصول)"; DemoTable.Columns.Add(Name, ValueType, Header); // ایجاد ستون "Quantity" Name = "Quantity"; ValueType = New TypeDescription("Number"); DemoTable.Columns.Add(Name, ValueType); // در نتیجه این دستکاری ها، یک جدول خالی با ستون های تایپ شده ایجاد کردیم // اگر نیاز به تایپ دقیق تری از انواع اولیه دارید، باید از نحو توسعه یافته سازنده "Description of Types" استفاده کنید.ایجاد جدول با کپی کردن
اگر مرجعی با ساختار و/یا ترکیب مناسب دارید، می‌توانید جدول مرجع مقادیر را کپی یا دانلود کنید. اگر جدول مرجع جدول دیگری است، باید از روش "کپی جداول مرجع" استفاده کنید. اگر با یک بخش جدولی یا مجموعه ای از رکوردهای ثبت سر و کار دارید، باید از روش "Unload جدول مقادیر" استفاده کنید. اگر فقط به ساختار نیاز دارید، می توانید از روش "Copy Columns" استفاده کنید.
// گزینه ای با کپی کردن تمام ردیف ها از استاندارد مشخصات فنی اما حفظ تنها دو ستون مشخص شده. DemoTable = TableEtalon.Copy(, ColumnsEtalon); // گزینه ای با کپی کردن ردیف های از پیش انتخاب شده از استاندارد مشخصات فنی، در حالی که دو ستون مشخص شده را حفظ می کند. ColumnsStandard = "نامگذاری، کمیت"; DemoTable = TableEtalon.Copy(RowsEtalon, ColumnsEtalon); // گزینه ای برای کپی کردن ردیف ها از استاندارد مشخصات فنی با استفاده از فیلتر مشخص شده، با حفظ یک ستون "Nomenclature" // تمام ردیف هایی که مقدار در ستون Quantity 0 است انتخاب می شوند، فقط ستون Nomenclature انتخاب ردیف = ساختار جدید(" مقدار" در جدول حاصل ظاهر می شود، 0)؛ ColumnsStandard = "نامگذاری"; DemoTable = TableEtalon.Copy(RowsEtalon, ColumnsEtalon); // گزینه با یک کپی کامل از جدول و حذف بعدی یک سطر با مقدار فیلد مقدار برابر با صفر و حذف کل ستون Quantity انتخاب ردیف = ساختار جدید("کمیت"، 0); ColumnsStandard = "نامگذاری"; DemoTable = TableEtalon.Copy(RowsEtalon, ColumnsEtalon); TableRow = DemoTable.Find(0, "Quantity"); DemoTable.Delete(TableRow); DemoTable.Columns.Delete("مقدار"); // گزینه های مشابه و اصلاحات آنها را می توان در قسمت های جدولی و مجموعه های رکوردهای ثبت اعمال کردایجاد جدول با پرس و جو
اگر قالبی از جدول مورد نیاز شما در پایگاه داده وجود دارد، می توانید از یک کوئری برای ایجاد سریع جدول با ساختار دلخواه استفاده کنید.
// نمونه ای از ایجاد یک جدول خالی بر اساس ساختار رجیستر تجمع // به راحتی می توان حدس زد که از این طریق می توانید یک جدول پر شده را نیز دریافت کنید Query = New Query("SELECT FIRST 0 * From Accumulation Register. Products. در انبار")؛ RequestResult = Request.Execute(); DemoTable = Query Result.Unload(); // نمونه ای از ایجاد یک جدول خالی با استفاده از انواع و نام فیلدهای مشخص شده Query = New Query; Query.Text = "انتخاب TOP 0 | Value(Directory.Nomenclature.EmptyLink) AS Nomenclature, | EXPRESS(0 AS NUMBER(15, 3)) AS Quantity"; RequestResult = Request.Execute(); DemoTable = Query Result.Unload(); // مهم! فراموش نکنید که انواع مقادیر ستون به دست آمده از یک درخواست همیشه دارای نوع Null هستند // بنابراین، TK ایجاد شده توسط درخواست همیشه دارای انواع ستون های ترکیبی است.نتیجه
در این مقاله کوتاه، ویژگی‌های اساسی و تکنیک‌های عملی برای ایجاد جدولی از مقادیر را که برای درک و شروع استفاده کافی است، بررسی کردیم. شیء جدول ارزش خود به قدری چند وجهی است که شرح دقیق قابلیت های آن مستلزم نوشتن مقاله ای جداگانه در مورد تکنیک ها و روش های کار است.
