Oppgrader til parten og den globale adressebokmodellen
Med Microsoft Azure Data Factory-malene kan du oppgradere eksisterende data i dobbel skriving til partsmodellen og den globale adressebokmodellen: data i Konto, Kontakt og Leverandør tabellene, og postadresser og elektroniske adresser.
Følgende tre Data Factory-maler tilbys. De bidrar til å avstemme dataene fra både økonomi- og driftsapper og kundeengasjementsapper.
- Partsmal (Oppgrader data til dobbel skriving Part-Global adressebok-skjema/arm_template.json) – Denne malen oppgraderer Part og Kontakt-data som er knyttet til Konto-, Kontakt- og Leverandør-data.
- Postadressemal for part (Oppgrader til dobbel skriving Part-Global adressebok-skjema/Oppgrader til postadresse for part - Global adresseliste/arm_template.json) – Denne malen hjelper til med å oppgradere postadressene som er knyttet til Konto-, Kontakt- og Leverandør-data.
- Elektronisk adressemal for part (Oppgrader til dobbel skriving Part-Global adressebok-skjema/Oppgrader til elektronisk adresse for part - Global adresseliste/arm_template.json) – Denne malen hjelper til med å oppgradere elektroniske adresser som er knyttet til Konto-, Kontakt-, og Leverandør-data.
På slutten av prosessen genereres følgende kommaseparerte verdier (.csv)-filer.
Filnavn | Formål |
---|---|
FONewParty.csv | Denne filen bidrar til å generere nye Part-oppføringer i økonomi- og driftsappen. |
ImportFONewPostalAddressLocation.csv | Denne filen hjelper deg med å opprette nye Postadressested-poster i økonomi- og driftsappen. |
ImportFONewPartyPostalAddress.csv | Denne filen hjelper deg med å opprette nye Postadresse for part-poster i økonomi- og driftsappen. |
ImportFONewPostalAddress.csv | Denne filen hjelper deg med å opprette nye Postadresse-poster i økonomi- og driftsappen. |
ImportFONewElectronicAddress.csv | Denne filen hjelper deg med å opprette nye Elektronisk adresse-poster i økonomi- og driftsappen. |
I denne artikkelen finner du instruksjoner om hvordan du kan bruke Data Factory-malene og oppgradere dataene. Hvis du ikke har noen tilpasninger, kan du bruke malene som de er. Hvis du har tilpasninger for Konto, Kontakt og Leverandør-data, må du endre malene ved å følge instruksjonene i denne artikkelen.
Viktig
Det finnes spesielle instruksjoner for kjøring av malene Postadresse for part og Elektronisk adresse for part. Du må kjøre partsmalen først, deretter malen for partspostadresse og deretter den elektroniske adressemalen for part. Hver mal er utformet for å importeres i en separat datafabrikk.
Forutsetninger
Følgende forutsetninger kreves for å oppgradere til parten og den globale adressebokmodellen:
- Du må ha et Azure-abonnement.
- Du må ha tilgang til malene.
- Du må være en eksisterende kunde med dobbel skriving.
Forberede for oppgraderingen
En oppgradering krever følgende forberedelse:
- Fullstendig synkronisering: Både Finance and Operations-miljøet og Customer Engagement-miljøet er i fullstendig synkronisert tilstand for tabellene Konto (Kunde), Kontakt og Leverandør.
- Integrasjonsnøkler:: Tabellene Konto (kunde), Kontakt og Leverandør i Customer Engagement-apper bruker de medfølgende integrasjonsnøklene. Hvis du har tilpasset integrasjonsnøklene, må du tilpasse malen.
- Partsnummer: Alle oppføringer av typen Konto (kunde), Kontakt og Leverandør som skal oppgraderes, har et partsnummer. Poster som ikke har partnummer, blir ignorert. Hvis du vil oppgradere disse oppføringer, legger du til et partsnummer før du starter oppgraderingsprosessen.
- Systembrudd: Under oppgraderingsprosessen må du koble fra både Finance and Operations- og Customer Engagement-miljøer.
- Øyeblikksbilde: Ta et øyeblikksbilde både av økonomi- og driftsappene og kundeengasjementsappene. Du kan bruke øyeblikksbildene til å gjenopprette den forrige tilstanden hvis du må.
Distribusjon
Last ned malene fra Dynamics-365-FastTrack-Implementering-Ressurser.
Logg på Azure-portalen.
Opprett en ressursgruppe.
Opprett en lagringskonto i ressursgruppen som du opprettet.
Opprett en datafabrikk i ressursgruppen som du opprettet.
Åpne datafabrikken og velg flisen Forfatter og overvåking.
På Administrer-fanen velger du ARM-mal.
Velg Importer ARM-mal for å importere partsmalen.
Importer malen til datafabrikken. Angi følgende verdier for Prosjektdetalj og Forekomstdetaljer.
Felt Verdi Abonnement Azure-abonnementet Ressursgruppe Oppgi den samme ressursen som lagringskontoen opprettes under. Område Området Fabrikknavn Fabrikknavnet FO Linked Service_service Principal Key Programmets nøkkel Azure Blob Storage_connection String Azure Blob Storage-tilkoblingsstrengen Dynamics Crm Linked Service_password Passordet for brukerkontoen du oppgir som brukernavnet FO Linked Service_properties_type Properties_url https://sampledynamics.sandbox-operationsdynamics.com/data
FO Linked Service_properties_type Properties_tenant Informasjon (domenenavn eller leier-ID) om leieren som appen ligger under FO Linked Service_properties_type Properties_aad Resource Id https://sampledynamics.sandboxoperationsdynamics.com
FO Linked Service_properties_type Properties_service Principal Id Klient-ID-en til programmet Dynamics Crm Linked Service_properties_type Properties_username Brukernavnet som brukes til å koble til Dynamics 365 Hvis du vil ha mer informasjon, kan du se følgende emner:
Etter distribusjonen validerer du datasettene, dataflyten og den tilkoblede tjenesten til datafabrikken.
Gå til Administrer. Under Tilkoblinger velger du Tilknyttet tjeneste. Velg deretter DynamicsCrmLinkedService. I dialogboksen Rediger tilknyttet tjeneste (Dynamics CRM) angir du følgende verdier.
Felt Verdi Navn DynamicsCrmLinkedService beskrivelse Tilknyttede tjenester for tilkobling til CRM-forekomsten for å hente data for enheter Tilkobling via integrasjonskjøretid AutoResolvelntegrationRuntime Distribusjonstype Tilkoblet Tjeneste-URI https://<organization-name>.crm[x].dynamics.com
Godkjenningstype Office365 Brukernavn Passord eller Azure Key Vault Passord Passord
Forberede kjøring av Data Factory-maler
Denne delen beskriver oppsettet som kreves før du kjører partspostadressen og Data Factory-malene for elektronisk adresse for part.
Oppsett for å kjøre malen for partspostadresse
Logg deg på kundeengasjementsapper, og gå til Innstillinger>Tilpasningsinnstillinger. I kategorien Generelt konfigurerer du deretter tidssoneinnstillingen for systemadministratorkontoen. Tidssonen må være i UTC-tid (Coordinated Universal Time) for å oppdatere "gyldig fra"- og "gyldig til"-datoene for postadresser fra økonomi- og driftsapper.
Opprett følgende global parameter i Data Factory i Administrer-fanen under Globale parameterere.
Tall Navn Type Verdi 1 PostalAddressIdPrefix streng Denne parameteren legger til et serienummer i nyopprettede postadresser som et prefiks. Pass på at du oppgir en streng som ikke er i konflikt med postadresser i økonomi- og driftsapper og kundeengasjementsapper. Bruk eksempel ADF-PAD-. Når du er ferdig, velg du Publiser alle.
Oppsett for å kjøre malen for elektronisk partspostadresse
Opprett følgende globale parametere i Data Factory i Administrer-fanen under Globale parameterere.
Tall Navn Type Verdi 1 IsFOSource bool Denne parameteren bestemmer hvilke hovedsystemadresser som erstattes ved konflikter. Hvis verdien er sann, vil primæradressene i økonomi- og driftsapper erstatte hovedadressene i kundeengasjementsapper. Hvis verdien er usann, vil primæradressene i kundeengasjementsapper erstatte hovedadressene i økonomi- og driftsapper. 2 ElectronicAddressIdPrefix streng Denne parameteren legger til et serienummer i nyopprettede elektroniske adresser som et prefiks. Pass på at du oppgir en streng som ikke er i konflikt med elektroniske adresser i økonomi- og driftsapper og kundeengasjementsapper. Bruk eksempel ADF-EAD-. Når du er ferdig, velg du Publiser alle.
Kjør malene
Stopp følgende dobbel skriving-tilordninger for Part, Konto, Kontakt og Leverandør som bruker økonomi- og driftsapper:
- CDS-parter (msdyn_parties)
- Kunder V3 (kontoer)
- Kunder V3 (kontakter)
- CDS-kontakter V2 (kontakter)
- CDS-kontakter V2 (kontakter)
- Leverandør V2 (msdyn_vendor)
- Kontakter V2 (msdyn_contactforparties)
- Postadressesteder for CDS-part (msdyn_partypostaladdresses)
- Historikk for CDS-postadresse V2 (msdyn_postaladdresses)
- CDS-postadressesteder (msdyn_postaladdresscollections)
- Partskontakter V3 (msdyn_partyelectronicaddresses)
Kontroller at tilordningene er fjernet fra msdy_dualwriteruntimeconfig-tabellen i Dataverse.
Installer Løsninger for part med dobbel skriving og global adressebok fra AppSource.
I økonomi- og driftsappen kjører du Innledende synkronisering for følgende tabeller hvis de inneholder data:
- Hilsener
- Typer personlige tegn
- Avsluttende hilsen
- Kontaktpersontitler
- Roller for beslutningstaking
- Fordelsnivåer
I Customer Engagement-appen deaktiverer du følgende trinn for plugin-moduler:
Kontooppdatering
- Microsoft.Dynamics.GABExtended.Plugins.UpdatePartyAttributesFromAccountEntity: Oppdatering av konto
- Microsoft.Dynamics.FinanceExtended.Plugins.TriggerNotesForCustomerTypeCodes: Oppdatering av konto
Kontaktoppdatering
- Microsoft.Dynamics.GABExtended.Plugins.UpdatePartyAttributesFromContactEntity: Oppdatering av kontakt
- Microsoft.Dynamics.FinanceExtended.Plugins.TriggerNotesForSellableContact: Oppdatering av kontakt
msdyn_party-oppdatering
- Microsoft.Dynamics.GABExtended.Plugins.UpdatePartyAttributesFromPartyEntity: Oppdatering av msdyn_party
msdyn_vendor-oppdatering
- Microsoft.Dynamics.GABExtended.Plugins.UpdatePartyAttributesFromVendorEntity: Oppdatering av msdyn_vendor
Customeraddress
Opprett
- Microsoft.Dynamics.GABExtended.Plugins.CreatePartyAddress: Opprettelse av customeraddress
Oppdater
- Microsoft.Dynamics.GABExtended.Plugins.CreatePartyAddress: Oppdatering av customeraddress
Slett
- Microsoft.Dynamics.GABExtended.Plugins.DeleteCustomerAddress: Sletting av customeraddress
msdyn_partypostaladdress
Opprett
- Microsoft.Dynamics.GABExtended.Plugins.CreateCustomerAddress: Opprettelse av msdyn_partypostaladdress
- Microsoft.Dynamics.GABExtended.Plugins.PartyPostalAddress: Opprettelse av msdyn_partypostaladdress
Oppdater
- Microsoft.Dynamics.GABExtended.Plugins.CreateCustomerAddress: Oppdatering av msdyn_partypostaladdress
- Microsoft.Dynamics.GABExtended.Plugins.PartyPostalAddress: Oppdatering av msdyn_partypostaladdress
msdyn_postaladdress
Opprett
- Microsoft.Dynamics.GABExtended.Plugins.PostalAddress: Opprettelse av msdyn_postaladdress
- Microsoft.Dynamics.GABExtended.Plugins.PostalAddressPostCreate: Opprettelse av msdyn_postaladdress
- Microsoft.Dynamics.GABExtended.Plugins.UpdateCustomerAddress: Opprettelse av msdyn_postaladdress
Oppdater
- Microsoft.Dynamics.GABExtended.Plugins.PostalAddressUpdate: Oppdatering av msdyn_postaladdress
- Microsoft.Dynamics.GABExtended.Plugins.UpdateCustomerAddress: Oppdatering av msdyn_postaladdress
msdyn_partyelectronicaddress
Opprett
- Microsoft.Dynamics.GABExtended.Plugins.PartyElectronicAddressSync: Opprettelse av msdyn_partyelectronicaddress
Oppdater
- Microsoft.Dynamics.GABExtended.Plugins.PartyElectronicAddressSync: Oppdatering av msdyn_partyelectronicaddress
Slett
- Microsoft.Dynamics.GABExtended.Plugins.DeletePartyElectronicAddressSync: Sletting av msdyn_partyelectronicaddress
I Customer Engagement-appen deaktiverer du følgende arbeidsflyter:
- Opprette leverandører i tabellen Kontoer
- Opprette leverandører i tabellen Kontoer
- Opprette leverandører av typen Person i tabellen Kontakter
- Opprette leverandører av typen Person i tabellen Leverandører
- Oppdatere leverandører i tabellen Kontoer
- Oppdatere leverandører i tabellen Leverandører
- Oppdatere leverandører av typen Person i tabellen Kontakter
- Oppdatere leverandører av typen Person i tabellen Leverandører
I datafabrikken kjører du malen ved å velge Utløs nå, som vist på følgende illustrasjon. Det kan ta noen timer å fullføre denne prosessen basert på datavolumet.
Notat
Hvis du har tilpasninger for Konto, Kontakt og Leverandør, må du endre malen.
Importer de nye Part-oppføringene til økonomi- og driftsappen.
- Last ned FONewParty.csv-filen fra Azure Blob Storage. Banen er partybootstrapping/output/FONewParty.csv.
- Konverter FONewParty.csv-filen til en Excel-fil, og importer Excel-filen til økonomi- og driftsappen. Hvis CSV-import fungerer for deg, kan du også importere CSV-filen direkte. Dette kan ta noen timer å fullføre denne prosessen basert på datavolumet. Hvis du vil ha mer informasjon, se Oversikt over dataimport- og -eksportjobber.
I datafabrikken kjører du malene for elektronisk adresse for part og deretter postadresse for part, en etter en.
- Malen for partspostadresse upserter alle postadresseposter i kundeengasjementsappen, og knytter dem til tilsvarende konto, kontakt og leverandør-poster. Den genererer også tre .csv-filer: ImportFONewPostalAddressLocation.csv, ImportFONewPartyPostalAddress.csv og ImportFONewPostalAddress.csv.
- Malen for elektronisk postadresse for part upserter alle elektroniske adresser i kundeengasjementsappen, og knytter dem til tilsvarende konto, kontakt og leverandør-poster. Den genererer også én .csv-fil: ImportFONewElectronicAddress.csv.
Hvis du vil oppdatere økonomi- og driftsappen med disse dataene, må du konvertere .csv-filene til en Excel-arbeidsbok og importere den til økonomi- og driftsappen. Hvis CSV-import fungerer for deg, kan du også importere CSV-filene direkte. Dette kan ta noen timer å fullføre denne prosessen basert på volumet.
I Customer Engagement-appen aktiverer du følgende trinn for plugin-moduler:
Kontooppdatering
- Microsoft.Dynamics.GABExtended.Plugins.UpdatePartyAttributesFromAccountEntity: Oppdatering av konto
- Microsoft.Dynamics.FinanceExtended.Plugins.TriggerNotesForCustomerTypeCodes: Oppdatering av konto
Kontaktoppdatering
- Microsoft.Dynamics.GABExtended.Plugins.UpdatePartyAttributesFromContactEntity: Oppdatering av kontakt
- Microsoft.Dynamics.FinanceExtended.Plugins.TriggerNotesForSellableContact: Oppdatering av kontakt
msdyn_party-oppdatering
- Microsoft.Dynamics.GABExtended.Plugins.UpdatePartyAttributesFromPartyEntity: Oppdatering av msdyn_party
msdyn_vendor-oppdatering
- Microsoft.Dynamics.GABExtended.Plugins.UpdatePartyAttributesFromVendorEntity: Oppdatering av msdyn_vendor
msdyn_partypostaladdress
Opprett
- Microsoft.Dynamics.GABExtended.Plugins.CreateCustomerAddress: Opprettelse av msdyn_partypostaladdress
- Microsoft.Dynamics.GABExtended.Plugins.PartyPostalAddress: Opprettelse av msdyn_partypostaladdress
Oppdater
- Microsoft.Dynamics.GABExtended.Plugins.CreateCustomerAddress: Oppdatering av msdyn_partypostaladdress
- Microsoft.Dynamics.GABExtended.Plugins.PartyPostalAddress: Oppdatering av msdyn_partypostaladdress
msdyn_postaladdress
Opprett
- Microsoft.Dynamics.GABExtended.Plugins.PostalAddress: Opprettelse av msdyn_postaladdress
- Microsoft.Dynamics.GABExtended.Plugins.PostalAddressPostCreate: Opprettelse av msdyn_postaladdress
- Microsoft.Dynamics.GABExtended.Plugins.UpdateCustomerAddress: Opprettelse av msdyn_postaladdress
Oppdater
- Microsoft.Dynamics.GABExtended.Plugins.PostalAddressUpdate: Oppdatering av msdyn_postaladdress
- Microsoft.Dynamics.GABExtended.Plugins.UpdateCustomerAddress: Oppdatering av msdyn_postaladdress
msdyn_partyelectronicaddress
Opprett
- Microsoft.Dynamics.GABExtended.Plugins.PartyElectronicAddressSync: Opprettelse av msdyn_partyelectronicaddress
Oppdater
- Microsoft.Dynamics.GABExtended.Plugins.PartyElectronicAddressSync: Oppdatering av msdyn_partyelectronicaddress
Slett
- Microsoft.Dynamics.GABExtended.Plugins.DeletePartyElectronicAddressSync: Sletting av msdyn_partyelectronicaddress
I kundeengasjementsappen aktiverer du følgende arbeidsflyter hvis du tidligere har deaktivert dem:
- Opprette leverandører i tabellen Kontoer
- Opprette leverandører i tabellen Kontoer
- Opprette leverandører av typen Person i tabellen Kontakter
- Opprette leverandører av typen Person i tabellen Leverandører
- Oppdatere leverandører i tabellen Kontoer
- Oppdatere leverandører i tabellen Leverandører
- Oppdatere leverandører av typen Person i tabellen Kontakter
- Oppdatere leverandører av typen Person i tabellen Leverandører
Kjør de parts-postrelaterte tilordningene som er beskrevet i Part og global adressebok.
Forklaring av Data Factory-malene
Denne delen tar deg gjennom trinnene i hver Data Factory-mal.
Trinn i partsmalen
Trinn 1 til og med 6 identifiserer firmaene som er aktivert for dobbel skriving, og bygger et filteruttrykk for dem.
Trinn 7-1 til og med 7-9 henter data fra både økonomi- og driftsappen og kundeengasjementsappen, og klargjør dataene for oppgradering.
Trinn 8 til og med 9 sammenligner partsnummeret for postene for Konto, Kontakt og Leverandør mellom økonomi- og driftsappen og kundeengasjementsappen. Eventuelle poster som ikke har partsnummer, blir ignorert.
Trinn 10 genererer to .csv-filer for partspostene som må opprettes i kundeengasjementsappen og økonomi- og driftsappen.
- FOCDSParty.csv– Denne filen inneholder alle partsposter for begge systemer, uansett om firmaet er aktivert for dobbel skriving.
- FONewParty.csv – Denne filen inneholder et delsett av partspostene som Dataverse er klar over (for eksempel kontoer av kundeemne-typen).
Trinn 11 oppretter partene i kundeengasjementsappen.
Trinn 12 henter de globale, unike identifikatorene til partene fra kundeengasjementsappen, og klargjør dem slik at de kan knyttes til konto, kontakt og leverandør-postene i påfølgende trinn.
Trinn 13 knytter postene konto, kontakt og og leverandør til partens GUIDer.
Trinn 14-1 til og med 14-3 oppdaterer postene for konto, kontakt og leverandør i kundeengasjementsappen med GUIDene for part.
Trinn 15-1 til og med 15-3 klargjør postene Kontakt for part for konto, kontakt og leverandør.
Trinn 16-1 til og med 16-7 henter referansedata som hilsener og personlige tegntyper, og knytter dem til Kontakt for part-poster.
Trinn 17 fletter Kontakt for part-postene for konto, kontakt og leverandør-postene.
Trinn 18 importerer Kontakt for part-postene til kundeengasjementsappen.
Trinn i malen for partspostadresse
Trinn 1-1 til og med 1-10 henter data fra både økonomi- og driftsappen og kundeengasjementsappen, og klargjør dataene for oppgradering.
Trinn 2 fjerner normaliseringen av postadressedataene i økonomi- og driftsappen ved å flette postadressen og partens postadresse.
Trinn 3 dedupliserer og fletter konto-, kontakt- og leverandøradressedata fra kundeengasjementsappen.
Trinn 4 oppretter .csv-filer for økonomi- og driftsappen for å opprette nye adressedata som er basert på konto-, kontakt- og leverandøradresser.
Trinn 5-1 oppretter .csv-filer for kundeengasjementsappen for å opprette alle adressedata basert på både økonomi- og driftsappen og kundeengasjementsappen.
Trinn 5-2 konverterer .csv-filene til Finance and Operations-importformatet for manuell import.
- ImportFONewPostalAddressLocation.csv
- ImportFONewPartyPostalAddress.csv
- ImportFONewPostalAddress.csv
Trinn 6 importerer data for postadresseinnsamling til kundeengasjementsappen.
Trinn 7 henter data for postadresseinnsamling fra kundeengasjementsappen.
Trinn 8 oppretter kundeadressedata og knytter til en ID for postadresseinnsamling.
Trinn 9-1 til og med 9-2 knytter parts- og postadressesamlings-IDer med postadresser og postadresser til parter.
Trinn 10-1 til og med 10-3 importerer kundeadresser, postadresser og postadresser for parter til kundeengasjementsappen.
Trinn i malen for elektronisk postadresse for part
Trinn 1-1 til og med 1-5 henter data fra både økonomi- og driftsappen og kundeengasjementsappen, og klargjør dataene for oppgradering.
Trinn 2 konsoliderer elektroniske adresser i kundeengasjementsappen fra konto-, kontakt- og leverandørenheter.
Trinn 3 fletter primære elektroniske adressedata fra kundeengasjementsappen og økonomi- og driftsappen.
Trinn 4 oppretter .csv-filer.
- Opprett nye elektroniske adressedata for økonomi- og driftsappen, basert på konto-, kontakt- og leverandøradresser.
- Opprett nye elektroniske adressedata for kundeengasjementsappen, basert på elektronisk adresse, konto, kontakt og leverandøradresser i økonomi- og driftsappen.
Trinn 5-1 importerer elektroniske adresser til kundeengasjementsappen.
Trinn 5-2 oppretter .csv-filer for å oppdatere primæradresser for kontoer og kontakter i kundeengasjementsappen.
Trinn 6-1 til og med 6-2 importerer primæradresser for kontoer og kontakter til kundeengasjementsappen.
Feilsøking
Hvis prosessen mislykkes, kjører du datafabrikken på nytt. Start fra den mislykkede aktiviteten.
Enkelte filer som genereres av datafabrikken, kan brukes til datavalidering.
Datafabrikken kjøres basert på .csv-filer. Hvis det er en feltverdi som har komma, kan det derfor påvirke resultatene. Du må fjerne alle kommaer fra feltverdier.
Kategorien Overvåking inneholder informasjon om alle trinn og data som har blitt behandlet. Velg et bestemt trinn for å feilsøke det.
Finn ut mer om malen
Du finner mer informasjon om malen i Kommentarer for Viktig-filen for Azure Data Factory-malen.