JSDoc: Global

Methods

(async) AddCategory(name)

Adaugă o categorie.

Necesită permisiunea: asicat.permission.WRITE_CATEGORIES

Parameters:

Name	Type	Description
`name`	string	Numele categoriei.

Since:

AsiCAT 1.17

Source:

ExtensionDocs.js, line 400

Throws:

O eroare dacă categoria deja există.

(async) AddPluginButton(textopt, callbackopt, tabopt, iconopt)

Adaugă un buton în bara de meniu.

Necesită permisiunea: asicat.permission.ADD_MENU_BUTTONS

Parameters:

Name	Type	Attributes	Default	Description
`text`	string	<optional>	"Buton neintitulat"	Textul butonului.
`callback`	function	<optional>	() => {}	Funcția de executat la apăsarea butonului.
`tab`	string	<optional>	"Extensii"	Numele tab-ului în care să fie adăugat butonul.
`icon`	string	<optional>	"fa-puzzle-piece"	Numele unei iconițe Font Awesome Free în stil solid.

Since:

AsiCAT 1.15

Source:

ExtensionDocs.js, line 179

Example

AsiCAT.AddPluginButton("Miau!", () => {
 AsiCAT.Dialog("Pisica face miau.", "Miau!");
}, "Generare", "fa-cat");

(async) AddTemplate(json)

Adaugă un șablon de ofertă.

Parameters:

Name	Type	Description
`json`	object	Obiectul JSON cu șablonul.

Since:

AsiCAT 1.19

Source:

ExtensionDocs.js, line 669

See:

Throws:

O eroare dacă datele sunt invalide sau șablonul deja există.

Example

// Obiectul JSON are următoarele proprietăți (toate sunt obligatorii):
// - presetCapable: Un boolean care spune dacă extensia poate fi presetată sau nu.
// - id: Un ID unic al extensiei. Este string.
// - name: Numele extensiei. Tot string.
// - desc: Descrierea extensiei. Tot string.
// - conf: Un obiect cu configurările cerute de extensie, la fel ca la RequestConfigs.
// - cb: Funcție ce generează șablonul.
// Primul argument este un obiect cu configurările introduse, la fel ca la RequestConfigs.
// Funcția returnează un string HTML ce va fi transformat în PDF și afișat.

// Exemplu
AsiCAT.AddTemplate({
 "presetCapable": true,
 "id": "text-cover",
 "name": "Copertă cu text centrat",
 "desc": "O pagină albă cu textul dvs. în centru.",
 "conf": {
     "requester-id": "text-cover",
     "requester-frn": "Copertă cu text centrat",
     "configs": [
       {
           "type": "string",
           "name": "text",
           "displayName": "Textul",
           "default": "Salut"
       }
     ]
 },
 "cb": async (configs) => {
   // Pentru a prelua font-ul ales din setări
   let prefs = await AsiCAT.GetSettings();
   // META CHARSET FOARTE IMPORTANT pentru a se afișa diacriticele
   return `<html><head><meta charset="UTF-8"></head><body style="display:flex;align-items:center;justify-content:center;text-align:center">
    <!-- Pentru a încărca font-ul Ubuntu -->
    ${await AsiCAT.GetFontLoads()}
    <h1 style="font-family: ${prefs.docFont},sans-serif;font-size:100px;">${await AsiCAT.SanitizeHTML(configs.text)}</h1>
</body></html>`
 }
});

(async) CreateElement(tagName) → {SanitizedHTMLElement}

Permite crearea unei versiuni sanitizate a unuia dintre elementele HTML permise, ce poate fi introdusă în program, de exemplu, în casete de dialog prin appendChild.

Parameters:

Name	Type	Description
`tagName`	string	Numele elementului dorit.

Since:

AsiCAT 1.15

Source:

ExtensionDocs.js, line 336

Returns:

Type: SanitizedHTMLElement

(async) CreateProduct(productopt) → {Object}

Creează un produs nou, dacă doriți și pe baza unor date existente.

