1C:Enterprise 8.3. Developer Guide. Contents
INTRODUCTION
This book is the guide for application development in 1C:Enterprise.
This document can be used by specialists developing, modifying and implementing applications based on the 1C:Enterprise platform.
STRUCTURE OF THE GUIDE
The guide contains a description of the overall concept of the 1C:Enterprise system and explains techniques for working with system objects, creating forms and command interfaces and using various service mechanisms.
CHAPTER 1 lays out the concept of the 1C:Enterprise system: its underlying principles, general operation and more.
CHAPTER 2 covers how to work with the entire configuration: edit configuration attributes, copy configuration objects, save the configuration, merge configurations and use additional operation modes.
CHAPTER 3 describes application interface and its operation.
CHAPTER 4 contains general information about the 1C:Enterprise script, describes data types, operators and syntax and covers general methods for working with the 1C:Enterprise script.
CHAPTER 5 deals with the main configuration objects and their features.
CHAPTER 6 is focused on the command interface and its development.
CHAPTER 7 describes forms, their components and methods of use in the 1C:Enterprise script.
CHAPTER 8 covers the query language and basic methods of using queries in the 1C:Enterprise script.
CHAPTER 9 explains the general principles and specifics of working with data in 1C:Enterprise.
CHAPTER 10 describes the data composition system.
CHAPTER 11 highlights the accounting procedures used in 1C:Enterprise.
CHAPTER 12 explains how to use periodic calculation tools in the 1C:Enterprise system.
CHAPTER 13 contains a description of business processes and tasks.
CHAPTER 14 covers data analysis and forecasting.
CHAPTER 15 is focused on data exchange.
CHAPTER 16 describes the XDTO mechanism.
CHAPTER 17 highlights the Web services mechanism.
CHAPTER 18 outlines how jobs function.
CHAPTER 19 describes full-text database search tools.
CHAPTER 20 demonstrates how to work with temporary data storages and use them for operations with files.
CHAPTER 21 describes how to work with the Event Log.
CHAPTER 22 describes the cryptographic mechanism.
CHAPTER 23 describes how to work with external data sources.
CHAPTER 24 focuses on data separation.
CHAPTER 25 describes the mobile application development.
CHAPTER 26 explains how to use a special form editor, text editor, spreadsheet editor, flowchart editor and picture editor.
CHAPTER 27 outlines configuration debugging and testing.
CHAPTER 28 depicts how to compare and merge configurations.
CHAPTER 29 illustrates how to prepare for and perform distributed configuration development.
CHAPTER 30 describes creation of distribution files, update files and distribution kits. This chapter is especially interesting for developers of standard configurations. It also highlights how to use distribution and update files for standard configurations supported by user configuration developers.
CHAPTER 31 explains the service modes: setting up parameters of the Designer, working with the Syntax Assistant, customizing templates, using built-in calculator and calendar, comparing files, working with dialog boxes and localizing configurations in the 1C:Enterprise system.
CHAPTER 32 details how to connect external components.
CHAPTER 33 contains recommendations on cross-platform applied solutions development.
WHAT YOU NEED TO KNOW
In writing this guide, we assumed that you were familiar with the operating system of the computer running 1C:Enterprise (Microsoft Windows 2000, Microsoft Windows XP, Microsoft Windows Vista, all referred to as "Microsoft Windows" hereinafter) and possessed the basic skills for working with it.
You should be familiar with the following concepts and skills:
using the Start menu to start programs
working in dialog boxes
using the mouse
using standard techniques for working with text and spreadsheets (entering text, entering values into spreadsheet cells, editing, formatting, printing, etc.)
using menus
using dialog box controls
working in standard dialog boxes
using the Microsoft Windows clipboard (hereinafter referred to as "clipboard")
customizing Microsoft Windows using Control Panel
If you haven't completely mastered the concepts and skills listed above, we recommend you refer to the operating system documentation.
THE BOOKS INCLUDED IN THE DOCUMENTATION
The documentation includes the following books covering the 1C:Enterprise technological platform:
"1C:Enterprise 8.3. User Manual". Describes the basic concepts and features that are common for all 1C:Enterprise applications.
"1C:Enterprise 8.3. Developer Guide". Describes how to customize applications to reflect the accounting procedures in a specific company, as well as how to develop new applications.
"1C:Enterprise 8.3. Administrator Guide". Describes 1C:Enterprise administration, including features related to building client/server systems.
"1C:Enterprise 8.3. Client/Server. Administrator Guide". Describes 1C:Enterprise installation and operation with client/server infobase versions.
The syntax of the 1C:Enterprise script and query language is described in "1C:Enterprise 8.3. Developer Guide". The full object model description is included in the distribution kit in the electronic form (in the Designer help topics and in the Syntax Assistant).
IMPORTANT!
The distribution kit for a specific product may not include all of the above books.
Training Materials and Additional Opportunities
1C Company supports 1C:Enterprise users in adopting and deploying its solutions. Support includes various sources of information that will help develop and use applications properly and efficiently.
Text Files Included in the 1C:Enterprise 8.3 Distribution Kit
The distribution kit includes electronic documents that include the list of features added in this version and migration recommendations. They are copied to the hard disk during 1C:Enterprise installation. They are copied to the hard disk during 1C:Enterprise installation.
These documents are located in the directory with 1C:Enterprise installation files, in the \docs\en subdirectory. If you do not change the default installation path, they are copied to C:\Program Files\1cv8\VersionNumber\docs\en. The VersionNumber stands for the 1C:Enterprise version number. For example, this is how the path looks for version 8.3.3.721: C:\Program Files\1cv82\8.3.3.721\docs\en.
The file V8Update.htm contains the list of changes as compared to previous platform versions, and update instructions.
ABOUT 1C:ENTERPRISE 8 PAGE
1C:Enterprise is a universal cloud and on-premise system of programs for automating a company’s financial and wider operational activities. 1C:Enterprise has the breadth of capability to address the diverse needs of today’s business. This is achieved through "configurability" – the ability to customize the system based on the specific needs of companies and their business processes.
AGREED NOTATION
To help you understand the material, this guide uses some general techniques to set off certain text elements. You will find the agreement on these techniques below.
Keys: Keys such as Enter, Esc, Del and the like will be shown with the lettering on the keys themselves, without quotation marks.
When referring to cursor control keys (arrow keys), we will use the phrase cursor control keys when we need to refer to all these keys at once. If we need to refer to these keys individually, we will use the expressions Up Arrow, Down Arrow, Right Arrow and Left Arrow.
Keyboard Shortcuts: When you need to press a combination of two keys to execute a command, it will be presented as Ctrl + F3.
Buttons: The names of the buttons in a form will be presented by their names without quotation marks, for example, OK, Cancel, Delete and so forth.
1C:Enterprise Script Keywords: Keywords of the 1C:Enterprise script will be highlighted by a font and written as in program modules: WorkingDate. The text might also contain references to descriptions of sections or items in the 1C:Enterprise script (properties, methods, etc.). To view these descriptions, use Help content (1C:Enterprise script branch).
Menu Actions: To describe selection of a menu item, we will use the following sequence: Menu – Submenu – Submenu – … – Item. For example, "To choose the scale, use Table – View – Scale." It is the same as the following: "To select the image scale, use Scale on the View submenu of the Table menu in the program's main menu." If the selection is not to be made in the main menu, this is specifically described.
1C:Enterprise Operation Modes: The 1C:Enterprise system has two modes of operation: configuration setup and verification mode (hereinafter "Designer mode" or "Designer" to refer to configuration creation or modification) and configuration running mode (hereinafter "1C:Enterprise mode").
For the purposes of this guide, a user means a specialist who develops or supports a configuration.
The %APPDATA% expression refers to a Windows environment variable which contains a path to a directory (in the user profile) for the applications used for storing data. If the default installation is used (for the user name Ivanov), the path will appear as follows:
C:\Documents and Settings\Ivanov\Application Data
For Windows Vista and later versions the path will appear as follows:
C:\Users\Ivanov\AppData\Roaming
%LOCALAPPDATA% means a Windows Vista and above environment variable that contains a directory path (in the user’s profile) where user-specific application data resides. In a standard installation (for an Ivanov user) this path looks as follows:
C:\Users\Ivanov\AppData\Local