Adatok másolása és átalakítása a Dynamics 365-ben (Microsoft Dataverse) vagy Dynamics CRM-ben az Azure Data Factory vagy az Azure Synapse Analytics használatával

A következőkre vonatkozik: Azure Data Factory Azure Synapse Analytics

Tipp.

Próbálja ki a Data Factoryt a Microsoft Fabricben, amely egy teljes körű elemzési megoldás a nagyvállalatok számára. A Microsoft Fabric az adattovábbítástól az adatelemzésig, a valós idejű elemzésig, az üzleti intelligenciáig és a jelentéskészítésig mindent lefed. Ismerje meg, hogyan indíthat új próbaverziót ingyenesen!

Ez a cikk bemutatja, hogyan használható másolási tevékenység az Azure Data Factoryben vagy a Synapse-folyamatokban adatok másolására a Dynamics 365-ből (Microsoft Dataverse) vagy a Dynamics CRM-be, és hogyan alakíthat át adatokat a Dynamics 365-ben (Microsoft Dataverse) vagy a Dynamics CRM-ben. További információkért olvassa el az Azure Data Factory és az Azure Synapse Analytics bevezető cikkeit.

Támogatott képességek

Ez az összekötő a következő tevékenységekhez támogatott:

Támogatott képességek	IR
Copy tevékenység (forrás/fogadó)	① ②
Adatfolyam leképezése (forrás/fogadó)	①
Keresési tevékenység	① ②

(1) Azure-integrációs modul (2) Saját üzemeltetésű integrációs modul

A másolási tevékenység által forrásként és fogadóként támogatott adattárak listáját a Támogatott adattárak táblában találja.

Megjegyzés:

2020 novemberében a Common Data Service át lett nevezve a Microsoft Dataverse-re. Ez a cikk a legújabb terminológiának megfelelően frissül.

Ez a Dynamics-összekötő támogatja a Dynamics 7–9-et online és helyszíni verziókhoz is. Pontosabban:

• A 7-es verzió a Dynamics CRM 2015-höz lesz megfeleltetve.
• A 8-as verzió a Dynamics CRM 2016-ra és a Dynamics 365 korai verziójára képez le.
• A 9-es verzió a Dynamics 365 későbbi verziójára képez le.

Tekintse meg a Dynamics-verziók és -termékek támogatott hitelesítési típusait és konfigurációit az alábbi táblázatban.

Dynamics-verziók	A hitelesítés típusai	Társított szolgáltatásminták
Dataverse Dynamics 365 online Dynamics CRM Online	Microsoft Entra szolgáltatásnév Office 365 Felhasználó által hozzárendelt felügyelt identitás	Dynamics online és Microsoft Entra szolgáltatásnév vagy Office 365-hitelesítés
Dynamics 365 helyszíni, internetes üzembe helyezéssel (IFD) Dynamics CRM 2016 helyszíni IFD-vel Dynamics CRM 2015 helyszíni IFD-vel	IFD	Dynamics helyszíni IFD és IFD hitelesítéssel

Megjegyzés:

A regionális felderítési szolgáltatás elavulása miatt a szolgáltatás az Office 365-hitelesítés használata során a globális felderítési szolgáltatás használatára vált.

Fontos

Ha a bérlő és a felhasználó feltételes hozzáféréshez és/vagy többtényezős hitelesítéshez van konfigurálva a Microsoft Entra-azonosítóban, nem fogja tudni használni az Office 365-hitelesítés típusát. Ilyen esetekben a Microsoft Entra szolgáltatásnév-hitelesítést kell használnia.

A Dynamics 365 esetében a következő alkalmazástípusok támogatottak:

• Dynamics 365 for Sales
• Dynamics 365 for Customer Service
• Dynamics 365 for Field Service
• Dynamics 365 for Project Service Automation
• Dynamics 365 for Marketing

Ez az összekötő nem támogatja az egyéb alkalmazástípusokat, például a Pénzügy, az Üzemeltetés és a Talent alkalmazást.

Tipp.

A Dynamics AX-összekötővel adatokat másolhat a Dynamics 365 Finance and Operations szolgáltatásból.

Ez a Dynamics-összekötő a Dynamics XRM-eszközökre épül.

Előfeltételek