Parameters:

Name	Type	Attributes	Default	Description
`product`	Object	<optional>	{}	Un obiect ce conține valorile dorite pentru produs. Valorile omise iau valorile prestabilite.

Since:

AsiCAT 1.15

Source:

ExtensionDocs.js, line 161

See:

GetProducts

Returns:

Type: Object

Example

// Restul câmpurilor capătă valori default
let product = await AsiCAT.CreateProduct({
 "name": "Acadele Înghețată Chiri Flax",
 "tvaInclus": false,
 "price": 6.42
});

(async) Dialog(options, titleopt) → {DialogBox}

Afișează o casetă de dialog. O versiune mai simplă a clasicului ShowDialog.

Parameters:

Name	Type	Attributes	Description
`options`	Object \| string		Un obiect cu opțiuni, sau HTML-ul conținut dacă se merge pe varianta simplă text + titlu.
`title`	string	<optional>	Titlul casetei de dialog. Folosit doar în varianta simplă, când options este string.

Since:

AsiCAT 1.16

Source:

ExtensionDocs.js, line 255

Returns:

Obiect reprezentând caseta de dialog.

Type: DialogBox

Examples

// Varianta simplă.
AsiCAT.Dialog("Salut!");
AsiCAT.Dialog("Ce mai faci?", "Salut!");

// Varianta normală.
AsiCAT.Dialog({
 "InnerHTML": "Faci <strong>bine</strong>?",
 "Title": "Salut!",
 "Cancelable": false,
 "Buttons": [
     {
         "Text": "Dap!"
     },
     {
         "Text": "Nope",
         "Callback": () => {
             AsiCAT.Dialog("Nu mai fi trist !");
         },
         "CloseOnClick": false
     }
 ]
});

// Așa arată obiectul de opțiuni. Nu trebuie specificate toate, ce nu se specifică ia valorile de aici.
{
   "InnerHTML": "", // Conținutul HTML. Tag-urile interzise sunt scoase.
   "Buttons": [ // Un array de maxim 3 butoane. Primul este pozitiv, apoi negativ și neutru.
       { // Btn pozitiv
           "Text": "<span class='fa-solid fa-check'></span> OK", // Textul. Mere și HTML.
           "Callback": () => {}, // Funcția de executat la click
           "CloseOnClick": true // Dacă se închide dialogul după click
       },
       { // Negativ
           "Text": "", // Textul. Mere și HTML.
           "Callback": () => {}, // Funcția de executat la click
           "CloseOnClick": true // Dacă se închide dialogul după click
       },
       { // Neutru
           "Text": "", // Textul. Mere și HTML.
           "Callback": () => {}, // Funcția de executat la click
           "CloseOnClick": true // Dacă se închide dialogul după click
       }
   ],
   "Cancelable": true, // Dacă dialogul poate fi închis.
   // Când este fals, nu mai merge închiderea cu Esc iar butonul X dispare.
   // Butoanele continuă să îl închidă la click.

   "Title": "", // Textul din bara de titlu
   "OnHelp": undefined, // Funcția pentru butonul Ajutor (?).
   "FocusSecondButton": false, // Dacă butonul negativ trebuie focusat by default (util pentru yes/no).
   "Fullscreen": false, // Dacă dialogul trebuie să umple toată fereastra, ex. editorul de imagini.

   // Funcție de executat la închiderea dialogului. Chiar dacă este async, închiderea va sta după ea.
   // Închiderea poate fi anulată executând .preventDefault() pe obiectul primit ca primul argument.
   "OnClose": () => {}
}

(async) DisposeAsset(asset) → {undefined}

Revocă URL-ul Blob pentru un asset, eliberându-l din RAM. Următoarea încercare de a prelua asset-ul va genera unul nou.

Parameters:

Name	Type	Description
`asset`	string	Numele asset-ului, la fel ca la GetAsset.

Since:

AsiCAT 1.19

Source:

ExtensionDocs.js, line 653

See:

GetAsset

Returns:

