Client Stampe Acknow

1 - installazione peer dependencies

npm i -s @ngrx/store @ngrx/effects file-saver

library

npm i -s @acknow-srl/ack-prints-client

2 - import modulo app.module.ts

@NgModule({

	declarations: [AppComponent],

	imports: [
		...
		StoreModule.forRoot(reducers),
		EffectsModule.forRoot([]),
		PrintsClientModule.forRoot(() =>  import('src/app/prints-forms'))
	],
	providers: [
	]
	bootstrap: [AppComponent]
})
export  class  AppModule {
}

è necessario importare i moduli StoreModule e EffectsModule anche se l'app non utilizza ngrx di suo, in tal caso verrà utilizzato esclusivamente dalla libreria senza impattare minimanente sul resto dell'app.

3 - Form parametri stampa dinamici in fase di import del modulo è possibile specificare un percorso di import per i form dinamici, il percorso deve puntare ad un barrel (index.ts) contenente tutti gli export dei vari componenti dinamici da caricare, un esempio di un componente caricato dinamicamente lo trovi su ng-demo: https://gitlab.acknow.it/acknow/ng-demo/tree/master/src/app/prints-forms

per istruire la libreria sul path da importare bisogna creare una funzione di questo tipo:

() =>  import('src/app/prints-forms')

la funzione deve restituire la Promise di caricamento del modulo dal server, il caricamento della libreria avviene in maniera lazy la prima volta in cui l'applicazione ne ha bisogno

NOTA: se non hai bisogno di caricare form dinamici puoi importare semplicemente il modulo senza la funzione "forRoot"

4 - Scaricare una stampa Per scaricare una stampa sarà necessario sapere l'endpoint della stampa, il percorso è il medesimo della stampa php chiamata in maniera diretta dal gestionale, sarà sufficiente aggiungere il prefisso /prints/[percorso originale]. una volta ottenure le informazione sarà necessario caricare il servizio nel componente:

constructor(
	...
	private  printsClient: PrintsClient
) {}

per avviare tutta la procedura basterà richiamare l'unica funzione presente nel servizio:

public  print() {
    this.printsClient.loadPrint('GET', 'http://api.acknow.it/prints/2_veca/www/RptVeca/RptRvDocConfordVeca.php', 
    'TestFormComponent');
}

NOTA: il terzo parametro in ingresso viene valutato in questa maniera:

• Tipo stringa: viene interpretato come nome di componente da caricare dinamicamente, questo componente rispetta una struttura precisa come nell'esempio che consente alla libreria di arrangiarsi con tutto il resto

• Oggetto: viene interpretato come body della richiesta, la libreria salterà la sezione di raccolta dati e andrà a scaricare direttamente la stampa con i parametri forniti

Una volta invocato il servizio la libreria si occuperà di tutto il resto, non sarà necessario fare nessuun'altra operaizione