開發大量編輯器 developing-the-bulk-editor
本節說明如何開發大量編輯器工具，以及如何擴充以大量編輯器為基礎的產品清單元件。
大量編輯器查詢引數 bulk-editor-query-parameters
使用「大量編輯器」時，您可以將多個查詢引數新增到URL中，以使用特定組態呼叫「大量編輯器」。 如果您希望大量編輯器一律搭配特定組態使用（例如，例如在產品清單元件中），則必須編輯bulkeditor.jsp （在/libs/wcm/core/components/bulkeditor中）或建立具有特定組態的元件。 使用查詢引數所做的變更不是永久性的。
例如，如果您在瀏覽器的URL中鍵入下列內容：
https://<servername><port_number>/etc/importers/bulkeditor.html?rootPath=/content/geometrixx/en&queryParams=geometrixx&initialSearch=true&hrp=true
大量編輯器顯示時沒有 根路徑 欄位，因為hrp=true會隱藏該欄位。 使用引數hrp=false，會顯示欄位（預設值）。
以下是「大量編輯器」查詢引數的清單：
rootPath，短名稱是rp。 如果未定義長名稱，則會從請求中讀取短名稱。開發以大量編輯器為基礎的元件：產品清單元件 developing-a-bulk-editor-based-component-the-product-list-component
本節提供如何使用大量編輯器的概觀，並說明以大量編輯器為基礎的現有Geometrixx元件：產品清單元件。
產品清單元件可讓使用者顯示和編輯資料表。 例如，您可以使用產品清單元件來代表目錄中的產品。 此資訊會顯示在標準HTML表格中，且任何編輯都會在包含BulkEditor Widget的 編輯 對話方塊中執行。 (此大量編輯器與在/etc/importers/bulkeditor.html或透過「工具」功能表存取的編輯器相同)。 產品清單元件已針對特定的有限大量編輯器功能進行設定。 可以設定批次編輯器的每個部分（或衍生自批次編輯器的元件）。
使用大量編輯器，您可以新增、修改、刪除、篩選和匯出列、儲存修改和匯入一組列。 每一列都會儲存為「產品清單」元件實體本身的節點。 每個儲存格都是每個節點的屬性。 這是設計選擇，很容易變更，例如，您可以將節點儲存在存放庫中的其他位置。 查詢servlet的角色是傳回要顯示的節點清單；搜尋路徑定義為產品清單執行個體。
產品清單元件的原始程式碼可在存放庫/apps/geometrixx/components/productlist中取得，並且由幾個部分組成，例如所有Adobe Experience Manager (AEM)元件：
- HTML呈現：呈現會在JSP檔案(https://experienceleague.adobe.com/apps/geometrixx/components/productlist/productlist.jsp?lang=zh-Hant)中完成。 JSP會讀取目前「產品清單」元件的子節點，並將每個子節點顯示為HTML表格的一列。
- 編輯對話方塊，您可在此定義大量編輯器設定。 設定對話方塊以符合元件的需求：可用的欄以及在格線或搜尋時可能執行的動作。 如需所有組態屬性的詳細資訊，請參閱大量編輯器組態屬性。
以下是對話方塊子節點的XML表示法：
<editor
jcr:primaryType="cq:Widget"
colsSelection="[ProductId,ProductName,Color,CatalogCode,SellingSku]"
colsValue="[ProductId,ProductName,Color,CatalogCode,SellingSku]"
contentMode="false"
exportURL="/etc/importers/bulkeditor/export.tsv"
extraCols="Selection"
hideColsSelection="false"
hideContentMode="true"
hideDeleteButton="false"
hideExportButton="false"
hideExtraCols="true"
hideImportButton="false"
hideInsertButton="false"
hideMoveButtons="false"
hidePathCol="true"
hideRootPath="true"
hideSaveButton="false"
hideSearchButton="false"
importURL="/etc/importers/bulkeditor/import"
initialSearch="true"
insertedResourceType="geometrixx/components/productlist/sku"
queryParams=""
queryURL="/etc/importers/bulkeditor/query.json"
saveURL="/etc/importers/bulkeditor/save"
xtype="bulkeditor">
<saveButton
jcr:primaryType="nt:unstructured"
text="Save modifications"/>
<searchButton
jcr:primaryType="nt:unstructured"
text="Apply filter"/>
<queryParamsInput
jcr:primaryType="nt:unstructured"
fieldDescription="Enter here your filters"
fieldLabel="Filters"/>
<searchPanel
jcr:primaryType="nt:unstructured"
height="200">
<defaults
jcr:primaryType="nt:unstructured"
labelWidth="150"/>
</searchPanel>
<grid
jcr:primaryType="nt:unstructured"
height="275"/>
<store jcr:primaryType="nt:unstructured">
<sortInfo
jcr:primaryType="nt:unstructured"
direction="ASC"
field="CatalogCode"/>
</store>
<colModel
jcr:primaryType="nt:unstructured"
width="150"/>
<colsMetadata jcr:primaryType="nt:unstructured">
<Selection
jcr:primaryType="nt:unstructured"
checkbox="true"
forcedPosition="0"
headerText=""/>
<ProductId
jcr:primaryType="nt:unstructured"
cellCls="productlist-cell-productid"
headerText="Product Id"/>
<ProductName
jcr:primaryType="nt:unstructured"
cellStyle="background-color: #FFCC99;"
headerText="Product Name"/>
<CatalogCode
jcr:primaryType="nt:unstructured"
cellStyle="background-color: #EDEDED;"
headerText="Catalog Code"/>
<Color jcr:primaryType="nt:unstructured">
<editor
jcr:primaryType="nt:unstructured"
store="[Blue,Red,Yellow]"
triggerAction="all"
typeAhead="true"
xtype="combo"/>
</Color>
<SellingSku
jcr:primaryType="nt:unstructured"
headerText="Sku Id"/>
</colsMetadata>
</editor>
大量編輯器組態屬性 bulk-editor-configuration-properties
可設定大量編輯器的每個部分。 下表列出大量編輯器的所有組態屬性。
欄中繼資料設定 columns-metadata-configuration
您可以為每個欄設定：
-
顯示屬性：html樣式、CSS類別及唯讀
-
核取方塊
-
強制位置
CSS和唯讀欄
大量編輯器有三種欄設定：
- 儲存格CSS類別名稱(cellCls)：新增至已設定欄之每個儲存格的CSS類別名稱。
- 儲存格樣式(cellStyle)：新增至已設定欄之每個儲存格的HTML樣式。
- 唯讀(readOnly)：針對已設定欄的每個儲存格設定唯讀。
組態必須定義為下列組態：
"colsMetadata": {
"Column name": {
"cellStyle": "html style",
"cellCls": "CSS class",
"readOnly": true/false
}
}
以下範例可在productlist元件(https://experienceleague.adobe.com/apps/geometrixx/components/productlist/dialog/items/editor/colsMetadata?lang=zh-Hant)中找到：
<colsMetadata jcr:primaryType="nt:unstructured">
<Selection
jcr:primaryType="nt:unstructured"
checkbox="true"
forcedPosition="0"
headerText=""/>
<ProductId
jcr:primaryType="nt:unstructured"
cellCls="productlist-cell-productid"
headerText="Product Id"/>
<ProductName
jcr:primaryType="nt:unstructured"
cellStyle="background-color: #FFCC99;"
headerText="Product Name"/>
<CatalogCode
jcr:primaryType="nt:unstructured"
cellStyle="background-color: #EDEDED;"
headerText="Catalog Code"/>
<Color jcr:primaryType="nt:unstructured">
<editor
jcr:primaryType="nt:unstructured"
store="[Blue,Red,Yellow]"
triggerAction="all"
typeAhead="true"
xtype="combo"/>
</Color>
<SellingSku
jcr:primaryType="nt:unstructured"
headerText="Sku Id"/>
</colsMetadata>
核取方塊
如果核取方塊組態屬性設為true，欄中的所有儲存格都會呈現為核取方塊。 核取方塊會將 true 傳送至伺服器儲存servlet，否則 false。 在標題功能表中，您也可以 全選 或 不選。 如果選取的標頭是核取方塊欄的標頭，則會啟用這些選項。
在前一個範例中，選取欄僅包含核取方塊，如checkbox="true"。
強制位置
強制位置中繼資料forcedPosition可讓您指定欄在網格中的放置位置：0是第一個位置，<number of columns>-1是最後一個位置。 任何其他值都會被忽略。
在前一個範例中，選取欄是第一個欄，如forcedPosition="0"。
查詢Servlet query-servlet
依預設，可在/libs/wcm/core/components/bulkeditor/json.java找到查詢servlet。 您可以設定其他路徑以擷取資料。
查詢servlet的運作方式如下：它接收GQL查詢並接收要傳回的欄、計算結果，並將結果以JSON資料流的形式傳回大量編輯器。
在產品清單元件案例中，傳送至查詢servlet的兩個引數如下：
- 查詢： "path：/content/geometrixx/en/customers/jcr：content/par/productlist Cube"
- 欄： "Selection、ProductId、ProductName、Color、CatalogCode、SellingSku"
而且JSON資料流會傳回如下：
{
"hits": [{
"jcr:path": "/content/geometrixx/en/products/jcr:content/par/productlist/1258674828905",
"ProductId": "21",
"ProductName": "Cube",
"Color": "Blue",
"CatalogCode": "43244",
"SellingSku": "32131"
}
],
"results": 1
}
每個點選都會對應一個節點及其屬性，並在格線中顯示為一列。
您可以擴充查詢Servlet，以傳回複雜的繼承模型或傳回儲存在特定邏輯位置的節點。 查詢servlet可用於執行任何型別的複雜計算。 然後，網格會顯示儲存庫中數個節點之彙總的列。 在此情況下，這些列的修改和儲存必須由「儲存Servlet」管理。
儲存Servlet save-servlet
在大量編輯器的預設設定中，每一列都是一個節點，而且此節點的路徑會儲存在列記錄中。 大量編輯器會透過jcr路徑保持列與節點之間的連結。 當使用者編輯格線時，會建立所有修改的清單。 當使用者按一下 儲存 時，會傳送POST查詢給每個具有更新屬性值的路徑。 這是Sling概念的基礎，如果每個儲存格都是節點的屬性，則運作良好。 但是，如果實施查詢servlet來執行繼承計算，則此模型無法運作，因為查詢servlet傳回的屬性可以從另一個節點繼承。
「儲存servlet」概念是修改不會直接發佈到每個節點，而是發佈到執行儲存作業的一個servlet。 此servlet因此可分析修改，並將屬性儲存在正確的節點上。
每個更新的屬性都會以下列格式傳送至servlet：
-
引數名稱： <jcr path>/<property name>
範例： /content/geometrixx/en/products/jcr：content/par/productlist/1258674859000/SellingSku
-
值： <value>
範例： 12123
此servlet需要知道catalogCode屬性的儲存位置。
預設的「儲存servlet」實作可在/libs/wcm/bulkeditor/save/POST.jsp取得，並用於產品清單元件中。 它會從請求中取得所有引數（具有<jcr path>/<property name>格式），並使用JCR API在節點上寫入屬性。 如果節點不存在，它也會建立節點（格線插入列）。
請勿照原樣使用預設程式碼，因為它會重新實作伺服器原生執行的動作(<jcr path>/<property name>上的POST)，因此，這只是建置可管理屬性繼承模型的「儲存」servlet的良好起點。