Свойства
| Свойство | Тип | Описание | Пример | Версия |
|---|---|---|---|---|
| SuccessSync | логический | Возвращает true, если последняя синхронизация была проведена успешно | function OnSync() {
if (DB.SuccessSync)
HandleSyncError();
}
| - |
| LastError | строка | Возвращает текст ошибки синхронизации. Возвращает null, если синхронизация была выполнена без ошибок | function HandleSyncError() {
$.txtReport.Text = DB.LastError;
}
| - |
| LastSyncTime | время | Возвращает время последней синхронизации | $.txtSync.Text = DB.LastSyncTime; | - |
| Size | число, целое | Возвращает размер файла базы данных в килобайтах | $.txtDbSize.Text = DB.Size.ToString(); | 2.2.2.101 |
Методы
| Метод | Описание | Параметры | Исключения | Пример | Версия |
|---|---|---|---|---|---|
Save() Obsolete | Сохраняет изменения в БД в рамках транзакции | function SaveChanges() {
DB.Save();
}
| - | ||
Sync() Sync(callback) Sync(callback, state) | Производит синхронизацию данных с сервером БИТ:Мобайл | callback - имя функции, вызываемой после выполнения синхронизации; state - объект, передаваемый в функцию обратного вызова в качестве параметра; Функция обратного вызова: (state), state - объект, переданный в качестве параметра state; | DB.Sync(SyncDataFinish, $.workflow.name); function SyncDataFinish(state) {
$.txtSyncComment.Text = state;
OnSync();
}
| - | |
| Create(name) | Создает новый экземпляр объекта | name - полное имя объекта | var order = DB.Create("Document.Order");
order.Outlet = outlet;
order.SR = userRef;
order.Save();
orderId = order.Id;
| - | |
| SelectById(name, id) | Возвращает экземпляр объекта по идентификатору | name - полное имя сущности ; id - идентификатор; | var order = DB.SelectById("Document.Order", orderId); | - | |
Delete(entityRef) Delete(entityRef, inTran) | Удаляет объект | entityRef - ссылка на объект inTran - установить false, для удаления сущности в обход транзакции | DB.Delete(orderId); | 2.3.5.108 | |
| EmptyRef(name) | Возвращает пустую ссылку на объект определенного типа | name - полное имя объекта; | var emptyOrderRef = DB.EmptyRef("Document.Order"); | - | |
| CreateRef(name, guid) | Создает ссылку на объект определенного типа Ответственность за ссылочную целостность ложится на разработчика | name - строка, полное имя объекта; guid - строка, идентификатор объекта | DBException
| var dbRef = DB.CreateRef("Document.Order", "e4875805-904d-4121-982b-8fa8753acf57");
| 2.3.14.119 |
| AsGuid(guidString) | Конвертирует строку к типу Guid | guidString - строка с текстом идентификатора; | var emptyGuid = DB.AsGuid("000000000-0000000-000000000"); | - | |
| Commit() | Сохраняет изменения в БД в рамках транзакции | function SaveChanges() {
DB.Commit();
}
| - | ||
| Rollback() | Откатывает изменения в БД в рамках транзакции | function DiscardChanges() {
DB.Rollback();
}
| - | ||
| CreateTable(name, columns[]) | Создает пользовательскую таблицу | name - имя таблицы, при создании платформа добавит суффикс 'UT_' к имени columns - массив имен колонок; | function OnLoad() {
DB.CreateTable("Filtered_Outlets", ["Id"]);
}
function LoadOutlets(){
var q = new Query("SELECT O.Id, O.Name "
+ "FROM Catalog_Outlets O"
+ "RIGHT JOIN UT_Filtered_Outlets U "
+ "ON (U.Id = O.Id)");
return q.Execute();
}
| 2.3.5.108 | |
| DropTable(name) | Удаляет пользовательскую таблицу | name - имя таблицы | function NextStep(){
DB.DeleteTable("Filtered_Outlets");
DoAction("Forward");
}
| 2.3.5.108 | |
| TruncateTable(name) | Очищает пользовательскую таблицу | name - имя таблицы | function Refresh(args){
DB.TruncateTable("Filtered_Outlets");
DoRefresh(args);
}
| 2.3.5.108 |
