Oracle® Fusion Middleware Administrator's Guide for Oracle WebCenter Interaction 10g Release 3 (10.3.0.1) Part Number E14107-02 |
|
|
View PDF |
The Administrative Objects Directory allows you to create and manage administrative objects and access portal utilities. It displays all objects to which you have at least Read access.
To display the Administrative Objects Directory click Administration.
Note:
To access the Administrative Objects Directory you must have the Access Administration activity right.To view an administrative object, click its name. For details on viewing objects, see Viewing Objects.
To search for objects, use one of the following methods:
To create an object, open the folder in which you want to store the object, then, in the Create Object list, select the type of object you want to create.
The list displays only those objects you have permission to create in the folder you are viewing.
To access portal utilities, in the Select Utility list, select the utility you want to use.
The list displays only those utilities to which you have access.
To perform actions on the folder you are viewing, use the buttons in the folder toolbar (to the right of the folder title).
For a description of these buttons, see Folder Toolbar.
To perform actions on the objects in the folder, use the buttons in the action toolbar (to the right of the Create Object and Select Utility lists).
For a description of these buttons, see Action Toolbar.
Administrative folders provide a hierarchical structure that make it easy to organize portal objects and manage security.
Note:
You might want to store all of the resources needed by a particular audience of users in the same folder in which you store those users. By securing the folder appropriately and applying experience definition settings to it you can create completely separate and discreet user experiences for each audience of users.To create an administrative folder you must have the following rights and privileges:
Access Administration activity right
Create Admin Folders activity right
At least Edit access to the parent folder (the folder in which you are creating the new folder)
Click Administration.
If necessary, open the folder in which you want to store the new folder.
In the Create Object list, click Administrative Folder.
The Create Administrative Folder dialog box opens.
In the Name box, type a name for the folder.
This name appears in lists of objects from which users will sometimes choose; therefore, the name should clearly convey the purpose of this folder.
In the Description box, type a description for the folder.
This description appears in the Administrative Objects Directory to provide other administrators further details on the purpose of this folder.
Click OK.
You can perform additional tasks when you edit this folder:
To edit an administrative folder you must have at least Edit access to the folder.
Click Administration.
Select the folder you want to edit and click Edit Subfolder.
Perform tasks as necessary on the Experience Definition Settings page:
Perform tasks as necessary on the Properties and Names page:
Perform tasks as necessary on the Security page:
Perform tasks as necessary on the Migration History and Status page:
You can view objects through the Administrative Objects Directory and through some of the portal utilities.
Note:
To view an object you must have the Access Administration activity right and at least Read access to the object.To display the Administrative Objects Directory and access portal utilities, click Administration.
To view the contents of a folder, click its name.
To view all objects of a particular type stored in the folder, click the object type (for example, crawler, portlet, or user). To hide these objects, click the object type again.
To expand all the object types so you can view all objects stored in this folder, click the Expand All icon.
While viewing a subfolder, to navigate up to the parent folder, click Up, or click the parent folder name in folder path.
By default, only the first 50 objects display. To view the next 50 objects, click Next >>, or to view another set of 50 objects, click a number range.
To view default profiles, in the Select Utilities list, select Default Profiles.
You can search for objects in the Administrative Objects Directory.
Click Administration.
Specify your criteria in the Object Search boxes:
To limit your search to particular types of objects (for example, crawler, portlet, or user), in the first list, select the object type.
To limit your search to particular folders, in the second list, choose whether to search all administrative folders, only the folder you are currently viewing, or the folder you are viewing plus its subfolders.
In the text box, type the text you want to search for and click the Search icon.
You can perform an advanced search, using metadata properties and location, to find objects or documents.
In the portal banner or in the Administrative Objects Directory, click Advanced Search.
To search for text in the name or description of an object or document, type the text you want to search for in the Search for text box.
You can use the text search rules.
To search for property values, click Add Criteria, and specify the property criteria in the boxes that appear:
In the first list (property), select the searchable property for which you want to filter the values.
In the second list (operator), select the operator to apply to this condition.
This list will vary depending on the property selected:
For any text property you can search for a value that contains your search string (Contains), or you can search for properties that are blank (Contains No Value).
Note:
To exclude results with particular values, select Contains, then type “not” followed by words that you want to exclude from your search. For example, if you want to search for documents about retirement benefits, excluding pension plans, then type “retirement benefits” in the Search for text box, select Contains from the list, and type “not pension plan” in the text box.For any date property you can search for a value that comes after, comes before, is, or is not the date and time you choose or for a value that occurs in the last number of minutes, hours, days, or weeks that you specify.
For any number property you can search for a value that is greater than, is less than, is, is not, is greater than or equal to, or is less than or equal to the number you enter in the text box.
In the Value text box, enter the value the property must have, or not have, depending on which operator you selected.
Note:
If you are searching for a text property, you can use the text search rules.To remove a property condition, select the condition and click the Remove icon (next to Add Criteria).
Specify how you want your search criteria handled:
To meet all the conditions you define, select All Criteria.
Selecting All Criteria is equivalent to using AND.
If you want your search results to meet at least one of the conditions you define, select Any Criterion.
Selecting Any Criterion is equivalent to using OR.
To restrict your search to specific Knowledge Directory folders, click Add Document Folder. In the Select folder for search dialog box, select the folders you want to search and click OK.
To restrict your search to specific Administrative Objects Directory folders, click Add Administration Folder. In the Select folder for search dialog box, select the folders you want to search and click OK.
To remove folders from your list, select the folders and click the Remove icon (next to Add Administration Folder).
To select or clear all folder boxes, select or clear the box next to Folder Names.
Specify whether you want to include subfolders.
By default, the portal searches subfolders. To exclude subfolders from your search, clear the box next to Include subfolders.
To specify the number of results to display on a page, in the Results per page list, choose a value.
To restrict your search to a specific language, in the This language only list, choose a language.
To limit your search to specific object types, in the Result Types list, select the object types you want to search.
To select or clear all object type boxes, select or clear the box next to Object Type.
To set all search conditions back to the defaults, click Clear.
To perform your search, click Search.
You can use multiple property criteria to define complex property searches.For example, if you want to find documents published after a certain date by a specific branch of a company, you could set the property criteria to the following values:
First Criterion:
Property = Object Created
Operator = Comes After
Value = December 30, 2003
Your search results would be limited to objects created after December 30, 2003.
Second Criterion:
Property = Company
Operator = Contains
Value = Company A
Your search results would be limited to objects where the company property contains Company A.
Third Criterion:
Property = Address
Operator = Contains
Value = San Francisco
Your search results would be limited to objects that contain San Francisco in the address.
You would also want to limit your Result Types to Documents, so that only documents were returned in your results.
Many administrative tasks start with opening an object editor. You open an editor by creating a new object or editing an existing object.
Note:
To edit an object you must have the Access Administration activity right, and you must have at least Edit access to the object.To create a new object see Creating an Object.
To edit an object from Administration see Editing an Object from Administration.
To edit an object from the search results page perform a search and click the name of the object you want to edit.
To edit a community while viewing it, in the My Communities menu, select the community you wan to edit, then click Edit Page.
You can create objects such as folders, portlets, and users in the Administrative Objects Directory.
Note:
To create an object you must have the Access Administration activity right and the activity right associated with creating that type of object. You must also have at least Edit access to the parent folder (the folder that will store the object).Click Administration.
If necessary, open the folder in which you want to store the object.
You can create folders in the root of the Administrative Objects Directory, but other objects must be created in a folder.
Note:
You can create default profiles only from the Default Profiles Utility: in the Select Utilities list, select Default Profiles.In the Create Object list, select the type of object you want to create.
The list displays only those objects you have permission to create in the folder.
Depending on the type of object you are creating, either the object editor opens, or a dialog box opens prompting you to choose a content source, template, or web service.
If necessary, select the appropriate content source, template, or web service and click OK.
A remote authentication source, a remote content source, an outgoing federated search, or a profile source requires a web service. A portlet requires a template or web service. A content crawler requires a content source.
The object editor opens.
Complete the editor.
You can edit objects from the Administrative Objects Directory.
Note:
You must have the Access Administration activity right and at least Edit access to the object you want to edit.Click Administration.
Navigate to the object you want to edit.
Open the object editor:
To open the Folder Editor, select the folder, and click Edit Subfolder.
To open the Community Editor, click the community name, and click the Edit Community icon.
To open any other object's editor, click the name of the object.
You can use the buttons in the action toolbar to perform actions on the objects in a folder.
Button | Action |
---|---|
Move an object to a different folder. Select one or more objects and click the Move Folder icon. In the Target Folder dialog box, expand the folders as necessary, select a folder, and click OK. | |
Copy an object to a different folder. Select one or more objects and click the Copy icon. In the Target Folder dialog box, expand the folders as necessary, select a folder, and click OK. | |
Delete an object. Select one or more objects and click the Delete icon. In the confirmation dialog box, click Apply Now. | |
Modify the security settings on one or more objects. Select the objects and click the Security icon. | |
Add one or more portlets or communities to one or more groups. You can use this bulk add operation to add portlets to users' My Pages or subscribe users to communities based on group membership. Select the portlets or communities and click the Bulk Add icon. | |
Marks an object for migration to another portal. Select one or more objects and click Migrate icon. | |
Edit a subfolder. Select a subfolder and click Edit Subfolder.
Note: You can only edit folders to which you have at least Edit access. |
|
Edit the portal layout for guest users and default profiles. Select a guest user or default profile and click Edit Profile Layout to log in as that user and change the user's portal layout.
Note: You see this button only when you are viewing users. |
|
Send an invitation or access a previously generated invitation link. Select the invitation and click Send Invitation.
Note: You see this button only when you are viewing invitations. |
|
Set a job to run one time, immediately, without changing the schedule. Select a job and click Run Once.
Note: You see this button only when you are viewing jobs. |
|
Enable makes a user or web service available for use. Disable makes a user or web service unavailable for use. Select a user or web service and click Enable or Disable.
Note: You see these buttons only when you are viewing users or web services. |
You can add or edit a name and description for an object.
Open the object's editor by creating a new object or editing an existing object.
In the Name box, type a name for this object.
The name should clearly convey what this object is or what it can be used for.
If you are naming an authentication-only authentication source, this name appears in the Authentication Partners list when you create the associated synchronization-only authentication source.
In the Description text box, type a description for this object.
The description should provide additional detail to convey what this object is or what it can be used for.
If you are naming an authentication source that synchronizes users, this description appears in the Authentication Source list when users log in. Users imported from an external source must choose the appropriate authentication source to log in to the portal.
If your portal administrator did not set a mandatory object language, in the Primary Language list, select the language for the name and description you entered.
If your portal administrator did set a mandatory object language, you see the mandatory language instead of a list. You cannot change this setting. The name and description you entered must be in the mandatory language.
If a localized name and description is not available in a user's selected language, the user will see the name and description in the specified primary language.
If you want to add names and descriptions for other languages, see Localizing Object Names and Descriptions.
You can localize object names and descriptions, so that users see the names and descriptions in their chosen language. For example, if you have an object called “Engineering,” you could add “Ingénierie” as the localized entry for French. A user viewing the French user interface would see the Ingénierie as the object name, as well as any other names and descriptions localized into French.
Note:
Open the object's editor by creating a new object or editing an existing object.
Select Supports Localized Names.
The Localized Names and Descriptions section appears.
Add or edit the localized names and descriptions:
To remove existing entries, select the entries you want to remove and click.
To select or clear all entries, select or clear the check box to the left of Name.
To edit an existing entry, click the entry you want to change, then, in the Name and Description dialog box, edit the entry as necessary, and click Finish.
To remove existing entries, select the entries you want to remove and click the Remove icon.
To select or clear all entries, select or clear the check box to the left of Name.
The Properties and Names page displays the top best bet terms set for this object. When users do a top best bet search on these terms, they go directly to this object instead of seeing the normal search results.
To link to the end user view of this object, click the link under URL.
You can use this URL to go directly to a top best bet. This can be useful if you want to direct users to an object or document related to a particular issue, but the object or document changes frequently. For example, you might want to direct customers to your current privacy statement, but you need to keep copies of older privacy statements in your portal for internal reference. You could create a top best bet that points to the current privacy statement and add a link to that top best bet on your customer account page. When your privacy statement is updated, you can change the top best bet without having to change any links you made to the privacy statement.
You can add or edit properties for an object.
Open the object's editor by creating a new object or editing an existing object.
Under Object Properties, change the properties and values:
To add or delete properties for all objects of this type, click Open Properties Map.
This displays the Global Object Property Map.
To enter values for properties, type the value in the box to the right of the property.
Note:
The Object Properties section does not display if you are creating or editing a property.On the Set Job page, you can associate an object with a new or existing job. You run jobs to import users with authentication sources, import content with content crawlers, run external operations, and import user information with profile sources.
Before you can run jobs, you must:
Confirm that the BEA ALI Automation Service is running on the Automation Service machine. If it is not running, start it now, as described in Starting the BEA ALI Automation Service.
Register the Automation Service with the portal, as described in Registering Automation Services.
Assign administrative folders to the registered Automation Services, as described in Registering Job Folders to Run Jobs.
Open the object's editor by creating a new object or editing an existing object.
Click the Set Job page.
Associate the object with one or more jobs:
To run this object with an existing job, click Add Job; then, in the Choose Jobs dialog box, select the jobs you want to add this object to and click OK.
To create a new job to run this object, click Create Job, then, in the Job Editor, schedule your job and click Finish.
To remove a job, select the job and click the Remove icon.
To select or clear all of the job check boxes, select or clear the check box to the left of Job Name.
To edit a job, click the job name.
If you added this object to an existing job, you might want to verify that the job is scheduled to run.
To change the order in which the jobs are sorted, click Job Name.
The owner of an object is displayed on the Set Job page. If you are a portal administrator, you can change the owner.
You might want to change object owner for several reasons:
If the owner is deleted from the portal, you must assign an existing portal user as the object owner before you can run the job.
When a job runs, it might require access to portal objects that the current owner does not have access to. For example, a content crawler needs access to the folders into which it imports content. You might need to change the owner to provide the proper access.
Open the object's editor by creating a new object or editing an existing object.
Click the Set Job page.
To change the owner, click Change Owner; then, in the Choose User dialog box, choose the user whom you want to make the object owner and click OK.
Note:
If you are not a portal administrator, you see the name of the owner, but you cannot change it.By default, a new object inherits the security of the parent folder, but you can override the inherited security.
Note:
You cannot override the inherited security for users; user security is always the same as the folder in which the user is stored. If you do not want a user to be returned in some users' searches, make sure those users are not allowed access to the folder in which the user is stored.Open the object's editor by creating a new object or editing an existing object.
Click the Security page.
Specify which users and groups can access this object and what type of access they have:
To allow additional users or groups access to this object, click Add Users/Groups.
To specify the type of access a user or group has, in the list under the Privilege column, select the access type.
For a description of the available privileges, see About Access Privileges.
Note:
If a user is a member of more than one group included in the list, or if they are included as an individual user and as part of a group, that user gets the highest access available to her for this object. For example, if a user is part of the Everyone group (which has Read access) and the Administrators Group (which has Admin access), that user gets the higher privilege to the community: Admin.To delete a user or group, select the user or group and click the Remove icon.
To select or clear all of the user and group check boxes, select or clear the check box to the left of Users/Groups.
To see what users are included in a group, click the group name.
To change the column used for sorting or to toggle the sort order between ascending and descending, click the column name.
You see an the Sort Ascending icon or the Sort Descending icon to the right of the column name by which the objects are sorted.
You can see if an object was imported from another portal.
Open the object's editor by creating a new object or editing an existing object.
Click the Migration History and Status page.
If this object was imported from another portal, information displays under Import History:
Column | Description |
---|---|
Migration Date | Displays the date the object was copied into this portal. |
Migration Comment | Displays the comment entered by the user who requested migration of the object. |
Source Portal UUID | Displays the unique identifier of the originating portal. |
You can request that an object be added to a migration package to be exported to another portal.
Note:
You must have at least Edit access to the object for which you want to request migration.Search for the object or click Administration and navigate to the object.
Select the object and click the Migrate icon.
To view the status of your migration request, open the object's editor and click the Migration History and Status page. Under Migration Status, you see whether your request is waiting for approval, has been approved, or has been rejected, as well as your comments and any comments from the portal administrator.
When users want an object to be migrated, they submit a migration request. A portal administrator can then approve the request, and the object is added to the migration package.
Open the object's editor by creating a new object or editing an existing object.
Click the Migration History and Status page.
Under Migration Status, you see whether this object has been requested for migration, and, if so, whether it is waiting for approval, has been approved, or has been rejected.
If you are a member of the Administrators group, and you want to add this object to the migration package to be migrated to another portal, select Approve this object for migration.
Note:
Users who are not members of the Administrators group do not see this option.After approving objects for migration, you can use the Migration - Export Utility to create a migration package.
Remote servers group together web services that are installed on the same computer and require the same type of authentication. With a remote server, you enter the base URL and authentication settings just once for multiple web services, and, if you need to move the web services, you just need to change the remote server settings.
To create a remote server you must have the following rights and privileges:
Access Administration activity right
Create Remote Server activity right
At least Edit access to the parent folder (the folder that will store the remote server)
Click Administration.
Open the folder in which you want to store the remote server.
In the Create Object list, click Remote Server.
The Remote Server Editor opens.
On the Main Settings page, complete the following tasks:
Click the Properties and Names page and complete the following tasks:
Naming and Describing an Object
You can instead enter a name and description when you save this remote server.
Localizing the Name and Description for an Object (optional)
Managing Object Properties (optional)
The default security for this remote server is based on the security of the parent folder. You can change the security when you save this remote server (on the Security tab page in the Save As dialog box), or by editing this remote server (on the Security page of the Remote Server Editor).