Compartir a través de

Copia de datos de ServiceNow V2 con Azure Data Factory o Synapse Analytics

SE APLICA A: Azure Data Factory Azure Synapse Analytics

Tip

Pruebe Data Factory en Microsoft Fabric, una solución de análisis todo en uno para empresas. Microsoft Fabric abarca todo, desde el movimiento de datos hasta la ciencia de datos, el análisis en tiempo real, la inteligencia empresarial y los informes. Aprenda a iniciar una nueva evaluación gratuita.

En este artículo se resume el uso de la actividad de copia en canalizaciones de Azure Data Factory y Synapse Analytics para copiar datos de ServiceNow. Se basa en el artículo de información general sobre la actividad de copia que presenta una introducción general a la actividad de copia.

Important

El conector de ServiceNow V1 está en la fase de retirada. Se recomienda actualizar el conector de ServiceNow de V1 a V2.

Capacidades compatibles

Este conector ServiceNow es compatible con las funcionalidades siguientes:

Capacidades compatibles IR
Actividad de copia (origen/-) 1 2
Actividad de búsqueda 1 2

(1) Entorno de ejecución de integración de Azure (2) Entorno de ejecución de integración autohospedado

Para obtener una lista de los almacenes de datos que se admiten como orígenes o receptores, consulte la tabla Almacenes de datos admitidos .

El servicio proporciona un controlador integrado para permitir la conectividad. Por lo tanto, no es necesario instalar manualmente ningún controlador con este conector.

Prerequisite

Para usar este conector, debe tener un rol con al menos acceso de lectura a las tablas de sys_db_object, sys_db_view y sys_dictionary en ServiceNow.

Para acceder a las vistas de ServiceNow, debe tener un rol con al menos acceso de lectura a las tablas de sys_db_view_table y sys_db_view_table_field.

Cómo empezar

Para realizar la actividad de copia con una canalización, puede usar una de los siguientes herramientas o SDK:

Creación de un servicio vinculado a ServiceNow mediante la interfaz de usuario

Siga estos pasos para crear un servicio vinculado a ServiceNow en la interfaz de usuario de Azure Portal.

  1. Vaya a la pestaña "Administrar" de su área de trabajo de Azure Data Factory o Synapse y seleccione "Servicios vinculados"; a continuación, haga clic en "Nuevo":

  2. Busque ServiceNow y seleccione el conector de ServiceNow.

    Captura de pantalla del conector de ServiceNow.

  3. Configure los detalles del servicio, pruebe la conexión y cree el servicio vinculado.

    Captura de pantalla de la configuración del servicio vinculado para ServiceNow.

Detalles de configuración del conector

En las secciones siguientes se proporcionan detalles sobre las propiedades que se usan para definir entidades de Data Factory específicas para el conector de ServiceNow.

Propiedades del servicio vinculado

Las siguientes propiedades son compatibles con el servicio vinculado de ServiceNow:

