10. Dezember 2021

· Whitepaper

CreateCentralSection

Inhaltsverzeichnis

xx Kapitel

Erstellen von zentralen Inhalten

RequestParameter: CreateCentralSectionRequest
ResponseParameter: CreateCentralSectionResponse

Mit Hilfe dieser Methode können Sie einen neuen zentralen Inhalt erstellen. Für die Verwaltung von Bildern der Mediendatenbank verwenden Sie das Web-Service MediaService.

Das Request-Objekt besitzt folgende Felder zur Steuerung der Abfrage:

Template: Die Newslettervorlage für welche der zentrale Inhalt erstellt wird.
Section: Der zu erstellende zentrale Inhalt.
Location: Der Pfad in dem der Inhalt abgelegt wird.
DisplayName: Der angezeigte Name.
ValidFrom: Anfangsdatum des Gültigkeitszeitraum. erforlderlich;
ValidTo: Enddatum des Gültigkeitszeitraum. optional;
CatchPhrase: Passendes Schlagwort zur erleichterten Suche des Inhaltes.

Location ist optional. Wird ihr Wert nicht gesetzt so wird der Zentrale Inhalt in das Wurzelverzeichniss abgespeichert.
Die Angabe des Wurzelverzeichnis ist nur notwendig falls der Benutzer in einen direkten Unterordner des Wurzelordners, mit gleicher Bezeichnung wie dieser, navigieren möchte.

Das Response-Objekt enthält keine Informationen.

CreateCentralSection

Beispiel Request „Erstellen von zentralen Inhalten“

C#

//Create an instance of the service agent
ServiceAgent agent = new ServiceAgent();

TemplateRequest request = new TemplateRequest();
request.SecurityContext = GetSecurityContext();

//Get the templates from mailworx
TemplateResponse response = agent.GetTemplates(request);

Template template = response.Templates[0];

//get all section definitions
SectionDefinitionRequest secDefRequest = new SectionDefinitionRequest();
secDefRequest.SecurityContext = GetSecurityContext();
secDefRequest.Template = template;

SectionDefinitionResponse secDefResponse = agent.GetSectionDefinitions(secDefRequest);

//select SectionDefinition
SectionDefinition secDef = secResponse.SectionDefinitions[0];

//create new Section
Section newSection = new Section();
newSection.Created = DateTime.Now;
newSection.SectionDefinitionName = secDef.Name;
newSection.Fields = secDef.Fields;
newSection.StatisticName = "my new section";

foreach (Field field in newSection.Fields) {
	field.UntypedValue = "set some usefull value";
}

//create request
CreateCentralSectionRequest secRequest = new CreateCentralSectionRequest();
secRequest.SecurityContext = GetSecurityContext();
secRequest.Template = template;
secRequest.Section = newSection;

/* Set the path in which the section should be set.
This value is optional and it does not matter if the root path is not typed. */
createRequest.Location = "Ordner 1/Sub Ordner 1/Sub Ordner 2";

// If this value is null or date.MinValue it gets set to DateTime.Today.
createRequest.ValidFrom = new DateTime(2003, 12, 6);

// The optional displayed name.
createRequest.DisplayName = "Neuester Inhalt";

//create the central section
CreateCentralSectionResponse secResponse = agent.CreateCentralSection(secRequest);