Les newsletter poden veure's com publicacions i també poden funcionar igual. Però són, internament, completament diferents. Així com una newsletter pot fer de publicació, al la inversa és impossible.

La composició d'una newsletter és el següent (només els camps més significatius):

Camp	Explicació
Títol	És el títol de la newsletter. Per a newsletter tipus informe, el títol de la newsletter pot contenir macros que s'expandiran en el moment de l'enviament. Això permet crear els números de newsletter a partir d'una sola maquetació.
Acceptat	Cert quan la newsletter és llesta per a ser enviada.
Categoria	Es correspon a les categories d'enviament del sistema i inclouen les categories de publicacions. Les categories són les que administren les subscripcions.
Plantilla	És el sobre que s'utilitzarà per enviar la newsletter. Per defecte és el mateix que s'utilitza per a la resta de notificacions. En la configuració bàsica s'afegeix la NoLogo, que elimina el logo inicial de la plantilla per defecte, i la Clean que només deixa el cos central de la plantilla.
Contingut estàtic	Aquest atribut controla la duració en el temps del contingut d'una newsletter. Quan el contingut és estàtic, la newsletter està pensada per a ser enviada una única vegada. Les newsletter amb contingut estàtic poden ser fàcilment substituïdes per publicacions dins newsletter sense contingut estàtic.
Vol o Podria voler	La Newsletter pot comportar-se com una notificació de sistema variant aquest atribut. Vol comprova que l'usuari tingui acceptats tots els acords de notificacions i la subscripció sigui activa. Podria voler comprova que l'usuari no hagi denegat algun acord de notificació i la subscripció sigui activa. Per a més informació, veieu Mail queue .
Seccions	Són el contingut de la newsletter. Poden ser de diferents tipus, segons la informació que continguin.

Les seccions

Les seccions tenen propietats comunes i propietats específiques segons el tipus.

Propietats comunes

Propietat	Explicació
Columna	Una secció pot ser una columna. Si es marca aquest atribut, les seccions adjacents amb el mateix atribut formen columnes.
Ample	Si la secció és una columna, aquest atribut controla l'amplada de la columna. Si no s'indica res, les columnes es distribueixen amb el mateix ample.
Disparador	Per enviaments que necessitin disparador, aquest atribut converteix la secció en un disparador només si té contingut.

Tipus de seccions

Tipus	Explicació
Text	Les seccions de tipus text són de contingut wiki. Contenen text amb format, imatges i qualsevol altre contingut multimèdia admès pel wiki.
Imatge	Les seccions d'imatge són formades per una imatge que ocuparà el 100% d'ample de la secció. La utilitat és crear banners amb facilitat.
Externa	Les seccions externes s'alimenten del contingut dels mòduls BrightSide. Una secció externa, per exemple, podria contenir publicacions, una publicació sola, un llistat de temes per fer, projectes, contractes, documents. Les seccions externes admeten crear filtres de les dades que mostren, poden fer que el contingut sigui personalitzat per a cada persona a qui s'envia.

Propietats per tipus de secció

Tipus	Propietat	Explicació
Text o Externa	Banner	És el banner que encapçalarà la secció. La newsletter proporciona un editor de banners per facilitar-ne la creació.
Imatge	Imatge	És la imatge que omplirà la secció. La imatge ocuparà l'ample total de la secció, tenint en compte si és una columna.
Imatge	Enllaç	Si es defineix un enllaç, quan es faci click sobre la imatge es navegarà fins l'enllaç.

Gràfica simplificada d'una newsletter

Les seccions externes permeten incloure contingut d'altres mòduls. La comunicació es fa via funcions macro que s'expandeixen en el contingut final. Segons els atributs, una funció pot tornar contingut específic per a cada usuari o genèric per a tots.

No cal escriure les macros senceres. La majoria funcionen correctament amb els paràmetres per defecte.

convocations

Mostra les convocatòries.

convocations([context=<String>];[count=10<Integer>];[template=summary<String>];[restricted=true<Boolean>];[public=false<Boolean>];[future=true<Boolean>])

Atributs	Descripció	Tipus	Opcions	Per defecte
context	Indica on porten els enllaços per llegir més.	<String>
count	El nombre d'ítems a mostrar.	<Integer>		10
template	El patró del format per mostrar els items.	<String>		summary
restricted	Cert si el que es mostra és específic per a l'usuari.	<Boolean>		true
public		<Boolean>		false
future	Cert si es mostren els items amb data futura.	<Boolean>		true

polls

Mostra les enquestes.

polls([context=<String>];[count=10<Integer>];[restricted=true<Boolean>];[active=false<Boolean>];[template=summary<String>])

