IBM Domino Designer 9 Social Edition User Guide

First Edition

Published March 2013

About this edition

In keeping with IBM's commitment to accessibility, this edition of the product documentation is accessible.

Updates to this document

This HTML file contains the latest draft of the official product documentation for this release. This draft is refreshed on a quarterly basis, as necessary. For the latest product documentation updates, refer to the release-specific articles available in the Product Documentation section of the wiki.

Printing

When you print this document some of the style elements are removed to create a better print output. Here are a few tips about printing:
  • The document length might exceed the browser's print capability. Microsoft Internet Explorer has demonstrated the ability to print large files successfully.
  • This document is long. Use print preview to determine the printed page length.
  • You can highlight section of the document and then choose to only print the selected content

Working offline

You can save a local copy of this document from your browser. Each browser has different menus and menu options. Consult the browser help if you need assistance saving the document locally.

Submitting feedback

If you would like to provide feedback about this document, see the Documentation Feedback Web site.

มีอะไรใหม่ใน IBM Domino Designer 9.0 Social Edition

ข้อมูลเกี่ยวกับคุณลักษณะใหม่ และการปรับปรุงเพิ่มเติมในDomino Designer

Domino Designer

หัวข้อนี้แสดงคุณลักษณะใหม่ และการเปลี่ยนแปลงสำหรับ Domino Designer 9.0 Social Edition

การอัพเดต เป็นระยะใน Domino Designer Help จะมีอยู่บนเว็บ หากต้องการดาวน์โหลดไฟล์ Designer Help ล่าสุด ไปที่ส่วนไลบรารีเอกสารของdeveloperWorks ที่ http://www.lotus.com/ldd/doc. คลิก ไลบรารีเชิงเทคนิค จากนั้นคลิก ตามผลิตภัณฑ์, จากนั้นคลิก Domino Designer, และ, ท้ายสุด, คลิกรีลีสที่คุณต้องการดู

ในพื้นที่ของ Domino Designer โดยทั่วไป, การเพิ่มหรือการเปลี่ยนแปลงต่อไปนี้ได้ถูกทำขึ้น:

อิลิเมนต์การออกแบบ JAR -- อิลิเมนต์การออกแบบ JAR ใหม่ได้ถูกแนะนำไว้ ในรีลีสนี้ อิลิเมนต์การออกแบบ JAR ให้ความสามารถในการทำงานกับโค้ด/ ไลบรารี Java™ ที่จัดทำเป็นแพ็กเกจ ซึ่งถูกรวมไว้ในแอ็พพลิเคชัน NSF อิลิเมนต์การออกแบบนี้ พร้อมใช้งานกับแอ็พพลิเคชัน XPage, โดยที่ JAR ถูกโหลดแบบอัตโนมัติโดย XPages ณ รันไทม์ คุณลักษณะนี้ให้อิสระกับคุณ จากการนำ JARS ไปใช้งานกับเซิร์ฟเวอร์ และ/หรือ รวมซอร์สไฟล์ ในฐานข้อมูลแอ็พพลิเคชัน ขณะที่ไฟล์ JAR สามารถเพิ่มไปยัง NSF ผ่านระบบเสมือน, อิลิเมนต์การออกแบบ JAR จะจัดการกับ คลาสพาธแบบอัตโนมัติและวางไฟล์ JAR ลงใน web-inf/lib, ซึ่งถูกแนะนำตำแหน่งไว้สำหรับไฟล์ JAR ที่ใช้ในแอ็พพลิเคชัน J2EE อิลิเมนต์การออกแบบ JAR ถูกพบในเนวิเกเตอร์แอ็พพลิเคชันซึ่งตามด้วย อิลิเมนต์ โค้ด

คุณสร้างอิลิเมนต์ JAR โดยใช้ขั้นตอนที่คล้ายกับที่สร้างรีซอร์สอิมเมจ - หรืออีกนัยหนึ่ง, JAR ถูกอิมพอร์ตไปยังแอ็พพลิเคชันแทนที่จะสร้าง ขึ้นใหม่ พาเนลแสดงรายการอิลิเมนต์การออกแบบมีปุ่ม อิมพอร์ต JAR ที่อนุญาตให้คุณเลือกและอิมพอร์ตไฟล์ JAR ที่ต้องการได้

ซึ่ง ไม่จำเป็นสำหรับ JARS ที่ต้องมี aliases และ, เนื่องจาก, ไฟล์เหล่านั้นไม่ได้รับการสนับสนุน รายการออกแบบสำหรับ JAR เป็นสิ่งที่ง่ายและเป็นรายการเฉพาะกับไฟล์, ด้วยข้อยกเว้นที่คอลัมน์ Alias ถูกถอนออก เนื่องจาก ขนาดข้อมูลของ JAR อาจเป็นสิ่งจำเป็น, ซึ่งจะรวมอยู่ในคอลัมน์ ไบต์ ท้ายสุด, เมนูใหม่ทั้งหมดจะมีรายการสำหรับอิลิเมนต์ใหม่นี้ ในรายการของอิลิเมนต์การออกแบบเช่นเดียวกัน

จากวิธีต่างๆ เพื่อสร้าง JAR, คุณจะมองเห็นไดอะล็อก Eclipse มาตรฐานต่อไปนี้เพื่อเลือกไฟล์, ซึ่งมีรายการที่กรองแล้ว ที่รวมอยู่ใน jars จากนั้น คุณเลือก JAR(s) ที่คุณต้องการ, กด บันทึก, และ JAR จะถูกอิมพอร์ตไปยังแอ็พพลิเคชัน

เมื่อเลือกใน พาเนลรายการออกแบบ Designer หรือในเนวิเกเตอร์แอ็พพลิเคชัน, อิลิเมนต์ JAR จะจัดเตรียมชุดมาตรฐานของพาเนลคุณสมบัติ, แต่ยังรวมถึงพาเนล ระดับต้น เพื่ออนุญาตให้คุณเพิ่มข้อคิดเห็น, เปลี่ยนชื่อ JAR, หรือจัดการกับแฟล็ก แทนที่ (คุณลักษณะนี้ถูกจัดเตรียมไว้เนื่องจาก JARs คืออิลิเมนต์ที่ถูกอิมพอร์ต, คุณอาจต้องการให้สามารถเก็บ Note ID ไว้)

ด้วย อิลิเมนต์การออกแบบไฟล์อื่น, ฟังก์ชัน Export ยังคงพร้อมใช้งาน และ JARS สามารถลงนามด้วยแอ็คชัน Sign

คลาสพาธถูกปรับไว้ สำหรับแต่ละ JAR ใน NSF, ดังนั้น เวลาในการคอมไพล์การออกแบบสามารถแก้ปัญหา การอ้างถึง jar ได้ การเปลี่ยนแปลงกับ .classpath ไม่ได้มีอยู่ในดิสก์, ดังนั้น เวอร์ชันเก่าของ Designer จะไม่ทำงานผิดพลาด

ณ รันไทม์, JAR note ถูกขยายไปยังระบบไฟล์ XPage ณ รันไทม์ใน web-inf/lib, และพร้อมใช้งานกับเซิร์ฟเวอร์ JS บน XPage, เช่นเดียวกับคลาส Java ใดๆ ที่อ้างถึงในสภาวะแวดล้อมนั้น

คุณลักษณะสถานะการบันทึกของถาดข้อมูล -- สำหรับรีลีสนี้, ถาดข้อมูลของเอดิเตอร์ XPages จำสถานะจาก XPage หนึ่งไปเป็นตัวถัดไป ซึ่งยังจำสถานะระหว่างเซสชันของ Domino Designer ด้วย

ไฟล์ส่วนสนับสนุน PNG สำหรับรีซอร์สอิมเมจ -- สำหรับรีลีสนี้, คุณมี ความสามารถในการอิมพอร์ตไฟล์ PNG ไปยัง Designer ในรูปของรีซอร์สอิมเมจ ชนิดไฟล์นี้คือตัวเลือกในคอมโบบ็อกซ์ ชนิดอิมเมจ ความสามารถนี้อนุญาตให้คุณใช้ไฟล์ PNG ในตำแหน่งที่ใช้รีซอร์สอิมเมจ (ตัวอย่างเช่น, XPages, แบบฟอร์ม, มุมมอง, โครงร่าง, เป็นต้น).

การทำงานของการนำทาง XPages Source Editor Hyperlink -- สำหรับรีลีสนี้ของ Domino Designer, XPages Source Editor สนับสนุนการนำทางไฮเปอร์ลิงก์ การนำทางผ่านไฮเปอร์ลิงก์อธิบายถึงการทำงานของ Eclipse ทั่วไปโดยที่ข้อความภายในเอดิเตอร์สามารถสร้างขึ้น ไฮเปอร์ลิงก์ได้

ด้วยการกด CTRL และลอยอยู่เหนือข้อความภายใน เอดิเตอร์ใดๆ ใน Eclipse, Eclipse จัดเตรียมผลสะท้อนไปยังเอดิเตอร์ ที่ผู้ใช้พยายามดำเนินการกับการนำทางผ่านไฮเปอร์ลิงก์ แต่ละเอดิเตอร์อาจเลือก การนำทางผ่านไฮเปอร์ลิงก์, โดยจัดเตรียมอ็อบเจ็กต์ไฮเปอร์ลิงก์ สำหรับขอบเขตที่ชี้โดยเคอร์เซอร์ สำหรับรีลีสนี้, เอดิเตอร์แหล่งที่มา XPages มีความสามารถในการใช้ฟังก์ชันนี้

การทำงาน ยังดำเนินการอยู่โดยไม่มีอ็อพชันปัจจุบันหรือการกำหนดค่าตามความชอบ เพื่อปิดใช้งาน ส่วนสนับสนุนสำหรับการนำทางผ่านไฮเปอร์ลิงก์ยังถูกจัดเตรียมไว้บน คอนโทรลโดยคอนโทรลพื้นฐาน การนำทางผ่านไฮเปอร์ลิงก์สามารถเรียกทำงาน กับคอนโทรลบางตัวได้, และในกรณีส่วนใหญ่ เรียกใช้เฉพาะแอ็ตทริบิวต์ บนคอนโทรลบางตัว ให้พิจารณาการใช้คุณลักษณะนี้ขณะที่แก้ไข คอนโทรลแบบกำหนดเอง เมื่อคุณกด CTRL และลอยอยู่เหนือคอนโทรลแบบกำหนดเอง ในเอดิเตอร์แหล่งที่มา, การนำทางผ่านไฮเปอร์ลิงก์จะอนุญาตให้คุณนำทางไปยัง คอนโทรลแบบกำหนดเองโดยตรง

ตัวอย่างเช่น, การวางเคอร์เซอร์อยู่เหนือ string.properties และคลิกบนไฮเปอร์ลิงก์ที่เป็นผลลัพธ์ในโค้ดของคุณ, ให้เปิด อิลิเมนต์การออกแบบที่เลือกไว้

การทำงานกับวิธีใช้การวางเคอร์เซอร์ล่งที่มา XPages – Eclipse จัดเตรียมกรอบงานแบบง่ายๆ สำหรับการอนุญาตให้เอดิเตอร์ จัดเตรียมวิธีใช้การวางเคอร์เซอร์แบบอ้างอิงตำแหน่งเคอร์เซอร์ของคุณเมื่อลอยอยู่ภายใน เอดิเตอร์ ตัวอย่างหนึ่งคือ วิธีใช้การวางเคอร์เซอร์ในเอดิเตอร์ Eclipse Java ด้วยการวางเคอร์เซอร์อยู่เหนือ คอนสตรัค Java เฉพาะ ขณะอยู่ในเอดิเตอร์, เอดิเตอร์สามารถจัดเตรียมข้อมูลเพิ่มเติมเกี่ยวกับ คอนสตรัคนั้น ใน Domino Designer, เอดิเตอร์ LotusScript จัดเตรียมส่วนสนับสนุนวิธีใช้การวางเคอร์เซอร์ในปัจจุบันสำหรับไอเท็มภายในเอดิเตอร์ LS

สำหรับ รีลีสนี้, คุณยังสามารถขอรับวิธีใช้ในเอดิเตอร์แหล่งที่มา XPages ได้ ด้วยคุณลักษณะนี้, คุณสามารถขอรับข้อมูลเกี่ยวกับ 'โหนด' ที่การวางเคอร์เซอร์อยู่ในปัจจุบัน คล้ายกับการนำทางผ่านไฮเปอร์ลิงก์ (โปรดดูที่ ก่อนหน้านี้), กรอบงานเอดิเตอร์ Eclipse จัดเตรียมข้อมูลการวางตำแหน่ง ให้กับเลเยอร์วิธีใช้แบบลอย, ซึ่งถูกตีความและแก้ปัญหากลับไปยังโหนด Dหากโหนด DOM ถูกแก้ไขแล้ว, เอดิเตอร์จัดเตรียมคำอธิบายสำหรับแท็กปัจจุบัน (และแอ็ตทริบิวต์) ไว้ แท็กและแอ็ตทริบิวต์ทั้งหมดที่จัดเตรียมคำอธิบายไว้ผ่าน xsp-config สามารถมีข้อมูลที่ทำให้สามารถมองเห็นได้ใน การทำงานของวิธีใช้การวางเคอร์เซอร์ภายในเอดิเตอร์แหล่งที่มาของ XPages

คุณลักษณะนี้ ถูกควบคุมโดยใช้การกำหนดค่าตามความชอบภายในแท็บ การกำหนดค่าตามความชอบของ Domino Designer คุณลักษณะ ะจะถูกเปิดไว้ตามค่าดีฟอลต์, ด้วยการหมดเวลาใช้งาน 500 มิลลิวินาทีซึ่งเชื่อมโยงกับการกำหนดค่าตามความชอบ นั่นคือ, เมื่อเคอร์เซอร์เป็น 'ที่พัก' ซึ่งมากกว่า 500 ms (มิลลิวินาที) กรอบเอดิเตอร์ Eclipse จะเรียกวิธีใช้การวางเคอร์เซอร์ของเอดิเตอร์แหล่งที่มาของ XPages ที่จุดนั้น, วิธีใช้การวางเคอร์เซอร์ของ XPages จะคำนวณโหนดที่เคอร์เซอร์กำลังลอย โดยอ้างอิงตาม ข้อมูลโหนด, การทำงานจะแก้ปัญหาโหนดพร้อมกับ รีจีสทรี XPages และดึงคำอธิบายสำหรับโหนด คุณลักษณะ ยังถูกออกแบบมาให้ทำงานกับหมายเหตุประกอบ 'this.attribute' ซึ่งถูกใช้อยู่ภายใน XPages ข้อมูลวิธีใช้แบบลอย ใช้แบบฟอร์มต่อไปนี้ในหน้าต่างวิธีใช้หากลอยอยู่เหนือ แท็ก (และไม่ใช่แอ็ตทริบิวต์):

ชื่อการแสดงผลแท็ก (tagName)

คำอธิบาย:

ถ้า เคอร์เซอร์กำลังลอยอยู่เหนือแอ็ตทริบิวต์ของแท็บ วิธีใช้จะใช้ แบบฟอร์มต่อไปนี้ในหน้าต่างวิธีใช้:

ชื่อการแสดงผลแท็ก (tagName)

คำอธิบาย:

ชื่อการแสดงผลแอ็ตทริบิวต์ (attributeName)

คำอธิบายแอ็ตทริบิวต์ :

ตามที่กล่าวไว้, ข้อมูลจะถึงมาจากรีจีสทรี XPages, ดังนั้น คุณลักษณะจะทำงานกับแท็กทั้งหมด - ไม่ใช่เพียงคอนโทรลแบบคอร์ XPages ท้ายสุด, การกด F2 ขณะที่วิธีใช้แบบลอย กำลังแสดงจะส่งโฟกัสไปที่หน้าต่างวิธีใช้แบบลอยซึ่งอนุญาตให้คุณปรับขนาด หน้าต่าง

การปรับปรุงการจัดการกับหน่วยความจำ – สำหรับรีลีสนี้, การปรับปรุงการจัดการกับหน่วยความจำได้ถูกทำขึ้นใน Domino Designer โดยเฉพาะในพื้นที่ของเอดิเตอร์ XPages การรั่วของหน่วยความจำที่ระบุไว้ก่อนหน้านี้ ได้ถูกตรวจสอบและแก้ปัญหาแล้ว ในอดีต, การรั่วเหล่านี้ เป็นแค่ระดับพื้นผิวเมื่อแก้ไข XPages ที่มีความซับซ้อนขนาดใหญ่ (เช่น, XPages ที่มีอิลิเมนต์ที่ซับซ้อนต่างๆ) พร้อมกับเวอร์ชวลไลเซชันคอนโทรลจำนวนมาก การรั่วเหล่านี้จะนำไปสู่ข้อยกเว้น หน่วยความจำของ Java ไม่เพียงพอ และเป็นสาเหตุทำให้ Domino Designer หยุดทำงาน

วิธีใช้เนื้อหาให้ความช่วยเหลือ – รีลีสนี้ แนะนำการทำงานของเนื้อหาให้ความช่วยเหลือในเอดิเตอร์แหล่งที่มา XPages คุณลักษณะนี้ อนุญาตให้คุณใช้เนื้อหาให้ความช่วยเหลือเมื่อทำงานใน 'โหมดแหล่งที่มา' ใน XPage คล้ายกับเอดิเตอร์ Eclipse อื่้นๆ, การกด CTRL+SPACE จะเรียกทำงานเนื้อหาให้ความช่วยเหลือ

เนื้อหาให้ความช่วยเหลือภายในเอดิเตอร์ XML ของ Eclipse (และเอดิเตอร์แหล่งที่มา XPages) ถูกผลักดันมาจากการใช้ สกีมา Domino Designer สร้างสกีมาที่อ้างอิงแอ็พพลิเคชัน Notes ปัจจุบันแบบไดนามิก สกีมามีข้อมูล วิธีใช้สำหรับแต่ละแอ็ตทริบิวต์ของแต่ละแท็กภายในรันไทม์ XPages หากต้องการเปิดใช้งานเนื้อหาให้ความช่วยเหลือภายในเอดิเตอร์ XPages, มาร์กอัพ XSP ต้องถูกปรับเปลี่ยนเพื่อแจ้งให้เอดิเตอร์แหล่งที่มา XPages ของตำแหน่งของสกีมาที่ถูกใช้ทราบ แต่ละ XPage ใหม่ที่สร้างขึ้น ภายใน Domino Designer npw มีข้อมูลเมตาต่อไปนี้ในคอนโทรล 'มุมมอง' ของ XPage:

xsi:schemaLocation="http://www.ibm.com/xsp/core xsdxp://localhost/xsp~core.xsd

นิยาม ตำแหน่งที่คล้ายกันจะถูกเพิ่มไว้สำหรับแต่ละเนมสเปซ ที่ถูกเพิ่มให้กับ XPage เมื่อดร็อปคอนโทรลจากถาดข้อมูล ไปยัง XPage, Domino Designer จะตรวจสอบว่า URI เนมสเปซของคอนโทรลมีตำแหน่งสกีมา ที่เชื่อมด้วยหรือไม่ ถ้าไม่มี, ตำแหน่งจะถูกสร้างและเพิ่มให้กับมาร์กอัพ XSP Domino Designer จะสร้างสกีมาแบบไดนามิกสำหรับเนมสเปซที่กำหนดไว้ อ้างอิงตามเนื้อหาของ FacesRegistry (ซึ่งมีนิยามสำหรับคอนโทรล XPages ทั้งหมด) สิ่งนี้อนุญาตให้ Domino Designer เพิ่มมาร์กอัพที่จำเป็นให้กับ XPage

ถ้าคุณมี XPages อยู่ก่อนแล้ว, คุณต้องเพิ่มคอนโทรลใหม่ไปยัง XPage (ผ่านการลาก แล้วปล่อยจากถาดข้อมูลคอนโทรล) เพื่อเปิดใช้งานเนื้อหา ให้ความช่วยเหลือใหม่

การตรวจหาชนิดเนื้อหา และฟิลด์ชนิดเนื้อหาที่สามารถแก้ไขได้ – ชนิดเนื้อหาที่สร้างขึ้นทั้งหมดถูกตรวจพบโดย Domino Designer

ฟิลด์ ชนิดเนื้อหาที่สามารถแก้ไขได้ – ฟิลด์ชนิดเนื้อหาสำหรับฟิลด์ที่คำนวณแล้ว และคอลัมน์มุมมองยังสามารถแก้ไขได้ เมื่อพัฒนาคอนโทรลสำหรับ Social Enabler, ฟิลด์ชนิดเนื้อหาสำหรับคอนโทรลฟิลด์ที่คำนวณแล้ว และสำหรับคอลัมน์มุมมองจะเป็นแบบอ่านอย่างเดียว ซึ่งไม่สามารถ ยอมรับได้เนื่องจากลูกค้าต้องการสร้างชนิดเนื้อหาของตนเอง ในกรณีของ Social Enabler มีหลายชนิดเนื้อหาที่พร้อมใช้งาน

ไม่ใช่ทั้งหมด ที่จะแสดงให้เห็นในฟิลด์ที่คำนวณแล้วหรือในคอลัมน์มุมมอง ที่เป็นอ็อพชัน, นั่นหมายความว่า คุณต้องการไปยังมุมมอง คุณสมบัติทั้งหมด เพื่อป้อนค่าเหล่านี้ ถึงอย่างนั้น พาเนลทางการยังคงแสดง ค่าเดิมของข้อความ แม้ว่าจะกำหนดค่าเป็นอย่างอื่น

การเปลี่ยนแปลงนี้แก้ไขปัญหานั้น คอลัมน์มุมมอง พาเนลแสดงและฟิลด์ที่คำนวณแล้ว พาเนลพื้นฐาน สนับสนุนชนิดเนื้อหาที่ลงทะเบียนแล้วทั้งหมด, และฟิลด์เหล่านั้นสามารถแก้ไขได้ ซึ่งคุณสามารถป้อน ชื่อชนิดเนื้อหาของคุณเองตามที่คุณต้องการได้

ส่วนสนับสนุนตัวแปลง ที่เพิ่มให้กับคอนโทรลเช็กบ็อกซ์ XPages – สำหรับรีลีสนี้, คอนโทรลเช็กบ็อกซ์ ยอมรับตัวแปลงแล้ว

ตัวแปลงค่าบูลีน ที่เพิ่มให้กับคอนโทรลซึ่งยอมรับตัวแปลง – สำหรับรีลีสนี้, คอนโทรลที่ยอมรับตัวแปลงจะยอมรับตัวแปลงค่าบูลีนแล้ว ตัวแปลงค่าบูลีน อนุญาตให้บันทึกค่าผ่าน XPage ที่ถูกเก็บภายใน แหล่งข้อมูลเป็นอ็อบเจ็กต์บูลีน, ซึ่งตรงข้ามกับสตริง Domino Designer อนุญาตให้เพิ่มตัวแปลงค่าบูลีน บนคอนโทรล XPage ใดๆ ที่สนับสนุนตัวแปลง

การเปลี่ยนแปลงการกำหนดค่าตามความชอบของ Domino Designer – การเปลี่ยนแปลงต่อไปนี้ได้ถูกทำขึ้นกับการกำหนดค่าตามความชอบของ Domino Designer:
  • XPages คือหมวดหมู่การกำหนดค่าตามความชอบของตนเอง
  • ไลบรารีส่วนขยายและการกำหนดค่าตามความชอบของถาดข้อมูลได้ถูกเพิ่มไปยังหมวดหมู่ XPages
  • ชื่อกล่องกลุ่มพาเนลการกำหนดค่าตามความชอบของ XPages ได้ถูกเปลี่ยนเป็นเอดิเตอร์ XPages
  • การกำหนดค่าตามความชอบ แสดงเส้นกั้นในเอดิเตอร์ คือ แสดงเส้นกั้นในเอดิเตอร์การออกแบบ ตามที่อ้างถึงในเอดิเตอร์แหล่งที่มา
  • การกำหนดค่าตามความชอบของวิธีใช้แบบ Bubble และการกำหนดค่าตามความชอบของวิธีใช้แบบลอย ถูกย้ายจากพาเนลการกำหนดค่าตามความชอบของ Domino Designer ไปยังพาเนล XPages/กลุ่มเอดิเตอร์ XPages
  • เช็กบ็อกซ์ใหม่ และตัวจับเวลาที่เกี่ยวข้องสำหรับการวางเมาส์เหนือวิธีใช้และการช่วยเหลือ ของเนื้อหาจะถูกเพิ่มไปยังพาเนล XPages/กลุ่ม XPages Editor คอนโทรลตัวจับเวลา จะเป็นสีเทาหากไม่ได้ทำเครื่องหมายที่เช็กบ็อกซ์ไว้

ปิดการทำงานกับแอ็พพลิเคชัน – สำหรับรีลีสเหล่านี้, คุณสามารถปิดแอ็พพลิเคชันแบบแมนวลซึ่งเปิดอยู่ในเนวิเกเตอร์แอ็พพลิเคชัน Domino Designer เมื่อต้องการเข้าถึงการทำงานนี้, ไอเท็มเมนูใหม่ได้ถูกเพิ่มให้กับ เนวิเกเตอร์แอ็พพลิเคชันที่อนุญาตให้คุณปิดแอ็พพลิเคชันแบบแมนวลได้ ซึ่งเปิดไว้ก่อนหน้านี้ในเนวิเกเตอร์แอ็พพลิเคชัน

ไอเท็มเมนูนี้ ถูกเปิดใช้งานเมื่อเลือกแอ็พพลิเคชันเท่านั้น, และแอ็พพลิเคชันเดียวกันนี้ได้เปิดขึ้นแล้ว ไอเท็มเมนูจะถูกปิดใช้งาน เมื่อโหนดในแผนผังอิลิเมนต์การออกแบบถูกเลือกไว้

ไอเท็มเมนูนี้ ถูกแจ้งให้ทราบเมื่อเปิดแอ็พพลิเคชันโดยไม่เปลี่ยนการเลือกใดๆ ตัวอย่างเช่น, เราพูดได้ว่า แอ็พพลิเคชัน A ถูกปิดและคุณพยายามเลือก เมนู ในกรณีนี้, ไอเท็มเมนูปิดแอ็พพลิเคชันจะถูกปิดใช้งาน หรืออีกนัยหนึ่ง, ถ้าคุณเปิดแอ็พพลิเคชัน A โดยไม่เปลี่ยนการเลือก ภายในเนวิเกเตอร์และลองเลือกเมนู, ไอเท็มเมนูปิดแอ็พพลิเคชัน จะถูกเปิดใช้งาน

เมื่อเลือก, ไอเท็มเมนูปิดแอ็พพลิเคชัน จะปิดแอ็พพลิเคชันที่เลือกไว้ในปัจจุบันพร้อมกับ ปิดอิลิเมนต์การออกแบบทั้งหมดที่แอ็พพลิเคชันนั้น เปิดอยู่ในปัจจุบัน

พาเนลคอนฟิกูเรชันแหล่งข้อมูล -- พาเนลเลือกแหล่งที่มาถูกจัดเตรียมไว้สำหรับคอนโทรลมุมมองข้อมูลและมุมมองแบบไดนามิก ในไลบรารีส่วนขยาย (โปรดดูส่วนที่สอดคล้องกันในหัวข้อนี้) พาเนลนี้จะเปิดขึ้นในทันทีหลังจากดร็อปหนึ่งในคอนโทรลเหล่านี้ ลงใน XPage พาเนลเหล่านี้อนุญาตให้คุณเลือกหรือจัดเตรียม ข้อมูลต่อไปนี้:
  • แหล่งที่มาที่คุณต้องการให้แสดงข้อมูล (มุมมอง Domino)
  • แอ็พพลิเคชันที่จัดเตรียมแหล่งข้อมูลไว้
  • มุมมองที่ระบุเฉพาะซึ่งคุณต้องการให้จัดเตรียมข้อมูลไว้
  • ชื่อแหล่งข้อมูล
การปรับปรุงความสามารถในการใช้งาน Designer -- ตัวเลือกเฉพาะใหม่ ได้ถูกเพิ่มให้กับค่าคุณสมบัติที่กำหนดให้กับวิธีใช้เมื่อทำงานใน พาเนลคุณสมบัติทั้งหมด เอดิเตอร์คุณสมบัติเฉพาะต่อไปนี้ ถูกเพิ่มไว้เพื่อปรับปรุงความสามารถในการใช้งานในคอนโทรลไลบรารีส่วนขยาย (โปรดดูส่วนที่สอดคล้องกันในหัวข้อนี้):
  • ตัวเลือกแฟล็กบิต
  • ตัวเลือกสกุลเงิน
  • ตัวเลือกแบบฟอร์ม
  • ตัวเลือกนิพจน์ปกติ
  • ตัวเลือกชื่อตัวแปร
  • ตัวเลือกมุมมองและโฟลเดอร์
  • ตัวเลือกมุมมอง
  • ตัวเลือก ID คอนโทรล XPage
คุณสามารถนำเอดิเตอร์เหล่านี้กลับมาใช้ได้ภายในนิยามคุณสมบัติ คอนโทรลแบบกำหนดเองตามต้องการ
การเปลี่ยนและการเพิ่มเนวิเกเตอร์แอ็พพลิเคชัน -- ไอเท็มใหม่ได้ถูกเพิ่มให้กับ เนวิเกเตอร์แอ็พพลิเคชัน ส่วนของคุณสมบัติแอ็พพลิเคชันที่เป็นรูปแบบได้ถูกเปลี่ยนชื่อเป็น ส่วนของคอนฟิกูเรชันแอ็พพลิเคชัน ส่วนนี้ช่วยคุณ แก้ไขสิทธิ์ในการเข้าถึงกลุ่มของอิลิเมนต์แอ็พพลิเคชันต่อไปนี้:
  • คุณสมบัติแอ็พพลิเคชัน - อิลิเมนต์นี้ช่วยคุณแก้ไขสิทธิ์ในการเข้าถึง คุณสมบัติระดับแอ็พพลิเคชันแบบคลาสสิค
  • คุณสมบัติ Xsp - ไฟล์นี้มีคอลเล็กชันของพารามิเตอร์กรอบงาน XPages, ที่รู้จักกันว่าคือ xsp.properties ซึ่งถูกใช้บนแอ็พพลิเคชัน หรือระดับเซิร์ฟเวอร์เพื่อตั้งค่าและควบคุมค่าติดตั้งในแอ็พพลิเคชัน XPages ของคุณ ทุกๆ แอ็พพลิเคชัน XPages NSF มีไฟล์ xsp.properties
  • Faces-config - ไฟล์ faces-config.xml คือไฟล์คอนฟิกูเรชันหลัก ในแอ็พพลิเคชัน JSF โดยทั่วไปแล้ว ไฟล์จะแสดงรีซอร์สบีน และกฎการนำทางเพจ ซึ่งวางอยู่ในโฟลเดอร์ WEB-INF ของแอ็พพลิเคชัน
    หมายเหตุ: Faces-config ถูกซ่อนอยู่ในเปอร์สเปคทีฟทั้งหมด ยกเว้นสำหรับเปอร์สเปคทีฟ XPages
คุณสามารถซ่อนหรือแสดงไอเท็มเหล่านี้ใดๆ ผ่าน การกำหนดค่าตามความชอบของเนวิเกเตอร์

ฟังก์ชันการทำงานแอ็พพลิเคชันไม่อยู่ในชุดการทำงาน -ผู้ใช้ Domino Designer ใช้ชุดการทำงานเพื่อกรองเนื้อหาของ มุมมอง Applications Navigator ชุดการทำงานช่วยให้คุณจัดกลุ่มแอ็พพลิเคชัน ลงในแค็ตตาล็อก ซึ่งทำให้คุณดูเฉพาะแอ็พพลิเคชันใน ชุดการทำงานเฉพาะ หรือหลายชุดการทำงานในครั้งเดียว วิธีการนี้ทำให้ คุณจัดระเบียบ และล้างข้อมูล Applications Navigator ดังนั้นคุณจึงสามารถโฟกัส/ดู ชุดย่อยของแอ็พพลิเคชันซึ่งคุณมีใน Applications Navigator แต่ ปัญหาในพื้นที่นี้ที่เกิดขึ้นยังคงเป็น เรื่องยากในการกำหนดว่าแอ็พพลิเคชันใดที่ ไม่ อยู่ใน ชุดการทำงาน

ฟังก์ชันใหม่ที่เพิ่มทำให้คุณ ดูแอ็พพลิเคชันทั้งหมดใน Domino Designer ซึ่งไม่ได้ถูกจัดเก็บ ในชุดการทำงาน ซึ่งจะคล้ายคลึงกับชุดการทำงาน Other Projects ซึ่งมีอยู่ในมุมมอง Java Package Explorer คุณสามารถ ค้นหาฟังก์ชันนี้ในอินเทอร์เฟส Designer ในเมนูดรอบดาวน์ ของแถบเครื่องมือชุดการทำงานตัวนำทางแอ็พพลิเคชันโฮมเพจ Domino Designer สองตำแหน่ง
  • โฮมเพจ Domino Designer
  • เมนูดรอบดาวน์ของแถบเครื่องมือชุดการทำงานตัวนำทาง

บนโฮมเพจ Domino Designer จะตรวจสอบว่าแอ็พพลิเคชันทั้งหมด ที่อยู่ภายใน Applications Navigator อยู่ ภายในชุดการทำงานหรือไม่ หากพบว่ามีหนึ่งแอ็พพลิเคชัน หรือมากกว่าไม่อยู่ ภายในหนึ่งชุดการทำงานหรือมากกว่า Designer จะรีโหลด โฮมเพจ ในระหว่างกระบวนการนั้น จะมีการเพิ่มไอเท็มรายการ Applications Not in a Working Set ใหม่ในโฮมเพจ

จาก Applications Navigator เมื่อคุณคลิกบนปุ่มเมนู Domino Designer จะระบุว่าแอ็พพลิเคชันใดที่ไม่อยู่ในชุด การทำงาน หากระบุว่ามีหนึ่งแอ็พพลิเคชันหรือมากกว่าที่ไม่อยู่ ไอเท็มรายการ Applications Not in a Working Set ที่เพิ่มใหม่จะถูกเปิดใช้งาน ในทางกลับกัน รายการเมนูเดียวกันจะถูกปิดใช้งานหากแอ็พพลิเคชันถูกจัดเรียง ในชุดการทำงาน หรือหากไม่มีชุดการทำงาน (ในกรณีที่แอ็พพลิเคชัน ทั้งหมดไม่อยู่ในชุดการทำงาน)

เมื่อคุณลักษณะ Applications Not in a Working Set ถูกเปิดใช้งาน Applications Navigator จะแสดงเฉพาะแอ็พพลิเคชันซึ่งปัจจุบันไม่อยู่ใน ชุดการทำงาน แถบหัวเรื่องของ Applications Navigator จะเปลี่ยนเพื่อไปเพื่อบอกว่า Other และ ทูลทิปจะอ่าน Applications Not in a Working Set

คุณ สามารถเพิ่มแอ็พพลิเคชันซึ่งปัจจุบันไม่อยู่ใน ชุดการทำงานไปยังชุดการทำงาน หากเป็นกรณีที่แอ็พพลิเคชันทั้งหมด ไม่อยู่ในชุดการทำงานที่ถูกเพิ่มเข้าไปในชุดการทำงาน ขณะ แอ็พพลิเคชันไม่อยู่ในชุดการทำงาน ถูกเปิดใช้งาน Applications Navigator จะแสดงค่าว่าง และ Home Page จะถูกโหลดใหม่ อย่างไรก็ตามในขณะนี้ รายการแอ็พพลิเคชันไม่ อยู่ในชุดการทำงาน จะไม่สามารถมองเห็น และไอเท็มเมนู Applications Not in a Working Set ในเมนู Applications Navigator จะถูกตรวจสอบ แต่จะถูกปิดใช้งาน

XPages

ในพื้นที่ของ XPages, การเพิ่มหรือการเปลี่ยนแปลงต่อไปนี้ได้ถูกทำไว้

ไลบรารีส่วนขยาย XPages -- ไลบรารีส่วนขยาย XPages จัดเตรียมคอนโทรลเพิ่มเติมที่ พร้อมใช้งาน คอนโทรลประกอบด้วยคอนโทรลคอนเทนเนอร์ใหม่ (เช่น โครงร่างแอ็พพลิเคชัน, มุมมองข้อมูล และอื่นๆ), ไดอะล็อกที่ปรับปรุงแล้ว, ตัวเลือก, แบบฟอร์มการเข้าแทนที่, คอมโพเนนต์ Dojo, เนื้อหาแบบไดนามิก, และอื่นๆ คอนโทรล ยังสนับสนุนการเพิ่มประสิทธิภาพให้กับเท็มเพลต Domino®

คอนโทรล ที่พร้อมใช้งานในไลบรารีส่วนขยายใหม่ครอบคลุมถึง พื้นที่การทำงานต่อไปนี้:
  • การเข้าถึงข้อมูล - เปิดเผยเซอร์วิสการเข้าถึงข้อมูล
  • แบบฟอร์ม Dojo - คอมโพเนนต์ที่ล้อเลียนจากชุดเครื่องมือ Dojo
  • โครงร่าง Dojo - คอมโพเนนต์ที่ล้อเลียนจากชุดเครื่องมือ Dojo
  • ไลบรารีส่วนขยาย - ขยายความสามารถของคอนโทรลแบบคอร์ของ Designer
  • iNotes - สนับสนุนมุมมอง, รายการ, และที่เก็บบางส่วน โมบายล์ - สนับสนุนแอ็พพลิเคชันโมบายล์
ไลบรารีส่วนขยาย XPages ประกอบด้วยคุณลักษณะ ที่ไฮไลต์ต่อไปนี้:
  • คอนโทรลโมบายล์ - ชุดของคอนโทรลใหม่นี้จัดเตรียมส่วนสนับสนุน สำหรับการสร้างแอ็พพลิเคชันสำหรับอุปกรณ์โมบายล์ซึ่งประกอบด้วยคุณลักษณะที่ไฮไลต์ ต่อไปนี้:
    • ลักษณะที่อยู่นอกกรอบสำหรับ iPhone และ Android
    • ความสามารถในการจัดเตรียมลักษณะแบบกำหนดเอง
    • คอนโทรลมุมมองที่ต้องการแสดงมุมมอง Domino
    • เอกสารที่สามารถสร้างการแสดงผลได้แบบง่ายๆ ได้โดยผ่านคอนโทรลแบบฟอร์มและ จัดการอยู่ในรูปของแอ็พพลิเคชันเดสก์ท็อป
    • คอนโทรลส่วนหัว, เครงร่าง และแถบแท็บ
    • คอนโทรลแอ็พพลิเคชันเพจเดี่ยวที่ต้องการเปลี่ยนเพจโมบายล์ โดยไม่มีการโหลดแอ็พพลิเคชันทั้งหมด
    คอนโทรลเหล่านี้ได้ถูกนำไปใช้งานเป็นคอนโทรลไลบรารี เพื่อให้สามารถใช้ได้ในแอ็พพลิเคชันแบบกำหนดเองโดยไม่มีการคัดลอกและ วางอิลิเมนต์การออกแบบ
  • เครื่องมือใหม่สำหรับคอนโทรลไลบรารี - ปลั๊กอินใหม่จัดเตรียมเวอร์ชวลไลเซชัน Domino Designer ระดับต้น สำหรับคอนโทรลไลบรารีส่วนขยายทั้งหมด, เช่นเดียวกับเวอร์ชวลไลเซชันที่พัฒนาแล้ว สำหรับคอนโทรลที่มีความซับซ้อนมากขึ้น เช่น คอนโทรลโครงร่างแอ็พพลิเคชัน การพัฒนาอื่นๆ ประกอบด้วยเอดิเตอร์เฉพาะใหม่ที่ช่วยกำหนดค่าคุณสมบัติ เมื่อทำงานในพาเนลคุณสมบัติทั้งหมดและพาเนลการออกแบบใหม่ ที่ช่วยด้วยคอนโทรลมุมมองข้อมูลและคอนโทรลแบบไดนามิก
  • ความสามารถในการเข้าถึงและส่วนสนับสนุนโลคัลไลเซชันที่พัฒนาแล้ว - เวอร์ชันก่อนหน้านี้ ของคอนโทรลบางส่วนและชนิดที่มีความซับซ้อนในไลบรารีส่วนขยาย XPages ไม่ได้ถูกเรียกร้องด้วยความสามารถในการเข้าถึงและโลคัลไลเซชัน มาตรฐานทั้งหมด ตัวอย่างเช่น, การใช้แอ็ตทริบิวต์ 'title' เป็นเลเบลคอนโทรล แทนแท็กเชิงอธิบายสำหรับเทคโนโลยีให้ความช่วยเหลือ (เช่น เครื่องอ่านหน้าจอ, เป็นต้น) ปัญหาที่เหมือนกับสิ่งนี้และปัญหาอื่นๆ ได้ถูกแสดงอยู่ในรีลีสนี้
  • โปรแกรมฟิกซ์และการปรับปรุงเพิ่มเติมเล็กน้อย - โปรแกรมฟิกซ์เพิ่มเติมเล็กน้อย จะถูกใช้กับรันไทม์ คำอธิบายถึงคุณสมบัติคอนโทรลส่วนใหญ่ และเครื่องมือให้คำแนะนำได้ถูกอัพเดตแล้ว

สำหรับข้อมูลเพิ่มเติมเกี่ยวกับคุณลักษณะนี้ โปรดดูที่ส่วน การเพิ่ม คอนโทรลจาก XPages Extension Library ของคู่มือการใช้งาน นี้ สำหรับข้อมูลเพิ่มเติม และเอกสารอ้างอิงเกี่ยวกับการใช้ คอนโทรล Extension Library สามารถดูได้ที่เอกสาร Domino Designer XPages Extension Library ที่พบในส่วนเอกสารผลิตภัณฑ์ของ Notes และวิกิ Domino Application Development ที่ http://www-10.lotus.com/ldd/ddwiki.nsf

เท็มเพลตแอ็พพลิเคชันที่อัพเดต -- รีลีสนี้จัดเตรียมเวอร์ชันที่อัพเดตแล้วของ Notes/Domino Discussion และเท็มเพลต TeamRoom ที่ได้ถูกขยายเพิ่มเพื่อใช้คุณลักษณะใหม่ จากรีลีสล่าสุด (discussion8xl.ntf และ teamrm8xl.ntf) เท็มเพลตเหล่านี้ สามารถใช้เพื่อสร้างแอ็พพลิเคชัน XPages ที่จะรันอยู่บนเว็บ, ไคลเอ็นต์ Notes, หรือบนอุปกรณ์โมบายล์ คุณได้รับการสนับสนุนโดยเฉพาะอย่างยิ่งลองใช้ แอ็พพลิเคชันโมบายล์ด้วยเท็มเพลตเหล่านี้คือการอ้างถึงตัวอย่างที่ดี สำหรับการเริ่มต้นทำงานกับการพัฒนาโมบายล์ XPages เท็มเพลต Discussion และ TeamRoom สำหรับรีลีสนี้เป็นภาษาอังกฤษ เท่านั้น

คอนโทรลโครงร่างแอ็พพลิเคชัน -- หนึ่งในไฮไลต์ของ ไลบรารีส่วนขยายคือคอนโทรลโครงร่างแอ็พพลิเคชัน (applicationLayout/com.ibm.xsp.extlib.component.layout.UIApplicationLayout) คอนโทรลนี้คืออ็อบเจ็กต์สำหรับการสร้างการแสดงผลกรอบแอ็พพลิเคชันหลัก และโครงร่างของแอ็พพลิเคชัน XPages

คอนโทรลนี้ถูกใช้ได้อย่างมีประสิทธิผล เมื่อวางอยู่ในคอนโทรลแบบกำหนดเอง, โดยที่คุณสามารถกำหนดคอนฟิก โครงร่างเพียงครั้งเดียวและนำคอนโทรลแบบกำหนดเองกลับมาใช้บน XPages จำนวนมาก คุณสามารถตั้งค่าโครงร่างได้มากสุดสามพื้นที่สำหรับหัวเรื่อง และลิงก์การนำทาง, พื้นที่เนื้อหาที่มีมากเท่าสามคอลัมน์, และพื้นที่ส่วนท้าย สองพื้นที่

เมื่อคุณได้ลากคอนโทรลไปยัง XPage และได้ทำการติดตั้งเริ่มต้นแล้ว, คุณสามารถใช้พาเนลคุณสมบัติของคอนโทรล เพื่อตั้งค่าอ็อพชันเพิ่มเติมสำหรับคุณสมบัติคอนโทรลโครงร่าง แอ็พพลิเคชันของคุณ ซึ่งรวมถึง:
  • พาเนลคุณสมบัติพื้นฐาน - อนุญาตให้คุณตั้งค่าชื่อคอนโทรล, คอนฟิกูเรชัน, และความสามารถในการมองเห็น (ด้วยค่าที่คำนวณแล้ว) เมื่อคอนโทรลอยู่ใน คอนโทรลแบบกำหนดเอง, พาเนลนี้ยังอนุญาตให้คุณเพิ่ม facets ให้กับคอลัมน์ใดๆ ในสามคอลัมน์หลัก, เพื่ออนุญาตให้ดร็อปคอนโทรลลงใน facets เหล่านี้เมื่อใช้ คอนโทรลแบบกำหนดเอง
  • พาเนลคุณสมบัติแบนเนอร์ - อนุญาตให้คุณตั้งค่าอ็อพชันแบนเนอร์โครงร่างทั้งหมด และตั้งค่าสำหรับพื้นที่แบนเนอร์ ตัวอย่างเช่น, ตราสัญลักษณ์ (ฟิลด์ข้อความ ที่มีตัวเลือกอิมเมจ), ลิงก์โกลบอล, เป็นต้น).
  • แบนเนอร์ - พาเนลคุณสมบัติลิงก์แอ็พพลิเคชัน - พบเป็นส่วนหนึ่งของ พาเนลคุณสมบัติแบนเนอร์, พาเนลนี้อนุญาตให้คุณเพิ่มลิงก์แอ็พพลิเคชัน และตั้งค่าคุณสมบัติลิงก์
  • แบนเนอร์ - พาเนลคุณสมบัติลิงก์ยูทิลิตี - พบเป็นส่วนหนึ่งของพาเนล คุณสมบัติแบนเนอร์, พาเนลนี้อนุญาตให้คุณเพิ่มลิงก์ในแบนเนอร์สำหรับยูทิลิตี เช่น วิธีใช้และล็อกอิน และตั้งค่าคุณสมบัติที่เกี่ยวข้อง
  • พาเนลคุณสมบัติแถบหัวเรื่อง - อนุญาตให้คุณตั้งค่าแถบหัวเรื่อง, ข้อความหัวเรื่อง, ตั้งค่าอ็อพชันหัวเรื่อง, เพิ่มลิงก์ (ในลำดับแบบกำหนดเอง), และเพิ่มแท็บเพิ่มเติม (ด้วยแท็บชายด์) ไปยังโครงร่างแอ็พพลิเคชัน
  • แถบหัวเรื่อง - พาเนลคุณสมบัติการค้นหา - อนุญาตให้คุณเพิ่มคอนโทรลการค้นหา ไปยังแถบหัวเรื่องและตั้งค่า URL การค้นหาที่เกี่ยวข้องทั้งหมดและคุณสมบัติ พื้นที่ ที่สามารถแก้ไขได้ (facet) ยังถูกจัดเตรียมไว้เป็นวิธีสำรองในการระบุ UI การค้นหา ถ้าใช้, facet จะลบล้างคอนโทรล ที่ระบุไว้บนพาเนลนี้
  • พาเนลคุณสมบัติแถบตำแหน่ง - อนุญาตให้คุณตั้งค่าอ็อพชันเพื่อแสดง พื้นที่แถบตำแหน่งสำหรับหัวเรื่องสำรอง คุณยังสามารถตั้งค่าลิงก์ให้มีลักษณะเป็น ปุ่มหรือปุ่มที่มีดร็อปดาวน์ ซึ่งสามารถเป็นปุ่มที่มี หรือไม่มีอิมเมจและเลเบล
  • พาเนลคุณสมบัติส่วนท้าย - กำหนดอ็อพชันให้คุณเพื่อแสดงส่วนท้าย ภายใต้พื้นที่เนื้อหาแอ็พพลิเคชันและใช้สำหรับลิงก์หรือข้อความ เมื่อต้องการแสดง เพียงข้อความในส่วนท้าย, คุณควรระบุเพียงข้อความเลเบล เป็นคุณสมบัติและไม่ควรใช้ HREF (ลิงก์)
  • พาเนลคุณสมบัติทางกฎหมาย - กำหนดอ็อพชันให้คุณเพื่อระบุพื้นที่ ในแอ็พพลิเคชันของคุณที่ต้องการแสดงข้อความทางกฎหมายเช่นเดียวกับการตั้งค่า ตราสัญลักษณ์ทั้งหมดและคุณสมบัติข้อความ (ด้วยค่าที่คำนวณแล้วหากต้องการ)

สำหรับข้อมูลโดยสมบูรณ์เกี่ยวกับวิธีใช้คอนโทรลนี้, โปรดอ้างถึงส่วนของการอ้างอิงคอนโทรลที่พบในคู่มือนี้

คอนโทรล เนื้อหาแบบไดนามิก -- ไฮไลต์อื่นๆ ของไลบรารีส่วนขยายคือ คอนโทรลเนื้อหาแบบไดนามิก (dynamicContent / com.ibm.xsp.extlib.component.dynamiccontent.UIDynamicContent) คอนโทรลนี้ที่อนุญาตให้คุณใช้ประกอบด้วยเพจแบบไดนามิกหรือส่วนของเพจ ในแอ็พพลิเคชัน XPage ของคุณ คอนโทรลอนุญาตให้คุณสร้างและ สร้างการแสดงผลคอนโทรลชายด์แบบมีเงื่อนไข, เปิดใช้งานเพื่อแสดงและซ่อนส่วนของ เพจ คอนโทรลนี้ได้ถูกจัดเตรียมไว้พร้อมกับเครื่องมือและเวอร์ชวลไลเซชันที่สมบูรณ์ เครื่องมือสำหรับคอนโทรลเนื้อหาแบบไดนามิกประกอบด้วยหนึ่งพาเนลคุณสมบัติ เนื้อหาแบบไดนามิก คุณสมบัติที่สามารถตั้งค่าได้จากพาเนลนี้ ประกอบด้วย:
  • ชื่อคอนโทรล
  • อ็อพชันที่ต้องการทำให้คอนโทรลสามารถมองเห็นได้ (เช็กบ็อกซ์ สามารถมองเห็นได้)
  • รายการดร็อปดาวน์ที่ต้องการเลือก facet ดีฟอลต์ เนื้อหาที่นิยามอยู่ใน facet ดีฟอลต์ถูกสร้างการแสดงผลหากไม่มีเงื่อนไขอื่นใดที่ตรงกัน
  • อ็อพชันที่ต้องการใช้การแฮช URL (เช็กบ็อกซ์)

เอดิเตอร์คุณสมบัติ XPages -- ส่วนติดต่อผู้ใช้เอดิเตอร์คุณสมบัติ XPages ได้ถูกเพิ่มเพื่อทำง่ายต่อการแก้ไขคุณสมบัติ XPages เมื่ออยู่ในมุมมองเนวิเกเตอร์ Eclipse

เมื่อต้องการแสดงมุมมอง เนวิเกเตอร์ Eclipse, ให้เลือก หน้าต่าง - แสดงมุมมอง Eclipse - เนวิเกเตอร์

เมื่อต้องการ เรียกทำงานเอดิเตอร์คุณสมบัติ XPages:
  • หาไฟล์คุณสมบัติ XPages ที่ชื่อ xsp.properties ในมุมมองเนวิเกเตอร์ Eclipse พาธควรเป็นบางสิ่งที่คล้ายกับ: Application-name.nsf/WebContent/WEB-INF/xsp.properties
  • คลิกขวาที่ xsp.properties และเลือกเปิดด้วย - เอดิเตอร์คุณสมบัติ XPages พาเนลเอดิเตอร์คุณสมบัติ XPages เปิดขึ้นด้วยแท็บ 4 แท็บ ที่พร้อมสำหรับการตั้งค่าคุณสมบัติ XPages แท็บคุณสมบัติเหล่านั้นคือ ทั่วไป, การมีอยู่, การสร้างเพจ, และแหล่งที่มา
แท็บทั่วไปของคุณสมบัติ XPages อนุญาตให้คุณตั้งค่า คุณสมบัติในพื้นที่ทั่วไปต่อไปนี้:
  • ธีมดีฟอลต์ - อนุญาตให้คุณตั้งค่าคุณสมบัติธีมของแอ็พพลิเคชัน คุณ ยังสามารถตั้งค่าตัวเลือกธีมที่ลบล้างค่าติดตั้งได้ขึ้นอยู่กับว่า แอ็พพลิเคชันที่กำลังถูกแสดงในไคลเอ็นต์ Notes หรือบนเว็บ
  • ลักษณะการทำงานของหน้าต่างสำหรับการนำทางและลิงก์ - อนุญาตให้คุณระบุ ลักษณะการทำงานของหน้าต่างและลิงก์ในแอ็พพลิเคชันของคุณได้เช่นเดียวกับลักษณะการทำงานของลิงก์ เมื่อไม่ได้ระบุไว้บนลิงก์
  • การจัดการกับข้อผิดพลาด - อนุญาตให้คุณระบุอ็อพชันการจัดการกับข้อผิดพลาด (เพจข้อผิดพลาด) ถ้าคุณเลือกให้แสดงเพจข้อผิดพลาดรันไทม์ XPage, คุณสามารถมีเพจข้อผิดพลาดดีฟอลต์ที่แสดงโดยเลเยอร์ XSP ซึ่งมีประโยชน์ สำหรับการจัดเตรียมข้อมูลข้อผิดพลาดพิเศษ
  • รีลีสต่ำสุดที่สนับสนุน - อนุญาตให้คุณระบุรีลีสต่ำสุดของ Notes/Domino ที่สนับสนุนสำหรับแอ็พพลิเคชันที่คอมไพล์แล้วของคุณเพื่อรัน และอนุญาตให้ตั้งค่าข้อกำหนดการสนับสนุนลักษณะ
  • หมดเวลาใช้งาน - อนุญาตให้คุณระบุแอ็พพลิเคชัน, เซสชัน, และ ช่วงหมดเวลาการอัพเดตเป็นบางส่วน สำหรับแอ็พพลิเคชันหรือเซสชัน, คุณสามารถ ตั้งค่าช่วงระยะเวลาในหน่วยนาทีเมื่อต้องถอนออกจากหน่วยความจำ หลังไม่มีกิจกรรม ช่วงเวลาดีฟอลต์คือ 30 นาทียกเว้นว่าได้ ระบุไว้เป็นอย่างอื่น สำหรับอัพเดตเป็นบางส่วน, คุณสามารถตั้งค่าช่วงหมดเวลาใช้งาน ในหน่วยวินาที ค่าดีฟอลต์คือ 20 วินาที การรีเฟรชเพิ่มเติม และอ็อพชันที่มีอยู่ยังสามารถตั้งค่าได้
  • Dojo - อนุญาตให้คุณระบุเวอร์ชัน Dojo เพื่อใช้ในแอ็พพลิเคชันของคุณ พร้อมกับระบุพารามิเตอร์ให้กับแอ็ตทริบิวต์ djConfig ของ Dojo ตัวอย่างเช่น, คุณสามารถระบุ isDebug=true เพื่ออนุญาตให้คุณสลับไปเป็นโหมดดีบักหากจำเป็น
  • เขตเวลา - อนุญาตให้คุณระบุข้อมูลเขตเวลา ถ้าคุณไม่ได้ใช้, เขตเวลาของเซิร์ฟเวอร์จะถูกนำมาใช้
  • อ็อพชันอัพโหลดไฟล์ - อนุญาตให้คุณระบุขนาดและตำแหน่งอัพโหลด ไฟล์แอ็พพลิเคชัน ซึ่งประกอบด้วยขนาดสูงสุดของไฟล์ที่ต้องถูกอัพโหลด ให้กับแอ็พพลิเคชันเช่นเดียวกับตำแหน่งไดเร็กทอรีเพื่อ เก็บสิ่งที่แนบที่อัพโหลดไว้ชั่วคราว
แท็บคุณสมบัติผลการทำงาน (การมีอยู่) อนุญาตให้คุณตั้งค่าคุณสมบัติในพื้นที่ผลการทำงานของแอ็พพลิเคชันต่อไปนี้:
  • อ็อพชันการมีอยู่ - อนุญาตให้คุณตั้งค่าโหมดการมีอยู่ของเพจของเซิร์ฟเวอร์ (JSF) และอ็อพชันที่เหมือนกับค่าติดตั้งจำนวนเพจที่มีอยู่ เพื่อปรับผลการทำงานของแอ็พพลิเคชันโดยเปรียบเทียบกับหน่วยความจำที่มีอยู่
  • ตำแหน่งชั่วคราว - อนุญาตให้คุณระบุตำแหน่งสำหรับหน่วยเก็บของสิ่งที่แนบ ชั่วคราว, ไฟล์ที่อัพโหลด, และเพจ JSF
  • อ็อพชัน - อนุญาตให้คุณระบุค่าติดตั้งผลการทำงานเพิ่มเติม สำหรับสิ่งที่คล้ายกับการรีเฟรชเพจ, ขนาดแคช, การหมดอายุของรีซอร์ส, และ JavaScript และอ็อพชันรีซอร์ส CSS
แท็บคุณสมบัติการสร้างเพจ (การสร้างเพจ) อนุญาตให้คุณตั้งค่าคุณสมบัติในพื้นที่การสร้างเพจแอ็พพลิเคชัน ต่อไปนี้:
  • การสร้าง HTML - อนุญาตให้คุณระบุค่าติดตั้งการสร้าง HTML เหมือนกับการตรวจสอบความถูกต้องของ HTML ฝั่งไคลเอ็นต์, ค่าติดตั้งการบีบอัด, การเข้ารหัส (ชุดอักขระ), และ HTML doctype พร้อมกับอ็อพชันอื่น
  • อ็อพชัน Rich text- อนุญาตให้คุณระบุวิธีการบันทึกลิงก์ในเอกสาร Domino - ใน Notes หรือรูปแบบเว็บ
  • การกรองเนื้อหาที่แอ็คทีฟ - อนุญาตให้คุณระบุตัวกรองเนื้อหาที่แอ็คทีฟ ซึ่งประกอบด้วยการแสดงผลและการบันทึกชนิดการกรองพร้อมกับระบุไฟล์ ACF CONFIG ที่ต้องการใช้
  • Active content filtering (ACF) cis ถูกใช้เพื่อถอนเนื้อหาที่แอ็คทีฟ ซึ่งประสงค์ร้ายจากเนื้อหาแอ็พพลิเคชันที่ถูกแสดง ในเบราว์เซอร์

ท้ายสุด, แท็บแหล่งที่มาอนุญาตให้คุณแสดง และแก้ไขซอร์สไฟล์คุณสมบัติ XPages จริงในเท็กซ์เอดิเตอร์ โดยไม่มีการช่วยเหลือของส่วนติดต่อผู้ใช้เอดิเตอร์คุณสมบัติ XPages

วิธีใช้แบบลอย/mouse-over ถูกจัดเตรียมไว้เพื่อกำหนดความช่วยเหลือเพิ่มเติมเกี่ยวกับอ็อพชันต่างๆ และคุณสมบัติที่คุณสามารถตั้งค่าบนแท็บเหล่านี้ได้

ปฏิทิน และตารางเวลา (C&S) คลาส Java แบล็คเอ็น – เฟรมเวิร์ก และชุดของเมธอดสามารถใช้ได้สำหรับ Java API แสดงถึงฟังก์ชันปฏิทิน และตารางเวลา Domino เหล่านี้ได้จัดเตรียมความสามารถในการสร้าง, อ่าน, อัพเดต, และถอนข้อมูลปฏิทินใน mailfile ส่วนบุคคลโดยใช้รูปแบบข้อมูล iCalendar (RFC 5545) ที่เป็นมาตรฐาน ซึ่งอนุญาตให้ใช้แอ็คชันปฏิทิน บนรายการปฏิทินและหมายเหตุประกอบ (ยอมรับ, ปฏิเสธ, ยกเลิก, เป็นต้น) โปรดอ้างถึงส่วนถัดไปของหัวข้อนี้สำหรับรายละเอียดทั้งหมด

การสนับสนุน ภาษารันไทม์ -- รันไทม์ XPages ในรุ่นนี้สนับสนุน กลุ่มภาษา 1, 2 และ 3 เท็มเพลต Discussion และ TeamRoom จะเป็นภาษาอังกฤษเท่านั้น

ส่วนสนับสนุน เท็มเพลตภาษา -- เท็มเพลต Discussion และ TeamRoom เป็นภาษาอังกฤษเท่านั้น

เรียกใช้ตัวเลือกเพื่อ รันแอ็พพลิเคชัน XPages บนเซิร์ฟเวอร์โดยตรงบนเซิร์ฟเวอร์ Domino – เนื่องจากแอ็พพลิเคชัน XPages Notes รันใน เว็บคอนเทนเนอร์ Notes XPD แบบโลคัล คลาส XPages Java ทั้งหมด (XPages และคอนโทรลแบบกำหนดเอง) ต้องถูกคัดลอกข้ามเครือข่ายจาก รีโมตเซิร์ฟเวอร์ไปยังไคลเอ็นต์ Notes ที่จะประมวลผล ในทำนองเดียวกัน รีซอร์สของเพจทั้งหมด (CSS, JavaScript, GIFs, ฯลฯ) ต้องถูกเรียกจากเซิร์ฟเวอร์แบบรีโมต รวมถึงเอกสาร ข้อมูลจริง ยิ่งไปกว่านี้ หากแอ็พพลิเคชัน XPages ใช้โปรแกรมการออกแบบ Notes อื่นๆ (ตัวอย่างเช่น การใช้คุณลักษณะ computeWithForm) อิลีเมนต์การออกแบบ ขนาดใหญ่เช่น ฟอร์ม, ฟอร์มย่อย, ฟิลด์ที่แบ่งใช้ และอื่นๆ จะต้อง ถูกเรียกแบบรีโมตด้วยเช่นกัน บนเครือข่ายประสิทธิภาพสูง สิ่งนี้อาจทำให้ เกิดผลกระทบด้านประสิทธิภาพที่สำคัญ โดยเฉพาะหากแอ็พพลิเคชันของคุณถูกออกแบบมา สำหรับเว็บ และไม่เหมาะสำหรับไคลเอ็นต์ Notes

ตัวเลือกการเรียกDomino Designer ขณะนี้ช่วยให้คุณ เลี่ยงสถานการณ์นี้ ไคลเอ็นต์ Notes ที่เรียกใช้ตัวเลือกจะเรียกว่า รันแอ็พพลิเคชัน XPages บนเซิร์ฟเวอร์ โดยตรงบนเซิร์ฟเวอร์ Domino เมื่อตัวเลือกนี้ถูกเลือก และแอ็พพลิเคชันถูกเรียกใช้โดยผู้ใช้ Notes รันไทม์ XPages จะถูกร้องขอเพื่อรันแอ็พพลิเคชันบนเซิร์ฟเวอร์Domino บน HTTP ตัวเลือก นี้ทำให้คุณร้องขอแอ็พพลิเคชันแบบรีโมตเพื่อรันบนเซิร์ฟเวอร์ Domino HTTP - เช่นเดียวกับ ตัวเลือกสำหรับผู้ใช้เว็บ - และแสดงในคอนเทนเนอร์ Notes XPages ข้อดีของ ้วิธีการนี้คือธุรกรรมบนเครือข่ายจำนวนมากจะถูกตัดออกเพื่อปรับปรุง ประสิทธิภาพ

เพื่อให้ได้รับการร้องขอนี้ ต้องมีเงื่อนไข หลายอย่าง ก่อนอื่น คุณต้องมีการตั้งค่าบัญชี Notes HTTP บัญชีเหล่านี้สามารถ ตั้งค่าโดยตรงบนไคลเอ็นต์ Notes หรือแบบรีโมตบนเซิร์ฟเวอร์ Domino จากนั้นถูกจัดเตรียมในไคลเอ็นต์ Notes เมื่อต้องการสร้าง หรือดูบัญชี Notes ให้เลือกFile > Preferences > Accounts in Notes ในการพยายามรับการร้องขอใน แอ็พพลิเคชัน XPages บน Domino XPages จะทำซ้ำผ่านบัญชี Notes ทั้งหมด ที่กำหนดในการติดตั้งไคลเอ็นต์ Notes จนกว่าจะพบบัญชี HTTP ที่ตรงกับชื่อ ของเซิร์ฟเวอร์ที่แอ็พพลิเคชันติดตั้งอยู่ เมื่อเกณฑ์เหล่านี้ ตรงกัน URL XPages ของDomino จะถูกสร้าง และการร้องขอจะถูกส่งไปยังเซิร์ฟเวอร์ Domino และแอ็พพลิเคชันจากนั้นจะโหลด ในไคลเอ็นต์ Notes หาก ไม่พบบัญชีที่ตรงกัน หรือหากการร้องขอไปยังเซิร์ฟเวอร์ไม่สามารถ ให้บริการ (เช่น รายละเอียดบัญชีบางอย่างไม่ถูกต้อง) คุณจะได้รับ พร้อมต์เพื่อปิดหน้าต่างแอ็พพลิเคชัน หรือย้อนกลับไปรัน แอ็พพลิเคชันโดยใช้เว็บคอนเทนเนอร์ Notes แบบโลคัล

เฟรมเวิร์กบัญชี Notes และเบราว์เซอร์ XULRunner พื้นฐานจะส่งข้อมูลประจำตัว ผู้ใช้ไปยังเว็บเซิร์ฟเวอร์โดยอัตโนมัติสำหรับการพิสูจน์ตัวตน ดังนั้น ผู้ใช้ไม่ควรได้รับการร้องขอสำหรับการพิสูจน์ตัวตน หากคุณ ได้รับพร้อมต์สำหรับชื่อผู้ใช้ และรหัสผ่านแสดงว่าการกำหนดคอนฟิก Notes/Domino แบบรันไทม์มีการตั้งค่าที่ไม่ถูกต้อง (ตัวอย่างเช่น Domino SSO ที่กำหนดคอนฟิกไม่ถูกต้อง) อย่างไรก็ตาม คุณควร สามารถตรวจสอบการไม่ต้องพิสูจน์ตัวตนนี้ของ XPages โดยการป้อน URL ไปยังแอ็พพลิเคชันผ่านทางวิดเจ็ตที่อยู่เบราว์เซอร์ Notes บนแถบเครื่องมือ Notes

เมื่อ รันแอ็พพลิเคชันบนเซิร์ฟเวอร์ Domino ภายในไคลเอ็นต์ Notes ฟังก์ชัน แบบกำหนดเองทั้งหมดของ Notes ควรทำหน้าที่เช่นเดียวกับเมื่อรันในโหมด XPages ปกติ ตัวอย่างเช่น เมนูบริบทควรทำหน้าที่เหมือนกัน การบันทึกเอกสารที่มีคำหยาบ ฟังก์ชัน JavaScript ฝั่งไคลเอ็นต์ ฯลฯ) ข้อยกเว้นหนึ่งนั้นคือคอมโพสิตแอ็พพลิเคชัน จะไม่สามารถใช้ฟังก์ชันตัวแทนคุณสมบัติไคลเอ็นต์ เมื่อรันบนเซิร์ฟเวอร์

คุณสามารถข้ามการตั้งค่าตัวเลือกนี้ ใน Domino Designer โดยการตั้งค่า คุณลักษณะ NOTES.INI ดังนี้: XPagesRunRemoteAppsOnServer=1 การตั้งค่านี้จะถูกใช้กับแอ็พพลิเคชัน XPages ทั้งหมด ไม่ใช่ แต่ละแอ็พพลิเคชัน

ตัวตรวจสอบการสะกดจะถูกเพิ่มไปยัง CKEditor – ตัวตรวจสอบ การสะกดจะถูกเพิ่มไปยัง CKEditor ใน XPages ซึ่งจะสามารถใช้ได้ ทั้งในเซิร์ฟเวอร์ และไคลเอ็นต์

ความสามารถในการโปรแกรมและภาษา

ในพื้นที่ของ ความสามารถในการโปรแกรมและภาษา, การเพิ่มหรือการเปลี่ยนแปลงต่อไปนี้ ได้ถูกทำไว้:

Domino Data Services -- Domino® Data Service คือ REST API ที่เข้าถึง ฐานข้อมูลบนเซิร์ฟเวอร์ Domino ซึ่งเป็นส่วนหนึ่งของ Domino Access Services Domino Data Service รับคำร้องขอและส่งการตอบกลับโดยใช้โปรโตคอล HTTP และ HTTPS ที่มีเนื้อความในรูปแบบ JSON Domino Data Service อนุญาตให้คุณขอรับข้อมูล บนฐานข้อมูล, มุมมอง, โฟลเดอร์, และเอกสาร คุณสามารถอัพเดต, เพิ่ม, และลบเอกสารได้

สำหรับเอกสารอ้างอิง และข้อมูลที่สมบูรณ์เพิ่มเติม เกี่ยวกับการใช้ Data Services โปรดดูที่ข้อมูลที่พบ ในส่วนเอกสารผลิตภัณฑ์ของวิกิ Notes และการพัฒนาแอ็พพลิเคชัน Domino ที่ http://www-10.lotus.com/ldd/ddwiki.nsf

ปฏิทิน และตารางเวลา (C&S) คลาส Java แบล็กเอ็น – เฟรมเวิร์ก และชุดของเมธอดที่สามารถใช้ได้สำหรับ Java API แสดงถึงฟังก์ชันปฏิทิน และตารางเวลา Domino เหล่านี้ได้จัดเตรียมความสามารถในการสร้าง, อ่าน, อัพเดต, และถอนข้อมูลปฏิทินใน mailfile ส่วนบุคคลโดยใช้รูปแบบข้อมูล iCalendar (RFC 5545) ที่เป็นมาตรฐาน ซึ่งอนุญาตให้ใช้แอ็คชันปฏิทิน บนรายการปฏิทินและหมายเหตุประกอบ (ยอมรับ, ปฏิเสธ, ยกเลิก, เป็นต้น)

หมายเหตุ: iCalendar อนุญาตให้ดักจับและแลกเปลี่ยนข้อมูล ที่เก็บอยู่ภายในแอ็พพลิเคชันการทำปฏิทินและการกำหนดตาราง; เช่น Personal Information Manager (PIM) หรือผลิตภัณฑ์แอ็พพลิเคชัน Group-Scheduling รูปแบบ iCalendar เหมาะสมกับรูปแบบการแลกเปลี่ยน ระหว่างแอ็พพลิเคชันหรือระบบ รูปแบบถูกนิยามอยู่ในรูปของ ชนิดเนื้อหา MIME ซึ่งอนุญาตให้อ็อบเจ็กต์ที่ต้องถูกแลกเปลี่ยน ใช้การขนส่งต่างๆ, ซึ่งรวมถึงแต่ไม่จำกัดถึง SMTP, HTTP, ระบบไฟล์, โปรโตคอลการโต้ตอบแบบเดสก์ท็อป เช่น การใช้คลิปบอร์ดอ้างอิงหน่วยความจำ หรือการโต้ตอบแบบลาก/ปล่อย, การสื่อสารแบบอะซิงโครนัสแบบจุดต่อจุด, การขนส่งทางเครือข่ายที่เชื่อมต่อแล้ว, หรือแบบฟอร์มของการขนส่งที่ไม่มีการเชื่อมต่อบางอย่าง เช่น อินฟาเรด

วัตถุประสงค์ของคลาสและเมธอดเริ่มต้นเหล่านี้ คือการจัดเตรียมพื้นฐานสำหรับการสำรวจความสามารถในการพัฒนา และสำหรับการสร้างปฏิทินขนาดเล็ก, ปฏิทินแบบง่าย และกำหนดตารางแอ็พพลิเคชันต้นแบบ โดยไม่มีความต้องการในการตกแต่งใน ปฏิทินและการกำหนดตารางของ Notes ภายใน

บางส่วนของคลาสใหม่ (ที่มีเมธอด) ที่ เพิ่มจะมีดังต่อไปนี้:

Session.getCalendar

สร้าง อ็อบเจ็กต์ NotesCalendar จากอ็อบเจ็กต์ฐานข้อมูล ฐานข้อมูลไม่ได้ถูกตรวจสอบ ว่าเป็นฐานข้อมูล C&S ที่ถูกต้องจนกว่าจะถูกเข้าถึงจริง

lotus.domino.NotesCalendar getCalendar(lotus.domino.Database db)throws NotesException

NotesCalendar - มีเมธอดต่อไปนี้:
  • NotesCalendar.getEntry
  • NotesCalendar.createEntry
  • NotesCalendar.readRange

ข้อมูลต่อไปนี้จัดเตรียมรายละเอียดเพิ่มเติม สำหรับการใช้เมธอดเหล่านี้:

NotesCalendar.getEntry

ส่งคืน อ็อบเจ็กต์ NotesCalendarEntry ที่เชื่อมโยงกับ uid ที่ได้จัดเตรียมไว้ (ตัวระบุ iCal) ซึ่งไม่ได้ทำการตรวจสอบความถูกต้อง เพื่อให้แน่ใจว่ารายการนั้นมีอยู่จริง

NotesCalendarEntry getEntry(String uid) throws NotesException

NotesCalendar.createEntry

ส่งคืน NotesCalendarEntry จาก iCal ที่จัดเตรียมไว้เมื่อกำหนดสตริง iCalendar (iCal) ถูกจัดรูปแบบไว้อ้างอิงตาม RFC 5545

NotesCalendarEntry createEntry(String iCal) throws NotesException

NotesCalendar.readRange

ส่งสตริง iCalendar ที่แทนค่ารายการปฏิทินทั้งหมดที่ปรากฏขึ้นบนปฏิทิน Notes ของคุณและ เริ่มต้นระหว่างเวลาเริ่มต้นและเวลาสิ้นสุดที่จัดเตรียม สำหรับรายการที่เกิดขึ้นซ้ำ, แต่ละอินสแตนซ์ภายในช่วงคือเอาต์พุตที่แยกจากกัน สิ่งนี้แทนค่า ข้อมูลสรุปสำหรับแต่ละรายการ, แต่ในแต่ละรายการจะมี UID ที่สามารถใช้เพื่อขอรับอ็อบเจ็กต์ NotesCalendarEntry ด้วยเมธอด getEntry ตัวเรียกรับผิดชอบสำหรับการวิเคราะห์คำเอาต์พุต

String readRange(DateTime start, DateTime end) throws NotesException

NotesCalendarEntry
  • NotesCalendarEntry.read
  • NotesCalendarEntry.update
  • NotesCalendarEntry.remove

ข้อมูลต่อไปนี้จัดเตรียมรายละเอียดเพิ่มเติม สำหรับการใช้เมธอดเหล่านี้:

NotesCalendarEntry.read

ส่งคืน สตริง iCalendar ที่แทนค่ารายการปฏิทินนี้ ถ้าระบุ recurID ไว้สำหรับรายการที่เกิดซ้ำ, ให้ส่งคืนสตริง iCalendar สำหรับเหตุการณ์ที่เกิดขึ้นนั้นๆ recurID ควรเป็นสตริงที่แทนค่า ข้อมูล/เวลาที่อินสแตนซ์ถูกจัดทำตาราง, ในรูปแบบที่คล้ายกับ iCalendar RECURRENCE-ID ตัวอย่างเช่น: 19960120T120000Z โปรดดูที่ RFC 5545, ส่วน 3.8.4.4

String read() throws NotesException

String read(String recurID) throws NotesException

NotesCalendarEntry.update

กำหนดสตริง iCalendar (iCal) ในรูปแบบที่เหมาะสมอ้างอิงตาม RFC 5545, อัพเดตรายการปฏิทินนี้โดยส่งผ่านใน iCalendar สำหรับการประชุมที่เกิดขึ้นซ้ำ, สิ่งนี้ได้รับการสนับสนุนในปัจจุบันสำหรับอินสแตนซ์เดี่ยว และอินพุต iCalendar ต้องมี VEVENT เดี่ยวที่ระบุ อินสแตนซ์ที่เหมาะสมด้วย RECURRENCE-ID, ซึ่งนิยามใน RFC 5545

ถ้าไม่ได้ ระบุข้อคิดเห็นไว้, สิ่งนี้จะไม่ส่งการแจ้งให้ทราบแม้ว่า สิ่งนี้คือการประชุมก็ตาม ถ้าสิ่งนี้คือการประชุมที่เจ้าของ mailfile คือผู้จัดการ, การแจ้งให้ทราบจะถูกส่งตามความเหมาะสม, ซึ่งรวมถึง ข้อคิดเห็นที่ได้จัดเตรียมไว้ ในปัจจุบัน, ข้อคิดเห็นที่ได้จัดเตรียมไว้ใดๆ ถูกละเว้น

void update(String iCal) throws NotesException

void update(String iCal, String comments) throws NotesException

NotesCalendarEntry.remove

ถอน (ลบ) รายการปฏิทินออกจาก mailfile ถ้าระบุ recurID ไว้, เฉพาะเหตุการณ์นั้นเท่านั้นที่จะถูกถอนออก ถ้ารายการปฏิทินนี้ คือการประชุมที่จัดตารางไว้, รายการนั้นจะถูกยกเลิกหรือปฏิเสธ, และ หมายเหตุที่เหมาะสมจะถูกส่งไปยังผู้จัดการหรือผู้เข้าร่วม

void remove() throws NotesException

void remove(recurID) throws NotesException

สำหรับข้อมูลที่สมบูรณ์เกี่ยวกับ เมธอด และคลาสเพิ่มเติมเหล่านี้ โปรดดูที่ส่วน Domino ของกาาอ้างอิง XPages ใน Domino Designer

ดีบักเกอร์ JavaScript ฝั่งเซิร์ฟเวอร์ – ดีบักเกอร์ JavaScript (SSJS) ฝั่งเซิร์ฟเวอร์จะสามารถใช้เพื่อดีบักบนเซิร์ฟเวอร์ ตัวอย่างของ Designer หรือบนเซิร์ฟเวอร์ Domino
หมายเหตุ: คีย์เวิร์ด debugger ที่ใช้ในคุณลักษณะนี้จะไม่สามารถทำงานร่วมกับเวอร์ชันย้อนหลังได้ และจะไม่ทำงาน หากแอ็พพลิเคชันถูกโฮสต์บนเวอร์ชันก่อนหน้าของเซิร์ฟเวอร์ คีย์เวิร์ดจะทำหน้าที่เป็นจุดพักแบบคงที่ภายในโค้ด JavaScript ฝั่งเซิร์ฟเวอร์เมื่อเซิร์ฟเวอร์/แอ็พพลิเคชันรันอยู่ในโหมดดีบัก การใช้ คีย์เวิร์ดจะไม่ทำให้เกิดปัญหาภายในแอ็พพลิเคชัน XPages ในช่วงเวลาการออกแบบ แต่แอ็พพลิเคชันจะมีปัญหาในช่วงรันไทม์เมื่อ ดำเนินการบนเวอร์ชันก่อนหน้าของเซิร์ฟเวอร์

อินเทอร์เฟส ผู้ใช้ดีบักเกอร์ยังมีการอัพเดตเพื่อทำให้กระบวนการของการดีบัก มีความซับซ้อนน้อยลงในสภาพแวดล้อม Eclipse ปุ่มแถบเครื่องมือ Debug IBM Domino Designer Server-Side JavaScriptถูกเพิ่ม ไปยังแถบเครื่องมือหลัก สำหรับข้อมูลที่สมบูรณ์เพิ่มเติม โปรดดูที่ส่วน Scripting in XPages ของส่วน Programming ของคู่มือผู้ใช้งาน Domino Designer

คุณสมบัติ/การกำหนดลักษณะสำหรับการใช้รีซอร์ส Dojo ที่บีบอัด สำหรับการดีบัก - คุณสมบัติแบบพับลิกในไฟล์ xsp.properties ที่ชื่อ xsp.client.script.uncompressed สามารถถูกแก้ไข และตั้งค่าเป็น TRUE เพื่อเปิดใช้การดีบักที่ง่ายขึ้นในรีซอร์สที่บีบอัด

การเลือก เช็กบ็อกซ์ ใช้ไฟล์รีซอร์สที่บีบอัด (CSS & Dojo) ใน XPage Properties Editor - แท็บ Performance Properties ของ แอ็พพลิเคชันของคุณจะเปิดใช้งานคุณลักษณะนี้ด้วย เช็กบ็อกซ์จะแก้ไข บรรทัดนี้ในไฟล์xsp.propertie ดังต่อไปนี้: xsp.client.resources.uncompressed=true

เมื่อ ตั้งค่าเป็น true คุณสมบัตินี้ทำให้รีซอร์ส Dojo จัดหา ไฟล์ที่ไม่ได้บีบอัดที่มีย่อหน้า พื้นที่ว่าง ชื่อตัวแปร และความคิดเห็นทั้งหมดเพื่อที่คุณจะสามารถดีบักแอ็พพลิเคชันของคุณอย่างละเอียด ในสภาพแวดล้อมการดำเนินการ คุณสมบัตินี้ควรถูกตั้งค่าเป็น false เพื่อ เพิ่มประสิทธิภาพแอ็พพลิเคชัน

ทางเทคนิค เวอร์ชันที่ไม่ได้บีบอัด ของรีซอร์สจะถูกจัดหาโดยไลบรารีที่ต่างกัน คุณ ต้องมีสองไลบรารีที่ลงทะเบียนไว้ (ตัวอย่างเช่น 1.7.2 สำหรับเวอร์ชันที่บีบอัด และ 1.7.2-u สำหรับเวอร์ชันที่ไม่ได้บีบอัด) เวอร์ชันล่าสุด ที่กล่าวถึง (1.7.2-u) จะถูกใช้เฉพาะเมื่อคุณสมบัติถูกตั้งค่าเป็น True เท่านั้น คุณสมบัติจะไม่แสดงโดยค่าดีฟอลต์ ซึ่งจะเท่ากับการตั้งค่า คุณสมบัติเป็น False

การกำหนดลักษณะเพื่อปิดการย่อหน้าอัตโนมัติ ในเอดิเตอร์ LotusScript - การกำหนดลักษณะที่มีให้จะทำให้คุณเปิด หรือปิดการย่อหน้าโดยอัตโนมัติ ในเอดิเตอร์ LotusScript พบการกำหนดลักษณะนี้ได้ในส่วน General ของแท็บ LotusScript Editor Preferences ค่าดีฟอลต์ปัจจุบันก็คือคุณลักษณะนี้ที่ ไม่ ถูกเปิดใช้งาน

การกำหนดลักษณะ จะปิดการย่อหน้าโดยอัตโนมัติในเอดิเตอร์ LotusScript - การกำหนดลักษณะ ที่มีให้ช่วยให้คุณเปิด หรือปิดการย่อหน้าโดยอัตโนมัติในเอดิเตอร์ LotusScript พบการกำหนดลักษณะนี้ ได้ในส่วน General ของแท็บ LotusScript Editor Preferences ค่าดีฟอลต์ปัจจุบันคือคุณลักษณะนี้ที่ ไม่ ถูกเปิดใช้งาน

การเพิ่มแอ็คชัน Send Mail พื้นฐาน – เพิ่มแอ็คชันSend Mailพื้นฐาน ไปยัง XPage เพื่อให้คุณดำเนินการกิจกรรมที่โปรแกรมไว้ล่วงหน้า ที่สามารถแก้ไขโดยอาร์กิวเมนต์ แอ็คชันพื้นฐานที่ใช้กับ ตัวจัดการเหตุการณ์ และสามารถจัดกลุ่ม แอ็คชันพื้นฐานนี้จะถูกเพิ่ม เพื่อให้สามารถส่งเมลจากแอ็พพลิเคชัน XPages ได้ง่ายมากขึ้น และยัง ช่วยให้คุณส่งอีเมล Embedded Experience โปรดดูที่เอกสารผลิตภัณฑ์ สำหรับข้อมูลที่สมบูรณ์เพิ่มเติม

ภาพรวมผลิตภัณฑ์

IBM® Domino Designer สนับสนุน การพัฒนาแอ็พพลิเคชัน สำหรับแพล็ตฟอร์ม IBM Domino โดยใช้ XPages ฟอร์ม มุมมอง และอิลีเมนต์อื่นๆ เช่น คอนโทรล

XPage คือเทคโนโลยีในการพัฒนาแอ็พพลิเคชันที่รวดเร็วสำหรับการสร้าง แอ็พพลิเคชันแบบอิงเว็บที่ทำงานร่วมกัน XPages จัดเตรียมชุดของส่วนติดต่อผู้ใช้ จำนวนมากและคอนโทรลการเข้าถึงข้อมูลที่สร้างขึ้นบนเทคโนโลยี Java Server Faces XPages สนับสนุนการผสานรวมของ IBM Notes ที่มีอยู่และทรัพย์สินของ Domino NSF เช่น เอกสาร มุมมอง เอเจนต์ สูตร และระบบความปลอดภัย แอ็พพลิเคชันเหล่านี้สามารถสร้างการแสดงผลเป็น เว็บเพจแบบไดนามิก 2.0 ทั้งในเบราว์เซอร์และในไคลเอ็นต์ Notes อินเตอร์เฟสการพัฒนา จัดเตรียมสภาวะแวดล้อมการออกแบบแบบลากแล้วปล่อยและสภาวะแวดล้อม XML ต้นทาง การนำเสนอถูกควบคุมผ่าน Cascading Style Sheets (CSS) และตรรกะเชิงธุรกิจและสามารถพัฒนาได้โดยใช้ JavaScript

เอกสาร Domino Designer ประกอบด้วย:

  • Domino Designer User Guide แนะนำผลิตภัณฑ์ และอธิบาย XPages และ อิลีเมนต์ที่สนับสนุน ข้อมูลนี้ยังอธิบายคุณลักษณะ Domino Designer ที่เพิ่มขึ้นหลังจากเวอร์ชัน 8.5
  • Domino Designer XPages Reference อธิบายอินเทอร์เฟส JavaScript ในออบเจ็กต์ Domino แอ็คชันพื้นฐาน และรายการ อื่นๆ ของโปรแกรมที่น่าสนใจใน XPages
  • Domino Designer Basic User Guide and Reference อธิบายอิลีเมนต์แบบฟอร์ม ของ Domino Designer ซึ่งประกอบด้วย ฟอร์ม มุมมอง ภาษาสูตร LotusScript, และอื่นๆ

เอกสารนี้อ้างถึงผลิตภัณฑ์ดังต่อไปนี้: IBM Domino, IBM Domino Designer, IBM Notes, IBM iNotes, and IBM Notes Traveler

การทำความเข้าใจกับ XPages

แอ็พพลิเคชัน XPages คือ XML ที่ตีความโดยเซิร์ฟเวอร์ Domino หรือไคลเอ็นต์ Notes และแสดงในเว็บเบราว์เซอร์ หรือไคลเอ็นต์ Notes คุณสามารถโต้ตอบด้วย คอนโทรลบนเพจเพื่อส่งคำร้องขอไปยังเซิร์ฟเวอร์

ตัวอย่างเช่น, โค้ด XML นี้ใช้สำหรับแอ็พพลิเคชัน XPages ที่มี กล่องแก้ไขและสองปุ่ม:
<?xml version="1.0" encoding="UTF-8"?>
<xp:view xmlns:xp="http://www.ibm.com/xsp/core">
	<xp:this.data>
		<xp:dominoDocument var="document1" formName="create"></xp:dominoDocument>
	</xp:this.data>
	<xp:inputText id="inputText1" value="#{document1.subject}"></xp:inputText><xp:br></xp:br>
	<xp:button id="button1" value="Submit"><xp:eventHandler event="onclick" submit="true" 
		refreshMode="complete" immediate="false" save="true"></xp:eventHandler></xp:button>
	<xp:button id="button2" value="Cancel"><xp:eventHandler event="onclick" submit="true" 
		refreshMode="complete" immediate="true" save="false"></xp:eventHandler></xp:button>
	<xp:this.navigationRules>
		<xp:navigationRule outcome="xsp-success" viewId="/main.xsp"></xp:navigationRule>
	</xp:this.navigationRules>
</xp:view>
นี่คือคำอธิบายบรรทัดต่อบรรทัดของตัวอย่างโค้ด XML ซึ่งหมายถึง:
  • xmlns:xp="http://www.ibm.com/xsp/core"

    Domino กำหนดคอนโทรล และโปรแกรม อื่นๆ ในเนมสเปซ http://www.ibm.com/xsp/core โดยใช้ xp เป็น ตัวย่อของอิลีเมนต์

  • xp:dominoDocument var="document1" formName="create"

    แอ็พพลิเคชัน XPages จะเชื่อมโยงกับฟอร์ม Domino ที่ชื่อ สร้าง

  • xp:inputText id="inputText1" value="#{document1.subject

    กล่องอินพุต ถูกโยงกับฟิลด์ที่ชื่อ subject บนแบบฟอร์ม create

  • xp:button id="button1" value="Submit", save="true", xp:navigationRule outcome="xsp-success" viewId="/main.xsp"

    เมื่อคลิก, ปุ่มแรกเป็นสาเหตุทำให้คำร้องขอต้องถูกส่งไปยังเซิร์ฟเวอร์ เซิร์ฟเวอร์ บันทึกข้อมูลจากกล่องอินพุตเป็นเอกสารใหม่อ้างอิงตามแบบฟอร์ม create, จากนั้น ส่งเพจอื่นที่ชื่อ main ไปยังไคลเอ็นต์

  • id="button2" value="Cancel", save="false"

    เมื่อคลิก, ปุ่มที่สองยังเป็นสาเหตุทำให้คำร้องขอถูกส่งไปยัง เซิร์ฟเวอร์ ในกรณีนี้, เซิร์ฟเวอร์ส่งกลับเพจ main

Domino Designer มี อินเทอร์เฟสผู้ใช้ (UI) ที่มีการนำทาง เอดิเตอร์ XPages พาเล็ต คอนโทรล แท็บคุณสมบัติ แท็บเหตุการณ์ และโปรแกรมอื่นๆ ต่อไปนี้ แสดงวิธีที่เพจถูกสร้างขึ้นโดยโค้ด XML ก่อนหน้าที่ปรากฏใน โหมดออกแบบของ Domino Designer:
อินเทอร์เฟสผู้ใช้ XPages

ผู้ใช้สามารถใช้เมนูหรือลากและปล่อยเพื่อจัดการกับคอนโทรล และข้อความในเอดิเตอร์ ผู้ใช้ยังสามารถใช้แท็บต่างๆ เพื่อตั้งค่าสำหรับคุณสมบัติและเหตุการณ์ โปรดสังเกตว่า ผู้ใช้สามารถใช้แท็บ แหล่งที่มา เพื่อแก้ไข XML โดยตรง

ผู้ใช้ใช้คุณสมบัติ XPage เพื่อระบุฟอร์ม Domino และมุมมอง Domino เป็นแหล่งข้อมูล และใช้คุณสมบัติคอนโทรล เพื่อเชื่อมโยงคอนโทรลกับฟิลด์บนแหล่งข้อมูล

สำคัญ: โปรดระวังเมื่อแก้ไข XML โดยตรง เนื่องจากข้อผิดพลาดสามารถทำให้ XPage ไม่ทำงาน
คอนโทรลแบบคอร์ประกอบด้วย:
  • คอนโทรลสำหรับการรับอินพุต - กล่องแก้ไข, Rich Text, กล่องแก้ไขแบบหลายบรรทัด, กล่องรายการ, คอมโบบ็อกซ์, เช็กบ็อกซ์, ปุ่มแบบเรดิโอ, กลุ่มเช็กบ็อกซ์, กลุ่มปุ่มแบบเรดิโอ, ตัวเลือกวันที่ เวลา
  • คอนโทรลสำหรับการดำเนินการกับแอ็คชัน - ปุ่ม, อัพโหลดไฟล์, ดาวน์โหลดไฟล์
  • คอนโทรลสำหรับการแสดง - ลิงก์, เลเบล, ฟิลด์ที่คำนวณแล้ว, อิมเมจ, ข้อผิดพลาดแสดง, ข้อผิดพลาดแสดง, เพจเจอร์
  • คอนโทรลแบบกำหนดเอง - พื้นที่ที่สามารถแก้ไขได้
คอนโทรลคอนเทนเนอร์ประกอบด้วยสิ่งต่อไปนี้:
  • พาเนล - สร้างสี่เหลี่ยมบนเพจสำหรับการสอดแทรกของ คอนโทรลอื่นๆ
  • ทำซ้ำ - ทำซ้ำจำนวนครั้งของตัวแปรของคอนโทรล
  • เพจ Include - ทำงานร่วมกันกับ XPage อื่น
  • ตาราง - สร้างตารางด้วยจำนวนคงที่ของคอลัมน์และแถว
  • มุมมอง - ทำงานร่วมกันกับมุมมอง Domino
  • ตารางข้อมูล - สร้างตารางที่มีแถวกลางพร้อมใช้งานใน จำนวนและโยงกับคอลเล็กชันข้อมูล
  • พาเนลที่แท็บ - สร้างชุดของพาเนลการซ้อนทับแต่ละครั้งที่เข้าถึง โดยคลิกที่แท็บ
  • ส่วน - สร้างพาเนลที่สามารถยุบได้
อินเตอร์เฟสโปรแกรมมิงคือ JavaScript ที่รันทั้งบนเซิร์ฟเวอร์ และไคลเอ็นต์:
  • ไคลเอ็นต์ JavaScript พ่วงต่อกับเหตุการณ์ เช่น onclick, onblur, และ onfocus สคริปต์เหล่านี้จะรันบนเว็บเบราว์เซอร์ หรือไคลเอ็นต์ Notes ก่อน จะส่งคำขอไปยังเซิร์ฟเวอร์ และใช้ Web Document Object Model (DOM) คุณอาจสร้างสคริปต์, ตัวอย่างเช่น ตรวจสอบว่า กล่องอินพุตมีเนื้อหาหรือยืนยันการดำเนินการกับเซิร์ฟเวอร์ ที่ถอนข้อมูล
  • เซิร์ฟเวอร์ JavaScript ยังพ่วงต่อกับเหตุการณ์, แต่เริ่มต้นหลังจากที่คำร้องขอส่งผ่านไปยังเซิร์ฟเวอร์ นอกจากนี้, เซิร์ฟเวอร์ JavaScript สามารถใช้เพื่อคำนวณค่าคอนโทรล, การโยงข้อมูล, และคุณสมบัติ เซิร์ฟเวอร์ JavaScript มีการเข้าถึง ชุดของไลบรารีที่ขยายเพิ่ม, ซึ่งรวมถึงหนึ่งอ็อบเจ็กต์ Domino เหล่านี้คือออบเจ็กต์ Domino เดียวกันที่สามารถเข้าถึงได้ ผ่าน LotusScript และ Java ออบเจ็กต์จะเข้าถึงหน่วยเก็บข้อมูล Domino และจัดการสภาพแวดล้อม Domino
และที่พร้อมใช้งานในคอนเท็กซ์บางส่วนคือแอ็คชันพื้นฐานและ Expression Language (EL)

อ็อบเจ็กต์โกลบอลจัดเตรียมกลไกการสร้างสำหรับอ็อบเจ็กต์แบบคอร์ ตัวอย่างเช่น, session คืออ็อบเจ็กต์ NotesSession สำหรับเซสชันปัจจุบัน, database คืออ็อบเจ็กต์ NotesDatabase สำหรับแอ็พพลิเคชันปัจจุบัน, และ context คืออ็อบเจ็กต์ XSPContext สำหรับคอนเท็กซ์ที่ JavaScript กำลังทำงาน ตัวแปร ที่กำหนดขอบเขตไว้จัดเตรียมกลไกพื้นฐานสำหรับการแบ่งใช้ค่าระหว่างคอนโทรล, เพจ, และเซสชัน

แบบฟอร์มและมุมมอง

ใน Domino แบบฟอร์ม กำหนดวิธีที่เอกสารแสดงให้กับผู้ใช้ และวิธีจัดเก็บรายการข้อมูล ของแบบฟอร์ม มุมมองรายงานเอกสารในคอลัมน์และแถว

เมื่อผู้ใช้เปิดเอกสารใหม่, แบบฟอร์มที่นิยามเอกสารนั้น ถูกใช้เพื่อสร้างการแสดงผลเพจบนไคลเอ็นต์ UI เมื่อผู้ใช้บันทึกเอกสารใหม่, ข้อมูลจาก UI ถูกใช้เพื่อสร้างเอกสารตาม นิยามข้อมูลบนแบบฟอร์ม นอกจากนั้น เมื่อผู้ใช้เปิดเอกสารที่มีอยู่, ข้อมูลจะถูกสร้างการแสดงผลบนไคลเอ็นต์ UI ตามนิยามข้อมูล บนแบบฟอร์ม

โดยปกติแล้ว, แต่ละแถวของมุมมองแทนค่าหนึ่งเอกสาร อย่างไรก็ตาม, เป็นวิธีการที่ง่ายในแอ็พพลิเคชัน XPage ที่จะเชื่อมมุมมองที่มากกว่าหนึ่งมุมมองพร้อมกัน, ดังนั้น แต่ละแถวคือมุมมองของเอกสารที่มากกว่าหนึ่งเอกสารสำหรับแถวนั้น

คอลัมน์สามารถมีค่าข้อมูลจากเอกสารต่างๆ หรือข้อมูลที่คำนวณ, เช่น วันที่ปรับเปลี่ยนล่าสุดของเอกสาร มุมมอง สามารถเรียงลำดับและจัดหมวดหมู่เพื่อแสดงเอกสารได้ดีกว่า มุมมอง สามารถใช้เป็นกลไกการเข้าถึงข้อมูล, ตัวอย่างเช่น, อนุญาตให้ผู้ใช้เปิดเอกสารโดยดับเบิลคลิกที่แถวในมุมมอง

แอ็พพลิเคชัน XPage ยังใช้ทั้งแบบฟอร์มและมุมมอง คุณสามารถใช้ฟอร์ม เพื่อเชื่อมต่อคอนโทรลบนเพจไปยังนิยามข้อมูล Domino อันดับแรก ให้เชื่อมโยงเพจด้วยแบบฟอร์ม จากนั้นโยงคอนโทรลอินพุตข้อมูลบนเพจ กับฟิลด์บนแบบฟอร์ม สามารถรวมมุมมองDomino เข้ากับคอนโทรล XPages View

อิลีเมนต์ Domino อื่นๆ ที่สามารถใช้บนเพจประกอบด้วย:
  • ไลบรารี JavaScript
  • รีซอร์สของอิมเมจ
  • รีซอร์สสไตล์ชีต
  • รีซอร์สของธีม

การนำทางในDomino Designer

IBM Domino Designer ถูกติดตั้งเป็นมุมมองของ Eclipse ที่จัดเรียงในเอดิเตอร์ พาเล็ต และมุมมองที่สามารถเข้าถึงได้ง่าย คุณสามารถดำเนินการกับภารกิจได้โดยใช้เมนูหลัก, เมนูแบบคลิกขวา, และไอคอนในมุมมอง, ถาดข้อมูล, และแถบหัวเรื่อง เอดิเตอร์

มุมมอง IBM Domino Designer มีดังต่อไปนี้:
  • Domino Designer แสดงอิลิเมนต์การออกแบบทั้งหมดใน เนวิเกเตอร์แอ็พพลิเคชันและเป็นเปอร์สเปคทีฟดีฟอลต์
  • XPages แยกอิลิเมนต์การออกแบบที่ไม่จำเป็น สำหรับการพัฒนา XPages
  • แบบฟอร์ม/มุมมอง แยกอิลิเมนต์การออกแบบเฉพาะ ที่จำเป็นสำหรับการพัฒนา XPages

เมื่อต้องการเปลี่ยนเปอร์สเปคทีฟ, ให้คลิก หน้าต่าง > เปิดเปอร์สเปคทีฟ

เมื่อต้องการปรับเนื้อหาของเปอร์สเปคทีฟอื่นๆ, ให้ไปที่ ไฟล์ > การกำหนดค่าตามความชอบ > Domino Designer > เนวิเกเตอร์แอ็พพลิเคชัน

เนื่องจากมุมมอง IBM Domino Designer ถูกกำหนดโดย แบบแผน Eclipse คุณสามารถย้าย ปรับขนาด ปิด และเปิดมุมมอง เมื่อต้องการบันทึกการจัดเรียงใหม่ของคุณเป็นเปอร์สเปคทีฟใหม่ ด้วยชื่อที่คุณเลือกไว้, ให้เลือก หน้าต่าง > บันทึกเปอร์สเปคทีฟเป็น ใน แถบเมนู

คุณยังสามารถนำทางผ่านมุมมองโดยใช้ช็อตคัตคีย์บอร์ด Eclipse Ctrl+F7 ซึ่งเป็นค่าดีฟอลต์หรือด้วยการคลิก หน้าต่าง > การนำทาง ในเมนูหลัก Eclipse

เมื่อต้องการดูมุมมองใดๆ ที่ซ่อนไว้, ให้คลิก หน้าต่าง > แสดงมุมมอง Eclipse ในเมนูหลัก Eclipse, และเลือกมุมมองที่ซ่อนไว้จากรายการ

อิลิเมนต์การออกแบบและเนวิเกเตอร์แอ็พพลิเคชัน

อิลิเมนต์การออกแบบที่พร้อมใช้งานถูกแสดงตาม เนวิเกเตอร์แอ็พพลิเคชัน

ตามค่าดีฟอลต์, เนวิเกเตอร์แอ็พพลิเคชันอยู่ทางด้านซ้ายของ หน้าต่าง เมื่อคุณสร้างหรือเปิดแอ็พพลิเคชัน, อิลิเมนต์จะถูกแสดง ในเนวิเกเตอร์แอ็พพลิเคชัน
  • เมื่อต้องการสร้างแอ็พพลิเคชัน, ให้คลิก ไฟล์ > สร้าง > แอ็พพลิเคชัน หรือคลิกขวาในเนวิเกเตอร์แอ็พลิเคชันและเลือก สร้างแอ็พพลิเคชันใหม่ (Ctrl-N)
  • เมื่อต้องการเปิดแอ็พพลิเคชันที่มีอยู่, ให้เลือกแอ็พพลิเคชันในเนวิเกเตอร์แอ็พพลิเคชัน, หรือถ้าไม่ได้อยู่ที่นั่น, ให้คลิก ไฟล์ > แอ็พพลิเคชัน > เปิด และเลือกแอ็พพลิเคชัน
  • เมื่อต้องการดูชนิดอิลิเมนต์การออกแบบที่พร้อมใช้งานและกลุ่มอิลิเมนต์การออกแบบ, ให้ขยายแอ็พพลิเคชัน ขยายกลุ่มเพื่อดูชนิดอิลิเมนต์การออกแบบ ในกลุ่ม
  • เมื่อต้องการสร้างอิลิเมนต์การออกแบบของชนิดที่เลือกไว้, ให้ใช้เมนู หรือคลิกขวา เนื่องจากอิลิเมนต์การออกแบบถูกสร้างขึ้น, อิลิเมนต์เหล่านั้นจะแสดงภายใต้ ชนิด รายการของอิลิเมนต์การออกแบบถูกแสดงในเอดิเตอร์โดยดับเบิลคลิก ชนิดอิลิเมนต์ อิลิเมนต์การออกแบบสามารถเปิดเพื่อแก้ไข โดยดับเบิลคลิกที่อิลิเมนต์

ตารางต่อไปนี้อธิบายถึงแต่ละอิลิเมนต์การออกแบบและบ่งชี้ ชนิดของแอ็พพลิเคชันที่ใช้

อิลิเมนต์การออกแบบ คำอธิบาย
แบบฟอร์ม จัดเตรียมโครงสร้างสำหรับทั้งการสร้างและแสดงเอกสาร สำหรับ XPages, คุณสามารถใช้แบบฟอร์มเป็นแหล่งข้อมูลได้
มุมมอง ถูกเรียงลำดับหรือจัดเป็นหมวดหมู่รายการของเอกสาร สำหรับ Designer แบบอ้างอิงแบบฟอร์ม, มุมมองคือจุดทางเข้าไปยังข้อมูลที่เก็บอยู่ในฐานข้อมูล มุมมองสามารถทำงานร่วมกันใน XPages
โฟลเดอร์ คือคอนเทนเนอร์ที่ถูกใช้เพื่อเก็บเอกสารที่เกี่ยวข้อง หรือจัดกลุ่มเอกสาร โฟลเดอร์มีอิลิเมนต์การออกแบบเดียวกับมุมมอง
XPages นิยามข้อความและคอนโทรลส่วนติดต่อผู้ใช้ (UI) ที่ผู้ใช้ โต้ตอบด้วยขณะที่ใช้แอ็พพลิเคชัน
คอนโทรลแบบกำหนดเอง เป็นคอลเล็กชันของคอนโทรล UI ที่ถูกเก็บเป็น อ็อบเจ็กต์เดี่ยว
ชุดกรอบ คือคอลเล็กชันของกรอบสำหรับการเพิ่มโครงสร้างให้กับแอ็พพลิเคชันของคุณ
เพจ คืออิลิเมนต์การออกแบบฐานข้อมูลที่แสดงข้อมูล
อิลิเมนต์ที่แบ่งใช้ - แบบฟอร์มย่อย เป็นคอลเล็กชันของอิลิเมนต์แบบฟอร์มที่เก็บเป็นอ็อบเจ็กต์เดี่ยว
อิลิเมนต์ที่แบ่งใช้ - ฟิลด์ เก็บข้อมูล คุณสร้างฟิลด์บนแบบฟอร์ม, แบบฟอร์มย่อย, และ ขอบเขตโครงร่าง สำหรับ XPages, คุณโยงคอนโทรลกับฟิลด์
อิลิเมนต์ที่แบ่งใช้ - คอลัมน์ แสดงค่าฟิลด์และข้อมูลอื่นๆ เกี่ยวกับเอกสาร คุณสร้างคอลัมน์บนมุมมองและโฟลเดอร์
อิลิเมนต์ที่แบ่งใช้ - โครงร่าง จัดเตรียมการจัดการโครงสร้างสำหรับแอ็พพลิเคชันและคอนโทรล วิธีการแสดงอิลิเมนต์ในบานหน้าต่างการนำทาง
อิลิเมนต์ที่แบ่งใช้ - เนวิเกเตอร์ เป็นแผนผังทางเดินแบบกราฟิกที่สั่งให้ผู้ใช้ระบุส่วนต่างๆ ของแอ็พพลิเคชัน
โค้ด - เอเจนต์ ตั้งค่าภารกิจที่เรียกใช้โดยผู้ใช้หรือแบ็กกราวน์ในส่วนใดๆ ของแอ็พพลิเคชัน
โค้ด - แอ็คชันที่แบ่งใช้ ตั้งค่าภารกิจที่เรียกใช้โดยผู้ใช้บนแบบฟอร์มหรือมุมมอง
โค้ด - ไลบรารีสคริปต์ มีโค้ด LotusScript, Java, หรือ JavaScript สำหรับการแทรกในไคลเอ็นต์หรืออิลิเมนต์โปรแกรมมิงเซิร์ฟเวอร์ ไลบรารี JavaScript ใช้สำหรับ XPages
โค้ด - สคริปต์ฐานข้อมูล เป็นอิลิเมนต์โปรแกรมมิงที่เรียกใช้เหตุการณ์ ระดับแอ็พพลิเคชัน, เช่น การเปิดหรือปิดแอ็พพลิเคชัน
โค้ด - ผู้ให้บริการเว็บเซอร์วิส คือโค้ดที่ไม่อ้างอิงกับสิ่งใด, โค้ดที่มีคำอธิบายในตัว, แอ็พพลิเคชันโมดูล่าร์, อ้างอิง XML, ที่สามารถเผยแพร่และเรียกจากเว็บ ผู้ให้บริการ เว็บเซอร์วิสคือเว็บเซอร์วิสที่โฮสต์อยู่บนเซิร์ฟเวอร์ Domino ดังนั้นจึงสามารถเรียกได้จาก คอมพิวเตอร์เครื่องอื่น
โค้ด - ผู้ใช้เว็บเซอร์วิส เรียกเว็บเซอร์วิสบนคอมพิวเตอร์เครื่องอื่น
โค้ด - Java

สร้างอิลิเมนต์ Java Class, Interface, หรือ Enum ในขอบเขตของโปรเจ็กต์ NSF (ภายใต้ Code/Java ในเปอร์สเปคทีฟ Java) โค้ด Java สามารถเรียกได้โดย โค้ดใน XPages

โค้ด - Jars

กำหนดความสามารถให้คุณเพื่อทำงานกับโค้ด/ไลบรารี Java ที่อยู่ในแพ็กเกจ ซึ่งรวมไว้ใน NSF แอ็พพลิเคชัน ให้อิสระกับคุณจากการนำ JARS ไปใช้งานกับเซิร์ฟเวอร์ และ/หรือ รวมไฟล์ต้นฉบับเฉพาะในฐานข้อมูลแอ็พพลิเคชัน อิลีเมนต์นี้จะ สามารถใช้ได้กับแอ็พพลิเคชัน XPage เท่านั้น เมื่อ JAR ถูกโหลด โดยอัตโนมัติโดยรันไทม์ของ XPages

ข้อมูล - การเชื่อมต่อข้อมูล คือรีซอร์สที่สร้างการแลกเปลี่ยนข้อมูลระหว่างแอ็พพลิเคชัน Domino และแหล่งข้อมูล ภายนอก
ข้อมูล - มุมมองการเข้าถึง DB2s นิยามมุมมอง DB2 ของข้อมูล Notes
รีซอร์ส - อิมเมจ ใช้เป็นกราฟิกหรือไอคอนบน XPages, เพจ, แบบฟอร์ม, แบบฟอร์มย่อย, ปุ่มแอ็คชัน, และรายการโครงร่าง, และเป็นอิมเมจพื้นหลังบนแบบฟอร์ม, เอกสาร, เพจ, เซลล์ตาราง, และปุ่มแอ็คชัน
รีซอร์ส - ไฟล์ อนุญาตให้คุณแบ่งใช้ไฟล์ที่ไม่ใช่ NSF ภายในและระหว่างแอ็พพลิเคชัน
รีซอร์ส - แอ็พเพล็ต เป็นโปรแกรม Java ที่ไม่อ้างอิงกับสิ่งใดที่สามารถรันอยู่ในแอ็พพลิเคชัน Domino ของคุณ
รีซอร์ส - สไตล์ชีต สามารถสร้างหรืออิมพอร์ตได้ ตามค่าดีฟอลต์, XPages และคอนโทรล UI ใช้ cascading styles sheets (CSS) ดีฟอลต์ที่จัดเตรียมไว้พร้อมกับ Domino คุณสามารถลบล้างค่าดีฟอลต์ ด้วยรีซอร์สเหล่านี้
รีซอร์ส - ธีม เป็นการกำหนดเองของการสร้าง HTML ฝั่งเซิร์ฟเวอร์ที่สามารถ ใช้เพื่อนิยามลักษณะของแอ็พพลิเคชัน ตามค่าดีฟอลต์แล้ว, XPages และคอนโทรลส่วนติดต่อผู้ใช้ใช้ธีมที่นิยามไว้สำหรับเซิร์ฟเวอร์ ธีมแบบโกลบอลนั้น สามารถปรับเปลี่ยนได้, สำหรับแอ็พพลิเคชันทั้งหมด, หรือสามารถลบล้างได้ด้วย แอ็พพลิเคชันที่ระบุเฉพาะธีม
รีซอร์ส - เกี่ยวกับเอกสาร อธิบายถึงวัตถุประสงค์ของแอ็พพลิเคชัน
รีซอร์ส - การใช้เอกสาร จัดเตรียมผู้ใช้ด้วยคำสั่ง
รีซอร์ส - ไอคอน ช่วยผู้ใช้ระบุฐานข้อมูลแบบด่วนบนบานหน้าต่างบุ๊กมาร์ก, และสามารถนำทางเข้าสู่แอ็พพลิเคชันจากเอดิเตอร์ไอคอน
คอมโพสิตแอ็พพลิเคชัน - คุณสมบัติการเชื่อมต่อ กำหนดสิทธิ์ในการเข้าถึงไฟล์ WSDL ให้แก่คุณภายในคอมโพสิตแอ็พพลิเคชัน
คอมโพสิตแอ็พพลิเคชัน - แอ็พพลิเคชัน กำหนดสิทธิ์ในการเข้าถึงไฟล์ XML ที่จำเป็นซึ่งมีนิยามสำหรับ คอมโพสิตแอ็พพลิเคชัน
คอมโพสิตแอ็พพลิเคชัน - คอมโพเนนต์ นำไปใช้งานในคอมโพสิตแอ็พพลิเคชันหากอ้างอิง XPages
คอนฟิกูเรชันแอ็พพลิเคชัน - คุณสมบัติแอ็พพลิเคชัน อนุญาตให้คุณตั้งค่าคุณสมบัติแอ็พพลิเคชันแบบกว้างๆ
คอนฟิกูเรชันแอ็พพลิเคชัน - Faces-config จัดเตรียมสิทธิ์ในการแก้ไข webcontent\web-inf\faces-config.xml นั่นคือไฟล์คอนฟิกูเรชันที่ถูกใช้สำหรับการกำหนดคอนฟิก บีนที่ถูกจัดการ (ท่ามกลางสิ่งอื่นใด เช่น ตัวแปลง/ตรวจตัวสอบความถูกต้องแบบกำหนดเอง) ใน XPages
คอนฟิกูเรชันแอ็พพลิเคชัน - คุณสมบัติ Xsp จัดเตรียมสิทธิ์ในการแก้ไขไฟล์ที่มีคอลเล็กชันของพารามิเตอร์กรอบงาน XPages, ที่รู้จักกันในชื่อของ xsp.properties ซึ่งถูกใช้บนแอ็พพลิเคชันหรือระดับเซิร์ฟเวอร์เพื่อตั้งค่าและควบคุมค่าติดตั้ง XPages ในแอ็พพลิเคชัน XPages ของคุณ ทุกๆ แอ็พพลิเคชัน XPages NSF มีไฟล์ xsp.properties

เนื่องจากคู่มือการใช้งานนี้อยู่ศูนย์กลาง XPages และแอ็พพลิเคชันที่ใช้ XPages, ซึ่งอธิบายในรายละเอียดเพิ่มเติมเกี่ยวกับเซ็ตย่อยของอิลิเมนต์การออกแบบ ที่ใช้ในแอ็พพลิเคชัน XPages สามารถดูเอกสารอย่างละเอียดสำหรับ อิลีเมนต์การออกแบบ "เชิงแบบฟอร์ม" และแอ็พพลิเคชัน "เชิงแบบฟอร์ม" เพิ่มเติม ในคู่มือการใช้งาน และการอ้างอิง Domino Designer Basic

การเลือกและการกรองชนิดอิลิเมนต์การออกแบบ

คุณ สามารถเลือกและกรองชนิดอิลิเมนต์การออกแบบที่คุณต้องการแสดง ในเนวิเกเตอร์แอ็พพลิเคชันโดยทำการเลือกใน การกำหนดค่าตามความชอบ > Domino Designer > เนวิเกเตอร์แอ็พพลิเคชัน

เลือก อิลิเมนต์ที่คุณต้องการทำงานด้วยและแสดงโดยเลือก อิลิเมนต์บนพาเนล การกำหนดค่าตามความชอบ ด้วยการเลือก เปอร์สเปคทีฟจาก \list บนพาเนล, คุณยังตั้งค่า การเลือกและกรองอ็อพชันที่แยกต่างหากสำหรับแต่ละเปอร์สเปคทีฟ ทั้งสามเปอร์สเปคทีฟ: Domino Designer, XPages, และ แบบฟอร์ม/มุมมอง Domino Designer

การเปรียบเทียบเวอร์ชันของอิลิเมนต์การออกแบบ

คุณ สามารถเปรียบเทียบเวอร์ชันที่แตกต่างกันของอิลิเมนต์การออกแบบหรือรีซอร์ส โดยดับเบิลคลิกที่ไอเท็มที่ระบุเฉพาะและเลือกชนิดการเปรียบเทียบจาก เมนูคอนเท็กซ์ เมื่อดำเนินการเปรียบเทียบ, เอดิเตอร์การเปรียบเทียบ จะปรากฏขึ้นในพื้นที่เอดิเตอร์ ความแตกต่างกันระหว่างเวอร์ชันถูกไฮไลต์ใน เอดิเตอร์การเปรียบเทียบ, ซึ่งอนุญาตให้คุณเรียกดูและคัดลอกการเปลี่ยนแปลง ระหว่างเวอร์ชันที่เปรียบเทียบ

คุณอาจดำเนินการกับ ชนิดการเปรียบเทียบต่อไปนี้:
  • เปรียบเทียบกับ > ประวัติโลคัล - เปรียบเทียบอิลิเมนต์ที่เลือกไว้ หรือรีซอร์สกับอิลิเมนต์ที่อยู่ในประวัติโลคัล, ซึ่งถูกเก็บไว้ เมื่อคุณบันทึกการเปลี่ยนแปลง
  • เปรียบเทียบกับ > ซึ่งกันและกัน - เปรียบเทียบสองหรือสามอิลิเมนต์ที่เลือกไว้ หรือรีซอร์สแต่ละรีซอร์ส

เอดิเตอร์การออกแบบ

เอดิเตอร์การออกแบบคือตำแหน่งที่คุณแก้ไข XPages และอิลิเมนต์การออกแบบอื่นๆ, และดูรายการของอิลิเมนต์การออกแบบ

มุมมอง คุณสมบัติ แสดงคุณสมบัติ สำหรับการเลือกปัจจุบันในเอดิเตอร์ ตัวอย่างเช่น, ถ้าคุณกำลังทำงานกับ คอนโทรลส่วนติดต่อผู้ใช้ (UI) ใน XPage, ตราบเท่าที่คุณคลิก คอนโทรล UI นั้นในเอดิเตอร์ XPages, มุมมอง คุณสมบัติ แสดงคุณสมบัติสำหรับคอนโทรล UI นั้น

คุณสามารถทำภารกิจต่อไปนี้ ได้ในเอดิเตอร์:

ภารกิจ แอ็คชัน
เปิดอิลิเมนต์การออกแบบหรือรายการ เลือกอิลิเมนต์การออกแบบหรือรายการใน เนวิเกเตอร์แอ็พพลิเคชัน ดับเบิลคลิกหรือคลิก ไฟล์ > เปิด
สลับระหว่างอิลิเมนต์การออกแบบที่เปิดและรายการต่างๆ คลิกแท็บของอิลิเมนต์การออกแบบ หรือรายการที่คุณต้องการดู
ปิดอิลิเมนต์การออกแบบหรือรายการ คลิกไอคอน ปิด (X) บนอิลิเมนต์การออกแบบหรือแท็บรายการ, หรือเลือกแท็บและคลิก ไฟล์ > ปิด
ปิดอิลิเมนต์การออกแบบและรายการทั้งหมด ที่รวมอิลิเมนต์ปัจจุบันไว้ คลิก ไฟล์ > ปิดทั้งหมด คุณยังสามารถคลิกขวา ที่แท็บและเลือก ปิดทั้งหมด
ขยายเอดิเตอร์ให้ใหญ่สุด คลิกไอคอน ขยายให้ใหญ่สุด หรือดับเบิลคลิกที่แท็บ
เรียกคืนเอดิเตอร์ให้เป็นขนาดและตำแหน่ง ดั้งเดิม คลิกไอคอน เรียกคืน หรือดับเบิลคลิกที่แท็บ ฟังก์ชันนี้ถูกเปิดใช้งานหากคุณ ขยายเอดิเตอร์ให้ใหญ่สุด
ปรับขนาดเอดิเตอร์ด้วยลูกศรบนคีย์บอร์ด คลิกขวาที่แท็บและเลือก ขนาด จากนั้น ซ้าย, ขวา, บน, หรือ ล่าง เพื่อไฮไลต์ขอบของเอดิเตอร์ กดลูกศรคีย์บอร์ดตามความเหมาะสมเพื่อขยายหรือยุบเอดิเตอร์

เอดิเตอร์แหล่งที่มา

ใช้เอดิเตอร์แหล่งที่มาเพื่อแก้ไขซอร์สโค้ด XPages โดยตรง

เมื่อคุณกำลังแก้ไข XPage, คุณสามารถใช้แท็บแหล่งที่มา เพื่อแก้ไขซอร์สโค้ด XPages ได้โดยตรง ซึ่งมีประโยชน์มาก หากมคุณคุ้นเคยกับภาษาของ XPages

คุณสามารถทำภารกิจต่อไปนี้ ได้ในเอดิเตอร์:

ภารกิจ แอ็คชัน
ใช้เนื้อหาความช่วยเหลือขณะที่เขียนโค้ด

กด CTRL+SPACE เพื่อเรียกคุณลักษณะเนื้อหาความช่วยเหลือขณะที่เขียนโค้ด ซึ่งยังทำงานกับ SSJS (Server Side JavaScript) ที่ฝังอยู่ภายใน XPage ของคุณ

เนื้อหาความช่วยเหลือ เป็นคุณลักษณะของเอดิเตอร์แหล่งที่มาของ XPages ซึ่งผลักดันมาจาก การใช้สกีมา Domino Designer สร้างสกีมาที่อ้างอิงแอ็พพลิเคชัน Notes ปัจจุบันแบบไดนามิก สกีมามีข้อมูลวิธีใช้ สำหรับแต่ละแอ็ตทริบิวต์ของแต่ละแท็กที่เป็นส่วนหนึ่งของรันไทม์ของ XPages

ใช้การนำทางผ่านไฮเปอร์ลิงก์ขณะที่เขียนโค้ด

การนำทางผ่านไฮเปอร์ลิงก์อธิบายถึงการทำงานของ Eclipse ทั่วไปโดยที่ข้อความภายในเอดิเตอร์สามารถสร้างขึ้นในไฮเปอร์ลิงก์ได้ กด CTRL ขณะลอยอยู่เหนือข้อความใดๆ หรือลิงก์ใดๆ (รวมถึงชื่อคอนโทรลแบบกำหนดเอง) เพื่อนำทางไปยัง ตำแหน่งลิงก์/อิลิเมนต์การออกแบบโดยตรง Eclipse จัดเตรียมผลป้อนกลับไปยังเอดิเตอร์ ซึ่งคุณกำลังใช้การนำทางผ่านไฮเปอร์ลิงก์

ตัวอย่างเช่น, ใช้คุณลักษณะนี้ขณะแก้ไขคอนโทรลแบบกำหนดเอง เมื่อคุณกด CTRL และลอยอยู่เหนือคอนโทรลแบบกำหนดเองในเอดิเตอร์แหล่งที่มา, การนำทางผ่านไฮเปอร์ลิงก์ จะอนุญาตให้คุณนำทางไปยังคอนโทรลแบบกำหนดเองโดยตรง

ใช้วิธีใช้แบบลอยขณะที่เขียนโค้ด

เมื่อต้องการใช้คุณลักษณะนี้, ให้ลอยอยู่เหนือ 'โหนด' เฉพาะด้วยเคอร์เซอร์ของคุณเพื่อขอรับข้อมูลเพิ่มเติม เช่นเดียวกับ การนำทางผ่านไฮเปอร์ลิงก์ (ดูด้านบน), กรอบงานเอดิเตอร์ Eclipse ยังสามารถจัดเตรียม คำอธิบายสำหรับแท็กปัจจุบัน (และแอ็ตทริบิวต์)

แท็กและแอ็ตทริบิวต์ทั้งหมด ที่จัดเตรียมคำอธิบายไว้ผ่าน xsp-config สามารถมีข้อมูลที่ทำให้สามารถมองเห็นได้ในการทำงานของวิธีใช้แบบลอย ภายในเอดิเตอร์แหล่งที่มาของ XPages

คุณสามารถควบคุมลักษณะการทำงาน ของคุณลักษณะนี้ได้จากแท็บการกำหนดค่าตามความชอบ Domino Designer คุณลักษณะจะถูกเปิดไว้ตามค่าดีฟอลต์, ด้วยการหมดเวลาใช้งาน 500 มิลลิวินาทีซึ่งเชื่อมโยงกับการกำหนดค่าตามความชอบ นั่นคือ, เมื่อเคอร์เซอร์เป็น 'ที่พัก' ซึ่งมากกว่า 500 ms (มิลลิวินาที) กรอบเอดิเตอร์ Eclipse จะเรียกการทำงานวิธีใช้แบบลอยของเอดิเตอร์แหล่งที่มาของ XPages

เรียกใช้ะบบวิธีใช้ผลิตภัณฑ์ กด F1 เพื่อเปิด คอนเท็กซ์วิธีใช้
ดำเนินการกับภารกิจการแก้ไขอื่นๆ คลิกขวาที่เพจเอดิเตอร์แหล่งที่มา เพื่อแสดงเมนูของแอ็คชันอื่นๆ ที่คุณสามารถดำเนินการได้ขณะอยู่ในเอดิเตอร์
ขยายเอดิเตอร์ให้ใหญ่สุด คลิกไอคอน ขยายให้ใหญ่สุด หรือดับเบิลคลิกที่แท็บ
เรียกคืนเอดิเตอร์ให้เป็นขนาดและตำแหน่ง ดั้งเดิม คลิกไอคอน เรียกคืน หรือดับเบิลคลิกที่แท็บ ฟังก์ชันนี้ถูกเปิดใช้งานหากคุณ ขยายเอดิเตอร์ให้ใหญ่สุด
ปรับขนาดเอดิเตอร์ด้วยลูกศรบนคีย์บอร์ด คลิกขวาที่แท็บและเลือก ขนาด จากนั้น ซ้าย, ขวา, บน, หรือ ล่าง เพื่อไฮไลต์ขอบของเอดิเตอร์ กดดลูกศรคีย์บอร์ดตามความเหมาะสมเพื่อขยายหรือยุบเอดิเตอร์

ถาดข้อมูลและมุมอง

ถาดข้อมูลและมุมมองจัดเตรียมเครื่องมือสำหรับการทำงานกับ อิลิเมนต์การออกแบบ

ถาดข้อมูล

ถาดข้อมูลอนุญาตให้คุณทำงานกับคอนโทรลและแหล่งข้อมูล ถาดข้อมูลต่อไปนี้ พร้อมใช้งาน:

ถาดข้อมูลคอนโทรล
มีคอนโทรล UI และคอนโทรลแบบกำหนดเองที่ใช้สำหรับการออกแบบ โครงร่างของ XPages และกำหนดวิธีการป้อนข้อมูลและเก็บ ในฐานข้อมูล คุณสามารถลากและปล่อยคอนโทรลจากถาดข้อมูล บน XPages ได้

ถาดข้อมูลนี้แอ็คทีฟเมื่อเอดิเตอร์ XPages แอ็คทีฟ, ตัวอย่างเช่น, ถ้าคุณกำลังแก้ไข XPage หรือคอนโทรลแบบกำหนดเอง ถาดข้อมูล มี drawers ของคอนโทรล UI: คอนโทรลแบบคอร์ และ คอนโทรลคอนเทนเนอร์ และยังมี drawer สำหรับคอนโทรลแบบกำหนดเอง หากคุณได้เพิ่มไปยังแอ็พพลิเคชัน IBM Domino Designer ปัจจุบัน

drawer คือบานหน้าต่างแบบฝังที่อนุญาตให้คุณเลื่อนผ่านอ็อพชัน โดยใช้ลูกศร ขึ้น และ ลง ที่จุดเริ่มต้นและสิ้นสุดของแต่ละ drawer

คุณยังสามารถทำสิ่งต่อไปนี้ กับถาดข้อมูลและ drawers:
  • เมื่อต้องการซ่อนถาดข้อมูล, ให้ปิดถาดข้อมูล
  • เมื่อต้องการเปลี่ยนคุณสมบัติถาดข้อมูล, ให้คลิกขวาและทำการเลือก
  • เมื่อต้องการขยายหรือยุบ drawer, ให้คลิกที่ drawer
ถาดข้อมูล
อนุญาตให้คุณดูแหล่งข้อมูลที่เชื่อมโยงกับ XPage หรือคอนโทรลที่เลือกไว้ในเอดิเตอร์ XPages เมื่อต้องการแสดงถาดข้อมูล, ให้คลิก หน้าต่าง > แสดงมุมมอง Eclipse > ถาดข้อมูล

โปรดระลึกถึงข้อมูล, ข้อจำกัด, และแนวทางต่อไปนี้ เมื่อคุณลากและปล่อยจากถาดข้อมูลคอนโทรลและถาดข้อมูล:

  • คุณสามารถเพิ่มคอนโทรลให้กับคอนโทรลคอนเทนเนอร์, ยกเว้น สำหรับพาเนลมุมมอง
  • ยกเว้นคอนโทรลลิงก์, คุณไม่สามารถเพิ่มคอนโทรลไปยัง คอนโทรลแบบคอร์ เนื่องจากคอนโทรลลิงก์สามารถมีชายด์ได้, ดังนั้น จึงทำหน้าที่คล้ายกับคอนโทรลคอนเทนเนอร์ ถ้าคุณพยายามเพิ่มคอนโทรล ให้กับคอนโทรลแบบคอร์, คอนโทรลใหม่จะถูกเพิ่มให้กับเพจที่อยู่เหนือ คอนโทรลที่มีอยู่
  • บนแท็บแหล่งที่มา, คุณสามารถทำให้คอนโทรลเป็นชายด์อันดับแรก หรือชายด์อันดับสุดท้ายของคอนเทนเนอร์โดยลากคอนโทรลไปยังแท็กเริ่มต้นหรือแท็กสิ้นสุดของ คอนเทนเนอร์, หรือโดยดับเบิลคลิกหรือใช้เมนู สร้าง พร้อมกับโฟกัสบนแท็กเริ่มต้นหรือแท็กสิ้นสุด
  • คุณสามารถเพิ่มคอนโทรลให้กับเซลล์ในตารางได้เท่านั้น, เพิ่มให้กับแถว หรือคอนเทนเนอร์ตารางไม่ได้
  • คุณสามารถเพิ่มคอนโทรลให้กับคอลัมน์ในตารางข้อมูล หากคุณสร้างคอนโทรล บนแท็บแหล่งที่มาแล้ว, คุณสามารถเพิ่มคอนโทรลคอนเทนเนอร์ ที่ถูกนิยามไว้เป็นส่วนหัวหรือส่วนท้ายตารางข้อมูล (หรือคอลัมน์ตารางข้อมูล) เมื่อต้องการนิยามคอนโทรลเป็นส่วนหัวหรือส่วนท้าย, ให้เพิ่มมคอนโทรลให้กับอิลิเมนต์ xp:this.facets ในตารางข้อมูลหรือคอลัมน์
  • คุณสามารถเพิ่มคอนโทรลให้กับแท็บในพาเนลที่แท็บไว้, ไม่ใช่เพิ่ม ให้กับพาเนลเอง
  • ถ้าคุณลากคอนโทรลไปยังแท็กสิ้นสุดของพาเนลที่แท็บไว้บนแท็บ แหล่งที่มา, หรือดับเบิลคลิกหรือใช้เมนู สร้าง ด้วยโฟกัสบนแท็กสิ้นสุด, คอนโทรลจะถูกเพิ่มให้กับแท็บสุดท้าย ในพาเนลที่แท็บแล้ว
  • คุณสามารถเพิ่มคอนโทรลให้กับคอนโทรลแบบกำหนดเองซึ่งได้เพิ่ม ให้กับ XPage เท่านั้นหากมีพื้นที่ที่สามารถแก้ไขได้ซึ่งกำหนดไว้สำหรับ คอนโทรลแบบกำหนดเอง ถ้าพื้นที่ที่สามารถแก้ไขได้มีชื่อ facet, คุณสามารถเพิ่มได้เพียง หนึ่งคอนโทรลเท่านั้น; ถ้าคุณลบชื่อ facet ออก, คุณสามารถเพิ่มคอนโทรลจำนวนมากได้
  • คุณไม่สามารถเพิ่มคอนโทรลให้กับคอนโทรลแบบกำหนดเองได้ซึ่งอยู่ติดกันภายใน คอนโทรลแบบกำหนดเองอื่นๆ
  • เมื่อคุณลากแหล่งข้อมูลจากถาดข้อมูลไปยังเอจ, คุณสามารถเรียงลำดับแหล่งที่มาใหม่ก่อนที่จะแทรกบนเพจได้ ที่ด้านบนของ ถาดข้อมูล, ให้คลิกไอคอน เลือกคอนโทรลและจากนั้นเลือก เลือกข้อมูลที่โยงกับคอนโทรล ใช้ปุ่มลูกศรเพื่อลากแหล่งข้อมูล ไปยังเพจ

คุณสามารถสร้างโปรไฟล์ถาดข้อมูล,คอนโทรลที่อนุญาตให้คุณเลือก คอนโทรลที่ปรากฏขึ้นตามลำดับบนถาดข้อมูลคอนโทรล คุณสามารถสร้าง โปรไฟล์ถาดข้อมูลจำนวนมาก, พร้อมกับโครงร่างถาดข้อมูลคอนโทรลที่แตกต่างกัน ซึ่งคุณสามารถสลับได้ เมื่อเข้าถึงค่าติดตั้งโปรไฟล์ถาดข้อมูล, ให้ไปที่ ไฟล์-การกำหนดค่าตามความชอบ-Domino Designer-ถาดข้อมูล รายการต่อไปนี้จัดเตรียมข้อมูลเพิ่มเติมเกี่ยวกับการใช้โปรไฟล์ ถาดข้อมูลคอนโทรล:

  • ตามค่าดีฟอลต์แล้ว, โปรไฟล์เริ่มต้นที่ชื่อ Profile1 ถูกสร้างขึ้น สิ่งนี้คือโปรไฟล์ที่มีสถานะปัจจุบันของถาดข้อมูล เมื่อ Designer ถูกเรียกทำงานในครั้งแรก ถ้าคุณได้ปรับเปลี่ยนถาดข้อมูล โดยใช้เพจ การกำหนดค่าตามความชอบให้กับถาดข้อมูล Designer เก่า, การเปลี่ยนแปลงเหล่านี้ จะมีผลต่อ Profile1 คุณสามารถเปลี่ยนชื่อและลบ Profile1 จากภายในส่วนติดต่อผู้ใช้โปรไฟล์ถาดข้อมูล
  • ส่วนติดต่อผู้ใช้มีรายการของโปรไฟล์และแผนผังที่แสดงคอนโทรล drawers และคอนโทรลใน drawers เหล่านั้น แผนผังแสดง โครงร่างของถาดข้อมูลสำหรับโปรไฟล์ที่เลือกไว้ในรายการของโปรไฟล์ คุณสามารถตรวจสอบคอนโทรล/drawers ที่คุณต้องการให้มองเห็นในถาดข้อมูล และยกเลิกการตรวจสอบสิ่งเหล่านั้นซึ่งคุณไม่ต้องการมองเห็น คุณยังสามารถย้ายคอนโทรลแต่ละตัว ภายใน drawer พาเรนต์แต่คุณไม่สามารถย้ายคอนโทรลระหว่าง drawers ได้
  • คุณยังสามารถเรียงลำดับ drawers ใหม่ได้ อย่างไรก็ตาม, การเรียงลำดับ drawers ใหม่ ของคอนโทรล, ไม่ได้รับการสนับสนุนโดยถาดข้อมูลคอนโทรลสำหรับ รีลีสนี้ คอนโทรลแบบกำหนดเองจะไม่ถูกแสดงในแผนผัง, และจะแสดงอยู่ในถาดข้อมูลคอนโทรลเสมอ
  • เมื่อคุณคลิก สร้างใหม่ เพื่อสร้างโปรไฟล์ใหม่, โครงสร้างถาดข้อมูลโปรไฟล์ใหม่จะอ้างอิงตามโปรไฟล์ที่เลือกไว้ในปัจจุบัน ในรายการของโปรไฟล์ ตามค่าดีฟอลต์ โปรไฟล์ที่แอ็คทีฟจะ ถูกเลือกไว้ในรายการของโปรไฟล์ เมื่อต้องการสลับโปรไฟล์, ให้เลือก โปรไฟล์ที่คุณต้องการเรียกใช้งานและคลิก "นำไปใช้" หรือ "ตกลง"
  • เมื่อต้องการเรียกคืนไฟล์ที่เลือกไว้ไปยังโปรไฟล์ดีฟอลต์, ให้คลิก เรียกคืนค่าดีฟอลต์ การเรียกคืนโปรไฟล์ดีฟอลต์ไม่ได้ลบโปรไฟล์ ที่สร้างขึ้น
  • ถ้าคุณลบโปรไฟล์ทั้งหมดในรายการของโปรไฟล์, Profile1 จะถูกสร้างขึ้นใหม่, ด้วยโครงร่างถาดข้อมูลที่ตรงกับโครงร่างดีฟอลต์

มุมมอง

มุมมองคือพาเนลใน Eclipse ที่อนุญาตให้คุณมองดูและทำงานกับ ลักษณะต่างๆ ของแอ็พพลิเคชันของคุณ มุมมองต่อไปนี้พร้อมใช้งาน:

มุมมองเหตุการณ์
อนุญาตให้คุณสร้างเหตุการณ์สำหรับ XPages, และคอนโทรล คุณสามารถใช้มุมมอง เหตุการณ์ เพื่อแนบแอ็คชันพื้นฐานหรือสคริปต์กับเหตุการณ์ เหตุการณ์ ถูกจัดการเป็นหมวดหมู่เพื่อให้ง่ายต่อการเข้าถึง

เมื่อเขียนสคริปต์, คุณสามารถสร้างเหตุการณ์ในฝั่งเซิร์ฟเวอร์หรือฝั่งไคลเอ็นต์ คุณสามารถระบุอ็อพชันสำหรับการอัพเดต XPages หลังจากที่เหตุการณ์เกิดขึ้น, ซึ่งรวมถึง การดำเนินการอัพเดตเป็นบางส่วนสำหรับส่วนของอิลิเมนต์ XPage ที่อ้างอิงตาม JavaScript แบบอะซิงโครนัสและเทคโนโลยี XML (AJAX)

เมื่อเขียนแอ็คชันพื้นฐาน, คุณสามารถ เขียนแอ็คชันที่ดำเนินการกับกิจกรรมที่โปรแกรมไว้ล่วงหน้าที่สามารถปรับเปลี่ยน ตามอาร์กิวเมนต์ คุณยังสามารถสร้างกลุ่มของแอ็คชันพื้นฐาน

มุมมองโครงร่าง
จัดเตรียมการแทนค่าเชิงลำดับชั้นของซอร์สโค้ด XML ใน XPages คุณสามารถคลิกบนโหนดเดี่ยวในมุมมองโครงร่าง เพื่อนำทางผ่าน XPage และอัพเดตคุณสมบัติในมุมมอง คุณสมบัติ คุณยังสามารถลากและปล่อยอิลิเมนต์เพื่อจัดเรียงส่วนใหม่อีกครั้ง และเปลี่ยนลำดับของอิลิเมนต์
มุมมองปัญหา
แสดงข้อผิดพลาด คำเตือน และข้อมูลอื่นๆ เกี่ยวกับรีซอร์ส IBM Domino Designer ข้อความเหล่านี้ ถูกสร้างขึ้นเมื่อคุณสร้างเวิร์กสเปซ Eclipse ตัวอย่างเช่น, ถ้าคุณบันทึก XPage ที่มีข้อผิดพลาดทางไวยากรณ์, มุมมองปัญหา จะแสดงข้อผิดพลาดเหล่านั้น
มุมมองคุณสมบัติ
อนุญาตให้คุณตั้งค่าคุณสมบัติสำหรับ XPages และคอนโทรล มุมมองคุณสมบัติ โต้ตอบกลับเอดิเตอร์ที่เปิดไว้ในปัจจุบัน ตัวอย่างเช่น, ถ้าคุณกำลังออกแบบ XPage, และคุณย้ายโฟกัสไปยังคอนโทรล UI ที่ระบุเฉพาะใน XPage, คุณสมบัติสำหรับคอนโทรล UI นั้นจะพร้อมใช้งาน ในมุมมองคุณสมบัติ

มุมมองคุณสมบัติอยู่ที่ด้านล่าง ของหน้าต่าง IBM Domino Designer และมีแต่ละแท็บ ที่คุณสามารถคลิกเพื่อแสดงชุดของตัวเลือก เนื่องจากแต่ละ XPage และคอนโทรล UI มีชุดของคุณสมบัติเฉพาะ, แท็บและอ็อพชันภายในแท็บเหล่านั้นเปลี่ยนแปลงตาม สิ่งที่เลือกไว้ในปัจจุบัน ตัวอย่างเช่น, เมื่อดูรายการของ XPages, ถ้าคุณคลิกชื่อของ XPage เดี่ยว, มุมมอง คุณสมบัติจะแสดงข้อมูลทั่วไปเกี่ยวกับ XPage, เช่น ชื่อของ XPage, ผู้เขียน, และวันที่สร้าง หากคุณดับเบิลคลิกที่ชื่อของ XPage XPage จะเปิดขึ้นในโหมดแก้ไขในเอดิเตอร์ XPages ของIBM Domino Designer และชุดของแท็บใหม่จะปรากฏในมุมมองคุณสมบัติ แท็บเหล่านี้จะเปลี่ยนไป ตามสิ่งที่เลือกไว้ในปัจจุบันในเอดิเตอร์, ตัวอย่างเช่น, XPage ทั้งหมดหรือคอนโทรล UI เดี่ยว

คุณสามารถย่อขนาดให้เล็กสุด, ขยายขนาดให้ใหญ่สุด, และเรียกคืนมุมมองด้วยปุ่มต่างๆ บน แถบหัวเรื่อง คุณสมบัติ คุณสามารถคลิกขวาบนแท็บคุณสมบัติเพื่อทำภารกิจ ต่อไปนี้ได้:
  • ซ่อนมุมมอง
  • ย่อขนาดมุมมองให้เล็กสุดหรือขยายขนาดมุมมองให้ใหญ่สุด
  • ถอดมุมมองเป็นหน้าต่างที่แยกต่างหาก
  • เรียกคืนมุมมองที่ย่อขนาดให้เล็กสุดหรือขยายขนาดให้ใหญ่สุด

การขอรับข้อมูล

รีซอร์สแบบทันทีสำหรับการขอรับข้อมูลคือ ระบบวิธีใช้ที่ติดตั้งไว้ รีซอร์สอื่นๆ ประกอบด้วย information center, วิกิ Domino Designer, และบทความ บนเว็บไซต์ที่หลากหลาย

เพื่อเข้าถึงวิธีใช้จาก Domino Designer หรือ Notes คลิก Help > Help Contents โดยปกติแล้ว การเข้าถึงที่ง่ายที่สุด คือการค้นหา นี่คือเคล็ดลับบางส่วน:
  • ป้อนคำแบบสมบูรณ์ ขนาดตัวพิมพ์ไม่ใช่ปัญหาแต่คำต้องเป็นคำแบบสมบูรณ์ ตัวอย่างเช่น, ถ้าคุณกำลังมองหาเมธอด createFTIndex, คุณสามารถป้อน createftindex แต่ createftinde จะล้มเหลว
  • ผลลัพธ์การค้นหาอาจแสดงหัวเรื่องซ้ำหรือหัวเรื่องที่คล้ายกัน, โดยเฉพาะอย่างยิ่งสำหรับหัวข้อที่อ้างถึง เมื่อคุณลอยเมาส์อยู่เหนือหัวเรื่อง, ป็อปอัพจะบอกคุณถึงชื่อ ของหนังสือ ข้อมูลนี้ยังปรากฏขึ้นบน บรรทัดสถานะ
  • ถ้าคุณกำลังใช้ส่วนของวิธีใช้บ่อย, คุณควรตั้งค่า ขอบเขตการค้นหาไว้ โปรดดูภารกิจที่อ้างถึง
การคลิก F1 แสดงระบบวิธีใช้ที่สมบูรณ์ใน บานหน้าต่างทางขวา สื่อประกอบบางส่วนคือข้อสรุปในเชิงลักษณะการทำงาน คุณสามารถนำทางเอกสารคู่มือที่สมบูรณ์กว่าโดยใช้ลิงก์หรือคลิก ค้นหา หรือ หัวข้อทั้งหมด ที่ด้านล่างของเพจ

วิธีใช้เดียวกันที่ติดตั้งในผลิตภัณฑ์จะมีอยู่ในศูนย์ข้อมูล Notes Domino ที่ http://publib.boulder.ibm.com/infocenter/domhelp/v8r0/index.jsp

ไปที่วิกิ Domino Designer ที่ http://www.lotus.com/ldd/ddwiki.nsf สำหรับบทความ ฟอรัม และข้อมูลเพิ่มเติม คุณสามารถติดประกาศกับ วิกินี้

ใช้ Google หรือผลิตภัณฑ์เว็บอื่นๆ เพื่อขยายการค้นหาของคุณ ที่ใกล้เคียงกับวิธีใช้ เขียนบทนำเคียวรีการค้นหาของคุณด้วย domino designer ตัวอย่างเช่น, เพื่อขอรับข้อมูลเกี่ยวกับเมธอด createFTIndex, คุณอาจป้อน domino designer createftindex เป็นเคียวรีการค้นหา

สำหรับคำแนะนำที่ส่งมอบไปยัง XPages, ให้ใช้บทเรียนใน วิธีใช้นี้ บทเรียนใช้เท็มเพลตระดับสูงที่มีชื่อว่า Site finder demo

การตั้งค่าขอบเขตการค้นหา

ขอบเขตการค้นหาจำกัดหัวข้อวิธีใช้ที่ถูกค้นหา

เกี่ยวกับภารกิจนี้

ตามค่าดีฟอลต์, การค้นหาใช้กับหัวข้อทั้งหมดในวิธีใช้ ให้ใช้ขั้นตอนต่อไปนี้ เพื่อสร้างขอบเขตที่กำหนดชื่อไว้ซึ่งจำกัดการค้นหา หัวข้อที่ระบุเฉพาะ

กระบวนการ

  1. บนหน้าต่างการค้นหา, ให้คลิก ขอบเขตการค้นหา
  2. ในไดอะล็อก Select Search Scope, เลือก Search only the following topics และคลิก สร้างใหม่
  3. ในไดอะล็อก New Search List, ให้ป้อน ชื่อสำหรับการค้นหา
  4. ตรวจสอบส่วนของวิธีใช้ที่คุณต้องการค้นหา คุณสามารถ ตรวจสอบหัวข้อที่ระดับเริ่มต้นและระดับหนึ่งด้านล่าง
  5. คลิก ตกลง เพื่อบันทึกขอบเขต และปิดไดอะล็อก New Search List

    ขอบเขต ใหม่ปรากฏขึ้นในรายการของขอบเขตเมื่อเลือก Search only the following topics

    คุณสามารถสร้างขอบเขต อื่นๆ ได้

    คุณสามารถแก้ไขหรือถอนขอบเขตที่เลือกไว้ได้

  6. คลิก ตกลง เพื่อปิดไดอะล็อก Select Search Scope
  7. ขอบเขตที่มีผลกระทบจะปรากฏขึ้นถัดจาก ขอบเขตการค้นหา หากต้องการเปลี่ยนขอบเขต:
    1. คลิก ขอบเขตการค้นหา ให้เปิดไดอะล็อก Select Search Scope
    2. เลือก Search only the following topics จากนั้นเลือกขอบเขต, หรือเลือก Search all topics
    3. คลิก ตกลง

ตัวอย่าง

ตัวอย่างเช่น, เมื่อต้องการสร้างขอบเขตการค้นหาสำหรับหัวข้อ Domino Designer เท่านั้น: ในไดอะล็อก New Search List, ให้ตั้งชื่อขอบเขต Designer และตรวจสอบหัวข้อระดับบนทั้งหมดที่ขึ้นต้นด้วย Lotus Domino Designer

ความสามารถในการเข้าถึงและช็อตคัตคีย์บอร์ด

IBM Domino Designer สามารถเข้าถึงผู้คนด้วย ความท้าทายทางกายภาพ ความท้าทายเหล่านั้นซึ่งมีความเคลื่อนไหวที่จำกัด หรือการมองเห็นที่จำกัดสามารถใช้คีย์บอร์ดช็อตคัตพิเศษในรูปของความช่วยเหลือ

ช็อตคัตคีย์บอร์ดเหล่านี้ อนุญาตให้คุณนำทางและดำเนินการกับภารกิจที่หลากหลายใน Designer สำหรับข้อมูลเพิ่มเติม โปรดดูที่ส่วน "Accessibility and keyboard shortcuts" ของคู่มือการใช้งานและการอ้างอิง Domino Designer Basic User ในระบบวิธีใช้ของผลิตภัณฑ์ ที่นั่น คุณจะค้นหาหัวข้อที่หลากหลายบนช็อตคัตคีย์บอร์ดที่เกี่ยวข้องกับภารกิจ

สามารถพบรุ่นที่สามารถเข้าถึงได้ของ วิธีใช้ผลิตภัณฑ์ที่สมบูรณ์ในศูนย์ข้อมูล IBM Notes และ Domino ที่ http://publib.boulder.ibm.com/infocenter/domhelp/v8r0/index.jsp

ยังสามารถพบ ข้อมูลเพิ่มเติมในหัวข้อ "Customizing Notes for Accessibility" ใน Notes Help หากวิธีใช้ไม่ถูก ติดตั้งไว้ คุณยังสามารถไปที่ไลบรารีเอกสารของ IBM Developer Domain ที่ http://www.lotus.com/ldd/doc เพื่อดาวน์โหลด หรือดูวิธีใช้ของ Notes

ท้ายสุด, เว็บไซต์ IBM Special Needs มีอยู่ที่ http://www.ibm.com/able

บทเรียน

ส่วนนี้มีบทบเรียนและข้อมูลเกี่ยวกับบทเรียน

บทเรียนที่พร้อมใช้งานในส่วนนี้คือ XPages Site Finder โปรดอ้างถึงส่วนที่เหลือของหัวข้อใน ส่วนนี้สำหรับข้อมูลเพิ่มเติม

บทเรียนเกี่ยวกับตัวค้นหาไซต์ XPages

บทเรียนนี้สาธิตวิธีที่คุณสามารถ สร้างแอ็พพลิเคชันเว็บใน IBM Domino Designer โดยใช้อิลีเมนต์ XPage ได้อย่างง่ายๆ การใช้ บทเรียนนี้คุณสร้างและแสดงตัวอย่างสาม XPages คุณวางคอนโทรลบน XPages สำหรับการเข้าถึงและการดูข้อมูล, การนำทางไปยังเพจอื่น, การรีเฟรชเพจเดียวกัน, และการดำเนินการกับแอ็คชันอื่น คุณจะ ใช้ JavaScript

ความคุ้นเคยกับ Domino Designer และอิลีเมนต์การออกแบบแบบดั้งเดิมเป็นสิ่งที่มีประโยชน์แต่ไม่จำเป็น อิลิเมนต์การออกแบบและกราฟิก บางส่วนที่อยู่ภายนอกขอบเขตที่คุณได้เรียนรู้ จะถูกโหลดก่อน สำหรับสิ่งที่ใหม่ต่อ Eclipse, การนำทางในDomino Designer จัดเตรียมบทนำที่ดี

โปรแกรมสาธิต, ที่เรียกว่า Site Finder Demo, คือเท็มเพลตระดับสูงที่จัดส่งพร้อมกับ Domino Designer ซึ่งจะคล้ายกับเครื่องมือ บนเว็บไซต์จำนวนมากเพื่อค้นหาตำแหน่งที่ใกล้เคียง คุณส่งรหัสไปรษณีย์หรือที่อยู่ และเซิร์ฟเวอร์ส่งคืนการจับคู่ตำแหน่ง ในบทเรียนนี้, คุณพัฒนา เว็บเพจสำหรับการทำการส่ง, และเพจอื่นๆ สำหรับการสร้าง และการแก้ไขเอกสารไซต์

สำหรับเหตุผลด้านความเรียบง่าย, การเข้าถึงไม่ได้ถูกจำกัดไว้ บุคคลใดๆ สามารถสร้างและแก้ไขเอกสาร การเข้าถึงนี้ อนุญาตให้คุณแสดงตัวอย่างคุณลักษณะ XPage โดยไม่ต้องติดตั้งเซิร์ฟเวอร์ สำหรับแอ็พพลิเคชันจริง, คุณต้องการจำกัดการเข้าถึง, ซึ่งง่ายต่อการทำ ผ่านรายการคอนโทรลการเข้าถึง (ACL) จากเมนู, ให้คลิก ไฟล์ > แอ็พพลิเคชัน > คอนโทรล การเข้าถึง

กลไกการค้นหาใน โปรแกรมสาธิตเป็นกลไกธรรมดา, อ้างอิงตามการจับคู่ที่ตรงกัน ในแอ็พพลิเคชันจริง, คุณอาจต้องการกลไกที่มีความเชี่ยวชาญมากขึ้น

เอกสารนี้ อ้างถึงผลิตภัณฑ์ดังต่อไปนี้: IBM Domino, IBM Domino Designer, IBM Notes, IBM iNotes, and IBM Notes Traveler

วัตถุประสงค์ของการเรียนรู้

  • การติดตั้งและดูแอ็พพลิเคชันที่มีอิลิเมนต์ XPage
  • สร้าง XPage
  • เพิ่มคอนโทรลไปยัง XPage
  • โยงข้อมูลไปยัง XPage
  • เพิ่มการนำทางไปยัง XPage
  • สร้างคอนโทรลแบบกำหนดเอง
  • ใช้การโยงและการสร้างสคริปต์ระดับสูง

เวลาที่ต้องการ

บทเรียนนี้ใช้เวลาประมาณ 90 นาทีเพื่อทำให้เสร็จสิ้น

การตั้งค่าแอ็พพลิเคชันตัวอย่าง

ในระหว่างคอร์สของบทเรียน, คุณสร้างสาม XPages ที่ชื่อ Site, SiteFinder, และ SiteList เมื่อคุณเปิดแอ็พพลิเคชันตัวอย่างในครั้งแรก, คุณมองเห็น XPages ที่มีอยู่ซึ่งมีชื่อที่คล้ายกัน สามชื่อนั้น คือโซลูชันสุดท้ายและมีชื่อว่า SiteFinal, SiteFinderFinal, และ SiteListFinal สองชื่อคือโซลูชันระดับกลาง ที่มีชื่อว่า Site1 และ SiteList1

เรียกใช้ IBM Domino Designer และทำตามขั้นตอน ดังต่อไปนี้:
  1. จากเมนู, คลิก ไฟล์ > แอ็พพลิเคชัน > สร้าง (Ctrl+N)
  2. ในหน้าต่าง สร้างแอ็พพลิเคชัน, ให้ทำตามขั้นตอนต่อไปนี้:
    1. ปล่อยให้การเลือกเซิร์ฟเวอร์เป็น Local
    2. พิมพ์หัวเรื่อง, ตัวอย่างเช่น, Site Finder Demo
    3. ยอมรับและปรับเปลี่ยนชื่อไฟล์, ตัวอย่างเช่น, SiteFinderDemo.nsf
    4. ทางเลือก: คลิก การเข้ารหัส เลือก ห้ามเข้ารหัสฐานข้อมูลนี้แบบโลคัล และคลิก ตกลง

      ขั้นตอนนี้อนุญาตให้ ผู้ใช้ Notes อื่นๆ สามารถเข้าถึง แอ็พพลิเคชันภายในโลคัล ตัวอย่างเช่น หากคุณส่งเมลไปหาใครบางคน โดยทั่วไป, คุณควรเข้ารหัส แอ็พพลิเคชันจริงเพื่อป้องกันความปลอดภัย การเข้ารหัสแบบโลคัลไม่ได้ปกป้อง แอ็พพลิเคชันจากการแบ่งใช้ผ่านการเรพลิเคตไปยังเซิร์ฟเวอร์

    5. เลือก สร้างดัชนีข้อความแบบเต็มสำหรับการค้นหา คุณอาจต้องการในภายหลัง
    6. ปล่อยให้เท็มเพลตการเลือกเซิร์ฟเวอร์เป็น โลคัล
    7. เลือก แสดงเท็มเพลตระดับสูง
    8. ในรายการเท็มเพลต, ให้เลือก Site Finder Demo
    9. เคลียร์ สืบทอดการเปลี่ยนแปลงการออกแบบในอนาคต
    ที่นี่คือสิ่งที่หน้าต่าง สร้างแอ็พพลิเคชัน ควรมีลักษณะที่คล้ายคลึง

    หน้าต่างสร้างแอ็พพลิเคชัน

  3. คลิก ตกลง

    Domino Designer สร้าง แอ็พพลิเคชันใหม่ และอิลีเมนต์จะแสดงอยู่ภายใต้ Applications ทางด้านซ้ายของหน้าจอ ขยายอิลิเมนต์เพื่อสำรวจการออกแบบ แอ็พพลิเคชันนี้

  4. ขยาย โค้ด และดับเบิลคลิก เอเจนต์ ในรายการของเอเจนต์, ให้คลิกขวาที่ สร้างข้อมูลตัวอย่าง และเลือก รัน

    เอเจนต์นี้ สร้างเร็กคอร์ดตัวอย่างต่างๆ ที่คุณใช้ทดสอบแอ็พพลิเคชัน ตอบกลับไปยังไดอะล็อกบ็อกซ์ใดๆ คลิก X ที่มุมเพื่อปิดบานหน้าต่างที่มีรายการของเอเจนต์

  5. ขยาย XPages และดับเบิลคลิก SiteFinderFinal (โซลูชัน สุดท้ายสำหรับ SiteFinder)
  6. คลิก ออกแบบ > แสดงตัวอย่างในเว็บเบราว์เซอร์ > ระบบเว็บเบราว์เซอร์ดีฟอลต์ หรือเลือกเบราว์เซอร์ที่ระบุเฉพาะจากรายการเหล่านั้น

    เว็บเซิร์ฟเวอร์ขนาดเล็กที่รันอยู่บนคอมพิวเตอร์ของคุณ เปิดเบราว์เซอร์, สร้าง HTML สำหรับ XPage, และส่งเพจไปยังเบราว์เซอร์ โดยใช้ localhost สำหรับชื่อเซิร์ฟเวอร์

    ถ้าคอมพิวเตอร์ของคุณ ไม่ได้ตั้งค่าให้ใช้ localhost, การแสดงตัวอย่าง URL จะล้มเหลว เปิดเบราว์เซอร์ และใช้ 127.0.0.1 หรือ IP address จริงของ คอมพิวเตอร์ของคุณใน URL, ตัวอย่างเช่น, http://127.0.0.1/SiteFinderDemo.nsf/SiteFinderFinal.xsp

  7. ระบุค่าในฟิลด์ รหัสไปรษณีย์ (ตัวอย่างเช่น, 02108) และคลิก ค้นหา

    ขั้นตอนนี้ส่งเพจไปยังเซิร์ฟเวอร์ เซิร์ฟเวอร์ ประมวลผลข้อมูลจากเพจและส่งเพจอื่นไปยัง ไคลเอ็นต์

  8. ปิดเบราว์เซอร์เมื่อคุณทำเสร็จสิ้น
  9. ในDomino Designer ให้ปิดอิลีเมนต์ XPage โดยการคลิก X บน แท็บ

    ลักษณะที่ปรากฏจะแตกต่างกันไป ถ้าบานหน้าต่างมีมากกว่าหนึ่งแท็บ, คุณจะมองเห็น X บนแท็บ ถ้าบานหน้าต่างมีเพียง หนึ่งแท็บ, บานหน้าต่างนั้นจะแสดงเป็นหน้าต่างที่มี X ในมุม

คุณสามารถสำรวจแอ็พพลิเคชันได้อย่างอิสระโดยแสดงตัวอย่าง XPages ด้วย Final ในชื่อ XPages เหล่านี้คือเวอร์ชันสุดท้ายของสิ่งที่คุณ กำลังออกแบบตามที่คุณเดินผ่านบทเรียน

การสร้าง XPage

บทเรียนนี้สอนให้คุณสร้าง XPage ระดับต้น

บทเรียนนี้ใช้หนึ่งแบบฟอร์มและหนึ่งมุมมอง, แต่ไม่พาคุณ ไปยังแบบฝึกหัดของการสร้างแบบฝึกหัดเหล่านั้น แบบฟอร์มไซต์ มีฟิลด์สำหรับการเก็บข้อมูลไซต์และเงื่อนไขการค้นหา, และมุมมอง SiteList ถูกใช้สำหรับการแสดงรายการไซต์ และผลลัพธ์การค้นหา ให้ดูอย่างรวดเร็ว สำหรับเอกสารเกี่ยวกับ ฟอร์ม และมุมมอง โปรดดูที่คู่มือการใช้งานและการอ้างอิงDomino Designer Basic ในวิธีใช้
  • แบบฟอร์มถูกใช้โดย XPages เพื่อนิยามข้อมูลที่เก็บอยู่ในเอกสาร, ไม่ใช่วิธีการแสดง นิยามนี้ดูคล้ายกับการใช้ฟิลด์ที่ซ่อนไว้ บนแบบฟอร์มการแสดงผลเพื่อจัดการและคำนวณข้อมูล แบบฟอร์มไซต์ มีฟิลด์ข้อมูลสำหรับการสร้างเอกสาร, และ ข้อความอธิบายบางอย่าง ผู้ใช้ไม่เคยเห็นสิ่งนี้, ดังนั้นโครงร่างจึงไม่เป็นปัญหา
  • มุมมองถูกใช้โดย XPages เพื่อนิยามคอลเล็กชันของเอกสาร และการเรียงลำดับ มากเท่ากับที่คุณอาจใช้มุมมองเพื่อสร้างดัชนี ข้อมูลบางอย่าง ดังนั้น จึงสามารถแสดงข้อมูลในเชิงโปรแกรมได้, มุมมอง SiteList ใช้เป็นดัชนีกับเอกสารข้อมูลของคุณ ซึ่งแสดงรายการเนื้อหาของ เอกสารทั้งหมดที่เรียงลำดับตามชื่อไซต์ มุมมองเป็นวิธีการจัดการเอกสาร ที่มีประสิทธิภาพ, และมีมุมมองต่างๆ ที่แสดง ชุดย่อยและการเรียงลำดับที่แตกต่างกัน

ตรวจสอบให้แน่ใจว่าแอ็พพลิเคชันถูกขยาย และทำตามขั้นตอนต่อไปนี้:

  1. ดับเบิลคลิก XPages

    แอ็คชันนี้ แสดงรายการของอิลิเมนต์ XPage ในบานหน้าต่างกลาง

  2. คลิก สร้าง XPage
  3. ตั้งชื่อ XPage SiteList ใหม่ของคุณ (ส่วนขยาย .xsp ถูกสมมติไว้และเพิ่มไว้เป็นแบบอัตโนมัติ)

    คุณสามารถใช้ช่องว่าง ในชื่อแต่ชื่อจะเป็นตัวล้างข้อมูลเมื่อคุณไม่ต้องการ

  4. คลิก ตกลง อิลิเมนต์การออกแบบ XPage ที่ว่างจะถูกสร้างขึ้นในบานหน้าต่างกลาง
  5. วางกราฟิกส่วนหัวไว้บนเพจ:
    1. จาก คอนโทรลแบบคอร์, ให้เลือกและลาก Image ลงบน XPage หน้าต่าง เลือกอิมเมจ จะปรากฏขึ้น
    2. เลือก xpTitlebarLeft_ren.gif

      หน้าต่าง เลือกอิมเมจ ดูคล้ายกับการดักจับหน้าจอ

      หน้าต่าง เลือกอิมเมจ

    3. คลิก ตกลง

    อิมเมจที่คุณมองเห็นในการดักจับหน้าจอ ถูกโหลดไว้ก่อน แต่ละอิมเมจที่คุณมองเห็นบนรายการคือรีซอร์สใน ฐานข้อมูลปัจจุบัน ปุ่ม เพิ่ม อนุญาตให้คุณ อิมพอร์ตอิมเมจเพิ่มเติม (และมีหลายวิธีที่ใช้อิมพอร์ตข้อมูล)

    หลังจากที่ คุณคลิก ตกลง, อิมเมจควรแสดงเป็น ส่วนหัว

  6. คลิกในพื้นที่ว่างทางด้านซ้ายของอิมเมจส่วนหัว, หรือกดลูกศร ขวา เพื่อย้ายในทิศทางนั้น คุณอาจเลื่อนในทิศทางนั้นถ้าพื้นที่ว่างไม่สามารถมองเห็นได้ กด Enter เพื่อเคอร์เซอร์ไปยัง บรรทัดถัดไป
  7. ป้อนข้อความส่วนหัวบางส่วน:
    1. บน XPage, คลิกบรรทัดว่างที่อยู่ด้านล่างส่วนหัว
    2. พิมพ์ รายการไซต์ และกด Enter
    3. ไฮไลต์บรรทัดของข้อความ
    4. ในบานหน้าต่างด้านล่าง, ให้คลิก ฟอนต์ และเปลี่ยนฟอนต์ตามที่คุณต้องการ, ตัวอย่างเช่น, ตัวหนา 14 สีน้ำเงิน
    ในภายหลัง คุณจะเพิ่มสไตล์ชีตและใช้กับข้อความนี้ ซึ่งเป็นทางเลือกในการคอนโทรลการจัดรูปแบบ
การออกแบบสำหรับ XPage ของคุณดูคล้ายกับการดักจับหน้าจอนี้:

SiteList XPage

ผู้พัฒนาเว็บที่มีประสบการณ์อาจต้องการใช้อิลิเมนต์ ที่จัดโครงสร้างเอกสารไว้, เช่น H1 และ H2 การออกแบบส่วนติดต่อผู้ใช้ไม่สนับสนุนโครงสร้างนี้, แต่ส่วนติดต่อผู้ใช้ต้นทางอนุญาตให้คุณป้อน XML ตามที่คุณต้องการ คลิกแท็บ แหล่งที่มา เพื่อดูและแก้ไขเพจเป็น XML คลิกแท็บ การออกแบบ เพื่อกลับสู่บทเรียน

การเพิ่มคอนโทรลมุมมอง

คอนโทรลมุมมอง XPage ถูกใช้เพื่อแสดงข้อมูล จากมุมมองที่นิยามไว้ คอนโทรลที่คุณสร้างในบทเรียนนี้ อนุญาตให้คุณแสดงข้อมูลจากมุมมอง SiteList

ตรวจสอบให้แน่ใจว่า SiteList XPage เปิดอยู่ในบานหน้าต่างกลาง และทำตามขั้นตอนต่อไปนี้:
  1. จาก คอนโทรลคอนเทนเนอร์, ให้เลือกและลาก มุมมอง ลงบน XPage
  2. ในหน้าต่าง เลือกแหล่งข้อมูลสำหรับมุมมอง:
    1. ปล่อยให้ แสดงข้อมูลจาก ตั้งค่าเป็น มุมมอง Domino
    2. ปล่อยให้ แอ็พพลิเคชัน ตั้งค่าเป็น ปัจจุบัน

      คุณสามารถเลือกแอ็พพลิเคชันDomino ใดๆ แต่คอนโทรลมุมมองจะไม่ทำงานนอกจากว่าแอ็พพลิเคชันจะมีอยู่ บนเซิร์ฟเวอร์รันไทม์

    3. ในรายการดร็อปดาวน์ มุมมอง, ให้เลือก SiteList
    4. ยอมรับ view1 เป็นชื่อแหล่งข้อมูล

      ชื่อนี้ สามารถใช้ในโค้ด JavaScript ฝั่งเซิร์ฟเวอร์

    5. ในรายการคอลัมน์ในส่วนท้าย, ให้ปล่อยให้ SiteName, StreetAddress, City, และ SiteType ถูกเลือกไว้

    หน้าต่างจะดูคล้ายกับการดักจับหน้าจอนี้

    เลือกแหล่งข้อมูลสำหรับ หน้าต่างมุมมอง

  3. คลิก ตกลง

    ตาราง ที่แทนค่ามุมมองจะแสดงขึ้น สี่คอลัมน์แทนค่าคอลัมน์มุมมอง, และสองแถวแทนค่าหัวเรื่องคอลัมน์และ เนื้อหาคอลัมน์ แถวแรกมีคอนโทรลเพจเจอร์ที่อนุญาตให้ผู้ใช้ นำทางผ่านข้อมูลในมุมมอง

  4. ปรับคอนโทรลมุมมอง:
    1. เมื่อต้องการปรับขนาดคอลัมน์, ให้เลือกทั้งแถวในหนึ่งคอลัมน์ โดยคลิกเซลล์ในแถวแรกและกดปุ่ม Shift ขณะที่คลิกเซลล์ที่สอง, จากนั้นลากตัวจัดการบนเซลล์
    2. เลือกแถวส่วนหัวทั้งหมดโดยคลิกที่เซลล์แรก และกดปุ่ม Shift ขณะคลิก บนเซลล์ที่เหลืออยู่ในแถว กด Ctrl+B หรือใช้คุณสมบัติฟอนต์ เพื่อทำให้เซลล์เหล่านี้เป็นตัวหนา
  5. อนุญาตให้ผู้ใช้เปิดเอกสารเมื่อคลิกใน คอลัมน์แรกของคอนโทรลมุมมอง:
    1. คลิกภายในเซลล์ด้านซ้ายที่ส่วนท้าย (SiteName)
    2. บนแท็บ คุณสมบัติ ในบานหน้าต่างด้านล่าง, ให้คลิก แสดง
    3. เลือก แสดงค่าในคอลัมน์นี้เป็นลิงก์

    เพจจะดูคล้ายกับการดักจับหน้าจอนี้

    SiteList XPage ที่มีคอนโทรลมุมมอง

  6. ลิงก์คอนโทรลมุมมองกับเพจการแก้ไข
    1. คลิกคอนโทรลมุมมองเพื่อให้มุมมองทั้งหมดอยู่ใน โฟกัส
    2. บนแท็บ คุณสมบัติ ในบานหน้าต่างด้านล่าง, ให้คลิก มุมมอง
    3. จากรายการดร็อปดาวน์ ณ รันไทม์, ให้เปิดเอกสารที่เลือกไว้ โดยใช้ รายการดร็อปดาวน์ที่ส่วนท้าย, ให้เลือก Site1
  7. บันทึกและแสดงตัวอย่างเพจ
    1. คลิก XPage จริงดังนั้นโฟกัสจึง อยู่บนเพจ

      อีกวิธีหนึ่งในการวางโฟกัสบนเพจ คือ คลิก โครงร่าง > เอกสารราก > XPage ในบานหน้าต่างด้านข้าง แอ็คชันนี้วางโฟกัสอยู่บนเพจ คุณสามารถวาง โฟกัสบนอิลิเมนต์การออกแบบเฉพาะบนเพจโดยคลิก อิลิเมนต์ที่สอดคล้องกันในโครงร่าง

    2. กด Ctrl+S เพื่อบันทึกเพจ
    3. คลิก ออกแบบ > แสดงตัวอย่างในเว็บเบราว์เซอร์ > ระบบเว็บเบราว์เซอร์ดีฟอลต์ หรือเบราว์เซอร์ของตัวเลือกของคุณ คลิกเอกสารในรายการ ซึ่งจะเปิดขึ้นด้วย Site XPage คุณสามารถทำการเปลี่ยนแปลงเอกสารจากหน้าต่างนี้และคลิก ส่ง เพื่อบันทึกการเปลี่ยนแปลง การส่งเพจไม่ได้ย้ายคุณออกจากเพจนั้น, และคุณดำเนินการแก้ไขและบันทึกเอกสารเดียวกัน
      มีหลายวิธี ในการบันทึกการเปลี่ยนแปลงและรีเฟรชเบราว์เซอร์:
      • ปุ่ม ส่ง ที่คุณใช้ในบทเรียนนี้ อัพเดตแหล่งข้อมูลและรีเฟรชเพจ
      • ปุ่ม ปุ่ม อนุญาตให้คุณพ่วงต่อกับ แอ็คชันพื้นฐานหรือ JavaScript ไปยังเหตุการณ์ onclick ใช้เหตุการณ์นี้เพื่ออัพเดตแหล่งข้อมูลและเปลี่ยนทิศทางผู้ใช้ ไปยังเพจอื่นๆ
      • เหตุการณ์เพจอนุญาตให้คุณพ่วงต่อแอ็คชันพื้นฐานหรือ JavaScript ไปยังเหตุการณ์ postSaveDocument คุณสามารถวางปุ่ม ส่ง บนเพจและในเหตุการณ์ postSaveDocument จะเปลี่ยนทิศทางผู้ใช้ไปยังเพจอื่น

      XPage ของคุณจะคล้ายกับ SiteList1, ซึ่งคุณสามารถเปิดเพื่อเปรียบเทียบได้

  8. ปิดเบราว์เซอร์

การสร้าง XPage สำหรับการแก้ไข

แบบฟอร์มยังสามารถใช้เพื่อออกแบบเว็บเพจ, แต่ XPages อนุญาตให้ใช้อ็อพชัน UI เพิ่มเติมและคอนโทรลของลักษณะที่ปรากฏที่มากกว่า ด้วยการสนับสนุนที่น้อยกว่า สิ่งนี้มีประโยชน์และยังมีแบบฟอร์มที่จัดเตรียมรายการของฟิลด์ สำหรับการโยงข้อมูล และแบบฟอร์มสามารถใช้เพื่อคำนวณฟิลด์ที่คำนวณแล้ว ด้วยสูตรฟิลด์แทนที่จะวางโค้ดบน XPage

ในบทเรียนนี้, คุณจะเรียนรู้ถึงวิธีการเพิ่มข้อความไปยังเพจ, เพิ่มคอนโทรลไปยังเพจ, ปรับลักษณะที่ปรากฏของเพจด้วยสไตล์ชีต, และโยงแหล่งข้อมูลไปยังเพจ มีหลายขั้นตอน แต่ใช้ขั้นตอนเหล่านั้นแค่เพียงครั้งเดียว

ทำสิ่งต่อไปนี้:

  1. ที่จุดเริ่มต้นของรายการของ XPages, ให้คลิก สร้าง XPage หรือ, คุณสามารถคลิกขวาที่ XPages > สร้าง XPage
  2. ตั้งชื่อ XPage Site ใหม่ของคุณและคลิก ตกลง XPage และชื่อแบบฟอร์มไม่ใช่สิ่งเดียวกัน, แต่เป็น การฝึกปฏิบัติที่ดี การกำหนดข้อมูลเหล่านี้ด้วยชื่อเดียวกันจะเปิดใช้ลักษณะการทำงานแบบอัตโนมัติบางอย่าง ที่ใกล้เคียงกับขอบเขตของบทเรียนนี้
  3. เพิ่มสไตล์ชีตให้กับเพจต่อไปนี้:
    1. ในบานหน้าต่างส่วนท้าย, ให้คลิก ลักษณะ
    2. เลื่อนไปยังส่วนท้ายและคลิก เพิ่มสไตล์ชีต ไปยังเพจ
    3. ในกล่อง Add Style Sheet to Page, ให้เลือก styles.css
    4. คลิก ตกลง
    ไฟล์ CSS เหล่านี้คืออิลิเมนต์การออกแบบสไตล์ชีตที่รวม ในแอ็พพลิเคชันตัวอย่าง
  4. เพิ่มหัวเรื่องสำหรับพจและสไตล์ดังต่อไปนี้:
    1. บน XPage, ให้พิมพ์หัวเรื่องสำหรับเพจ, ตัวอย่างเช่น, Site Description และกด Enter
    2. ไฮไลต์ข้อความ
    3. บนหน้าต่างที่อยู่เกือบท้ายสุด, ให้คลิก ลักษณะ หากคุณยังไม่ได้ทำ
    4. ในรายการภายใต้ styles.css, ให้คลิก .title
    ลักษณะที่ปรากฏขึ้นของข้อความจะเปลี่ยนไปเพื่อแปลงเป็น ลักษณะที่เลือกไว้
  5. เชื่อมโยง (โยง) XPage ด้วยที่เก็บข้อมูลส่วนหลังของ Domino ดังต่อไปนี้:
    1. คลิกภายนอกข้อความบน XPage ดังนั้น โฟกัสจะอยู่บน เพจ
    2. บนบานหน้าต่างด้านล่างภายใต้ Properties, ให้คคลิก ข้อมูล
    3. คลิก เพิ่ม และเลือก Domino Document

      แหล่งข้อมูลที่ชื่อ document1 จะปรากฏขึ้น

    4. บนฝั่งของบานหน้าต่าง, ให้ค้นหา Form และเลือก Site จากรายการดร็อปดาวน์

      สิ่งนี้ จะเชื่อมโยง XPage ด้วยนิยามข้อมูลบนแบบฟอร์ม Site

  6. ตั้งค่าถาดข้อมูลดังต่อไปนี้:
    1. บนด้านล่างของบานหน้าต่าง, ให้คลิกลิงก์ ถาดข้อมูล แท็บ ข้อมูล จะปรากฏขึ้นในบานหน้าต่างด้านข้าง คุณยังสามารถแสดงแท็บข้อมูลโดยคลิก หน้าต่าง > แสดงมุมมอง Eclipse > ข้อมูล
    2. บนแท็บ Data, ให้เลือก document1 สำหรับ Data source คุณอาจต้องวางโฟกัสบน XPage ก่อนที่แหล่งข้อมูลใหม่ จะปรากฏขึ้นบนถาดข้อมูล

      ชื่อฟิลด์ และชนิดสำหรับแหล่งข้อมูลจะปรากฏขึ้นภายใต้ชื่อของ แหล่งข้อมูล

    3. บนมุมบนซ้ายของแท็บ Data, ให้คลิกไอคอนสำหรับ ไดอะล็อกเลือกคอนโทรล เพื่อเปิดใช้งาน

      ไอคอนสำหรับ ไดอะล็อกบ็อกซ์ เลือกคอนโทรล จะดูคล้ายกับสิ่งนี้:

  7. เลือกและลากฟิลด์ทั้งหมดจากถาดข้อมูลไปยัง XPage ภายใต้หัวเรื่อง

    ไดอะล็อกบ็อกซ์ Select Data Bound Controls จะเปิดขึ้น

  8. กรอกข้อมูลลงในไดอะล็อกบ็อกซ์ดังต่อไปนี้:
    1. ปล่อยให้เช็กบ็อกซ์ทั้งหมดถูกทำเครื่องหมายไว้ซึ่งพูดได้ว่า คุณต้องการที่จะรวมฟิลด์ทั้งหมด
    2. ปล่อยให้ข้อความเลเบลทั้งหมดเป็นไปตามสภาพ
    3. เปลี่ยนชนิดคอนโทรลสำหรับ Site type ไปยัง Combo Box โดยเลือกชนิดและใช้เมนูดร็อปดาวน์
    4. เปลี่ยนชนิดคอนโทรลสำหรับ Amenities ไปยัง List Box
    5. เปลี่ยนชนิดคอนโทรลสำหรับ Directions ไปยัง Multiline Edit Box
    6. ทำเครื่องหมายที่ Add Submit button to generated code
    7. ทำเครื่องหมายที่ Add messages control to generated code

    ไดอะล็อกบ็อกซ์ควรดูคล้ายกับสิ่งนี้

    ไดอะล็อกบ็อกซ์ เลือกข้อมูลที่โยงกับคอนโทรล

  9. คลิก ตกลง

    สิ่งนี้ จะสร้างตารางสองคอลัมน์ที่มีเลเบลในคอลัมน์แรก และคอนโทรลในคอลัมน์ที่สอง คอลัมน์ที่สองยังมีพื้นที่ที่ต้องแสดง ข้อผิดพลาดในการตรวจสอบความถูกต้องและปุ่ม Submit

  10. วางโฟกัสบนฟิลด์ SiteType และปรับเป็นดังนี้:
    1. คลิก ข้อมูล ภายใต้ Properties บนบานหน้าต่างส่วนท้ายและพิมพ์ Office สำหรับค่าดีฟอลต์
    2. เมื่อต้องการพิ่มตัวเลือกอื่นสำหรับชนิดของไซต์, ให้คลิก ค่า ตามด้วย Properties คลิก เพิ่มไอเท็ม สามครั้ง เลือกและเปลี่ยน เลเบลสำหรับแต่ละไอเท็มจาก Untitled ไปเป็น Office, Retail, และ Restaurant

      คุณไม่จำเป็น ต้องป้อนสิ่งใดๆ สำหรับ Values ยกเว้นค่าที่เก็บไว้ แตกต่างจากค่าที่แสดงซึ่งไม่ใช่กรณีนี้

  11. วางโฟกัสบนฟิลด์ Amenities และปรับ เป็นดังต่อไปนี้:
    1. คลิก กล่องรายการ ภายใต้ Properties บนบานหน้าต่างส่วนท้ายและทำเครื่องหมาย Allow multiple selections
    2. คลิก ค่า ภายใต้ Properties คลิก เพิ่มไอเท็ม สี่ครั้ง เลือกและเปลี่ยน เลเบลสำหรับแต่ละไอเท็มจาก Untitled ไปยัง Cafeteria, Fitness Center, Visitor Center, และ Executive Briefing Center
    3. คลิกบนคอลัมน์ 1 ภายในเซลล์แต่ภายนอกคอนโทรลเลเบล (“Amenities:") คลิก เซลล์ตาราง ภายใต้ Properties และเลือก บน สำหรับ Cell vertical alignment

      สิ่งนี้จัดตำแหน่งเลเบลที่จุดเริ่มต้นของเซลล์

    ถ้าคุณต้องการทำเครื่องหมายที่กล่องสำหรับ Amenities, คุณสามารถลบ กล่องรายการและลากกลุ่มเช็กบ็อกซ์จากถาดข้อมูลคอนโทรล โยง กลุ่มเช็กบ็อกซ์โดยคลิก ข้อมูล ภายใต้ คุณสมบัติ และเลือก Amenities จากเมนูดร็อปดาวน์ โยงกับ ป้อนค่าบนแท็บ ค่า ตามขั้นตอนที่ 11 ข้างต้น

    เหตุผลที่มีทั้งสองฟิลด์ City และ searchCity คือ เพื่อทำให้ city แตกต่างจากการค้นหาชื่อไซต์จริง ตัวอย่างเช่น, หนึ่งในตัวอย่างไซต์อยู่ใน Brighton, นอกเมือง Boston, ดังนั้น การค้นหาเราจึงพูดได้ว่าอยู่ใน Boston สำหรับ ประเทศ, อย่างไรก็ตาม, เรากำลังสมมติว่า ประเทศจริง และการค้นหาประเทศคือสิ่งเดียวกัน

    XPage ของคุณควรดูคล้ายกับ สิ่งนี้

    คำอธิบายไซต์ XPage

    ที่จุดนี้, XPage ของคุณควรคล้ายกับ Site1 ซึ่งคุณสามารถเปิด เพื่อเปรียบเทียบได้

  12. ปรับตารางเพื่อให้แถวที่มีปุ่ม Submit ถูกซ่อนไว้เมื่อเพจไม่สามารถแก้ไขได้ คุณจำเป็นต้องมี JavaScript
    1. คลิกบนเซลล์ตารางที่มีปุ่ม Submit (เซลล์, ไม่ใช่ปุ่ม)
    2. ภายใต้ Properties ในบานหน้าต่างด้านล่าง, ให้คลิก เซลล์ตาราง หากยังไม่ได้เลือกไว้
    3. คลิกรูปไดมอนที่อยู่ถัดจาก สามารถมองเห็นได้, จากนั้นคลิก คำนวณค่า เอดิเตอร์ สคริปต์เปิดขึ้น
    4. ในเอดิเตอร์สคริปต์, ให้ดับเบิลคลิก document1 ในรายการของตัวแปรโกลบอล, แล้วพิมพ์ช่วงเวลา

      ตัวแปรโกลบอล document1 คืออ็อบเจ็กต์ของชนิด NotesXspDocument ที่แสดงเอกสารปัจจุบันที่ XPage กำลังดู เมื่อคุณพิมพ์ ช่วงเวลา, รายการของเมธอดสำหรับอ็อบเจ็กต์นั้นจะปรากฏขึ้น

    5. ในรายการของเมธอด, ให้เลื่อนไปยังส่วนท้ายและดับเบิลคลิก isEditable()
      สิ่งนี้ส่งคืน true ถ้าเอกสาร สามารถแก้ไขได้และ false สูตรควร ดูคล้ายกับสิ่งนี้:
      document1.isEditable()
    6. คลิก ตกลง

      เอดิเตอร์ สคริปต์ปิดการบันทึกโค้ดของคุณ

    โค้ดนี้ซ่อนเซลล์ที่มีปุ่มหาก ค่าส่งคืนคือ false คุณยังสามารถซ่อนปุ่ม แทนที่จะเป็นเซลล์
  13. บน XPage, ให้คลิกภายนอกคอนโทรลใดๆ เพื่อวางโฟกัส บนเพจและกด Ctrl+S เพื่อบันทึกเพจ
  14. คลิก ออกแบบ > แสดงตัวอย่างในเว็บเบราว์เซอร์ > ระบบเว็บเบราว์เซอร์ดีฟอลต์ (หรือเลือกเบราว์เซอร์อื่น) คุณสามารถทดสอบ แอ็พพลิเคชันของคุณโดยป้อนค่าและคลิก Submit สิ่งนี้ควรป้อนเอกสารใหม่ลงในฐานข้อมูล เมื่อต้องการดูรายการ ของเอกสาร, ให้ใช้ไคลเอ็นต์ Notes ปิดเบราว์เซอร์เมื่อคุณทำเสร็จสิ้น

    ที่จุดนี้, XPage ของคุณควร คล้ายกับ SiteFinal ซึ่งคุณสามารถเปิดสำหรับการเปรียบเทียบ

  15. ปิด Site XPage โดยคลิก X ที่มุมขวาของบานหน้าต่างกลาง

การสร้างคอนโทรลเพื่อเพิ่มและลบเอกสารคู่มือ

SiteList XPage อนุญาตให้คุณดูและแก้ไขเอกสารในแอ็พพลิเคชัน, แต่เราจำเป็นต้องเพิ่มคอนโทรลเพื่อสร้างและลบเอกสาร

ทำสิ่งต่อไปนี้:
  1. บน SiteList XPage, ให้คลิกภายในคอลัมน์แรก (คอลัมน์, ไม่ใช่ส่วนหัว) ดังนั้นจึงอยู่ในโฟกัส
  2. ภายใต้ Properties, ให้คลิก แสดง
  3. ทำเครื่องหมาย Check box ระบบจะ ใส่เช็กบ็อกซ์ที่ด้านหน้าของแต่ละแถว ผู้ใช้สามารถเลือกแถว ได้โดยทำเครื่องหมายที่กล่อง
  4. บน XPage, ให้คลิกส่วนท้ายของหัวเรื่องและกด Enter เพื่อวางบรรทัดว่างระหว่างหัวเรื่องและคอนโทรลมุมมอง
  5. ถ้าคุณมองไม่เห็นรายการของคอนโทรลในบานหน้าต่างด้านขวา, ให้คลิกแท็บ คอนโทรล หรือคลิก หน้าต่าง > แสดงมุมมอง Eclipse > คอนโทรล
  6. ลากคอนโทรล Button บนบรรทัดว่าง ภายใต้หัวเรื่องและให้ทำสิ่งต่อไปนี้:
    1. ภายใต้ Properties บนบานหน้าต่างด้านล่าง, ให้คลิก ปุ่ม ถ้าไม่ได้อยู่ในโฟกัส
    2. เปลี่ยนเลเบลไปยัง New Site
    3. คลิกแท็บ เหตุการณ์
    4. ตรวจสอบให้แน่ใจว่าเหตุการณ์ onClick จะถูกเลือกไว้
    5. คลิก เพิ่มแอ็คชัน ไดอะล็อกบ็อกซ์ Add Simple Action จะเปิดขึ้น หมวดหมู่ควรอ่าน ทั้งหมด และแอ็คชัน เปิดเพจ ให้ปรับแต่งหาก ไม่ใช่
    6. เลือก ไซต์ สำหรับชื่อของ เพจที่ต้องการเปิด
    7. เลือก สร้างเอกสาร สำหรับ เอกสารเป้าหมาย
    ไดอะล็อกบ็อกซ์ควรดูคล้ายกับสิ่งนี้

    ไดอะล็อกบ็อกซ์ เพิ่มแอ็คชันพื้นฐาน

  7. คลิก ตกลง
  8. ลากคอนโทรล Button อันดับสอง ข้างๆ คอนโทรลแรกและทำสิ่งต่อไปนี้:
    1. บนบานหน้าต่างด้านล่าง, ให้คลิกแท็บ คุณสมบัติ และคลิก ปุ่ม หากไม่ได้อยู่ในโฟกัส
    2. เปลี่ยนเลเบลไปเป็น Delete Selected
    3. คลิกแท็บ เหตุการณ์
    4. ตรวจสอบให้แน่ใจว่า onclick ถูกเลือกไว้
    5. คลิก เพิ่มแอ็คชัน
    6. เลือก เอกสาร สำหรับหมวดหมู่
    7. เลือก ลบเอกสารที่เลือกไว้ สำหรับแอ็คชัน
    8. เลือก viewPanel1 สำหรับ ชื่อมุมมอง

      หากสิ่งนี้ไม่ใช่ชื่อของคอนโทรลมุมมองของคุณ, ให้เลือกคอนโทรลมุมมองของคุณ

    9. พิมพ์ คุณต้องการลบไซต์ที่ทำเครื่องหมายไว้จริง หรือไม่? สำหรับข้อความยืนยัน

    ไดอะล็อกบ็อกซ์ควรถูกคล้ายกับสิ่งนี้

    ไดอะล็อกบ็อกซ์ เพิ่มแอ็คชันพื้นฐาน

  9. คลิก ตกลง
  10. กด Ctrl+S เพื่อบันทึกเพจ
  11. แสดงตัวอย่างเพจตามต้องการ
  12. ปิด SiteList XPage โดยคลิก X ที่ด้านบนขวาของบานหน้าต่างกลาง
ที่จุดนี้, XPage ของคุณดูคล้ายกับ SiteListFinal ที่คุณสามารถเปิดไว้สำหรับการเปรียบเทียบ

การสร้าง XPage สำหรับการค้นหา

ผู้ใช้ใช้เพจนี้เพื่อระบุพารามิเตอร์การค้นหา และดูผลลัพธ์ พารามิเตอร์การค้นหาคือค่าสำหรับเมือง, รัฐ, ประเทศ, และรหัสไปรษณีย์ ผู้ใช้สามารถกรอกข้อมูลลงในพารามิเตอร์เหล่านี้ และคลิกปุ่ม เพจถูกรีเฟรชและผลลัพธ์ถูกแสดง เป็นมุมมอง คุณสมบัติการค้นหาสำหรับมุมมองจำกัดการแสดงผลไปยังเอกสาร ที่ตรงกับพารามิเตอร์การค้นหา

ทำสิ่งต่อไปนี้:
  1. ที่จุดเริ่มต้นของรายการของ XPages, ให้คลิก สร้าง XPage หรือ, คุณสามารถคลิกขวาที่ XPages > สร้าง XPage ในบานหน้าต่างด้านข้าง
  2. ตั้งชื่อ XPage SiteFinder ใหม่ของคุณและคลิก ตกลง
  3. จากภายใต้ Custom Controls ในบานหน้าต่างด้านขวา, ให้ลากคอนโทรลแบบกำหนดเอง Header ไปยัง XPage

    สิ่งนี้เป็นอิมเมจเดียวกันกับที่คุณวางไว้บน SiteList XPage, แต่อิมเมจนี้ถูกวางในคอนโทรลแบบกำหนดเองเพื่อให้ง่ายต่อการดูแลรักษา คอนโทรลแบบกำหนดเอง คล้ายกับแบบฟอร์มย่อย

  4. เพิ่มสไตล์ชีตไปยังเพจดังต่อไปนี้:
    1. คลิกบนเพจจริงที่ไม่ใช่คอนโทรลเพื่อให้โฟกัส อยู่บนเพจ
    2. ภายใต้ Properties ในบานหน้าต่างด้านล่าง, ให้คลิก ลักษณะ
    3. เลื่อนไปยังส่วนท้ายและคลิก เพิ่มสไตล์ชีต ไปยังเพจ
    4. ในกล่อง Add Style Sheet to Page, ให้เลือก styles.css
    5. คลิก ตกลง.
  5. เพิ่มหัวเรื่องดังต่อไปนี้:
    1. บน XPage, ให้กด Enter หลังส่วนหัว, พิมพ์หัวเรื่องสำหรับเพจ, ตัวอย่างเช่น, Site Finder, และกด Enter อีกครั้ง
    2. ไฮไลต์ข้อความ
    3. บนบานหน้าต่างด้านล่าง, ให้คลิก ลักษณะ หากคุณยังไม่ได้ทำ
    4. จากรายการภายใต้ styles.css, ให้คลิก .title
    ลักษณะที่ปรากฏขึ้นของข้อความจะเปลี่ยนไปเพื่อแปลงเป็น ลักษณะที่เลือกไว้
  6. ด้านล่างของข้อความหัวเรื่อง, ให้ป้อนคำสั่งสำหรับผู้ใช้, ตัวอย่างเช่น, Fill in any or all of these fields and click Search, และกด Enter
  7. สร้างตารางที่มีสี่แถวสองคอลัมน์ดังต่อไปนี้:
    1. จาก Container Controls ในบานหน้าต่างด้านขวา, ให้ลาก ตาราง ภายใต้คำสั่งบน XPage

      ไดอะล็อกบ็อกซ์ Insert Table จะปรากฏขึ้น

    2. ในไดอะล็อกบ็อกซ์ Insert Table, ให้ระบุ 4 สำหรับแถวและ 2 สำหรับคอลัมน์
    3. คลิก ตกลง
    4. ใช้ตัวจัดการ grab เพื่อปรับความกว้างของตาราง
  8. ทำสิ่งต่อไปนี้สำหรับแต่ละเซลล์ในคอลัมน์ 1:
    1. จาก Core Controls ในบานหน้าต่างด้านขวา, ให้ลาก เลเบล ลงในเซลล์
    2. ในบานหน้าต่างด้านล่าง, ให้เปลี่ยนเลเบลของคอนโทรลเป็น City (แถวที่ 1), State (แถวที่ 2), Country (แถวที่ 3), หรือ Zip/Postal code (แถวที่ 4)
  9. ทำสิ่งต่อไปนี้สำหรับแต่ละเซลล์ในคอลัมน์ที่ 2:
    1. จาก Core Controls ในบานหน้าต่างด้านข้าง, ให้ลาก กล่องแก้ไข ไปยังเซลล์
    2. ภายใต้ Properties ในบานหน้าต่างด้านล่าง, ให้คลิก กล่องแก้ไข
    3. เปลี่ยนชื่อไปเป็น searchCity (แถวที่ 1), searchState (แถวที่ 2), searchCountry (แถวที่ 3), และ searchZip (แถวที่ 4)
    4. ภายใต้ Properties ในบานหน้าต่างด้านล่าง, ให้คลิก ข้อมูล
    5. สำหรับ Bind data using, ให้คลิก ระดับสูง
    6. จากเมนูดร็อปดาวน์ ใช้, ให้เลือก ตัวแปรที่จัดขอบเขตไว้
    7. จากกล่องรายการ พารามิเตอร์, ให้เลือก ขอบเขตของเซสชัน
    8. เลื่อนไปยังส่วนท้ายและพิมพ์ชื่อตัวแปรเป็น searchCity (แถวที่ 1), searchState (แถวที่ 2), searchCountry (แถวที่ 3), หรือ searchZip (แถวที่ 4)
    การโยงกล่องแก้ไขเหล่านี้กับตัวแปรที่จัดขอบเขตแล้วจะอนุญาตให้เรา เข้าถึงค่าของกล่องแก้ไขในโค้ด JavaScript แทนที่จะเข้าถึงใน ที่เก็บข้อมูล ตัวแปรเซสชันเก็บค่าระหว่างเพจสำหรับ ช่วงเวลาของเซสชันผู้ใช้บนเซิร์ฟเวอร์
  10. ทำสิ่งต่อไปนี้เพื่อสร้างปุ่มเพื่อส่งและรีเฟรช เพจ:
    1. จาก Core Controls ในบานหน้าต่างด้านข้าง, ให้ลาก ปุ่ม ไปยังบรรทัดด้านล่างตาราง
    2. ในบานหน้าต่างด้านล่าง, ให้เปลี่ยนเลเบลของคอนโทรล ไปเป็น Search
    3. จากรายการดร็อปดาวน์สำหรับชนิดปุ่ม, ให้เลือก ส่ง
    การคลิกปุ่มนี้จะส่งเพจไปยังเซิร์ฟเวอร์ และรีเฟรชเนื้อหาของเพจที่อ้างอิงตามค่า ที่ผู้ใช้ป้อน
  11. ทำสิ่งต่อไปนี้เพื่อแสดงเคียวรีที่ใช้เพื่อขอรับผลลัพธ์:
    1. บนบรรทัดถัดไปบน XPage, ให้พิมพ์ สตริงเคียวรี: และช่องว่าง
    2. จาก Core Controls ที่ด้านขวา, ให้ลาก ฟิลด์ที่คำนวณแล้ว ไปยังเพจ
    3. ภายใต้ Properties ในบานหน้าต่างด้านล่าง, ให้คลิก ฟอนต์ เปลี่ยนสีเป็นสีน้ำเงิน
    4. ภายใต้ Properties ในบานหน้าต่างด้านล่าง, ให้คลิก ค่า
    5. สำหรับ Bind data using, ให้คลิก ระดับสูง
    6. จากเมนูดร็อปดาวน์ ใช้, ให้เลือก ตัวแปรที่จัดขอบเขตไว้
    7. จากกล่องรายการ พารามิเตอร์, ให้เลือก ขอบเขตของเซสชัน
    8. เลื่อนไปยังส่วนท้ายและพิมพ์ชื่อตัวแปรเป็น queryString

      ชื่อตัวแปรคือชื่อที่คุณเลือกไว้และ ไม่มีความหมายเป็นพิเศษ คุณจะกำหนดค่าไปยังตัวแปรได้ในภายหลัง

    สิ่งนี้อนุญาตให้เราแสดงเคียวรีที่เราคำนวณ ในภายหลัง การแสดงผลอาจไม่จำเป็นในแอ็พพลิเคชันที่ใช้งานจริง แต่มีประโยชน์สำหรับการทดสอบ
  12. จาก Container Controls ในบานหน้าต่างด้านข้าง, ให้ลาก มุมมอง ไปยังบรรทัดถัดไปของเพจ
    1. ปล่อยให้ Show data from ตั้งค่าเป็น มุมมอง Domino
    2. ปล่อยให้ Application ตั้งค่าเป็น ปัจจุบัน
    3. ในรายการดร็อปดาวน์ View, ให้เลือก SiteList
    4. ยอมรับ view1 เป็นชื่อแหล่งข้อมูล
    5. ในรายการคอลัมน์ที่ด้านล่าง, ให้ยกเลิกการทำเครื่องหมายสิ่งใดๆ ยกเว้น SiteName, Phone, StreetAddress, City, และ State คุณสามารถเปลี่ยนสิ่งนี้ และเลือกคอลัมน์ที่ต้องการแสดง, แต่ SiteName ต้องถูกรวมไว้
    6. คลิก ตกลง
  13. ภายใต้ Properties ในบานหน้าต่างด้านล่าง, ให้คลิก มุมมอง สำหรับ At runtime, open selected document using, ให้เลือก ไซต์
  14. ภายใต้ Properties ในบานหน้าต่างด้านล่าง, ให้คลิก ข้อมูล ตรวจสอบให้แน่ใจว่า มุมมองถูกตั้งค่าเป็น SiteList
  15. ถึงตอนนี้ คุณตั้งค่าเคียวรีการค้นหาเพื่อจำกัดมุมมองกับเอกสารเหล่านั้น ซึ่งเป็นสิ่งที่ผู้ใช้ป้อนสำหรับฟิลด์การค้นหา ทำสิ่งต่อไปนี้:
    1. ภายใต้ Properties ในบานหน้าต่างด้านล่าง, ให้คลิก คุณสมบัติทั้งหมด
    2. เลื่อนไปยังส่วนท้าย ขยาย ข้อมูล จากนั้นขยายเหตุการณ์ที่เกิดขึ้นลำดับที่สองของ ข้อมูล เลือกคุณสมบัติ ค้นหา

      หน้าจอของคุณ ควรดูคล้ายกับสิ่งนี้

      คุณสมบัติการค้นหา

    3. คลิกรูปไดมอนที่อยู่ถัดจากคุณสมบัติ Search และเลือก คำนวณค่า

      เอดิเตอร์ สคริปต์เปิดขึ้น

    4. ป้อนโค้ดต่อไปนี้ในเอดิเตอร์สคริปต์ ตรวจสอบให้แน่ใจว่า ภาษาเป็นภาษา JavaScript ในฝั่งเซิร์ฟเวอร์และ Compute Dynamically ถูกตั้งค่าไว้
      var tmpArray = new Array("");
      var cTerms = 0;
      if(sessionScope.searchZip != null & sessionScope.searchZip != "") {
      	tmpArray[cTerms++] = "(FIELD SearchZip = \"" + sessionScope.searchZip + "\")";
      }
      if(sessionScope.searchCity != null & sessionScope.searchCity != "") {
      	tmpArray[cTerms++] = "(FIELD SearchCity = \"" + sessionScope.searchCity + "\")";
      }
      if(sessionScope.searchState != null & sessionScope.searchState != "") {
      	tmpArray[cTerms++] = "(FIELD SearchState = \"" + sessionScope.searchState + "\")";
      }
      if(sessionScope.searchCountry != null & sessionScope.searchCountry != "") {
      	tmpArray[cTerms++] = "(FIELD Country = \"" + sessionScope.searchCountry + "\")";
      }
      qstring = tmpArray.join(" AND ").trim();
      sessionScope.queryString = qstring; // this just displays the query
      return qstring // this is what sets the search property

      คุณไม่ได้ ไปยังแบบฝึกหัด, แต่โค้ดนี้สามารถวางอยู่ในแบบฟอร์ม ของฟังก์ชันและวางอยู่ในไลบรารีสคริปต์ ไลบรารีสคริปต์ จะถูกเพิ่มไว้เป็นรีซอร์สของเพจและฟังก์ชันจะถูกเข้าถึงโดย การอ้างอิงพื้นฐาน สิ่งนี้อนุญาตให้โค้ดถูกใช้ในตำแหน่งจำนวนมาก พร้อมกับการดูแลรักษาส่วนกลาง

    5. คลิก ตกลง
    โค้ดนี้ขอรับค่าที่ผู้ใช้ป้อนบนเพจ โดยใช้ตัวแปรขอบเขตเซสชันที่โยงกับกล่องแก้ไขเหล่านี้ โค้ด บิวต์และส่งคืนสตริงเคียวรีที่ตรงกับค่าเอกสาร ในฟิลด์ searchZip, searchCity, searchState, และ Country

    สำหรับความชัดเจน เรากำลังใช้ชื่อฟิลด์ที่เหมือนกันกับ ในเอกสารที่เรากำลังค้นหา, แต่เราสามารถใช้ชื่อใดๆ ได้

  16. ปรับคอลัมน์แรกเพื่ออนุญาตให้ผู้ใช้เปิดเอกสาร ในโหมดอ่าน:
    1. บน XPage, ให้คลิกภายในคอลัมน์แรกของมุมมอง
    2. ภายใต้ Properties ในบานหน้าต่างด้านล่าง, ให้คลิก แสดง
    3. ทำเครื่องหมาย แสดงค่าในคอลัมน์นี้เป็นลิงก์
    4. สำหรับ Document open mode, ให้คลิก อ่านอย่างเดียว

    ผุ้ใช้เว็บที่ดูผลลัพธ์การค้นหาจะไม่ได้รับอนุญาต ให้แก้ไขเอกสารที่ค้นหาเมื่อทำตามลิงก์ ในแอ็พพลิเคชันจริง คุณอาจใช้รายการคอนโทรลการเข้าถึง

  17. บันทึกการเปลี่ยนแปลงของคุณและแสดงตัวอย่างหน้าจอการค้นหาใหม่
  18. แสดงตัวอยางเพจตามต้องการ ลองการค้นหาบางอย่าง, ตัวอย่างเช่น: 02108 หรือ 33432 สำหรับรหัสไปรษณีย์; Boca Raton หรือ Boston สำหรับเมือง; MA สำหรับรัฐ; France สำหรับประเทศ
  19. ปิด SiteFinder XPage โดยคลิก X ที่มุมบนขวาของบานหน้าต่างกลาง
ที่จุดนี้, XPage ของคุณควรคล้ายกับ SiteFinderFinal ที่คุณสามารถเปิดเพื่อเปรียบเทียบ

กระบวนการที่แสดงที่นี่ ไม่ใช่วิธีที่ต้องมีเพื่อจัดการกับฟังก์ชันการค้นหาแต่เป็นวิธีการหนึ่ง คุณอาจ กำหนดคุณสมบัติการค้นหาของแหล่งข้อมูลจากโค้ด JavaScript ในปุ่ม Search แทน วิธีนี้เป็นวิธีที่ง่ายเพื่อให้มี แหล่งที่มาของข้อมูลเคียวรีจำนวนมากบนเพจ, บางครั้งมีปุ่มการค้นหาจำนวนมาก สำหรับชนิดที่แตกต่างกันของการค้นหา

คอนโทรลอื่นๆ พร้อมใช้งานเพื่อจัดรูปแบบผลลัพธ์ของคุณได้ดีกว่า Data Table, สำหรับตัวอย่าง, กำหนดคอนโทรลเพิ่มเติมผ่านวิธีการที่คุณจัดโครงร่างผลลัพธ์การค้นหา, และใช้แทนมุมมอง อย่างไรก็ตาม, คอนโทรล View เป็นคอนโทรลที่ง่ายที่สุดสำหรับการใช้งาน

การดูแลจัดการแอ็พพลิเคชัน

IBM Domino Designer มีคุณลักษณะสำหรับการดูแลระบบ และการจัดการงานของคุณ และไฟล์ที่เกี่ยวข้องพร้อมกับการพัฒนาโปรเจ็กต์ แอ็พพลิเคชันของคุณ

คุณลักษณะหลักปัจจุบัน, การเปิดใช้งานคอนโทรลแหล่งที่มา, อนุญาตให้คุณเก็บ NSF ที่อ้างอิงอิลิเมนต์การออกแบบลงในที่เก็บคอนโทรลแหล่งที่มา และดำเนินการกับการดำเนินการคอนโทรลซอร์สทั่วไปโดยใช้ Domino Designer คุณลักษณะทำสิ่งนี้ โดยอนุญาตให้คุณสร้างความสัมพันธ์ระหว่างโปรเจ็กต์ on-disk ที่ถูกจัดการโดย คอนโทรลแหล่งที่มาและ NSF เสมือนที่อ้างถึงโปรเจ็กต์ที่ Domino Designer ติดตาม

คุณลักษณะนี้ถูกจัดเตรียมไว้เพื่ออนุญาตให้คุณรวมไคลเอ็นต์คอนโทรลแหล่งที่มา SVN เข้ากับ Domino Designer อย่างแนบเนียนเท่าที่จะเป็นไปได้และเพื่ออนุญาตให้ Domino Designer ยังคงเป็น "ระบบคอนโทรลแหล่งที่มาที่ไม่มีใครอาจรู้ได้" เท่าที่เป็นไปได้

เอกสารนี้อ้างถึงผลิตภัณฑ์ต่อไปนี้: IBM Domino, IBM Domino Designer, IBM Notes, IBM iNotes, and IBM Notes Traveler

คอนโทรลซอร์สใน Domino Designer

การดำเนินการกับคอนโทรลซอร์สสามารถเป็นไปได้กับ Domino Designer ส่วนจัดเตรียม ข้อมูลที่จำเป็นสำหรับการใช้ คุณลักษณะการเปิดใช้งานคอนโทรลแหล่งที่มา ซึ่งทำให้การทำงานนี้พร้อมใช้งาน

การเปิดใช้งานคอนโทรลแหล่งที่มา

คุณลักษณะคอนโทรลแหล่งที่มาได้ถูกนำเสนอไว้ เพื่ออนุญาตให้คุณเก็บอิลิเมนต์การออกแบบที่อ้างถึง NSF ในที่เก็บคอนโทรลแหล่งที่มา และดำเนินการกับการดำเนินการกับคอนโทรลแหล่งที่มาทั่วไปโดยใช้ Domino Designer

Eclipse อ้างอิง (เช่น ซอร์สแบบเปิด) ไคลเอ็นต์การควบคุมแหล่งที่มา เช่น SVN และ CCRC ทำงานบนไฟล์แบบฟิสิคัล เนื่องจากไม่สามารถทำงานกับโปรเจ็กต์ Designer ได้โดยตรงที่มีการแม็พไฟล์เสมือนกับ NSF ที่อิงกับอิลิเมนต์การออกแบบ และทำงานกับโปรเจ็กต์ที่ถูกบันทึกไว้ บนเดิสก์เท่านั้น เช่น, คุณต้องการทำงานบนโปรเจ็กต์บนดิสก์ ที่มิเรอร์โปรเจ็กต์ NSF เสมือนเพื่อดำเนินการกับการดำเนินการคอนโทรลแหล่งที่มา

เพื่อช่วยแก้ปัญหานี้, Domino Designer คุณลักษณะ การเปิดใช้งานคอนโทรลแหล่งที่มา ได้ถูกนำเสนอไว้เพื่ออนุญาตให้คุณเก็บอิลิเมนต์การออกแบบที่อ้างถึง NSF ลงในที่เก็บและดำเนินการกับการดำเนินการกับคอนโทรลแหล่งที่มาทั่วไป โดยใช้ Domino Designer คุณลักษณะทำสิ่งนี้โดย อนุญาตให้คุณสร้างการเชื่อมโยงระหว่างโปรเจ็กต์ on-disk ที่ถูกจัดการโดย คอนโทรลแหล่งที่มาและ NSF เสมือนที่อ้างถึงโปรเจ็กต์ที่ Designer ติดตาม ขั้นตอนนี้, ในความเป็้นจริง, เป็นสิ่งที่จำเป็นต้องมีซึ่งต้องทำให้เสร็จสิ้น ก่อนที่จะใช้การดำเนินการคอนโทรลแหล่งที่มาระดับพื้นฐานใดๆ

ท้ายสุด, คุณลักษณะนี้อนุญาตให้คุณรวมไคลเอ็นต์คอนโทรลแหล่งที่มา SVN เข้ากับ Domino Designer อย่างแนบเนียนเท่าที่จะเป็นไปได้และเพื่ออนุญาตให้ Domino Designer ยังคงเป็น "ระบบคอนโทรลแหล่งที่มาที่ไม่มีใครอาจรู้ได้" เท่าที่เป็นไปได้

สิ่งที่จำเป็นต้องมี: การติดตั้งเวอร์ชันของระบบคอนโทรลแหล่งที่มา ด้วยการเปิดใช้งานคอนโทรลแหล่งที่มา

หัวข้อนี้กล่าวถึงวิธีการติดตั้งเวอร์ชันของระบบคอนโทรลแหล่งที่มาอันดับแรก เพื่อให้คุณสามารถใช้คุณลักษณะการเปิดใช้งานคอนโทรลแหล่งที่มา

เกี่ยวกับภารกิจนี้

เวอร์ชันของซอร์สแบบเปิดของระบบคอนโทรลแหล่งที่มา (เช่น Subversion®) อนุญาตให้คุณแบ่งใช้โปรเจ็กต์บนที่เก็บ, ซึ่งถูกเก็บไว้ในภายหลัง ที่เก็บจะดูคล้ายกับไฟล์เซิร์ฟเวอร์ยกเว้นว่าที่เก็บไม่ได้เก็บสำเนาของ ระบบไฟล์เท่านั้น, แต่ยังเก็บสถานะก่อนหน้าและ ประวัติการเปลี่ยนแปลงด้วย ระบบคอนโทรลแหล่งที่มา เช่น Subversion® เข้าถึงที่เก็บโดยใช้การเชื่อมต่อเครือข่าย สิ่งนี้อนุญาตให้คุณทำงานกับไฟล์ที่แบ่งที่แบ่งใช้ และดูการเปลี่ยนแปลงที่เป็นไปได้ซึ่งทำไว้โดยผู้พัฒนารายอื่น

ก่อน ที่คุณจะสามารถใช้คุณลักษณะการเปิดใช้งานคอนโทรลแหล่งที่มาใน Domino Designer, ให้สมมติว่า ปลั๊กอินของคอนโทรลแหล่งที่มาสำหรับ SVN/Clearcase (การจัดทำเป็นเวอร์ชันของซอฟต์แวร์และ การเปลี่ยนแปลงระบบคอนโทรล) ได้ถูกติดตั้งไว้หรือได้ถูกจัดหาไว้ใน Designer แบบไดนามิก ตามแนวทางที่ให้ไว้, ขั้นตอนต่อไปนี้จำเป็นต้องทำให้เสร็จสิ้น หากต้องการเริ่มต้นใช้คุณลักษณะการเปิดใช้งานคอนโทรลแหล่งที่มา:

กระบวนการ

  1. ติดตั้งและกำหนดคอนฟิกเวอร์ชันของซอร์สแบบเปิดของ ระบบคอนโทรลแหล่งที่มา
  2. สร้างที่เก็บในเซิร์ฟเวอร์ที่มีเวอร์ชันย่อย (อ้างถึง เอกสารคู่มือซอฟต์แวร์เวอร์ชันย่อย
  3. ลงทะเบียนที่เก็บใหม่ด้วยเซิร์ฟเวอร์คอนโทรลแหล่งที่มา โดยคลิก สร้าง - ตำแหน่งที่เก็บ - สร้างพาเนลที่เก็บใหม่ และป้อน URL ของเซิร์ฟเวอร์และหนังสือรับรองผู้ใช้

สิ่งที่ต้องทำต่อไป

ถ้าคุณยังไม่ได้ติดตั้งเวอร์ชันของซอร์สแบบเปิดของ ระบบคอนโทรลแหล่งที่มาไว้, คุณสามารถใช้ขั้นตอนต่อไปนี้ เพื่อติดตั้งระบบ Subversion®:
หมายเหตุ: หมายเหตุ: เวอร์ชันนี้ต้องการอย่างน้อย Eclipse 3.3 และไม่สนับสนุนเวอร์ชันก่อนหน้านี้ของ Eclipse IDE
  • เปิดใช้งานเมนู แอ็พพลิเคชัน - ติดตั้ง โดยเลือกการกำหนดค่าตามความชอบที่เปิดใช้งานการติดตั้งปลั๊กอิน Eclipse
  • ติดตั้งไซต์อัพเดตสำหรับปลั๊กอิน SVN eclipse ที่แสดงอยู่บนไซต์ http://www.eclipse.org/subversive/downloads.php ใช้ Helios Release GEF (3.4 เป็นต้นไป) คือข้อกำหนดที่ต้องมีสำหรับปลั๊กอินเวอร์ชันย่อย, ดังนั้น คุณยังถูกถามเพื่อติดตั้งปลั๊กอิน GEF ที่แสดงไว้ก่อนหน้านี้
  • เมื่อติดตั้งแล้ว, ให้ติดตั้งตัวเชื่อมต่อ SVN ที่เกี่ยวข้องจากไซต์อัพเดตต่อไปนี้: http://community.polarion.com/projects/subversive/download/eclipse/2.0/helios-site/ ในระหว่างการประมวลผล, คุณอาจได้รับพร้อมต์สำหรับแต่ละปลั๊กอินตัวเชื่อมต่อ
  • เมื่อต้องการตรวจสอบว่า ไซต์อัพเดตเหล่านี้ถูกติดตั้งไว้อย่างถูกต้อง, ให้ตรวจสอบว่า เปอร์สเปคทีฟที่แสดงที่เก็บ SVN สามารถเปิดขึ้นได้ใน Domino Designer จากนั้นเชื่อมต่อกับเซิร์ฟเวอร์เวอร์ชันย่อย
หมายเหตุ: สถานการณ์จำลองการติดตั้งตัวอย่างที่กล่าวถึงไว้ก่อนหน้านี้ ถูกทดสอบโดยใช้เวอร์ชันปลั๊กอินต่อไปนี้:
  • ปลั๊กอิน Subversive: Subversive-incubation-0.7.9.I20100512-1900.zip
  • Subversive-connectors: Subversive-connectors-2.2.2.I20100512-1900.zip
ขอแนะนำให้คุณใช้เวอร์ชันเหล่านี้ ซึ่งตรงข้ามกับเวอร์ชันล่าสุดหรือเวอร์ชันก่อนหน้านี้ ถ้าคุณต้องการลองใช้เวอร์ชันอื่น, อย่างไรก็ตาม, ขอแนะนำให้คุณลองใช้เวอร์ชันที่ ตรงกับเวอร์ชันในตัวอย่าง
หมายเหตุ: ตามค่าดีฟอลต์, ปลั๊กอินคอนโทรลแหล่งที่มา Subversive (และปลั๊กอินคอนโทรลผลิตภัณฑ์แหล่งที่มาอื่นๆ) ติดตั้งเวอร์ชันล่าสุดของ Graphical Editing Framework (GEF) ถ้าเวอร์ชันของ GEF ที่ใหม่กว่าเวอร์ชัน 3.6.2 ได้ถูกติดตั้งไว้, XPages จะแสดงอย่างไม่ถูกต้องเมื่อเปิดขึ้นเพื่อ แก้ไขใน Designer

เมื่อต้องการแก้ไขปัญหานี้, เมื่อติดตั้งปลั๊กอิน Subversive (หรือปลั๊กอินคอนโทรลผลิตภัณฑ์แหล่งที่มาที่สามารถเรียกทำงานได้), ให้ติดตั้งเวอร์ชันที่ระบุเฉพาะของ Graphical Editing Framework (GEF) ที่ไม่ใหม่เกินกว่าเวอร์ชัน 3.6.2 เวอร์ชัน 3.6.2 เป็นเวอร์ชันที่แนะนำให้ใช้ เมื่อต้องการทำสิ่งนี้, ในระหว่างโพรซีเดอร์การติดตั้ง, ให้ยกเลิกการทำเครื่องหมายที่เช็กบ็อกซ์ แสดง เวอร์ชันล่าสุดของคุณลักษณะต่อไซต์อัพเดตเท่านั้น ขยายคุณลักษณะ .../gef/updates/releases/, และเลือก GEF SDK 3.6.2

การตั้งค่าคุณลักษณะการเปิดใช้งานคอนโทรลแหล่งที่มา

หัวข้อต่อไปนี้จัดเตรียมข้อมูลเกี่ยกวับภารกิจการติดตั้งเริ่มต้น ที่จำเป็นต้องถูกทำให้เสร็จสิ้นเมื่อต้องการเริ่มต้นใช้คุณลักษณะการเปิดใช้งานคอนโทรลแหล่งที่มา Domino Designer เป็นส่วนหนึ่งของการดำเนินการคอนโทรลแหล่งที่มาแบบวันต่อวันของคุณ

  • การสร้างการเชื่อมโยงระหว่างโปรเจ็กต์ on-disk และ NSFs
  • การเชื่อมโยง NSF กับโปรเจ็กต์ on-disk ที่มีอยู่
  • การตั้งค่าทิศทางของการดำเนินการซิงโครไนซ์เริ่มต้น
  • การเชื่อมโยง NSF กับโปรเจ็กต์ on-disk ใหม่
  • การตั้งค่าการกำหนดค่าตามความชอบของคุณลักษณะการเปิดใช้งานคอนโทรลแหล่งที่มา

ก่อนที่คุณจะเริ่มต้น: การสร้างการเชื่อมโยงระหว่างโปรเจ็กต์ on-disk และ NSFs

คุณลักษณะการเปิดใช้งานคอนโทรลแหล่งที่มาต้องการให้คุณ สร้างการเชื่อมโยงระหว่างโปรเจ็กต์ on-disk ที่ถูกจัดการโดยคอนโทรลแหล่งที่มา และ NSF เสมือนอ้างอิงตามโปรเจ็กต์ที่ Designer ใช้

Eclipse อ้างอิง (เช่น ซอร์สแบบเปิด) ไคลเอ็นต์การควบคุมแหล่งที่มา เช่น SVN และ CCRC ทำงานบนไฟล์แบบฟิสิคัล เนื่องจากไม่สามารถทำงานกับโปรเจ็กต์ Designer โดยตรงที่มีการแม็พไฟล์เสมือนกับ NSF ที่อ้างถึงอิลิเมนต์การออกแบบ และทำงานกับโปรเจ็กต์ที่ถูกบันทึกไว้บนดิสก์ (เช่น โปรเจ็กต์ on-disk) เช่น, คุณต้องการใช้โปรเจ็กต์บนดิสก์ ที่มิเรอร์โปรเจ็กต์ NSF เสมือนเพื่อดำเนินการกับการดำเนินการคอนโทรลแหล่งที่มา

เพื่อทำให้บรรลุสิ่งนี้, คุณลักษณะการเปิดใช้งานคอนโทรลแหล่งที่มา ต้องการให้คุณสร้างการเชื่อมโยงระหว่างโปรเจ็กต์ on-disk ที่ถูกจัดการโดย คอนโทรลแหล่งที่มาและ NSF เสมือนที่อ้างถึงโปรเจ็กต์ที่ Designer ใช้ ขั้นตอนนี้คือสิ่งที่จำเป็นต้องมีซึ่งต้องการทำให้เสร็จสิ้น ก่อนที่จะใช้การดำเนินการคอนโทรลแหล่งที่มาระดับพื้นฐานใดๆ

ต่อไปนี้คือขั้นตอนทั่วไปที่ต้องการให้เสร็จสิ้น เพื่อสร้างการเชื่อมโยงนี้

  • ตรวจสอบให้แน่ใจว่าคุณได้เปิดหรือสร้างแอ็พพลิเคชัน NSF ใน Designer
  • ในเนวิเกเตอร์แอ็พพลิเคชัน, ให้เลือก NSF ที่คุณต้องการให้เชื่อมโยงกับโปรเจ็กต์ on-disk และ, ในเมนูคอนเท็กซ์ของการคลิกขวา, ให้เลือก ทีมการพัฒนา - เชื่อมโยงกับโปรเจ็กต์ On-Disk ที่มีอยู่ คุณลักษณะการเปิดใช้งานคอนโทรลแหล่งที่มา Domino Designer ทำงานโดยสร้างการเชื่อมโยงหรือการแม็พ ระหว่างโปรเจ็กต์ NSF เสมือนและโปรเจ็กต์ on-disk การเลือกตัวเลือกเมนูนี้ จะเสร็จสิ้นการเชื่อมโยงนี้

การเชื่อมโยง NSF กับโปรเจ็กต์ on-disk ที่มีอยู่

คุณลักษณะการเปิดใช้งานคอนโทรลแหล่งที่มาอนุญาตให้คุณสร้าง การเชื่อมโยงระหว่างโปรเจ็กต์ on-disk ที่มีอยู่ ซึ่งถูกจัดการโดย คอนโทรลแหล่งที่มาและ NSF เสมือนอ้างถึงโปรเจ็กต์ที่ Designer ใช้

เกี่ยวกับภารกิจนี้

ใช้ขั้นตอนต่อไปนี้เพื่อสร้าง Designer Application (.NSF) - การเชื่อมโยงหรือการแม็พโปรเจ็กต์ On-Disk (ODP) สิ่งนี้ถูกทำจากพาเนล เชื่อมโยงกับโปรเจ็กต์ On-Disk...

กระบวนการ
  1. เปิดหรือสร้างแอ็พพลิเคชัน NSF ใน Domino Designer
  2. เลือก NSF ที่สร้างและเลือกทีมการพัฒนา - เชื่อมโยงกับ โปรเจ็กต์ On-Disk ที่มีอยู่... จากเมนู สิ่งนี้เปิดพาเนล การเชื่อมโยงกับโปรเจ็กต์ On-Disk จากพาเนลนี้, คุณเลือกโปรเจ็กต์ on-disk ที่มีอยู่เช่นเดียวกับการเลือกทิศทางสำหรับการดำเนินการ ซิงโครไนซ์เริ่มต้นที่จะเกิดขึ้นหลังจากทำการเชื่อมโยง ค่าติดตั้งดีฟอลต์คือ "อิมพอร์ตจากโปรเจ็กต์ on-disk ไปยัง nsf_filename
  3. โปรดดูหัวข้อ การตั้งค่าทิศทางของการดำเนินการ ซิงโครไนซ์เริ่มต้น สำหรับรายละเอียดเพิ่มเติมเกี่ยวกับ การตั้งค่าซิงโครไนซ์

การตั้งค่าทิศทางของการดำเนินการซิงโครไนซ์เริ่มต้น

หัวข้อนี้อธิบายถึงทิศทางที่พร้อมใช้งานสำหรับการดำเนินการ ซิงโครไนซ์เริ่มต้นที่เกิดขึ้นเมื่อสร้างการเชื่อมโยง ระหว่าง NSF และโปรเจ็กต์ on-disk

ขณะที่สร้างการเชื่อมโยงระหว่าง NSF และโปรเจ็กต์ on-disk, คุณจำเป็นต้องเลือกทิศทางของการดำเนินการซิงโครไนซ์เริ่มต้น สิ่งนี้สามารถเป็นหนึ่งในสิ่งต่อไปนี้:

  • เอ็กซ์พอร์ตจาก ชื่อไฟล์ nsf ไปยังโปรเจ็กต์ on-disk ที่เลือกไว้ -- เมื่อทิศทางเริ่มต้นถูกตั้งค่าเป็นสิ่งนี้, การดำเนินการซิงโครไนซ์เริ่มต้น จะเอ็กซ์พอร์ตเนื้อหาทั้งหมดจากโปรเจ็กต์ NSF เสมือน ไปยังโปรเจ็กต์ on-disk ในรูปแบบที่เหมาะสม, ซึ่งคุณสามารถยอมรับ ที่เก็บคอนโทรลแหล่งที่มา
  • อิมพอร์ตจากโปรเจ็กต์ on-disk ที่เลือกไว้ไปยัง ชื่อไฟล์ nsf -- เมื่อทิศทางเริ่มต้นถูกตั้งค่าเป็นสิ่งนี้, การดำเนินการซิงโครไนซ์เริ่มต้น จะอัพเดตโปรเจ็กต์ NSF ด้วยเนื้อหาจากดิสก์ ที่อ้างถึงโปรเจ็กต์

การเชื่อมโยง NSF กับโปรเจ็กต์ on-disk ใหม่

คุณลักษณะการเปิดใช้งานคอนโทรลแหล่งที่มาอนุญาตให้คุณสร้างการเชื่อมโยง ระหว่างโปรเจ็กต์ on-disk ใหม่และ NSF

เกี่ยวกับภารกิจนี้

เมื่อต้องการเชื่อมโยง NSF กับโปรเจ็กต์ on-disk ใหม่, ให้เลือก ไฟล์ - ทีมการพัฒนา - ตั้งค่าคอนโทรลแหล่งที่มา สำหรับแอ็พพลิเคชันนี้ จาก

เมื่อต้องการทำสิ่งนี้ใน Domino Designer Applications Navigator, คลิกขวาบนส่วนหัวแอ็พพลิเคชัน (ไอคอน) ของแอ็พพลิเคชันที่คุณต้องการเพิ่มให้กับคอนโทรลแหล่งที่มาและเลือก ทีมการพัฒนา - การตั้งค่าคอนโทรลแหล่งที่มาสำหรับแอ็พพลิเคชันนี้ สิ่งนี้สร้างโปรเจ็กต์ on-disk ใหม่และเนื้อหาทั้งหมดของโปรเจ็กต์ NSF ที่เปิดถูกเอ็กซ์พอร์ตไปยังโปรเจ็กต์ตามค่าดีฟอลต์

เมื่อต้องการขอรับข้อมูลเพิ่มเติม เกี่ยวกับวิธีการใช้คุณลักษณะการเปิดคอนโทรลแหล่งที่มาด้วย ภารกิจคอนโทรลแหล่งที่มาทั่วไป, โปรดอ้างถึงหัวข้อ การกรอกข้อมูลภารกิจ คอนโทรลแหล่งที่มาทั่วไปให้สมบูรณ์ด้วยคุณลักษณะการเปิดใช้งานคอนโทรลแหล่งที่มา สำหรับรายละเอียดเพิ่มเติม

การตั้งค่าการกำหนดค่าตามความชอบของคุณลักษณะการเปิดใช้งานคอนโทรลแหล่งที่มา

หัวข้อนี้กล่าวถึงการกำหนดค่าตามความชอบที่คุณสามารถตั้งค่า เพื่อปรับแต่งการดำเนินการกับคุณลักษณะการเปิดใช้งานคอนโทรลแหล่งที่มา

เมื่อต้องการปรับแต่งการดำเนินการกับคุณลักษณะการเปิดใช้งานคอนโทรลแหล่งที่มาของคุณ, คุณสามารถตั้งค่าการกำหนดค่าตามความชอบได้โดยคลิก ไฟล์-การกำหนดค่าตามความชอบ-Designer- คอนโทรลแหล่งที่มา การกำหนดค่าตามความชอบเหล่านี้จะถูกใช้กับคุณลักษณะนี้ ขณะที่คุณใช้ การกำหนดค่าตามความชอบเหล่านี้ประกอบด้วยสิ่งต่อไปนี้:

  • ใช้ Binary DXL สำหรับการดำเนินการคอนโทรลแหล่งที่มา -- มีวิธีที่แตกต่างกัน ในการแทนค่าอิลิเมนต์การออกแบบบนดิสก์ขึ้นอยู่กับ ชนิดของอิลิเมนต์การออกแบบที่ถูกแทนค่า - โปรดดูส่วน "การเลือก วิธีการแสดงอิลิเมนต์การออกแบบบนดิสก์" สำหรับรายละเอียดที่สมบูรณ์
  • เปิดใช้งานเอ็กซ์พอร์ตแบบอัตโนมัติของอิลิเมนต์การออกแบบ (จาก NSF ไปยังดิสก์) สำหรับโมดิฟิเคชัน -- การกำหนดค่าตามความชอบนี้ถูกจัดเตรียมไว้เพื่อเปิดใช้งาน การเอ็กซ์พอร์ตของอิลิเมนต์การออกแบบหลังจากที่แก้ไขแล้วภายใน NSF โดยผู้ใช้ ถ้าการกำหนดค่าตามความชอบนี้ถูกเลือกไว้, การแก้ไขใดๆ ที่ทำไว้กับโปรเจ็กต์ NSF (ตัวอย่างเช่น สร้าง/อัพเดต/ลบ ของแบบฟอร์ม, XPage, เป็นต้น) จะถูกสะท้อนกลับไปยัง โปรเจ็กต์ on-disk, ซึ่งคุณสามารถยอมรับที่เก็บ คอนโทรลแหล่งที่มา
  • เปิดใช้งานอิมพอร์ตแบบอัตโนมัติของอิลิเมนต์การออกแบบ (จากดิสก์ไปยัง NSF) สำหรับโมดิฟิเคชัน -- การกำหนดค่าตามความชอบนี้ถูกจัดเตรียมไว้เพื่ออนุญาตให้อิมพอร์ต ไฟล์การออกแบบจากดิสก์ไปยัง NSF เมื่อถูกปรับเปลี่ยนใน โปรเจ็กต์ดิสก์ ซึ่งยังต้องการสร้างแบบอัตโนมัติที่ต้องเป็น ON หลังจากที่ตั้งค่า การกำหนดค่าตามความชอบนี้, ถ้าผู้ใช้อัพเดตโปรเจ็กต์ดิสก์ด้วยเนื้อหาจากที่เก็บ, การเปลี่ยนแปลงจะขอรับการอิมพอร์ตแบบอัตโนมัติภายใน NSF
  • แสดงพาเนลตัวให้ความช่วยเหลือในวิซาร์ดการติดตั้ง - การกำหนดค่าตามความชอบนี้จะแสดง พาเนลตัวให้ความช่วยเหลือที่กล่าวถึงคุณลักษณะการเปิดใช้งานคอนโทรลแหล่งที่มา เมื่อเรียกใช้พาเนล ทีมการพัฒนา-การติดตั้งคอนโทรลแหล่งที่มาสำหรับแอ็พพลิเคชันนี้

เลือก (ทำเครื่องหมาย) การกำหนดค่าตามความชอบเพื่อเปิดใช้งานหรือยกเลิกการเลือกเพื่อ ปิดใช้งาน

หมายเหตุ: การกำหนดค่าตามความชอบแบบอัตโนมัติคือ ENABLED ตามค่าดีฟอลต์

การเลือกวิธีการแทนค่าอิลิเมนต์การออกแบบบนดิสก์

หัวข้อนี้กล่าวถึงวิธีการแทนค่าอิลิเมนต์การออกแบบ บนดิสก์

มีสองวิธีการที่แตกต่างกันในการแทนค่าอิลิเมนต์การออกแบบบนดิสก์ ขึ้นอยู่กับชนิดของอิลิเมนต์การออกแบบที่ต้องถูกแทนค่า

  • เนื่องจากมีชุดของ 2 ไฟล์ (เนื้อหาและข้อมูลเมตา) บนดิสก์ -- XPages, คอนโทรลแบบกำหนดเอง, สไตล์ชีต, ไฟล์, ธีม, คอมโพสิตแอ็พพลิเคชัน, คุณสมบัติการเชื่อมโยง, และไลบรารีสคริปต์ JS/SSJS/LS ถูกแทนค่าเป็น ชุดของ 2 ไฟล์บนดิสก์, เนื้อหาไฟล์และไฟล์เมตาข้อมูล ไฟล์เนื้อหามีเนื้อหาไฟล์ที่เป็นจริงซึ่งดูในเอดิเตอร์ และไฟล์ข้อมูลเมตามี DXL ลบเนื้อหาเพื่อแทนค่า ส่วนที่เหลือของแอ็ตทริบิวต์ของอิลิเมนต์การออกแบบ
  • เนื่องจากไฟล์มี DXL ของอิลิเมนต์การออกแบบ -- ส่วนที่เหลือของอิลิเมนต์การออกแบบ, แบบฟอร์ม, มุมมอง, เพจ, ไลบรารีสคริปต์ Java, เอเจนต์, แอ็คชันที่แบ่งใช้, เป็นต้น ถูกแทนค่าเป็นไฟล์ที่มี DXL ของอิลิเมนต์การออกแบบข้อมูล การกำหนดค่าตามความชอบถูกจัดเตรียมไว้เพื่อใช้รูปแบบ "ไบนารี" สำหรับ DXL สำหรับ เนื้อหาที่เอ็กซ์พอร์ต โปรดดูหัวข้อ การตั้งค่าการกำหนดค่าตามความชอบของคุณลักษณะการเปิดใช้งานคอนโทรลแหล่งที่มา สำหรับข้อมูลเพิ่มเติม

การกรอกข้อมูลภารกิจคอนโทรลแหล่งข้อมูลทั่วไปด้วยคุณลักษณะการเปิดใช้งาน คอนโทรลแหล่งที่มา

ขั้นตอนพื้นฐานของเวิร์กโฟลว์ทั่วไปถูกจัดเตรียมไว้เพื่อให้แนวคิด กับคุณถึงวิธีการทำงานกับคุณลักษณะการเปิดใช้งานคอนโทรลแหล่งที่มา Domino Designer

เนื่องจากไม่ได้อยู่ภายในขอบเขตของเอกสารคู่มือนี้ เพื่ออธิบายถึงรายละเอียดทั้งหมดของการดำเนินการคอนโทรลแหล่งที่มาระดับพื้นฐานสำหรับระบบคอนโทรลแหล่งข้อมูลต่างๆ ที่พร้อมใช้งาน, ขั้นตอนระดับพื้นฐานของเวิร์กโฟลว์ทั่วไป ถูกจัดเตรียมไว้เพื่อให้แนวคิดแก่คุณถึงวิธีการทำงานกับคุณลักษณะการเปิดใช้งานคอนโทรลแหล่งที่มาของ Domino Designer

กระบวนการทั่วไปสามารถเป็นบางสิ่งเหมือนกับสิ่งนี้:

  • ปลั๊กอินคอนโทรลแหล่งที่มาที่เหมาะสมถูกติดตั้งไว้ใน Designer
  • เปิดฐานข้อมูลใน Designer
  • เชื่อมโยงฐานข้อมูล (NSF) กับโปรเจ็กต์ on-disk (ODP) และเอ็กซ์พอร์ตจาก NSF ไปยัง ODP
  • ยอมรับ - ส่งจาก Designer ODP ไปยังที่เก็บคอนโทรลแหล่งที่มา
  • เช็กเอาต์ - จากเครื่องอื่น, ดึง ODP จากที่เก็บ คอนโทรลแหล่งที่มา
  • เชื่อมโยงฐานข้อมูล (NSF) กับ ODP และอิมพอร์ตจาก ODP ไปยัง .NSF
  • ปรับเปลี่ยน .NSF และ/หรือ ODP และซิงโครไนซ์ทั้งสอง (โดยนัยหรือชัดแจ้ง)
  • ยอมรับการเปลี่ยนแปลงไปยังที่เก็บคอนโทรลแหล่งที่มา
  • อัพเดตเพื่อดึงการเปลี่ยนแปลงจากที่เก็บคอนโทรลแหล่งที่มา ไปยัง ODP
  • ซิงโครไนซ์ ODP ที่อัพเดตด้วย .NSF

เป็นตัวอย่างที่ระบุเฉพาะเพิ่มเติม, เครื่องมือทั่วไปใช้โพรซีเดอร์ ระดับพื้นฐานต่อไปนี้:

  • แบ่งใช้โปรเจ็กต์เพื่อเพิ่มไปยังคอนโทรลแหล่งที่มา
  • เช็กเอาต์เพื่อสร้างโปรเจ็กต์ on-disk แบบโลคัลจากคอนโทรลแหล่งที่มา
  • ยอมรับเพื่อส่งการเปลี่ยนแปลงโลคัลไปยังคอนโทรลแหล่งที่มา
  • อัพเดตเพื่อรับการเปลี่ยนแปลงจากแหล่งที่มา
หมายเหตุ: หมายเหตุ: โปรดอ้างถึงเอกสารคู่มือซอฟต์แวร์คอนโทรลแหล่งที่มาสำหรับ รายละเอียดเพิ่มเติมถึงวิธีการที่ระบบของคุณจัดการกับการดำเนินการพื้นฐาน

หัวข้อถัดไปจัดเตรียมตัวอย่างโดยละเอียดเพิ่มเติมของการใช้คุณลักษณะการเปิดใช้งาน Domino Designer เพื่อเสร็จสิ้นภารกิจคอนโทรลแหล่งข้อมูลทั่วไป ตามที่กล่าวไว้

การเพิ่มแอ็พพลิเคชัน Domino Designer ที่มีอยู่ไปยังคอนโทรลแหล่งที่มา

หัวข้อนี้กล่าวถึงวิธีการเพิ่มแอ็พพลิเคชัน Domino Designer ที่มีอยู่ลงในคอนโทรลแหล่งที่มา

เกี่ยวกับภารกิจนี้

อนุญาตให้เราพูดได้ว่า เราได้เริ่มต้นแอ็พพลิเคชันใหม่แล้ว และเริ่มต้นทำงานกับแอ็พพลิเคชันบนเครื่องของเราแล้ว ดังนั้น คุณค้นหาได้ว่า คุณต้องการมอบหมายส่วนของแอ็พพลิเคชันไปยังผู้ร่วมงานได้ คุณตัดสินใจ เพื่อทำสิ่งนี้ได้โดยทำเครื่องหมายที่แอ็พพลิเคชันที่มีอยู่ใน ระบบคอนโทรลแหล่งที่มาของคุณ

ภารกิจนี้เสร็จสิ้นแล้วด้วยการเปิดใช้งานคุณลักษณะคอนโทรลแหล่งที่มา Domino Designer โดยเชื่อมโยงแอ็พพลิเคชัน NSF ที่มีอยู่กับโปรเจ็กต์ on-disk ใหม่ สำหรับขั้นตอนเกี่ยวกับวิธีการทำสิ่งนี้, โปรดอ้างถึงหัวข้อ การเชื่อมโยง NSF กับโปรเจ็กต์ on-disk ใหม่

การเข้าสู่แอ็พพลิเคชันจากคอนโทรลแหล่งที่มา

หัวข้อนี้กล่าวถึงวิธีการเข้าสู่แอ็พพลิเคชัน จากคอนโทรลแหล่งที่มา

เกี่ยวกับภารกิจนี้

อนุญาตให้เราพูดได้ว่า คุณจำเป็นต้องช่วยเพื่อนร่วมงานของคุณเกี่ยวกับ แอ็พพลิเคชันใหม่ที่กำลังบิวต์ แอ็พพลิเคชันได้ถูกตรวจสอบ ในคอนโทรลแหล่งที่มาโดยผู้พัฒนาคนแรกแต่ในตอนนี้ คุณจำเป็นต้องเข้าสู่แอ็พพลิเคชันเพื่อเริ่มต้นทำงานด้วยตัวคุณเอง

ใช้ขั้นตอน ทั่วไปต่อไปนี้ทำสิ่งนี้:
  • ในมุมมองเนวิเกเตอร์ Eclipse, ให้ใช้คำสั่งของระบบคอนโทรลแหล่งที่มา เพื่อคัดลอกแอ็พพลิเคชันไปยังเครื่องโลคัลของคุณ
  • เชื่อมโยงโปรเจ็กต์ on-disk กับ NSF ใหม่

    หรือ

  • เชื่อมโยงโปรเจ็กต์ on-disk กับ NSF ที่มีอยู่

โปรดอ้างถึงหัวข้อเพิ่มเติมในส่วนนี้สำหรับข้อมูลเพิ่มเติม เกี่ยวกับภารกิจเหล่านี้

การเชื่อมโยงโปรเจ็กต์ on-disk กับ NSF ใหม่

หัวข้อนี้กล่าวถึงวิธีการเชื่อมโยงโปรเจ็กต์ on-disk กับ NSF ใหม่

เกี่ยวกับภารกิจนี้

อนุญาตให้เราพูดได้ว่า คุณจำเป็นต้องช่วยเพื่อนร่วมงานของคุณเกี่ยวกับ แอ็พพลิเคชันใหม่ที่กำลังบิวต์ แอ็พพลิเคชันได้ถูกตรวจสอบ ในคอนโทรลแหล่งที่มาโดยผู้พัฒนาคนแรกแต่ในตอนนี้ คุณจำเป็นต้องดึงแอ็พพลิเคชันเพื่อเริ่มต้นทำงานด้วยตัวคุณเอง

วิธีการหนึ่ง ที่จะทำสิ่งนี้ได้คือ เชื่อมโยงโปรเจ็กต์ on-disk กับ NSF ใหม่ ใช้ขั้นตอนต่อไปนี้เพื่อทำสิ่งนี้:

กระบวนการ
  1. เมื่อต้องการเชื่อมโยงโปรเจ็กต์ on-disk กับ NSF ใหม่, ให้คลิกขวา บนโปรเจ็กต์ on-disk ที่สร้างขึ้นใหม่และเลือก ทีมการพัฒนา - เชื่อมโยงกับ NSF ใหม่... การดำเนินการนี้จะแสดง ไดอะล็อก เชื่อมโยงกับ NSF ใหม่... ซึ่งถามถึงชื่อของแอ็พพลิเคชันและตำแหน่งที่คุณต้องการ ที่จะสร้าง
  2. ถ้าตำแหน่งคือเซิร์ฟเวอร์โลคัล, ให้ใช้ปุ่ม เรียกดู เพื่อเปิดไดเร็กทอรีระบบโลคัลไฟล์
  3. ถ้าตำแหน่งคือเซิร์ฟเวอร์แบบรีโมต, ปุ่ม เรียกดู จะปรากฏขึ้นพร้อมกับไดอะล็อกที่แสดงโฟลเดอร์ที่สามารถเลือกได้
  4. ตามค่าดีฟอลต์, NSF และโปรเจ็กต์ on-disk จะถูกเก็บแบบอัตโนมัติ ในการซิงโครไนซ์
ผลลัพธ์

การเชื่อมโยงโปรเจ็กต์ on-disk กับ NSF ที่มีอยู่

หัวข้อนี้กล่าวถึงวิธีการเชื่อมโยงโปรเจ็กต์ on-disk กับ NSF ที่มีอยู่

เกี่ยวกับภารกิจนี้

อนุญาตให้เราพูดได้ว่า คุณจำเป็นต้องช่วยเพื่อนร่วมงานของคุณเกี่ยวกับ แอ็พพลิเคชันใหม่ที่กำลังบิวต์ แอ็พพลิเคชันได้ถูกตรวจสอบ ในคอนโทรลแหล่งที่มาโดยผู้พัฒนาคนแรกแต่ในตอนนี้ คุณจำเป็นต้องดึงแอ็พพลิเคชันเพื่อเริ่มต้นทำงานด้วยตัวคุณเอง

วิธีการหนึ่ง ที่จะทำสิ่งนี้ได้คือ เชื่อมโยงโปรเจ็กต์ on-disk กับ NSF ที่มีอยู่ ใช้ขั้นตอนต่อไปนี้เพื่อทำสิ่งนี้:

กระบวนการ
  1. เมื่อต้องการเชื่อมโยงกับโปรเจ็กต์ on-disk กับ NSF ที่มีอยู่, ให้คลิกขวาที่โปรเจ็กต์ on-disk ที่สร้างขึ้นใหม่และเลือก ทีมการพัฒนา - เชื่อมโยงกับ NSF ที่มีอยู่... การดำเนินการนี้จะแสดง ไดอะล็อก เชื่อมโยงกับ NSF... ที่มีอยู่
  2. เลือก NSF ที่มีอยู่ที่คุณต้องการเชื่อมโยงกับโปรเจ็กต์ on-disk ของคุณเช่นเดียวกับทิศทางของการดำเนินการซิงโครไนซ์เริ่มต้น
ผลลัพธ์

ตัวอย่างของการเชื่อมโยง NSF ที่มีอยู่กับโปรเจ็กต์ on disk

หัวข้อนี้จัดเตรียมตัวอย่างของการเชื่อมโยง NSF ที่มีอยู่กับโปรเจ็กต์ on disk

พูดได้ว่า คุณกำลังมองไปที่สำเนาของแอ็พพลิเคชัน ซึ่งผู้ร่วมงานของคุณได้ส่งให้คุณทางอีเมล แอ็พพลิเคชันนี้ได้ถูกโพสต์ ในคอนโทรลแหล่งที่มาและคุณได้ถูกถามเพื่อ ให้ความช่วยเหลือ ในกรณีนี้, คุณจำเป็นต้องขอรับเวอร์ชัน "จริง" เพื่อเปลี่ยนเป็นเวอร์ชันที่ส่งให้กับคุณในอีเมล

โพรซีเดอร์นี้เป็นหัวข้อเดียวกับ การเชื่อมโยงโปรเจ็กต์ on-disk ที่มีหัวข้อ NSF ที่มีอยู่ ยกเว้น แอ็คชันการเชื่อมโยง ที่ได้รับจาก NSF และตัวเลือกคือ โปรเจ็กต์ on-disk โปรเจ็กต์ on-disk ที่คุณเชื่อมโญงกับ NSF จะเป็นหนึ่งโปรเจ็กต์ ที่ใช้สำหรับการดำเนินการคอนโทรลแหล่งที่มา สำหรับขั้นตอนเกี่ยวกับวิธีการทำสิ่งนี้, โปรดอ้างถึงหัวข้อ การเชื่อมโยง NSF กับโปรเจ็กต์ on-disk ที่มีอยู่

การจัดการกับไฟล์การซิงค์ความขัดแย้ง

หัวข้อนี้กล่าวถึงวิธีการจัดการกับไฟล์การซิงค์ความขัดแย้ง ด้วยคุณลักษณะคอนโทรลแหล่งที่มา

เกี่ยวกับภารกิจนี้

เมื่อทำงานกับไฟล์ในคอนโทรลแหล่งที่มา, คุณอาจรับไฟล์ ข้อผิดพลาดเกี่ยวกับไฟล์การซิงค์ความขัดแย้ง ถ้าสิ่งนี้เกิดขึ้น, ข้อความไดอะล็อก การซิงค์ความขัดแย้ง แสดงขึ้นด้วยกล่องแสดงรายการที่มีไฟล์ที่มีความขัดแย้ง คุณ สามารถเลือกหนึ่งไฟล์หรือมากกว่าและเลือกเพื่อเปรียบเทียบเวอร์ชันของไฟล์ ที่แตกต่างกันได้ หลังจากที่คุณได้กำหนดที่เป็นสิ่งที่ถูกต้อง, คุณสามารถเลือกเวอร์ชันที่ต้องการใช้ได้

ไดอะล็อกการซิงค์ความขัดแย้ง แสดงมุมมองที่มี 3 คอลัมน์: ชื่อไฟล์, วันที่ปรับเปลี่ยนล่าสุด (NSF), และวันที่ปรับเปลี่ยนล่าสุด (On-disk) ปุ่ม เปรียบเทียบ อนุญาตให้คุณสร้างไดอะล็อกที่อนุญาตให้คุณดูเวอร์ชัน DXL ของเวอร์ชัน NSF และ On-disk ของอิลิเมนต์, ด้านต่อด้าน, พร้อมกับความแตกต่าง ที่ถูกไฮไลต์

ขั้นตอนต่อไปนี้ถูกใช้ในตัวอย่าง โดยที่คุณมี 2 ไฟล์ที่มีความขัดแย้ง ในกรณีนี้, การซิงค์ความขัดแย้งระหว่างโปรเจ็กต์ NSF และ on-disk จะเกิดขึ้นและแสดง 2 ไฟล์บนพาเนล การซิงค์ความขัดแย้ง

กระบวนการ
  1. ถ้าคุณต้องการ, ให้เลือกไฟล์และคลิกปุ่ม เปรียบเทียบ แอ็คชันนี้จะสร้างไดอะล็อกเปรียบเทียบที่แสดงเนื้อหาของแต่ละไฟล์ ที่มีความแตกต่างที่ถูกไฮไลต์
  2. ตัดสินใจว่าเวอร์ชันใดของไฟล์ที่คุณต้องการใช้ และกดปุ่ม ใช้เวอร์ชัน NSF หรือปุ่ม ใช้เวอร์ชันโปรเจ็กต์ On-Disk อ็อพชัน ใช้เวอร์ชัน NSF จะเขียนทับเวอร์ชัน On-Disk, และอ็อพชัน ใช้เวอร์ชันของโปรเจ็กต์ On-Disk จะเขียนทับเวอร์ชัน NSF คุณสามารถทำการดำเนินการเหล่านี้ได้อย่างเป็นอิสระ
  3. ถ้าคุณคลิกปุ่ม ปิด โดยไม่ได้ระบุไฟล์ใดๆ, ไฟล์เหล่านั้นจะแสดงขึ้นอีกครั้งในครั้งถัดไป ที่การซิงค์ความขัดแย้งทริกเกอร์
ผลลัพธ์

การซิงค์ NSF และโปรเจ็กต์คอนโทรลแหล่งที่มาบนโลคัลแบบแมนวล

หัวข้อนี้กล่าวถึงวิธีการซิงค์ NSF และโปรเจ็กต์คอนโทรลแหล่งที่มาบนโลคัลแบบแมนวล

เกี่ยวกับภารกิจนี้

อาจเป็นบางครั้งที่คุณต้องซิงค์ NSF และโปรเจ็กต์ on-disk ของคอนโทรลแหล่งที่มาบนโลคัลแบบแมนวล ตัวอย่างเช่น, คุณอาจต้องการทำสิ่งนี้หากมีปัญหาหรือหากคุณปิดการซิงค์แบบอัตโนมัติ ในพาเนล การกำหนดค่าตามความชอบ

ทำสิ่งนี้ โดยเลือก การซิงค์ทีมการพัฒนาด้วยโปรเจ็กต์ On-Disk จาก เมนูคอนเท็กซ์หรือเมนูหลัก

การถอนการเชื่อมโยงในคอนโทรลแหล่งที่มา

หัวข้อนี้กล่าวถึงวิธีการถอนการเชื่อมโยง NSF/โปรเจ็กต์ ในคอนโทรลแหล่งที่มา

เกี่ยวกับภารกิจนี้

อาจเป็นบางครั้งที่คุณต้องการถอนการเชื่อมโยง ที่คุณได้สร้างไว้ระหว่าง NSF และโปรเจ็กต์ on-disk ของคอนโทรลแหล่งที่มาบนโลคัล

ทำสิ่งนี้โดยเลือก ทีมการพัฒนา-การถอน การเชื่อมโยงคอนโทรลแหล่งที่มา จากเมนูคอนเท็กซ์ หรือเมนูหลัก

การออกแบบแอ็พพลิเคชัน XPages

IBM Domino Designer มีความสำคัญต่อ การป้อนข้อมูล XPage โดยอัตโนมัติด้วยคอนโทรล และโปรแกรมอื่นๆ และเพื่อเชื่อมโยง XPage กับหน่วยเก็บข้อมูล

สำหรับการนำทางทั่วไป เช่น การสร้างและการเปิด XPages, โปรดดูที่ การนำทางในDomino Designer

ตัวออกแบบจัดเตรียมอ็อพชันต่อไปนี้สำหรับการทำงานกับ XPages:

  • คลิกแท็บ ออกแบบ เพื่อทำงานในโหมด มองเห็นได้
  • คลิกแท็บ แหล่งที่มา เพื่อแก้ไข XML โดยตรง

เอกสารนี้อ้างอิงถึงผลิตภัณฑ์ต่อไปนี้: IBM Domino, IBM Domino Designer, IBM Notes, IBM iNotes, and IBM Notes Traveler

การแสดงตัวอย่างและการรัน XPages

XPages รันอยู่ในเซิร์ฟเวอร์ Domino และสภาวะแวดล้อมไคลเอ็นต์ Notes จาก Domino Designer, คุณสามารถแสดงตัวอย่าง XPages ในทั้งสองสภาวะแวดล้อม

XPage ที่มีอยู่ในแอ็พพลิเคชันบนเซิร์ฟเวอร์ Domino สามารถเข้าถึงได้ดังต่อไปนี้:
  • จากเบราว์เซอร์ผ่าน URL ของแบบฟอร์ม http://server/application.nsf/xpage.xsp
  • จากไคลเอ็นต์ Notes ผ่าน URL ของแบบฟอร์ม notes://server/application.nsf/xpage.xsp

XPage ที่มีอยู่ในแอ็พพลิเคชันบนไคลเอ็นต์ Notes สามารถเข้าถึงได้จากไคลเอ็นต์ ผ่าน URL ของแบบฟอร์ม notes:///application.nsf/xpage.xsp?OpenXPage

นอกจากนี้, คุณสามารถตั้งค่าแอ็พพลิเคชันเพื่อเปิด XPage ตามการเรียกใช้งาน

การแสดงตัวอย่าง XPage

คุณสามารถแสดงตัวอย่าง XPage ในเซิร์ฟเวอร์ Domino หรือสภาวะแวดล้อมไคลเอ็นต์ Notes

ก่อนเริ่มต้นภารกิจ

สำหรับการแสดงตัวอย่างเว็บ, คุณต้องปรับ access control list (ACL) สำหรับแอ็พพลิเคชัน คลิกขวาที่แอ็พพลิเคชันใน เนวิเกเตอร์และเลือก แอ็พพลิเคชัน > คอนโทรลการเข้าถึง เพิ่มรายการสำหรับ Anonymous และตั้งค่าระดับที่เหมาะสมของการเข้าถึง (อย่างน้อยที่สุด Author ด้วยความสามารถในการสร้างเอกสาร)
หมายเหตุ: และ, ตรวจสอบให้แน่ใจว่า ภารกิจ HTTP กำลังรันอยู่บนเซิร์ฟเวอร์ Domino หากดำเนินการ แสดงตัวอย่างเว็บเป็นผลสำเร็จ

กระบวนการ

  1. คลิกขวาที่ XPage และเลือก แสดงตัวอย่างใน Notes หรือ แสดงตัวอย่างในเว็บเบราว์เซอร์ และ, ด้วยโฟกัสบน XPage, คุณสามารถคลิก ออกแบบ > แสดงตัวอย่างใน Notes หรือ ออกแบบ > แสดงตัวอย่างในเว็บเบราว์เซอร์ บนเมนู

    และ, ด้วยโฟกัสบน XPage, คุณสามารถคลิก แสดงตัวอย่างใน Notes หรือไอคอน แสดงตัวอย่างในเว็บเบราว์เซอร์ บนแถบเครื่องมือ

  2. สำหรับ แสดงตัวอย่างในเว็บเบราว์เซอร์, ให้เลือกชนิดเบราว์เซอร์

ผลลัพธ์

การแสดงตัวอย่าง Notes เริ่มต้นด้วยไคลเอ็นต์ Notes หากจำเป็น จากนั้นเปิด XPage ในไคลเอ็นต์ ไคลเอ็นต์จัดการคำร้องขอจาก XPage

การแสดงตัวอย่างเว็บเริ่มต้นที่การแสดงตัวอย่างเซิร์ฟเวอร์ Domino แบบโลคัล จากนั้นเปิด XPage ในเบราว์เซอร์ เซิร์ฟเวอร์การแสดงตัวอย่างแบบโลคัล จัดการคำร้องขอจาก XPage

การแสดงตัวอย่าง XPage บนเว็บอาจแตกต่างจากการรัน XPage ในคอนเท็กซ์ของ แอ็พพลิเคชันแบบเต็ม ผลลัพธ์อาจขึ้นอยู่กับว่าคุณกำลังแสดงตัวอย่างแอ็พพลิเคชันแบบโลคัล หรือแบบรีโมต การแสดงตัวอย่างแอ็พพลิเคชันแบบโลคัล ยังใช้ Anonymous สำหรับคอนโทรลการเข้าถึง, และเซิร์ฟเวอร์การแสดงตัวอย่างแบบโลคัลขาดฟังก์ชันระดับสูงบางอย่างของเซิร์ฟเวอร์ที่ใช้งานจริง อย่างไรก็ตาม, สคริปต์รันและเอกสารถูกสร้างขึ้น, ลงนามแบบไม่ระบุชื่อ สำหรับการแสดงตัวอย่างแบบโลคัลและด้วย ID ปัจจุบันสำหรับการแสดงตัวอย่างบนเซิร์ฟเวอร์, กำหนดลักษณะที่มองเห็นได้จริงของแอ็พพลิเคชันให้แก่คุณ

การเปิด XPage ตามการเรียกใช้แอ็พพลิเคชัน

คุณสามารถเปิด XPage ตามการเรียกใช้แอ็พพลิเคชัน

กระบวนการ

  1. ดับเบิลหรือเปิด คุณสมบัติแอ็พพลิเคชัน จากเนวิเกเตอร์แอ็พพลิเคชัน เพจคุณสมบัติสำหรับ แอ็พพลิเคชันที่เปิด
  2. คลิกแท็บ เรียกทำงาน
  3. สำหรับไคลเอ็นต์ Notes, ให้เลือก เปิด XPage ที่กำหนดไว้ (ไคลเอ็นต์มาตรฐาน) และเลือก XPage
  4. สำหรับเว็บเบราว์เซอร์, ให้เลือก เปิด XPage ที่กำหนดไว้ และเลือก XPage หรือถ้า คุณต้องการเปิด XPage ตัวเดียวกับ Notes, ให้เลือก ใช้อ็อพชันการเรียกทำงาน Notes
  5. บันทึกคุณสมบัติแอ็พพลิเคชัน

ผลลัพธ์

เมื่อผู้ใช้เรียกทำงานแอ็พพลิเคชัน, XPage จะเปิดขึ้นในทันที

เว็บเบราว์เซอร์สามารถเรียกทำงาน XPage ได้โดยใช้ URL, ตัวอย่างเช่น, http://server/application.nsf/xpage.xsp

การเปิด XPage อื่นๆ

จาก XPage, ผู้ใช้สามารถเปิด XPages อื่นๆ ผ่านกฎการนำทาง, แอ็คชันพื้นฐาน, เมธอด XSPContext, และการเปิด URL

กฎการนำทาง

แต่ละ XPage มีคุณสมบัติ navigationRules ที่เป็นอาร์เรย์ของอิลิเมนต์ navigationRule กฎการนำทาง บอกให้เซิร์ฟเวอร์ทราบถึงเพจที่ต้องส่งคืนไปยังไคลเอ็นต์หลังจากประมวลผลเพจ ที่ส่งผ่านปุ่มของชนิดส่งหรือยกเลิก โปรดดูที่ button - ปุ่ม แต่ละกฎการนำทาง มีแอ็ตทริบิวต์ต่อไปนี้:
แอ็ตทริบิวต์ ค่า
outcome xsp-success หากอัพเดตเป็นปกติ
  xsp-failure หากอัพเดตล้มเหลว
redirect true หมายถึงการเรียกคืนสถานะล่าสุดของ เพจ
  false (ดีฟอลต์) หมายถึงเปิดเพจการล้างข้อมูล
viewId <no rule> หมายถึงเปิดเพจเดียวกัน
  $$PreviousPage หมายถึงการเปิดเพจล่าสุดที่เปิดไว้ ก่อนการส่งเพจ
  $$HomePage หมายถึงเปิดเพจการเรียกทำงาน
  page.xsp หมายถึงการเปิดเพจที่ระบุ
ที่นี่คือตัวอย่าง:
<xp:this.navigationRules>
	<xp:navigationRule
		outcome="xsp-success" viewId="$$PreviousPage">
	</xp:navigationRule>
	<xp:navigationRule
		outcome="xsp-failure" viewId="/errpage.xsp">
	</xp:navigationRule>
</xp:this.navigationRules>

ในโหมดการออกแบบ, ให้คลิกภายนอกคอนโทรลทั้งหมด, ให้คลิกแท็บ XPage, และมองหาอ็อพชัน เพจถัดไป

แอ็คชันพื้นฐาน openPage

แอ็คชันพื้นฐาน เปิดเพจ แอ็คชันพื้นฐาน เปิดเพจในทันทีตามการเรียกทำงาน ที่นี่คือ ตัวอย่าง:
<xp:button value="Open page 2" id="button4">
	<xp:eventHandler event="onclick" submit="true" refreshMode="complete">
		<xp:this.action>
			<xp:openPage name="/xpage2.xsp"></xp:openPage>
		</xp:this.action>
	</xp:eventHandler>
</xp:button>

เมธอด XSPContext สำหรับการเปลี่ยนทิศทาง

เมธอด redirectToPage, redirectToPrevious, และ redirectToHome เปิดเพจในทันทีเมื่อ การเรียกทำงาน นี่คือตัวอย่าง:
<xp:button value="Open page 2" id="button4">
	<xp:eventHandler event="onclick" submit="true"
		refreshMode="complete">
		<xp:this.action>
			<![CDATA[#{javascript:context.redirectToPage("xpage2.xsp")}]]>
		</xp:this.action>
	</xp:eventHandler>
</xp:button>

การเปิด URL

คุณสามารถเปิดเพจโดยส่ง URL ไปยังเซิร์ฟเวอร์ ตัวอย่างเช่น, คุณอาจระบุสิ่งต่อไปนี้ ในหน้าต่างแอดเดรสของเบราว์เซอร์:
http://myserver/foo.nsf/xpage1.xsp

จากอิลิเมนต์การออกแบบ ที่ไม่ใช่ XPage, คุณสามารถใช้ @URLOpen ในสูตร สูตรต่อไปนี้ใช้แอ็คชันแบบฟอร์มและเปิด XPage โลคัลในไคลเอ็นต์ Notes:

@URLOpen("notes:///foo.nsf/xpage1.xsp?OpenXpage")

การเปิด XPage แทนมุมมอง

สำหรับการเข้าถึงเว็บเท่านั้น, คุณสามารถเปิด XPage แทนมุมมองได้

กระบวนการ

  1. ดับเบิลคลิกหรือเปิดมุมมองจาก เนวิเกเตอร์แอ็พพลิเคชัน
  2. เปิดคุณสมบัติมุมมองและคลิกแท็บ ระดับสูง
  3. สำหรับ การเข้าถึงเว็บ > แสดง XPage แทน, เลือก XPage
  4. บันทึกมุมมอง

ผลลัพธ์

เมื่อผู้ใช้เลือกมุมมอง, XPage เปิด

การลงนาม XPages

XPages ถูกลงนามด้วย ID ของผู้ใช้ Domino Designer ปัจจุบันตามการบันทึกอิลิเมนต์การออกแบบ XPage, และ/หรือตามการสร้างการนำไฟล์ไปปฏิบัติ (เช่น คลาส)

เกี่ยวกับภารกิจนี้

การลงนาม XPage กำหนดว่าให้โหลด ณ รันไทม์, และสามารถรันได้ด้วยข้อจำกัดหรือไม่มีข้อจำกัด เกี่ยวกับเมธอดและการดำเนินการ การรัน ด้วย ข้อจำกัด จะแยกบางคุณลักษณะ เช่น ไฟล์ หรือ I/O เน็ตเวิร์ก, ซึ่งเป็นวิธี ทั่วไปเพิ่มเติม การรัน โดยไม่มี ข้อจำกัดอนุญาตให้ใช้คุณลักษณะ ที่สนับสนุนทั้งหมดของภาษาในการดำเนินการ XPage (ดูหัวข้อการดำเนินการเอเจนต์ "Restricted LotusScript และ Java " ที่คู่มือการใช้และการอ้างอิง Domino Designer Basic > การออกแบบแอ็พพลิเคชัน > ที่เพิ่มไปยังแอ็พพลิเคชันโดยอัตโนมัติ)

ตามสิทธิ์ การเข้าถึงเซิร์ฟเวอร์ สิทธิ์ในการดำเนินการเมธอดที่จำกัด/ไม่จำกัด ที่กำหนดไปยัง Signer เฉพาะ หรือกลุ่มในส่วน Programmability Restrictions ของแท็ป Security ของเอกสารเซิร์ฟเวอร์ (ดูหัวข้อ "การควบคุม เอเจนต์และ XPages ที่รันบนเซิร์ฟเวอร์" ที่การเข้าถึง Domino Administrator Help > ความปลอดภัย > เซิร์ฟเวอร์ สำหรับผู้ใช้ Notes ผู้ใช้อินเทอร์เน็ต และเซิร์ฟเวอร์ Domino > การกำหนดการเข้าถึงเซิร์ฟเวอร์ Domino)

เมื่อ XPage ถูกเรียก (สำหรับเอเจนต์), Domino ตรวจสอบเอกสารเซิร์ฟเวอร์สำหรับสิทธิ์ความปลอดภัยของเซิร์ฟเวอร์ของผู้ลงนาม XPage, นอกจากนี้ยังตรวจสอบสิทธิ์เข้าถึงสำหรับผู้ใช้เว็บที่พิสูจน์ตัวตนแล้ว สำหรับคอมโพเนนต์ของ XPage (เช่น XPages ที่รวม, คอนโทรลแบบกำหนดเอง, ส่วนขยาย JSF, หรือเซิร์ฟเวอร์ไลบรารี JavaScript), Domino จะตรวจสอบแต่ละสิทธิ์เข้าถึงเซิร์ฟเวอร์ของผู้ลงนามคอมโพเนนต์แต่ละราย, และถ้าบ่งชี้ไว้, ให้ลดเกรดเซสชัน XPage เพื่อเรียกใช้ ด้วย ข้อจำกัดเท่านั้น (ถ้าตั้งค่าไว้สำหรับ Domino, ตัวแปร NoExternalApps notes.ini จะมีผลกระทบเช่นเดียวกัน) ณ รันไทม์, ลายเซ็นต์สำหรับผู้ใช้ DDE โดยไม่มีสิทธิ์เซิร์ฟเวอร์ใดๆ เพื่อลงนาม XPages ทั้งหมดจะสร้างข้อผิดพลาด HTTP 403 กลับไปยังเบราว์เซอร์

การใช้ XPages ในไคลเอ็นต์ Notes

คุณสามารถรันแอ็พพลิเคชัน XPages ในไคลเอ็นต์ประเภท Rich ของ IBM Notes

ข้อดีพื้นฐานของส่วนสนับสนุนสำหรับ XPages ในไคลเอ็นต์ Notes คือ คุณสามารถเรพลิเคตแอ็พพลิเคชัน แบบโลคัลที่พัฒนาสำหรับเว็บและรันแบบออฟไลน์ในไคลเอ็นต์ Notes, โดยไม่มี การนำกลับมาพัฒนาใหม่สำหรับไคลเอ็นต์ ข้อดีทั้งหมดของโมเดลการพัฒนาแอ็พพลิเคชัน XPages สามารถขยายไปยังไคลเอ็นต์ Notes แอ็พพลิเคชันเหล่านี้แสดงใน เบราว์เซอร์ที่ฝั่งไว้และสำหรับส่วนที่มองเห็นเป็นส่วนใหญ่และลักษณะการทำงานคล้ายกับเว็บ แอ็พพลิเคชัน, แต่ทำงานแตกต่างกันในบางวิธีในไคลเอ็นต์ Notes

  • มีความเป็นไปได้ในการสร้างตรรกะที่ระบุเฉพาะกับไคลเอ็นต์ Notes ซึ่งมีผลต่อวิธีที่แอ็พพลิเคชัน สร้างการแสดงผลใน Notes ตัวอย่างเช่น, ในแอ็พพลิเคชัน Discussion, การเรนเดอร์เว็บรวมข้อความ "ยินดีต้อนรับชื่อผู้ใช้" ตามด้วยลิงก์ "โปรไฟล์ของฉัน" ในมุมองของเพจ ข้อความยินดีต้อนรับไม่ได้ปรากฏขึ้นในไคลเอ็นต์ Notes; ตรรกะในแอ็พพลิเคชัน Discussion จะลบข้อความออก คุณยังสามารถปรับเปลี่ยนคุณสมบัติ XPages ของแอ็พพลิเคชันเพื่อระบุธีมที่แตกต่างกันเพื่อนำมาใช้เมื่อแอ็พพลิเคชันรัน ในไคลเอ็นต์ Notes หรือในเบราว์เซอร์
  • ผู้ใช้ของแอ็พพลิเคชันที่รันอยู่ในไคลเอ็นต์ Notes สามารถใช้ ไฟล์ > บันทึก เพื่อสงวนการปรับเปลี่ยนไปยัง XPages คุณสมบัติ enableModifiedFlag อนุญาตให้คุณเปิดใช้งานเมนูอ็อพชันนี้ และแสดงพร้อมต์ให้ผู้ใช้บันทึกการเปลี่ยนแปลงเมื่อเปลี่ยน XPage
  • เมื่อผู้ใช้ถูกพิสูจน์ตัวตนในไคลเอ็นต์ Notes, หนังสือรับรองเดียวกันนี้จะถูกใช้ เพื่อเข้าถึงแอ็พพลิเคชันหรือคอมโพเนนต์ XPages ใดๆ ดังนั้น, ผู้ใช้จะไม่ได้รับพร้อมต์ที่มีไดอะล็อกล็อกอินเข้าสู่เว็บซึ่งอาจเกิดขึ้นกับเว็บแอ็พพลิเคชัน ดั้งเดิมซึ่งรันอยู่ในเบราว์เซอร์ที่ฝังไว้
  • เมื่อต้องการปกป้องโค้ดในอิลิเมนต์การออกแบบ XPages (เนื้อหาที่แอ็คทีฟ) จากการเรียกใช้งานการดำเนินการที่ปกป้องไว้, เช่น การอ่านหรือเขียน ลงไฟล์เวิร์กสเตชันหรือการอ่านและเขียนคุณสมบัติของระบบ, XPages ใช้ Execution Control List (ECL) เพื่อจัดการกับการเข้าถึงและความสามารถ ของผู้ใช้ที่ได้รับสิทธิ์เป็นผู้ลงนามของโค้ดซึ่งกำลังพยายามดำเนินการกับ การดำเนินการที่ถูกปกป้องไว้
  • เพจสามารถทำบุ๊กมาร์กได้ในไคลเอ็นต์ Notes

นอกจากนี้ เพื่อสร้าง XPages เป็นแอ็พพลิเคชันแบบสแตนด์อะโลน, คุณยังสามารถสร้างคอมโพเนนต์ XPage ใน Domino Designer ที่สามารถรันอยู่ภายในคอมโพสิตแอ็พพลิเคชันและสนับสนุนโมเดลเหตุการณ์การรับ/เผยแพร่ เช่นเดียวกับพารามิเตอร์คอมโพเนนต์ คอมโพเนนต์ XPages ของคุณสามารถโต้ตอบกับคอมโพเนนต์อื่นๆ ในไคลเอ็นต์, เช่น คอมโพเนนต์ PIM

โปรดสังเกตว่า แอ็พพลิเคชัน XPages สามารถวางอยู่บนเซิร์ฟเวอร์ Domino ถ้าคุณตั้งค่า "เมื่อเปิดอยู่ใน อ็อพชันเรียกทำงาน Notes Client " เป็น "เปิด XPage ที่กำหนดไว้ (ไคลเอ็นต์มาตรฐาน)," XPage ที่สอดคล้องกัน จะถูกสร้างการแสดงผลบนไคลเอ็นต์, ไม่ว่าแอ็พพลิเคชันตั้งอยู่บนเซิร์ฟเวอร์ Domino หรือบนไคลเอ็นต์ Notes แบบโลคัลหรือไม่ ลักษณะการทำงานของ XPage ในไคลเอ็นต์จะเหมือนกัน

การใช้แถบเครื่องมือของ XPages

แอ็พพลิเคชัน XPages ในไคลเอ็นต์ Notes มีแถบเครื่องมือของตัวเอง ซึ่งมองเห็นได้เมื่อใดก็ตามที่ XPage ได้รับโฟกัส ในเบาว์เซอร์ที่ฝังตัวไว้

เกี่ยวกับภารกิจนี้
แถบเครื่องมือมีกลุ่มของปุ่มที่แตกต่างกัน
  • ปุ่มการนำทางอนุญาตให้คุณย้ายกลับหรือไปยังระหว่างเพจ, หยุดแอ็คชันปัจจุบัน, รีเฟรชเพจปัจจุบัน, และส่งคืนไปยัง เพจเดิม ปุ่มรีเฟรชยังนำเสนออ็อพชัน เคลียร์ข้อมูล ไพรเวต การเรียกใช้แอ็คชันนี้เคลียร์แคช เบราว์เซอร์ที่ฝังไว้
  • ปุ่มพิมพ์อนุญาตให้คุณตั้งค่า XPages สำหรับการพิมพ์ และการพิมพ์ XPages
  • ถ้า Domino Designer ถูกติดตั้งไว้, คุณสามารถคลิกปุ่ม ดูแหล่งที่มาของเพจ เพื่อมองเห็นซอร์ส HTML หรือคลิกปุ่ม ดูคอนฟิกูเรชันเบราว์เซอร์ เพื่อดูค่าติดตั้งเบราว์เซอร์ที่ฝังไว้

ความปลอดภัย XPages

ความปลอดภัยถูกจัดเตรียมไว้สำหรับแอ็พพลิเคชัน XPages

แอ็พพลิเคชัน XPages ที่รันในไคลเอ็นต์ IBM Notes สามารถมีจำนวนของ อิลีเมนต์การออกแบบที่มีโค้ด (โดยส่วนใหญ่จะเรียกว่าเป็น "เนื้อหา ที่แอ็คทีฟ") ที่สามารถดำเนินการบนเวิร์กสเตชั่นของผู้ใช้ ตัวอย่างเช่น การเข้าถึงฐานข้อมูล หรือ JavaScriptที่มีโค้ด Java ฝังไว้ เมื่อต้องการปกป้องเนื้อหาที่แอ็คทีฟ จากการเรียกใช้การดำเนินการที่ปกป้องไว้, เช่น การอ่านหรือเขียน ไปยังไฟล์เวิร์กสเตชัน, การอ่านและการเขียนคุณสมบัติระบบ, และการดำเนินการเน็ตเวิร์ก, XPages ใช้ Execution Control List (ECL) เพื่อจัดการกับ การเข้าถึงและความสามารถที่ผู้ใช้ได้รับสิทธิ์เป็นผู้ลงนามของโค้ด ซึ่งกำลังพยายามดำเนินการกับการดำเนินการที่ปกป้องไว้

ECL กำหนดให้ผู้ลงนามของโค้ดได้รับอนุญาตให้ รันโค้ดบนเวิร์กสเตชันที่กำหนดไว้และนิยามการเข้าถึงโค้ดนั้น ว่าต้องมีฟังก์ชันเวิร์กสเตชันที่หลากหลาย, เช่น เข้าถึงฐานข้อมูลปัจจุบัน หรือฐานข้อมูลอื่น ตัวอย่างของเนื้อหาที่แอ็คทีฟภายในแอ็พพลิเคชัน XPages รวมโค้ด Java ที่ฝังอยู่ใน JavaScript (ฝั่งเซิร์ฟเวอร์), ไลบรารีสคริปต์ฝั่งเซิร์ฟเวอร์, และคลาส Java และ JARs ที่อิมพอร์ตไปยังฐานข้อมูล

อิลิเมนต์การออกแบบทั้งหมดในแอ็พพลิเคชัน XPages มีลายเซ็นต์ ของผู้สร้าง โปรดสังเกตว่า ถ้ามีมากกว่าหนึ่งผู้ลงนามของแอ็พพลิเคชัน XPages, ผู้ลงนามทั้งหมดต้องได้รับการไว้วางใจโดยผู้ใช้ ก่อนที่การดำเนินการที่ปกป้องไว้จะเรียกใช้งาน

อ็อพชันการเข้าถึงความปลอดภัย ECL สำหรับแอ็พพลิเคชัน XPages ตั้งค่าอยู่ในแท็บ การใช้เวิร์กสเตชัน ภายใต้ สิ่งที่ผู้อื่นต้องทำ ของไดอะล็อก ความปลอดภัยของผู้ใช้ (ไฟล์ > ความปลอดภัย > ความปลอดภัยของผู้ใช้)

ความปลอดภัยที่มีการกรองเนื้อหาที่แอ็คทีฟ

คุณลักษณะความปลอดภัย Active Content Filtering (ACF) ยังปกป้องไม่ให้ โค้ดที่เป็นอันตรายเข้าสู่คอนโทรลอินพุต XPage ในระหว่างการเรียกใช้งาน

การกรองเนื้อหาที่แอ็คทีฟถูกใช้เพื่อลบเนื้อหาที่แอ็คทีฟซึ่ง เป็นอันตราย ( สคริปต์, แท็ก ) ในคอนโทรลข้อความอินพุต/เอาต์พุตออก เอ็นจิน ACF ทำหน้าที่เป็นไลบรารีเพื่อดำเนินการกรองในระหว่าง รันไทม์ ถ้าคุณ วางโฟกัสไว้บนคอนโทรล XPage (กล่องแก้ไข, กล่องแก้ไขแบบหลายบรรทัด, rich text, อินพุตที่ซ่อนไว้), คุณมองเห็นสองคุณสมบัติ htmlFilter และ htmlFilterIn บนแท็บ คุณสมบัติทั้งหมด ภายใต้ ระดับต้น

คุณสมบัติ htmlFilter นิยามเอ็นจิน ACF ที่ต้องใช้เมื่อคอนโทรลส่งข้อมูลไปยังไคลเอ็นต์, และคุณสมบัติ htmlFilterIn นิยามเอ็นจินที่ต้องการใช้เมื่อคอนโทรลได้รับข้อความจาก ไคลเอ็นต์ คุณสามารถใช้สองคุณสมบัติเหล่านี้เพื่อเปิดใช้งานหรือปิดใช้งาน ACF สำหรับฟิลด์ข้อความ

มีสี่ ACF เอ็นจินที่พร้อมใช้งานสำหรับ XPages:
  • acf
  • striptags
  • identity
  • empty

เอ็นจิน “acf” วิเคราะห์คำในข้อความ HTML และกรองคอนสตรัค ที่ไม่ปลอดภัย, อ้างอิงตามไฟล์คอนฟิกูเรชัน (acf-config.xml) เอ็นจิน “striptags” ลบแท็กทั้งหมดโดยใช้นิพจน์ปกติ 'replaceAll("\\<.*?>","")' ตัวกรอง "identity" ส่งคืนสตริงดั้งเดิม เอ็นจิน “empty” ลบทุกสิ่งและส่งคืนสตริงว่าง

เอ็นจิน “acf” สามารถกำหนดคอนฟิกผ่านไฟล์คอนฟิกูเรชันได้ สำหรับ ฝั่งไคลเอ็นต์, ไฟล์นี้ยังวางอยู่ที่ C:\Program Files\IBM\Lotus\Notes\Data\properties ตัวอย่างเช่น, acf-config.xml.sample, วางอยู่ในโฟลเดอร์นี้

เมื่อต้องการกำหนดคอนฟิก ACF, คุณต้องค้นหาไฟล์ xsp.properties ในโฟลเดอร์เดียวกันและเพิ่มบรรทัดต่อไปนี้: xsp.htmlfilter.acf.config=acf-config.xml ซึ่งบ่งชี้ว่า acf-config.xml จะถูกใช้เพื่อ กำหนดคอนฟิกเอ็นจิน “acf” (หรือ, กฎดีฟอลต์จะถูกใช้) ต่อไปนี้ คือตัวอย่างของไฟล์เนื้อหาไฟล์ acf-config.xml :
<?xml version="1.0"?>
<config>
       <filter-chain>
          <filter name='base' class='com.ibm.trl.acf.impl.html.basefilter.BaseFilter'
                  verbose-output='false' use-annotation='false' />
       </filter-chain>

			<filter-rule id='base'>
           <target scope=''>
             <!-- C14N rules -->
             <rule c14n='true' all='true' />

              <!-- Base rules -->
             <rule attribute='on' attribute-criterion='starts-with'
                 action='remove-attribute-value' />
             <rule attribute='${' attribute-criterion='starts-with'
                 action='remove-attribute-value' />
             <rule attribute='href' value='javascript:' value-criterion='contains'
                  action='remove-attribute-value' />
             <rule attribute='style' action='remove-attribute-value' />

              <rule tag='script' action='remove-tag' />
              <rule tag='style' action='remove-tag' />
              <rule tag='link' attribute='rel' value='stylesheet'
                   value-criterion='contains' action='remove-tag' />
            </target>
        </filter-rule>
</config>
ในตัวอย่างก่อนหน้านี้:
  • <rule attribute='on' attribute-criterion='starts-with' action='remove-attribute-value' /> ถอนแอ็ตทริบิวต์ ที่ขึ้นต้นด้วย "on"
  • <rule attribute='href' value='javascript:' value-criterion='contains' action='remove-attribute-value' /> ถอนแอ็ตทริบิวต์ 'href' ทั้งหมดที่มีค่าซึ่งมีคีย์เวิร์ด 'javascript:'
  • <rule tag='style' action='remove-tag' /> ถอนแท็ก "script" ทั้งหมด
  • <rule tag='link' attribute='rel' value='stylesheet' value-criterion='contains' action='remove-tag' /> ถอนแท็ก "link" ที่ค่าแอ็ตทริบิวต์ "rel" ตรงกับ "stylesheet"

สำหรับข้อมูลเพิ่มเติมเกี่ยวกับ Execution Control List โปรดดูที่วิธีใช้ Domino Administrator

การพร้อมต์ให้ผู้ใช้บันทึกการเปลี่ยนแปลงกับ XPages

คุณสามารถควบคุมวิธีการแสดงพร้อมต์แอ็พพลิคเชัน XPage ให้ผู้ใช้ เมื่อผู้ใช้ร้องขอแอ็คชันที่ปิดเพจด้วย ฟิลด์ที่ปรับเปลี่ยน

เกี่ยวกับภารกิจนี้
เมื่อ XPage หรือคอนโทรลแบบกำหนดเองมีคอนโทรลที่สามารถแก้ไขได้, คุณสามารถตั้งค่าสองคุณสมบัติเพื่อระบุวิธีการแสดงพร้อมต์แอ็พพลิเคชันให้ผู้ใช้ เกี่ยวกับคอนโทรลที่ปรับเปลี่ยนแล้ว คุณสมบัติเหล่านี้มีอยู่บนสองระดับ, XPage หรือระดับคอนโทรลแบบกำหนดเองและระดับคอนโทรลแบบคอร์
  • ระดับ 1: XPage หรือคอนโทรลแบบกำหนดเอง
    • enableModifiedFlag (บูลีน - ค่าโดยนัยดีฟอลต์คือค่าเท็จ) – ระบุเพื่อแสดงพร้อมต์ให้ผู้ใช้บันทึกการเปลี่ยนแปลงไปยังคอนโทรลแบบคอร์ใน XPage หรือคอนโทรลแบบกำหนดเอง, และเพื่อเปิดใช้งานอ็อพชันไคลเอ็นต์ Notes ไฟล์ > บันทึก เมื่อ XPage หรือคอนโทรลได้ถูกปรับเปลี่ยนในไคลเอ็นต์ Notes แอ็พพลิเคชันที่รันในเบราว์เซอร์ภายนอก ใช้กลไก Notes ไฟล์ > บันทึก, ดังนั้น เฉพาะไดอะล็อกเท่านั้นที่แสดงให้ผู้ใช้เห็น
    • modifiedMessage (สตริง) – ข้อความแบบกำหนดเองที่ต้องการแสดงใน ไดอะล็อกพร้อมต์
  • ระดับ 2: คอนโทรลแบบคอร์
    • disableModifiedFlag (บูลีน - ค่าโดยนัยดีฟอลต์คือค่าจริง) – ระบุว่าให้แสดงพร้อมต์ให้กับผู้ใช้เพื่อบันทึกการเปลี่ยนแปลงกับ คอนโทรลแบบคอร์
คุณสมบัติ enableModifiedFlag ใช้การนำหน้าสัมบูรณ์ เมื่อเปิดใช้งานหรือปิดใช้งานการแจ้งเตือนการปรับเปลี่ยนสำหรับ XPage ที่กำหนดไว้หรือคอนโทรลแบบกำหนดเอง ถ้าคุณตั้งค่าคุณสมบัตินี้ให้เป็นจริง, ผู้ใช้จะถูกแจ้งเตือนเกี่ยวกับการเปลี่ยนแปลงคอนโทรลแบบคอร์ที่สนับสนุนทั้งหมดภายใน XPage หรือคอนโทรลแบบกำหนดเอง, ยกเว้นว่าคุณตั้งค่าคอนโทรลแบบคอร์สำหรับค่าคุณสมบัติ disableModifiedFlag ให้เป็นจริง ถ้าคุณไม่ได้ตั้งค่า enableModifiedFlag สำหรับ XPage หรือคอนโทรลแบบกำหนดเอง, หรือคุณตั้งค่า ให้เป็นเท็จ, และคุณตั้งค่าคอนโทรลแบบคอร์สำหรับค่าคุณสมบัติ disableModifiedFlag ตั้งแต่หนึ่งค่าขึ้นไปให้เป็นเท็จ, ผู้ใช้จะไม่ได้รับการแจ้งเตือนเกี่ยวกับการเปลี่ยนแปลง, เนื่องจากคุณสมบัติ enableModifiedFlag ใช้การนำหน้า
คอนโทรลแบบคอร์ ต่อไปนี้สนับสนุนคุณลักษณะนี้:
  • กล่องแก้ไข
  • กล่องแก้ไขแบบหลายบรรทัด
  • กล่องรายการ
  • คอมโบบ็อกซ์
  • เช็กบ็อกซ์
  • ปุ่มแบบเรดิโอ
  • อัพโหลดไฟล์
  • ตัวเลือกวันที่ เวลา
  • เอดิเตอร์ Rich Text

ถ้าผู้ใช้เลือกที่จะไม่บันทึกการปรับเปลี่ยนในเพจ ปัจจุบัน, แอ็คชันที่ร้องขอ (เช่น การปิดเพจ, หรือการนำทาง ออกในเบราว์เซอร์) สามารถเรียใช้งานได้ ถ้าผู้ใช้เลือกเพื่อบันทึก การปรับเปลี่ยน, ฟิลด์ที่เกี่ยวข้องจะถูกตรวจสอบความถูกต้องก่อนที่เพจ จะถูกบันทึก การตรวจสอบความถูกต้องเกิดขึ้นในครั้งแรกบนไคลเอ็นต์และจากนั้นบนเซิร์ฟเวอร์ เมื่อการตรวจสอบความถูกต้องฝั่งไคลเอ็นต์ของฟิลด์เพจปัจจุบันเป็นผลสำเร็จเท่านั้น ที่สามารถเกิดการตรวจสอบความถูกต้องในฝั่งเซิร์ฟเวอร์ ถ้าการตรวจสอบความถูกต้องในฝั่งเซิร์ฟเวอร์ล้มเหลว, ผู้ใช้ถูกแสดงด้วยเพจปัจจุบันที่มีการละเมิดฟิลด์ และกำหนดโอกาสเพื่อแก้ไขเนื้อหาฟิลด์ เมื่อการตรวจสอบความถูกต้อง ฝั่งเซิร์ฟเวอร์เป็นผลสำเร็จ, แอ็คชันที่ร้องขอสามารถเรียกใช้งานได้

การรัน XPages ใน Notes บน เซิร์ฟเวอร์ Domino HTTP

แอ็พพลิเคชัน XPages บนเซิร์ฟเวอร์ ที่รันในไคลเอ็นต์ Notes สามารถนำมารันบนเซิร์ฟเวอร์ Domino HTTP แทน เพื่อประสิทธิภาพที่ดีขึ้น

โดยค่าดีฟอลต์ แอ็พพลิคชัน XPages บนเซิร์ฟเวอร์ที่รันในไคลเอ็นต์ Notes ที่ดำเนินการอยู่ผ่าน ชุดของข้อมูลที่ถ่ายโอนระหว่างเซิร์ฟเวอร์ และไคลเอ็นต์โดยใช้โปรโตคอล Notes คุณสามารถ กำหนดให้แอ็พพลิเคชันนั้นดำเนินการบนเซิร์ฟเวอร์ Domino แทนโดยใช้โปรโตคอล HTTP

ฟังก์ชันNotes จะทำงาน เหมือนกับเมื่อรันโหมด XPages ปกติ ตัวอย่างเช่น เมนูบริบท (เช่น File > Save, File > Replication, File > Open), การบันทึกเอกสารที่มี "คำหยาบ", JavaScript ฝั่งไคลเอ็นต์ และ อื่นๆ จะมีการทำงานเหมือนกัน ข้อยกเว้นหนึ่งนั้นคือคอมโพสิตแอ็พพลิเคชัน ไม่สามารถใช้ฟังก์ชันตัวแทนคุณสมบัติไคลเอ็นต์ เมื่อรันบน เซิร์ฟเวอร์

ข้อกำหนดของผู้ออกแบบ
บนแท็บ Launch สำหรับ คุณสมบัติแอ็พพลิเคชัน เมื่อ Open designated XPage (ไคลเอ็นมาตรฐาน)ได้รับผลกระทบ ให้เลือก รัน แอ็พพลิเคชัน XPages บนเซิร์ฟเวอร์โดยตรงบนเซิร์ฟเวอร์ Domino และ บันทึกแอ็พพลิเคชัน คุณสมบัตินี้ยังสามารถใช้ใน Notes ผ่านกล่องคุณสมบัติ สำหรับแอ็พพลิเคชัน
ดังนั้นคุณสามารถเปิดใช้การดำเนินการเซิร์ฟเวอร์ สำหรับแอ็พพลิเคชันทั้งหมดโดยการแทรกบรรทัดต่อไปนี้ในไฟล์ Notes notes.ini และรีสตาร์ท Notes:
XPagesRunRemoteAppsOnServer=1
ข้อกำหนดของรันไทม์Notes
ไคลเอ็นต์ Notes ควรมีบัญชี HTTP สำหรับเซิร์ฟเวอร์ที่มีแอ็พพลิเคชัน XPages ในการสร้างหรือดูบัญชี Notes ให้คลิก File > Preferences > Accounts สำหรับเอกสาร โปรดดูที่ "การสร้างและแก้ไขบัญชีจากการกำหนดค่าลักษณะ Notes" ในวิธีใช้ Notes

สามารถตั้งค่าบัญชีบนเซิร์ฟเวอร์ Domino และจัดเตรียม ให้กับไคลเอ็นต์ Notes

เมื่อ แอ็พพลิเคชัน XPages บนเซิร์ฟเวอร์ถูกเรียกใช้ในไคลเอ็นต์ Notes ตัวประมวลผล XPages จะค้นหา บัญชี HTTP สำหรับเซิร์ฟเวอร์ที่มีแอ็พพลิเคชัน และโหลด แอ็พพลิเคชัน

เฟรมเวิร์กบัญชี Notes และเบราว์เซอร์ XULRunner พื้นฐานจะส่ง ข้อมูลประจำตัวผู้ใช้ไปยังเว็บเซิร์ฟเวอร์โดยอัตโนมัติสำหรับการพิสูจน์ตัวตน หาก ผู้ใช้ได้รับพร็อมต์สำหรับชื่อและรหัสผ่าน แสดงว่าการกำหนดคอนฟิกNotes มีการตั้งค่าที่ไม่ถูกต้อง ตัวอย่างเช่น SSO ไม่ถูกต้อง คุณสามารถตรวจสอบโดยการป้อน URL สำหรับแอ็พพลิเคชันในวิดเจ็ตที่อยู่เบาว์เซอร์ Notes บนแถบเครื่องมือ Notes

หาก ไม่มีบัญชี HTTP ที่ตรงกันอยู่ ผู้ใช้กำลังจะถูกกำหนดให้ป้อนข้อมูลประจำตัว นอกจากจะอนุญาตให้มีการเข้าถึงแบบไม่ระบุชื่อ อย่างไรก็ตามบัญชี HTTP ที่มีอยู่สามารถบังคับด้วยตัวแปร notes.ini ต่อไปนี้:
XPagesRunOnServerRequireAccount=1
หาก ต้องมีบัญชีที่ตรงกันแต่ไม่พบ หรือข้อมูลบัญชี ไม่ถูกต้อง ผู้ใช้จะได้รับพร้อมต์เพื่อปิดหน้าต่างแอ็พพิลเคชัน หรือ ย้อนกลับไปรันแอ็พพลิเคชันโดยใช้โปรแกรมบรรจุเว็บ Notes แบบโลคัล
ตัวแปร notes.ini ต่อไปนี้ ปิดใช้งานการรัน XPages ใน Notes บน เซิร์ฟเวอร์:
XPagesRunOnServerDisable=1
พื้นหลังผลการปฏิบัติงาน
แอ็พพลิเคชัน XPages ที่รันในไคลเอ็นต์ Notes แต่อยู่ในเซิร์ฟเวอร์ Domino แบบรีโมต เผชิญกับความท้ายทายด้านประสิทธิภาพเฉพาะ ซึ่งเป็นส่วนใหญ่ เนื่องจาก ทรานเซสชั่นบนเครือข่ายจำนวนมากต้องดำเนินการเมื่อประมวลผล แอ็พพลิเคชัน XPages ในไคลเอ็นต์ Notes สิ่งสำคัญต้องเข้าใจว่าแอ็พพลิเคชัน XPages Notes จะรันอยูในโปรแกรมบรรจุเว็บ Notes XPD แบบโลคัล และดังนั้น คลาสทั้งหมดของ XPages Java (XPages และคอนโทรลแบบกำหนดเอง) ต้องถูกคัดลอกข้ามเครือข่ายจาก เซิร์ฟเวอร์แบบรีโมตไปยังไคลเอ็นต์ Notes ที่จะประมวลผล ในทำนองเดียวกัน รีซอร์สของเพจทั้งหมด (CSS, JavaScript, GIFs, และอื่นๆ ) ต้องถูกเรียกจากเซิร์ฟเวอร์แบบรีโมต รวมถึง ข้อมูลจริง ยิ่งไปกว่านั้น หากแอ็พพลิเคชัน XPages ของคุณใช้โปรแกรมการออกแบบ Notesอื่นๆ (ตัวอย่างเช่น การใช้ คุณลักษณะ computeWithForm) อิลีเมนต์ การออกแบบขนาดใหญ่ที่ไม่มีกฏเกณฑ์ เช่น ฟอร์ม, ฟอร์มย่อย และฟิลด์ที่แบ่งใช้ต้อง ถูกเรียกแบบรีโมตด้วย บนเครือข่ายศักยภาพสูง สิ่งนี้อาจทำให้ เกิดผลกระทบด้านประสิทธิภาพที่สำคัญ โดยเฉพาะหากแอ็พพลิเคชันของคุณ ถูกออกแบบมาสำหรับเว็บ และไม่เหมาะสำหรับไคลเอ็นต์ Notes

การแปลแอ็พพลิเคชัน XPages

เมื่อแปล XPages และคอนโทรลแบบกำหนดเอง ห้ามทำสำเนา ใหม่สำหรับแต่ละภาษา เนื่องจากกลไกการแปลของ XPage มีความแตกต่างจากกลไกสำหรับอิลีเมนต์การออกแบบIBM Notes ที่ไม่ใช่ XPage

เกี่ยวกับภารกิจนี้
ในกลไกการแปล XPage, ข้อความที่สามารถแปลได้ แตกออกจาก XPage ในไฟล์ที่แยกออกโดยกระบวนการทำให้เป็นอัตโนมัติ จากนั้น คุณจัดเตรียมการแปลของไฟล์นั้นในภาษาอื่น XPage กำหนดไฟล์ที่แปลที่จะใช้อิงตามภาษา ของเว็บเบราว์เซอร์ หรือไคลเอ็นต์ Notes

สำหรับ คำสั่งการแปล XPages โปรดดูที่ "XPages: วิธีใช้ตัวเลือกการแปลเพื่อท้องถิ่น " ในวิกิ Domino Designer

การออกแบบสำเนา XPages เดี่ยว

คุณสามารถเก็บอิลิเมนต์ออกแบบ XPage ในหนึ่งฐานข้อมูลและ เปลี่ยนทิศทางฐานข้อมูลอื่นๆ ที่นั่น ณ รันไทม์

เกี่ยวกับภารกิจนี้

สำเนา XPages เดี่ยวปรับปรุงผลการทำงานโดยใช้หนึ่งตำแหน่ง สำหรับหน่วยเก็บอ็อบเจ็กต์และการเข้าถึงเบราว์เซอร์ อิลิเมนต์การออกแบบที่ได้รับผลกระทบคือ XPages, คอนโทรลแบบกำหนดเอง, ไลบรารี JavaScript, สไตล์ชีต, และธีม เมื่อต้องการสั่งฐานข้อมูลให้ใช้ที่เก็บสำหรับอิลิเมนต์ XPage ณ รันไทม์:

กระบวนการ

  1. ในบานหน้าต่างด้านซ้าย, ให้เลือก คุณสมบัติแอ็พพลิเคชัน
  2. ในบานหน้าต่างกึ่งกลางด้านบน, ให้เลือกแท็บ XPages
  3. เลื่อนลงไปยัง ผลการทำงาน
  4. ทำเครื่องหมาย คัดลอกการออกแบบ XPage เดี่ยว
  5. ระบุชื่อของ NSF ที่มีอิลิเมนต์การออกแบบ XPages ชื่อที่เกี่ยวข้องจะเกี่ยวข้องกับไดเร็กทอรีข้อมูล Notes

ผลลัพธ์

แอ็พพลิเคชันที่มีอิลิเมนต์การออกแบบต้องเป็นไฟล์ NSF

อิลิเมนต์การออกแบบ XPages ทั้งหมดต้องอยู่ในที่เก็บ หรือไม่ คุณไม่สามารถลบล้างหรือเลือกอิลิเมนต์การออกแบบเดี่ยวได้

คุณ ไม่สามารถเปลี่ยนค่าติดตั้งสำเนาเดี่ยวแบบไดนามิก

อิลิเมนต์ที่แบ่งใช้ ถูกจำกัดอิลิเมนต์ XPages ตามที่นับได้ แบบฟอร์ม และมุมมอง, เป็นต้น, ไม่สามารถแบ่งใช้ได้

การเพิ่มคอนโทรล

คอนโทรลคืออิลิเมนต์ที่มองเห็นได้ เช่น กล่องแก้ไข, ปุ่ม, อิมเมจ, และข้อความที่ยอมให้ผู้ใช้จัดการกับข้อมูลบน XPage

คอนโทรลคือชนิดต่อไปนี้: คอร์, คอนเทนเนอร์, และอื่นๆ

ชื่อแท็กระบุแต่ละคอนโทรลใน XML ชื่อทั่วไป จะปรากฏขึ้นในส่วนติดต่อผู้ใช้ ตัวอย่างเช่น, ชื่อแท็กสำหรับกล่องแก้ไข คือ inputText ขณะที่ชื่อทั่วไปคือ กล่องแก้ไข ซึ่งเป็นหัวข้อที่อ้างถึง ที่ตามหลังตัวระบุคอนโทรลตามชื่อแท็กและชื่อทั่วไป

ถาดสี คอนโทรล และเมนู สร้าง แสดงคอนโทรลชนิดคอร์และคอนเทนเนอร์ตามค่าดีฟอลต์ เลือก อื่นๆ เพื่อเข้าถึงคอนโทรลทั้งหมด คุณสามารถปรับการแสดงผลคอนโทรลที่ ไฟล์ > การกำหนดค่าตามความชอบ > Domino Designer > ถาดสี

การจัดการกับคอนโทรลและข้อความ

คุณสามารถเพิ่มคอนโทรลและข้อความให้กับ XPage ได้โดยใช้เอดิเตอร์ ออกแบบ หรือ แหล่งที่มา ถาดสี คอนโทรล จัดเตรียมแหล่งที่มา สำหรับคอนโทรล

ถาดสี คอนโทรล ปรากฏขึ้นในหน้าต่าง ทางด้านข้างของเอดิเตอร์ ถ้าไม่มีอยู่ที่นั้น, ให้คลิก หน้าต่าง > แสดงมุมมอง Eclipse > คอนโทรล

คุณสามารถลากคอนโทรลจกาถาดสีไปยังเอดิเตอร์ได้ (ทั้ง ออกแบบ และ แหล่งที่มา) หรือคุณสมารถหาตำแหน่งเคอร์เซอร์ในเอดิเตอร์ จากนั้นดับเบิลคลิก คอนโทรลบนถาดสี คุณยังสามารถใช้ สร้าง > คอนโทรลแบบคอร์ หรือ สร้าง > คอนโทรลคอนเทนเนอร์ จากเมนูได้

คุณสามารถย้าย, ปรับขนาด, ตัด, คัดลอก, วาง, และลบคอนโทรล ได้ตามปกติ

คุณสามารถเพิ่มข้อความและการขึ้นบรรทัดใหม่ให้กับ XPage

การวางตำแหน่งเคอร์เซอร์บนคอนโทรลในเอดิเตอร์ ออกแบบ ทำให้คุณสมบัติพร้อมใช้งาน การวางตำแหน่งเคอร์เซอร์ภายนอก คอนโทรลทั้งหมดทำให้คุณสมบัติ XPage พร้อมใช้งาน

คุณยังสามารถดำเนินการจัดการ XPage บางอย่างจากมุมมอง โครงร่าง

การตั้งค่าคุณสมบัติ

คุณสมบัตินิยาม XPages และคอนโทรล

คุณสมบัติปรากฏขึ้นในหน้าต่างภายใต้เอดิเตอร์ คุณสมบัติ ที่ปรากฏขึ้นใช้สำหรับคอนโทรลในโฟกัสในเอดิเตอร์, หรือใช้สำหรับ XPage หากโฟกัสอยู่ภายนอกคอนโทรลทั้งหมด

เลือก คุณสมบัติทั้งหมด ภายใต้แท็บ คุณสมบัติ เพื่อเข้าถึงรายการที่จัดหมวดหมู่แล้วของคุณสมบัติทั้งหมดสำหรับคอนโทรลหรือ XPage ที่นี่ คุณสมบัติถูกระบุไว้โดยชื่อแท็กตามตัวอักษร ให้ทำการเลือกใหม่ ภายใต้แท็บ คุณสมบัติ และ เหตุการณ์ เพื่อเข้าถึงเซ็ตย่อยของคุณสมบัติที่มีส่วนการติดต่อผู้ใช้ที่ออกแบบแล้ว ที่นี่ คุณสมบัติถูกเข้าถึงด้วยชื่อเชิงอธิภาย

กำหนดค่าให้กับคุณสมบัติดังต่อไปนี้:
  • ค่าแบบสแตติกถูกเลือกจากรายการหรือการพิมพ์
  • ค่าแบบไดนามิกถูกระบุไว้ด้วยสคริปต์ที่ส่งคืนค่า ไดมอนถัดจากคุณสมบัติจะเปิดเอดิเตอร์สคริปต์
  • เหตุการณ์ถูกระบุไว้ด้วยสคริปต์ฝั่งไคลเอ็นต์และฝั่งเซิร์ฟเวอร์ รวมถึงแอ็คชันพื้นฐาน ซึ่งเป็นการดีในการระบุสคริปต์และแอ็คชันพื้นฐาน บนแท็บ เหตุการณ์
ใน XML ต้นฉบับ, คุณสมบัติปรากฏขึ้นเป็นแอ็ตทริบิวต์ และเนื้อหาสำหรับอิลิเมนต์คอนโทรล ตัวอย่างเช่น, นี่คือคอนโทรล inputText (กล่องแก้ไข) ที่มีคุณสมบัติ id และ value ซึ่งนิยามไว้เป็นแอ็ตทริบิวต์:
<xp:inputText id="inputText1" value="#{document1.subject}"></xp:inputText>
ที่นี่ คุณสมบัติ value ถูกนิยามเป็นเนื้อหา สำหรับนิยามคอนโทรล:
<xp:inputText id="inputText1">
	<xp:this.value>
		<![CDATA[#{javascript:return document1.getItemValueString("subject")}]]>
	</xp:this.value>
</xp:inputText>
คุณสมบัติแบบไดนามิกถูกคำนวณดังต่อไปนี้ ใช้ปุ่มแบบเรดิโอในหน้าต่างการแก้ไข เพื่อเลือกหนึ่งค่าหรือค่าอื่น
  • คำนวณแบบไดนามิก คำนวณสูตรใหม่ เมื่อใดก็ตามที่รีเฟรช XPage สูตรเหล่านี้ปรากฏขึ้นในซอร์ส ที่นำหน้าด้วยเครื่องหมายสี่เหลี่ยม, ตัวอย่างเช่น, #{javascript:var dc = database.getAllDocuments(); "Count = " + dc.getDocumentCount();}
  • คำนวณบนเพจโหลด คำนวณสูตร เมื่อโหนด XPage ในครั้งแรก สูตรเหล่านี้ปรากฏขึ้นใน ซอร์สที่นำหน้าด้วยเครื่องหมายดอลล่าร์, ตัวอย่างเช่น, ${javascript:var dc = database.getAllDocuments(); "Count = " + dc.getDocumentCount();}

การทำความเข้าใจกับเหตุการณ์

เหตุการณ์คือแอ็คชันที่ผู้ใช้อาจต้องดำเนินการ เช่น การคลิกปุ่มหรือถอนโฟกัสออกจากกล่องแก้ไข ตัวจัดการเหตุการณ์คือแอ็คชัน ที่คุณ (ผู้ออกแบบ) ดำเนินการเพื่อตอบกลับเหตุการณ์

ตัวจัดการเหตุการณ์คือส่วนหนึ่งของคอนโทรลหรือส่วนของ XPage

ตัวจัดการเหตุการณ์สามารถเป็นสคริปต์, แอ็คชันพื้นฐาน, หรือ กลุ่มแอ็คชันพื้นฐาน สำหรับหนึ่งเหตุการณ์, ตัวจัดการสามารถระบุเพื่อรันบนไคลเอ็นต์, เซิร์ฟเวอร์, หรือทั้งสอง ตัวจัดการไคลเอ็นต์สามารถหยุดการเรียกทำงานตัวจัดการไคลเอ็นต์ และเรียกทำงานการยกเลิกของตัวจัดการเซิร์ฟเวอร์โดยส่งคืน false

ถ้าคุณกำลังทำงานในโหมดการออกแบบ, ให้วางโฟกัสไว้บนคอนโทรลที่เหมาะสม หรือเพจที่เหมาะสม, คลิกแท็บ เหตุการณ์, และเลือกเหตุการณ์ที่ต้องการ จากนั้น คุณสามารถระบุตัวจัดการเหตุการณ์

เหตุการณ์ถูกใช้เป็นคุณสมบัติและปรากฏขึ้นบน คุณสมบัติทั้งหมด ภายใต้ คุณสมบัติ อย่างไรก็ตาม แนวปฏิบัติที่เหมาะสมคือ ไม่สร้างหรือปรับเปลี่ยนเหตุการณ์จาก คุณสมบัติทั้งหมด ใช้แท็บ เหตุการณ์ หรือซอร์ส XML

ตัวจัดการเหตุการณ์เซิร์ฟเวอร์

รูปแบบทั่วไปสำหรับ ตัวจัดการเหตุการณ์เซิร์ฟเวอร์มีดังต่อไปนี้ในโหมดแหล่งที่มา ถ้าคุณกำลังทำงานใน โหมดการออกแบบ, ให้เลือกแท็บ เหตุการณ์ จากนั้น เลือกแท็บ เซิร์ฟเวอร์
<xp:eventHandler event="name" submit="true|false"
	refreshMode="complete|partial|norefresh" refreshId="id"
	immediate="true|false"	execMode="partial|full">
	<xp:this.action>
		<![CDATA[#{javascript:textOfScript}]]> <!-- script -->
		<xp:actionName arguments</xp:actionName> <!-- or simple action -->
		<xp:actionGroup condition="#{javascript:textOfScript}"> <!-- or simple action group -->
			actions and embedded groups
		</xp:actionGroup>
	</xp:this.action>
	<xp:this.parameters>
		<xp:this.parameter name="name" value"value"</xp:this.parameter> ...
	</xp:this.parameters>
</xp:eventHandler>
โดยที่:
  • event ระบุชื่อของเหตุการณ์, ตัวอย่างเช่น, onblur หรือ onclick ถ้าคุณกำลังทำงานบนแท็บ เหตุการณ์, ให้เลือกเหตุการณ์ที่เหมาะสม
  • submit="true" สาเหตุที่ทำให้คำร้องขอถูกส่งไปยัง เซิร์ฟเวอร์เมื่อผู้ใช้เรียกทำงานเหตุการณ์ ค่าอื่นใดสำหรับ submit ยกเลิกการเรียกทำงานเหตุการณ์ ถ้าคุณกำลังทำงานบนแท็บ เหตุการณ์, ให้คลิก No Submission เพื่อถอนเหตุการณ์
  • refreshMode คือหนึ่งในค่าต่อไปนี้:
    • complete รีโหลดเพจทั้งหมดไปยังไคลเอ็นต์ หลังจากที่เซิร์ฟเวอร์ประมวลผลคำร้องขอ ถ้าคุณกำลังทำงานบนแท็บ เหตุการณ์, ให้คลิก อัพเดตทั้งหมด
    • partial รีโหลดส่วนที่เลือกไว้ของเพจ โดยใช้อะซิงโครนัส JavaScript และเทคโนโลยี XML (AJAX) ถ้าคุณกำลังทำงานบนแท็บ เหตุการณ์, ให้คลิก อัพเดตบางส่วน
    • norefresh ไม่รีโหลดเพจ ถ้าคุณกำลัง ทำงานบนแท็บ เหตุการณ์, ให้คลิก ไม่อัพเดต
  • refreshId ใช้เฉพาะสำหรับ refreshMode="partial" และระบุคอนโทรลที่ต้องถูกอัพเดต ถ้าคุณกำลังทำงานบนแท็บ เหตุการณ์, ให้คลิก เลือกอิลิเมนต์
  • immediate="true" ยับยั้งการตรวจสอบข้อมูล บนเซิร์ฟเวอร์ สำหรับการประมวลผลข้อมูล, ให้ละเว้นแอ็ตทริบิวต์นี้หรือระบุแอ็ตทริบิวต์อื่น แต่ true ถ้าคุณกำลังทำงานบนแท็บ เหตุการณ์, ให้คลิก ห้ามตรวจสอบความถูกต้องหรืออัพเดตข้อมูล
  • execMode="partial" ระบุการรีเฟรชบางส่วน เมื่อแฟรกเมนต์โค้ดถูกเรียกใช้งาน สำหรับการรีเฟรชทั้งหมด, ให้ละเว้นแอ็ตทริบิวต์นี้ หรือระบุแอ็ตทริบิวต์อื่น แต่ partial ถ้าคุณกำลังทำงานบนแท็บ เหตุการณ์, ให้คลิก โหมดตั้งค่า การเรียกทำงานเป็นบางส่วน
  • action ระบุอย่างใดอย่างหนึ่ง:
    • สคริปต์ โดยที่ textOfScript คือโค้ดของคุณ ถ้า คุณกำลังทำงานบนแท็บ เหตุการณ์, ให้คลิก เอดิเตอร์สคริปต์ ป้อนสคริปต์ในหน้าต่างสคริปต์หรือเปิด ไดอะล็อกสคริปต์
    • ชื่อของแอ็คชันพื้นฐานและอาร์กิวเมนต์ ถ้าคุณกำลังทำงานบนแท็บ เหตุการณ์, ให้คลิก แอ็คชันพื้นฐาน ใช้ปุ่มต่างๆ และรายการต่างๆ เพื่อสร้าง และแก้ไขแอ็คชันพื้นฐาน
    • actionGroup ซึ่งสามารถมีแอ็คชันพื้นฐาน และกลุ่มแอ็คชันอื่นๆ ได้ เงื่อนไขเป็นแบบเผื่อเลือก คุณสามารถระบุ กลุ่มจำนวนมากได้
  • parameters ระบุชื่อและค่าของ พารามิเตอร์เหตุการณ์ใดๆ ถ้าคุณกำลังทำงานบนแท็บ เหตุการณ์, ให้คลิก แก้ไขพารามิเตอร์เหตุการณ์

ตัวจัดการเหตุการณ์ไคลเอ็นต์

รูปแบบทั่วไปสำหรับ ตัวจัดการเหตุการณ์ที่เป็นสคริปต์ไคลเอ็นต์มีดังต่อไปนี้ ถ้าคุณกำลังทำงาน ในโหมดการออกแบบ, ให้เลือกแท็บ เหตุการณ์ จากนั้นเลือกแท็บ ไคลเอ็นต์
<xp:eventHandler event="name" submit="false"
	<xp:this.script>
		<![CDATA[[textOfScript]]> <!-- script -->
		<xp:actionName arguments</xp:actionName> <!-- or simple action -->
		<xp:scriptGroup conditionScript="textOfScript"> <!-- or simple action group -->
			actions and embedded groups
		</xp:scriptGroup>
	</xp:this.script>
</xp:eventHandler>
โดยที่:
  • event ระบุชื่อของเหตุการณ์, ตัวอย่างเช่น, onblur หรือ onclick ถ้าคุณกำลังทำงานบนแท็บ Events, ให้เลือกเหตุการณ์ที่เหมาะสม
  • submit="false" หมายถึงไม่มีคำร้องขอที่ส่งไปยังเซิร์ฟเวอร์ เมื่อผู้ใช้เรียกทำงานเหตุการณ์ สิ่งนี้จำเป็นต้องมีสำหรับ สคริปต์ไคลเอ็นต์
  • script ระบุอย่างใดอย่างหนึ่ง:
    • สคริปต์ โดยที่ textOfScript คือโค้ดของคุณ ถ้า คุณกำลังทำงานบนแท็บ เหตุการณ์, ให้คลิก เอดิเตอร์สคริปต์ ป้อนสคริปต์ในหน้าต่างสคริปต์หรือเปิด ไดอะล็อกสคริปต์
    • ชื่อของแอ็คชันพื้นฐานและอาร์กิวเมนต์ ถ้าคุณกำลังทำงานบนแท็บ เหตุการณ์, ให้คลิก แอ็คชันพื้นฐาน ใช้ปุ่มต่างๆ และรายการต่างๆ เพื่อสร้าง และแก้ไขแอ็คชันพื้นฐาน
    • scriptGroup ซึ่งสามารถมีแอ็คชันพื้นฐาน และกลุ่มแอ็คชันอื่นๆ ได้ เงื่อนไขเป็นแบบเผื่อเลือก คุณสามารถระบุ กลุ่มจำนวนมากได้

ส่งและยกเลิกตัวจัดการเหตุการณ์

ปุ่มของชนิด Submit สร้างตัวจัดการเหตุการณ์ของ แบบฟอร์มต่อไปนี้:
<xp:eventHandler event="onclick" submit="true"
	refreshMode="complete" immediate="false" save="true">
</xp:eventHandler>
ปุ่มของชนิด Cancel สร้างตัวจัดการเหตุการณ์ของแบบฟอร์มต่อไปนี้:
<xp:eventHandler event="onclick" submit="true"
	refreshMode="complete" immediate="true" save="false">
</xp:eventHandler>
โปรดสังเกตว่า save="true" สำหรับปุ่ม Submit และ save="false" สำหรับปุ่ม Cancel

การรวมตัวจัดการเหตุการณ์ในฝั่งเซิร์ฟเวอร์และไคลเอ็นต์

ฝั่งไคลเอ็นต์ โค้ด JavaScript สามารถทริกเกอร์ตัวจัดการเหตุการณ์ฝั่งเซิร์ฟเวอร์ได้ พารามิเตอร์แรกต้อง เป็นผ่านที่ผ่านการรับรองโดยสมบูรณ์ไปยังตัวจัดการเหตุการณ์, แทนที่จะเป็นเพียง id ของตัวจัดการเหตุการณ์ฝั่งเซิร์ฟเวอร์ พารามิเตอร์นี้อนุญาตให้คุณเรียกตัวจัดการเหตุการณ์ ที่ถูกฝังในคอนโทรลแบบกำหนดเองเช่นกัน คุณสามารถขอรับ id ของตัวจัดการเหตุการณ์ในฝั่งเซิร์ฟเวอร์และส่งผ่านไปยังสคริปต์ไคลเอ็นต์ เนื่องจากคุณต้องการคอนโทรลอื่นใดๆ (ตัวอย่างเช่น การใช้ # {id:eventhanderId} หรือฟังก์ชัน SSJS getClientId())

ตัวจัดการ เหตุการณ์ถูกเรียกใช้งานภายในคอนเท็กซ์ที่คุณระบุไว้ ตัวอย่างเช่น, การระบุตัวจัดการเหตุการณ์ด้วย id ของ view:_id1:repeatCtrl:0:_id33:eventhandler1 จะเรียกใช้งานกับไอเท็มแรกใน xp:repeat ที่มี id ของ repeatCtrl, ขณะที่ view:_id1:repeatCtrl:1:_id33:eventhandler1 จะเรียกทำงานพร้อมกับไอเท็มที่สอง

การจัดการฝั่งไคลเอ็นต์ ถูกทริกเกอร์ด้วยปุ่มหรืออิลิเมนต์ส่วนติดต่อผู้ใช้อื่น, และส่งข้อมูล ไปยังเซิร์ฟเวอร์ที่ต้องถูกจัดการโดยการจัดการเหตุการณ์ฝั่งเซิร์ฟเวอร์ ถ้าคุณกำลังทำงานในโหมดการออกแบบ, ให้เลือกแท็บ เหตุการณ์ จากนั้นเลือกแท็บ ไคลเอ็นต์
<button dojoType="dijit.form.Button" type="button"
	onClick="XSP.executeOnServer('# {id:eventhandler1a}', '# {id:panel1}')">
	Click To Trigger Server Event Handler
</button>

<xp:eventHandler event="name" id="eventhandler1a">
	<xp:this.action>
		<xp:saveDocument />
	</xp:this.action>
</xp:eventHandler>
ถ้าคุณกำลังทำงานใน โหมดการออกแบบ, ให้เลือกแท็บ เหตุการณ์ จากนั้น เลือกแท็บ เซิร์ฟเวอร์
XSP.executeOnServer = function () {
	// the event handler id to be executed is the first argument, and is required
	if (!arguments[0])
		return false;
	var functionName = arguments[0];

	// OPTIONAL - The Client Side ID that is partially refreshed after executing the event handler
	var refreshId = (arguments[1]) ? arguments[1] : "@none";
	var form = (arguments[1]) ? this.findForm(arguments[1]) : dojo.query('form')[0];
       
	// catch all in case dojo element has moved object outside of form...
	if (!form)
		form = dojo.query('form')[0];

	// OPTIONAL - Options object containing onStart, onComplete and onError functions for the call to the
	// handler and subsequent partial refresh
	var options = (arguments[2]) ? arguments[2] : {};

	// OPTIONAL - Value to submit in $$xspsubmitvalue. can be retrieved using context.getSubmittedValue()
	var submitValue = (arguments[3]) ? arguments[3] : '';

	// Set the ID in $$xspsubmitid of the event handler to execute
	dojo.query('[name="$$xspsubmitid"]')[0].value = functionName;
	dojo.query('[name="$$xspsubmitvalue"]')[0].value = submitValue;
	this._partialRefresh("post", form, refreshId, options);
}	

การทำความเข้าใจกับ facets

facet นิยามขอบเขตในคอนโทรลสำหรับการวางตำแหน่ง ของคอนโทรลอื่น

คอนโทรลอาจหรืออาจไม่สร้างการแสดงผล facet ขึ้นอยู่กับคอนโทรล และเนื้อหาของ facet

การใช้งานแบบพิเศษสำหรับ facets คือการวางตำแหน่งของเพจเจอร์ในมุมมอง การใช้งาน แบบทั่วไปสำหรับ facets คือการวางตำแหน่งของพาเนลในคอนโทรลอื่นๆ นี่คือซอร์สโค้ดตัวอย่างสำหรับมุมมอง โปรดสังเกตว่า ขอบเขต facets จะปรากฏขึ้นเป็นแอ็ตทริบิวต์ของคอนโทรลพาเรนต์และมี คอนโทรลอื่นๆ อยู่
<xp:viewPanel rows="30" id="viewPanel1">
	<xp:this.facets>
		<xp:pager partialRefresh="true" layout="Previous Group Next"
			xp:key="headerPager" id="pager1">
		</xp:pager>
	</xp:this.facets>
	<xp:this.data>
		<xp:dominoView var="view2" viewName="main"></xp:dominoView>
	</xp:this.data>
	<xp:viewColumn columnName="subject" id="viewColumn1">
		<xp:viewColumnHeader value="subject" id="viewColumnHeader1"></xp:viewColumnHeader>
	</xp:viewColumn>
	<xp:viewColumn columnName="fruit" id="viewColumn2">
		<xp:viewColumnHeader value="fruit" id="viewColumnHeader2"></xp:viewColumnHeader>
	</xp:viewColumn>
</xp:viewPanel>

ข้อมูลจำเพาะของ xp:key คือสิ่งประดิษฐ์ของ facets ที่ไม่ใช่คุณสมบัติของคอนโทรลอื่น ค่าที่แสดง เหมาะสมกับเพจเจอร์ในมุมมอง สำหรับพาเนล, ให้ใช้หนึ่งในค่าต่อไปนี้ เพื่อระบุตำแหน่งของคอนโทรลอื่นในพาเรนต์: east, west, south, north, southwest, southeast, northwest, และ northeast

โค้ดตัวอย่างต่อไปนี้มีพาเนลที่แสดงสองลิงก์ (Inbox และ Outbox) และอิมเมจ ลิงก์แรกจัดเตรียมเหตุการณ์ onclick ไว้
<xp:viewPanel>
	<xp:this.facets>
		<xp:panel xp:key="west">
			<xp:link text="Inbox" >
				<xp:eventHandler event="onclick" submit="true">
					<xp:this.action>
					</xp:this.action>
				</xp:eventHandler>
			</xp:link>
			<xp:br/>
			<xp:link  text="Outbox" />
			<xp:br/>
			<xp:image id="viewPickerImage"
				value="/images/sampleViewPicker.gif" />
		</xp:panel>
	</xp:this.facets>
<xp:viewPanel>

Facets ไม่สามารถมองเห็นได้ในโหมดการออกแบบ คุณต้องใช้โหมดแหล่งที่มา เพื่อสร้างและแก้ไข facets โดยตรง

การทำความเข้าใจกับวิดเจ็ต Dojo

วิดเจ็ต Dojo ถูกจัดทำเป็นแพ็กเกจล่วงหน้าด้วยโค้ด JavaScript, HTML, และการประกาศ CSS ที่พัฒนาลักษณะที่ปรากฏและใช้คอนโทรลทั้งในเบราว์เซอร์ และไคลเอ็นต์ Notes

วิดเจ็ต Dojo สามารถใช้ได้บนคอนโทรลต่อไปนี้: กล่องแก้ไข, Rich Text, กล่องแก้ไขแบบหลายบรรทัด, ปุ่ม, เช็กบ็อกซ์, ปุ่มแบบเรดิโอ, ตัวเลือก วันที่ เวลา, แตกเนื้อหา, พาเนล, ตาราง, Div

ใน Domino 8.5.3, ไฟล์ Dojo อยู่ภายใต้ domino\js\dojo-1.5.0\dijit ในไดเร็กทอรีข้อมูล Notes ใน Domino 8.5.2, ไฟล์เหล่านี้อยู่ภายใต้ domino\js\dojo-1.4.1\dijit

แอ็พพลิเคชันควรอ้างถึงไฟล์ Dojo ผ่าน /.ibmxspres/dojoroot/ ซึ่งแม็พกับเวอร์ชันที่สนับสนุน

สำหรับข้อมูลเพิ่มเติมเกี่ยวกับ Dojo, โปรดดูที่ http://api.dojotoolkit.org

การทำให้รีซอร์ส Dojo พร้อมใช้งานบน XPage

รีซอร์ส Dojo ต้องถูกทำให้ใช้งานก่อนที่จะใช้กับ คอนโทรล

เกี่ยวกับภารกิจนี้
เมื่อต้องการทำให้รีซอร์ส Dojo พร้อมใช้งานบน XPage:
กระบวนการ
  1. วางโฟกัสบน XPage เอง
  2. เลือก Dojo บนแท็บ คุณสมบัติ
  3. ตั้งค่า dojoTheme ให้มีค่าจริง
  4. เลือก รีซอร์ส บนแท็บ คุณสมบัติ
  5. สำหรับแต่ละวิดเจ็ตที่คุณต้องการทำให้พร้อมใช้งาน:
    1. คลิก เพิ่ม และเลือก โมดูล Dojo
    2. ระบุชื่อโมดูล Dojo, ตัวอย่างเช่น, dijit.form.NumberSpinner
    3. (เผื่อเลือก) ระบุเงื่อนไข - สคริปต์ที่ประเมินค่า เป็นจริงหรือเท็จ
    4. คลิก ตกลง

การใช้วิดเจ็ต Dojo กับคอนโทรล

เมื่อรีซอร์ส Dojo พร้อมใช้งานบน XPage, คุณสามารถใช้รีซอร์สเหล่านั้นกับคอนโทรลได้

เกี่ยวกับภารกิจนี้
เมื่อต้องการใช้วิดเจ็ต Dojo กับคอนโทรล เช่น กล่องแก้ไข:
กระบวนการ
  1. วางโฟกัสบนคอนโทรล
  2. เลือก Dojo บนแท็บ คุณสมบัติ
  3. ตั้งค่า ชนิด Dojo ไปเป็นชื่อของรีซอร์สโมดูล Dojo, ตัวอย่างเช่น, dijit.form.NumberSpinner ภายใต้ คุณสมบัติทั้งหมด, สิ่งนี้คือ dojoType
  4. เมื่อต้องการตั้งค่าแอ็ตทริบิวต์:
    1. คลิกไอคอน เพิ่ม
    2. ระบุชื่อของแอ็ตทริบิวต์, ตัวอย่างเช่น, value หรือ smallDelta สำหรับ dijit.form.NumberSpinner
    3. ระบุค่าของแอ็ตทริบิวต์, ตัวอย่างเช่น, 100 สำหรับ value หรือ 5 สำหรับ smallDelta ใน dijit.form.NumberSpinner
    ภายใต้ คุณสมบัติทั้งหมด, สิ่งนี้คือ dojoAttributes
ผลลัพธ์
ถ้าคุณบันทึกและแสดงตัวอย่าง dijit.form.NumberSpinner ที่ใช้กับคอนโทรล กล่องแก้ไข, คุณจะมองเห็นลูกศรขึ้นและลง (ตัวปั่น) บนด้านของกล่องแก้ไข ค่าเริ่มต้นของกล่องแก้ไขคือ แอ็ตทริบิวต์ value เมื่อคุณคลิกลูกศร ขึ้น และ ลง, ค่าจะเพิ่มและลดตามแอ็ตทริบิวต์ smallDelta

การอ้างถึงคอนโทรล

สิ่งที่ระบุไว้ที่นี่คือคอนโทรล XPages

br - เส้นแบ่ง

แทรกตัวแบ่งในข้อความ

หมวดหมู่
คอนโทรลชนิดคอร์
ไวยากรณ์
<xp:br attributes>content</xp:br>
ตารางที่ 1. คุณสมบัติทั้งหมด
หมวดหมู่ คุณสมบัติ
ความสามารถในการเข้าถึง หัวเรื่อง
ระดับต้น attrs, binding, id, loaded, rendered, rendererType
dojo dojoAttributes, dojoType
การกำหนดลักษณะ disableTheme, style, styleClass, themeId
การใช้งาน

ณ รันไทม์, เส้นแบ่งปรากฏขึ้น บนเพจ

โดยปกติแล้ว คอนโทรลนี้ไม่ได้ใช้คุณสมบัติ

ตัวอย่าง
นี่คือเส้นแบ่งที่แยกปุ่มสองปุ่ม:
<xp:button value="Submit" id="button2">
	<xp:eventHandler event="onclick" submit="true" refreshMode="complete"
	immediate="false" save="true"></xp:eventHandler>
</xp:button>
<xp:br></xp:br>
<xp:button value="Cancel" id="button3">
	<xp:eventHandler event="onclick" submit="true" refreshMode="complete"
	immediate="true" save="false"></xp:eventHandler>
</xp:button>

button - ปุ่ม

แสดงปุ่มที่ผู้ใช้สามารถคลิกเพื่อดำเนินการ กับแอ็คชัน

หมวดหมู่
คอนโทรลชนิดคอร์
ไวยากรณ์
<xp:button attributes>content</xp:button>
ตารางที่ 2. คุณสมบัติที่สำคัญ
คุณสมบัติ คำอธิบาย
id ค่าดีฟอลต์ button1, button2, และอื่นๆ
value ระบุเลเบลสำหรับปุ่ม
eventHandler ระบุแอ็คชัน เมื่อเรียกใช้ปุ่ม โปรดดูส่วนของการใช้งาน
ตารางที่ 3. คุณสมบัติทั้งหมด
หมวดหมู่ คุณสมบัติ
ความสามารถในการเข้าถึง accesskey, iconAlt, role, tabindex, title
ระดับต้น attrs, binding, dir, disabled, disableValidators, execId, execMode, icon, id, lang, loaded, navigate, refreshId, refreshMode, rendered, rendererType, save, type, value
dojo dojoAttributes, dojoType
เหตุการณ์ action, actionListener, actionListeners, immediate,onblur, onclick, ondblclick, onfocus, onkeydown, onkeypress, onkeyup, onmousedown, onmousemove, onmouseout, onmouseover, onmouseup
การกำหนดลักษณะ disableTheme, outerStyleClass, style, styleClass, themeId
การใช้งาน
ณ รันไทม์, ปุ่มปรากฏขึ้นบน ผู้ใช้สามารถคลิกปุ่ม
ปุ่มมีอยู่สามชนิด:
  • ปุ่ม (ดีฟอลต์) ตอบกลับตัวจัดการเหตุการณ์ ที่คุณสร้าง, ตัวอย่างเช่น, สำหรับ onclick
  • ส่ง บันทึกข้อมูลและปิดเพจ
  • ยกเลิก ปิดเพจ
เมื่อปิดเพจแล้ว, เพจถัดไปที่โหลดจะถูกกำหนดด้วย คุณสมบัติ navigationRules สำหรับเพจที่เป็น เพจถัดไป (สำเร็จหรือยกเลิก) ใน UI
เมื่อต้องการตั้งค่าชนิดปุ่ม ใน UI, ให้คลิก ปุ่ม ภายใต้ คุณสมบัติ และมองหา ชนิดปุ่ม คุณสมบัติ eventHandler ที่สร้างขึ้นมีแอ็ตทริบิวต์ต่อไปนี้ ทำตามกฎเหล่านี้หากคุณสร้างคุณสมบัติ eventHandler แบบแมนวล
ปุ่ม ส่ง ยกเลิก
event=any event="onclick" event="onclick"
submit=any submit="true" submit="true"
refreshMode=any refreshMode="complete" refreshMode="complete"
immediate=any immediate="false" immediate="true"
save=any save="true" save="false"
action=simple action or event handler action=none action=none
ตัวอย่าง
คอนโทรลปุ่มนี้มีชนิดแบบส่ง
<xp:button id="button1" value="Submit">
	<xp:eventHandler event="onclick"
		submit="true" refreshMode="complete" immediate="false" save="true">
	</xp:eventHandler>
</xp:button>
This Button control is of type Cancel.
<xp:button id="button2" value="Cancel">
	<xp:eventHandler event="onclick"
		submit="true" refreshMode="complete" immediate="true" save="false">
	</xp:eventHandler>
</xp:button>
คอนโทรลปุ่มนี้มีชนิดเป็นปุ่ม และเรียกทำงานแอ็คชันพื้นฐาน บันทึกข้อมูล เมื่อคลิก
<xp:button id="button1" value="Save and Exit">
	<xp:eventHandler event="onclick" submit="true" refreshMode="complete">
		<xp:this.action>
			<xp:save name="/xpage2.xsp"></xp:save>
		</xp:this.action>
	</xp:eventHandler>
</xp:button>

callback - พื้นที่ที่สามารถแก้ไขได้

จัดเตรียมคอนโทรลแบบกำหนดเองพร้อมกับพื้นที่ที่สามารถแก้ไขได้ เมื่อฝังใน XPage

หมวดหมู่
คอนโทรลชนิดคอร์
ไวยากรณ์
<xp:callback attributes>content</xp:callback>
ตารางที่ 4. คุณสมบัติที่สำคัญ
คุณสมบัติ คำอธิบาย
id ค่าดีฟอลต์ callback1, callback2, และอื่นๆ
facetName ระบุขอบเขตของ facet
ตารางที่ 5. คุณสมบัติทั้งหมด
หมวดหมู่ คุณสมบัติ
ระดับต้น attrs, binding, facetName, id, loaded, rendered, rendererType
การกำหนดลักษณะ disableTheme, themeId
การใช้งาน
คอนโทรลนี้ใช้กับคอนโทรลแบบกำหนดเอง เท่านั้น

สำหรับข้อมูลเพิ่มเติม, โปรดดูที่ การนิยามพื้นที่ที่สามารถแก้ไขได้ในคอนโทรลแบบกำหนดเอง และ การตั้งค่าคุณสมบัติสำหรับพื้นที่ที่สามารถแก้ไขในคอนโทรลแบบกำหนดเอง

checkBox - เช็กบ็อกซ์

แสดงกล่องที่สามารถเลือกหรือลบการเลือกได้

หมวดหมู่
คอนโทรลชนิดคอร์
ไวยากรณ์
<xp:checkBox attributes>content</xp:checkBox>
ตารางที่ 6. คุณสมบัติที่สำคัญ
คุณสมบัติ คำอธิบาย
id ค่าดีฟอลต์ checkBox1, checkBox2, และอื่นๆ
text จัดเตรียมเลเบล
value โยงคอนโทรลกับอิลิเมนต์ข้อมูล หรือค่าอื่นๆ
checkedValue ระบุค่าข้อมูล เมื่อเลือกกล่อง กำหนดค่าดีฟอลต์เป็นสตริง true
uncheckedValue ระบุค่าข้อมูล เมื่อล้างการเลือกกล่อง กำหนดค่าดีฟอลต์เป็นสตริง false
defaultChecked ระบุ true เพื่อเลือกกล่องตามค่าดีฟอลต์
ตารางที่ 7. คุณสมบัติทั้งหมด
หมวดหมู่ คุณสมบัติ
ความสามารถในการเข้าถึง accesskey, role, tabindex, title
ระดับต้น attrs, binding, dir, disabled, id, immediate, lang, loaded, readonly, rendered, rendererType, required, text
ข้อมูล checkedValue, converter, defaultChecked, disableModifiedFlag, uncheckedValue, validator, validators, value, valueChangeListener, valueChangeListeners
dojo dojoAttributes, dojoType
เหตุการณ์ onblur, onchange, onclick, ondblclick, onfocus, onkeydown, onkeypress, onkeyup, onmousedown, onmousemove, onmouseout, onmouseover, onmouseup
การกำหนดลักษณะ disableTheme, style, styleClass, themeId
การใช้งาน
ณ รันไทม์, เช็กบ็อกซ์ปรากฏขึ้นบนเพจ ผู้ใช้สามารถเลือกหรือเคลียร์ได้ เครื่องหมายถูก จะปรากฏขึ้นในกล่องเมื่อเลือก
ตัวอย่าง
คอนโทรล เช็กบ็อกซ์ นี้กำหนดค่าข้อมูล ขึ้นอยู่กับว่าเลือกกล่อง (ค่าดีฟอลต์) หรือยกเลิกการเลือกกล่อง
<xp:checkBox id="checkBox2" text="Use user name instead of Anonymous"
	defaultChecked="true" value="#{document1.loginname}" uncheckedValue="Anonymous"
	checkedValue="#{javascript:session.getUserName()}">
</xp:checkBox>
คอนโทรลเช็กบ็อกซ์นี้ โยงกับตัวแปรคำร้องขอที่ชื่อ phonesame สคริปต์จะทำงาน หากเปลี่ยนกล่อง สคริปต์ตั้งค่าของคอนโทรล phonenight (กล่องแก้ไข) เท่ากับคอนโทรล phoneday หากเลือก เช็กบ็อกซ์
<xp:checkBox text="Night phone same as day" id="checkBox1"
	value="#{requestScope.phonesame}">
	<xp:eventHandler event="onchange" submit="true" 	refreshMode="complete">
		<xp:this.action><![CDATA[#{javascript:
			if(requestScope.phonesame == "true") {
				getComponent("phonenight").setValue(
					getComponent("phoneday").getValue());
			}
		}]]></xp:this.action>
	</xp:eventHandler>
</xp:checkBox>

checkBoxGroup - กลุ่มเช็กบ็อกซ์

แสดงกล่องจำนวนมากที่สามารถเลือกหรือยกเลิกการเลือกได้

หมวดหมู่
คอนโทรลชนิดคอร์
ไวยากรณ์
<xp:checkBoxGroup attributes>content</xp:checkBoxGroup>
ตารางที่ 8. คอนโทรลแบบฝัง
คอนโทรล คำอธิบาย
selectItem จัดเตรียมหนึ่งไอเท็มสำหรับการเลือกผู้ใช้
selectItems จัดเตรียมหนึ่งไอเท็มหรือมากกว่าสำหรับ การเลือกผู้ใช้
ตารางที่ 9. คุณสมบัติที่สำคัญ
หมวดหมู่ คุณสมบัติ
id ค่าดีฟอลต์ checkBoxGroup1, checkBoxGroup2, และอื่นๆ
value โยงคอนโทรลกับอิลิเมนต์ข้อมูล หรือค่าอื่นๆ
ตารางที่ 10. คุณสมบัติทั้งหมด
หมวดหมู่ คุณสมบัติ
ความสามารถในการเข้าถึง accesskey, legend, role, tabindex, title
ระดับต้น attrs, binding, dir, disabled, id, immediate, lang, loaded, readonly, rendered, rendererType, required
ข้อมูล converter, defaultValue, disableClientSideValidation, disableModifiedFlag, selectedValues, showReadonlyAsDisabled, validator, validators, value, valueChangeListener, valueChangeListeners
dojo dojoAttributes, dojoType
เหตุการณ์ onblur, onchange, onclick, ondblclick, onfocus, onkeydown, onkeypress, onkeyup, onmousedown, onmousemove, onmouseout, onmouseover, onmouseup
รูปแบบ border, layout
การกำหนดลักษณะ disabledClass, disableTheme, enabledClass, style, styleClass, themeId
การใช้งาน
ณ รันไทม์, หนึ่งเช็กบ็อกซ์หรือมากกว่า จะปรากฏขึ้นบนเพจ ผู้ใช้สามารถเลือกหรือยกเลิกการเลือกเช็กบ็อกซ์เหล่านั้น เครื่องหมายถูก จะปรากฏขึ้นในกล่องเมื่อเลือก

อิลิเมนต์ข้อมูลที่โยงกับเช็กบ็อกซ์ ต้องยอมให้มีหลายค่า

ตัวอย่าง
คอนโทรลกลุ่มเช็กบ็อกซ์นี้แสดง สองไอเท็มสำหรับการเลือก
<xp:checkBoxGroup id="checkBoxGroup1" value="#{document1.fruit}">
		<xp:selectItem itemLabel="Apples" itemValue="apples"></xp:selectItem>
		<xp:selectItem itemLabel="Oranges" itemValue="oranges"></xp:selectItem>
	</xp:checkBoxGroup>
คอนโทรลกลุ่มเช็กบ็อกซ์ แสดงสองไอเท็มสำหรับการเลือกโดยใช้สูตร
<xp:checkBoxGroup id="checkBoxGroup1" value="#{document1.fruit}">
	<xp:selectItems>
		<xp:this.value>
			<![CDATA[#{javascript:return new Array("Apples|apples", "Oranges|oranges")}]]>
		</xp:this.value>
	</xp:selectItems>
</xp:checkBoxGroup>
กลุ่มเช็กบ็อกซ์ทำให้เกิด การเลือกไอเท็มจากค่าในคอลัมน์มุมมอง
<xp:checkBoxGroup id="checkBoxGroup1" value="#{document1.fruit}">
	<xp:selectItems>
		<xp:this.value>
			<![CDATA[#{javascript:var list = @DbColumn("", "fruits", 1);
			return @Explode(list,",")}]]>
		</xp:this.value>
	</xp:selectItems>
</xp:checkBoxGroup>

comboBox - คอมโบบ็อกซ์

แสดงรายการของไอเท็มที่สามารถเลือกได้

หมวดหมู่
คอนโทรลชนิดคอร์
ไวยากรณ์
<xp:comboBox attributes>content</xp:comboBox>
ตารางที่ 11. คอนโทรลแบบฝัง
คอนโทรล คำอธิบาย
selectItem จัดเตรียมหนึ่งไอเท็มสำหรับการเลือกผู้ใช้
selectItems จัดเตรียมหนึ่งไอเท็มหรือมากกว่าสำหรับ การเลือกผู้ใช้
ตารางที่ 12. คุณสมบัติที่สำคัญ
คุณสมบัติ คำอธิบาย
id ค่าดีฟอลต์ comboBox1, comboBox2, และอื่นๆ
text จัดเตรียมเลเบล
value โยงคอนโทรลกับอิลิเมนต์ข้อมูล หรือค่าอื่นๆ
ตารางที่ 13. คุณสมบัติทั้งหมด
หมวดหมู่ คุณสมบัติ
ความสามารถในการเข้าถึง accesskey, role, tabindex, title
ระดับต้น attrs, binding, dir, disabled, id, immediate, lang, loaded, readonly, rendered, rendererType, required
ข้อมูล converter, defaultValue, disableClientSideValidation, disableModifiedFlag, disableValidators, showReadonlyAsDisabled, validator, validators, value, valueChangeListener, valueChangeListeners
dojo dojoAttributes, dojoType
เหตุการณ์ onblur, onchange, onclick, ondblclick, onfocus, onkeydown, onkeypress, onkeyup, onmousedown, onmousemove, onmouseout, onmouseover, onmouseup
การกำหนดลักษณะ disabledClass, disableTheme, enabledClass, style, styleClass, themeId
การใช้งาน
ณ รันไทม์, รายการดร็อปดาวน์จะปรากฏขึ้น บนเพจ ผู้ใช้สามารถเลือกได้หนึ่งไอเท็ม
ตัวอย่าง
คอนโทรลคอมโบบ็อกซ์นี้แสดงสอง ไอเท็มสำหรับการเลือก
<xp:comboBox id="comboBox1" value="#{document1.fruit}">
	<xp:selectItem itemLabel="Apples" itemValue="apples"></xp:selectItem>
	<xp:selectItem itemLabel="Oranges" itemValue="oranges"></xp:selectItem>
</xp:comboBox>
คอนโทรลคอมโบบ็อกซ์นี้แสดงสอง ไอเท็มสำหรับการเลือกโดยใช้สูตร
<xp:comboBox id="comboBox1" value="#{document1.fruit}">
	<xp:selectItems>
		<xp:this.value>
			<![CDATA[#{javascript:return new Array("Apples|apples", "Oranges|oranges")}]]>
		</xp:this.value>
	</xp:selectItems>
</xp:comboBox>
คอมโบบ็อกซ์นี้ขอรับการเลือกไอเท็มจาก ค่าในคอลัมน์มุมมอง
<xp:comboBox id="comboBox1" value="#{document1.fruit}">
	<xp:selectItems>
		<xp:this.value>
			<![CDATA[#{javascript:var list = @DbColumn("", "fruits", 1);
			return @Explode(list,",")}]]>
		</xp:this.value>
	</xp:selectItems>
</xp:comboBox>

dataTable - ตารางข้อมูล

มีเซลล์ที่จัดเรียงเป็นแถวและคอลัมน์ที่เชื่อมโยงกับ แหล่งข้อมูล แต่ละเซลล์สามารถมีคอนโทรลอื่นๆ ได้ (ซึ่งรวมถึง ตาราง) และข้อความ

หมวดหมู่
คอนโทรลคอนเทนเนอร์
ไวยากรณ์
<xp:dataTable attributes>
	<xp:column attributes>content	</xp:column>
	...
</xp:dataTable>
ตารางที่ 14. คุณสมบัติที่สำคัญ
คุณสมบัติ คำอธิบาย
id (dataTable) ค่าดีฟอลต์ dataTable1, dataTable2, และอื่นๆ

(column) ค่าดีฟอลต์ column1, column2, และอื่นๆ

value (dataTable) โดยปกติแล้ว การโยงข้อมูลคือ คอลเล็กชันของอิลิเมนต์, ตัวอย่างเช่น, อ็อบเจ็กต์ NotesDocumentCollection
var (dataTable) โดยปกติแล้ว ตัวแปรนี้อ้างถึงหนึ่งสมาชิกของการโยงคอลเล็กชันข้อมูล, ตัวอย่างเช่น, อ็อบเจ็กต์ NotesDocument หากการโยงคือ อ็อบเจ็กต์ NotesDocumentCollection
ตารางที่ 15. คุณสมบัติทั้งหมด (ข้อมูลตาราง)
หมวดหมู่ คุณสมบัติ
ความสามารถในการเข้าถึง caption, role, summary, title
ระดับต้น attrs, binding, dir, disabled, id, lang, loaded, partialExecute, partialRefresh, refreshId, rendered, rendererType, rules
ข้อมูล data, first, indexVar, rows, value, var
เหตุการณ์ onclick, ondblclick, onkeydown, onkeypress, onkeyup, onmousedown, onmousemove, onmouseout, onmouseover, onmouseup
รูปแบบ bgcolor, border, cellpadding, cellspacing, frame, showUnreadMarks, width
การกำหนดลักษณะ captionStyleClass, columnClasses, disableTheme, footerClass, headerClass, readMarksClass, rowClasses, style, styleClass, themeId, unreadMarksClass
ตารางที่ 16. คุณสมบัติทั้งหมด (คอลัมน์)
หมวดหมู่ คุณสมบัติ
ความสามารถในการเข้าถึง role
ระดับต้น binding, id, loaded, rendered, rendererType
การกำหนดลักษณะ disableTheme, style, styleClass, themeId
เพจเจอร์
ขอบเขต facets ที่มีเพจเจอร์หรือเพจเจอร์คือส่วนของตาราง ขึ้นอยู่กับข้อมูลจำเพาะของการออกแบบ ใช้โหมดซอร์สเพื่อทำงานภายในขอบเขตของ facet

ที่นี่คือตัวอย่าง facet สำหรับคอนโทรลเพจเจอร์:

<xp:this.facets>
	<xp:pager partialRefresh="true" layout="Previous Group Next"
		xp:key="header" id="pager1">
	</xp:pager>
</xp:this.facets>
กล่องต่อไปนี้บนแท็บ แสดง ภายใต้ คุณสมบัติ มีผลต่อเนื้อหา facet ดังต่อไปนี้:
  • แสดงเพจเจอร์ในส่วนหัว (เคลียร์ตามค่าดีฟอลต์) สร้างคอนโทรล pager ของคีย์ header ไม่มีขอบเขต facets ที่สร้างขึ้นหากเคลียร์ข้อมูลแล้ว
  • แสดงเพจเจอร์ในส่วนท้าย (เคลียร์ตามค่าดีฟอลต์) สร้างคอนโทรล pager ของคีย์ footer
การใช้งาน
ณ รันไทม์, ตารางข้อมูลปรากฏขึ้นบน เพจ ผู้ใช้สามารถเข้าถึงเซลล์ของตารางทีละครั้ง

หากสร้าง ตารางข้อมูล, คุณสามารถเพิ่มหรือลบแถวและคอลัมน์

เนื้อหา ของแต่ละคอลัมน์มีค่าหนึ่ง, สอง, หรือสามเพื่อแสดงส่วนหัว, ส่วนกลาง, และส่วนท้ายของแถวในตาราง แถวส่วนกลางถูกสร้างการแสดงผล เป็นจำนวนต่างๆ ของแถวขึ้นอยู่กับจำนวนของอิลิเมนต์ใน แหล่งข้อมูล

สำหรับมุมมอง Domino ความสามารถ เช่น หมวดหมู่, ผลรวม, เอกสารการตอบกลับ, และการเรียงลำดับ, อ้างถึงคอนโทรล มุมมอง คอนโทรล View รวมความสามารถของมุมมอง Domino ต้นทาง

ซึ่งต้องการ คอนโทรลนี้โดยที่คุณต้องการความสามารถที่ใกล้เคียงกับคอนโทรล View เหล่านี้ คอนโทรลนี้อนุญาตให้ผู้ใช้แก้ไขภายในคอลัมน์โดยที่คอนโทรล View ไม่มีอยู่ ด้วยคอนโทรลนี้, คุณสามารถฝังและโยงคอนโทรลอื่นๆ (ตัวอย่างเช่น, อิมเมจ) ของตัวเลือกของคุณขณะที่คอนโทรล View ถูกจำกัดโดยการออกแบบของมุมมอง Domino ต้นทาง

ตัวอย่าง
ตารางข้อมูลนี้แสดงไอเท็ม subject และ fruit ของเอกสารทั้งหมดในฐานข้อมูลปัจจุบัน
<xp:dataTable id="dataTable1" rows="30"
	value="#{javascript:return database.getAllDocuments()}" var="rowdoc">
	<xp:column id="column1">
		<xp:this.facets>
			<xp:label value="subject" id="label1" xp:key="header" style="font-weight:bold"></xp:label>
		</xp:this.facets>
		<xp:text escape="true" id="computedField1"><xp:this.value>
			<![CDATA[#{javascript:return rowdoc.getItemValueString("subject")}]]>
		</xp:this.value>	</xp:text>
	</xp:column>
	<xp:column id="column2">
		<xp:this.facets>
			<xp:label value="fruit" id="label2" xp:key="header" style="font-weight:bold"></xp:label>
		</xp:this.facets>
		<xp:text escape="true" id="computedField2"><xp:this.value>
			<![CDATA[#{javascript:return rowdoc.getItemValueString("fruit")}]]>
		</xp:this.value></xp:text>
	</xp:column>
</xp:dataTable>

dateTimeHelper - ตัวเลือกวันที่และเวลา

แสดงตัวเลือกสำหรับการเลือกค่าวันที่และเวลาใน กล่องแก้ไข

หมวดหมู่
คอนโทรลชนิดคอร์
ไวยากรณ์
<xp:dateTimeHelper attributes>content</xp:dateTimeHelper>
ตารางที่ 17. คุณสมบัติที่สำคัญ
คุณสมบัติ คำอธิบาย
id ค่าดีฟอลต์ dateTimeHelper1, dateTimeHelper2, และอื่นๆ
ตารางที่ 18. คุณสมบัติทั้งหมด
หมวดหมู่ คุณสมบัติ
ระดับต้น binding, id, loaded, rendered, rendererType
dojo dojoAttributes, dojoType
รูปแบบ timeClickableIncrement, timeVisibleIncrement, timeVisibleRange
การกำหนดลักษณะ disableTheme, themeId
การใช้งาน
ในโหมดการออกแบบ, การสร้างคอนโทรล Date Time Picker จะฝังคอนโทรลไว้ในคอนโทรล Edit Box แบบอัตโนมัติด้วยชนิดการแสดงผลของ Date/Time เมื่อต้องการเข้าถึงคุณสมบัติ Date Time Picker, ให้เลือก โหมด แหล่งที่มา และวางโฟกัสไว้บนอิลิเมนต์ dateTimeHelper ที่ฝังไว้

ณ รันไทม์, ผู้ใช้สามารถคลิกตัวเลือก จากนั้นเลือกวันที่และเวลา สำหรับการแทรกลงในกล่องแก้ไข

ตัวอย่าง
กล่องแก้ไขนี้มีตัวเลือกสำหรับ การเลือกค่าวันที่และเวลา
<xp:inputText id="inputText4" value="#{document1.mydatetime}">
	<xp:dateTimeHelper id="dateTimeHelper1"></xp:dateTimeHelper>
	<xp:this.converter>
		<xp:convertDateTime type="both" dateStyle="short" timeStyle="short"></xp:convertDateTime>
	</xp:this.converter>
</xp:inputText>

div - การแบ่ง

ทำหน้าที่คล้ายกับการแบ่งหรือบล็อกของเนื้อหาใน HTML มี คอนโทรลและข้อความอื่นๆ

หมวดหมู่
คอนโทรลคอนเทนเนอร์
ไวยากรณ์
<xp:div attributes>content</xp:div>
ตารางที่ 19. คุณสมบัติทั้งหมด
หมวดหมู่ คุณสมบัติ
ความสามารถในการเข้าถึง role, title
ระดับต้น attrs, binding, dir, id, lang, loaded, rendered, rendererType
dojo dojoAttributes, dojoType
เหตุการณ์ onclick, ondblclick, onkeydown, onkeypress, onkeyup, onmousedown, onmousemove, onmouseout, onmouseover, onmouseup
การกำหนดลักษณะ disableTheme, style, styleClass, themeId
การใช้งาน

ณ รันไทม์, เนื้อหาของการแบ่ง จะปรากฏขึ้นบนเพจพร้อมกับคุณสมบัติที่กำหนดไว้

ตัวอย่าง
คอนโทรล Div มีข้อความและกล่องแก้ไข ที่มีการกำหนดลักษณะที่แตกต่างกัน
<xp:div style="font-weight:bold;padding-bottom:20.0px">
	Day phone =>
	<xp:inputText id="inputText2" value="#{document1.phoneday}"></xp:inputText>
</xp:div>
<xp:div style="font-weight:bold">
	Night phone => 
	<xp:inputText id="inputText3" value="#{document1.phonenight}"></xp:inputText>
</xp:div>

eventHandler - ตัวจัดการเหตุการณ์ (คอนโทรล)

ตอบกลับไปยังแอ็คชันผู้ใช้ เช่น การคลิกคอนโทรล

หมวดหมู่
คอนโทรลอื่นๆ
ไวยากรณ์
<xp:eventHandler attributes>content</xp:eventHandler>
ตารางที่ 20. คุณสมบัติที่สำคัญ
คุณสมบัติ คำอธิบาย
save บันทึกข้อมูลที่เชื่อมโยงกับแบบฟอร์มหรือไม่ คำตอบนี้ควรเป็นเท็จสำหรับปุ่มชนิด Cancel
submit สิ่งนี้เป็นจริงเพื่อส่งคำร้องขอ และขอรับการตอบกลับจากเซิร์ฟเวอร์ ตัวจัดการไคลเอ็นต์สามารถยกเลิกการส่ง คำร้องขอโดยส่งคืนค่าเท็จ
refreshMode ระบุว่าการรีเฟรชเพจ สมบูรณ์, เป็นบางส่วน, หรือไม่ได้ดำเนินการ
immediate สิ่งนี้ควรเป็นจริงสำหรับปุ่มของ ชนิด Cancel
ตารางที่ 21. คุณสมบัติทั้งหมด
หมวดหมู่ คุณสมบัติ
ระดับต้น binding, disableValidators, event, execId, execMode, handlers, id, loaded, navigate, refreshId, refreshMode, rendered, rendererType, save, submit, value
ข้อมูล parameters
เหตุการณ์ action, actionListener, actionListeners, immediate, onComplete, onError, onStart, script
การกำหนดลักษณะ disableTheme, themeId
การใช้งาน
โปรดดูที่ การทำความเข้าใจกับเหตุการณ์
ตัวอย่าง
สิ่งนี้คือคอนโทรลปุ่มของชนิด Submit
<xp:button value="submit" id="button1">
	<xp:eventHandler event="onclick" submit="true"
		refreshMode="complete" immediate="false" save="true">
	</xp:eventHandler>
</xp:button>
นี่คือคอนโทรลปุ่มของชนิด Cancel
<xp:button value="cancel" id="button2">
	<xp:eventHandler event="onclick" submit="true"
		refreshMode="complete" immediate="true" save="false">
	</xp:eventHandler>
</xp:button>
สิ่งนี้คือคอนโทรลปุ่ม ที่มีเหตุการณ์ onclick ซึ่งโค้ดโดยผู้ใช้
<xp:button value="set username" id="button3">
	<xp:eventHandler event="onclick" submit="true" refreshMode="complete">
		<xp:this.action>
			<![CDATA[#{javascript:getComponent("inputText2").setValue(session.getCommonUserName())}]]>
		</xp:this.action>
	</xp:eventHandler>
</xp:button>

fileDownload - ดาวน์โหลดไฟล์

ดาวน์โหลดไฟล์ไปยังระบบโลคัลไฟล์

หมวดหมู่
คอนโทรลชนิดคอร์
ไวยากรณ์
<xp:fileDownload attributes>content</xp:fileDownload>
ตารางที่ 22. คุณสมบัติที่สำคัญ
คุณสมบัติ คำอธิบาย
id ค่าดีฟอลต์ fileDownload1, fileDownload2, และอื่นๆ
value โยงคอนโทรลไฟล์ไปยังอิลิเมนต์ข้อมูล หรือค่าอื่นๆ ที่ต้องเป็นชนิด rich text
mimetype บังคับให้ใช้ชนิด MIME ของดาวน์โหลด แทนการกำหนดไว้โดยชนิดไฟล์
useUploadName ตามค่าดีฟอลต์ ชื่อไฟล์เดิม จะถูกใช้
filename ระบุชื่อสิ่งที่แนบ หากคุณไม่ได้ใช้ชื่อไฟล์เดิม
ตารางที่ 23. คุณสมบัติทั้งหมด
หมวดหมู่ คุณสมบัติ
ความสามารถในการเข้าถึง accesskey, role, tabindex, title
ระดับต้น attrs, allowDelete, binding, createdTitle, createdValue, deleteImageTitle, deleteMessage, dir, disabled, displayCreated, displayLastModified, displaySize, displayType, fileNameHrefValue, fileNameTitle, fileNameValue, hideWhen, id, lang, lastModifiedTitle, lastModifiedValue, loaded, rendered, rendererType, rowAttrs, rules, sizeTitle, sizeValue, typeTitle, typeValue
ข้อมูล data, first, indexVar, rows, value, var
เหตุการณ์ onclick, ondblclick, onkeydown, onkeypress, onkeyup, onmousedown, onmousemove, onmouseout, onmouseover, onmouseup
รูปแบบ bgcolor, border, cellpadding, cellspacing, frame, width
การกำหนดลักษณะ captionStyleClass, columnClasses, createdStyleClass, deleteStyleClass, disableTheme, footerClass, headerClass, modifiedStyleClass, nameStyleClass, rowClasses, sizeStyleClass, style, styleClass, themeId, typeStyleClass
การใช้งาน
ณ รันไทม์, ข้อมูลเกี่ยวกับไฟล์ที่แนบใดๆ จะปรากฏขึ้นบนเพจ ซึ่งอาจรวมถึงชนิดไฟล์, ขนาด, ชื่อ, และวันที่ปรับเปลี่ยน, วันที่สร้าง, และเมื่อผู้ใช้สามารถลบ ไฟล์ที่แนบได้ ผู้ใช้สามารถคลิกบนชื่อเพื่อเข้าถึงเบราว์เซอร์ไฟล์ เพื่อดาวน์โหลดไฟล์ที่แนบ
ตัวอย่าง
คอนโทรล ดาวน์โหลดไฟล์ นี้ ยอมให้ผู้ใช้ดาวน์โหลดไฟล์จากไอเท็ม เนื้อความ ของเอกสาร
<xp:fileDownload rows="30" id="fileDownload1"
	displayLastModified="false" value="#{document2.body}">
</xp:fileDownload>

fileUpload - อัพโหลดไฟล์

อัพโหลดไฟล์จากระบบโลคัลไฟล์

หมวดหมู่
คอนโทรลชนิดคอร์
ไวยากรณ์
<xp:fileUpload attributes>content</xp:fileUpload>
ตารางที่ 24. คุณสมบัติที่สำคัญ
คุณสมบัติ คำอธิบาย
id ค่าดีฟอลต์ fileUpload1, fileUpload2, และอื่นๆ
value โยงคอนโทรลไฟล์ไปยังอิลิเมนต์ข้อมูล หรือค่าอื่นๆ ที่ต้องเป็นชนิด rich text
mimetype บังคับให้ใช้ชนิด MIME ของอัพโหลด แทนการกำหนดไว้โดยชนิดไฟล์
useUploadName ตามค่าดีฟอลต์ ชื่อไฟล์เดิม จะถูกใช้
filename ระบุชื่อสิ่งที่แนบ หากคุณไม่ได้ใช้ชื่อไฟล์เดิม
ตารางที่ 25. คุณสมบัติทั้งหมด
หมวดหมู่ คุณสมบัติ
ความสามารถในการเข้าถึง accesskey, role, tabindex, title
ระดับต้น attrs, accept, binding, dir, disabled, exclude, filename, id, immediate, lang, loaded, mimetype, readonly, rendered, rendererType, required, size, useUploadName
ข้อมูล converter, disableClientSideValidation, disableModifiedFlag, disableValidators, showReadonlyAsDisabled, validator, validators, value, valueChangeListener, valueChangeListeners
เหตุการณ์ onblur, onchange, onclick, ondblclick, onfocus, onkeydown, onkeypress, onkeyup, onmousedown, onmousemove, onmouseout, onmouseover, onmouseup, onselect
การกำหนดลักษณะ disableTheme, style, styleClass, themeId
การใช้งาน
ณ รันไทม์, เบราว์เซอร์ไฟล์ ปรากฏขึ้นบนเพจ ผู้ใช้สามารถระบุหรือเลือกไฟล์ได้จากระบบ โลคัลไฟล์

ไฟล์ถูกแนบกับไอเท็มที่โยงไว้ในที่เก็บข้อมูล เมื่อบันทึกเพจ ไอเท็มนี้ต้องเป็นชนิดที่อนุญาตให้ใช้ ไฟล์แนบ, ตัวอย่างเช่น, rich text

ตัวอย่าง
คอนโทรล อัพโหลดไฟล์ นี้อัพโหลด ไฟล์ไปยังไอเท็ม เนื้อความ ของเอกสาร
<xp:fileUpload id="fileUpload1" value="#{document1.body}"></xp:fileUpload>

อิมเมจ - อิมเมจ (คอนโทรล)

แสดงอิมเมจ

หมวดหมู่
คอนโทรลชนิดคอร์
ไวยากรณ์
<xp:image attributes>content</xp:image>
ตารางที่ 26. คุณสมบัติที่สำคัญ
คุณสมบัติ คำอธิบาย
id ค่าดีฟอลต์ image1, image2, และอื่นๆ
for ระบุคอนโทรลเป้าหมาย
ตารางที่ 27. คุณสมบัติทั้งหมด
หมวดหมู่ คุณสมบัติ
ความสามารถในการเข้าถึง alt, role, title
ระดับต้น attrs, binding, dir, id, ismap, lang, loaded, longdesc, rendered, rendererType, url, usemap, value
เหตุการณ์ onblur, onclick, ondblclick, onfocus, onkeydown, onkeypress, onkeyup, onmousedown, onmousemove, onmouseout, onmouseover, onmouseup
รูปแบบ height, width
การกำหนดลักษณะ disableTheme, style, styleClass, themeId
การใช้งาน
ณ รันไทม์ อิมเมจปรากฏขึ้นบนเพจ
ตัวอย่าง
นี่คืออิมเมจที่วางอยู่บนเพจ
<xp:image url="/sound.gif" id="image1" alt="Sound image"></xp:image>

include - เพจ Include

แทรกการอ้างอิงให้กับ XPage อื่น

หมวดหมู่
คอนโทรลคอนเทนเนอร์
ไวยากรณ์
<xp:include attributes>content</xp:include>
ตารางที่ 28. คุณสมบัติที่สำคัญ
คุณสมบัติ คำอธิบาย