Ha ezt az összekötőt a Microsoft Entra szolgáltatásnév-hitelesítéssel szeretné használni, be kell állítania a kiszolgálók közötti (S2S) hitelesítést a Dataverse-ben vagy a Dynamicsben. Először regisztrálja az alkalmazásfelhasználót (szolgáltatásnév) a Microsoft Entra-azonosítóban. Itt megtudhatja, hogyan teheti meg ezt. Az alkalmazásregisztráció során létre kell hoznia ezt a felhasználót a Dataverse-ben vagy a Dynamicsben, és engedélyeket kell adnia. Ezeket az engedélyeket közvetlenül vagy közvetve is meg lehet adni, ha hozzáadja az alkalmazás felhasználóját egy olyan csapathoz, amely engedélyt kapott a Dataverse-ben vagy a Dynamicsben. Itt talál további információt arról, hogyan állíthat be alkalmazásfelhasználót a Dataverse-hitelesítéshez.

Első lépések

A Copy tevékenység folyamattal való végrehajtásához használja az alábbi eszközök vagy SDK-k egyikét:

• Az Adatok másolása eszköz
• The Azure portal
• A .NET SDK
• A Python SDK
• Azure PowerShell
• A REST API
• Az Azure Resource Manager-sablon

Társított szolgáltatás létrehozása a Dynamics 365-höz (Microsoft Dataverse) vagy a Dynamics CRM-hez felhasználói felület használatával

Az alábbi lépésekkel létrehozhat egy társított szolgáltatást a Dynamics 365-höz az Azure Portal felhasználói felületén.

1. Keresse meg az Azure Data Factory vagy a Synapse-munkaterület Kezelés lapját, és válassza a Társított szolgáltatások lehetőséget, majd kattintson az Új gombra:

   Azure Data Factory

   

   Azure Synapse

   

2. Keresse meg a Dynamics-t vagy a Dataverse-t, és válassza a Dynamics 365 (Microsoft Dataverse) vagy a Dynamics CRM-összekötőt.

   

   

3. Konfigurálja a szolgáltatás részleteit, tesztelje a kapcsolatot, és hozza létre az új társított szolgáltatást.

   

Csatlakozás or konfigurációjának részletei

A következő szakaszok a Dynamics-specifikus entitások meghatározásához használt tulajdonságok részleteit ismertetik.

Társított szolgáltatás tulajdonságai

A Dynamics társított szolgáltatás esetében az alábbi tulajdonságok támogatottak.

Dynamics 365 és Dynamics CRM online

Property	Leírás	Required
típus	A típustulajdonságot a "Dynamics", a "DynamicsCrm" vagy a "CommonDataServiceForApps" értékre kell állítani.	Igen
deploymentType	A Dynamics-példány üzembehelyezési típusa. Az értéknek online állapotúnak kell lennie a Dynamics Online-hoz.	Igen
serviceUri	A Dynamics-példány szolgáltatási URL-címe, ugyanaz, amit a böngészőből ér el. Ilyen például a "https://< organization-name.crm>[x].dynamics.com".	Igen
authenticationType	A Dynamics-kiszolgálóhoz való csatlakozás hitelesítési típusa. Az érvényes értékek a következők: "AADServicePrincipal", "Office365" és "ManagedIdentity".	Igen
servicePrincipalId	A Microsoft Entra-alkalmazás ügyfélazonosítója.	Igen, ha a hitelesítés "AADServicePrincipal"
servicePrincipalCredentialType	A szolgáltatásnév-hitelesítéshez használandó hitelesítőadat-típus. Az érvényes értékek a "ServicePrincipalKey" és a "ServicePrincipalCert". Megjegyzés: A ServicePrincipalKey használata ajánlott. A ServicePrincipalCert hitelesítő adatok típusának ismert korlátozásai miatt előfordulhat, hogy a szolgáltatás átmeneti problémát tapasztal a titkos kulcs kulcstartóból való lekérésének sikertelenségével kapcsolatban.	Igen, ha a hitelesítés "AADServicePrincipal"
servicePrincipalCredential	A szolgáltatásnév hitelesítő adatai. Ha a "ServicePrincipalKey" azonosítót használja hitelesítő adattípusként, servicePrincipalCredential a szolgáltatás a társított szolgáltatás üzembe helyezésekor titkosítja a sztringet. Vagy hivatkozhat egy titkos kódra az Azure Key Vaultban. Ha a "ServicePrincipalCert" azonosítót használja hitelesítő adatként, servicePrincipalCredential az Azure Key Vault egyik tanúsítványára kell hivatkoznia, és győződjön meg arról, hogy a tanúsítvány tartalomtípusa pKCS #12.	Igen, ha a hitelesítés "AADServicePrincipal"
username	A Dynamicshez való csatlakozáshoz használt felhasználónév.	Igen, ha a hitelesítés "Office365"
jelszó	A felhasználónévként megadott felhasználói fiók jelszava. Jelölje meg ezt a mezőt a "SecureString" jellel, hogy biztonságosan tárolja, vagy hivatkozzon az Azure Key Vaultban tárolt titkos kódra.	Igen, ha a hitelesítés "Office365"
hitelesítő adatok	Adja meg a felhasználó által hozzárendelt felügyelt identitást hitelesítő objektumként. Hozzon létre egy vagy több felhasználó által hozzárendelt felügyelt identitást, rendelje őket az adat-előállítóhoz, és hozzon létre hitelesítő adatokat minden felhasználó által hozzárendelt felügyelt identitáshoz.	Igen, ha a hitelesítés "ManagedIdentity"
connectVia	Az adattárhoz való csatlakozáshoz használandó integrációs modul . Ha nincs megadva érték, a tulajdonság az alapértelmezett Azure-integrációs modult használja.	Nem

