Actividad Upsert de NetSuite
Introducción
Una actividad Upsert de NetSuite, que utiliza su conexión de NetSuite, actualiza registros existentes y crea nuevos registros en NetSuite y está destinado a ser utilizado como un destino para consumir datos en una operación.
La actividad Upsert utiliza un campo de ID externo para actualizar los registros existentes e insertar nuevos datos si no lo hacen. Si, por el contrario, solo desea insertar nuevos datos en NetSuite, utilice la actividad NetSuite Create, o si desea utilizar un campo de identificación interno o externo para actualizar registros existentes sin crear nuevos, utilice una actividad Actualizar de NetSuite.
Crear una actividad Upsert de NetSuite
Se crea una instancia de una actividad Upsert de NetSuite desde una conexión de NetSuite utilizando su tipo de actividad Upsert.
Para crear una instancia de una actividad, arrastre el tipo de actividad al tela de diseño de tela de diseño o cópielo y péguelo en él. Para obtener más información, consulte Crear una instancia de actividad o herramienta en Reutilización de componentes.
Se puede editar una actividad Upsert de NetSuite existente desde estas ubicaciones:
-
El tela de diseño (vea menú de acciones del componente en Lienzo de diseño).
-
La pestaña Componentes del panel del proyecto (vea menú de acciones de componentes en la pestaña Componentes del panel Proyecto)
Configurar una actividad Upsert de NetSuite
Siga estos pasos para configurar una actividad Upsert de NetSuite:
Paso 1: Ingrese un nombre y seleccione un objeto
-
Nombre: Ingrese un nombre para identificar la actividad Upsert de NetSuite. El nombre debe ser único para cada actividad Upsert de NetSuite y no debe contener barras diagonales (
/
) o dos puntos (:
). -
Seleccionar un objeto: Esta sección muestra los objetos disponibles en el extremo de NetSuite. Al reabrir una configuración de actividad existente, solo se muestra el objeto seleccionado en lugar de recargar la lista completa.
-
Objeto de NetSuite seleccionado: Después de seleccionar un objeto, este aparece aquí.
-
Buscar: Introduzca el valor de cualquier columna en el cuadro de búsqueda para filtrar la lista de objetos. La búsqueda no distingue entre mayúsculas y minúsculas. Si los objetos ya se muestran en la tabla, los resultados se filtran en tiempo real con cada pulsación de tecla. Para recargar objetos desde el extremo durante la búsqueda, introduzca los criterios de búsqueda y actualice, como se describe a continuación.
-
Actualizar: Haga clic en el icono de actualización o la palabra Actualizar para recargar objetos desde el extremo de NetSuite. Esto puede ser útil si ha añadido recientemente objetos o campos a NetSuite. Esta acción actualiza todos los metadatos utilizados para crear la tabla de objetos que se muestra en la configuración.
-
Seleccionar un objeto: Dentro de la tabla, haga clic en cualquier parte de una fila para seleccionar un objeto. Solo se puede seleccionar un objeto. La información disponible para cada objeto se obtiene del extremo de NetSuite:
-
Nombre: El nombre del objeto de NetSuite.
-
Tipo: El tipo de objeto de NetSuite. Esto incluye todos los objetos estándar, de transacción, de artículo y personalizados que se pueden buscar en el extremo de NetSuite.
Nota
Según los permisos de NetSuite establecidos para la cuenta de NetSuite, esta lista puede ser diferente a la que se devuelve con una actividad Búsqueda de NetSuite.
-
Descripción del objeto: La descripción del objeto de NetSuite.
Consejo
Si la tabla no se completa con los objetos disponibles, la conexión NetSuite podría no funcionar correctamente. Asegúrese de estar conectado reabriendo la conexión y probando las credenciales.
-
-
-
Guardar y salir: Si está habilitado, haga clic para guardar la configuración de este paso y cerrar la configuración de la actividad.
-
Siguiente: Haga clic para continuar con el siguiente paso y guardar temporalmente la configuración. La configuración no se guarda hasta que haga clic en el botón Finalizado en el último paso.
-
Descartar cambios: Después de realizar los cambios, haga clic para cerrar la configuración sin guardar los cambios realizados en ningún paso. Un mensaje le pedirá que confirme que desea descartar los cambios.
Paso 2: Revisar los esquemas de datos
Esquema de datos: Se muestran los esquemas de datos de solicitud y respuesta de NetSuite. Si la operación utiliza una transformación, los esquemas de datos se muestran de nuevo durante el proceso de mapeo de la transformación, donde se pueden mapear a los campos de destino mediante objetos de origen, secuencias de comandos, variables, valores personalizados, etc.
El conector de NetSuite utiliza la API de servicios web SOAP de la versión de NetSuite WSDL que haya configurado. Consulte la documentación disponible en el Centro de ayuda de NetSuite para obtener información sobre los campos del esquema.
!!! tip "Consejo"
Durante el proceso de mapeo de transformación, puede mapear a la `externalId` Campo en NetSuite para asociar los registros que se actualizarán. Si se necesitan crear nuevos registros, se puede usar solo el... `InternalId` El campo no sería suficiente ya que este campo aún no se crearía para nuevos registros en NetSuite.
!!! note "Nota"
Para actualizar un esquema de datos en una actividad existente, debe avanzar nuevamente a través de cada paso de configuración de la actividad, realizando al menos un cambio (como agregar y quitar un carácter del final del nombre de la actividad) para forzar una actualización del esquema.
-
Atrás: Haga clic para regresar al paso anterior y almacenar temporalmente la configuración.
-
Terminado: Haga clic para guardar la configuración de todos los pasos y cerrar la configuración de la actividad.
-
Descartar cambios: Después de realizar cambios, haga clic para cerrar la configuración sin guardar los cambios realizados en ningún paso. Un mensaje le pedirá que confirme que desea descartar los cambios.
Próximos pasos
Después de configurar una actividad Upsert de NetSuite, puede usarla dentro de una operación o secuencia de comandos como se describe a continuación.
Completar la operación
Después de configurar una actividad Upsert de NetSuite, complete la configuración de la operación agregando y configurando otras actividades o herramientas como pasos de la operación. También puede configurar los ajustes de la operación, lo que incluye la posibilidad de encadenar operaciones que se encuentren en el mismo flujo de trabajo o en flujos de trabajo diferentes.
Se puede acceder a las acciones del menú de una actividad desde el panel del proyecto y el tela de diseño. Para más detalles, consulte menú de acciones de la actividad en Conceptos básicos del conector.
Las actividades Upsert de NetSuite se pueden utilizar como destino con estos patrones de operación:
- Patrón de Transformación
- Patrón de archivo de dos objetivos (solo como primer objetivo) - Patrón de dos transformaciones (como primer o segundo objetivo)
Las operaciones que contienen una actividad de NetSuite solo pueden tener una actividad de NetSuite y tampoco pueden contener ninguna Salesforce, Salesforce Service Cloud, SAP, ServiceMax, o SOAP actividades.
Otros patrones no son válidos con las actividades Upsert de NetSuite. Consulte los patrones de validación en la sección Validez de la operación página.
Para utilizar la actividad con funciones de script, escriba los datos en una ubicación temporal y luego use esa ubicación temporal en la función de script.
Cuando esté listo, desplegar y ejecutar la operación y validar el comportamiento comprobando los registros de operación.
Recommendation" Consejo "Recomendación
Habilitar fragmentación de datos para evitar errores de tiempo de ejecución debido a los límites de registros impuestos por la API de NetSuite.
Solución de problemas
Si tiene problemas al ejecutar una operación mediante una actividad Upsert de NetSuite, consulte Solución de problemas del conector de NetSuite.