Atributs	Descripció	Tipus	Opcions	Per defecte
context	Indica on porten els enllaços per llegir més.	<String>
count	El nombre d'ítems a mostrar.	<Integer>		10
restricted	Cert si el que es mostra és específic per a l'usuari.	<Boolean>		true
active	Cert si l'item es actiu.	<Boolean>		false
template	El patró del format per mostrar els items.	<String>		summary

dossiers

Mostra els dossiers.

dossiers([status=onwork<onwork|closed|all>];[context=<String>];[categoryIds=<String>];[dossierId=0<Long>];[count=10<Integer>];[restricted=false<Boolean>];[direct=false<Boolean>];[related=false<Boolean>];[template=summary<String>])

Atributs	Descripció	Tipus	Opcions	Per defecte
status	L'estat en que es troba l'item.	<String>	onwork|closed|all	onwork
context	Indica on porten els enllaços per llegir més.	<String>
categoryIds	Les categories a mostrar. Buit per a totes.	<String>
dossierId	L'identificador del dossier a mostrar.	<Long>		0
count	El nombre d'ítems a mostrar.	<Integer>		10
restricted	Cert si el que es mostra és específic per a l'usuari.	<Boolean>		false
direct	Cert si el que es mostra és per participació directe de l'usuari.	<Boolean>		false
related	Cert si el que es mostra es participat per membres de la mateixa empresa que l'usuari.	<Boolean>		false
template	El patró del format per mostrar els items.	<String>		summary

projects

Mostra els projectes.

projects(status=onwork<onwork|closed|all>;context=<String>;[categoryIds=<String>];[dossierId=0<Long>];[count=10<Integer>];[restricted=false<Boolean>];[direct=false<Boolean>];[related=false<Boolean>];[template=summary<String>])

Atributs	Descripció	Tipus	Opcions	Per defecte
status	L'estat en que es troba l'item.	<String>	onwork|closed|all	onwork
context	Indica on porten els enllaços per llegir més.	<String>
categoryIds	Les categories a mostrar. Buit per a totes.	<String>
dossierId	L'identificador del dossier a mostrar.	<Long>		0
count	El nombre d'ítems a mostrar.	<Integer>		10
restricted	Cert si el que es mostra és específic per a l'usuari.	<Boolean>		false
direct	Cert si el que es mostra és per participació directe de l'usuari.	<Boolean>		false
related	Cert si el que es mostra es participat per membres de la mateixa empresa que l'usuari.	<Boolean>		false
template	El patró del format per mostrar els items.	<String>		summary

issues

Mostra els temes.

issues(status=onwork<onwork|closed|all>;context=<String>;[categoryId=0<Long>];[dossierId=0<Long>];[count=10<Integer>];[restricted=false<Boolean>];[template=summary<String>])

Atributs	Descripció	Tipus	Opcions	Per defecte
status	L'estat en que es troba l'item.	<String>	onwork|closed|all	onwork
context	Indica on porten els enllaços per llegir més.	<String>
categoryId	La categoria que es mostrarà. Zero per a totes.	<Long>		0
dossierId	L'identificador del dossier a mostrar.	<Long>		0
count	El nombre d'ítems a mostrar.	<Integer>		10
restricted	Cert si el que es mostra és específic per a l'usuari.	<Boolean>		false
template	El patró del format per mostrar els items.	<String>		summary

workload

Mostra la càrrega de treball de l'usuari.

workload(context=<String>;[count=10<Integer>];[template=summary<String>])

Atributs	Descripció	Tipus	Opcions	Per defecte
context	Indica on porten els enllaços per llegir més.	<String>
count	El nombre d'ítems a mostrar.	<Integer>		10
template	El patró del format per mostrar els items.	<String>		summary

kb

Mostra el contingut de la base de coneixement.

kb(context=<String>;[count=10<Integer>];[template=summary<String>])

Atributs	Descripció	Tipus	Opcions	Per defecte
context	Indica on porten els enllaços per llegir més.	<String>
count	El nombre d'ítems a mostrar.	<Integer>		10
template	El patró del format per mostrar els items.	<String>		summary

contracts

Mostra els contractes.

contracts([status=active<active|closed|all>];[context=<String>];[count=10<Integer>];[intervention=true<Boolean>];[type=0<Integer>];[template=summary<String>])

Atributs	Descripció	Tipus	Opcions	Per defecte
status	L'estat en que es troba l'item.	<String>	active|closed|all	active
context	Indica on porten els enllaços per llegir més.	<String>
count	El nombre d'ítems a mostrar.	<Integer>		10
intervention	Cert si es comprova la intervenció dins el contracte.	<Boolean>		true
type	El tipus de l'item.	<Integer>		0
template	El patró del format per mostrar els items.	<String>		summary