Megjegyzés:

A Dynamics-összekötő korábban az opcionális organizationName tulajdonságot használta a Dynamics CRM vagy a Dynamics 365 online példány azonosításához. Bár ez a tulajdonság továbbra is működik, javasoljuk, hogy inkább az új serviceUri tulajdonságot adja meg, hogy jobb teljesítményt nyújtson a példányfelderítéshez.

Példa: Dynamics online a Microsoft Entra szolgáltatásnévvel és kulcshitelesítéssel

{  
    "name": "DynamicsLinkedService",  
    "properties": {  
        "type": "Dynamics",  
        "typeProperties": {  
            "deploymentType": "Online",  
            "serviceUri": "https://<organization-name>.crm[x].dynamics.com",  
            "authenticationType": "AADServicePrincipal",  
            "servicePrincipalId": "<service principal id>",  
            "servicePrincipalCredentialType": "ServicePrincipalKey",  
            "servicePrincipalCredential": "<service principal key>"
        },  
        "connectVia": {  
            "referenceName": "<name of Integration Runtime>",  
            "type": "IntegrationRuntimeReference"  
        }  
    }  
}  

Példa: Dynamics online a Microsoft Entra szolgáltatásnévvel és tanúsítványhitelesítéssel

{ 
    "name": "DynamicsLinkedService", 
    "properties": { 
        "type": "Dynamics", 
        "typeProperties": { 
            "deploymentType": "Online", 
            "serviceUri": "https://<organization-name>.crm[x].dynamics.com", 
            "authenticationType": "AADServicePrincipal", 
            "servicePrincipalId": "<service principal id>", 
            "servicePrincipalCredentialType": "ServicePrincipalCert", 
            "servicePrincipalCredential": { 
                "type": "AzureKeyVaultSecret", 
                "store": { 
                    "referenceName": "<AKV reference>", 
                    "type": "LinkedServiceReference" 
                }, 
                "secretName": "<certificate name in AKV>" 
            } 
        }, 
        "connectVia": { 
            "referenceName": "<name of Integration Runtime>", 
            "type": "IntegrationRuntimeReference" 
        } 
    } 
} 

Példa: Dynamics online office 365-hitelesítéssel

{
    "name": "DynamicsLinkedService",
    "properties": {
        "type": "Dynamics",
        "typeProperties": {
            "deploymentType": "Online",
            "serviceUri": "https://<organization-name>.crm[x].dynamics.com",
            "authenticationType": "Office365",
            "username": "test@contoso.onmicrosoft.com",
            "password": {
                "type": "SecureString",
                "value": "<password>"
            }
        },
        "connectVia": {
            "referenceName": "<name of Integration Runtime>",
            "type": "IntegrationRuntimeReference"
        }
    }
}

Példa: Dynamics online felhasználó által hozzárendelt felügyelt identitáshitelesítés használatával

{
    "name": "DynamicsLinkedService",
    "properties": {
        "type": "Dynamics",
        "typeProperties": {
            "deploymentType": "Online",
            "serviceUri": "https://<organization-name>.crm[x].dynamics.com",
            "authenticationType": "ManagedIdentity",
            "credential": {
                "referenceName": "credential1",
                "type": "CredentialReference"
            }
        },
        "connectVia": {
            "referenceName": "<name of Integration Runtime>",
            "type": "IntegrationRuntimeReference"
        }
    }
}

Dynamics 365 és Dynamics CRM helyszíni IFD-vel

