Arhiva Razvoj - Tomislav Stanković

Dohvaćanje podataka s API-ja Sudskog registra data.gov.hr

Prije nekoliko godina objavio sam blog post o prikazu podataka API-ja Sudskog registra – pravosudje.hr.

API se tada nalazio na adresi https://sudreg-api.pravosudje.hr, dok će se od 1. travnja nalaziti na adresi https://sudreg-data.gov.hr/.

Više o detaljima i razlozima prebacivanja API-ja na novu adresu možete saznati na https://data.gov.hr/ckan/dataset/sudski-registar.

Ukratko, to znači da se osim URL-a putem kojega će se pozivati API mijenjaju i parametri potrebni za pristup tim podacima.

“Portal otvorenih podataka Sudskog registra namijenjen je razvojnim inženjerima koji u svoja aplikativna rješenja žele preuzimati podatke Sudskog registra (https://sudreg.pravosudje.hr) u strojno čitljivom obliku.

Za pristup podacima potrebno je napraviti registraciju. Nakon uspješno predanog registracijskog obrasca korisnik će dobiti e-mail za potvrdu svog korisničkog računa. Verifikacijom računa korisnik će biti preusmjeren na stranice aplikacije te će mu se dodijeliti Client ID, Client Secret i link za dohvat tokena koji omogućuju pristup RESTapi sučeljima.”

Registracija i aktivacija

Prije registracije potrebno je prijaviti se, a to je moguća napraviti korištenjem e-građana te putem servisa Facebook, Google i Microsoft na linku https://data.gov.hr/ckan/dataset/sudski-registar i klikom na ‘Prijava’ u gornjem desnom kutu ekrana.

Nakon prijave mogu se vidjeti detalji o postupku registracije i što se njome dobije. Klikom na “Registracija” pokreće se postupak.

Klikom na “Registracija” otvara se jednostavna forma gdje se navodi naziv i opis projekta u kojemu će se koristiti API.

Klikom na “Predaj zahtjev” otvara se sljedeći ekran gdje se vide detalji poput parametara Client Id i Client Secret koji će biti potrebni za slanje upita na API tj. dobivanje tokena.

Prije nego se prikazani podaci mogu koristiti potrebno je potvrditi tj. verificirati e-mail klikom na “Potvrdi”.

Nakon toga preostaje još kliknuti na “Aktivacija” i to je to što se registracije tiče.

I konačno, podaci su spremni za korištenje.

Provjera rada API-ja

Kako je i navedeno u dokumentaciji API mogu provjeriti koristeći Curl (Client for URL) naredbu i to želim napraviti prije nego krenem s postavljanjem Angular forme.

Naredba se upisuje u naredbeni redak (CMD) u sljedećem obliku: curl -i -k --user ClientId:ClientSecret --data "grant_type=client_credentials" https://sudreg-data.gov.hr/api/oauth/token

Iz navedenog mogu vidjeti u kojem obliku i koje parametre će mi API vratiti. U ovom slučaju najvažniji mi je parametar access_token koji će mi trebati prilikom pozivanja drugih API-ja.

Također vidim da token vrijedi 6 sati (21600 sekundi) od trenutka kreiranja.

Dohvaćanje tokena testirat ću i koristeći Postman.

Odmah ću, također putem Curl naredbe, isprobati jedan API u kojem ću proslijediti access_token da bi dobio podatke. Želim se uvjeriti da sve radi prije nego počnem s kreiranjem API servisa u Angularu.

Pokretanjem Curl naredbe curl --location "https://sudreg-data.gov.hr/api/javni/sudovi?expand_relations=true" ^ --header "Content-Type: application/json" ^ --header "Authorization: Bearer access_token" dobijem sljedeće:

Kako se može vidjeti iz gornje naredbe ovdje prosljeđujem samo dva parametara u headeru i već sam dobio “osjećaj” kako će funkcionirati svi ostali API pozivi.

Nadam se bez grešaka koje neki od njih trenutno imaju. 🙂

API detalji_subjekta

S obzirom da me API detalji_subjekta trenutno najviše zanima više ću pažnje obratiti na njega što se tiče dokumentacije.

Na adresi https://sudreg-data.gov.hr/api/OpenAPIs/OpenAPIJavni se nalaze sve dostupne API točke. Između ostalog tu je i detalji_subjekta.

Iz dokumentacije vidim da se radi o get metodi i koje obavezne parametre trebam slati.

Kreiranje API servisa

U servisu će se nalaziti dvije funkcije. Jedna će dohvaćati access_token, a druga podatke o tvrtki prema OIB-u ili MBS-u.

Obavezni parametri za dobivanje tokena:

Content-Type (string) / header – ‘application/x-www-form-urlencoded’
Authorization (string) / header – ‘Basic ‘ + btoa(‘ClientId:ClientSecret’)
grant_type (string) / body – client_credentials

import { Injectable } from '@angular/core';
import { HttpClient, HttpHeaders } from '@angular/common/http';
import { map } from 'rxjs/operators';

@Injectable({
  providedIn: 'root'
})
export class ApiService {

  sudregURL: string = "https://sudreg-data.gov.hr/api/";

  constructor(
    private _http: HttpClient
  ){}

  getToken(){
    const headers = new HttpHeaders({
      'Content-Type': 'application/x-www-form-urlencoded',
      'Authorization': 'Basic ' + btoa('ClientId:ClientSecret')
    });

    const body = new URLSearchParams();
    body.set('grant_type', 'client_credentials');

    return this._http.post(this.sudregURL + 'oauth/token', body.toString(), { headers });
  }

  detaljiSubjekta(access_token: string, tip_identifikatora: string, identifikator: string){
    const headers = new HttpHeaders({
      'Content-Type': 'application/json',
      'Authorization': 'Bearer ' + access_token
    });

    return this._http.get(this.sudregURL + 'javni/detalji_subjekta?expand_relations=true&tip_identifikatora='+tip_identifikatora+'&identifikator='+identifikator, { headers })
          .pipe(map((res: any) => res ));
  }

}

import { Injectable } from '@angular/core';

import { HttpClient, HttpHeaders } from '@angular/common/http';

import { map } from 'rxjs/operators';

@Injectable({

providedIn: 'root'

})

export class ApiService {

sudregURL: string = "https://sudreg-data.gov.hr/api/";

constructor(

private _http: HttpClient

){}

getToken(){

const headers = new HttpHeaders({

'Content-Type': 'application/x-www-form-urlencoded',

'Authorization': 'Basic ' + btoa('ClientId:ClientSecret')

});

const body = new URLSearchParams();

body.set('grant_type', 'client_credentials');

return this._http.post(this.sudregURL + 'oauth/token', body.toString(), { headers });

}

detaljiSubjekta(access_token: string, tip_identifikatora: string, identifikator: string){

const headers = new HttpHeaders({

'Content-Type': 'application/json',

'Authorization': 'Bearer ' + access_token

});

return this._http.get(this.sudregURL + 'javni/detalji_subjekta?expand_relations=true&tip_identifikatora='+tip_identifikatora+'&identifikator='+identifikator, { headers })

.pipe(map((res: any) => res ));

}

Obavezni parametri za dohvaćanje detalja tvrtke:

Content-Type (string) / header – ‘application/json’
Authorization (string) / header – ‘Bearer ‘ + access_token
tip_identifikatora (string) / query – ‘oib’ ili ‘mbo’
identifikator (string) / query – 0000000000 ili 000000000

Angular forma

Forma će biti jednostavna. Nakon unosa OIB-a ili MBS-a popunit će se polja naziv, adresa i grad. API naravno dohvaća puno više od toga.

<div class="page-content">
    <form class="modal-content" id="angularForma" [formGroup]="angularForma">
      <div class="modal-header p-4">
        <h5 class="modal-title">Provjera poslovnog subjekta</h5>
      </div>
      <div class="modal-body p-4">
        <div class="form-group row">
          <div class="col-sm-6">
            <label for="oib">OIB:</label>
            <input class="form-control form-control-line" id="oib" type="text" pattern="[-+]?[0-9]*[.,]?[0-9]+" minlength="11" maxlength="11" formControlName="oib" (keyup)="dohvatiDetalje(angularForma)">
          </div>
          <div class="col-sm-6">
            <label for="mbs">MBS:</label>
            <input class="form-control form-control-line" id="mbs" type="text" pattern="[-+]?[0-9]*[.,]?[0-9]+" minlength="9" maxlength="9" formControlName="mbs" (keyup)="dohvatiDetalje(angularForma)">
          </div>
        </div>
        <div class="form-group">
          <label for="naziv">Naziv:</label>
          <input class="form-control form-control-line" id="naziv" type="text" formControlName="nazivtvrtke">
        </div>
        <div class="form-group">
          <label for="adresa">Adresa:</label>
          <input class="form-control form-control-line" id="adresa" type="text" formControlName="ulica">
        </div>
        <div class="form-group">
          <label for="grad">Grad:</label>
          <input class="form-control form-control-line" id="grad" type="text" formControlName="grad">
        </div>
      </div>
    </form>
</div>

<h5 class="modal-title">Provjera poslovnog subjekta</h5>

</div>

</div>

</div>

<label for="naziv">Naziv:</label>

</div>

<label for="adresa">Adresa:</label>

</div>

</div>

</form>

</div>

Što se funkcionalnosti tiče i s obzirom da je ovo samo demo prikaz neću ići previše u detalje.

Unutar ngOnInit() funkcije pozivam API za dohvaćanje tokena. U produkcijskom okruženju ne bih to radio na ovaj način nego bih spremio token i novi ne bih tražio sljedećih 6 sati dok trenutni ne istekne.

import { Component, OnInit } from '@angular/core';
import { FormBuilder, FormGroup, ReactiveFormsModule, Validators } from '@angular/forms';
import { RouterOutlet } from '@angular/router';

import { ApiService } from './api.service';
import { CommonModule } from '@angular/common';
import { FormControl } from '@angular/forms';

@Component({
  selector: 'app-root',
  standalone: true,
  imports: [CommonModule, RouterOutlet, ReactiveFormsModule],
  templateUrl: './app.component.html',
  styleUrl: './app.component.scss'
})
export class AppComponent implements OnInit {

  angularForma!: FormGroup;
  
  title = 'API - Sudreg';
  access_token: string = '';

  constructor(
    private _fb: FormBuilder,
    private _apiService: ApiService
  ){
    this.angularForma = this._fb.group({
        oib: ['', [Validators.required, Validators.minLength(11), Validators.maxLength(11), Validators.pattern('[-+]?[0-9]*[.,]?[0-9]+')]],
        mbs: ['', [Validators.required, Validators.minLength(9), Validators.maxLength(9), Validators.pattern('[-+]?[0-9]*[.,]?[0-9]+')]],
        nazivtvrtke: new FormControl({ value: '', disabled: true }),
        ulica: new FormControl({ value: '', disabled: true }),
        grad: new FormControl({ value: '', disabled: true })
    });
  }

  ngOnInit(){
    this._apiService.getToken().subscribe((res: any) => { this.access_token = res.access_token; });
  }

  dohvatiDetalje(angularForma: FormGroup){
    if(angularForma.value.oib && angularForma.value.oib.length == 11){
      console.log("Dohvaćam detalje...");
      this._apiService.detaljiSubjekta(this.access_token, 'oib', angularForma.value.oib).subscribe(res => {
        console.log("Detalji tvrtke:");
        console.log(res);
        if(res){
            this.angularForma = this._fb.group({
              oib: res.oib,
              mbs: res.mbs,
              nazivtvrtke: res.skracena_tvrtka['ime'],
              ulica: res.sjediste['ulica'] + ' ' + res.sjediste['kucni_broj'] + (res.sjediste['kucni_podbroj'] ? (res.sjediste['kucni_podbroj']) : ''),
              grad: res.sjediste['naziv_naselja']
            });
        } else {
          alert("Neuspješno dohvaćanje podataka prema OIB-u!");
          this.angularForma.controls['oib'].setValue(null);
        } 
      });
    } else if (angularForma.value.mbs && angularForma.value.mbs.length == 9){
        this._apiService.detaljiSubjekta(this.access_token, 'mbs', angularForma.value.mbs).subscribe(res => {
          if(res){
              this.angularForma = this._fb.group({
                oib: res.oib,
                mbs: res.mbs,
                nazivtvrtke: res.skracena_tvrtka[0].ime,
                ulica: res.sjediste['ulica'] + ' ' + res.sjediste['kucni_broj'] + (res.sjediste['kucni_podbroj'] ? (res.sjediste['kucni_podbroj']) : ''),
                grad: res.sjediste['naziv_naselja']
              });
          } else {
            alert("Neuspješno dohvaćanje podataka prema MBS-u!");
            this.angularForma.controls['mbs'].setValue(null);
          }
        });
    }
  }

}

import { Component, OnInit } from '@angular/core';

import { FormBuilder, FormGroup, ReactiveFormsModule, Validators } from '@angular/forms';

import { RouterOutlet } from '@angular/router';

import { ApiService } from './api.service';

import { CommonModule } from '@angular/common';

import { FormControl } from '@angular/forms';

@Component({

selector: 'app-root',

standalone: true,

imports: [CommonModule, RouterOutlet, ReactiveFormsModule],

templateUrl: './app.component.html',

styleUrl: './app.component.scss'

})

export class AppComponent implements OnInit {

angularForma!: FormGroup;

title = 'API - Sudreg';

access_token: string = '';

constructor(

private _fb: FormBuilder,

private _apiService: ApiService

){

this.angularForma = this._fb.group({

oib: ['', [Validators.required, Validators.minLength(11), Validators.maxLength(11), Validators.pattern('[-+]?[0-9]*[.,]?[0-9]+')]],

mbs: ['', [Validators.required, Validators.minLength(9), Validators.maxLength(9), Validators.pattern('[-+]?[0-9]*[.,]?[0-9]+')]],

nazivtvrtke: new FormControl({ value: '', disabled: true }),

ulica: new FormControl({ value: '', disabled: true }),

grad: new FormControl({ value: '', disabled: true })

});

}

ngOnInit(){

this._apiService.getToken().subscribe((res: any) => { this.access_token = res.access_token; });

}

dohvatiDetalje(angularForma: FormGroup){

if(angularForma.value.oib && angularForma.value.oib.length == 11){

console.log("Dohvaćam detalje...");

this._apiService.detaljiSubjekta(this.access_token, 'oib', angularForma.value.oib).subscribe(res => {

console.log("Detalji tvrtke:");

console.log(res);

if(res){

this.angularForma = this._fb.group({

oib: res.oib,

mbs: res.mbs,

nazivtvrtke: res.skracena_tvrtka['ime'],

ulica: res.sjediste['ulica'] + ' ' + res.sjediste['kucni_broj'] + (res.sjediste['kucni_podbroj'] ? (res.sjediste['kucni_podbroj']) : ''),

grad: res.sjediste['naziv_naselja']

});

} else {

alert("Neuspješno dohvaćanje podataka prema OIB-u!");

this.angularForma.controls['oib'].setValue(null);

}

});

} else if (angularForma.value.mbs && angularForma.value.mbs.length == 9){

this._apiService.detaljiSubjekta(this.access_token, 'mbs', angularForma.value.mbs).subscribe(res => {

if(res){

this.angularForma = this._fb.group({

oib: res.oib,

mbs: res.mbs,

nazivtvrtke: res.skracena_tvrtka[0].ime,

ulica: res.sjediste['ulica'] + ' ' + res.sjediste['kucni_broj'] + (res.sjediste['kucni_podbroj'] ? (res.sjediste['kucni_podbroj']) : ''),

grad: res.sjediste['naziv_naselja']

});

} else {

alert("Neuspješno dohvaćanje podataka prema MBS-u!");

this.angularForma.controls['mbs'].setValue(null);

}

});

}

U praksi to izgleda ovako. Unosom OIB-a ili MBS-a poziva se funkcija za dohvaćanje detalja poslovnog subjekta.

Jednom kada access_token istekne dobit će se poruka

I to je to. Istovremeno vrlo jednostavan i vrlo koristan API koji može poboljšati funkcionalnosti nekog programskog rješenja.

Capacitor ili Cordova za razvoj Ionic aplikacija?

Ionic aplikacije razvijam od 2015. godine i sve do prije nešto više od godinu dana temeljio sam ih primarno na Cordovi.

Usput sam pratio razvoj Capacitora koji je sa verzijama 3 i 4 počeo “dobivati oblik” s kojim sam bio zadovoljan. Tada sam zaključio da može poslužiti kao temelj novih, ali i postojećih projekata.

Cordova pripada prošlosti

Ako se pogleda samo činjenica da je Cordova nastala 2009., a Capacitor 2018. više je nego jasno da među njima vrlo vjerovatno postoje dosta velike razlike. Bile one konceptualne ili praktične ipak su razlike.

Godinama je bilo gotovo nezamislivo pristupiti nekim značajkama mobilnih uređaja bez nekoliko Cordova pluginova u različitim stupnjevima razvoja i održavanja, a sada je stiglo nativno.

Također, kroz godine se povećavao naglasak na sigurnosti mobilnih aplikacija pa tako Google i Apple više neće pustiti bilo što u svoje trgovine aplikacijama. Pri tome održavanje postojećih, a pogotovo razvoj novih aplikacija temeljenih na Cordovi gubi svoj smisao.

Capacitor nije zamjena za Cordovu

Ovo je i najveća zabluda developera koji su toliko navikli na Cordovu da Capacitoru ne žele dati niti šansu jer misle da sada moraju sve mijenjati i raditi ispočetka.

Capacitor je kompatibilan sa Cordovom tako da niti migracija nije veliki problem i moguće ju je raditi postupno. Ako i dođete u slučaj da ipak trebate neki stariji Cordova plugin moći ćete ga dodati u postojeći Ionic Capacitor projekt.

Iako Capacitor i Cordova mogu raditi zajedno osobno mi je cilj u svim projektima postupno skroz napustiti Cordovu.

Prednosti Capacitora

Najveća prednost je skroz druga filozofija razvoja aplikacija, koja je više prilagođena današnjem tehnološkim potrebama. Ali da ne bi sve ostalo na filozofiranju evo i konkretnih prednosti koje mi se osobno sviđaju.

Brži i jednostavniji build/deploy aplikacija

Postavljanje na Google Play Store i Apple App Store nešto je čime završi svaki novi ciklus razvoja nove ili održavanja postojeće aplikacije. To je proces koji se ponavlja i kao takav je važno da bude što jednostavniji.

Capacitor omogućava brže i jednostavnije kreiranje produkcijskog builda. Kod Android aplikacija sve ide putem Android Studia. Kod iOS-a mi je isto kao i do sada, s tom razlikom da više nema problema s nekompatibilnosti verzija nekih pluginova.

Manja ovisnost o pluginovima

Capacitor donosi nativne funkcionalnosti, kao npr. Deep Link, za koje više nisu potrebni pluginovi što je bio slučaj sa Cordovom. Samim time manje toga je potrebno posebno ažurirati i usklađivati po pitanju verzija.

Svaki plugin manje donosi aplikaciju koju je lakše održavati.

Jednostavna migracija

Općenito kada se prelazi sa tehnologije na tehnologiju u dosta slučajeva su u pitanju toliko velike promjene da je jednostavnije sve raditi ispočetka. To nije slučaj kod Capacitora.

Iako donosi značajne promjene, Capacitor u prvoj fazi migracije može poslužiti samo kao temelj. Čak i kada se ostave postojeći Cordova pluginovi. Kada se savlada taj korak, onda lagano migrirati ili uklanjati plugin po plugin. Kod pluginova koji nisu kompatibilni sa Capacitorom potrebno je odmah planirati adekvatnu zamjenu.

Izrada nove aplikacije

Kada se kreira nova aplikacija u startu je sasvim lijepo vidjeti da više ne postoji ovisnost o config.xml-u. Platformske postavke su sada ondje gdje i trebaju biti – u datotekama pojedine platforme. Za Android je to AndroidManifest.xml, a za iOS Info.plist.

To je super. Jer koliko god se prije pisalo “programiraš jednom za sve platforme” u praksi to često nije bio slučaju kada su u pitanju razlike između iOS-a i Androida.

Zaključak

Iz svega navedenog meni je Capacitor jedini logičan izbor i jedva čekam vidjeti što će novog donijeti.

Implementacija CorvusPay kartičnog plaćanja koristeći Node.js, Express.js i Angular

U ovom blog postu možete saznati kako implementirati CorvusPay kartično plaćanje koristeći Node.js tj. Express.js i Angular Framework.

Kartično plaćanje provodi se kroz Corvus Form Service što znači da korisnik nakon odabira artikala bude preusmjeren na URL za autorizaciju kreditne kartice. Na tom URL-u ispunjava se obrazac s potrebnim podacima o kreditnoj kartici nakon čega korisnik ponovno bude preusmjeren na web shop gdje se najčešće prikazuje poruka o ne/uspješnoj kupovini.

Tijek transakcije kroz CorvusPay sustav odvija se na sljedeći način:

Kupac u web trgovini odabire proizvod ili uslugu koju želi platiti karticom.

Kupac se preusmjerava sa stranice trgovca na CorvusPay platnu formu (stranicu) gdje unosi podatke potrebne za realizaciju kartične transakcije.

CorvusPay šalje banci zahtjev za autorizacijom.

Banka šalje odgovor na zahtjev za autorizacijom na CorvusPay.

CorvusPay preusmjerava kupca na cancel ili success url kojeg definira trgovac ovisno o ishodu transakcije.

Moguća je i integracija tog obrasca unutar web shopa, ali u tom slučaju trgovac mora imati PCI DSS certifikat.

Tijek implementacije

Proces se istovremeno odvija u dva smjera. Prvi se tiče administrativnih poslova u kojima Corvus od trgovca prikuplja potrebnu dokumentaciju za pokretanje procesa aktivacije kartičnog plaćanje koju prosljeđuje prema bankama/kartičnim kućama.

Paralelno trgovac (web shop) postavlja obavezan sadržaj na web trgovinu (uvjeti korištenja i plaćanja, logo CorvusPaya,…), vrši implementaciju prema dostupnim uputama i testira sustav pomoću razvojnog certifikata. Nakon obavljenih testova postavlja se produkcijski certifikat čime se proces implementacije završava.

Uvod

Komunikacija između trgovca i usluge CorvusPay vrši se putem HTTPS POST web zahtjeva.

Svaki web zahtjev prema Corvusu treba obavezno sadržavati tri parametra, a to su:

– Store ID
– Secret Key
– Client Certificate (.p12).

Dobiju se dva seta ovih podataka. Jedan set za testiranje, a drugi za produkciju.

Obavezni CorvusPay parametri

Obavezni parametri su: version, store_id, order_number, language, currency, amount, cart, signature i require_complete.

U slučaju greške pri kreiranju parametara prikazat će se sljedeći ekran:

CorvusPay greška — Vaš zahtjev ne može biti obrađen – CorvusPay

order_number mora biti jedinstven jer sustav će provjeriti i odbiti svaki upit na Corvus API ako narudžba s istim brojem narudžbe već postoji.

signature se kreira koristeći HMAC-SHA256. On se sastoji od svih obaveznih i opcionalnih vrijednosti (key-value field pairs), poredanih abecedno i spojenih bez razmaka.

To onda izgleda ovako:

amount10.00cartkindlepaperwhitecurrencyHRKlanguagehrorder_number1537270065109require_completefalsestore_id2029version1.3

1	amount10.00cartkindlepaperwhitecurrencyHRKlanguagehrorder_number1537270065109require_completefalsestore_id2029version1.3

na osnovu čega se dobije signature

6cc62fa239555f790b5665d4b002faa5b1d90ded5e4caa3e70d37a4db88d6d51

1	6cc62fa239555f790b5665d4b002faa5b1d90ded5e4caa3e70d37a4db88d6d51

signature = HMAC-256(key, key-value field pairs)

~ ključ: UNV3-i2otJw0rUWzA2lpcNRqTOYRWdAeTw
~ parametri:
– version : 1.3
– store_id : 2029
– order_number : 1537270065109
– amount : 10.00
– currency : HRK
– cart : kindle paperwhite
– require_complete : false
– language : hr

CorvusPay HTTPS POST — CorvusPay Integration Manual v5.1.0

Neobavezni CorvusPay parametri

Osim obaveznih parametara moguće je koristiti i neobavezne. U ovom slučaju to će biti parametri vezani uz plaćanje na rate.

Tri su načina pokretanja transakcije na rate:
• Fiksni broj rata
• Fleksibilan broj rata
• Samostalan odabir rata za određenu karticu

Napomene:
• Ako se za određenu platnu karticu ne pošalje parametar payment_brandName kartica neće biti dostupna za odabir
• Prvi znak parametra payment_ trebao bi biti jednak N ili Y jer to označava je li dozvoljeno jednokratno plaćanje ili ne
• Posljednja četiri znaka određuju raspon broja rata. Kupac može odabrati broj rata u rasponu između prvog dvoznamenkastog broja i drugog dvoznamenkastog broja

CorvusPay plaćanje na rate — CorvusPay Integration Manual v5.1.0

Web aplikacija (Angular)

Unutar forme pomoću POST metode poziva se API za pokretanje kartičnog plaćanja.

Sve navedene vrijednosti su promjenjive tako da ih prilikom svake promjene unutar .ts datoteke treba osvježiti i unutar forme </form>.

Parametri signature i payment_ mogu se kreirati na frontendu i backendu. U ovom slučaju oni će se kreirati na frontendu i prosljeđivati kroz formu na API.

<form [action]="'https://localhost:3000/api/corvus/'" ngNoForm method="POST" target="_self">
  <button [disabled]="disableSecondClick" class="btn-pay" type="submit">Plati karticom</button>
  <div hidden>
       <input name='order_number' value='{{orderNumber}}'>
       <input name='amount' value='{{paymentForm.value.amount}}'>
       <input name='cart' value='{{paymentForm.value.cart}}'>
       <input name='signature' value='{{paymentForm.value.signature}}'>
       <input name='payment_visa' value='{{paymentForm.value.payment_visa}}'>
       <input name='payment_master' value='{{paymentForm.value.payment_master}}'>
       <input name='payment_maestro' value='{{paymentForm.value.payment_maestro}}'>
       <input name='payment_diners' value='{{paymentForm.value.payment_diners}}'>
  </div>
</form>

<button [disabled]="disableSecondClick" class="btn-pay" type="submit">Plati karticom</button>

</div>

</form>

Za potrebu kreiranja HmacSHA256 potpisa koristi se crypto-js. Uz to, unutar environment varijable nalaze se razvojni i produkcijski parametri secretKey i storeId.

import * as crypto from 'crypto-js';
import * as HmacSHA256 from 'crypto-js/hmac-sha256';

import { environment } from './../../environments/environment';

...

import * as crypto from 'crypto-js';

import * as HmacSHA256 from 'crypto-js/hmac-sha256';

import { environment } from './../../environments/environment';

...

Glavna razlika u ovom dijelu tiče se ukupne cijene tj. ovisno o tome prelazi li iznos od 500kn plaćanje na rate biti će odobreno ili onemogućeno. U oba slučaja kreira se različit signature.

Za ukupan iznos veći ili jednak 500kn koristi se sljedeće:

this.value_pairs="amount"+this.amountTotal.toFixed(2)+
                 "cart"+this.orderedItem+
                 "currencyHRK"+
                 "languagehr"+
                 "order_number"+this.orderNumber+
                 "payment_all_dynamictrue"+
                 "payment_dinersY0112"+
                 "payment_maestroY0112"+
                 "payment_masterY0112"+
                 "payment_visaY0112"+"require_completefalse"+
                 "store_id"+environment.storeId+
                 "version1.3";
this.signature = HmacSHA256(this.value_pairs,environment.secretKey).toString(crypto.enc.Hex);
this.paymentForm.patchValue({
        amount: this.amountTotal.toFixed(2),
        signature: this.signature,
        payment_visa: 'Y0112',
        payment_master: 'Y0112',
        payment_maestro: 'Y0112',
        payment_diners: 'Y0112'
});

this.value_pairs="amount"+this.amountTotal.toFixed(2)+

"cart"+this.orderedItem+

"currencyHRK"+

"languagehr"+

"order_number"+this.orderNumber+

"payment_all_dynamictrue"+

"payment_dinersY0112"+

"payment_maestroY0112"+

"payment_masterY0112"+

"payment_visaY0112"+"require_completefalse"+

"store_id"+environment.storeId+

"version1.3";

this.signature = HmacSHA256(this.value_pairs,environment.secretKey).toString(crypto.enc.Hex);

this.paymentForm.patchValue({

amount: this.amountTotal.toFixed(2),

signature: this.signature,

payment_visa: 'Y0112',

payment_master: 'Y0112',

payment_maestro: 'Y0112',

payment_diners: 'Y0112'

});

Dok se za iznose manje od 500kn koristi:

this.value_pairs="amount"+this.amountTotal.toFixed(2)+
                 "cart"+this.orderedItem+
                 "currencyHRK"+
                 "languagehr"+
                 "order_number"+this.orderNumber+
                 "payment_all_dynamictrue"+
                 "payment_dinersY0000"+
                 "payment_maestroY0000"+
                 "payment_masterY0000"+
                 "payment_visaY0000"+
                 "require_completefalse"+
                 "store_id"+environment.storeId+
                 "version1.3";
this.signature = HmacSHA256(this.value_pairs,environment.secretKey).toString(crypto.enc.Hex);
this.paymentForm.patchValue({
         amount: this.amountTotal.toFixed(2),
         signature: this.signature,
         payment_visa: 'Y0000',
         payment_master: 'Y0000',
         payment_maestro: 'Y0000',
         payment_diners: 'Y0000'
});

this.value_pairs="amount"+this.amountTotal.toFixed(2)+

"cart"+this.orderedItem+

"currencyHRK"+

"languagehr"+

"order_number"+this.orderNumber+

"payment_all_dynamictrue"+

"payment_dinersY0000"+

"payment_maestroY0000"+

"payment_masterY0000"+

"payment_visaY0000"+

"require_completefalse"+

"store_id"+environment.storeId+

"version1.3";

this.signature = HmacSHA256(this.value_pairs,environment.secretKey).toString(crypto.enc.Hex);

this.paymentForm.patchValue({

amount: this.amountTotal.toFixed(2),

signature: this.signature,

payment_visa: 'Y0000',

payment_master: 'Y0000',

payment_maestro: 'Y0000',

payment_diners: 'Y0000'

});

Backend API (Express.js)

Backend logika nalazit će se u server.js datoteci. Kako ju kreirati možete se vidjeti u blog postu “Izrada RESTful API-ja koristeći Node.js i Express.js“. Razlika između primjera iz tog blog posta i ovoga sada je što više nije potrebno koristiti body-parser.

var express = require('express');
var app = express();

app.use(express.json());
app.use(express.urlencoded({ extended: true }));
app.use('/api', apiRoutes);

var port = process.env.PORT || 3000;
 
var apiRoutes = express.Router();

apiRoutes.get('/', function(req, res) {
    res.json({ message: 'CorvusPay API je pokrenut!' });
});

...

app.listen(port);

var express = require('express');

var app = express();

app.use(express.json());

app.use(express.urlencoded({ extended: true }));

app.use('/api', apiRoutes);

var port = process.env.PORT || 3000;

var apiRoutes = express.Router();

apiRoutes.get('/', function(req, res) {

res.json({ message: 'CorvusPay API je pokrenut!' });

});

...

app.listen(port);

Ova će se datoteka sastojati od tri krajnje točke (API endpoints).

Prva krajnja točka, '/corvusPay', preusmjerit će korisnika na formu za plaćanje.

apiRoutes.post('/corvusPay', function(req, res) {
    if(req.body.order_number && req.body.amount){
        res.status(301).redirect(307, 'https://test-wallet.corvuspay.com/checkout/?store_id=2029&order_number='+req.body.order_number+'&language=hr&currency=HRK&amount='+req.body.amount+'&cart='+req.body.cart+'&signature='+req.body.signature+'&require_complete=false&version=1.3&payment_all_dynamic=true&payment_visa='+req.body.payment_visa+'&payment_master='+req.body.payment_master+'&payment_maestro='+req.body.payment_maestro+'&payment_diners='+req.body.payment_diners)
    } else {
        res.json({
            success: false,
            status: 502,
            message: 'Greška, ne šaljete sve potrebne podatke za plaćanje!'
        });
    }
});

apiRoutes.post('/corvusPay', function(req, res) {

if(req.body.order_number && req.body.amount){

res.status(301).redirect(307, 'https://test-wallet.corvuspay.com/checkout/?store_id=2029&order_number='+req.body.order_number+'&language=hr&currency=HRK&amount='+req.body.amount+'&cart='+req.body.cart+'&signature='+req.body.signature+'&require_complete=false&version=1.3&payment_all_dynamic=true&payment_visa='+req.body.payment_visa+'&payment_master='+req.body.payment_master+'&payment_maestro='+req.body.payment_maestro+'&payment_diners='+req.body.payment_diners)

} else {

res.json({

success: false,

status: 502,

message: 'Greška, ne šaljete sve potrebne podatke za plaćanje!'

});

}

});

Nakon unosa i obrade podataka o kartici

CorvusPay - obrada u tijeku — CorvusPay – obrada u tijeku

korisnik je preusmjeren na dodatnu sigurnosnu autentifikaciju kartice.

CorvusPay - sigurnosna autentifikacija kartice — CorvusPay – sigurnosna autentifikacija kartice

Ako je sve prošlo uspješno korisniku će se prikazati obavijest

CorvusPay - transakcija-uspjela — CorvusPay – transakcija uspjela

i na e-mail će dobiti obavijest o uspješnoj narudžbi.

CorvusPay - obavijest o uspješnoj narudžbi — CorvusPay – obavijest o uspješnoj narudžbi

Druga krajnja točka, '/corvusPaySuccess' , prihvaća odgovor od Corvusa kada je plaćanje uspješno provedeno.

apiRoutes.post('/corvusPaySuccess', function(req, res) {
    res.status(200).redirect(301, 'https://localhost/success/'+req.body.order_number)
    ...
});

apiRoutes.post('/corvusPaySuccess', function(req, res) {

res.status(200).redirect(301, 'https://localhost/success/'+req.body.order_number)

...

});

Treća krajnja točka, '/corvusPayCancel' , prihvaća odgovor od Corvusa kada je plaćanje neuspješno ili otkazano.

apiRoutes.post('/corvusPayCancel', function(req, res) {
    res.status(200).redirect(301, 'https://localhost/cancel/'+req.body.order_number)
    ...
});

apiRoutes.post('/corvusPayCancel', function(req, res) {

res.status(200).redirect(301, 'https://localhost/cancel/'+req.body.order_number)

...

});

DevExtreme Pivot Grid & Angular: prikaz i analiza višedimenzionalnih podataka

U ovom ću blog postu pokazati kako implementirati DevExtreme Pivot Grid UI komponentu u Angular projekt. Ona omogućava prikaz i analizu višedimenzionalnih podataka iz lokalne pohrane ili OLAP kocke.

Fokusirat ću se na prikaz podataka prema specifičnim parameterima te načinu na koji te podatke uređivati jer Pivot Grid nativno ne nudi takvu mogućnost.

Pivot Grid prikaz podataka

Prva i osnovna značajka Pivot Grida je prikaz i analizu višedimenzionalnih podataka.

U ovom ću primjeru koristiti strukturu podataka prikazanu u JSON-u kojega je moguće vidjeti ispod. S jedne strane biti će poslovnice, a s druge automobili. Cilj je prikazati količinu naručenih tj. isporučenih automobila ovisno o poslovnici.

Logika aplikacije nalazit će se unutar angular-devextreme.component.ts datoteke koja se temelji na PivotGridDataSource objektu. Za sada će se unutar njega nalaziti samo fields niz i store objekt.

Poslovnice će se nalaziti krajnje lijevo area: "row", a automobili na vrhu area: "column". Sve ostalo tj. narudžbe prikazuju se kao podaci area: "data".

import { Component, OnInit } from '@angular/core';

import PivotGridDataSource from "devextreme/ui/pivot_grid/data_source";

@Component({
  selector: 'app-narudzbe-popis',
  templateUrl: './narudzbe-popis.component.html',
  styleUrls: ['./narudzbe-popis.component.scss']
})

export class NarudzbePopisComponent implements OnInit {

  dataSource: PivotGridDataSource;

  podaciDemo = [
    {
      "poslovnica_ID": 163,
      "poslovnica_naziv": "POSLOVNICA VK",
      "narudzba_ID": 1720303,
      "narudzba_narucenakolicina": 50,
      //Od 50 isporučeno 49 automobila
      "narudzba_isporucenakolicina": 49,
      "artikl_ar_ID": 69567,
      "artikl_sifra": 666627,
      "artikl_naziv": "Tesla Model S"
    },
    {
      "poslovnica_ID": 163,
      "poslovnica_naziv": "POSLOVNICA VK",
      "narudzba_ID": 83572434,
      "narudzba_narucenakolicina": 20,
      //Još nije unesena isporučena količina
      "narudzba_isporucenakolicina": null,
      "artikl_ar_ID": 69463,
      "artikl_sifra": 555018,
      "artikl_naziv": "Fiat Panda"
    },
    {
      "poslovnica_ID": 163,
      "poslovnica_naziv": "POSLOVNICA VK",
      "narudzba_ID": 83572437,
      "narudzba_narucenakolicina": 6,
      //Od 6 isporučeno 0 automobila
      "narudzba_isporucenakolicina": 0,
      "artikl_ar_ID": 69610,
      "artikl_sifra": 102836,
      "artikl_naziv": "Kia Rio"
    },
...
]

  constructor() {}

  ngOnInit(): void {
      this.prikaziNarudzbe();
  }

  prikaziNarudzbe(){
          this.dataSource = new PivotGridDataSource({
            fields: [
              {
                dataField: "poslovnica_naziv",
                dataType: "string",
                area: "row",
                width: 120
              },
              {
                dataField: "artikl_naziv",
                dataType: "string",
                area: "column",
                expanded: true
              },
              {
                caption: "Naručeno",
                dataField: "narudzba_narucenakolicina",
                dataType: "number",
                summaryType: "sum",
                area: "data"
              },
              {
                caption: "Isporučeno",
                dataField: "narudzba_isporucenakolicina",
                dataType: "number",
                summaryType: "sum",
                area: "data"
              }
            ],
            store: {
              type: "array",
              data: this.podaciDemo
            }
        });
  }

}

import { Component, OnInit } from '@angular/core';

import PivotGridDataSource from "devextreme/ui/pivot_grid/data_source";

@Component({

selector: 'app-narudzbe-popis',

templateUrl: './narudzbe-popis.component.html',

styleUrls: ['./narudzbe-popis.component.scss']

})

export class NarudzbePopisComponent implements OnInit {

dataSource: PivotGridDataSource;

podaciDemo = [

{

"poslovnica_ID": 163,

"poslovnica_naziv": "POSLOVNICA VK",

"narudzba_ID": 1720303,

"narudzba_narucenakolicina": 50,

//Od 50 isporučeno 49 automobila

"narudzba_isporucenakolicina": 49,

"artikl_ar_ID": 69567,

"artikl_sifra": 666627,

"artikl_naziv": "Tesla Model S"

{

"poslovnica_ID": 163,

"poslovnica_naziv": "POSLOVNICA VK",

"narudzba_ID": 83572434,

"narudzba_narucenakolicina": 20,

//Još nije unesena isporučena količina

"narudzba_isporucenakolicina": null,

"artikl_ar_ID": 69463,

"artikl_sifra": 555018,

"artikl_naziv": "Fiat Panda"

{

"poslovnica_ID": 163,

"poslovnica_naziv": "POSLOVNICA VK",

"narudzba_ID": 83572437,

"narudzba_narucenakolicina": 6,

//Od 6 isporučeno 0 automobila

"narudzba_isporucenakolicina": 0,

"artikl_ar_ID": 69610,

"artikl_sifra": 102836,

"artikl_naziv": "Kia Rio"

...

]

constructor() {}

ngOnInit(): void {

this.prikaziNarudzbe();

}

prikaziNarudzbe(){

this.dataSource = new PivotGridDataSource({

fields: [

{

dataField: "poslovnica_naziv",

dataType: "string",

area: "row",

width: 120

{

dataField: "artikl_naziv",

dataType: "string",

area: "column",

expanded: true

{

caption: "Naručeno",

dataField: "narudzba_narucenakolicina",

dataType: "number",

summaryType: "sum",

area: "data"

{

caption: "Isporučeno",

dataField: "narudzba_isporucenakolicina",

dataType: "number",

summaryType: "sum",

area: "data"

}

store: {

type: "array",

data: this.podaciDemo

}

});

}

Izgled sučelja biti će definiran unutar angular-devextreme.component.html datoteke.

Od Pivot Grid UI svojstva koristit ću ih nekoliko:

showBorders – želim da vanjski rubovi budu vidljivi.

showColumnGrandTotals – ne želim prikazivati ukupne vrijednosti za kolone. Ovo bi se inače prikazivalo krajnje desno.

showRowGrandTotals – želim na dnu prikazati ukupne vrijednosti.

<dx-pivot-grid
            [showBorders]="true"
            [showColumnGrandTotals]="false"
            [showRowGrandTotals]="true"
            [dataSource]="dataSource">
            <dxo-field-chooser [enabled]="false" [height]="400"></dxo-field-chooser>
            <dxo-scrolling
                mode="standard"  
                [useNative]="false"
                [scrollByContent]="true"
                [scrollByThumb]="true"
                showScrollbar="always">
            </dxo-scrolling> <!-- "virtual" | "infinite" -->
</dx-pivot-grid>

<dx-pivot-grid

[showBorders]="true"

[showColumnGrandTotals]="false"

[showRowGrandTotals]="true"

[dataSource]="dataSource">

<dxo-field-chooser [enabled]="false" [height]="400"></dxo-field-chooser>

<dxo-scrolling

mode="standard"

[useNative]="false"

[scrollByContent]="true"

[scrollByThumb]="true"

showScrollbar="always">

</dxo-scrolling>

</dx-pivot-grid>

Sve to zajedno na kraju daje sljedeće:

Pivot Grid – promjena izgleda polja

Ako želim dodatno prilagoditi prikaz određenih polja to mogu napraviti koristeći onCellPrepared metodu.

<dx-pivot-grid ...
    (onCellPrepared)="onCellPrepared($event)">
</dx-pivot-grid>

<dx-pivot-grid ...

(onCellPrepared)="onCellPrepared($event)">

</dx-pivot-grid>

U ovom slučaju hoću napraviti tri grafičke izmjene. Stupac “Naručeno” će imati sivu pozadinsku boju i podebljane brojeve, ukupne vrijednosti na dnu također će biti podebljanje, a vrijednosti koje za “Isporučeno” imaju null će imati crvenu pozadinsku boju kako bi bila uočljivija.

onCellPrepared(e){
      
    if(e.cell.rowType == "GT"){
      e.cellElement.style.fontWeight = "bold";
    }

    if(e.area == 'data' && e.columnIndex % 2 == 0){
          e.cellElement.style.fontWeight = "bold";
          e.cellElement.style.backgroundColor = "rgb(242,242,242)";
    }
    
    if(e.area === "data" && e.cell.dataIndex === 1 && e.cell.value === null && e.cell.rowType != "GT"){
        e.cellElement.style.backgroundColor = "rgb(255 0 0 / 42%)";
    }
          
  }

onCellPrepared(e){

if(e.cell.rowType == "GT"){

e.cellElement.style.fontWeight = "bold";

}

if(e.area == 'data' && e.columnIndex % 2 == 0){

e.cellElement.style.fontWeight = "bold";

e.cellElement.style.backgroundColor = "rgb(242,242,242)";

}

if(e.area === "data" && e.cell.dataIndex === 1 && e.cell.value === null && e.cell.rowType != "GT"){

e.cellElement.style.backgroundColor = "rgb(255 0 0 / 42%)";

}

Na ekranu bi to izgledalo ovako:

Međutim, niti jedno polje nema crvenu pozadinsku boju. Razlog je što Pivot Grid sve null vrijednosti vidi kao 0 i zato uvjet e.cell.value === null nije zadovoljen. Ali ako stavim e.cell.value === 0 stanje će biti puno drugačije.

Iz podaciDemo niza se može vidjeti da narudzba_isporucenakolicina može imati vrijednosti null. To znači da bi vrijednost za “POSLOVNICA VK” i automobil “Fiat Panda” trebala imati crvenu pozadinsku boju jer je narudzba_isporucenakolicina = null, a kombinacija POSLOVNICA VK” i “Kia Rio” ne bi trebala imati crvenu pozadinsku boju jer ima vrijednost narudzba_isporucenakolicina = 0.

Pivot Grid – prikaz null vrijednosti

Kako bi u PivotGridu mogao prikazati null vrijednosti i razlikovati ih od vrijednosti 0 koristiti ću calculateCustomSummary funkciju. Tu ću funkciju vezati uz polje dataField: "narudzba_isporucenakolicina".

{
        caption: "Isporučeno",
        dataField: "narudzba_isporucenakolicina",
        dataType: "number",
        //summaryType: "sum",
        area: "data",
        summaryType: "custom",
        calculateCustomSummary: function(options) {  
          if (options.summaryProcess == 'start') {  
              options.totalValue = null;  
          }  
          if (options.summaryProcess == 'calculate') {  
              if (options.value !== null) {  
                  options.totalValue += options.value;  
              }  
          }  
        }
}

{

caption: "Isporučeno",

dataField: "narudzba_isporucenakolicina",

dataType: "number",

//summaryType: "sum",

area: "data",

summaryType: "custom",

calculateCustomSummary: function(options) {

if (options.summaryProcess == 'start') {

options.totalValue = null;

}

if (options.summaryProcess == 'calculate') {

if (options.value !== null) {

options.totalValue += options.value;

}

Sada se na ekranu može vidjeti da istovremeno imam prikazane vrijednosti za isporučenu količinu i kao null i kao 0.

Omogućiti klik na odabrano polje

Želim omogućiti klik samo na polje koje pokazuje isporučenu količinu, ali isključivo za poslovnice i automobile koji imaju unesenu naručenu količinu. Znači, ne želim da se u koloni sa isporučenom količinom može kliknuti na prazno polje jer nema smisla unositi isporučenu količinu ako ništa nije naručeno.

Za to ću koristiti onCellClick funkciju.

<dx-pivot-grid ...
    (onCellClick)="onPivotCellClick($event)">
</dx-pivot-grid>

<dx-pivot-grid ...

(onCellClick)="onPivotCellClick($event)">

</dx-pivot-grid>

onPivotCellClick(e) {
    //Klik na polje "narudzba_isporucenakolicina" ako ima unesenu vrijednost
    if(e.area == "data" && e.cell.dataIndex == 1 && e.cell.value != undefined && e.cell.rowType != "GT") {
      console.log(e);
    }
    //Klik na polje "narudzba_isporucenakolicina" ako je vrijednosti null tj. ako je polje crvene pozadinske boje
    if(e.area === "data" && e.cell.dataIndex === 1 && e.cell.value === null && e.cell.rowType != "GT"){
      console.log(e);
    }
 }

onPivotCellClick(e) {

//Klik na polje "narudzba_isporucenakolicina" ako ima unesenu vrijednost

if(e.area == "data" && e.cell.dataIndex == 1 && e.cell.value != undefined && e.cell.rowType != "GT") {

console.log(e);

}

//Klik na polje "narudzba_isporucenakolicina" ako je vrijednosti null tj. ako je polje crvene pozadinske boje

if(e.area === "data" && e.cell.dataIndex === 1 && e.cell.value === null && e.cell.rowType != "GT"){

console.log(e);

}

Iz prikazanog se može vidjeti da klik na prazno polje ne radi ništa, klik na crveno polje dohvaća vrijednost null, a klik na polje za unesenom količinom dohvaća tu vrijednost. U ovom slučaju ta vrijednost je 10.

Pivot Grid dohvaćanje vrijednosti polja

Pivot Grid je primarno kreiran s ciljem prikaza podataka tj. prema dokumentaciji nema mogućnost jednostavnog uređivanja podataka kao što je to slučaj kod Data Grida, barem ju nisam našao, ali sam znao da mora postojati neko rješenje.

Za početak želim prikazati nekakvu formu unutar koje će se vrijednost polja moći urediti. Za to ću iskoristiti Popup UI komponentu. Unutar nje definiram dxTemplate što mi omogućava daljnju prilagodbu sučelja za uređivanje isporučene vrijednosti.

Za dohvaćanje vrijednosti kliknutog polja koristit ću Drill Down.

...
</dx-pivot-grid>
        <dx-popup
        [closeOnOutsideClick]="false"
        [showCloseButton]="true"
        [(visible)]="popupVisible"
        [title]="popupTitle"
        [width]="650"
        [height]="200"
        >
        <div *dxTemplate="let data of 'content'">
            <dx-data-grid
            #drillDownDataGrid
            [dataSource]="drillDownDataSource"
            >
            </dx-data-grid>
        </div>
        </dx-popup>

...

</dx-pivot-grid>

<dx-popup

[closeOnOutsideClick]="false"

[showCloseButton]="true"

[(visible)]="popupVisible"

[title]="popupTitle"

[width]="650"

[height]="200"

<dx-data-grid

#drillDownDataGrid

[dataSource]="drillDownDataSource"

</dx-data-grid>

</div>

</dx-popup>

import { 
        Component,
        OnInit,
        ViewChild
      } 
      from '@angular/core';

import { DxTextBoxComponent } from 'devextreme-angular';
   ...

export class NarudzbePopisComponent implements OnInit {

  popupVisible = false;
  popupTitle: string;
  narudzba_ID: number;
  isporucenakolicina: number;
  narucenaKolicinaPopup: number;

  drillDownDataSource: any;

  @ViewChild("kolicinaUnos", { static: false }) inputName: DxTextBoxComponent;
...

onPivotCellClick(e) {
    //Klik na polje "narudzba_isporucenakolicina" ako ima unesenu vrijednost
    if(e.area == "data" && e.cell.dataIndex == 1 && e.cell.value != undefined && e.cell.rowType != "GT") {
      //console.log(e);
      this.drillDownDataSource = this.dataSource.createDrillDownDataSource(e.cell);
        let _this = this;
        this.drillDownDataSource.load().done(function(result) {
          _this.narucenaKolicinaPopup = result[0].nas_kolicina;
        });
        this.popupTitle = e.cell.rowPath[0] + ' - ' + e.cell.columnPath[0];
        this.popupVisible = true;
    }
    //Klik na polje "narudzba_isporucenakolicina" ako je vrijednosti null tj. ako je polje crvene pozadinske boje
    if(e.area === "data" && e.cell.dataIndex === 1 && e.cell.value === null && e.cell.rowType != "GT"){
      //console.log(e);
      this.drillDownDataSource = this.dataSource.createDrillDownDataSource(e.cell);
        let _this = this;
        this.drillDownDataSource.load().done(function(result) {
          _this.narucenaKolicinaPopup = result[0].nas_kolicina;
        });
        this.popupTitle = e.cell.rowPath[0] + ' - ' + e.cell.columnPath[0];
        this.popupVisible = true;
    }
  }

import {

Component,

OnInit,

ViewChild

}

from '@angular/core';

import { DxTextBoxComponent } from 'devextreme-angular';

...

export class NarudzbePopisComponent implements OnInit {

popupVisible = false;

popupTitle: string;

narudzba_ID: number;

isporucenakolicina: number;

narucenaKolicinaPopup: number;

drillDownDataSource: any;

@ViewChild("kolicinaUnos", { static: false }) inputName: DxTextBoxComponent;

...

onPivotCellClick(e) {

//Klik na polje "narudzba_isporucenakolicina" ako ima unesenu vrijednost

if(e.area == "data" && e.cell.dataIndex == 1 && e.cell.value != undefined && e.cell.rowType != "GT") {

//console.log(e);

this.drillDownDataSource = this.dataSource.createDrillDownDataSource(e.cell);

let _this = this;

this.drillDownDataSource.load().done(function(result) {

_this.narucenaKolicinaPopup = result[0].nas_kolicina;

});

this.popupTitle = e.cell.rowPath[0] + ' - ' + e.cell.columnPath[0];

this.popupVisible = true;

}

//Klik na polje "narudzba_isporucenakolicina" ako je vrijednosti null tj. ako je polje crvene pozadinske boje

if(e.area === "data" && e.cell.dataIndex === 1 && e.cell.value === null && e.cell.rowType != "GT"){

//console.log(e);

this.drillDownDataSource = this.dataSource.createDrillDownDataSource(e.cell);

let _this = this;

this.drillDownDataSource.load().done(function(result) {

_this.narucenaKolicinaPopup = result[0].nas_kolicina;

});

this.popupTitle = e.cell.rowPath[0] + ' - ' + e.cell.columnPath[0];

this.popupVisible = true;

}

Klikom na polje isporučene količine prikazat će se sljedeće:

Kao što se iz prikazanog može vidjeti dohvaćeni su podaci prikazani na vrhu blog posta.

{
      "poslovnica_ID": 163,
      "poslovnica_naziv": "POSLOVNICA VK",
      "narudzba_ID": 1720303,
      "narudzba_narucenakolicina": 50,
      //Od 50 isporučeno 49 automobila
      "narudzba_isporucenakolicina": 49,
      "artikl_ar_ID": 69567,
      "artikl_sifra": 666627,
      "artikl_naziv": "Tesla Model S"
}

{

"poslovnica_ID": 163,

"poslovnica_naziv": "POSLOVNICA VK",

"narudzba_ID": 1720303,

"narudzba_narucenakolicina": 50,

//Od 50 isporučeno 49 automobila

"narudzba_isporucenakolicina": 49,

"artikl_ar_ID": 69567,

"artikl_sifra": 666627,

"artikl_naziv": "Tesla Model S"

}

Pivot Grid uređivanje vrijednosti polja

Popup iz gornjeg primjera je potrebno prilagoditi na način da se kreira input polje za izmjenu isporučene količine. Klikom na polje sa već unesenom isporučenom količinom ista će se prikazati unutar input polja. Ako je polje prazno isto će biti i input polje.

U GIF-u se može primjetiti da uređivanje isporučene količine uredno prolazi, ali uz jedan problem. Prilikom svakog spremanja isporučene količine cijeli se Pivot Grid osvježi i vrati u krajnju lijevu poziciju. Naravno da to nije praktično. Uz to, prilikom otvaranja popupa polje za unos količine nije fokusirano (crvena podcrtana linija) nego je na njega prvo potrebno kliknuti.

U nastavku ću pokazati kako riješiti oba problema.

<div *dxTemplate="let data of 'content'">
            <dx-data-grid
            class="dataGridKlasa"
            #drillDownDataGrid
            [dataSource]="drillDownDataSource"
            >
                <dxi-column dataField="narudzba_isporucenakolicina" caption="Isporučena količina" [visible]="true" cellTemplate="urediKolicinu">
                    <div *dxTemplate="let data of 'urediKolicinu'">
                        <dx-number-box #kolicinaUnos
                            style="text-align: center;"
                            [value]="data.value"
                            [placeholder]="data.value"
                            (onValueChanged)="spremiKolicinu($event, data)"
                            (onEnterKey)="spremiKolicinuEnter($event, data)"
                            >
                        </dx-number-box>
                    </div>
                </dxi-column>
                <dxi-column cellTemplate="gumbUrediKolicinu">
                    <div *dxTemplate="let data of 'gumbUrediKolicinu'">
                        <dx-button
                            style="margin-bottom: 5px;"
                            stylingMode="contained"
                            text="SPREMI"
                            type="success"
                            [width]="120"
                            (onClick)="spremiKolicinuButton($event, data)">
                        </dx-button>
                    </div>
                </dxi-column>
            </dx-data-grid>
        </div>

<dx-data-grid

class="dataGridKlasa"

#drillDownDataGrid

[dataSource]="drillDownDataSource"

<dxi-column dataField="narudzba_isporucenakolicina" caption="Isporučena količina" [visible]="true" cellTemplate="urediKolicinu">

<dx-number-box #kolicinaUnos

style="text-align: center;"

[value]="data.value"

[placeholder]="data.value"

(onValueChanged)="spremiKolicinu($event, data)"

(onEnterKey)="spremiKolicinuEnter($event, data)"

</dx-number-box>

</div>

</dxi-column>

<dxi-column cellTemplate="gumbUrediKolicinu">

<dx-button

style="margin-bottom: 5px;"

stylingMode="contained"

text="SPREMI"

type="success"

[width]="120"

(onClick)="spremiKolicinuButton($event, data)">

</dx-button>

</div>

</dxi-column>

</dx-data-grid>

</div>

  spremiKolicinu(event, data){
    this.isporucenakolicina = event.value;
    this.narudzba_ID = data.row.cells[0].data.narudzba_ID;
  }

  spremiKolicinuButton(event, data){
    //Slanje podataka na API
    //if(res.success == true){
      this.popupVisible = false;
    //} else {
      //Poruka o grešci
    //}
  }

  spremiKolicinuEnter(event, data){
    // this.slanjeKolicine(data.key.nas_ID, e.value);
      //Slanje podataka na API
      //if(res.success == true){
        this.popupVisible = false;
      //} else {
        //Poruka o grešci
      //}
  }

spremiKolicinu(event, data){

this.isporucenakolicina = event.value;

this.narudzba_ID = data.row.cells[0].data.narudzba_ID;

}

spremiKolicinuButton(event, data){

//Slanje podataka na API

//if(res.success == true){

this.popupVisible = false;

//} else {

//Poruka o grešci

//}

}

spremiKolicinuEnter(event, data){

// this.slanjeKolicine(data.key.nas_ID, e.value);

//Slanje podataka na API

//if(res.success == true){

this.popupVisible = false;

//} else {

//Poruka o grešci

//}

}

Osvježavanje samo uređenog podatka

Jedan od problema koji se stvorio nakon što je omogućeno uređivanje podataka je to što se sada cijeli ekran osvježi i onda se svaki put iznova mora skrolati do točno određenog polja kako bi se nastavilo uređivanje. To nikako nije praktično i bilo je potrebno pronaći rješenje.

U ovom će mi slučaju pomoći ArrayStore, ali tek kada prilagodim prikaziNarudzbe() funkciju. Kao što se može vidjeti this.podaciDemo se sada dohvaćaju upravo kroz ArrayStore. Kroz key parametar identificiram unikatnu vrijednost pomoću koje Pivot Grid može znati koju vrijednost će osvježiti.

Podatke nakon unosa osvježavam pomoću update(key, values) metode unutar funkcija spremiKolicinuButton() i spremiKolicinuEnter().

import { Component, OnInit, ViewChild } from '@angular/core';

import PivotGridDataSource from "devextreme/ui/pivot_grid/data_source";
import ArrayStore from "devextreme/data/array_store";
import { DxTextBoxComponent,
         DxPivotGridComponent } from 'devextreme-angular';
...

@ViewChild(DxPivotGridComponent, { static: false }) pivotGrid: DxPivotGridComponent;

dataSource: PivotGridDataSource;
dataStore: any;

...

prikaziNarudzbe(){
          this.dataStore = new ArrayStore({
            key: "narudzba_ID",
            data: this.podaciDemo
          });
          this.dataSource = new PivotGridDataSource({
            fields: [
              {
                dataField: "poslovnica_naziv",
                dataType: "string",
                area: "row",
                width: 120
              },
              {
                dataField: "artikl_naziv",
                dataType: "string",
                area: "column"
              },
              {
                caption: "Naručeno",
                dataField: "narudzba_narucenakolicina",
                dataType: "number",
                summaryType: "sum",
                area: "data"
              },
              {
                caption: "Isporučeno",
                dataField: "narudzba_isporucenakolicina",
                dataType: "number",
                area: "data",
                summaryType: "custom",
                calculateCustomSummary: function(options) {  
                  if (options.summaryProcess == 'start') {  
                      options.totalValue = null;  
                  }  
                  if (options.summaryProcess == 'calculate') {  
                      if (options.value !== null) {  
                          options.totalValue += options.value;  
                      }  
                  }  
                }
              }
            ],
            store: this.dataStore
        });
  }

...

spremiKolicinuButton(event, data){
    //Slanje podataka na API
    //if(res.success == true){
      this.dataStore.update(data.key, {
        'poslovnica_ID': data.data.poslovnica_ID,
        'poslovnica_naziv': data.data.poslovnica_naziv,
        'artikl_ar_ID': data.data.artikl_ar_ID,
        'artikl_naziv': data.data.artikl_naziv,
        'artikl_sifra': data.data.artikl_sifra,
        'narudzba_isporucenakolicina': this.isporucenakolicina,
        'narudzba_narucenakolicina': data.data.narudzba_narucenakolicina,
        'narudzba_ID': data.data.narudzba_ID
      });
      this.isporucenakolicina = null;
      this.pivotGrid.instance.getDataSource().reload();
      this.popupVisible = false;
    //} else {
      //Poruka o grešci
    //}
  }

  spremiKolicinuEnter(event, data){
    // this.slanjeKolicine(data.key.nas_ID, e.value);
      //Slanje podataka na API
      //if(res.success == true){
        this.dataStore.update(data.key, {
          'poslovnica_ID': data.data.poslovnica_ID,
          'poslovnica_naziv': data.data.poslovnica_naziv,
          'artikl_ar_ID': data.data.artikl_ar_ID,
          'artikl_naziv': data.data.artikl_naziv,
          'artikl_sifra': data.data.artikl_sifra,
          'narudzba_isporucenakolicina': this.isporucenakolicina,
          'narudzba_narucenakolicina': data.data.narudzba_narucenakolicina,
          'narudzba_ID': data.data.narudzba_ID
        });
        this.isporucenakolicina = null;
        this.pivotGrid.instance.getDataSource().reload();
        this.popupVisible = false;
      //} else {
        //Poruka o grešci
      //}
  }

100

101

102

103

104

105

106

import { Component, OnInit, ViewChild } from '@angular/core';

import PivotGridDataSource from "devextreme/ui/pivot_grid/data_source";

import ArrayStore from "devextreme/data/array_store";

import { DxTextBoxComponent,

DxPivotGridComponent } from 'devextreme-angular';

...

@ViewChild(DxPivotGridComponent, { static: false }) pivotGrid: DxPivotGridComponent;

dataSource: PivotGridDataSource;

dataStore: any;

...

prikaziNarudzbe(){

this.dataStore = new ArrayStore({

key: "narudzba_ID",

data: this.podaciDemo

});

this.dataSource = new PivotGridDataSource({

fields: [

{

dataField: "poslovnica_naziv",

dataType: "string",

area: "row",

width: 120

{

dataField: "artikl_naziv",

dataType: "string",

area: "column"

{

caption: "Naručeno",

dataField: "narudzba_narucenakolicina",

dataType: "number",

summaryType: "sum",

area: "data"

{

caption: "Isporučeno",

dataField: "narudzba_isporucenakolicina",

dataType: "number",

area: "data",

summaryType: "custom",

calculateCustomSummary: function(options) {

if (options.summaryProcess == 'start') {

options.totalValue = null;

}

if (options.summaryProcess == 'calculate') {

if (options.value !== null) {

options.totalValue += options.value;

}

store: this.dataStore

});

}

...

spremiKolicinuButton(event, data){

//Slanje podataka na API

//if(res.success == true){

this.dataStore.update(data.key, {

'poslovnica_ID': data.data.poslovnica_ID,

'poslovnica_naziv': data.data.poslovnica_naziv,

'artikl_ar_ID': data.data.artikl_ar_ID,

'artikl_naziv': data.data.artikl_naziv,

'artikl_sifra': data.data.artikl_sifra,

'narudzba_isporucenakolicina': this.isporucenakolicina,

'narudzba_narucenakolicina': data.data.narudzba_narucenakolicina,

'narudzba_ID': data.data.narudzba_ID

});

this.isporucenakolicina = null;

this.pivotGrid.instance.getDataSource().reload();

this.popupVisible = false;

//} else {

//Poruka o grešci

//}

}

spremiKolicinuEnter(event, data){

// this.slanjeKolicine(data.key.nas_ID, e.value);

//Slanje podataka na API

//if(res.success == true){

this.dataStore.update(data.key, {

'poslovnica_ID': data.data.poslovnica_ID,

'poslovnica_naziv': data.data.poslovnica_naziv,

'artikl_ar_ID': data.data.artikl_ar_ID,

'artikl_naziv': data.data.artikl_naziv,

'artikl_sifra': data.data.artikl_sifra,

'narudzba_isporucenakolicina': this.isporucenakolicina,

'narudzba_narucenakolicina': data.data.narudzba_narucenakolicina,

'narudzba_ID': data.data.narudzba_ID

});

this.isporucenakolicina = null;

this.pivotGrid.instance.getDataSource().reload();

this.popupVisible = false;

//} else {

//Poruka o grešci

//}

}

Uz to, kada se popup otvori polje za unos isporučene količine nije fokusirano i prije unosa potrebno je na njega kliknuti. To također nije praktično. Ovo se vrlo lako riješi kroz onShown funkciju.

<dx-popup
        [closeOnOutsideClick]="false"
        [showCloseButton]="true"
        [(visible)]="popupVisible"
        [title]="popupTitle"
        [width]="650"
        [height]="200"
        (onShown)="onPopupShown($event)"
        >

<dx-popup

[closeOnOutsideClick]="false"

[showCloseButton]="true"

[(visible)]="popupVisible"

[title]="popupTitle"

[width]="650"

[height]="200"

(onShown)="onPopupShown($event)"

onPopupShown(e) {
    let a = this;
    setTimeout(() => {
      a.inputName.instance.focus();
    }, 100);
}

onPopupShown(e) {

let a = this;

setTimeout(() => {

a.inputName.instance.focus();

}, 100);

}

Na kraju to izgleda ovako:

Zaključak

Naravno, ovo je samo dio mogućnosti koje DevExtreme Pivot Grid ima, ali dovoljno da pohvatate osnove i shvatite na koji način funkcionira.

Što napraviti kada izgubite Android keystore lozinku?

Za početak, važna napomena. Jedna stvar mora biti jasna. Ova metoda neće raditi u 100% slučajeva i treba se koristiti kao zadnja opcija.

Olakotna okolnost može biti ako ste sami kreirali keystore za koji više nemate lozinku jer lakše ćete dobiti inspiraciju za potencijalne mogućnosti kada znate koje najčešće kombinacije koristite No, ako želite doći do lozinke keystore datoteke koju je netko drugi kreirao onda najveću ulogu igra sreća i dovoljno vremena provedenog u čekanju da ovaj alat dođe do lozinke.

P.S. Prije korištenja ovog alata dobra je opcija kontaktirati Google kroz njihovu General Play Console issues formu (I have a key or keystore related issue -> I have an upload key-related issue -> I forgot the password to my keystore).

Android keystore!?

Ono što se u svim uputama može pronaći je važna napomena koja se tiče upravo keystore datoteke za koju je navedeno da se uvijek mora čuvati na sigurnom mjestu i da se nikako ne smije izgubiti pripadajuća lozinka. U suprotnom neće biti moguće napraviti ažuriranje aplikacije na Google Play Store. Druga opcija je da se aplikacija potpisuje sa certifikatom kojim upravlja Google direktno kroz Google Play Store.

…if you’re not opted in to app signing with by Google Play and you lose your app’s signing key, you lose the ability to update your app.

Više o načinu kako se Android keystore datoteka kreira i koristi za postavljanje Ionic aplikacija na Google Play Store moguće je pronaći u blog postu pod naslovom “Priprema i objava Ionic aplikacije na Google Play Store“.

No, vratimo se scenariju u kojemu lozinka keystore datoeke nije poznata.

Što napraviti u tom slučaju?

Priprema

Preduvjet za korištenje ovog alata je instalirana Java
AndroidKeystoreBrute alat je moguće preuzeti na adresi https://drive.google.com/file/d/0B_Rw7kNjv3BATldrLXMwcVRud2c/edit?usp=sharing

Alat se pokreće naredbom

java -jar AndroidKeystoreBrute.jar <argumenti>

1	java -jar AndroidKeystoreBrute.jar <argumenti>

Mogući argumenti:

-m <1..3> – metoda 1, 2 ili 3

-k <putanja> – putanja do keystore datoteke

-d <putanja> – putanja do datoteke sa popisom riječi (za metodu 2 i 3)

-p – korištenje uobičajene zamjene poput “@” za “a” (3. metoda). VAŽNO – vrlo sporo!

-start <String> – postavljanje početnog niza za lozinku (za brute force)

-w – kreira novu keystore datoteku s istom lozinkom

-h – prikaz pomoći

Korištenje AndroidKeystoreBrute alata

Prilikom pokretanja dobiju se alias i datum tj. vrijeme kreiranja keystore datoteke. U ovom slučaju to su:

Found alias: demoapp
Creation Date: Fri Aug 07 14:42:35 CEST 2020

1 2	Found alias: demoapp Creation Date: Fri Aug 07 14:42:35 CEST 2020

1. metoda – Simply Bruteforce

java -jar AndroidKeystoreBrute_v1.05.jar -m 1 -k DemoApp.keystore -start AAAAAA

1	java -jar AndroidKeystoreBrute_v1.05.jar -m 1 -k DemoApp.keystore -start AAAAAA

Najsporija metoda. Ovdje se ne koristi riječnik s popisom mogućih riječi nego se vrte sve kombinacije počevši od zadanog argumenta -START AAAAAA

2. metoda – Dictionary Attack

java -jar AndroidKeystoreBrute_v1.05.jar -m 2 -k DemoApp.keystore -d "wordlist.txt"

1	java -jar AndroidKeystoreBrute_v1.05.jar -m 2 -k DemoApp.keystore -d "wordlist.txt"

Metoda koja će vrtiti popis zadanih riječi u točnom obliku kako su navedene. Znači neće ih kombinirati kao što to radi u 3. metodi. Potreban je puno veći popis riječi i sve moguće kombinacije.

3. metoda – Smart Wordlist Attack (preporuka)

java -jar AndroidKeystoreBrute_v1.05.jar -m 3 -k DemoApp.keystore -d "wordlist.txt"

1	java -jar AndroidKeystoreBrute_v1.05.jar -m 3 -k DemoApp.keystore -d "wordlist.txt"

Najbolja metoda jer će od svih riječi iz riječnika napraviti sve moguće kombinacije. Brojevi se dodaju automatski i nije ih potrebno posebno navoditi. Ipak, ako znate da se lozinka sastoji od npr. broja godine “2020” dobro je to navesti jer će ubrzati pronalazak ispravne kombinacije.

Popis riječi koje sam koristio u wordlist.txt:

tomislav
primjer
demo
blog
8
7
0

tomislav

primjer

demo

blog

Ispravnu kombinaciju lozinke dobio sam za 22 sekunde:

Naslovna slika preuzeta sa https://android-developers.googleblog.com/2018/12/new-keystore-features-keep-your-slice.html