Nimic.

Type: undefined

Example

let imagine = await AsiCAT.GetAsset("imagini/caine.png", "image/png");
await faChestiiCuEl();
await AsiCAT.DisposeAsset("imagini/caine.png");
// URL-ul din variabila 'imagine' nu va mai funcționa.

(async) FindProductBySKU(sku) → {Object}

Returnează produsul cu codul specificat.

Necesită permisiunea: asicat.permission.READ_PRODUCTS

Parameters:

Name	Type	Description
`sku`	string	Codul de căutat.

Since:

AsiCAT 1.15

Source:

ExtensionDocs.js, line 467

See:

GetProducts

Returns:

Produsul, dacă a fost găsit. Semnificația proprietăților poate fi aflată cu funcția GetProperties.

Type: Object

(async) FindProductsBySKU(list) → {Array.<Object>}

Returnează o listă a produselor corespunzătoare codurilor furnizate, în același format ca GetProducts. Dacă un cod nu este găsit, acesta este omis.

Necesită permisiunea: asicat.permission.READ_PRODUCTS

Parameters:

Name	Type	Description
`list`	Array.<string>	O listă de coduri de produse.

Since:

AsiCAT 1.15

Source:

ExtensionDocs.js, line 454

See:

GetProducts

Returns:

O listă de obiecte JSON reprezentând produsele. Semnificația proprietăților poate fi aflată cu funcția GetProperties.

Type: Array.<Object>

(async) FindProductsBySku(list) → {Array.<Object>}

Parameters:

Name	Type	Description
`list`	Array.<string>	O listă de coduri de produse.

Since:

AsiCAT 1.15

Deprecated:

AsiCAT 1.16. Folosește identicul FindProductsBySKU

Source:

ExtensionDocs.js, line 27

See:

Returns:

O listă de obiecte JSON reprezentând produsele. Semnificația proprietăților poate fi aflată cu funcția GetProperties.

Type: Array.<Object>

(async) GetAsset(asset, mimetypeopt) → {string|undefined}

Preia un asset static din arhiva ZIP, și returnează un URL Blob către acesta.
Este disponibilă doar dacă au fost specificate asset-uri. Asset-urile trebuie specificate în manifest pentru a fi folosite.

Este o operațiune destul de scumpă, fiindcă citește fișierul ZIP de fiecare dată, dacă asset-ul nu e deja în cache. La apelurile ulterioare, se returnează același URL Blob din cache.
Când ați terminat cu asset-ul respectiv, iar acesta nu mai este afișat nicăieri, folosiți DisposeAsset pentru a îl elibera din memoria RAM.

Nu folosiți această funcție pentru fișiere foarte mari.

Parameters:

Name	Type	Attributes	Default	Description
`asset`	string			Numele asset-ului. Dacă este într-un subfolder, se separă cu /. Exemple: VALI VIJELIE.mp3, imagini/pisica.png.
`mimetype`	string	<optional>	"application/octet-stream"	Tipul fișierului. Exemple: image/png, text/plain, application/octet-stream.

Since:

AsiCAT 1.19

Source:

ExtensionDocs.js, line 619

See:

DisposeAsset

Returns:

Returnează un URL Blob către asset, sau undefined dacă nu a fost găsit.

Type: string | undefined

Example

AsiCAT.AddPluginButton("Pisică drăguță", async () => {
    // Preluăm asset-ul. Imaginea este în zip în dosarul 'imagini', și este specificată în manifest.
    // Nu uita mimetype-ul pentru fișiere media!
    let pisica = await AsiCAT.GetAsset("imagini/pisica.png", "image/png");
    // O afișăm.
    AsiCAT.Dialog({
        "Title": "Pisică drăguță",
        // Este efectiv un URL, deci putem face asta.
        "InnerHTML": `<img src="${pisica}" alt="Pisică drăguță"></img>`,
        // Îi dăm dispose la închiderea dialogului pentru a nu ocupa memoria degeaba.
        "OnClose": async () => {
            await AsiCAT.DisposeAsset("imagini/pisica.png");
            // URL-ul din 'pisica' nu va mai funcționa.
        }
    })
});