last-activity

Mostra la darrera activitat de tots els mòduls dirigida a l'usuari i tenint en compte els seus permisos.

last-activity([context=<String>];[count=50<Integer>];[days=7<Integer>];[path=<String>];[template=summary<String>])

Atributs	Descripció	Tipus	Opcions	Per defecte
context	Indica on porten els enllaços per llegir més.	<String>
count	El nombre d'ítems a mostrar.	<Integer>		50
days	Nombre de dies a revisar.	<Integer>		7
path	Trajectoria de l'entitat a revisar. Buit si totes.	<String>
template	El patró del format per mostrar els items.	<String>		summary

publications

Mostra les publicacions.

publications([context=<String>];[categoryId=0<Long>];[groupId=0<Long>];[count=10<Integer>];[template=summary<String>];[notSent=false<Boolean>];[lang=<String>];[asBlogger=false<Boolean>];[future=false<Boolean>])

Atributs	Descripció	Tipus	Opcions	Per defecte
context	Indica on porten els enllaços per llegir més.	<String>
categoryId	La categoria que es mostrarà. Zero per a totes.	<Long>		0
groupId	El grup que es mostrarà. Zero per a tots.	<Long>		0
count	El nombre d'ítems a mostrar.	<Integer>		10
template	El patró del format per mostrar els items.	<String>		summary
notSent	Cert si es mostren les no enviades.	<Boolean>		false
lang	L'idiome de l'item. Buit per a tots.	<String>
asBlogger	Els items pendents de l'usuari amb el rol de blogger.	<Boolean>		false
future	Cert si es mostren els items amb data futura.	<Boolean>		false

challenges

challenges([status=active<active|closed|all>];[context=<String>];[count=10<Integer>];[restricted=false<Boolean>];[studentRelated=false<Boolean>];[challengerRelated=false<Boolean>];[responseFrom=15<Integer>];[template=summary<String>])

Atributs	Descripció	Tipus	Opcions	Per defecte
status	L'estat en que es troba l'item.	<String>	active|closed|all	active
context	Indica on porten els enllaços per llegir més.	<String>
count	El nombre d'ítems a mostrar.	<Integer>		10
restricted	Cert si el que es mostra és específic per a l'usuari.	<Boolean>		false
studentRelated		<Boolean>		false
challengerRelated		<Boolean>		false
responseFrom		<Integer>		15
template	El patró del format per mostrar els items.	<String>		summary

Per tal de cobrir tots els casos que permeten les newsletter, la tasca que llança el contingut pels subscriptors és diferent de la tasca d'enviament de publicacions.

Diferències per decidir si enviar

La llançadora de newsletter té en compte que els diferents continguts venen de diferents mòduls. Si la llançadora es defineix com a Necessita disparador, previ a l'enviament, la llançadora comprovarà que hi hagi continguts en aquelles seccions marcades com a Disparador.

Diferències en els subscriptors

Opcionalment, la llançadora pot restringir els nombre de recipients a criteris de mòdul. Un cop seleccionats els recipients, aquests passaran pel filtre de subscripció, on es diu si volen o no rebre de la categoria de la newsletter.

Tot i que és possible crear tantes newsletter com s'enviïn, l'objectiu principal és permetre usar les newsletter com eina de maquetació i captar el contingut de l'activitat dins les bases de dades.

El que segueix són exemples dels diferents tipus de newsletter segons els atributs o la llançadora que s'utilitzi.

Variacions pel contingut

Newsletter tipus informe

Valor	Explicació
Títol	Pot ser un títol normal, tipus Informe d'estat.
Estàtica/Dinàmica	El contingut no es guarda com enviat en una data determinada. Cada vegada que es consulti o s'enviï, variarà segons les dades del moment de la consulta.

Newsletter tipus publicació via números

Valor	Explicació
Títol	El títol ha de contenir el número. Aquest pot ser del format any/mes per enviaments mensuals.
Estàtica/Dinàmica	El contingut es guarda com enviat en una data determinada. Cada vegada que es consulti o s'enviï el número, es veurà el mateix que es va enviar per primer cop.

Variacions per llançadora

Newsletter periòdiques

Llançadora	Explicació
Tasca periòdica	Una tasca periòdica genera el contingut i l'envia als subscriptors.

Newsletter d'activitat

Llançadora	Explicació
Una activitat concreta	Una activitat genera el contingut i l'envia als subscriptors.