Personalizzazione dei servizi di dati Bozza e Invio customizing-draft-and-submission-data-services
Panoramica overview
AEM Forms consente agli utenti di salvare un modulo adattivo come bozza. La funzionalità bozza consente agli utenti di mantenere un modulo in corso di lavorazione. Un utente può quindi completare e inviare il modulo in qualsiasi momento da qualsiasi dispositivo.
Per impostazione predefinita, AEM Forms memorizza i dati utente associati alla bozza e all’invio nell’istanza Pubblica in /content/forms/fp nodo.
Tuttavia, i componenti del portale AEM Forms forniscono servizi dati che consentono di personalizzare l’implementazione dell’archiviazione dei dati utente per bozze e invii. Ad esempio, puoi archiviare i dati in un archivio dati attualmente implementato nella tua organizzazione.
Per personalizzare la memorizzazione dei dati utente, è necessario implementare il Dati bozza e Dati di invio servizi.
Prerequisiti prerequisites
Servizio dati bozza draft-data-service
Per personalizzare l'archiviazione dei dati di bozza dell'utente, è necessario fornire l'implementazione di tutti i metodi del DraftAFDataService interfaccia.
Una descrizione dei metodi e dei relativi argomenti è fornita nel seguente codice di esempio dell’interfaccia:
public interface DraftAFDataService {
/**
* Deletes the user data stored against the ID passed as the argument
*
* @param draftDataID
* @return status for the just occurred delete draft UserData operation
* @throws FormsPortalException
*/
public Boolean deleteAFDraftUserData (String draftDataID) throws FormsPortalException;
/**
* Saves user data provided in the argument map
*
* @param draftUserDataMap contains Form Data (key - "guideState"), Adaptive Form Name (Key - "guideName"), and Draft DataID (Key - "userDataID") in case of update
* @return userData ID would be returned which needs to be saved in metadata node
* @throws FormsPortalException
*/
public String saveAFUserData (Map<String, Object> draftUserDataMap) throws FormsPortalException;
/**
* Gets the user data stored against the ID passed as the argument
*
* @param Draft DataID
* @return guideState (which would then be populated in adaptive form to reload the draft) which is stored against draftDataID
* @throws FormsPortalException
*/
public byte[] getAFDraftUserData(String draftDataID) throws FormsPortalException;
/**
* Saves the attachments for current adaptive form instance
*
* @param attachmentsBytes would expect byte array of the attachment to be saved
* @return id for the attachment just saved (so that it could be retrieved later)
* @throws FormsPortalException
*/
public String saveAttachments(byte[] attachmentBytes) throws FormsPortalException;
}
Servizio dati di invio submission-data-service
Per personalizzare l’archiviazione dei dati di invio degli utenti, è necessario fornire l’implementazione di tutti i metodi del SubmittedAFDataService interfaccia.
Una descrizione dei metodi e dei relativi argomenti è fornita nel seguente codice di esempio dell’interfaccia:
public interface SubmittedAFDataService {
/**
* Submits the user data passed in argument map
*
* @param submittedAFUserdataMap contains Form Data (key - "guideState"), Adaptive Form Name (Key - "guideName"), and Draft DataID (Key - "userDataID")
* @return userData ID is returned that needs to be saved in the metadata node
* @throws FormsPortalException
*/
public String submitAFUserData (Map<String, Object> submittedAFUserdataMap) throws FormsPortalException;
/**
* Gets the user data stored against the ID passed as argument
*
* @param submitDataID
* @return guideState which would be used to open DOR
* @throws FormsPortalException
*/
public byte[] getSubmittedAFUSerData(String submitDataID) throws FormsPortalException;
/**
* Deletes user data stored against the ID passed as argument
*
* @param Submit DataID
* @return status of the delete operation on Submitted User data
* @throws FormsPortalException
*/
public Boolean deleteSubmittedAFUserData(String submitDataID) throws FormsPortalException;
/**
* Submits the attachment bytes passed as argument
*
* @param attachmentsBytes would expect byte array of the attachment to be saved
* @return id for the attachment just saved (so that it could be retrieved later)
* @throws FormsPortalException
*/
public String submitAttachments(Object attachmentBytes) throws FormsPortalException;
}