\\

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}

\\

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).
\\
When the list is empty, the _Add button_ is disabled (it's time to think about creating new posts \!).
\\

h1. {color:#003f80}{*}5.4.*{color} {color:#003f80}{*}Create{*}{color} {color:#003f80}{*}a{*}{color} {color:#003f80}{*}post{*}{color}

\\
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),
\\

\\
To delete a post from the list of posts of an organization, you have only to click on the _Delete_ _link_ at the right side of the array. A message box asks you to confirm the deletion of the post s(the post is not deleted from the database, only the link between the post and the current organization is broken). The deleted post is now available into the choice list of the Add post form... so you can add it again \!
{warning}If a post is used by a person in the current company, the Delete link is disabled. Only a non-used post can be deleted \! {warning}

h1. {color:#003f80}{*}5.7.*{color} {color:#003f80}{*}Create{*}{color} {color:#003f80}{*}a{*}{color} {color:#003f80}{*}person{*}{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 escape special characters like *+* *\-* *&&* *\|\|* *\!* *(* *)* *\{* *\}* *\[* *\]* *^* *"* *~* \**\* \*?* *:* *\* use the \*\* before the character. For example to search for \*(test):toto* use the query: *(test)\:toto*
\\

{note}Don't escape special caracters in your key words if they are URIs like service fullnames (\{http://
www.foo.net\}FooBar).{note}

h1. {color:#003f80}{*}5.11.*{color} {color:#003f80}{*}Search{*}{color} {color:#003f80}{*}organizations{*}{color}