Insertion de propriétés personnalisées SharePoint dans la recherche, SOQL et les requêtes SOSL

Configuration de propriétés personnalisées dans SharePoint

Si vous avez les colonnes personnalisées mappées existantes et les métadonnées des documents Office (Microsoft Word, Excel, etc.) dans SharePoint, les objets externes dans Salesforce permettent de sélectionner et de filtrer sur les propriétés personnalisées suivantes :

• Colonnes personnalisées définies dans un Type de contenu personnalisé
• Métadonnées de Microsoft Word, Excel et d'autres documents Office

Pour rechercher dans ces propriétés personnalisées dans Salesforce, un administrateur Sharepoint doit créer une Propriété gérée correspondante.

• Pour afficher ces propriétés dans des champs d'objet externe, ou les utiliser dans des requêtes SOQL ou SOSL SELECT, définissez la Propriété gérée correspondante sur Récupérable.
• Pour filtrer sur ces propriétés dans des objets externes, ou les utiliser en tant que critères de requête dans une clause SOQL ou SOSL WHERE WHERE, définissez la Propriété gérée correspondante sur Interrogable.

Interrogation des champs résultants dans Salesforce pour SharePoint Online

Dans l'exemple suivant, CustomProperty désigne le nom de colonne Personnalisé défini dans Type de contenu personnalisé ou le nom des métadonnées du document Office. ManagedCustomProperty signifie le nom de propriété gérée correspondant.

Dans la plupart des cas, vous pouvez utiliser ManagedCustomProperty pour la clause SELECT et la clause WHERE. Voici un exemple SOQL :

SELECT ManagedCustomProperty FROM items_spOnline_x WHERE ManagedCustomProperty=...

Cependant, pour les types de fichier que SharePoint n'indexe pas pour la recherche, tels que les fichiers .jpg, .png et .pdf, vous devez utiliser CustomProperty dans la clause SELECT et ManagedCustomProperty dans la clause WHERE. Pour contourner ce problème, vous pouvez définir un alias dans la Propriété gérée dans SharePoint et mettre en forme les requêtes comme suit :

SELECT Alias FROM items_spOnline WHERE Alias=...

Normalement, les propriétés personnalisées ne sont pas affichées dans les pages de détail d'objets externes. La définition d'un alias résout également ce problème.

Propriétés personnalisées booléennes

Lors de l'utilisation de propriétés personnalisées booléennes (Oui/Non) avec une Propriété gérée correspondante définie sur le type Texte, le champ d'objet externe correspondant doit également être défini sur le type Texte. Dans les filtres, les valeurs « 0 » et « 1 » valent respectivement false et true. Par exemple :

WHERE customBooleanWithTextManagedProperty=”1”

« 0 » et « 1 » sont également affichés sous forme de résultats. Par conséquent, les propriétés personnalisées booléennes doivent utiliser un type Propriété gérée OuiNon. Définissez le champ d'objet externe correspondant sur Case à cocher pour l'interroger avec des valeurs standard true ou false. Par exemple :

WHERE customBooleanWithYesNoManagedProperty=true

Métadonnées dans les documents Microsoft Office

Le service Recherche de points partagés renvoie toutes les métadonnées des documents Office sous forme de chaînes. Par conséquent, les champs d'objet externe correspondants doivent être définis sur le type Texte.

Les dates sont renvoyées sous le format MM/JJ/AAAA hh:mm:ss AM/PM (par exemple, “31/03/2015 21:59:00”). Pour interroger des champs en utilisant le type Date, l'objet externe doit inclure un champ Date correspondant pour le filtrage et un champ Texte pour la sélection.

Limitations de types de propriété SharePoint spécifiques dans Salesforce pour SharePoint Online

• Les propriétés multiples Numérique, Devise et Choix ne peuvent pas être sélectionnées pour des types de fichier SharePoint n'indexe pas pour la recherche. Par défaut, cela inclut les fichiers image, vidéo et .pdf, bien que les fichiers .pdf soient indexés en natif à partir de SharePoint 2013.
• Les propriétés Ligne de texte, URL et Date multiples ne peuvent pas être interrogées.
• Les propriétés de choix multiples et URL ne peuvent pas être sélectionnées.