v7

Connettere Campaign e Microsoft Dynamics 365

Ultimo aggiornamento: 2023-08-01

In questa pagina imparerai a collegare Campaign Classic a Microsoft Dynamics CRM 365.

La possibile implementazione avviene tramite API web (consigliato). Fai riferimento a la sezione seguente per informazioni sulla procedura per configurare la connessione con Microsoft Dynamics.

La sincronizzazione dei dati viene eseguita tramite un’attività del flusso di lavoro dedicata. Ulteriori informazioni.

Passaggi di implementazione

Per collegare Microsoft Dynamics 365 per lavorare con Adobe Campaign tramite API web, è necessario applicare i seguenti passaggi:

In Microsoft Dynamics CRM:

  1. Ottieni ID client Microsoft Dynamics
  2. Genera ID chiave e identificatore chiave del certificato di Microsoft Dynamics
  3. Configurare le autorizzazioni
  4. Creare un utente dell’app
  5. Codifica la chiave privata

Per ulteriori informazioni, consulta questa sezione

In Campaign Classic:

  1. Crea un nuovo account esterno
  2. Configurare l’account esterno con le impostazioni di Microsoft Dynamics
  3. Utilizzare la configurazione guidata per mappare tabelle e sincronizzare enumerazioni
  4. Creare il flusso di lavoro di sincronizzazione

Per ulteriori informazioni, consulta questa sezione

ATTENZIONE

Quando si collega Adobe Campaign con Microsoft Dynamics, non è possibile:

  • Installa plug-in che possono modificare il comportamento del sistema CRM e causare problemi di compatibilità con Adobe Campaign
  • Seleziona più enumerazioni

Configurare Microsoft Dynamics CRM

Per generare il token di accesso e le chiavi per configurare l’account, devi accedere a Directory di Microsoft Azure utilizzando un Amministratore globale credenziali. Quindi segui i passaggi descritti di seguito.

Ottieni ID client Microsoft Dynamics

Per ottenere l'ID client, è necessario registrare un'app in Azure Active Directory. L’ID client è uguale all’ID applicazione.

  1. Accedi a Azure Active Directory > Registrazioni app e fai clic su Registrazione nuova applicazione.
  2. Assegna un nome univoco che possa aiutare a identificare un’istanza, ad esempio adobecampaign<instance identifier>.
  3. Scegli Tipo di applicazione as App web/API.
  4. Utilizzare http://localhost per URL di accesso.

Una volta effettuato il salvataggio, si ottiene un ID applicazione che è l’identificatore client di Campaign.

Per ulteriori informazioni, consulta questa pagina.

Genera ID chiave e identificatore chiave del certificato di Microsoft Dynamics

Per ottenere Identificatore chiave del certificato (customKeyIdentifier) e ID chiave (keyId), effettua le seguenti operazioni:

  1. Accedi a Azure Active Directory > Registrazioni app e selezionare l'applicazione creata in precedenza.

  2. Fai clic su Certificati e segreto.

  3. Fai clic su Carica certificato quindi sfoglia e carica il certificato pubblico generato.

  4. Per generare il certificato è possibile utilizzare openssl.

    Ad esempio:

    - openssl req -x509 -sha256 -nodes -days 365 -newkey rsa:2048 -keyout '<'private key name'>' -out '<'public certificate name'>
    
    NOTA

    Puoi modificare il numero di giorni qui -days 365, nel codice di esempio per un periodo di validità del certificato più lungo.

  5. Sarà quindi necessario codificarlo in base64. A tale scopo, è possibile utilizzare l'aiuto di un codificatore Base64 o la riga di comando base64 -w0 private.key per Linux.

  6. Fai clic sul pulsante Manifesto collegamento per ottenere Identificatore chiave del certificato (customKeyIdentifier) e ID chiave (keyId).

Il Identificatore chiave del certificato (customKeyIdentifier) e ID chiave (keyId) sarà necessario in seguito per configurare l'account esterno di Microsoft Dynamics CRM tramite il certificato CRM O-Auth type.

Configurare le autorizzazioni

Passaggio 1: configura il Autorizzazioni richieste per l’app creata.

  1. Accedi a Azure Active Directory > Registrazioni app e selezionare l'applicazione creata in precedenza.

  2. Clic Impostazioni in alto a sinistra.

  3. On Autorizzazioni richieste, fai clic su Aggiungi e Seleziona un’API > Dynamics CRM Online.

  4. Clic Seleziona, abilita Accedere a Dynamics 365 come utenti dell’organizzazione e fai clic su Seleziona.

  5. Quindi, dall’app, seleziona la Manifesto sotto Gestisci menu.

  6. Dalla sezione Manifesto editor, imposta allowPublicClient proprietà da null a true e fai clic su Salva.