A Dynamics Online-hoz hasonló további tulajdonságok a hostName és a port.

Property	Leírás	Required
típus	A típustulajdonságot a "Dynamics", a "DynamicsCrm" vagy a "CommonDataServiceForApps" értékre kell állítani.	Igen.
deploymentType	A Dynamics-példány üzembehelyezési típusa. Az értéknek "OnPremisesWithIfd" értékűnek kell lennie a helyszíni Dynamics esetében az IFD-vel.	Igen.
Hostname	A helyszíni Dynamics-kiszolgáló gazdagépneve.	Igen.
kikötő	A helyszíni Dynamics-kiszolgáló portja.	Nem. Az alapértelmezett érték 443.
organizationName	A Dynamics-példány szervezeti neve.	Igen.
authenticationType	A Dynamics-kiszolgálóhoz való csatlakozás hitelesítési típusa. Adja meg az IFD-vel rendelkező helyszíni Dynamics "Ifd" (Had) értéket.	Igen.
username	A Dynamicshez való csatlakozáshoz használt felhasználónév.	Igen.
jelszó	A felhasználónévhez megadott felhasználói fiók jelszava. Ezt a mezőt a "SecureString" jellel jelölheti meg, hogy biztonságosan tárolja. Vagy tárolhat egy jelszót a Key Vaultban, és onnan is lekérheti a másolási tevékenységet, amikor adatmásolást végez. További információ a Key Vaultban tárolt hitelesítő adatokról.	Igen.
connectVia	Az adattárhoz való csatlakozáshoz használandó integrációs modul . Ha nincs megadva érték, a tulajdonság az alapértelmezett Azure-integrációs modult használja.	Nem

Példa: Dynamics helyszíni IFD-vel IFD-hitelesítéssel

{
    "name": "DynamicsLinkedService",
    "properties": {
        "type": "Dynamics",
        "description": "Dynamics on-premises with IFD linked service using IFD authentication",
        "typeProperties": {
            "deploymentType": "OnPremisesWithIFD",
            "hostName": "contosodynamicsserver.contoso.com",
            "port": 443,
            "organizationName": "admsDynamicsTest",
            "authenticationType": "Ifd",
            "username": "test@contoso.onmicrosoft.com",
            "password": {
                "type": "SecureString",
                "value": "<password>"
            }
        },
        "connectVia": {
            "referenceName": "<name of Integration Runtime>",
            "type": "IntegrationRuntimeReference"
        }
    }
}

Adathalmaz tulajdonságai

Az adathalmazok meghatározásához elérhető szakaszok és tulajdonságok teljes listáját az Adathalmazok című cikkben találja. Ez a szakasz a Dynamics-adatkészlet által támogatott tulajdonságok listáját tartalmazza.

Ha adatokat szeretne másolni a Dynamicsből és a Dynamicsbe, az alábbi tulajdonságok támogatottak:

Property	Leírás	Required
típus	Az adathalmaz típustulajdonságának "DynamicsEntity", "DynamicsCrmEntity" vagy "CommonDataServiceForAppsEntity" értékre kell állítania.	Igen
entityName	A lekérni kívánt entitás logikai neve.	Nem a forráshoz, ha a tevékenység forrása "lekérdezésként" van megadva, és igen a fogadó esetében

Példa

{
    "name": "DynamicsDataset",
    "properties": {
        "type": "DynamicsEntity",
        "schema": [],
        "typeProperties": {
            "entityName": "account"
        },
        "linkedServiceName": {
            "referenceName": "<Dynamics linked service name>",
            "type": "linkedservicereference"
        }
    }
}

Másolási tevékenység tulajdonságai

A tevékenységek meghatározásához elérhető szakaszok és tulajdonságok teljes listáját a Folyamatok című cikkben találja. Ez a szakasz a Dynamics-forrás- és fogadótípusok által támogatott tulajdonságok listáját tartalmazza.

Dynamics mint forrástípus

Ha adatokat szeretne másolni a Dynamicsből, a másolási tevékenység forrás szakasza a következő tulajdonságokat támogatja:

Property	Leírás	Required
típus	A másolási tevékenység forrásának típustulajdonságát a "DynamicsSource", a "DynamicsCrmSource" vagy a "CommonDataServiceForAppsSource" értékre kell állítani.	Igen
Lekérdezés	A FetchXML egy saját fejlesztésű lekérdezési nyelv, amelyet a Dynamics Online és a helyszíni Dynamics használ. Tekintse meg a következő példát. További információ: Lekérdezések létrehozása a FetchXML használatával.	Nem, ha entityName az adathalmazban meg van adva