(async) GetCategories() → {Array}

Returnează o listă a tuturor categoriilor.

Necesită permisiunea: asicat.permission.READ_CATEGORIES

Since:

AsiCAT 1.15

Source:

ExtensionDocs.js, line 390

Returns:

Type: Array

(async) GetCompanyInfo() → {Object}

Obține informațiile firmei.

Necesită permisiunea: asicat.permission.READ_COMPANY_INFO

Since:

AsiCAT 1.15

Source:

ExtensionDocs.js, line 345

Returns:

Obiect JSON cu informațiile.

Type: Object

(async) GetFontLoads() → {string}

Returnează HTML-ul unui tag 'style', ce poate fi inclus într-un șablon pentru a încărca font-urile specifice AsiCAT (Ubuntu).

Since:

AsiCAT 1.19

Source:

ExtensionDocs.js, line 734

Returns:

Un tag style ()

Type: string

(async) GetLogoURI() → {string}

Returnează un URL blob către sigla firmei.

Necesită permisiunea: asicat.permission.READ_COMPANY_INFO

Since:

AsiCAT 1.15

Source:

ExtensionDocs.js, line 422

Returns:

Type: string

(async) GetProducts() → {Array.<Object>}

Returnează o listă cu toate produsele.

Necesită permisiunea: asicat.permission.READ_PRODUCTS

Since:

AsiCAT 1.15

Source:

ExtensionDocs.js, line 3

Returns:

O listă de obiecte JSON reprezentând produsele. Semnificația proprietăților poate fi aflată cu funcția GetProperties.

Type: Array.<Object>

(async) GetProperties() → {Array.<Object>}

Returnează o listă cu toate proprietățile ce le pot avea produsele.
Name - Numele proprietății în JSON-ul produsului
FriendlyName - Numele afișat utilizatorului
TableName - Numele afișat în tabel
OfertName - Numele afișat pe oferte
Show - Unde se va afișa proprietatea
Show.Oferta - true/false - dacă se afișează pe oferte
Show.App - true/false - dacă se afișează în lista de produse din program
Show.Editor - true/false - dacă se afișează în editorul de produse
Index - Utilizat intern de AsiCAT

Since:

AsiCAT 1.15

Source:

ExtensionDocs.js, line 86

Returns:

O listă de obiecte reprezentând proprietatea, având câmpurile menționate mai sus.

Type: Array.<Object>

Example

// Exemplu de obiect pentru proprietatea Preț:
 {
   "Name": "price",
   "FriendlyName": "Preț",
   "TableName": "Preț cu TVA",
   "OfertName": "Preț/cut",
   "Show": {
     "Oferta": true,
     "App": true,
     "Editor": true
   },
   "Index": "5"
 }

(async) GetPropertiesPairs() → {Array.<string, Object>}

La fel ca GetProperties, dar returnează un obiect cu perechi nume în produs - restul proprietăților.

Since:

AsiCAT 1.15

Source:

ExtensionDocs.js, line 118

See:

GetProperties

Returns:

O listă de obiecte reprezentând proprietatea, având câmpurile menționate mai sus.

Type: Array.<string, Object>

Example

// Exemplu de intrare pentru proprietatea Preț:
 "price": {
   "FriendlyName": "Preț",
   "TableName": "Preț cu TVA",
   "OfertName": "Preț/cut",
   "Show": {
     "Oferta": true,
     "App": true,
     "Editor": true
   },
   "Index": "5"
 }

(async) GetSettings() → {Object}

Obține setările programului.

Necesită permisiunea: asicat.permission.READ_SETTINGS

Obiectul JSON are următoarele proprietăți, ce corespund cu anumite opțiuni din program.
Atenție! Oricare poate fi undefined!