Passaggio 2: concedi il consenso all’amministratore

  1. Accedi a Azure Active Directory > Applicazioni aziendali.

  2. Seleziona l’applicazione a cui desideri concedere il consenso dell’amministratore a livello di tenant.

  3. Dal menu del riquadro a sinistra, seleziona Autorizzazioni in Sicurezza.

  4. Clic Concedere il consenso dell’amministratore.

Per ulteriori informazioni, consulta Documentazione di Azure.

Creare un utente dell’app

NOTA

Questo passaggio è facoltativo con Password credentials autenticazione.

L’utente dell’app è l’utente che verrà utilizzato dall’applicazione registrata in precedenza. Eventuali modifiche apportate a Microsoft Dynamics utilizzando l’app registrata in precedenza verranno eseguite tramite questo utente.

Passaggio 1: crea un utente non interattivo in Azure Active Directory

  1. Clic Azure Active Directory > Utenti e fai clic su Nuovo utente.
  2. Assegna un nome appropriato che desideri utilizzare e il nome utente deve essere in formato e-mail.
  3. Scegli Amministratore Dynamics 365 nel Ruolo directory.

Passaggio 2: assegna una licenza corretta all’utente creato

  1. Da Microsoft Azure, fai clic su App di amministrazione.
  2. Vai a Utenti > Utenti attivi e fai clic sul nuovo utente creato.
  3. Fai clic su Modifica licenze prodotto e seleziona la Piano di coinvolgimento del cliente Dynamics 365.
  4. Fai clic su Chiudi.

Passaggio 3: crea un utente dell’applicazione in Dynamics CRM

  1. Da Microsoft Azure, passa a Impostazioni > Protezione > Utenti.

  2. Fai clic sull’elenco a discesa, seleziona Utenti dell’applicazione e fai clic su Nuovo.

  3. Utilizza lo stesso nome utente creato in Active Directory in precedenza

    NOTA

    Se si utilizza lo stesso nome, viene generato un errore di chiave duplicata; finché non viene confermato se questo passaggio è necessario, utilizza un nome utente diverso e procedi.

  4. Assegna la ID applicazione per l'applicazione creata in precedenza.

  5. Fai clic su Gestisci ruoli e scegli la Amministratore di sistema ruolo all'utente.

Configurare Campaign

NOTA

Registrare la disattivazione di RDS da Microsoft, i tipi di distribuzioni CRM On-Premise e Office 365 non sono più compatibili con Campaign. Adobe Campaign ora supporta solo la distribuzione API web per la versione CRM CRM dinamico 365. Ulteriori informazioni.

Per connettere Microsoft Dynamics 365 e Campaign, è necessario creare e configurare una External Account in Campaign.

  1. Accedi a Administration > Platform > External accounts.

  2. Seleziona la Microsoft Dynamics CRM account esterno. Seleziona l’opzione Enabled.

  3. Inserisci le informazioni necessarie per connettere Microsoft Dynamics 365 e Campaign.

    NOTA

    Configurazione account esterno di Microsoft Dynamics CRM con ogni CRM O-Auth type è dettagliato in questa sezione.

  4. Fai clic sul collegamento Microsoft CRM configuration wizard…. Adobe Campaign rileva automaticamente le tabelle dal modello dati di Microsoft Dynamics.

  5. Seleziona le tabelle da recuperare.

  6. Clic Next per iniziare a creare lo schema corrispondente.

    NOTA

    Per approvare la configurazione, devi disconnetterti/riconnetterti alla console Adobe Campaign.

    Puoi verificare che lo schema di dati corrispondente diventi disponibile in Adobe Campaign.

  7. Fai clic su Synchronizing enumerations… collegamento per avviare la sincronizzazione delle enumerazioni tra Adobe Campaign e Microsoft Dynamics.

Campaign e Microsoft Dynamics sono ora connessi. È possibile impostare la sincronizzazione dei dati tra i due sistemi. Per ulteriori informazioni, consulta Sincronizzazione dei dati sezione.

NOTA

È necessario assicurarsi di aggiungere all’di inserire nell'elenco Consentiti due URL: l’URL del server e login.microsoftonline.com nella configurazione del server. Per ulteriori informazioni su come configurare le autorizzazioni URL, consulta questa pagina.

Tipi di dati dei campi supportati

Di seguito sono elencati i tipi di attributo supportati/non supportati per Microsoft Dynamics 365:

Tipo di attributo Supportato
Tipi di base : boolean, datetime, decimal, float, double, integer, bigint , string
Denaro (doppio)
memo, entityname , primarykey, uniqueidentifier (come stringhe)
Stato, elenco a discesa (i valori possibili vengono memorizzati nelle enumerazioni), stato (stringa)
proprietario (come stringa)
Ricerca (solo ricerche di riferimento a entità singola)
cliente No
Riguardo No
PartyList No
ManagedProperty No
Set di opzioni MultiSelect No

In questa pagina