# Datos de proveedores en Pimcore, mapeados visualmente Pimcore 11 no tiene webservice REST, así que SDM Portal escribe a través de la API GraphQL de Datahub: los objetos se localizan por clave, se crean bajo la carpeta que elijas y se actualizan idioma por idioma. El conector está en beta y esta página dice exactamente qué hace y qué no. Versión web: https://sdmportal.com/es/pimcore/ ## La conexión - **Protocolo:** Datahub GraphQL, /pimcore-graphql-webservices/{config} - **Autenticación:** API key de Datahub en la security definition de la configuración - **Versión:** Pimcore 11 - **Estructura:** Clase - **Direccionamiento:** Clave de objeto, bajo una carpeta destino por perfil - **Estado:** Beta ## Dónde se atasca de verdad un feed de proveedor en Pimcore ### Sin webservice REST Pimcore 11 lo eliminó. Todo pasa por una configuración de Datahub que creas tú, que decide qué clases se pueden leer y escribir y que guarda la API key. ### Los objetos son claves y rutas Un objeto de Pimcore no se direcciona por un atributo identifier, sino por una clave dentro de un árbol de carpetas. Una fila de proveedor tiene que resolverse en una clave antes de poder escribir nada. ### Cada idioma es una escritura aparte Los campos localizados se actualizan por idioma, lo que significa que un catálogo multiidioma amplio son muchas mutaciones pequeñas en lugar de un solo documento. ## Cómo escribe SDM Portal en Pimcore ### Datahub como superficie de integración Creas una configuración de Datahub en Pimcore, expones las clases que quieres rellenar, pones una API key en la security definition y la activas. SDM Portal se conecta a ese endpoint con la key. No se instala nada dentro de Pimcore. ### Mapeo por clase Elige la clase y el panel de atributos se limita a sus campos, igual que hace una familia o una plantilla en los otros dos PIM. ### Comprobación de existencia por clave Antes de escribir, SDM Portal busca las claves que va a tocar y decide fila por fila si eso es un create o un update. La comprobación también encuentra objetos sin publicar, así que un objeto que creaste en una ejecución anterior se actualiza en lugar de duplicarse. ### Una carpeta destino que eliges Los objetos nuevos se crean bajo una ruta de carpeta fijada por perfil. Cuando la configuración de Datahub expone las carpetas de objetos, la eliges en un árbol con búsqueda leído en vivo desde Pimcore; cuando no lo hace, escribes la ruta. ### Valores escritos por idioma Un create y después una mutación de update por idioma, con pausas para que un catálogo grande no inunde el endpoint. Un update sin contenido se omite en lugar de enviarse. ### Todo lo anterior a la escritura es igual La subida, el enlace compartido o la recepción por correo, el editor visual de flujo, las transformaciones compiladas con IA, los bloques Translate y Compose, el dry-run fila a fila, el flujo de aprobación, los modos create, update y upsert, y el delta sync son idénticos a las rutas de Ergonode y Akeneo. Solo cambia la escritura. ## Qué podemos escribir en Pimcore Los valores se escriben mediante mutaciones de update de Datahub por idioma. Los valores de select se mapean a los códigos que espera tu clase; SDM Portal no crea valores ni campos nuevos en la definición de la clase. - Campos de texto - Textarea - Números - Fechas - Campos localizados por idioma - Clave de objeto - Ubicación en la carpeta destino ## Lo que el conector de Pimcore todavía no hace ### Más joven que los otros dos conectores (beta) Hoy escribe en una instancia real de Pimcore: encuentra objetos por clave, los crea bajo una carpeta destino y actualiza valores por idioma. Tiene menos funciones que los conectores de Ergonode y Akeneo, y están todas listadas aquí. ### Los objetos llegan sin publicar (tu decisión) Un objeto creado por SDM Portal no se publica. La publicación sigue siendo una decisión en Pimcore. La comprobación de claves sí encuentra objetos sin publicar, así que la siguiente ejecución actualiza ese objeto en lugar de crear un segundo. ### Variantes, creación de opciones, estado de workflow (no compatible) Sin padres de variante ni ejes, sin creación de valores de select ni de opciones, sin enriquecimiento de opciones y sin transiciones de estado de workflow. Eso son funciones de Ergonode y Akeneo. ### Crear campos (se queda en pimcore) No puedes crear un campo de clase nuevo desde el editor. La definición de la clase se gestiona en Pimcore. ### Claves duplicadas entre carpetas (punto a vigilar) La comprobación de claves busca en todas las carpetas. Si la misma clave existe dos veces recibes un aviso de clave duplicada y la escritura va al primer resultado. ### Un update por idioma y por objeto (rendimiento) Un catálogo multiidioma amplio avanza más despacio que las rutas de escritura agrupadas de Ergonode y Akeneo, donde muchos productos viajan en una sola petición. ### El selector de carpetas (depende de la configuración) La lectura de carpetas de objetos está desactivada por defecto en una configuración de Datahub. Actívala para obtener el árbol de carpetas, o escribe la ruta destino en su lugar. ## FAQ ### ¿Qué versión de Pimcore y qué API usa SDM Portal? Pimcore 11 a través de la API GraphQL de Datahub. Pimcore 11 no tiene webservice REST, así que Datahub es la superficie de integración. Creas una configuración de Datahub, expones las clases que quieres rellenar, pones una API key en su security definition y la activas. ### ¿Qué significa beta en el conector de Pimcore? Hoy escribe en una instancia real de Pimcore: encuentra objetos por clave, los crea bajo una carpeta destino y actualiza valores por idioma. Es más joven que los conectores de Ergonode y Akeneo y tiene menos funciones, que están listadas en esta página. Lo llamamos beta para que puedas juzgarlo por ti mismo. ### ¿Se publican los objetos automáticamente? No. Los objetos creados por SDM Portal llegan sin publicar, y la publicación sigue siendo una decisión en Pimcore. La comprobación de existencia sí encuentra objetos sin publicar, así que una ejecución posterior actualiza el objeto que creaste en lugar de hacer otro. ### ¿Cómo se emparejan los objetos de Pimcore con las filas del proveedor? Por la clave del objeto. Antes de escribir, SDM Portal repasa las claves que va a tocar y decide fila por fila si eso es un create o un update. La comprobación busca claves en todas las carpetas, así que si la misma clave existe dos veces recibes un aviso de clave duplicada y la escritura va al primer resultado. ### ¿Puedo seguir usando el editor visual y el dry-run? Sí. Todo lo anterior a la escritura es igual que en Ergonode y Akeneo: el lienzo de flujo, las transformaciones, las reglas compiladas con IA, los bloques Translate y Compose, el dry-run fila a fila, el flujo de aprobación y el delta sync. ## Empezar Prueba gratis 14 días: https://app.sdmportal.com/signup?lang=es Otros PIM: https://sdmportal.com/es/ergonode/ · https://sdmportal.com/es/akeneo/ · https://sdmportal.com/es/pimcore/ SDM Portal.