Delen via

Gegevens kopiëren uit ServiceNow met behulp van Azure Data Factory of Synapse Analytics

  • Artikel

VAN TOEPASSING OP: Azure Data Factory Azure Synapse Analytics

Tip

Probeer Data Factory uit in Microsoft Fabric, een alles-in-één analyseoplossing voor ondernemingen. Microsoft Fabric omvat alles, van gegevensverplaatsing tot gegevenswetenschap, realtime analyses, business intelligence en rapportage. Meer informatie over het gratis starten van een nieuwe proefversie .

In dit artikel wordt beschreven hoe u de kopieeractiviteit in Azure Data Factory- en Synapse Analytics-pijplijnen gebruikt om gegevens van ServiceNow te kopiëren. Het is gebaseerd op het artikel over het overzicht van kopieeractiviteiten met een algemeen overzicht van de kopieeractiviteit.

Belangrijk

De nieuwe ServiceNow-connector biedt verbeterde systeemeigen ServiceNow-ondersteuning. Als u de verouderde ServiceNow-connector in uw oplossing gebruikt, wordt u aangeraden om uw ServiceNow-connector zo snel mogelijk bij te werken. Raadpleeg deze sectie voor meer informatie over het verschil tussen de verouderde en de nieuwste versie.

Ondersteunde mogelijkheden

Deze ServiceNow-connector wordt ondersteund voor de volgende mogelijkheden:

Ondersteunde mogelijkheden IR
Copy-activiteit (bron/-) (1) (2)
Activiteit Lookup (1) (2)

(1) Azure Integration Runtime (2) Zelf-hostende Integration Runtime

Zie de tabel Ondersteunde gegevensarchieven voor een lijst met gegevensarchieven die worden ondersteund als bronnen/sinks.

De service biedt een ingebouwd stuurprogramma om connectiviteit mogelijk te maken. Daarom hoeft u geen stuurprogramma handmatig te installeren met deze connector.

Gebruik de werkelijke waarde in plaats van de weergegeven waarde in ServiceNow.

Vereiste

Als u deze connector wilt gebruiken, moet u een rol hebben met ten minste leestoegang tot sys_db_object en sys_dictionary tabellen in ServiceNow.

Aan de slag

Als u de kopieeractiviteit wilt uitvoeren met een pijplijn, kunt u een van de volgende hulpprogramma's of SDK's gebruiken:

Een gekoppelde service maken voor ServiceNow met behulp van de gebruikersinterface

Gebruik de volgende stappen om een gekoppelde service te maken voor ServiceNow in de gebruikersinterface van Azure Portal.

  1. Blader naar het tabblad Beheren in uw Azure Data Factory- of Synapse-werkruimte en selecteer Gekoppelde services en klik vervolgens op Nieuw:

  2. Zoek naar ServiceNow en selecteer de ServiceNow-connector.

    Schermopname van de ServiceNow-connector.

  3. Configureer de servicedetails, test de verbinding en maak de nieuwe gekoppelde service.

    Schermopname van de configuratie van de gekoppelde service voor ServiceNow.

Configuratiedetails van connector

De volgende secties bevatten details over eigenschappen die worden gebruikt voor het definiëren van Data Factory-entiteiten die specifiek zijn voor de ServiceNow-connector.

Eigenschappen van gekoppelde service

De volgende eigenschappen worden ondersteund voor de gekoppelde ServiceNow-service:

