<?xml version="1.0" encoding="UTF-8"?>
<!--Arbortext, Inc., 1988-2015, v.4002-->
<!DOCTYPE pubsConcept PUBLIC "-//PTC//DTD PUBS DITA Concept//EN"
 "pubsConcept.dtd">
<?Pub UDT template _font?>
<?Pub UDT _bookmark _target?>
<?Pub Inc?>
<pubsConcept id="_WF_projects_setting_visibility_61931" xml:lang="en"
xmlns:import="http://www.oberontech.com/import" import:style="0_Topic"
import:mapobject="1Heading_to_conceptH1">
<title>Setting Workflow and Document Project Visibility</title><?Pub
Caret -3?>
<prolog>
<metadata><keywords>
<indexterm>project<indexterm>permission</indexterm></indexterm>
<indexterm>user<indexterm>group<indexterm>project permission</indexterm
></indexterm></indexterm>
<indexterm>group<indexterm>project permission</indexterm></indexterm>
</keywords></metadata>
</prolog>
<pubsConbody>
<p>Project visibility allows you to control access to information
throughout your organization. Through <ph
conkeyref="text_variables/ProdName01"></ph>, you can manage workflow
and document projects that reflect your product development. You can
use project visibility to ensure that sensitive information from one
group is not viewed or modified by another group. All items and e-mail
notification are subject to project visibility rules.</p>
<p>When you create a project, you can select which user groups can
see the project and all items assigned to the project. You can also
define which user groups can see all projects in the database and
which ones are restricted to see only certain projects.</p>
<p>If a user is not a member of at least one group allowed to view
the project, that user cannot view any items belonging to the project
and its subprojects. For users to see a given subproject, they must
have permission to see the associated parent project. Not all user
groups with visibility to the project must see all the subprojects
under the project. You can restrict the subproject visibility to fewer
groups than you have chosen to be able to view the project.</p>
<p>Based on project visibility, users are allowed to query the database
only for items within projects that are visible to them. Projects
not visible to users are not displayed in the query results. If users
try to view an item within a project that is not visible to them,
an error message displays.</p>
<p>If an item in one project is related to an item in a project not
visible to the user, only the item ID of the related item displays
in the Relationship view. In the History view, the user can see only
that an edit occurred (<uicontrol import:style="Literal">Modified
by <varname>user</varname> on <varname>modified date</varname></uicontrol
>). Users cannot see if the edit was an addition or removal of a related
item.</p>
<p>If an item previously invisible to users is reassigned to a project
that is visible to users, they cannot see the previous project name
in the History view. Instead, a symbolic <codeph import:style="Literal"
>Restricted Project</codeph> value displays.</p>
<section id="_WF_projects_setting_visibility_98720"
import:style="0_TopicSub2"><title>Example</title><p>Look at an example
of three users: one is a member of the Word Processor R&amp;D group,
the second one is a member of the Spreadsheet R&amp;D group, and the
third one is a member of the Product Managers group. The assigned
workflow and document project permissions are recursive and apply
to subprojects as follows:</p><p><image href="../images/WF_project_example.png">
</image></p><p>According to project permissions, the member of the
Word Processor R&amp;D group can see only the Word Processor project
and its subprojects (Text Engine, Import &amp; Export, and PrintEngine),
and all items associated with this project.</p><p>According to project
permissions, the member of the Spreadsheet R&amp;D group can see only
the Spreadsheet project and its subprojects (Toolbars &amp; Menus,
Formula Engine, and Chart Engine), and all items associated with this
project.</p><p>According to project permissions, the member of the
Product Managers group can see both the Word Processor project, the
Spreadsheet project, their subprojects, and all items associated with
both projects.</p></section>
<section id="_WF_projects_setting_visibility_34832"
import:style="0_TopicSub2"><title>Key Considerations</title><ul>
<li><p><ph conkeyref="text_variables/ProdName01"></ph> project administrators
can only edit and view the workflow and document projects they are
assigned to.</p></li>
<li><p>To display entries in user and group fields when submitting
items, at least one workflow and document project must be shared with
each available group, and the users and groups must have visibility
into that project.</p></li>
<li><p>When creating a new project as a root project, the <uicontrol
import:style="GUI">Inherit Permissions from Parent</uicontrol> option
is unavailable. If you are creating a new project as a child project,
you can select the <uicontrol import:style="GUI">Inherit Permissions
from Parent</uicontrol> option, if you want the permissions of the
parent project to apply to your new project.</p></li>
<li><p>Items that are not part of any project (the project field is
blank) are visible to all users. To enforce project permissions, you
must make the project field mandatory.</p></li>
<li><p>If a user is not a member of at least one group allowed to
view the project, that user cannot view any items belonging to the
project and its subprojects.</p></li>
<li><p>Based on project visibility, users are allowed to query the
database only for items within projects that are visible to them.</p
></li>
<li><p>When creating a project, you can also designate users or groups
as project administrators for that project.</p></li>
</ul></section>
</pubsConbody>
</pubsConcept>