Megjegyzés:

A PK oszlop mindig ki lesz másolva, még akkor is, ha a FetchXML lekérdezésben konfigurált oszlopvetület nem tartalmazza.

Fontos

• Ha adatokat másol a Dynamicsből, az explicit oszlopleképezés a Dynamicsből a fogadóba nem kötelező. De erősen ajánljuk a leképezést a determinisztikus másolási eredmény biztosításához.
• Amikor a szolgáltatás egy sémát importál a szerzői felhasználói felületen, az a sémára következtet. Ezt úgy teszi, hogy a Dynamics-lekérdezés eredményéből mintavételezi a felső sorokat a forrásoszlopok listájának inicializálásához. Ebben az esetben a felső sorokban értékeket nem tartalmazó oszlopok kimaradnak. Ugyanez a viselkedés vonatkozik az adatelőnézetre és a másolási végrehajtásra is, ha nincs explicit leképezés. Áttekintheti és hozzáadhat további oszlopokat a leképezéshez, amelyek a másolási futtatókörnyezet során teljesülnek.

Példa

"activities":[
    {
        "name": "CopyFromDynamics",
        "type": "Copy",
        "inputs": [
            {
                "referenceName": "<Dynamics input dataset>",
                "type": "DatasetReference"
            }
        ],
        "outputs": [
            {
                "referenceName": "<output dataset>",
                "type": "DatasetReference"
            }
        ],
        "typeProperties": {
            "source": {
                "type": "DynamicsSource",
                "query": "<FetchXML Query>"
            },
            "sink": {
                "type": "<sink type>"
            }
        }
    }
]

Minta FetchXML-lekérdezés

<fetch>
  <entity name="account">
    <attribute name="accountid" />
    <attribute name="name" />
    <attribute name="marketingonly" />
    <attribute name="modifiedon" />
    <order attribute="modifiedon" descending="false" />
    <filter type="and">
      <condition attribute ="modifiedon" operator="between">
        <value>2017-03-10 18:40:00z</value>
        <value>2017-03-12 20:40:00z</value>
      </condition>
    </filter>
  </entity>
</fetch>

Dynamics mint fogadótípus

Ha adatokat szeretne átmásolni a Dynamicsbe, a másolási tevékenység fogadó szakasza a következő tulajdonságokat támogatja:

Property	Leírás	Required
típus	A másolási tevékenység fogadójának típustulajdonságát a "DynamicsSink", a "DynamicsCrmSink" vagy a "CommonDataServiceForAppsSink" értékre kell állítani.	Igen.
writeBehavior	A művelet írási viselkedése. Az értéknek "Upsert" értékűnek kell lennie.	Igen
alternateKeyName	Az entitáson egy upserthez definiált másodlagos kulcsnév.	Nem.
writeBatchSize	A Dynamicsbe írt adatok sorszáma az egyes kötegekben.	Nem. Az alapértelmezett érték 10.
ignoreNullValues	Az írási művelet során figyelmen kívül hagyja-e a kulcsmezőktől eltérő bemeneti adatok null értékeit. Az érvényes értékek IGAZ és FAL Standard kiadás: IGAZ: Az upsert vagy a frissítési művelet végrehajtásakor hagyja változatlanul a célobjektumban lévő adatokat. Beszúráskor beszúrhat egy megadott alapértelmezett értéket. FAL Standard kiadás: Frissítse a célobjektumban lévő adatokat null értékre, amikor upsert vagy update műveletet hajt végre. Null érték beszúrása beszúráskor.	Nem. Az alapértelmezett érték a FAL Standard kiadás.
maxConcurrent Csatlakozás ions	Az adattárhoz a tevékenység futtatása során létrehozott egyidejű kapcsolatok felső korlátja. Csak akkor adjon meg értéket, ha korlátozni szeretné az egyidejű kapcsolatokat.	Nem

Megjegyzés:

A fogadó writeBatchSize és a párhuzamos másolási tevékenység alapértelmezett értéke a Dynamics-fogadó példányai esetében 10. Ezért a rendszer alapértelmezés szerint 100 rekordot küld el egyszerre a Dynamicsnek.

A Dynamics 365 online verziójában szervezetenként legfeljebb 52 egyidejű köteghívás érhető el. Ha túllépi ezt a korlátot, a rendszer az első kérés futtatása előtt "Kiszolgáló foglalt" kivételt ad ki. Tartsa a writeBatchSize 10-nél vagy annál kisebbnél, hogy elkerülje az egyidejű hívások ilyen szabályozását.

