Definir fuentes de distribución

Defina una fuente de distribución, incluyendo los registros que se devuelven y los datos de los registros que se mostrarán:

• Nombre: nombre descriptivo de esta fuente, que lo distingue de otras fuentes que pueda crear. Utilice letras, números o el carácter de subrayado “_” únicamente. No utilice más de un carácter de subrayado en una fila.
• Descripción: Describa la fuente. Por ejemplo, “Nombre y apellido de la cuenta y región de las diez últimas cuentas creadas o editadas.”
• Consulta: La consulta SOQL que define los registros que se devuelven a la fuente de distribución. Para garantizar un desempeño rápido, algunas limitaciones de la consulta SOQL son obligatorias.
  • Si la consulta SOQL no especifica un límite, no se devolverán más de 20 registros.
  • El límite de solicitud no puede superar los 200 resultados. Si hace una solicitud con un límite superior, sólo se devuelven 200 resultados.
  • Si la consulta SOQL no tiene un valor ORDENAR POR especificado, los registros se ordenan por el valor LastModifiedDate si hay uno, o bien por el valor SystemModstamp en caso contrario.
  • COUNT no se admite.
  • Las consultas adicionales no se admiten. Por ejemplo, esta consulta no se puede utilizar en una consulta SOQL de fuentes de distribución:

    SELECT Name, (SELECT CreatedBy.Name FROM Notes) FROM Account

  • Puede utilizar variables de vinculación, una variable cuyo valor se proporciona en la URL.
  

  Nota El usuario invitado debe tener el acceso de colaboración y de seguridad a nivel de campo adecuado para que pueda guardar la consulta, ya que la plataforma Lightning comprueba el acceso y la colaboración antes de guardar.
• Asignación: Puesto que las fuentes de distribución utilizan el protocolo de publicación en Internet ATOM, debe proporcionar un valor de asignación que coincida con los objetos y campos de los registros devueltos con construcciones de ATOM. Tenga en cuenta que todos los valores deben ser literales de cadena.

  También puede utilizar variables de vinculación, una variable cuyo valor se proporciona en la URL. Para obtener más información, consulte Asignación de objetos ATOM.

• Máximo de segundos de antigüedad de la caché: dado que muchos usuarios pueden acceder a una noticia en tiempo real al mismo tiempo, Salesforce almacena en caché los datos de la noticia en tiempo real, por defecto 3600 segundos. Puede modificar este ajuste a un mínimo de 300 segundos, o durante el tiempo que desee. Los resultados de la consulta que duran más que el tiempo especificado se eliminan y se genera una nueva consulta para la siguiente solicitud de información, es decir, la próxima vez que un usuario abra una página que contiene una fuente a la que el usuario esté suscrito.
• Activa: Seleccione esta casilla de verificación para que la fuente esté disponible para suscripción. Una vez la fuente esté activa, los usuarios pueden suscribirse.

Asignación de objetos ATOM

Debe especificar una asignación en la definición de la fuente de distribución. La asignación relaciona los objetos ATOM como el título de la entrada con el valor correspondiente en un registro, por ejemplo, “Nombre de cuenta.” Un conjunto completo de asignaciones representa una fuente de noticias y la consulta representa el contenido de cada elemento de noticias de una fuente. Por ejemplo, los registros de prospectos creados hoy o los contactos con una información de cuenta actualizada.

Un elemento de fuente es el sobre de cada parte de una noticia y un elemento de entrada es el contenido del sobre.

La asignación también permite aplicar etiquetas cortas a varios campos para propósitos de visualización.

La tabla siguiente muestra cada ATOM y elemento de objeto y explica los valores que se pueden proporcionar:

description for Ajax Industries Description

El siguiente ejemplo muestra valores de asignación válidos para una fuente de distribución:

ft: "Harry Potter", et: Name, ec: "description for " Name "<br>" Description, el: "/" Id, ect: html

Las fuentes se visualizan en el contexto del usuario invitado del sitio público donde se muestran. Por lo tanto, si tiene etiquetas personalizadas para gestionar la internacionalización y etiquetas específicas en su asignación, los usuarios verán esas etiquetas en el idioma del usuario invitado.

Sólo puede utilizar literales de cadena en la asignación de fuentes. No puede utilizar, por ejemplo, literales de fecha como TODAY o LAST_WEEK.

