\\

h1. {color:#003f80}{*}5.1.*{color} {color:#003f80}{*}Create{*}{color} {color:#003f80}{*}an{*}{color} {color:#003f80}{*}organization{*}{color}

\\
What is an organization ? This can be a company, a part of a company, a unit of a company. An organization provides services, human resources (called *person* here), has positions (called *post* here). To create an organization, you have to fill :
\\
• The name of the organization,
\\
• The contact e-mail of the organization,
\\
• The name of the city where the organization is located,
\\
• The name of the country where the organization is located. Optional elements to fill are :
• The legal status of the organization,
\\
• The type of organization (Small Business, etc.),
\\
• The Website of the organization,
\\
• The Mother organization name of the organization (the current new organization can be a part/ an unit of an other organization,
\\
• Concerning the organization's address : the street number, the street name, the zipcode, the state.

!createOrganizationExample.png|thumbnail!


h1. {color:#003f80}{*}5.2.*{color} {color:#003f80}{*}View/edit{*}{color} {color:#003f80}{*}an{*}{color} {color:#003f80}{*}organization{*}{color}

\\
The next screen after creating an organization is the "View/Edit" screen. The screen is set on view mode (default). To edit the data, you have to click on the Edit button.
\\
You can see four tabs :

!organizationTabs.png|thumbnail!
• The Identity Card tab : there you can view the previous data that you have given to register the current organization.
\\
\\ !ViewOrganization.png|thumbnail!\\
• The Other Info tab : here you can view categories and identifiers

!viewOrganizationCateogriesIdentifiers.png|thumbnail!
You can define categories, for example countries where organizations are located. Simply click "add" to define a new category. Some categorization systems comes with default values and descriptions. Others let you define your own values and descriptions. To delete categories, just tick them in the list and click Delete button.

!addOrganizationCategory.png|thumbnail!
UDDI defines a set of identifier systems (DUNS, Thomas Register...) that are international identification systems for organizations. Simply click "add" to define a new identifier for the current organization. You must specify a value and a human readable description for each added identifier. To delete identifiers, just tick them in the list and click Delete button.

!addOrganizationIdentifier.png|thumbnail!\\
• The Organization's posts tab : there you can view the various positions of the organization (e.g.: manager, developer, etc.).
\\
You can also add a position to the list. For this purpose, you can create a new Post (i.e. create a new position, available for all the companies registered on Petals Master into the posts' list), or you can add an existing position, choose via the posts' list.

!organizationPosts.png|thumbnail!
We will see later how to create (see {color:#003f80}Section 5.4, "Create a post"{color}) and add (see {color:#003f80}Section 5.3, "Add posts to an organization"{color}) posts to an organization. Note that if you click on the name of the post in the list, you can see the complete "id card" of this post and edit its information.

!editOrganizationPost.png|thumbnail!\\
• The Organization's persons tab : there you can view the several persons who have a role on the SOA governance into the current organization.
\\
You cannot create a person if there is no post linked (via "create" or "add" actions seen below) to the organization. You need to create a person, who will automatically appear into the list. A person has a firstname, a middlename, a lastname, a post, an e-mail address, a phone number and a localization (where does he/she work ?).

!organizationPerson.png|thumbnail!
We will see later how to create a person (see {color:#003f80}Section{color} {color:#003f80}5.7,{color} {color:#003f80}"Create{color} {color:#003f80}a{color} {color:#003f80}person"{color}). Note that if you click on the name of a person in the list, the complete data about him/her appears, and you can edit it.
!createOrganizationPerson.png|thumbnail!


h1. {color:#003f80}{*}5.3.*{color} {color:#003f80}{*}Add{*}{color} {color:#003f80}{*}posts{*}{color} {color:#003f80}{*}to{*}{color} {color:#003f80}{*}an{*}{color} {color:#003f80}{*}organization{*}{color}

\\
Previously, we have seen that an organization owns several posts. A post can be also linked to many companies (ex : "HR Manager" is a position owned by many companies). So, you can add to Company B a post previously created for Company A (this post was automatically added to Company A). You don't need to duplicate this post to add it to Company B.
\\
Come back on the View/Edit form of the organization. We have the following screen : !organizationPosts.png|thumbnail!\\
Click on the Add Post Button. Now you see a list of posts : !addOrganizationPost.png|thumbnail!\\
A multiple selection is allowed (by pressing _CTRL_ while clicking on the name of the posts you want to add to the current organization). After validating your choice, you automatically go back to the list of posts.
\\
Please note that the posts list to add is updated after each adding of post. As a consequence, an added post won't appear in the list so you cannot add twice the same post (avoiding double data).
\\

\\
If there is no post matching the position you want to add to the organization, you have to create it. Go back on the _Organization's post tab_. Click on the _Create Post_ button : you are now on a form to create a post. This post will be automatically added to the current organization and will be also available into the list of available posts to add of the other organizations.
\\
To create a post, you have to fill :
\\
• The name of the post (ex: Developer),
\\
• The nature/type of the post (ex: IT),
\\
• The description of the post (a brief description that underlines the skills of the post). !createOrganizationPost.png|thumbnail!

h1. {color:#003f80}{*}5.5.*{color} {color:#003f80}{*}View/edit{*}{color} {color:#003f80}{*}a{*}{color} {color:#003f80}{*}post{*}{color}


\\
When you click on a post into the list of posts, you can see its whole information and edit (click on the _Edit button_ to change data). !editOrganizationPost.png|thumbnail!


h1. {color:#003f80}{*}5.6.*{color} {color:#003f80}{*}Delete{*}{color} {color:#003f80}{*}a{*}{color} {color:#003f80}{*}post{*}{color}

\\

• The title of the person,
\\
• The first name of the person,
\\
• The last name of the person,
\\
• The Email address of the person,
\\
• The post of the person. Optional fields to fill are :
• The middle name of the person,
\\
• The phone number of the person,
\\

\\
To delete a person from the list of persons of an organization, you have only to click on the _Delete_ _link_ at the right side of the array. A message box asks for confirmation of the deletion of the person (the person is definitively deleted from the database, you cannot undo this action).
\\

h1. {color:#003f80}{*}5.10.*{color} {color:#003f80}{*}How{*}{color} {color:#003f80}{*}does{*}{color} {color:#003f80}{*}the{*}{color} {color:#003f80}{*}search{*}{color} {color:#003f80}{*}engine{*}{color} {color:#003f80}{*}work{*}{color} {color:#003f80}*?*{color}

\\
Before presenting the search forms, have a look on the Petals Master search engine.
\\
The search engine is based on the logical expression *AND*. e.g., you are searching a company located in _Villepreux_, whose name is _Lacoera_. And, you are making a search on two fields : the organization's name and the organization's city. The search engine will return all the results that contain _Lacoera_ into the _name field_ and/or the _city field_ *AND* that contain _Villepreux_ into the _name field_ and/or the _city field_.
\\
You can use wildcards in the keywords :
\\
• To perform a single character wildcard search use the "?" symbol. To search for "text" or "test" you can use the search:
te?t
\\
\\
\\
• To perform a multiple character wildcard search use the "*" symbol. To search for test, tests or tester, you can use the search: tes*
\\
• To perform a fuzzy search use the tilde, "~", symbol at the end of a Single word Term. For example to search for a term similar in spelling to "roam" use the fuzzy search roam~. This search will find terms like foam and roams.
\\

\\
To access the post data, click on its name : the view/edit form appears.
\\
To totaly remove a post from the Petals Master database, just click on the delete link. Deletion is allowed only if the post isn't linked to persons or organizations.
\\
{color:#cc0000}{*}Caution{*}{color}\\
be careful, it is different from the previously described remove method that only unlink post from an organization
\\
\\
\\