Property Description Required
type La propiedad type debe establecerse en: ServiceNowV2 Yes
endpoint El punto de conexión del servidor de ServiceNow (http://<instance>.service-now.com). Yes
authenticationType Tipo de autenticación que se debe usar.
Los valores permitidos son: Basic, OAuth2		 Yes
username Nombre de usuario utilizado para conectarse al servidor de ServiceNow para la autenticación Basic y OAuth2. Yes
password Contraseña correspondiente al nombre de usuario para la autenticación Basic y OAuth2. Marque este campo como SecureString para almacenarlo de forma segura o hacer referencia a un secreto almacenado en Azure Key Vault. Yes
clientId Id. de cliente para la autenticación OAuth2. Sí para la autenticación de OAuth
clientSecret Secreto de cliente para la autenticación OAuth2. Marque este campo como SecureString para almacenarlo de forma segura o hacer referencia a un secreto almacenado en Azure Key Vault. Sí para la autenticación de OAuth
grantType Especifica el tipo de flujo de OAuth2.0 que usa la aplicación cliente para acceder al token. El valor predeterminado es la contraseña. Sí para la autenticación de OAuth

Example:

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

Propiedades del conjunto de datos

Para obtener una lista completa de las secciones y propiedades disponibles para definir conjuntos de datos, consulte el artículo conjuntos de datos . En esta sección se proporciona una lista de las propiedades compatibles con el conjunto de datos de ServiceNow.

Para copiar datos de ServiceNow, establezca la propiedad type del conjunto de datos en ServiceNowV2Object. Se admiten las siguientes propiedades:

Property Description Required
type La propiedad type del conjunto de datos debe establecerse en: ServiceNowV2Object Yes
tableName Nombre de la tabla. Yes
valueType Tipo de valores de tabla de ServiceNow. El valor de esta propiedad puede ser display o actual (valor predeterminado). Puede interpretarlo como si el parámetro sysparm_display_value fuera verdadero o falso al llamar a las API REST de ServiceNow. No

Example

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

Propiedades de la actividad de copia

Para obtener una lista completa de las secciones y propiedades disponibles para definir actividades, consulte el artículo Canalizaciones . En esta sección se proporciona una lista de las propiedades compatibles con el origen de ServiceNow.

ServiceNow como origen

Para copiar datos de ServiceNow, establezca el tipo de origen de la actividad de copia en ServiceNowV2Source. Las siguientes propiedades están respaldadas en la sección origen de la actividad de copia:

Property Description Required
type La propiedad type del origen de la actividad de copia debe establecerse en: ServiceNowV2Source Yes
expression Utiliza la expresión para leer datos. Puede configurar la expresión en el Generador de consultas. Tiene el mismo uso que el generador de condiciones en ServiceNow. Para obtener instrucciones sobre cómo usarlo, consulte este artículo de . También puede usar parámetros de expresión. Tenga en cuenta que debe usar el valor real en lugar del valor para mostrar. No
En expression
type El tipo de expresión. Los valores pueden ser Constante (valor predeterminado), Unario, Binario y Operador nº. No
value El valor constante. Sí cuando el tipo de expresión es Constante o Campo.
operators El valor del operador. Para obtener más información sobre los operadores, consulte la sección Operadores disponibles para campos de elección que contienen cadenas en este artículo. Sí cuando el tipo de expresión es Unario o Binario.
operands Lista de expresiones en las que se aplica el operador. Sí cuando el tipo de expresión es Unario o Binario.
pageSize Número de documentos por página del resultado de la consulta. No
(el valor predeterminado es 300)

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>"
            }
        }
    }
]

Usar parámetros de expresión

Para configurar el parámetro de expresión en el Generador de consultas , seleccione Agregar contenido dinámico. El tipo de parámetro debe ser Object y el valor debe seguir el formato que se muestra en el ejemplo JSON siguiente:

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

Este es un ejemplo del código JSON de origen mediante el parámetro de expresión:

"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>"
            }
        }
    }
]

Nota:

La columna sys_tags y sus columnas derivadas no se pueden obtener debido a las limitaciones de la API ServiceNow.

Propiedades de la actividad de búsqueda

Para obtener más información sobre las propiedades, consulte la actividad de búsqueda.

Actualización del conector de ServiceNow

Estos son los pasos que le ayudarán a actualizar el conector de ServiceNow:

  1. Cree un nuevo servicio vinculado haciendo referencia a las propiedades del servicio vinculado.
  2. La consulta en el origen se actualiza al Generador de consultas, que tiene el mismo uso que el generador de condiciones en ServiceNow. Aprenda a configurarlo haciendo referencia a ServiceNow como origen.

Diferencias entre ServiceNow V2 y V1

El conector de ServiceNow V2 ofrece nuevas funciones y es compatible con la mayoría de las características del conector de ServiceNow V1. En la siguiente tabla, se muestran las diferencias de características entre V2 y V1.

ServiceNow V2 ServiceNow V1
useEncryptedEndpoints, useHostVerification y usePeerVerification no se admiten en el servicio vinculado. Admite useEncryptedEndpoints, useHostVerification y usePeerVerification en el servicio vinculado.
Soporte para Generador de consultas en la fuente. El generador de consultas no se admite en el origen.
No se admiten consultas basadas en SQL. Se admiten consultas basadas en SQL.
Las consultas sortBy no se admiten en el Generador de consultas. Admite consultas sortBy en Query.
Puedes ver el esquema en el conjunto de datos. No puedes ver el esquema en el conjunto de datos.
Puede configurar valueType en display o actual en conjuntos de datos. El nombre de la tabla de visualización o real se utiliza como valor de tableName.

El nombre de columna es [column name] tanto para el valor de visualización como para el valor real.		 El nombre de la tabla de visualización o real con el prefijo "visualización" o "real" añadido se utiliza como valor de tableName.

El nombre de columna para el valor real es [column name]_value, mientras que para el valor para mostrar es [column name]_display_value.

Contenido relacionado

Para obtener una lista de almacenes de datos admitidos como orígenes y receptores por la actividad de copia, consulte almacenes de datos admitidos.

  • Last updated on