Looking for xpages Answers? Try Ask4KnowledgeBase
Looking for xpages Keywords? Try Ask4Keywords

xpagesIniziare con xpages


Osservazioni

XPages è un framework Web per la piattaforma IBM Notes. È stato introdotto in Lotus Domino 8.5 (deve essere verificato) .

È basato su JSF (JavaServer Faces) con molte estensioni utili per rappresentare e manipolare i dati di IBM Notes.

IBM offre un tutorial per XPages: https://www-10.lotus.com/ldd/ddwiki.nsf/dx/Tutorial-intro-to-XPages.htm

Dietro le quinte Nel backend XPages sono file XML che è simile all'HTML. Il server Domino rende finalmente HTML reale e invia queste pagine al client. La logica aziendale è implementata in JavaScript nativo ("clientide JavaScript - CSJS") e pseudo JavaScript ("serveride JavaScript - SSJS").

Installazione o configurazione

In breve: XPages fa parte di IBM Domino Designer. Non è richiesta alcuna installazione o installazione aggiuntiva per XPages.


Primo esempio di XPage / Hello-World

Per creare il tuo primo XPage devi prima creare un nuovo NSF. Aprire IBM Domino Designer e aprire il menu " File " -> " Nuovo " -> " Applicazione ".

Nella finestra di dialogo popup, effettuare queste impostazioni:

  1. Seleziona il server in cui verrà creato NSF (può anche essere "locale").
  2. Quindi inserire un titolo, ad esempio " Hello World NSF ".
  3. Quindi inserire un nome file del nuovo NSF, ad esempio " hello-world.nsf ".
  4. Ignora il pulsante "Encription ..." per mantenere le impostazioni predefinite.
  5. Controlla l'opzione " indice completo ".
  6. Quindi fare clic su "OK".

Viene creato il nuovo NSF.

Ora fai clic con il tasto destro sulla sezione "[XPages]" nel navigatore dell'applicazione e seleziona " new XPage ... ".

  1. Inserisci un titolo del tuo nuovo XPage, ad esempio " HelloWorld ". Questo creerà un file chiamato "HelloWorld.xsp".
  2. Il campo dei commenti può essere lasciato vuoto per questo semplice esempio.
  3. Fai clic su "OK" e la pagina viene creata.

Fai doppio clic sul tuo nuovo HelloWorld XPage, che puoi trovare nella sezione "[XPages]".

Seleziona la scheda "Sorgente" (che si trova nella parte inferiore dell'editor) e aggiungi un semplice componente di testo alla tua pagina. Questo dovrebbe essere il risultato:

<?xml version="1.0" encoding="UTF-8"?>
<xp:view xmlns:xp="http://www.ibm.com/xsp/core" pageTitle="Hello My World">

  <xp:text id="simpleTextField" value="Hello World!!!!" />

</xp:view>
 

Salva la pagina e crea il progetto (fai clic con il tasto destro del mouse sulla tua applicazione "Hello World NSF" e seleziona la voce di menu "build").

Ora apri un browser come Internet Explorer e naviga verso il nuovo XPage del tuo NSF dell'applicazione. Ad esempio " http://mydominoserver.com/hello-world.nsf/HelloWorld.xsp " e vedrai il tuo testo Hello World.

Utilizzare testi esterni con message.properties in XPages

Preparare

Prima crea un file " message.properties " in Risorse / File /. Esempio:

##############
# Test message.properties
##############
label.age=Enter your age:
validate.error.reqired.age=Sorry, but you have to give away the secret of your age ...
 

Quindi, collega la risorsa con il tuo XPage o controllo personalizzato:

<xp:this.resources>
    <xp:bundle src="/messages.properties" var="appMsg" />
    ....
</xp:this.resources>
 

Nota: "var" definisce il nome che si desidera utilizzare nelle XPage o nei controlli personalizzati per fare riferimento alla mappa dei messaggi.

uso

Ora puoi utilizzare la mappa dei messaggi con JavaScript lato server ( #{javascript:appMsg.getString('...')} ) o con EL ( #{appMsg['...']} ).

Esempio di utilizzo:

...
<!-- to show the error message: -->
<xp:messages />

<!-- use with ssjs: -->
<xp:text value="#{javascript:appMsg.getString('label.age')}" escape="false" />

<!-- use with EL: -->
<xe:djNumberSpinner value="#{myDoc.age}" maxLength="2" javaType="int">
    <xp:this.validators>
        <xp:validateRequired message="#{appMsg['validate.error.reqired.age']}" />
    </xp:this.validators>
</xe:djNumberSpinner>
...