CRUD-Vorgänge im Kundenkontaktverlauf mithilfe von Code

Das Kundenkontaktverlauf-SDK-Beispiel ist ein Beispiel mit verwaltetem Code von .NET. Es zeigt, wie die Kundenkontaktverlauf-APIs verwendet werden. Die Beispielziele bei der Verwendung des Kundenkontaktverlauf-SDK aus einer .NET-Konsolenanwendung. Das Kundenkontaktverlauf-SDK kann von Plug-In-Code aus verwendet werden.

Laden Sie das Beispiel herunter: Kundenkontaktverlauf-SDK

Wenn Sie die ZIP-Datei extrahieren, finden Sie darin drei Projekte:

• Microsoft.Dynamics.Marketing.SDK, das die grundlegende wiederverwendbare Funktion definiert, die den Zugriff auf Kundenkontaktverlauf-APIs vereinfacht. Es enthält:
  • Organisierte Konstanten, die den Verweis auf Metadatenelemente vereinfachen, wie Entitäten und Optionssätze.
  • Ein Generator, um die Erstellung von Kundenkontaktverlaufs-Entwürfen zu vereinfachen (programmgesteuerte Entsprechung des Kundenkontaktverlauf-Designers).
  • Kapselung von Datenverträgen (Anforderungen und Antworten) für die meisten wichtigen Marketingvorgänge, wie das Überprüfen von Kundenkontaktverlauf-Fehlern.
• Microsoft.Dynamics.Marketing.SDK.Tests, das Einheitstests enthält, die die Qualität von Microsoft.Dynamics.Marketing.SDK sicherstellen.
• Microsoft.Dynamics.Marketing.Samples, das ein ausführbares Programm ist, das verwendet wird, um die tatsächlichen Beispiele auszuführen. Es enthält Code für:
  • Erstellen eines Kundenkontaktverlaufs aus einem vorhandenen Vorlagendatensatz.
  • Erstellen eines Beispiel-Kundenkontaktverlaufs mit einem Segment und E-Mail.
  • Überprüfung und Veröffentlichung des vorhandenen Kundenkontaktverlauf-Datensatzes.
  • Erstellen Interaktion mit benutzerdefinierten Kanalaktivitäten aus dem benutzerdefinierten Kanalaktivitätsdatensatz Kundenkontaktverlauf.

Hinweis

Sie müssen auf die Microsoft Dynamics 365 Marketing-Instanz Zugriff haben. Weitere Informationen: Installieren von Dynamics 365 Marketing.

Wie das Beispiel ausgeführt wird

1. Laden Sie das Beispiel herunter und extrahieren Sie es.
2. Öffnen Sie Microsoft.Dynamics.Marketing.Samples.sln in Visual Studio.
3. Implementieren Sie die GetConnectionString-Methode in Program.cs. Suchen Sie im Quellcode nach Anweisungen. Dies ist erforderlich, um sich in einer bestimmten Dynamics 365 Marketing-Instanz anzumelden.
4. Wählen Sie das Beispiel aus, das Sie ausführen möchten, indem Sie Befehlszeilenparameter verwenden; zum Beispiel customerjourneycreate erstellt einen Beispielkundenkontaktverlauf mit einem Segment und einer E-Mail. Wenn Sie keinen Parameter angeben, wird der Verwendungsbildschirm gedruckt.
5. Drücken Sie F5, um das Beispiel auszuführen.

Funktionsweise dieses Beispiels

Das Kundenkontaktverlauf-SDK-Beispiel zeigt, wie Sie:

1. Kundenkontaktverlaufs-Daten abfragen.
2. Einen neuen Kundenkontaktverlauf anhand einer Kundenkontaktverlaufs-Vorlage erstellen.
3. Einen neuen Kundenkontaktverlauf mit einem spezifischen Workflowdesign erstellen.
4. Einen vorhandenen Kundenkontaktverlauf-Datensatz nach Fehlern überprüfen.
5. Einen vorhandenen Kundenkontaktverlauf-Datensatz veröffentlichen.
6. Erstellt Interaktion mit benutzerdefinierten Kanalaktivitäten aus dem benutzerdefinierten Kanalaktivitätsdatensatz Kundenkontaktverlauf.

