Implementación de tablas de One-Off
Hace referencia a: Outlook 2013 | Outlook 2016
El proveedor puede implementar una o varias tablas únicas. Una tabla única es una lista de resumen de plantillas únicas que se usan para crear destinatarios, ya sea directamente en un contenedor o en la lista de destinatarios de un mensaje saliente. Una plantilla única es un formulario que los usuarios emplean para escribir datos relevantes para un tipo determinado de dirección. Cuando el usuario termina de trabajar con la plantilla, el proveedor crea el nuevo destinatario y lo agrega al mensaje. Normalmente, cada plantilla controla un único tipo de dirección. Sin embargo, es posible que una plantilla controle varios tipos o que varias plantillas controlen el mismo tipo.
El proveedor debe admitir el método OpenEntry para cada plantilla que incluya en la tabla única. La implementación de OpenEntry debe recuperar una tabla para mostrar para la plantilla. MAPI usa la tabla para mostrar para que la plantilla sea visible para el usuario.
Aunque la mayoría de las filas de las tablas únicas representan plantillas, algunas de ellas se pueden usar para clasificar o agrupar plantillas. El valor de su columna PR_SELECTABLE (PidTagSelectable) indica si una fila de una tabla única representa una plantilla. Las filas que representan plantillas tienen la columna PR_SELECTABLE establecida en TRUE; Las filas que no representan plantillas lo tienen establecido en FALSE.
MAPI define tres tipos de tablas únicas:
Tabla única que refleja las plantillas que admite un contenedor individual
Tabla única que refleja todas las plantillas que admite el proveedor
Una tabla única que refleja todas las plantillas que admiten todos los proveedores del perfil, además de algunas que admite MAPI.
Los dos primeros tipos los implementan los proveedores que admiten los destinatarios de creación, ya sea en un mensaje o en un contenedor. El proveedor puede incluir el mismo conjunto o un conjunto diferente de plantillas en sus tablas únicas. La principal diferencia entre los dos tipos es que la tabla de proveedores debe incluir plantillas para crear destinatarios que se pueden usar en los mensajes salientes y la tabla de contenedor debe incluir plantillas para crear destinatarios que se van a agregar al contenedor. Un contenedor solo puede admitir un conjunto restringido de plantillas, pero la tabla de un solo uso del proveedor debe incluir todas las plantillas que admita el proveedor.
MAPI implementa el tercer tipo de tabla única; los proveedores obtienen acceso a ella mediante una llamada a IMAPISupport::GetOneOffTable. La tabla única MAPI es la unión de todas las tablas de proveedor; incluye todas las plantillas admitidas por cada proveedor del perfil. También incluye plantillas admitidas por MAPI. El proveedor puede usar esta tabla en lugar de la tabla solicitada para un contenedor. Sin embargo, las plantillas de esta tabla también se pueden usar para crear destinatarios para los mensajes salientes.