Una vez que haya definido una fuente, debe comprobarla y activarla seleccionando la casilla de verificación Activa, tal y como se ha descrito anteriormente. Para obtener más información sobre la comprobación, consulte Comprobación de fuentes de distribución.

Uso de variables de vinculación de consultas y asignación

Puede utilizar variables de vinculación en la cláusula WHERE de la consulta SOQL. Las variables de vinculación deben tener el formato siguiente:

{!var_name}

La consulta siguiente utiliza una variable de vinculación denominada accountID.

SELECT Name, Description
FROM Account
WHERE Id = {!accountID}

Tenga en cuenta que no es el nombre literal del campo, sino un nombre arbitrario. En el momento de la ejecución, el valor de accountID se pasa a la consulta de la dirección URL. Se puede acceder a la fuente desde la siguiente URL y pasa en el Id. de la cuenta como parte del parámetro de cadena de la consulta:

site_URL/services/xml/My'Account'Feed?accountId=0013000000BmP4x

También puede utilizar variables de vinculación para asignar valores.

Los siguientes detalles de implementación se aplican al uso de las variables de vinculación de las consultas:

• No puede utilizar más de 20 variables de vinculación en una definición de fuente, consultas y asignación combinadas.
• El nombre de la variable de vinculación no puede tener más de 100 caracteres.
• Puede utilizar una variable de vinculación únicamente en el lado derecho de una operación de filtro para representar parte de una cadena. Como representa parte de una cadena, debe estar entre comillas. Por ejemplo, la consulta siguiente es válida:

  SELECT Id, Name FROM Account WHERE Name = '{!myBindVariable}'

  Las siguientes consultas no son válidas porque la variable de vinculación no está en su posición correcta y no funciona como la variable de una cadena literal:

  SELECT Id, Name FROM Account WHERE {!myFieldName} = 'Joe'
  SELECT Id, {!myFieldName} FROM Account WHERE IsDeleted = false

• No puede utilizar una variable de vinculación para representar un nombre de campo. Significa que una variable de vinculación no se puede utilizar en el lado izquierdo de una operación de filtro.
• No puede utilizar una variable de vinculación para cambiar el significado o estructura de una consulta por motivos de seguridad. Cualquier carácter especial que especifique en el valor de sustitución de vinculación se interpreta como un carácter literal cuando se evalúa la consulta.

Etiquetas personalizadas y fuentes

En fuentes que se deben localizar en diferentes idiomas, puede utilizar etiquetas personalizadas para definir la cadena en idiomas diferentes. En la definición de la asignación, sólo tiene que hacer referencia a la etiqueta personalizada. Cuando se recibe una solicitud, la etiqueta personalizada comprueba el idioma del usuario invitado y devuelve el texto traducido, que se utiliza en la asignación.

Las etiquetas personalizadas se pueden especificar en un campo con la sintaxis siguiente:

map_element_name: "{!$LABEL.custom_label_name}"

Para especificar una etiqueta personalizada en una fuente, cree la etiqueta a través de Etiquetas personalizadas en Configuración. Para identificarlo de forma sencilla, puede asignar un nombre a la etiqueta personalizada después del elemento de asignación que toma su valor, por ejemplo feedTitle para el elemento ft. A continuación especifique la etiqueta personalizada en la asignación de la fuente.

Por ejemplo, suponga que crea una fuente que contiene información acerca de todos los inmuebles que su compañía intenta vender. Para clientes angloparlantes, el título de la fuente debe ser “The Houses,” pero para usuarios hispanohablantes el título debe ser “Las Casas”. Puede crear una etiqueta personalizada, por ejemplo, feedTitle. En inglés, su valor es “The Houses" y en español, su valor es “Las Casas”. A continuación, en la definición de la asignación de la fuente, especifique lo siguiente para el título de la fuente fc::

ft: "{!$LABEL.feedTitle}"

Visualforce y noticias en tiempo real

<A HREF=""/services/xml/theFeedName">My feed</A>

<A HREF="/services/xml/theFeedName"><img src="feed.gif"></A>

<link href='URI of feed'
   type='application/x.atom+xml'
   rel='feed'
   title='A nice descriptive title'/>