@acknow-srl/ack-prints-client 中文文档教程

Question

Client Stampe Acknow

1 - 安装 对等依赖

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

库

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

2 - 导入模数 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, 在 tal caso verrà utilizzato esclusivamente dalla libreria senza impattare minimanente sul resto dell'app。

3 - Form parametri stampa dinamici 在 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 服务器，il caricamento della libreria avviene 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à sufficient 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 我parametri forniti

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