Comment personnaliser l'élément racine ou de niveau supérieur dans un contrôle ItemsGrid ou Path ?

Les contrôles ItemsGrid et Path fournissent les interfaces d'affichage et de navigation des éléments contenus dans un bean EnterpriseItems, par exemple une série de dossiers ou de catégories menant à des rapports et documents. Il existe plusieurs valeurs prédéfinies pour le nœud racine ou de niveau supérieur des contrôles ItemsGrid et Path, accessibles par navigation aux utilisateurs. Vous pouvez par exemple vouloir que l'application affiche le dossier racine personnel d'un utilisateur une fois celui-ci connecté et l'empêcher de naviguer au-dessus de cet élément de niveau supérieur. Vous pouvez aussi restreindre la navigation de l'utilisateur aux seules catégories personnelles, plutôt qu'aux dossier ou autres catégories.

Pour personnaliser l'élément de niveau supérieur

1. Affectez à la propriété DefaultRoot du contrôle ItemsGrid ou Path la valeur None.
2. Affectez à la propriété EnableDefaultParent des données du bean EnterpriseItems liées au contrôle la valeur CorporateCategory, PersonalCategory, RootFolder, UserRootCategory ou UserRootFolder.
3. Vérifiez que la propriété ItemTypes du bean EnterpriseItems est définie pour renvoyer le type voulu.

Par exemple, si vous affectez à la propriété EnableDefaultParent la valeur CorporateCategory, vous devez au moins sélectionner Corporate Category dans la liste de types disponible dans la propriété ItemTypes. Ou bien, si la propriété EnableDefaultParent a pour valeur un des dossiers prédéfinis comme UserRootFolder, vous devez affecter à la propriété ItemTypes les valeurs Folder et Favorites Folder.

Si vous souhaitez définir un élément de niveau supérieur personnalisé plutôt que d'utiliser une valeur prédéfinie, affectez à la propriété DefaultRoot du contrôle ItemsGrid ou Path la valeur Custom, puis spécifiez la propriété RootItemID.

Astuce :    Si vous souhaitez définir le dossier qui est affiché à l'origine, mais qu'il n'est pas nécessaire de limiter les éléments auxquels l'utilisateur peut accéder, il vous suffit de définir la propriété parentItemId du bean EnterpriseItems.