En este documento se describen las mejoras relacionadas con la API en Upchain 22.2. Los cambios que formaban parte de las actualizaciones semanales se marcan con un asterisco (*).

Proveedor

• * Como se esperaba, los usuarios habituales reciben un código de error HTTP 403 al utilizar GET /api/supplier/v1/parts/{partVersionId}. Solo los proveedores deben utilizar este punto final para obtener información sobre los objetos del proveedor relacionados con la pieza especificada mediante partVersionId.
  El resto de usuarios puede utilizar GET /api/supplier/v1/parts/{partVersionId}/suppliers. La respuesta incluye un nuevo campo partSupplierId que proporciona la ubicación en la que se guardan los objetos del proveedor.

Información de la organización del usuario

• Los siguientes puntos finales ahora incluyen contact.organization en su carga útil de respuesta:
  • GET /api/user/v1/user/{userId}
  • GET /api/user/v2/users
  • GET /api/user/v2/users/{username}
  • GET /api/user/v2/users/current-user/details
• La hoja de cálculo de Excel generada con POST /api/user/v2/users/export incluye la Organización de los usuarios.
• PUT /api/user/v1/user/{userId} incluye contact.organization en la solicitud para que se pueda actualizar la organización de un usuario.

Conversiones enlazadas manualmente mediante la API

Siga estos pasos para enlazar manualmente una conversión a un artículo mediante la API:

1. Utilice GET /api/bom/v2/item_versions/{itemVersionId}/translations para obtener todas las conversiones asociadas con el artículo identificado por itemVersionId.
   Por defecto, los usuarios con permiso para acceder al artículo pueden obtener todas las versiones más recientes de las conversiones para el itemVersionId especificado. Establezca allVersions en true para obtener las versiones más recientes y anteriores de las conversiones.
2. Cree la nueva conversión mediante POST /api/bom/v1/file-versions. Tenga en cuenta lo siguiente antes de enviar la solicitud (deberá consultar la carga útil de respuesta del paso 1):

¿Ya existe una conversión con el mismo nombre de archivo?
Sí	No
a. Si subCategory: USER_GENERATED, al crear la nueva conversión, utilice fileId en la carga útil de la solicitud. De este modo, se añade la nueva versión de la conversión y se incrementa la versión del archivo. b. Si subCategory: SYSTEM_GENERATED, recibirá un código de error HTTP 409 y la operación finalizará sin crear la conversión.	a. Para asegurarse de que las conversiones con el mismo nombre de archivo asociadas con otros artículos no se incrementen, establezca forceNewTranslationFile en true.

3. Enlace la conversión recién creada del paso 3 a un artículo mediante `POST /api/bom/v1/item-versions/{itemVersionId}/file-versions-bulk`. Puede enlazar varias conversiones al artículo identificado por itemVersionId.
Nota: El equipo de soporte es el único con permiso para enlazar una conversión a un artículo con el estado Lanzado o Released_External. Todos los demás recibirán un código de error HTTP 403.

Puede eliminar las conversiones utilizando los siguientes puntos finales:

• DELETE ​/api​/bom​/v2​/item-versions​/{itemVersionId}​/file-versions​/{fileVersionId} Este punto final solo rompe el vínculo entre la conversión y el artículo. Las "conversiones suprimidas" se pueden encontrar desde la búsqueda.

• DELETE /api/bom/v2/item-versions/{itemVersionId}/user-translations elimina todas las conversiones asociadas manualmente a un artículo. Solo el equipo de soporte puede utilizar este punto final para eliminar todas las conversiones asociadas manualmente.

Restringir funciones para que no creen nuevas versiones de artículos lanzados

Cuando se usa POST /api/bom/v2/items para crear una nueva versión de un artículo lanzado y la persona que llama a este punto final no tiene una de las funciones permitidas, se devuelve un código de error HTTP 403.

Configuraciones necesarias

Los administradores de inquilinos deben seguir estos pasos:

1. Solicite soporte para que las siguientes propiedades de inquilino estén disponibles: create.new.item.version.from.release.check y create.new.item.version.from.release.allowed.
2. En Administración > Ingeniería > Propiedades del inquilino:
   1. Haga clic en Editar.
   2. Para la propiedad de inquilino create.new.item.version.from.release.allowed tipo: función permitida 1 = tipo de artículo 1, tipo de artículo 2; función permitida 2` = tipo de artículo 2, tipo de artículo 3, etc., separe cada configuración de permisos con un punto y coma, y separe los varios tipos de artículos con una coma.

Ejemplo:
create.new.item.version.from.release.allowed: Diseñador mecánico principal = Artículo de estructura de producto, Pieza mecánica comercial; Gestor de proyectos = Artículo de estructura de producto, Pieza mecánica comercial, Paquete eléctrico.

Desactivar bloqueos desde la API

Los administradores de inquilinos pueden utilizar DELETE ​/api​/lock​/v1​/item-versions​/{itemVersionId}​/locks para eliminar los bloqueos de edición de la lista de materiales, edición y check-out del artículo especificado en itemVersionId.

Una respuesta HTTP 200 devuelve información sobre todos los bloqueos desactivados.