Referencia: Utilice este artículo para seleccionar los campos de acción y los campos de comando adecuados en un «custo-manifest».
Puede utilizar este artículo para seleccionar los campos de acción raíz y los campos de comando adecuados en un «custo-manifest». Verá cómo utiliza Rainbow cada campo y qué campos dependen de la familia de puntos de extensión.
Campos de acción raíz
| Campo | Descripción |
|---|---|
nombre |
Texto que se muestra en Rainbow: etiqueta del botón, título del widget o entrada del menú. Opcional para eventos automáticos. |
icono / iconId
|
URL del icono, ruta del recurso empaquetado o identificador de icono integrado. Obligatorio para la mayoría de los puntos de extensión de botones. |
tooltip |
Texto de ayuda que se muestra al pasar el cursor por encima de un botón. |
comando |
Objeto obligatorio que describe lo que Rainbow debe ejecutar o invocar. |
responseType |
Formato de visualización de los resultados visibles: markdown, json o adaptiveCard. |
displayJsonField |
Cuando una respuesta REST es JSON, este campo identifica la propiedad que contiene el Markdown que se va a mostrar. |
adaptiveCardTemplate |
Plantilla de Adaptive Card en línea. |
adaptiveCardTemplateJsonField |
Campo JSON que contiene la plantilla de Adaptive Card devuelta por el servicio REST. |
adaptiveCardContentJsonField |
Campo JSON que contiene los datos utilizados para rellenar la plantilla de Adaptive Card. |
adaptiveCardSubmitUrl |
URL REST a la que se realiza una llamada POST cuando se activa una acción «Action.Submit» de Adaptive Card. |
El objeto «command»
"command": {
"url": "https://api.example.com/customer",
"params": "email=${contact.email}",
"commandType": "rest",
"method": "GET",
"header": ["Authorization: Bearer TOKEN"],
"bodyParameters": {
"user": "${localUser.email}"
}
}| Campo | Cuándo utilizarlo |
|---|---|
url |
Obligatorio. URL web, punto final REST, ruta de un archivo local o ruta de un recurso empaquetado. |
params |
Parámetros de consulta opcionales. Se admiten variables. |
commandType |
Opcional. Los valores habituales son «rest » y «file». Si se omite, el comportamiento depende del punto de extensión. |
method |
Para comandos REST. Valores admitidos: GET y POST. |
header |
Para comandos REST. Matriz de cadenas de encabezados HTTP. |
parámetros del cuerpo |
Para comandos REST POST. Objeto JSON enviado como cuerpo de la solicitud. Se admiten variables. |
Campos secundarios
| Campo | Se utiliza con | Finalidad |
|---|---|---|
AnswerOnClick |
Botón de llamada entrante | Responder a la llamada al hacer clic en el botón. |
NoShortNumber |
Eventos de la centralita | Utilice el número de teléfono completo en lugar del número abreviado cuando sea pertinente. |
RaiseChangeCall |
Eventos de la centralita | Controla el comportamiento del cambio de estado de la llamada para flujos de trabajo de Telefonía específicos. |
Ventana emergente |
Acciones en la ventana principal |
Abre la aplicación en una ventana del navegador en lugar de integrarla en Rainbow. |
tambiénParaEquipos |
Puntos de extensión de la interfaz gráfica de usuario | Mostrar la extensión para Teams cuando sea compatible. |
urlConfig |
Casos de uso de widgets/marcos | URL utilizada para configurar el widget o la aplicación integrada. |
firstNameJsonField |
Extracción de datos de contacto | Campo que contiene el nombre de pila en una respuesta JSON. |
lastNameJsonField |
Extracción de datos de contacto | Campo que contiene el apellido en una respuesta JSON. |
companyJsonField |
Extracción de datos de contacto | Campo que contiene el nombre de una empresa en una respuesta JSON. |
Comandos de archivo y recursos empaquetados
En Rainbow Desktop, commandType: «file» permite ejecutar una aplicación o un script local. En Rainbow Web, la ejecución nativa no es disponible; los casos de uso basados en archivos deben recurrir a los recursos empaquetados en el archivo ZIP del manifiesto.
"command": {
"commandType": "file",
"url": "${custo.path}\display.html"
}
Advertencia: No utilice rutas absolutas específicas de un equipo en los manifiestos de producción. Utilice
${custo.path} e incluya los recursos necesarios en un archivo ZIP siempre que sea posible.