{"action":"created","comment":{"url":"https://api.github.com/repos/orocrm/documentation/pulls/comments/55776348","id":55776348,"diff_hunk":"@@ -0,0 +1,198 @@\n+.. _user-guide-getting-started-company-structure:\n+\n+Company Structure and Organization Selector\n+===========================================\n+\n+Understanding the Company Structure\n+-----------------------------------\n+\n+Each enterprise is structured in a meaningful way. Big enterprises usually have several branches/offices, each of which \n+may be divided into several major divisions comprised of departments that may be comprised of several functional groups, \n+etc. Even small companies organize their workforce into teams.\n+\n+For example, a telecommunication service provider might have several subsidiaries, e.g. in each of the states. The \n+Californian subsidiary may have two offices - Western and Eastern. In each of the offices there are unites working at \n+different directions:\n+\n+\n+* CaliforniaTelecom\n+\n+  * Western California\n+ \n+    * Western California Stationary Phones\n+  \n+    * Western California Mobiles\n+\n+    * Western California TV\n+\n+    * Western California Internet\n+   \n+  * Eastern California\n+ \n+    * Eastern California Stationary Phones\n+   \n+    * Eastern California Mobiles\n+\n+    * Eastern California TV\n+\n+    * Eastern California Internet\n+\n+Each unit in its turn may be divided in teams, for example:\n+ \n+- Eastern California Internet Office Employees\n+- Eastern California Internet Field Workers\n+- Eastern California Internet Freelance Employees\n+\n+\n+The corporate structure is essential, as it defines the scope of the user’s tasks and and available resources. As a \n+business application, OroCRM provides tools to reflect the corporate structure normally.\n+\n+\n+How Corporate Structure is Reflected in OroCRM\n+----------------------------------------------\n+\n+Business units\n+^^^^^^^^^^^^^^\n+\n+In OroCRM every business, division, or team of any kind may be represented by a business unit. The units can be \n+hierarchically organized in a tree-like structure that reflects the actual subordination of the organization.\n+ \n+So, for example, to represent the hierarchy of the above-mentioned telecom in California, we need to create two business \n+units that correspond to the two offices *\"Western California\"* and *\"Eastern California\"*. Each of them will have child \n+business units that represent the directions: *\"Stationary Phones\"*, *\"Mobiles\"*, etc. Each of these child units, in its \n+turn, will be a parent unit to other business units that correspond to the teams.\n+\n+For example:\n+\n+* Eastern California business unit has a child business unit:\n+\n+  * Eastern California Stationary Phones that has child business units:\n+\n+    * Eastern California Stationary Phone Office Employees\n+  \n+    * Eastern California Stationary Phone Field Workers\n+  \n+    * Eastern California Stationary Phone Freelance Employees\n+\n+So, the system administrator usually creates such reflection of the organization’s hierarchy and defines what users \n+belong to them. *This affects the access and permissions granted to the users within the company*.\n+ \n+For example, users assigned directly to the  Eastern California business unit may see all the orders, requests and \n+sales reported by any of the users of the unit and its child unit. Thus an office manager will see all the accounts \n+created in any direction and by any kind of employee.\n+\n+Users assigned to the child units may see only the accounts created within their unit - so, employees of the Stationary \n+Phone department will only see the items reported by members of their department, and won’t see items reported by \n+representatives of the Mobiles’ department. \n+\n+In the same manner, the access may be limited for users assigned to the child-units of the next level, e.g. freelancer’s \n+may only see the information that has been reported or assigned to them directly, and office employees will see \n+information reported by any of their co-workers.\n+\n+This will protect information on one hand, and help to protect users from being overwhelmed with non-relevant \n+information. \n+\n+Please refer to the :ref:`Access and permissions guide <user-guide-user-management-permissions-basic>` for more details.\n+\n+.. hint::\n+\n+    By the user name, you can see the name of the business unit, that *\"owns\"* the user. This is also defined by the \n+    system administrator and serves as additional information for other users.\n+\n+**At least one business unit must be defined in the system.**\n+\n+Organizations\n+^^^^^^^^^^^^^\n+\n+In addition to the business unit hierarchy, OroCRM Enterprise Edition provides the ability to create several \n+Organizations. Organizations may be described as large business units, independent enough in their operations to \n+require a high degree of separation and customization. Organizations provide a much higher degree of separation - every \n+organization in OroCRM is basically a business in its own right. They might have their own hierarchies of business \n+units, use different languages and locales, or even the most common entities such as Contacts or Accounts may differ \n+from one organization to another. Data records that exists in one organization are normally not available to another.\n+\n+Usually, organizations are need when their real-world counterparts have their own P&L reports and balance sheets. For \n+the telecom in the example above, different organization could represent offices in each of the states. Another good \n+example for several organizations would be a franchisor that has several franchisees - the best way to represent each \n+of them in OroCRM is a separate organization. Even a freelance entrepreneur working with several different businesses \n+from his computer will benefit using a separate organization to represent each of them in OroCRM.\n+\n+Subject to the work done in the company, some users may have access to several organizations \n+(work with multiple organization) or to all records across all organizations that are available to them \n+(work from a system organization). This is described below. \n+\n+    \n+.. _user-guide-getting-started-change-organization:\n+\n+Work with Multiple Organizations\n+--------------------------------\n+\n+In many cases a user has access to a single organization. A sales representative in the U.S. office is likely to have no \n+access to the company’s French division.\n+\n+However, users can be assigned to multiple organizations just as they can be assigned to multiple business units and \n+will get access to the records in different organizations. For example, if you are working at the worldwide help desk \n+of a multinational organization, you should be able to access customer records in all the organization within your \n+company in order to open cases based on the customer requests. Similarly, if you are the CEO of a big enterprise \n+comprised of multiple independent divisions, you would like to have access to every one of them in order to check their \n+performance.\n+\n+As organizations are often much bigger and more separated than business units, the user will have to switch to the \n+necessary organization to work with data in each one of them.\n+\n+\n+Switching Between Organizations\n+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^\n+\n+The name of an organization you are currently working with is displayed in the top left corner of the screen. If you \n+have access to multiple organizations, upon your first login you will see a note with your current organization. Three \n+dots to the left are the organization selector.\n+\n+|\n+\n+.. image:: ./img/multi_org/multi_org_select.png\n+\n+|\n+\n+Click the selector, to see a list of organizations you have access to. Your current organization will be displayed in \n+bold. If a System organization exists, it will be shown at the top of the list and shifted left\n+\n+|\n+\n+.. image:: ./img/multi_org/multi_org_choice.png\n+\n+|\n+\n+To switch to another organization, click its name in the list.\n+\n+\n+Work with a System Organization\n+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^\n+\n+A System Organization provides users with simultaneous access to all the records of all the organizations they are \n+assigned to. There cannot be more than one system organization in OroCRM. ","path":"user_guide/intro_company_structure_org_selector.rst","position":173,"original_position":173,"commit_id":"b3a00f84fce9ad2d9b87741cee3edb01abe0aa56","original_commit_id":"160ce074ab54d7bf4ae793508711806c12140c9f","user":{"login":"dfolgeryoung","id":17605465,"avatar_url":"https://avatars.githubusercontent.com/u/17605465?v=3","gravatar_id":"","url":"https://api.github.com/users/dfolgeryoung","html_url":"https://github.com/dfolgeryoung","followers_url":"https://api.github.com/users/dfolgeryoung/followers","following_url":"https://api.github.com/users/dfolgeryoung/following{/other_user}","gists_url":"https://api.github.com/users/dfolgeryoung/gists{/gist_id}","starred_url":"https://api.github.com/users/dfolgeryoung/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/dfolgeryoung/subscriptions","organizations_url":"https://api.github.com/users/dfolgeryoung/orgs","repos_url":"https://api.github.com/users/dfolgeryoung/repos","events_url":"https://api.github.com/users/dfolgeryoung/events{/privacy}","received_events_url":"https://api.github.com/users/dfolgeryoung/received_events","type":"User","site_admin":false},"body":"Edit: A system organization provides users with simultaneous access to all the records of all the organizations that they are assigned to. There cannot be more than one system organization in OroCRM. ","created_at":"2016-03-11T01:04:47Z","updated_at":"2016-03-11T01:04:47Z","html_url":"https://github.com/orocrm/documentation/pull/198#discussion_r55776348","pull_request_url":"https://api.github.com/repos/orocrm/documentation/pulls/198","_links":{"self":{"href":"https://api.github.com/repos/orocrm/documentation/pulls/comments/55776348"},"html":{"href":"https://github.com/orocrm/documentation/pull/198#discussion_r55776348"},"pull_request":{"href":"https://api.github.com/repos/orocrm/documentation/pulls/198"}}},"pull_request":{"url":"https://api.github.com/repos/orocrm/documentation/pulls/198","id":60567685,"html_url":"https://github.com/orocrm/documentation/pull/198","diff_url":"https://github.com/orocrm/documentation/pull/198.diff","patch_url":"https://github.com/orocrm/documentation/pull/198.patch","issue_url":"https://api.github.com/repos/orocrm/documentation/issues/198","number":198,"state":"open","locked":false,"title":"getting started and data management sections updated","user":{"login":"nnenasheva","id":9048914,"avatar_url":"https://avatars.githubusercontent.com/u/9048914?v=3","gravatar_id":"","url":"https://api.github.com/users/nnenasheva","html_url":"https://github.com/nnenasheva","followers_url":"https://api.github.com/users/nnenasheva/followers","following_url":"https://api.github.com/users/nnenasheva/following{/other_user}","gists_url":"https://api.github.com/users/nnenasheva/gists{/gist_id}","starred_url":"https://api.github.com/users/nnenasheva/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/nnenasheva/subscriptions","organizations_url":"https://api.github.com/users/nnenasheva/orgs","repos_url":"https://api.github.com/users/nnenasheva/repos","events_url":"https://api.github.com/users/nnenasheva/events{/privacy}","received_events_url":"https://api.github.com/users/nnenasheva/received_events","type":"User","site_admin":false},"body":"along with that  index updated to correspond to getting started, integrations moved to the admin section","created_at":"2016-02-24T19:52:42Z","updated_at":"2016-03-11T01:04:47Z","closed_at":null,"merged_at":null,"merge_commit_sha":"1b26e223dea2229c7b44b9ccbc9049e1e874c4fc","assignee":null,"milestone":null,"commits_url":"https://api.github.com/repos/orocrm/documentation/pulls/198/commits","review_comments_url":"https://api.github.com/repos/orocrm/documentation/pulls/198/comments","review_comment_url":"https://api.github.com/repos/orocrm/documentation/pulls/comments{/number}","comments_url":"https://api.github.com/repos/orocrm/documentation/issues/198/comments","statuses_url":"https://api.github.com/repos/orocrm/documentation/statuses/b3a00f84fce9ad2d9b87741cee3edb01abe0aa56","head":{"label":"nnenasheva:get_started_fin","ref":"get_started_fin","sha":"b3a00f84fce9ad2d9b87741cee3edb01abe0aa56","user":{"login":"nnenasheva","id":9048914,"avatar_url":"https://avatars.githubusercontent.com/u/9048914?v=3","gravatar_id":"","url":"https://api.github.com/users/nnenasheva","html_url":"https://github.com/nnenasheva","followers_url":"https://api.github.com/users/nnenasheva/followers","following_url":"https://api.github.com/users/nnenasheva/following{/other_user}","gists_url":"https://api.github.com/users/nnenasheva/gists{/gist_id}","starred_url":"https://api.github.com/users/nnenasheva/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/nnenasheva/subscriptions","organizations_url":"https://api.github.com/users/nnenasheva/orgs","repos_url":"https://api.github.com/users/nnenasheva/repos","events_url":"https://api.github.com/users/nnenasheva/events{/privacy}","received_events_url":"https://api.github.com/users/nnenasheva/received_events","type":"User","site_admin":false},"repo":{"id":40135021,"name":"documentation","full_name":"nnenasheva/documentation","owner":{"login":"nnenasheva","id":9048914,"avatar_url":"https://avatars.githubusercontent.com/u/9048914?v=3","gravatar_id":"","url":"https://api.github.com/users/nnenasheva","html_url":"https://github.com/nnenasheva","followers_url":"https://api.github.com/users/nnenasheva/followers","following_url":"https://api.github.com/users/nnenasheva/following{/other_user}","gists_url":"https://api.github.com/users/nnenasheva/gists{/gist_id}","starred_url":"https://api.github.com/users/nnenasheva/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/nnenasheva/subscriptions","organizations_url":"https://api.github.com/users/nnenasheva/orgs","repos_url":"https://api.github.com/users/nnenasheva/repos","events_url":"https://api.github.com/users/nnenasheva/events{/privacy}","received_events_url":"https://api.github.com/users/nnenasheva/received_events","type":"User","site_admin":false},"private":false,"html_url":"https://github.com/nnenasheva/documentation","description":"The Oro Platform and OroCRM Documentation","fork":true,"url":"https://api.github.com/repos/nnenasheva/documentation","forks_url":"https://api.github.com/repos/nnenasheva/documentation/forks","keys_url":"https://api.github.com/repos/nnenasheva/documentation/keys{/key_id}","collaborators_url":"https://api.github.com/repos/nnenasheva/documentation/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/nnenasheva/documentation/teams","hooks_url":"https://api.github.com/repos/nnenasheva/documentation/hooks","issue_events_url":"https://api.github.com/repos/nnenasheva/documentation/issues/events{/number}","events_url":"https://api.github.com/repos/nnenasheva/documentation/events","assignees_url":"https://api.github.com/repos/nnenasheva/documentation/assignees{/user}","branches_url":"https://api.github.com/repos/nnenasheva/documentation/branches{/branch}","tags_url":"https://api.github.com/repos/nnenasheva/documentation/tags","blobs_url":"https://api.github.com/repos/nnenasheva/documentation/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/nnenasheva/documentation/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/nnenasheva/documentation/git/refs{/sha}","trees_url":"https://api.github.com/repos/nnenasheva/documentation/git/trees{/sha}","statuses_url":"https://api.github.com/repos/nnenasheva/documentation/statuses/{sha}","languages_url":"https://api.github.com/repos/nnenasheva/documentation/languages","stargazers_url":"https://api.github.com/repos/nnenasheva/documentation/stargazers","contributors_url":"https://api.github.com/repos/nnenasheva/documentation/contributors","subscribers_url":"https://api.github.com/repos/nnenasheva/documentation/subscribers","subscription_url":"https://api.github.com/repos/nnenasheva/documentation/subscription","commits_url":"https://api.github.com/repos/nnenasheva/documentation/commits{/sha}","git_commits_url":"https://api.github.com/repos/nnenasheva/documentation/git/commits{/sha}","comments_url":"https://api.github.com/repos/nnenasheva/documentation/comments{/number}","issue_comment_url":"https://api.github.com/repos/nnenasheva/documentation/issues/comments{/number}","contents_url":"https://api.github.com/repos/nnenasheva/documentation/contents/{+path}","compare_url":"https://api.github.com/repos/nnenasheva/documentation/compare/{base}...{head}","merges_url":"https://api.github.com/repos/nnenasheva/documentation/merges","archive_url":"https://api.github.com/repos/nnenasheva/documentation/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/nnenasheva/documentation/downloads","issues_url":"https://api.github.com/repos/nnenasheva/documentation/issues{/number}","pulls_url":"https://api.github.com/repos/nnenasheva/documentation/pulls{/number}","milestones_url":"https://api.github.com/repos/nnenasheva/documentation/milestones{/number}","notifications_url":"https://api.github.com/repos/nnenasheva/documentation/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/nnenasheva/documentation/labels{/name}","releases_url":"https://api.github.com/repos/nnenasheva/documentation/releases{/id}","deployments_url":"https://api.github.com/repos/nnenasheva/documentation/deployments","created_at":"2015-08-03T16:18:24Z","updated_at":"2016-02-22T12:57:40Z","pushed_at":"2016-03-10T15:11:12Z","git_url":"git://github.com/nnenasheva/documentation.git","ssh_url":"git@github.com:nnenasheva/documentation.git","clone_url":"https://github.com/nnenasheva/documentation.git","svn_url":"https://github.com/nnenasheva/documentation","homepage":"","size":26964,"stargazers_count":0,"watchers_count":0,"language":"Python","has_issues":false,"has_downloads":true,"has_wiki":true,"has_pages":false,"forks_count":0,"mirror_url":null,"open_issues_count":0,"forks":0,"open_issues":0,"watchers":0,"default_branch":"master"}},"base":{"label":"orocrm:master","ref":"master","sha":"ce4d1466ddcb8d4a5c9b5f9bf791eb25343d0b90","user":{"login":"orocrm","id":4165718,"avatar_url":"https://avatars.githubusercontent.com/u/4165718?v=3","gravatar_id":"","url":"https://api.github.com/users/orocrm","html_url":"https://github.com/orocrm","followers_url":"https://api.github.com/users/orocrm/followers","following_url":"https://api.github.com/users/orocrm/following{/other_user}","gists_url":"https://api.github.com/users/orocrm/gists{/gist_id}","starred_url":"https://api.github.com/users/orocrm/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/orocrm/subscriptions","organizations_url":"https://api.github.com/users/orocrm/orgs","repos_url":"https://api.github.com/users/orocrm/repos","events_url":"https://api.github.com/users/orocrm/events{/privacy}","received_events_url":"https://api.github.com/users/orocrm/received_events","type":"Organization","site_admin":false},"repo":{"id":16752895,"name":"documentation","full_name":"orocrm/documentation","owner":{"login":"orocrm","id":4165718,"avatar_url":"https://avatars.githubusercontent.com/u/4165718?v=3","gravatar_id":"","url":"https://api.github.com/users/orocrm","html_url":"https://github.com/orocrm","followers_url":"https://api.github.com/users/orocrm/followers","following_url":"https://api.github.com/users/orocrm/following{/other_user}","gists_url":"https://api.github.com/users/orocrm/gists{/gist_id}","starred_url":"https://api.github.com/users/orocrm/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/orocrm/subscriptions","organizations_url":"https://api.github.com/users/orocrm/orgs","repos_url":"https://api.github.com/users/orocrm/repos","events_url":"https://api.github.com/users/orocrm/events{/privacy}","received_events_url":"https://api.github.com/users/orocrm/received_events","type":"Organization","site_admin":false},"private":false,"html_url":"https://github.com/orocrm/documentation","description":"The Oro Platform and OroCRM Documentation","fork":false,"url":"https://api.github.com/repos/orocrm/documentation","forks_url":"https://api.github.com/repos/orocrm/documentation/forks","keys_url":"https://api.github.com/repos/orocrm/documentation/keys{/key_id}","collaborators_url":"https://api.github.com/repos/orocrm/documentation/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/orocrm/documentation/teams","hooks_url":"https://api.github.com/repos/orocrm/documentation/hooks","issue_events_url":"https://api.github.com/repos/orocrm/documentation/issues/events{/number}","events_url":"https://api.github.com/repos/orocrm/documentation/events","assignees_url":"https://api.github.com/repos/orocrm/documentation/assignees{/user}","branches_url":"https://api.github.com/repos/orocrm/documentation/branches{/branch}","tags_url":"https://api.github.com/repos/orocrm/documentation/tags","blobs_url":"https://api.github.com/repos/orocrm/documentation/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/orocrm/documentation/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/orocrm/documentation/git/refs{/sha}","trees_url":"https://api.github.com/repos/orocrm/documentation/git/trees{/sha}","statuses_url":"https://api.github.com/repos/orocrm/documentation/statuses/{sha}","languages_url":"https://api.github.com/repos/orocrm/documentation/languages","stargazers_url":"https://api.github.com/repos/orocrm/documentation/stargazers","contributors_url":"https://api.github.com/repos/orocrm/documentation/contributors","subscribers_url":"https://api.github.com/repos/orocrm/documentation/subscribers","subscription_url":"https://api.github.com/repos/orocrm/documentation/subscription","commits_url":"https://api.github.com/repos/orocrm/documentation/commits{/sha}","git_commits_url":"https://api.github.com/repos/orocrm/documentation/git/commits{/sha}","comments_url":"https://api.github.com/repos/orocrm/documentation/comments{/number}","issue_comment_url":"https://api.github.com/repos/orocrm/documentation/issues/comments{/number}","contents_url":"https://api.github.com/repos/orocrm/documentation/contents/{+path}","compare_url":"https://api.github.com/repos/orocrm/documentation/compare/{base}...{head}","merges_url":"https://api.github.com/repos/orocrm/documentation/merges","archive_url":"https://api.github.com/repos/orocrm/documentation/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/orocrm/documentation/downloads","issues_url":"https://api.github.com/repos/orocrm/documentation/issues{/number}","pulls_url":"https://api.github.com/repos/orocrm/documentation/pulls{/number}","milestones_url":"https://api.github.com/repos/orocrm/documentation/milestones{/number}","notifications_url":"https://api.github.com/repos/orocrm/documentation/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/orocrm/documentation/labels{/name}","releases_url":"https://api.github.com/repos/orocrm/documentation/releases{/id}","deployments_url":"https://api.github.com/repos/orocrm/documentation/deployments","created_at":"2014-02-12T02:08:30Z","updated_at":"2016-03-07T09:27:53Z","pushed_at":"2016-03-10T15:11:13Z","git_url":"git://github.com/orocrm/documentation.git","ssh_url":"git@github.com:orocrm/documentation.git","clone_url":"https://github.com/orocrm/documentation.git","svn_url":"https://github.com/orocrm/documentation","homepage":"","size":28532,"stargazers_count":24,"watchers_count":24,"language":"Python","has_issues":true,"has_downloads":true,"has_wiki":true,"has_pages":false,"forks_count":36,"mirror_url":null,"open_issues_count":8,"forks":36,"open_issues":8,"watchers":24,"default_branch":"master"}},"_links":{"self":{"href":"https://api.github.com/repos/orocrm/documentation/pulls/198"},"html":{"href":"https://github.com/orocrm/documentation/pull/198"},"issue":{"href":"https://api.github.com/repos/orocrm/documentation/issues/198"},"comments":{"href":"https://api.github.com/repos/orocrm/documentation/issues/198/comments"},"review_comments":{"href":"https://api.github.com/repos/orocrm/documentation/pulls/198/comments"},"review_comment":{"href":"https://api.github.com/repos/orocrm/documentation/pulls/comments{/number}"},"commits":{"href":"https://api.github.com/repos/orocrm/documentation/pulls/198/commits"},"statuses":{"href":"https://api.github.com/repos/orocrm/documentation/statuses/b3a00f84fce9ad2d9b87741cee3edb01abe0aa56"}}}}