Proprietate	Tip	Setare corespunzătoare	Valori posibile
darkMode	boolean	Mod întunecat	true, false
docFont	string	Font oferte	serif, sans-serif, monospace, Ubuntu
hideTitleBar	boolean	Ascundeți bara de titlu	true, false
hideWindowControls	boolean	Ascundeți butoanele Minimizează și Maximizează	true, false
langGender	string	Adresare	m, f
paperLandscape	boolean	Orientarea hârtiei	true, false
paperSize	string	Mărimea hârtiei	A0, A1, A2, A3, A4, A5, A6, Legal, Letter, Tabloid, Ledger
prefersReducedMotion	boolean	Reduceți animațiile	true, false
uiFont	string	Font program	serif, sans-serif, monospace, Ubuntu

Since:

AsiCAT 1.15

Source:

ExtensionDocs.js, line 365

Returns:

Obiect JSON cu setările.

Type: Object

(async) GetVersion() → {string}

Returnează numele versiunii de AsiCAT care rulează.

Since:

AsiCAT 1.16

Source:

ExtensionDocs.js, line 573

Returns:

Numele versiunii. De ex: 1.16.

Type: string

Example

if (await AsiCAT.GetVersion() == "1.99") {
    throw new Error("BA ASTA POATE SA CALATOREASCA IN TIMP");
}

// Am fost deștepți rău și am adăugat funcția asta în a DOUA versiune publică.
// Dacă vrei musai și neapărat să suporți 1.15, folosește acest polyfill:
async function getVersion() {
    if ('GetVersion' in AsiCAT) {
        return await AsiCAT.GetVersion();
    } else {
        return "1.15";
    }
}

(async) GetVersionCode() → {number}

Returnează codul versiunii de AsiCAT care rulează.

Since:

AsiCAT 1.16

Source:

ExtensionDocs.js, line 596

Returns:

Codul versiunii. De ex: 18 pentru 1.16.

Type: number

Example

if (await AsiCAT.GetVersionCode > 99) {
    throw new Error("BA ASTA POATE SA CALATOREASCA IN TIMP");
}

// Am fost deștepți rău și am adăugat funcția asta în a DOUA versiune publică.
// Dacă vrei musai și neapărat să suporți 1.15, folosește acest polyfill:
async function getVersionCode() {
    if ('GetVersionCode' in AsiCAT) {
        return await AsiCAT.GetVersionCode();
    } else {
        return 17;
    }
}

(async) ListProductsInCategory(category) → {Array.<Object>}

Returnează o listă cu toate produsele din categoria respectivă.

Parameters:

Name	Type	Description
`category`	string	Numele categoriei.

Since:

AsiCAT 1.15

Source:

ExtensionDocs.js, line 212

See:

Returns:

Lista produselor, în același format ca GetProducts.

Type: Array.<Object>

(async) LoadingDialog() → {Object}

Afișează un dialog loading. Se închide prin .close() pe obiectul returnat.

Since:

AsiCAT 1.15

Source:

ExtensionDocs.js, line 560

Returns:

Obiect cu funcția close.

Type: Object

Example

let dlg = await AsiCAT.LoadingDialog();
await FaChestiiCareDureazaFoarteMult();
dlg.close();

(async) ParseProperty(product, property, role) → {string|number}

Procesează valoarea introdusă a unei proprietăți (în formatul tastat în ferestrele Adăugare/editare produs) pentru un anumit scop. Această conversie este aceeași cu cea făcută de AsiCAT în situațiile menționate.

Parameters:

Name	Type	Description
`product`	Object	Obiectul reprezentând produsul.
`property`	string	Numele proprietății așa cum apare în obiectul produsului. Ex: name, price, qtNextUnit.
`role`	string	Scopul în care se procesează proprietatea. Poate fi: check: Verifică dacă valoarea proprietății este validă și poate fi stocată. store: Convertește proprietatea într-un format ce poate fi atribuit în obiectul produsului, și salvat fără probleme. view: Convertește proprietatea în forma finală pentru afișarea către utilizator. Boolean-urile devin Da și Nu, prețurilor li se calculează TVA dacă este nevoie, etc. edit: Convertește proprietatea înapoi în formatul inițial, cel introdus, pentru precompletarea în editorul de produs.

