JAMP può interagire con diversi tipi di strutture dati come database, filesystem, file xml, tracciati record, LDAP e altre che verranno sviluppate. Indipendetemente dal tipo di connessione i parametri si impostano all'interno del file conf/conf.inc.php Il file è così composto:

<?php
die(); // name|dsengine|dshost[@schema]|dsuser|dspwd|port
?>

La prima riga non deve essere rimossa e serve ad evitare che il file venga visualizzato richiamando la pagina dal browser.
Ogni riga del file rappresenta una connessione ed è composta da 6 campi separati dal "|":

  • name: Identificativo della connessione da associare al tag ds(data source) tramite attributo conn
  • dsengine: tipologia di connessione(mysql, pgsql, mssql, odbc, ldap, filesystem, ssh, xml, ftp, record e csv)
  • dshost: nome macchina o indirizzo IP del server a cui connettersi.
  • dsuser: l'utente da utilizzare per la connessione
  • dspwd: la password da utilizzare per la connessione
  • port: la porta su cui è in ascolto il servizio, fanno eccezione le connessioni a tracciati record e file csv nelle quali questo campo rappresenta la modalità di apertura file

I primi tre campi(nome, tipo e server) devono essere necessariamente specificati perché indispensabili per il funzionamento del sistema, gli altri potrebbero anche essere impostati al valore none, in questo caso JAMP utilizzerà i valori di default, ad esempio per una connessione di tipo SSH verrà utilizzata la porta 22.

MODALITA' IN SOLA LETTURA

Chiamando la connessione "demoXX" (demo,demo1,democlienti...), si forzano tutti i datasource al funzionamento in sola lettura.


CONNESSIONI A DATABASE

Per le connessioni a database è possibile indicare assieme all'indirizzo IP del server anche il nome dello schema utilizzando il carattere separatore(@), in questo modo non si avrà l'onere di dover specificare in ogni oggetto ds l'attributo dsdefault con il nome dello schema:

<?php
db|mysql|localhost@jfatture|jamp|admin|3306
?>

CONNESSIONI DINAMICHE

1) Metodo (connessione custom)

A volte può essere necessario istanziare dinamicamente un datasource. Per far ciò è possibile utilizzare le connessioni di tipo custom. Basta impostare la proprietà “conn” a “custom”:

<ds1 typeobj="ds" conn="custom"/>

Tale metodo consente di specificare con una riga di codice la connessione per tutti gli eventi dell'oggetto ds (Selezione, inserimento, salvataggio...). I dati di connessione dovranno essere specificati nel file php nell'array: $DS_CONN["id_ds"]

<?php
require_once("./../class/system.class.php");
$system = new ClsSystem(true);
$DS_CONN["ds1"] = "mysql|localhost@jfatture|jamp|admin|3306";
$xml  = new ClsXML("filexml");
$event = new ClsEvent($xml);
$event->managerRequest();
?>

2) Metodo (metodo diretto)

E' possibile settare e/o alterare le proprietà con il metodo diretto. Tale metodo viene utilizzato quando è necessario variare le proprietà di connessione in base all'evento del ds. In questo caso bisogna manipolare l'oggetto ds nell'evento desiderato e corretto.