Сравнение версий

Ключ

  • Эта строка добавлена.
  • Эта строка удалена.
  • Изменено форматирование.

Свойства

СвойствоТипОписаниеПримерВерсия
SuccessSync
ExistsлогическийВозвращает true, если
последняя синхронизация была проведена успешно
база данных решения создана
Блок кода
language
jsthemeEclipse
c#
Database db = new Database();
if(!db.Exists)
	db.CreateFromModel();

SyncIsActiveЛогическийВозвращает true, при активной синхронизации
function OnSync() {
	if (DB.SuccessSync)
		HandleSyncError();
}
-LastErrorстрокаВозвращает текст ошибки синхронизации. Возвращает null, если синхронизация была выполнена без ошибок
Блок кода
language
jsthemeEclipse
function HandleSyncError() {
	$.txtReport.Text = DB.LastError;
}
-LastSyncTimeвремяВозвращает время последней синхронизации$.txtSync.Text = DB.LastSyncTime;-Sizeчисло, целоеВозвращает размер файла базы данных в килобайтах$.txtDbSize.Text = DB.Size.ToString();2.2.2.101

Методы

c#
Database db = new Database();
if(db.SyncIsActive)
	 DConsole.WriteLine("Синхронизация запущена");

SuccessSyncЛогическийВозвращает true, если последняя синхронизация была проведена успешно
Блок кода
languagec#
Database db = new Database();
if(db.SuccessSync)
	 DConsole.WriteLine("Синхронизация выполнена успешно");

LastSyncTimeDateTimeВозвращает время последней синхронизации
Блок кода
languagec#
Database db = new Database();

	 DConsole.WriteLine("Дата последней синхронизации" + db.LastSyncTime.ToString());

LastSyncErrorStringВозвращает текст ошибки синхронизации. Возвращает null, если синхронизация была выполнена без ошибок
Блок кода
languagec#
Database db = new Database();
if(db.SuccessSync)
	 DConsole.WriteLine("Произошла ошибка синхронизации + db.LastSyncError.ToString());


Методы

МетодОписаниеПараметрыИсключенияПримерВерсия
CreateFromModel()Создает базу данных sqlite на основании файла метаданных решения. Проект решения должен содержать файл метаданных, доступный по имени Model\metadata.xml

Блок кода
languagec#
Database db = new Database();
if(!db.Exists)
	db.CreateFromModel();
МетодОписаниеПараметрыИсключенияПримерВерсия

Save()

Obsolete

Сохраняет изменения в БД в рамках транзакции  
Блок кода
languagejs
themeEclipse
function SaveChanges() {
	DB.Save();
}
-

Sync()

Sync(callback)

Sync(callback, state)

Производит синхронизацию данных с сервером БИТ:Мобайл

callback - имя функции, вызываемой после выполнения синхронизации;

state - объект, передаваемый в функцию обратного вызова в качестве параметра;

Функция обратного вызова: (state),

state - объект, переданный в качестве параметра state;

 
Блок кода
languagejs
themeEclipse
 DB.Sync(SyncDataFinish, $.workflow.name);
Блок кода
languagejs
themeEclipse
function SyncDataFinish(state) {
	$.txtSyncComment.Text = state;
	OnSync();
}
-Create(name)Создает новый экземпляр объектаname - полное имя объекта 
Блок кода
languagejs
themeEclipse
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.108EmptyRef(name)Возвращает пустую ссылку на объект определенного типаname - полное имя объекта; var emptyOrderRef = DB.EmptyRef("Document.Order");-CreateRef(name, guid)

Создает ссылку на объект определенного типа

ПредупреждениеОтветственность за ссылочную целостность ложится на разработчика


name - строка, полное имя объекта;

guid - строка, идентификатор объекта

DBException

  • Некорректный guid

 


Блок кода
language
js
c#
themeEclipse
var dbRef = DB.CreateRef("Document.Order", "e4875805-904d-4121-982b-8fa8753acf57");
2.3.14.119AsGuid(guidString)Конвертирует строку к типу GuidguidString - строка с текстом идентификатора; var emptyGuid = DB.AsGuid("000000000-0000000-000000000");
void DeleteCountry(Catalog.Country country)
{
	Database.Delete(country.Id, false);
}
 
3.0.0.0
-
Commit()Сохраняет изменения в БД в рамках транзакции
  


Блок кода
language
js
c#
themeEclipse
function
public class DB
{
	private static Database db;
 
	public static void Init()
	{
		db = new Database();
		if(!db.Exists)
			db.CreateFromModel();
	}
 
	public static void SaveChanges()
 
	{
		
DB
db.Commit();
	}
}
-
Rollback()Откатывает изменения в БД в рамках транзакции
 
 


Блок кода
language
js
c#
themeEclipse
function
public class DB
{
	public static void DiscardChanges()
 
	{
		
DB
db.Rollback();
	}
}
-
CreateTable(name, columns[])Создает пользовательскую таблицу

name - имя таблицы, при создании платформа добавит суффикс 'UT_' к имени

columns - массив имен колонок;

 

Блок кода
language
js
c#
themeEclipse
function
public 
OnLoad()
class DB
{
	
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 - имя таблицы
 

Блок кода
language
js
c#
themeEclipse
 function
void NextStep(){
	
DB
Database.DeleteTable("Filtered_Outlets");
	
DoAction("Forward");

}
2
3.
3
0.
5
0.
108
0
TruncateTable(name)Очищает пользовательскую таблицуname - имя таблицы
 

Блок кода
language
js
c#
themeEclipse
function
void Refresh(
args
){
	
DB
Database.TruncateTable("Filtered_Outlets"
); DoRefresh(args); }
);
}
3.0.0.0

PerformSync(string url, string username, string password, ResultEventHandler<bool> handler, object state)

Синхронизирует данные между мобильным устройством и сервером


Блок кода
languagec#
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)

Синхронизирует данные между мобильным устройством и сервером в асинхронном режиме

Блок кода
languagec#
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)

Загружает на мобильное устройство все доступные данные

Блок кода
languagec#
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)

Загружает на мобильное устройство все доступные данные в асинхронном режиме

Блок кода
languagec#
var db = new Database();
db.PerformFullSyncAsync(@"http://bitmobile1.bt/bitmobileX/synctest/device","sr","sr", OnSyncComplete, "sync complete");
2.3.5.108