Argomento precedente: Variabili degli elenchiArgomento successivo: Variabili delle operazioni


Operazioni server supportate

Per consentire l'integrazione delle pagine Web di CA SDM con le proprie pagine Web, sono supportate le operazioni seguenti:

CREATE_NEW

Fornisce un'interfaccia generica per consentire all'utente di creare una nuova riga in una determinata tabella. È necessario specificare il nome dell'oggetto e, per impostazione predefinita, viene usato un modello chiamato dettagli_xxx_edit.htmpl per l'oggetto xxx. È possibile ignorare il file .htmpl specificando la proprietà HTMPL.

Specificatori obbligatori:

FACTORY=objectname

Specificatori opzionali:

ALG_PRESET=espressione_preset
ALG_PRESET_REL=espressione_preset
CREATE_ALG=tipo_registro_attività
HTMPL=zdetailxxx_factory.htmpl
KEEP.nome_attr=valore
PRESET=espressione_preset
PRESET_REL=espressione_preset
SET.nome_attr=valore
use_template=1 | 0 (0 è il valore predefinito)

Nota: per usare lo specificatore HTMPL con CREATE_NEW, il modulo a cui si fa riferimento deve avere un nome conforme alla convenzione zdetailxxx_factory.htmpl. Deve iniziare con la stringa zdetail, seguita da caratteri alfanumerici (compresa una stringa nulla), seguiti da un carattere di sottolineatura e dal nome del factory.

ENDSESSION o LOGOUT

Chiude la sessione di accesso corrente. ENDSESSION è l'operazione consigliata.

GENERIC_LIST

Fornisce un'interfaccia generica per consentire all'utente di visualizzare un elenco da qualsiasi tabella nel database. È necessario specificare il nome dell'oggetto e, per impostazione predefinita, viene usato un modello chiamato list_xxx.htmpl per l'oggetto xxx. È possibile ignorare il file .htmpl specificando la proprietà HTMPL.

Specificatori obbligatori:

FACTORY=objectname
KEEP.nome_attr=valore

DISPLAY_FORM

Fornisce un'interfaccia generica per consentire all'utente di visualizzare qualsiasi modulo personalizzato.

Specificatori obbligatori:

HTMPL=file_htmpl

Nota: DISPLAY_FORM sostituisce JUST_GRONK_IT. Le implementazioni esistenti possono continuare a utilizzare JUST_GRONK_IT, che funziona esattamente come DISPLAY_FORM. DISPLAY_FORM è l'operazione consigliata.

MENU

Mostra la pagina di menù principale, definita nel file web.cfg nelle proprietà dei menù.

Specificatori opzionali:

HTMPL=filemenu

filemenu è il nomefile del menu principale alternativo.

PAGE_EXTENSION

Consente al Web master di specificare ulteriori estensioni per l'interfaccia.

Specificatori obbligatori:

NAME=file_html

html_file è uno dei nomi di file elencati nel file di configurazione UserPageExtensions.

Specificatori opzionali:

REQUIRES_LOGIN=1

Se presente, compare una pagina di accesso se l'utente non ha ancora effettuato l'accesso. Se manca o è impostato su zero, il file viene mostrato senza verificare se l'utente ha effettuato l'accesso.

RELOG

Visualizza la schermata di accesso.

SEARCH

Fornisce un'interfaccia generica per consentire l'esecuzione di ricerche in qualsiasi tabella del database. Questa operazione presuppone che sia stato creato un search_xxx.htmpl appropriato, dove xxx è il nome-oggetto, come definito nei file .maj nella cartella majic in bopcfg.

Nota: per ulteriori informazioni, consultare la Guida di riferimento tecnico di CA SDM. Per impostazione predefinita, i risultati di questa ricerca sono visualizzati in list_xxx.htmpl, ma questo file può essere ignorato specificando la proprietà HTMPL.

Specificatori obbligatori:

FACTORY=nome-oggetto
QBE.op.nome_attr=valore

Specificatori opzionali:

ALG_PRESET=espressione_preset
ALG_PRESET_REL=espressione_preset
CREATE_ALG=tipo_registro_attività
HTMPL=file_elenco_htmpl
KEEP.nome_attr=valore

SEC_REFRESH

Aggiorna le informazioni sull'accesso dell'utente dal sottosistema di protezione. Agli utenti in possesso del privilegio di modifica (per il gruppo funzionale admin) viene fornito un collegamento ipertestuale per questa operazione sulla schermata del menu. Dopo aver aggiornato il privilegio di accesso di un utente usando il programma di protezione, con questa operazione è possibile aggiornare le informazioni sull'accesso (vengono aggiornate le informazioni di protezione per tutti gli utenti).

Nota: l'aggiornamento della protezione è un processo asincrono. Una volta completato, viene visualizzato un messaggio nel file registro standard (stdlog).

SET_MENU

Il comportamento di questa operazione è uguale a quello di MENU, quando MENU è usata con la variabile HTMPL. L'unica differenza è che questa operazione imposta anche il modulo menu predefinito sul modulo specificato con la proprietà HTMPL.

Specificatori obbligatori:

HTMPL=file_htmpl

Nota: con questa operazione viene ignorata l'impostazione MENU nel file web.cfg finché il servizio Web non viene riavviato.

SHOW_DETAIL

Fornisce un'interfaccia generica per consentire all'utente di visualizzare in sola‑lettura i dettagli di una riga in una determinata tabella. È necessario specificare il nome dell'ID persistente (da cui si ricava il nome dell'oggetto). Per impostazione predefinita, viene usato un modello chiamato detail_xxx_ro.htmpl per l'oggetto xxx. È possibile ignorare il file .htmpl specificando la proprietà HTMPL.

Specificatori obbligatori:

PERSID=id‑persistente

Specificatori opzionali:

ALG_PRESET=espressione_preset
ALG_PRESET_REL=espressione_preset
CREATE_ALG=tipo_registro_attività
HTMPL=file_dettagli_htmpl_sola_lettura

UPDATE

Fornisce un'interfaccia generica per modificare qualsiasi tabella. È necessario passare l'ID e il nome dell'oggetto; un modulo dettagli modificabile viene visualizzato dall'utente. Per impostazione predefinita, l'utente ha accesso esclusivo al record per due minuti e, se in questo periodo vengono inviati i cambiamenti, il database viene aggiornato.

Specificatori obbligatori:

PERSID=id-persistente o
SET.id=id-riga-da-aggiornare FACTORY=nome-oggetto

Specificatori opzionali:

NEXT_PERSID=idpersistente (del record da visualizzare dopo l'aggiornamento)
KEEP.nome_attr=valore
KEY.nome_attr=valore
HTMPL=zdetailxxx_factory.htmpl

Nota: per usare lo specificatore HTMPL con UPDATE, il modulo a cui si fa riferimento deve avere un nome conforme alla convenzione zdetailxxx_factory.htmpl. Il nome deve iniziare con la stringa “zdetail”, seguita da caratteri alfanumerici (compresa una stringa nulla), seguiti da un carattere di sottolineatura e dal nome del factory.

Nota: per informazioni su web.cfg, vedere la Guida all'amministrazione.