Copier des données à partir de ServiceNow V2 à l’aide d’Azure Data Factory ou Synapse Analytics

S’APPLIQUE À : Azure Data Factory Azure Synapse Analytics

Cet article décrit comment utiliser l’activité de copie dans des pipelines Azure Data Factory et Azure Synapse Analytics pour copier des données à partir de ServiceNow. Il s’appuie sur l’article de vue d’ensemble de l’activité de copie qui présente une vue d’ensemble générale de l’activité de copie.

Fonctionnalités prises en charge

Ce connecteur ServiceNow est pris en charge pour les activités suivantes :

(1) Runtime d’intégration Azure (2) Runtime d’intégration auto-hébergé

Pour obtenir la liste des magasins de données pris en charge en tant que sources/récepteurs, consultez la table des magasins de données pris en charge .

Le service fournit un pilote intégré pour permettre la connectivité. Vous n'êtes donc pas tenu d'installer manuellement un pilote pour utiliser ce connecteur.

Prerequisite

Pour utiliser ce connecteur, vous devez avoir un rôle avec au moins un accès en lecture aux tables sys_db_object, sys_db_view et sys_dictionary dans ServiceNow.

Pour accéder aux vues dans ServiceNow, vous devez disposer d’un rôle avec au moins un accès en lecture aux tables sys_db_view_table et sys_db_view_table_field.

Mise en route

Pour effectuer l’activité de copie avec un pipeline, vous pouvez utiliser l’un des outils ou kits sdk suivants :

• Outil Copier des données
• portail Azure
• Kit de développement logiciel (SDK) .NET
• Kit de développement logiciel (SDK) Python
• Azure PowerShell
• REST API
• Modèle Azure Resource Manager

Créer un service lié à ServiceNow à l’aide de l’interface utilisateur

Utilisez les étapes suivantes pour créer un service lié à ServiceNow dans l’interface utilisateur du portail Azure.

1. Accédez à l’onglet Gérer dans votre espace de travail Azure Data Factory ou Synapse, sélectionnez Services liés, puis cliquez sur Nouveau :

   • Azure Data Factory.
   • Azure Synapse

   

2. Recherchez ServiceNow et sélectionnez le connecteur ServiceNow.

   

3. Configurez les informations du service, testez la connexion et créez le nouveau service lié.

   

Détails de configuration du connecteur

Les sections suivantes fournissent des informations sur les propriétés utilisées pour définir les entités Data Factory spécifiques du connecteur ServiceNow.

Propriétés du service lié

Les propriétés prises en charge pour le service lié ServiceNow sont les suivantes :

Example:

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

Propriétés du jeu de données

Pour obtenir la liste complète des sections et des propriétés disponibles pour définir des jeux de données, consultez l’article sur les jeux de données . Cette section fournit la liste des propriétés prises en charge par le jeu de données ServiceNow.

Pour copier des données à partir de ServiceNow, définissez la propriété de type du jeu de données sur ServiceNowV2Object. Les propriétés prises en charge sont les suivantes :

Example

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

Propriétés de l’activité de copie

Pour obtenir la liste complète des sections et des propriétés disponibles pour définir des activités, consultez l’article Pipelines . Cette section fournit la liste des propriétés prises en charge par la source ServiceNow.

ServiceNow en tant que source

Pour copier des données à partir de ServiceNow, définissez le type de source dans l’activité de copie sur ServiceNowV2Source. Les propriétés suivantes sont prises en charge dans la section source de l’activité de copie :

Example:

"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"
                        }
                    ]
                },
                "pageSize": 300
            },
            "sink": {
                "type": "<sink type>"
            }
        }
    }
]

Utilisation de paramètres d’expression

Vous pouvez configurer le paramètre d’expression dans le Générateur de requêtes en sélectionnant Ajouter du contenu dynamique. Le type de paramètre doit être Object et la valeur doit suivre le format indiqué dans l’exemple JSON ci-dessous :

 {
	"type": "Nary",
	"operators": [
		"="
	],
	"operands": [
		{
			"type": "Field",
			"value": "col"
		},
		{
			"type": "Constant",
			"value": "val"
		}
	]
}

Voici un exemple de la source JSON utilisant le paramètre d’expression :

"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": "Expression",
                    "value": "@pipeline().parameters.expressionParameter"
                }
            },
            "sink": {
                "type": "<sink type>"
            }
        }
    }
]

Propriétés de l’activité Lookup

Pour en savoir plus sur les propriétés, consultez l’activité de recherche.

Mettre à niveau le connecteur ServiceNow

Voici les étapes qui vous aideront à mettre à niveau votre connecteur ServiceNow :

1. Créez un service lié en faisant référence aux propriétés du service lié.
2. La requête dans la source est mise à niveau vers le générateur de requêtes, qui a la même utilisation que le générateur de conditions dans ServiceNow. Découvrez comment la configurer en faisant référence à ServiceNow en tant que source.

Différences entre ServiceNow V2 et V1

Le connecteur ServiceNow V2 offre de nouvelles fonctionnalités et est compatible avec la plupart des fonctionnalités du connecteur ServiceNow V1. Le tableau ci-dessous présente les différences de fonctionnalités entre V2 et V1.

Contenu connexe

Pour obtenir la liste des magasins de données pris en charge en tant que sources et récepteurs par l’activité de copie, consultez les magasins de données pris en charge.