El Knowledge Graph admite varios tipos de campos, cada uno diseñado para diferentes tipos de datos.
Tipos de campo estándar
Cada campo está definido por un tipo. Estos son los tipos de campos estándar disponibles en la plataforma Yext.
| Tipo | Descripción | Validación disponible |
|---|---|---|
| Llamadas a la acción | Llamada a la acción con etiqueta y enlace | Longitud de caracteres de etiqueta (hasta 255), longitud de caracteres de enlace (hasta 2 000) |
| Foto compleja | Foto con pie de foto incorporado, detalles, URL de clic y texto alternativo | Relación de aspecto, ancho mínimo/altura |
| Galería de fotos complejas | Galería de fotos con pie de foto incorporado, detalles, URL de clic y texto alternativo | Relación de aspecto, ancho mínimo/altura, recuento de elementos (hasta 500) |
| Vídeo complejo | URL de YouTube (y YouTube Shorts) con descripción integrada | Longitud de los caracteres de la descripción (hasta 140) |
| Galería de vídeos complejos | Galería de URLs de YouTube con descripción incorporada | Descripción, longitud de caracteres (hasta 140), recuento de artículos (hasta 100) |
| Horario diario | Configure una hora específica para cada día de la semana. | n/d |
| Fecha | Campo de fecha | Rango de fechas |
| Fecha y hora | Campo de fecha con la hora del día especificada | Intervalo de fecha y hora |
| Relación de la entidad | Lista de entidades relacionadas con la opción de seleccionar un tipo de relación unidireccional, bidireccional (campo compartido) o bidireccional (campo distinto) | Tipos de entidades seleccionables, recuento de elementos (hasta 5 000) |
| Archivo | Los tipos de campo de archivo pueden configurarse para admitir un archivo o admitir una lista de archivos. | Formato de archivo y tamaño máximo de archivo (hasta 1GB) |
| Horarios | Configure una lista de horas para cada día de la semana. Indique si una entidad está abierta, cerrada, dividida o abierta las 24 horas. Puede especificar varios rangos de horas para un día concreto. | n/d |
| Texto de múltiples líneas | Texto de formato largo | Longitud de caracteres (hasta 100 000) |
| Selección de múltiples opciones | Campo de opciones donde el usuario puede seleccionar varias opciones | Opciones disponibles, Cantidad de artículos (hasta 2 000) |
| Número | Campo numérico | Rango de números |
| Teléfono | Campo numérico con prefijo del código de país y formateo automático del número de teléfono | n/d (la validación sobre qué constituye un número de teléfono válido se deriva de Google ) |
| Foto | Foto con texto alternativo | Relación de aspecto, ancho mínimo/altura |
| Galería de fotos | Galería de fotos con texto alternativo | Relación de aspecto, ancho mínimo/altura, recuento de elementos (hasta 500) |
| Precio | Campo de precios | n/d |
| Texto enriquecido | Campo de texto enriquecido con formato | Tipo de formato (negrita, cursiva, subrayado, lista con viñetas, lista numerada, hiperenlace, bloque de código), longitud de caracteres (hasta 100 000) |
| Texto de una sola línea | Texto breve | Longitud de caracteres (hasta 100 000) |
| Selección de una sola opción | Campo de opciones donde el usuario solo puede seleccionar una opción | Opciones disponibles |
| Slug | Una etiqueta corta y fácil para el lector al final de una URL que normalmente actúa como identificador, por ejemplo, hitchhikers.yext.com/docs | Alfanuméricos minúsculos y los siguientes caracteres especiales: - . _ ~ : / [ ] @ ! $ ’ ( ) * + ; = “ |
| Texto - lista | Lista de cadenas de texto | Longitud de caracteres (hasta 100.000), Cantidad de elementos (hasta 1.000) |
| Hora | Un valor de hora y minuto (hh:mm) |
n/d |
| URL | URL del sitio web | Longitud de los caracteres (hasta 2 000) |
| Vídeo | URL de YouTube (y YouTube Shorts) | n/d |
| Galería de vídeos | Galería de URLs de YouTube (y YouTube Shorts) | Relación de aspecto, ancho/altura mínimo, recuento de elementos (hasta 100) |
| Sí/No | Campo con opciones Sí, No o No especificado | n/d |
Tipo de campo de archivo
El tipo de campo Archivo le permite almacenar los archivos directamente en sus entidades. Este tipo está disponible para su uso en campos personalizados y tipos de campos personalizados.
Propiedades
El tipo de campo Archivo se compone de las cinco propiedades siguientes:
| Propiedad | Descripción |
|---|---|
sourceURL |
URL de origen del archivo. Solo se completa si se carga proporcionando una URL alojada. |
url |
La URL del archivo alojada en Yext. |
mimeType |
El tipo MIME del archivo. Actualmente, se admiten todos los tipos de MIME. |
nombre |
El nombre que se muestra del archivo. Configurable por el usuario. Nota: la propiedad del nombre no se puede asignar mediante un conector, pero se puede configurar o editar en todas las demás interfaces. |
tamaño |
El tamaño del archivo en bytes. |
Los tipos de campo de archivo pueden configurarse para admitir un archivo o admitir una lista de archivos. Esto creará automáticamente una validación de carga de archivo máxima de 1 o 5 000 respectivamente.
Proceso de
La validación predeterminada para los campos de archivo está a continuación. También puede configurar la validación para los campos personalizados del archivo y los tipos de campos personalizados del archivo.
| Opción | Validación por defecto | Validación personalizada |
|---|---|---|
| Formato de archivo | Todos los formatos de tipo MIME están permitidos. | Puede restringir los archivos subidos a un subconjunto de tipos de archivo permitidos según el tipo MIME común. |
| Tamaño máximo del archivo | Los archivos no pueden superar 1 GB. | Establezca un límite máximo diferente en bytes, kilobytes o megabytes. El valor debe ser un número entero. |
Nota: Hay un problema conocido con JsonFormat.Printer que afecta a Configuration as Code, por el cual la propiedad maxSize se devolverá como una cadena al recuperarla. Sin embargo, cuando se aplica, esta propiedad debe ser un número.
Cargando Archivos
Los archivos se pueden cargar utilizando todas las interfaces para editar entidades en el Knowledge Graph (es decir, Edición de entidades, Carga de entidades, Conectores, API y CaC).
Todas las interfaces admiten la carga de archivos haciendo referencia a una URL de origen. La carga desde un sistema de archivos local solo se admite en Entity Edit.
Para subir un archivo alojado en Internet, indique la URL alojada con la propiedad url. Esta URL proporcionada se propagará entonces a la propiedad sourceUrl, mientras que el campo URL cambiará para ser la URL alojada en Yext de este archivo.
Actualización de archivos
Para cambiar un archivo almacenado en un campo de una entidad, actualice el valor de la propiedad url para que sea la URL del nuevo archivo alojado. No se admite el envío de actualizaciones a la propiedad sourceUrl.
La cadena de agente de usuario utilizada para descargar archivos es YextBot YextFileDownloader/1.0.
Acceso a archivos almacenados
Se puede acceder a los archivos almacenados en las entidades a través de Edición de Entidad y a través de la API.
Edición de Entidad
Los archivos pueden descargarse desde la propiedad URL. El estado de edición de este campo mostrará todas las propiedades del campo Archivo. Las propiedades de un archivo no pueden editarse en Edición de Entidad, excepto por el nombre del archivo.
API
Abrir la URL almacenada en la propiedad url descargará el archivo en su dispositivo local. Este es un ejemplo de cómo podría ser en un Entities: GET.
Con los demás campos omitidos, la respuesta es la siguiente:
{
"response": {
"entities": [{
"c_pdfFile": [{
"sourceUrl": "https://www.pdfs.com/123",
"url":"https://a.mktgcdn.com/f/3912636/123",
"mimeType": "application/pdf",
"name": "Instruction Manual",
"size": 2001
}]
}]
}
}Tipo de campo de fotografía
El tipo de campo Foto te permite almacenar fotos directamente en tus entidades. Este tipo está disponible para su uso en campos personalizados y tipos de campos personalizados.
Propiedades
El tipo de campo Photo está compuesto por las siguientes cinco propiedades:
| Propiedad | Descripción |
|---|---|
ancho |
El ancho de la foto en píxeles. |
altura |
La altura de la foto en píxeles. |
url |
La URL del archivo alojada en Yext. |
sourceUrl |
URL de origen del archivo. Solo se completa si se carga proporcionando una URL alojada. |
thumbnails (Legado) |
Una función antigua que generaba miniaturas de varios tamaños para una foto al subirla. Esta función ha sido sustituida por la transformación dinámica de imágenes. |
Proceso de
Puede configurar la validación para campos personalizados de foto y tipos de campos personalizados de foto.
| Opción | Validación disponible | Predeterminada | Valores aceptados |
|---|---|---|---|
| Ancho | Establezca el ancho mínimo en píxeles | 0 | Números enteros del 0 al 1.000 |
| Altura | Establezca la altura mínima en píxeles. | 0 | Números enteros del 0 al 1.000 |
| Relación de aspecto | Establezca la relación de aspecto aceptada (ancho:alto). | Sin restricciones | Sin restricciones, 1:1, 4:3, 3:2, 5:3, 16:9, 3:1,2:3, 5:7, 4:5, 16:10 |
Limitaciones
| Opción | Valores aceptados |
|---|---|
| Tamaño de imagen | Hasta 100 megapíxeles |
| Formato de imagen | JPEG, PNG, BMP, GIF, TIFF, WEBP |
Subiendo fotos
Las fotos se pueden subir a través de todas las interfaces de edición de las entidades del Knowledge Graph.
Todas las interfaces admiten la carga de fotos haciendo referencia a una URL de origen. Subir una foto desde un sistema de archivos local solo es posible en Edición de Entidad.
Para subir una foto alojada en línea, introduzca la URL de la foto en la propiedad url. Esta URL se propagará entonces a la propiedad sourceUrl, mientras que el campo URL será la URL alojada en Yext de la foto.
Actualización de fotos
Para cambiar la foto que está almacenada en un campo de foto dado, actualice el valor de la propiedad url para que sea la nueva URL de la foto alojada. No se admite el envío de actualizaciones directamente a la propiedad sourceUrl.
Acceso a Fotos
Una vez que se ha subido una imagen a una entidad, su URL alojada se guarda como referencia en el campo de la entidad. Puede acceder a la entidad a través de la API para recuperar directamente la URL de la foto, por ejemplo:
Con los demás campos omitidos, la respuesta es la siguiente:
{
"response": {
"entities": [{
"photoGallery": [{
"image": {
"width": 314,
"height": 366,
"url": "http://a.mktgcdn.com/p/Oua5ocwC7euaUFkJ-V8n3OpF76Xtfh_rdsDT9ki_laY/314x366.jpg"
}]
}]
}
}A cada imagen se le asigna un UUID largo (la cadena aleatoria larga de arriba), por lo que la URL tiene la forma: a.mktgcdn.com/p/UUID/WIDTHxHEIGHT.EXT.
Tanto HTTP como HTTPS son compatibles.
Tipos de campo personalizado
Puede crear tipos de campos personalizados para agrupar varios campos en un solo campo complejo. Por ejemplo, podría crear un tipo de campo «Business Hours Override» con subcampos para el día, la hora de apertura y la hora de cierre.
Normalmente usará los tipos de campo integrados en Yext. Si es necesario para su caso de uso, también puede crear tipos de campo personalizados.
Para crear un tipo de campo personalizado:
- Vaya a Knowledge Graph > Configuración y haga clic en el mosaico Tipos de campos .
-
Haga clic en Añadir tipo de campo personalizado.
-
Introduzca la información básica para su tipo de campo personalizado.
- Nombre del tipo de campo
- Nombre de la API: Esto se establecerá automáticamente en función del nombre, pero puede modificarlo si lo desea.
-
Descripción del tipo (opcional)
- Si utiliza perfiles de idiomas alternativos, añada traducciones a su tipo de entidad personalizado. Haga clic en Añadir traducción en la configuración Nombre o Descripción.
- Seleccione el idioma deseado e introduzca el valor traducido. Haga clic en Guardar o Guardar y añadir otra para añadir otra traducción a la misma configuración.
- Añada los campos individuales que conformarán su nuevo tipo de campo. Para empezar, haga clic en Añadir un subcampo.
- Introduzca la configuración para el subcampo.
- Tipo de subcampo: elija el tipo de subcampo que quiere añadir. Según el tipo de campo que haya elegido, es posible que vea una configuración ligeramente diferente.
- Etiqueta de subcampo: introduzca una etiqueta para el subcampo. Añada traducciones si lo desea.
- Validación: establezca reglas de validación, como el recuento mínimo o máximo de caracteres u otro contenido aceptado en el subcampo.
- Configuración: elija si este subcampo debe ser obligatorio al rellenar su campo personalizado y si tiene opciones de lista.
- Haga clic en Añadir un subcampo para añadir otro subcampo.
- Haga clic en el icono de la papelera de un subcampo para eliminarlo.
- Haga clic en Guardar en la parte inferior de la pantalla para guardar su campo personalizado.