Свойство | Тип | Описание | Пример | Версия |
---|
SuccessSyncExists | логический | Возвращает true, если |
последняя синхронизация была проведена успешнобаза данных решения создана | |
js | theme | Eclipse |
---|
| Database db = new Database();
if(!db.Exists)
db.CreateFromModel(); |
|
|
SyncIsActive | Логический | Возвращает true, при активной синхронизации |
function OnSync() {
if (DB.SuccessSync)
HandleSyncError();
} |
- | LastError | строка | Возвращает текст ошибки синхронизации. Возвращает null, если синхронизация была выполнена без ошибокjs | theme | Eclipse |
---|
function HandleSyncError() {
$.txtReport.Text = DB.LastError;
} |
- | LastSyncTime | время | Возвращает время последней синхронизации | $.txtSync.Text = DB.LastSyncTime; | - |
Size | число, целое | Возвращает размер файла базы данных в килобайтах | $.txtDbSize.Text = DB.Size.ToString(); | 2.2.2.101 |
Метод | Описание | Параметры | Исключения | Пример | Версия |
---|
CreateFromModel() | Создает базу данных sqlite на основании файла метаданных решения. Проект решения должен содержать файл метаданных, доступный по имени Model\metadata.xml |
|
| Блок кода |
---|
| Database db = new Database();
if(!db.Exists)
db.CreateFromModel(); |
|
Метод | Описание | Параметры | Исключения | Пример | Версия |
---|
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 | jsvar 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"); | void DeleteCountry(Catalog.Country country)
{
Database.Delete(country.Id, false);
}
|
| 3.0.0.0 |
- |
Commit() | Сохраняет изменения в БД в рамках транзакции |
| jsfunctionpublic class DB
{
private static Database db;
public static void Init()
{
db = new Database();
if(!db.Exists)
db.CreateFromModel();
}
public static void SaveChanges() |
|
DB | - |
Rollback() | Откатывает изменения в БД в рамках транзакции |
| jsfunctionpublic class DB
{
public static void DiscardChanges() |
|
DB | - |
CreateTable(name, columns[]) | Создает пользовательскую таблицу | name - имя таблицы, при создании платформа добавит суффикс 'UT_' к имени columns - массив имен колонок; |
| jsfunctionOnLoad()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();
}private static Database db;
public static void Init()
{
db = new Database();
if(!db.Exists)
{
db.CreateFromModel();
Database.CreateTable("Filtered_Outlets", new String[] {"Id"});
}
}
} |
| 3.0.0.0 |
2.3.5.108 |
DropTable(name) | Удаляет пользовательскую таблицу | name - имя таблицы |
| js functionDBDatabase.DeleteTable("Filtered_Outlets"); |
|
DoAction("Forward");2351080 |
TruncateTable(name) | Очищает пользовательскую таблицу | name - имя таблицы |
| jsfunctionargsDBDatabase.TruncateTable("Filtered_Outlets" |
|
);
DoRefresh(args);
} | 3.0.0.0 |
PerformSync(string url, string username, string password, ResultEventHandler<bool> handler, object state) | Синхронизирует данные между мобильным устройством и сервером |
|
| Блок кода |
---|
| var db = new Database();
db.PerformSync(@"http://bitmobile1.bt/bitmobileX/synctest/device","sr","sr", OnSyncComplete, "sync complete"); |
|
|
PerformSyncAsync(string url, string username, string password, ResultEventHandler<bool> handler, object state) | Синхронизирует данные между мобильным устройством и сервером в асинхронном режиме |
|
| Блок кода |
---|
| var db = new Database();
db.SyncAsync(@"http://bitmobile1.bt/bitmobileX/synctest/device","sr","sr", OnSyncComplete, "sync complete"); |
|
|
PerformFullSync(string url, string username, string password, ResultEventHandler<bool> handler, object state) | Загружает на мобильное устройство все доступные данные |
|
| Блок кода |
---|
| var db = new Database();
db.PerformFullSync(@"http://bitmobile1.bt/bitmobileX/synctest/device","sr","sr", OnSyncComplete, "sync complete"); |
|
|
PerformFullSyncAsync(string url, string username, string password, ResultEventHandler<bool> handler, object state) | Загружает на мобильное устройство все доступные данные в асинхронном режиме |
|
| Блок кода |
---|
| var db = new Database();
db.PerformFullSyncAsync(@"http://bitmobile1.bt/bitmobileX/synctest/device","sr","sr", OnSyncComplete, "sync complete"); |
|
2.3.5.108