Since:

AsiCAT 1.15

Source:

ExtensionDocs.js, line 141

See:

Returns:

Type: string | number

Example

// Sa presupunem ca este produsul nostru
let product = [...];
product.tvaInclus = true;
let tvaInclus = await AsiCAT.ParseProperty(product, "tvaInclus", "edit");
AsiCAT.Dialog(tvaInclus); //Afiseaza Da

(async) Prompt(titleopt, defopt, textopt) → {string}

Afișează un dialog de introducere text.

Parameters:

Name	Type	Attributes	Default	Description
`title`	string	<optional>	""	Titlul ferestrei.
`def`	string	<optional>	""	Valoarea default din text field.
`text`	string	<optional>	""	Textul din interiorul dialogului.

Since:

AsiCAT 1.17

Source:

ExtensionDocs.js, line 440

Returns:

Type: string

Example

let name = await AsiCAT.Prompt("Numele pisicii", "Kitty", "Cum o cheamă pe pisica ta?");

(async) RemoveCategory(name)

Elimină o categorie. Toate produsele din categoria respectivă sunt mutate în „Necategorizat”.

Necesită permisiunea: asicat.permission.WRITE_CATEGORIES

Parameters:

Name	Type	Description
`name`	string	Numele categoriei.

Since:

AsiCAT 1.17

Source:

ExtensionDocs.js, line 411

Throws:

O eroare dacă categoria nu există.

(async) RequestConfigs(conf) → {Object}

O funcție pentru a cere utilizatorului să introducă configurări pentru ceva.
Ca la configurările pentru șabloane.

Parameters:

Name	Type	Description
`conf`	Object	Configurările de cerut. Vezi exemplu.

Since:

AsiCAT 1.15

Source:

ExtensionDocs.js, line 480

See:

FindProductsBySKU

Returns:

Obiect conținând valorile introduse.

Type: Object

Example

let configs = await AsiCAT.RequestConfigs({ // Numele variabilei poate fi orice
   "requester-frn": "Ceva ce face extensia mea", // Numele afișat utilizatorului
   "configs": [ // Listă de configurări
     { // Exemplu pentru string
         "type": "string",
         "name": "numele",  // Nume unic pentru configurare. Se folosește pentru a accesa valoarea în obiectul returnat.
         "displayName": "Numele tău", // Nume afișat
         // Nu specificăm valoarea default aici, pt. ca nu e nevoie. Dar putem dacă vrem.
     },
     { // Boolean
         "type": "boolean",
         "name": "likeCats",
         "displayName": "Îți plac pisicile?",
         "default": true // Valoarea prestabilită
     },
     { // Exemplu multiline (aka textarea)
         "type": "multiline-string",
         "name": "bio",
         "displayName": "Biografie",
         "default": "Îmi plac pisicile.\n\nFoarte, foarte mult."
     },
     {   // Exemplu lista produse
         "type": "products",
         "name": "favCandy",
         "displayName": "Dulciurile preferate:",
         "default": ["1001", "1002", "1003"] // lista de coduri, poti sa omiti desigur
     },
     { // Exemplu dropdown (adăugat în 1.17)
         "type": "select",
         "name": "favAnimal",
         "displayName": "Animalul preferat",
         "list": ["Câinele", "Pisica", "Găina"],
         "default": "1" // adică a doua opțiune (sunt indexate de la 0)
     },
     { // Exemplu culoare (adăugat în 1.18)
         "type": "color",
         "name": "favColor",
         "displayName": "Culoarea preferată",
         "default": "#ffb400" // culoare hex
     },
     { // Exemplu categorii (adăugat în 1.19)
         "type": "categories",
         "name": "prodCats",
         "displayName": "Categoriile de produse preferate",
         "default": ["Acadele"]
     }
   ]
});