A writeBatchSize és a párhuzamos másolatok optimális kombinációja az entitás sémájától függ. A sémaelemek közé tartoznak az oszlopok, a sorok mérete és a hívásokhoz csatlakoztatott beépülő modulok, munkafolyamatok vagy munkafolyamat-tevékenységek száma. A Dynamics szolgáltatás szerint a writeBatchSize (10) × párhuzamos példányok (10) alapértelmezett beállítása a javaslat. Ez az érték a Legtöbb Dynamics-entitás esetében működik, bár lehet, hogy nem a legjobb teljesítményt nyújtja. A teljesítményt a másolási tevékenység beállításaiban lévő kombináció módosításával hangolhatja.

Példa

"activities":[
    {
        "name": "CopyToDynamics",
        "type": "Copy",
        "inputs": [
            {
                "referenceName": "<input dataset>",
                "type": "DatasetReference"
            }
        ],
        "outputs": [
            {
                "referenceName": "<Dynamics output dataset>",
                "type": "DatasetReference"
            }
        ],
        "typeProperties": {
            "source": {
                "type": "<source type>"
            },
            "sink": {
                "type": "DynamicsSink",
                "writeBehavior": "Upsert",
                "writeBatchSize": 10,
                "ignoreNullValues": true
            }
        }
    }
]

Adatok lekérése nézetekből

Ha adatokat szeretne lekérni a Dynamics-nézetekből, le kell kérnie a nézet mentett lekérdezését, és a lekérdezés használatával le kell kérnie az adatokat.

Két entitás tárolja a különböző típusú nézeteket: a "mentett lekérdezés" tárolja a rendszernézetet, a "felhasználói lekérdezés" pedig a felhasználói nézetet. A nézetek információinak lekéréséhez tekintse meg a következő FetchXML-lekérdezést, és cserélje le a "TARGETENTITY" kifejezést a következőre savedquery : vagy userquery. Minden entitástípus több elérhető attribútummal rendelkezik, amelyeket igény szerint hozzáadhat a lekérdezéshez. További információ a mentett lekérdezési entitásról és a userquery entitásról.

<fetch top="5000" >
  <entity name="<TARGETENTITY>">
    <attribute name="name" />
    <attribute name="fetchxml" />
    <attribute name="returnedtypecode" />
    <attribute name="querytype" />
  </entity>
</fetch>

Szűrőket is hozzáadhat a nézetek szűréséhez. Adja hozzá például a következő szűrőt, hogy lekérjen egy "Saját aktív fiókok" nevű nézetet a fiók entitásában.

<filter type="and" >
    <condition attribute="returnedtypecode" operator="eq" value="1" />
    <condition attribute="name" operator="eq" value="My Active Accounts" />
</filter>

Adattípus-leképezés a Dynamicshez

Amikor adatokat másol a Dynamicsből, az alábbi táblázat a Dynamics-adattípusok és a szolgáltatás köztes adattípusai közötti leképezéseket mutatja be. Ha meg szeretné tudni, hogy egy másolási tevékenység hogyan képez le egy forrássémát, és hogyan képez le egy adattípust egy fogadóra, tekintse meg a séma- és adattípus-leképezéseket.

Konfigurálja a megfelelő köztes adattípust a forrás Dynamics-adattípuson alapuló adathalmaz-struktúrában a következő leképezési táblázat használatával:

Dynamics-adattípus	Köztes szolgáltatás adattípusa	Forrásként támogatott	Fogadóként támogatott
AttributeTypeCode.BigInt	Long	✓	✓
AttributeTypeCode.Boolean	Logikai	✓	✓
AttributeType.Customer	GUID	✓	✓ (Lásd az útmutatót)
AttributeType.DateTime	Datetime	✓	✓
AttributeType.Decimális	Decimális	✓	✓
AttributeType.Double	Dupla	✓	✓
AttributeType.EntityName	Sztring	✓	✓
AttributeType.Integer	Int32	✓	✓
AttributeType.Lookup	GUID	✓	✓ (Lásd az útmutatót)
AttributeType.ManagedProperty	Logikai	✓
AttributeType.Memo	Sztring	✓	✓
AttributeType.Money	Decimális	✓	✓
AttributeType.Owner	GUID	✓	✓ (Lásd az útmutatót)
AttributeType.Picklist	Int32	✓	✓
AttributeType.Uniqueidentifier	GUID	✓	✓
AttributeType.String	Sztring	✓	✓
AttributeType.State	Int32	✓	✓
AttributeType.Status	Int32	✓	✓