Eigenschappen Beschrijving Vereist
type De typeeigenschap moet worden ingesteld op: ServiceNowV2 Ja
endpoint Het eindpunt van de ServiceNow-server (http://<instance>.service-now.com). Ja
authenticationType Het verificatietype dat moet worden gebruikt.
Toegestane waarden zijn: Basic, OAuth2		 Ja
gebruikersnaam De gebruikersnaam die wordt gebruikt om verbinding te maken met de ServiceNow-server voor Basic- en OAuth2-verificatie. Ja
password Het wachtwoord dat overeenkomt met de gebruikersnaam voor Basis- en OAuth2-verificatie. Markeer dit veld als SecureString om het veilig op te slaan of verwijs naar een geheim dat is opgeslagen in Azure Key Vault. Ja
clientId De client-id voor OAuth2-verificatie. Ja voor OAuth-verificatie
clientSecret Het clientgeheim voor OAuth2-verificatie. Markeer dit veld als SecureString om het veilig op te slaan of verwijs naar een geheim dat is opgeslagen in Azure Key Vault. Ja voor OAuth-verificatie
grantType Hiermee geeft u het type OAuth2.0-stroom op dat de client-app gebruikt voor het toegangstoken. De standaardwaarde is een wachtwoord. Ja voor OAuth-verificatie

Voorbeeld:

{
    "name": "ServiceNowLinkedService",
    "properties": {
        "type": "ServiceNowV2",
        "typeProperties": {
            "endpoint" : "http://<instance>.service-now.com",
            "authenticationType" : "Basic",
            "username" : "<username>",
            "password": {
                 "type": "SecureString",
                 "value": "<password>"
            }
        }
    }
}

Eigenschappen van gegevensset

Zie het artikel gegevenssets voor een volledige lijst met secties en eigenschappen die beschikbaar zijn voor het definiëren van gegevenssets . Deze sectie bevat een lijst met eigenschappen die worden ondersteund door de ServiceNow-gegevensset.

Als u gegevens van ServiceNow wilt kopiëren, stelt u de typeeigenschap van de gegevensset in op ServiceNowV2Object. De volgende eigenschappen worden ondersteund:

Eigenschappen Beschrijving Vereist
type De typeeigenschap van de gegevensset moet worden ingesteld op: ServiceNowV2Object Ja
tableName Naam van de tabel. Ja

Voorbeeld

{
    "name": "ServiceNowDataset",
    "properties": {
        "type": "ServiceNowV2Object",
        "typeProperties": {
            "tableName": "<table name>"
        },
        "schema": [],
        "linkedServiceName": {
            "referenceName": "<ServiceNow linked service name>",
            "type": "LinkedServiceReference"
        }
    }
}

Eigenschappen van de kopieeractiviteit

Zie het artikel Pijplijnen voor een volledige lijst met secties en eigenschappen die beschikbaar zijn voor het definiëren van activiteiten. Deze sectie bevat een lijst met eigenschappen die worden ondersteund door de ServiceNow-bron.

ServiceNow als bron

Als u gegevens van ServiceNow wilt kopiëren, stelt u het brontype in de kopieeractiviteit in op ServiceNowV2Source. De volgende eigenschappen worden ondersteund in de sectie bron van kopieeractiviteit:

Eigenschappen Beschrijving Vereist
type De typeeigenschap van de bron van de kopieeractiviteit moet worden ingesteld op: ServiceNowV2Source Ja
uitdrukking Gebruik de expressie om gegevens te lezen. U kunt de expressie configureren in de opbouwfunctie voor query's. Het heeft hetzelfde gebruik als de opbouwfunctie voor voorwaarden in ServiceNow. Zie dit artikel voor instructies over het gebruik ervan. Nee
Onder expression
type Het expressietype. Waarden kunnen Constant (standaard), Unaire, Binair en Veld zijn. Nee
waarde De constante waarde. Ja wanneer het expressietype Constant of Veld is
Exploitanten De operatorwaarde. Zie Operators die beschikbaar zijn voor keuzevelden met tekenreeksen in dit artikel voor meer informatie over operators. Ja wanneer het expressietype Unary of Binary is
Operands Lijst met expressies waarop de operator wordt toegepast. Ja wanneer het expressietype Unary of Binary is

Voorbeeld:

"activities": [
    {
        "name": "CopyFromServiceNow",
        "type": "Copy",
        "inputs": [
            {
                "referenceName": "<ServiceNow input dataset name>",
                "type": "DatasetReference"
            }
        ],
        "outputs": [
            {
                "referenceName": "<output dataset name>",
                "type": "DatasetReference"
            }
        ],
        "typeProperties": {
            "source": {
                "type": "ServiceNowV2Source",
                "expression": {
                    "type": "Nary",
                    "operators": [
                        "<"
                    ],
                    "operands": [
                        {
                            "type": "Field",
                            "value": "u_founded"
                        },
                        {
                            "type": "Constant",
                            "value": "2000"
                        }
                    ]
                }
            },
            "sink": {
                "type": "<sink type>"
            }
        }
    }
]

Eigenschappen van opzoekactiviteit

Als u meer wilt weten over de eigenschappen, controleert u de lookup-activiteit.

De ServiceNow-connector upgraden

Hier volgen de stappen die u helpen bij het upgraden van uw ServiceNow-connector:

  1. Maak een nieuwe gekoppelde service door te verwijzen naar de eigenschappen van de gekoppelde service.
  2. De query in de bron wordt bijgewerkt naar de opbouwfunctie voor query's, die hetzelfde gebruik heeft als de opbouwfunctie voor voorwaarden in ServiceNow. Leer hoe u deze configureert die verwijst naar ServiceNow als bron.

Verschillen tussen ServiceNow en ServiceNow (verouderd)

De ServiceNow-connector biedt nieuwe functionaliteiten en is compatibel met de meeste functies van de ServiceNow-connector (verouderd). In de onderstaande tabel ziet u de functieverschillen tussen ServiceNow en ServiceNow (verouderd).

ServiceNow ServiceNow (verouderd)
useEncryptedEndpoints, useHostVerification en usePeerVerification worden niet ondersteund in de gekoppelde service. Ondersteuning voor useEncryptedEndpoints, useHostVerification en usePeerVerification in de gekoppelde service.
Ondersteuning voor opbouwfunctie voor query's in de bron. Opbouwfunctie voor query's wordt niet ondersteund in de bron.
Query's op basis van SQL worden niet ondersteund. Ondersteuning voor query's op basis van SQL.
sortBy-query's worden niet ondersteund in de opbouwfunctie voor query's. Ondersteuning voor sortBy-query's in Query.
U kunt het schema in de gegevensset bekijken. U kunt het schema niet weergeven in de gegevensset.

Gerelateerde inhoud

Zie ondersteunde gegevensarchieven voor een lijst met gegevensarchieven die worden ondersteund als bronnen en sinks door de kopieeractiviteit.