Beispiele

Microsoft.Dynamics.Marketing.SDK.dll verwendet das Kern-SDK zum Verarbeiten von Organisationsanforderungen. Der Quellcode dieses Projekts kann im Plug-In-Code eingebettet und ausgeführt werden.

Dieses Beispiel veranschaulicht, wie Sie den Befehl Auf Fehler überprüfen programmgesteuert aufrufen:

using Microsoft.Dynamics.Marketing.SDK; 
using Microsoft.Dynamics.Marketing.SDK.CustomerJourney.Validation; 
using Microsoft.Dynamics.Marketing.SDK.Metadata.Entities; 
using Microsoft.Xrm.Sdk; 
using Microsoft.Xrm.Sdk.Query; 
using System; 
 
public class Snippet 
{ 
    public ValidationResponse CheckForErrors( 
            IOrganizationService organizationService,  
            Guid customerJourneyRecordId) 
    { 
        // Retrieve record 
        var customerJourneyRecord = organizationService.Retrieve(
            EntityLogicalNames.CustomerJourney,
            customerJourneyRecordId,
            new ColumnSet(true));
       
        // Call check for errors service 
        var validationRequest = ValidationRequest.FromCustomerJourneyEntity(customerJourneyRecord); 

        // Transform the organization response to strongly typed validation response 
        return organizationService.Execute(validationRequest.OrganizationRequest).ToValidationResponse(); 
    } 
} 

Dieses Beispiel veranschaulicht, wie Sie einen Kundenkontaktverlaufs-Workflow programmgesteuert erstellen:

using Microsoft.Dynamics.Marketing.SDK.CustomerJourney.Workflow; 
using System; 
 
public class Snippet 
{ 
    public CustomerJourneyDesign CreateSimpleCustomerJourney() 
    { 
        var designBuilder = new CustomerJourneyDesignBuilder(); 
        var segmentActivityId = Guid.NewGuid().ToString(); 
        var emailActivityId = Guid.NewGuid().ToString(); 
        designBuilder.Root.With(
            new WorkflowActivityBuilder(ActivityType.Segment, segmentActivityId, "Sample Contacts") 
                .WithParentActivityId(designBuilder.Root.RootActivityId) 
                .WithHeaderItemProperty("SegmentMergeMethod", "Union") 
                .WithSubItem(new ItemBuilder(ActivityType.SegmentItem, "Sample Segment") 
                    .WithProperty("ContainmentMethod", "Inclusion") 
                    .WithProperty("SegmentSourceType", "Segment")), 
            new WorkflowActivityBuilder(ActivityType.Email, emailActivityId, "Sample Email") 
                .WithParentActivityId(segmentActivityId)); 
 
            return designBuilder.Build(); 
    } 
} 

In diesem Beispiel sehen Sie, wie Sitzung starten programmgesteuert aufgerufen wird:

using Microsoft.Dynamics.Marketing.SDK.Metadata.OptionSets; 
using Microsoft.Dynamics.Marketing.SDK.Wrappers; 
using Microsoft.Xrm.Sdk; 
using System; 

public class Snippet 
{ 
    public void PublishCustomerJourney(IOrganizationService organizationService, Guid customerJourneyId) 
    { 
        var customerJourney = new CustomerJourneyEntity(customerJourneyId) 
        { 
            StateCode = new OptionSetValue(CustomerJourneyStatusCode.GoingLive) 
        };
        organizationService.Update(customerJourney.Entity); 
    } 
} 

Siehe auch

Kundenkontaktverlauf mithilfe von API erweitern

Hinweis

Können Sie uns Ihre Präferenzen für die Dokumentationssprache mitteilen? Nehmen Sie an einer kurzen Umfrage teil. (Beachten Sie, dass diese Umfrage auf Englisch ist.)

Die Umfrage dauert etwa sieben Minuten. Es werden keine personenbezogenen Daten erhoben. (Datenschutzbestimmungen).