// Exemplu de utilizare.
let nume = configs.numele; // string
let pisicile = configs.likeCats; // true sau false
let biografie = configs.bio; // string
// La produse, se returneaza lista de coduri selectate.
let produse = await AsiCAT.FindProductsBySKU(configs.favCandy);
// La dropdown, se returnează index-ul opțiunii selectate (începând de la 0)
// 0 - câinele
// 1 - pisica
// 2 - găina
let favAnimals = ["Câinele", "Pisica", "Găina"];
let favAnimal = favAnimals[configs.favAnimal];
// Culoarea este în hex.
let favColor = configs.favColor;
myDiv.style.backgroundColor = favColor;
// Array cu numele categoriilor
let categorii = configs.prodCats;

(async) RequestRestart()

Cere repornirea programului, precum extensia preinstalată cu același nume.

Necesită permisiunea: asicat.permission.REQUEST_RESTART

Since:

AsiCAT 1.15

Source:

ExtensionDocs.js, line 197

Example

// Întreg codul extensiei Repornire program:
AsiCAT.AddPluginButton("Reporniți programul", () => {
     AsiCAT.RequestRestart();
}, undefined, "fa-rotate-right")

(async) SanitizeHTML(html) → {string}

Sanitizează HTML-ul, dând escape la toate caracterele periculoase.

Parameters:

Name	Type	Description
`html`	string	HTML-ul.

Since:

AsiCAT 1.19

Source:

ExtensionDocs.js, line 722

Returns:

String-ul sanitizat.

Type: string

Example

AsiCAT.SanitizeHTML("<p>Miau!</p>"); // &lt;p&gt;Miau!&lt;/p&gt;

(async) SaveCompanyInfo(info)

Salvează informațiile firmei.

Necesită permisiunea: asicat.permission.WRITE_COMPANY_INFO

Parameters:

Name	Type	Description
`info`	Object	Informațiile JSON.

Since:

AsiCAT 1.15

Source:

ExtensionDocs.js, line 355

(async) SaveProducts(json)

Salvează lista produselor din obiectul JSON furnizat, urmând sintaxa listei de produse returnată de GetProducts.
Se efectuează validare pentru a asigura integritatea datelor. În cazul în care verificarea eșuează, funcția dă eroare.

Necesită permisiunea: asicat.permission.WRITE_PRODUCTS

Parameters:

Name	Type	Description
`json`	Object	Obiectul ce conține lista produselor.

Since:

AsiCAT 1.15

Source:

ExtensionDocs.js, line 14

Throws:

O eroare dacă datele furnizate sunt invalide.

(async) ShowDialog(textopt, okBtnopt, okCallbackopt, cancelBtnopt, cancelCallbackopt, closeOnOkopt, closeOnCancelopt, neutralBtnopt, neutralCallbackopt, closeOnNeutralopt, cancelableopt, titleopt, onhelpopt) → {DialogBox}

Afișează o casetă de dialog. Folosiți în schimb Dialog. Unele opțiuni ale dialogurilor nu sunt accesibile cu ShowDialog.

Parameters:

Name	Type	Attributes	Default	Description
`text`	string	<optional>	""	HTML-ul din caseta de dialog. Tag-urile interzise sunt scoase.
`okBtn`	string	<optional>	"OK"	Textul butonului pozitiv (OK). Setați-l la un string gol ("") pentru a ascunde butonul.
`okCallback`	function	<optional>	() => {}	Funcția executată la click pe butonul pozitiv.
`cancelBtn`	string	<optional>	""	Textul butonului negativ (Anulare). Ascuns by default.
`cancelCallback`	function	<optional>	() => {}	Funcția executată la click pe butonul negativ.
`closeOnOk`	boolean	<optional>	true	Dacă caseta de dialog se va închide la click pe butonul pozitiv. Dacă este fals, aceasta va rămâne deschisă, dar poate fi închisă manual cu .close();
`closeOnCancel`	boolean	<optional>	true	Dacă caseta de dialog se va închide la click pe butonul negativ. Dacă este fals, aceasta va rămâne deschisă, dar poate fi închisă manual cu .close();
`neutralBtn`	string	<optional>	""	Textul butonului neutru (al treilea). Ascuns by default.
`neutralCallback`	function	<optional>	() => {}	Funcția executată la click pe butonul neutru.
`closeOnNeutral`	boolean	<optional>	true	Dacă caseta de dialog se va închide la click pe butonul neutru. Dacă este fals, aceasta va rămâne deschisă, dar poate fi închisă manual cu .close();
`cancelable`	boolean	<optional>	true	Dacă caseta de dialog poate fi închisă. Închiderea cu Esc este oprită iar butonul X dispare, însă butoanele încă pot s-o închidă.
`title`	string	<optional>	""	Textul din bara de titlu.
`onhelp`	function	<optional>		Funcția executată la click pe butonul Ajutor (?). Butonul apare doar dacă această funcție este specificată.

