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

xpagesKomma igång med xpages


Anmärkningar

XPages är en webbram för IBM Notes-plattformen. Det introducerades i Lotus Domino 8.5 (måste verifieras) .

Det är baserat på JSF (JavaServer Faces) med många användbara tillägg för att representera och manipulera IBM Notes-data.

IBM erbjuder en handledning för XPages: https://www-10.lotus.com/ldd/ddwiki.nsf/dx/Tutorial-intro-to-XPages.htm

Bakom kulisserna I backend XPages finns XML-filer som liknar HTML. Domino-servern skapar äntligen riktigt HTML och skickar dessa sidor till klienten. Affärslogiken implementeras i inbyggt JavaScript ("clientside JavaScript - CSJS") och pseudo JavaScript ("serverside JavaScript - SSJS").

Installation eller installation

Kort sagt: XPages är en del av IBM Domino Designer. Extra installation eller installation krävs inte för XPages.


Första XPage / Hello-World-exempel

För att skapa din första XPage måste du skapa en ny NSF först. Öppna IBM Domino Designer och öppna menyn " File " -> " New " -> " Application ".

Gör dessa inställningar i popup-dialogen:

  1. Välj den server där NSF ska skapas (kan också vara "lokal").
  2. Ange sedan en titel, till exempel " Hello World NSF ".
  3. Ange sedan ett filnamn på din nya NSF, till exempel " hello-world.nsf ".
  4. Ignorera knappen "Encription ..." för att behålla standardinställningarna.
  5. Markera alternativet " fullständigt index ".
  6. Klicka sedan på "OK".

Den nya NSF skapas.

Högerklicka nu på avsnittet "[XPages]" i applikationsnavigatorn och välj " ny XPage ... ".

  1. Ange en titel på din nya XPage, till exempel " HelloWorld ". Detta skapar en fil med namnet "HelloWorld.xsp".
  2. Kommentarfältet kan lämnas tomt för detta enkla exempel.
  3. Klicka på "OK" så skapas sidan.

Dubbelklicka på din nya HelloWorld XPage, som du kan hitta under avsnittet "[XPages]".

Välj fliken "Källa" (som finns längst ner i redigeraren) och lägg till en enkel textfältkomponent på din sida. Detta borde vara resultatet:

<?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>
 

Spara sidan och bygg projektet (högerklicka på din applikation "Hello World NSF" och välj menypost "build").

Öppna nu en webbläsare som Internet Explorer och navigera till den nya XPage för din applikations NSF. Till exempel " http://mydominoserver.com/hello-world.nsf/HelloWorld.xsp " och du ser din Hello World-text.

Använd externa texter med message.properties i XPages

Förbereda

message.properties först en " message.properties " message.properties i resurser / filer /. Exempel:

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

Anslut sedan resursen till din XPage eller anpassad kontroll:

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

Obs: "var" definierar namnet du vill använda i dina XPages eller anpassade kontroller för att referera meddelandekartan.

Användande

Nu kan du använda meddelandekartan med JavaScript på serversidan ( #{javascript:appMsg.getString('...')} ) eller med EL ( #{appMsg['...']} ).

Exempel på användning:

...
<!-- 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>
...