Elementos básicos de mensajería messaging-essentials
Esta página documenta los detalles de cómo trabajar con el componente Mensajería para incluir una función de mensajería en un sitio web.
Elementos esenciales para el cliente essentials-for-client-side
Componer mensaje
Lista de mensajes (para Bandeja de entrada, Enviado y Papelera)
Consulte también Personalizaciones del lado del cliente
Elementos esenciales para el servidor essentials-for-server-side
-
API de cliente de mensajería para componentes SCF
-
API de mensajería para el servicio
setInboxPath
()setSentItemsPath
()
code language-none |
---|
|
Sitio de la comunidad community-site
Una estructura de sitio de comunidad, creada con el asistente, incluirá la función de mensajería cuando se seleccione. Consulte User Management
configuración de Consola Sitios de la comunidad.
Código de ejemplo: Notificación de mensaje recibido sample-code-message-received-notification
La función Mensajería social lanza eventos para operaciones, por ejemplo send
, marking read
, marking delete
. Estos eventos se pueden capturar y se pueden realizar acciones con los datos contenidos en el evento.
El siguiente ejemplo es de un controlador de eventos que escucha el message sent
y envía un correo electrónico a todos los destinatarios de mensajes utilizando la variable Day CQ Mail Service
.
Para probar el script de ejemplo del lado del servidor, necesitará un entorno de desarrollo y la capacidad de crear un paquete OSGi.
-
Inicie sesión como administrador para
[CRXDE|Lite](http://localhost:4502/crx/de)
-
Cree un
bundle node
en/apps/engage/install
con nombres arbitrarios, como- Nombre simbólico: com.comprometer.media.social.messaging.MessagingNotification
- Nombre: Notificación de mensaje de tutorial de introducción
- Descripción: un servicio de ejemplo para enviar una notificación por correo electrónico a los usuarios cuando reciban un mensaje
- Paquete:
com.engage.media.social.messaging.notification
-
Navegue hasta
/apps/engage/install/com.engage.media.social.messaging.MessagingNotification/src/main/java/com/engage/media/social/messaging/notification
- Elimine el
Activator.java
clase creada automáticamente - Crear clase
MessageEventHandler.java
- Copie/pegue el código siguiente en
MessageEventHandler.java
- Elimine el
-
Haga clic en Guardar todo
-
Vaya a
/apps/engage/install/com.engage.media.social.messaging.MessagingNotification/com.engage.media.social.messaging.MessagingNotification.bnd
y añada todas las instrucciones de importación tal como se han escrito en la variableMessageEventHandler.java
código. -
Crear el paquete
-
Asegúrese
Day CQ Mail Service
El servicio OSGi está configurado -
Inicie sesión como un usuario de demostración y envíe un correo electrónico a otro
-
El destinatario debe recibir un correo electrónico con respecto a un nuevo mensaje
MessageEventHandler.java messageeventhandler-java
package com.engage.media.social.messaging.notification;
import org.apache.felix.scr.annotations.Component;
import org.apache.felix.scr.annotations.Properties;
import org.apache.felix.scr.annotations.Property;
import org.apache.felix.scr.annotations.Service;
import org.apache.felix.scr.annotations.Reference;
import org.apache.sling.api.resource.ResourceResolver;
import org.apache.sling.api.resource.ResourceResolverFactory;
import org.apache.sling.api.resource.Resource;
import org.apache.commons.mail.Email;
import org.apache.commons.mail.EmailException;
import org.apache.commons.mail.SimpleEmail;
import org.apache.commons.mail.HtmlEmail;
import java.util.List;
import org.osgi.service.event.Event;
import org.osgi.service.event.EventHandler;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import com.adobe.cq.social.messaging.api.Message;
import com.adobe.cq.social.messaging.api.MessagingEvent;
import com.day.cq.mailer.MessageGatewayService;
import com.day.cq.mailer.MessageGateway;
@Component(immediate=true)
@Service(EventHandler.class)
@Properties({
@Property(name = "event.topics", value = "com/adobe/cq/social/message")
})
public class MessagingEventHandler implements EventHandler {
private Logger logger = LoggerFactory.getLogger(MessagingEventHandler.class);
@Reference
ResourceResolverFactory resourceResolverFactory;
@Reference
private MessageGatewayService messageGatewayService;
ResourceResolver resourceResolver=null;
MessageGateway messageGateway=null;
public void sendMail(String from, String to,String subject, String content){
Email email = new SimpleEmail();
messageGateway = messageGatewayService.getGateway(SimpleEmail.class);
try {
email.addTo(to);
email.addReplyTo(from);
email.setFrom(from);
email.setMsg(content);
email.setSubject(subject);
messageGateway.send(email);
} catch(EmailException ex) {
logger.error("MessageNotificaiton : Error sending email : "+ex.getMessage());
}
logger.info("**** MessageNotification **** Mail sent to " + to);
}
public void handleEvent(Event event) {
//Get Message Path and originator User's ID from event
String messagePath = (String) event.getProperty("path");
String senderId = (String) event.getProperty("userId");
MessagingEvent.MessagingActions action = (MessagingEvent.MessagingActions) event.getProperty("action");
try{
if(MessagingEvent.MessagingActions.MessageSent.equals(action)){
resourceResolver = resourceResolverFactory.getAdministrativeResourceResolver(null);
//Read message
Resource resource = resourceResolver.getResource(messagePath);
Message msg = resource.adaptTo(Message.class);
//Get list of recipient Ids from message
//For Getting Started Tutorial, Id is same as email. If that is not the case in your site,
//an additional step is needed to retrieve the email for the Id
List<String> reclist = msg.getRecipientIdList();
for(int i=0;i<reclist.size();i++){
//Send Email using Mailing Service
sendMail("admin@cqadmin.qqq",reclist.get(i),"New message on Getting Started Tutorial", "Hi\nYou have received a new message from " + senderId + ". To read it, sign in to Getting Started Tutorial.\n\n-Engage Admin");
}
}
} catch(Exception ex){
logger.error("Error getting message info : " + ex.getMessage());
} finally {
resourceResolver.close();
}
}
}