Megjegyzés:

A Dynamics AttribútumType.CalendarRules, AttributeType.MultiSelectPicklist és AttributeType.PartyList adattípusai nem támogatottak.

Adatok írása keresőmezőbe

Ha adatokat szeretne írni egy olyan keresőmezőbe, amelynek több célja van, például az ügyfél és a tulajdonos, kövesse az alábbi útmutatást és példát:

1. Adja meg, hogy a forrás tartalmazza a mező értékét és a cél entitás nevét is.

   • Ha az összes rekord ugyanarra a cél entitásra van megfeleltetve, győződjön meg az alábbi feltételek egyikéről:
     • A forrásadatoknak van egy oszlopa, amely a cél entitás nevét tárolja.
     • Hozzáadott egy további oszlopot a másolási tevékenység forrásához a cél entitás definiálásához.
   • Ha a különböző rekordok különböző célentitásokra vannak leképezve, győződjön meg arról, hogy a forrásadatok olyan oszlopot tartalmaznak, amely a megfelelő cél entitásnevet tárolja.

2. Az érték- és entitáshivatkozási oszlopok leképezése forrásról fogadóra. Az entitáshivatkozási oszlopot egy speciális elnevezési mintával {lookup_field_name}@EntityReferencerendelkező virtuális oszlophoz kell hozzárendelni. Az oszlop valójában nem létezik a Dynamicsben. Ez azt jelzi, hogy ez az oszlop az adott többtargetes keresőmező metaadatoszlopa.

Tegyük fel például, hogy a forrásnak két oszlopa van:

• A Guid típusú CustomerField oszlop, amely a Dynamics célentitásának elsődleges kulcsértéke.
• Sztring típusú céloszlop, amely a cél entitás logikai neve.

Tegyük fel, hogy ezeket az adatokat az Ügyfél típusú Fogadó Dynamics entitásmezőbe szeretné másolni.

A másolási tevékenység oszlopleképezésében a két oszlop megfeleltetése az alábbiak szerint történik:

• CustomerField és CustomerField között. Ez a leképezés a normál mezőleképezés.
• Cél a CustomerField@EntityReference. A fogadó oszlop egy virtuális oszlop, amely az entitáshivatkozást jelöli. Adja meg az ilyen mezőneveket egy leképezésben, mivel a sémák importálásával nem jelennek meg.

Ha az összes forrásrekord ugyanarra a célentitására van megfeleltetve, és a forrásadatok nem tartalmazzák a cél entitás nevét, íme egy parancsikon: a másolási tevékenység forrásában adjon hozzá egy további oszlopot. Nevezze el az új oszlopot a mintával {lookup_field_name}@EntityReference, állítsa az értéket a cél entitás nevére, majd folytassa az oszlopleképezést a szokásos módon. Ha a forrás- és fogadóoszlopok neve megegyezik, kihagyhatja az explicit oszlopleképezést is, mivel a másolási tevékenység alapértelmezés szerint név szerint leképezi az oszlopokat.

Adatok írása keresőmezőbe alternatív kulcsokkal

Ha alternatív kulcsoszlopokkal szeretne adatokat írni egy keresőmezőbe, kövesse az alábbi útmutatást és példát:

1. Győződjön meg arról, hogy a forrás tartalmazza a keresési kulcs összes oszlopát.

2. A másodlagos kulcsoszlopokat a speciális elnevezési mintával {lookup_field_name}@{alternate_key_column_name}kell hozzárendelni az oszlophoz. Az oszlop nem létezik a Dynamicsben. Ez azt jelzi, hogy ez az oszlop a cél entitás rekordjának keresésére szolgál.

3. Lépjen a Leképezés lapra a leképezési adatfolyamok fogadóátalakításában. Válassza ki a másodlagos kulcsot kimeneti oszlopként a Keresés mező alatt. A másodlagos kulcs kulcsoszlopait jelző érték.

   

4. A kijelölést követően a másodlagos kulcsoszlopok automatikusan megjelennek az alábbiakban.

   

5. A bal oldali bemeneti oszlopokat a kimeneti oszlopokkal képezheti le.

   

Megjegyzés:

Ez jelenleg csak akkor támogatott, ha beágyazott módot használ a leképezési adatfolyamok fogadóátalakításában.

Adatfolyam-tulajdonságok leképezése

