在最適化Forms中使用預填服務

Last update: Mon Jul 15 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

主題：
適用性表單

建立對象：

中繼
開發人員

您可以使用現有資料預先填寫最適化表單的欄位。當使用者開啟表單時，這些欄位的值將被預填。有多種方式可預先填寫最適化表單欄位。在本文中，我們將瞭解如何使用AEM Forms預填服務預填最適化表單。

若要深入瞭解預先填入最適化表單的各種方法，請遵循此檔案

若要使用預填服務預填調適型表單，您必須建立實作com.adobe.forms.common.service.DataXMLProvider介面的類別。方法getDataXMLForDataRef將具有邏輯，可建置並傳回最適化表單將用來預先填入欄位的資料。在此方法中，您可以從任何來源擷取資料，並傳回資料檔案的輸入資料流。下列程式碼範例會擷取登入使用者的使用者設定檔資訊，並建構XML檔案，其輸入資料流會傳回供調適型表單使用。

在下列程式碼片段中，我們有一個實作DataXMLProvider介面的類別。我們取得登入使用者的存取權，然後擷取登入使用者的設定檔資訊。然後我們會使用稱為「data」的根節點元素來建立XML檔案，並將適當的元素附加至此資料節點。一旦建構XML檔案之後，就會傳回XML檔案的輸入資料流。

此類別隨後會成為OSGi套件組合併部署至AEM。部署套件組合後，即可使用此預填服務做為最適化表單的預填服務。

NOTE

您可以使用xml或json資料，透過本文所列的方法預先填寫表單。

package com.aem.prefill.core;
import com.adobe.forms.common.service.DataXMLOptions;
import com.adobe.forms.common.service.DataXMLProvider;
import com.adobe.forms.common.service.FormsException;
import java.io.ByteArrayInputStream;
import java.io.ByteArrayOutputStream;
import java.io.FileOutputStream;
import java.io.InputStream;
import javax.jcr.Session;
import javax.xml.parsers.DocumentBuilder;
import javax.xml.parsers.DocumentBuilderFactory;
import javax.xml.transform.Transformer;
import javax.xml.transform.TransformerFactory;
import javax.xml.transform.dom.DOMSource;
import javax.xml.transform.stream.StreamResult;
import org.apache.jackrabbit.api.JackrabbitSession;
import org.apache.jackrabbit.api.security.user.Authorizable;
import org.apache.jackrabbit.api.security.user.UserManager;
import org.apache.sling.api.resource.Resource;
import org.apache.sling.api.resource.ResourceResolver;
import org.osgi.service.component.annotations.Component;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.w3c.dom.Document;
import org.w3c.dom.Element;

@Component
public class PrefillAdaptiveForm implements DataXMLProvider {
  private static final Logger log = LoggerFactory.getLogger(PrefillAdaptiveForm.class);

  @Override
  public String getServiceDescription() {

    return "Custom AEM Forms PreFill Service";
  }

  @Override
  public String getServiceName() {

    return "CustomAemFormsPrefillService";
  }

  @Override
  public InputStream getDataXMLForDataRef(DataXMLOptions dataXmlOptions) throws FormsException {
    InputStream xmlDataStream = null;
    Resource aemFormContainer = dataXmlOptions.getFormResource();
    ResourceResolver resolver = aemFormContainer.getResourceResolver();
    Session session = (Session) resolver.adaptTo(Session.class);
    try {
      UserManager um = ((JackrabbitSession) session).getUserManager();
      Authorizable loggedinUser = um.getAuthorizable(session.getUserID());
      log.debug("The path of the user is" + loggedinUser.getPath());
      DocumentBuilderFactory docFactory = DocumentBuilderFactory.newInstance();
      DocumentBuilder docBuilder = docFactory.newDocumentBuilder();
      Document doc = docBuilder.newDocument();
      Element rootElement = doc.createElement("data");
      doc.appendChild(rootElement);

      if (loggedinUser.hasProperty("profile/givenName")) {
        Element firstNameElement = doc.createElement("fname");
        firstNameElement.setTextContent(loggedinUser.getProperty("profile/givenName")[0].getString());
        rootElement.appendChild(firstNameElement);
        log.debug("Created firstName Element");
      }

      if (loggedinUser.hasProperty("profile/familyName")) {
        Element lastNameElement = doc.createElement("lname");
        lastNameElement.setTextContent(loggedinUser.getProperty("profile/familyName")[0].getString());
        rootElement.appendChild(lastNameElement);
        log.debug("Created lastName Element");

      }
      if (loggedinUser.hasProperty("profile/email")) {
        Element emailElement = doc.createElement("email");
        emailElement.setTextContent(loggedinUser.getProperty("profile/email")[0].getString());
        rootElement.appendChild(emailElement);
        log.debug("Created email Element");

      }

      TransformerFactory transformerFactory = TransformerFactory.newInstance();
      ByteArrayOutputStream outputStream = new ByteArrayOutputStream();
      Transformer transformer = transformerFactory.newTransformer();
      DOMSource source = new DOMSource(doc);
      StreamResult outputTarget = new StreamResult(outputStream);
      TransformerFactory.newInstance().newTransformer().transform(source, outputTarget);
      if (log.isDebugEnabled()) {
        FileOutputStream output = new FileOutputStream("afdata.xml");
        StreamResult result = new StreamResult(output);
        transformer.transform(source, result);
      }

      xmlDataStream = new ByteArrayInputStream(outputStream.toByteArray());
      return xmlDataStream;
    } catch (Exception e) {
      log.error("The error message is " + e.getMessage());
    }
    return null;

  }

}

若要在您的伺服器上測試此功能，請執行下列動作

請確定已填寫登入使用者的設定檔資訊。範例會尋找登入使用者的FirstName、LastName和Email屬性。
將zip檔案的內容下載並解壓縮到您的電腦上
使用AEM Web主控台部署prefill.core-1.0.0-SNAPSHOT組合
使用「建立」匯入最適化表單 | 從FormsAndDocuments區段上傳檔案
確定表單使用 「自訂AEM Forms預填服務」 做為預填服務。這可以從 表單容器 區段的組態屬性中驗證。
預覽表單。您應該會看到表單已填入正確的值。

NOTE

如果您已啟用com.aem.prefill.core.PrefillAdaptiveForm的偵錯，則產生的xml資料檔案會寫入您的AEM伺服器安裝資料夾。

recommendation-more-help

8de24117-1378-413c-a581-01e660b7163e