Since:

AsiCAT 1.15

Deprecated:

AsiCAT 1.16

Source:

ExtensionDocs.js, line 232

See:

Dialog

Returns:

Obiect reprezentând caseta de dialog.

Type: DialogBox

(async) ShowRawTextDialog()

Afișează un dialog de text neformatat. Un textarea mare.

Parameters:

Name	Type	Description
`Textul.`	string

Since:

AsiCAT 1.15

Source:

ExtensionDocs.js, line 432

(async) ShowToastError(text)

Afișează o notificare de eroare (cu accent roșu).

Necesită permisiunea: asicat.permission.SHOW_NOTIFICATIONS

Parameters:

Name	Type	Description
`text`	string	Textul notificării.

Since:

AsiCAT 1.15

Source:

ExtensionDocs.js, line 75

(async) ShowToastInfo(text)

Afișează o notificare de informare (cu accent albastru).

Necesită permisiunea: asicat.permission.SHOW_NOTIFICATIONS

Parameters:

Name	Type	Description
`text`	string	Textul notificării.

Since:

AsiCAT 1.15

Source:

ExtensionDocs.js, line 42

(async) ShowToastSuccess(text)

Afișează o notificare de succes (cu accent verde).

Necesită permisiunea: asicat.permission.SHOW_NOTIFICATIONS

Parameters:

Name	Type	Description
`text`	string	Textul notificării.

Since:

AsiCAT 1.15

Source:

ExtensionDocs.js, line 53

(async) ShowToastWarning(text)

Afișează o notificare de avertizare (cu accent galben).

Necesită permisiunea: asicat.permission.SHOW_NOTIFICATIONS

Parameters:

Name	Type	Description
`text`	string	Textul notificării.

Since:

AsiCAT 1.15

Source:

ExtensionDocs.js, line 64

(async) YesNoAsync(text, title) → {boolean}

Afișează o casetă de dialog cu butoane Da/Nu.

Parameters:

Name	Type	Description
`text`	string	Textul dialogului.
`title`	string	Titlul dialogului.

Since:

AsiCAT 1.19

Source:

ExtensionDocs.js, line 742

Returns:

True pentru da, false pentru nu.

Type: boolean

Type Definitions

DialogBox

Type:

Object

Properties:

Name	Type	Description
`setTitle`	function	Setează titlul ferestrei.
`close`	function	Închide fereastra.
`querySelector`	function	QuerySelector în dialog. Returnează SanitizedHTMLElement
`querySelectorAll`	function	QuerySelectorAll în dialog. Returnează SanitizedHTMLElement
`setClassName`	function	Schimbă classname-ul dialogului.

Source:

ExtensionDocs.js, line 223

SanitizedHTMLElement

Type:

Object

Properties:

Name	Type	Description
`addEventListener`	function
`querySelector`	function	Returnează SanitizedHTMLElement
`querySelectorAll`	function	Returnează SanitizedHTMLElement
`className`	string
`tagName`	string
`innerText`	string
`innerHTML`	string
`value`	string

Source:

ExtensionDocs.js, line 324