A leképezési adatfolyam adatainak átalakításakor a Dynamicsben olvashat és írhat táblákba. További információkért tekintse meg a forrásátalakítást és a fogadóátalakítást a leképezési adatfolyamokban. Választhat, hogy dynamics-adatkészletet vagy beágyazott adatkészletet használ forrás- és fogadótípusként.

Forrásátalakítás

Az alábbi táblázat a Dynamics által támogatott tulajdonságokat sorolja fel. Ezeket a tulajdonságokat a Forrás beállításai lapon szerkesztheti.

Name	Leírás	Required	Megengedett értékek	Adatfolyam-szkript tulajdonság
Entitásnév	A lekérni kívánt entitás logikai neve.	Igen, ha beágyazott adatkészletet használ	-	(csak beágyazott adathalmaz esetén) Entitás
Query	A FetchXML egy saját fejlesztésű lekérdezési nyelv, amelyet a Dynamics Online és a helyszíni Dynamics használ. Tekintse meg a következő példát. További információ: Lekérdezések létrehozása a FetchXML használatával.	Nem	Sztring	Lekérdezés

Megjegyzés:

Ha bemeneti típusként a Lekérdezés lehetőséget választja, a táblákból származó oszloptípus nem kérhető le. Alapértelmezés szerint sztringként lesz kezelve.

Példa Dynamics-forrásszkriptre

Ha a Dynamics-adatkészletet használja forrástípusként, a társított adatfolyam-szkript a következő:

source(allowSchemaDrift: true,
	validateSchema: false,
	query: '<fetch mapping='logical' count='3 paging-cookie=''><entity name='new_dataflow_crud_test'><attribute name='new_name'/><attribute name='new_releasedate'/></entity></fetch>') ~> DynamicsSource

Beágyazott adatkészlet használata esetén a társított adatfolyam-szkript a következő:

source(allowSchemaDrift: true,
	validateSchema: false,
	store: 'dynamics',
	format: 'dynamicsformat',
	entity: 'Entity1',
	query: '<fetch mapping='logical' count='3 paging-cookie=''><entity name='new_dataflow_crud_test'><attribute name='new_name'/><attribute name='new_releasedate'/></entity></fetch>') ~> DynamicsSource

Fogadó átalakítása

Az alábbi táblázat a Dynamics sink által támogatott tulajdonságokat sorolja fel. Ezeket a tulajdonságokat a Fogadó beállításai lapon szerkesztheti.

Name	Leírás	Required	Megengedett értékek	Adatfolyam-szkript tulajdonság
Másodlagos kulcs neve	Az entitáson egy frissítéshez, frissítéshez vagy törléshez definiált másodlagos kulcsnév.	Nem	-	alternateKeyName
Frissítési módszer	Adja meg, hogy milyen műveletek engedélyezettek az adatbázis célhelyén. Az alapértelmezett beállítás csak a beszúrások engedélyezése. A sorok frissítéséhez, frissítéséhez vagy törléséhez a sorok címkézéséhez alter sorátalakítás szükséges.	Igen	true vagy false	beszúrható Frissíthető upsertable törölhető
Entitásnév	Az írandó entitás logikai neve.	Igen, ha beágyazott adatkészletet használ	-	(csak beágyazott adathalmaz esetén) Entitás

Példa a Dynamics fogadószkriptre

Ha a Dynamics-adatkészletet fogadótípusként használja, a társított adatfolyam-szkript a következő:

IncomingStream sink(allowSchemaDrift: true,
    validateSchema: false,
    deletable:true,
    insertable:true,
    updateable:true,
    upsertable:true,
    skipDuplicateMapInputs: true,
    skipDuplicateMapOutputs: true) ~> DynamicsSink

Beágyazott adatkészlet használata esetén a társított adatfolyam-szkript a következő:

IncomingStream sink(allowSchemaDrift: true,
    validateSchema: false,
    store: 'dynamics',
    format: 'dynamicsformat',
    entity: 'Entity1',
    deletable: true,
    insertable: true,
    updateable: true,
    upsertable: true,
    skipDuplicateMapInputs: true,
    skipDuplicateMapOutputs: true) ~> DynamicsSink

Keresési tevékenység tulajdonságai

A tulajdonságok részleteinek megismeréséhez tekintse meg a Keresési tevékenység című témakört.

Kapcsolódó tartalom

A támogatott adattárak listáját forrásként és fogadóként tárolja a másolási tevékenység, lásd: Támogatott adattárak.