Before you can start using Cloud Service Management (CSM), you will need to create data in the application which is specific to your business. How much and what kind of data will depend on your business. This section will cover common data that is loaded, ways to load certain data, and any security or workflow features that interact or rely on it.
...
- Mapping CSM Organizations: CSM organizations should map to how your organization is constructed. You will want to understand how your business sees tickets and what data, if any, is needed for reporting.
- Logos: Logos can be associated with all levels of organization. When a logo is associated with an organization, the logged in user will see that logo when they are logged into CSM. Contacts can be associated with multiple organizations, but the Logo presented will be the Primary Organization's logo. If you create a child organization, it will automatically receive its parent logo. Click here <<change the link to Serviceaide>> for for instruction on updating organization logos.
- Organization Based Access Control: Enable organization based access permissions on service desk tickets and Configuration Items that the agents can operate upon.
- Advanced Reports: Use reports to provide ticket metrics at the organizational level.
- Associate CCTI Families: Categories are broken down into four levels: Class, Category, Type and Item (CCTI). A CCTI Family is a group of CCTIs that can be associated with one or more Organizations. This enables limiting CCTI records on tickets based on the Requested For/Requester's organization.
- ADSync: The ADSync Utility helps you download user data from an LDAP server to CSM. If you plan on using ADSync to populate the users in CSM, make sure to create Organizations in CSM first since ADSync will not create them for you. Further, if you have users associated with an organization in your LDAP directory, and that organization does not exist in CSM, the users will not be created in CSM since the utility will be unable to match the organizational profile.
...
- Manually: you can create and manage organizations through the CSM application manually. Use this option if you do not have many organizations to manage. Click here <<change the link to Serviceaide>> for for additional information on manually creating organizations.
- Bulk Process Data: you can load many organizations at the same time using an XLS or XML template through the CSM application by populating the Organization tab. Use this option if you have a long list of organizations that you can copy and paste into a formatted template. Click here <<change the link to Serviceaide>> for for additional information on creating organizations using the bulk import, or refer to the Bulk Load Example in this document.
- Web Service: Web service calls to CSM can create, search, and update organizations. If you have a way of making web service calls automatically, you may want to use web service calls to update CSM organizations.
...
- Manually: you can create and manage groups through the CSM application manually. Use this option if you do not have many groups that need to be created or managed in the application. Click here <<change the link to Serviceaide>> for for additional information on manually creating groups.
- Bulk Process Data: you can bulk load groups with the XLS or XML template through the CSM application by populating the Support Groups tab. Organizations must be loaded prior to Groups if you need to link groups to organizations. Refer to the Support Groups Worksheet section in the documentation wiki, located here, for additional information on creating groups using the bulk import, or refer to the Bulk Load Example in this document.
- Web Service: Web service calls to CSM can create, search, and update groups. If you have a way of making web service calls automatically, you may want to use web service calls to manage CSM groups.
...
- Manually: you can create and manage users through the CSM application manually. Use this option if you do not have many users to manage. Click here <<change the link to Serviceaide>> for for additional information on manually creating users.
- Bulk Process Data: you can bulk load users with the XLS or XML template through the CSM application by populating the Contact Persons tab. Organizations and Support Groups must be loaded prior to Contacts if you need to link analysts to groups or contacts to organizations. Click here for additional information on creating users using the bulk import, or refer to the Bulk Load Example in this document.
- Web Service: Web service calls to CSM can create, search, and update users. If you have a way of making web service calls automatically, you may want to use web service calls to update CSM users.
- Active Directory Synchronization: The ADSync utility synchronizes user data from an LDAP server, and imports users and their organization. Click here for additional information on ADSync.
...
- Start with the Organization Tab
- Refer to the documentation wiki for instructions on bulk importing Organizations here.
- Additional Tips on Organization fields:
- Organization Name – plain text field which is required
- Parent Organization (if needed) – plain text field which must match an existing Organization name in the database, or a name listed in the XLS sheet in a previous row.
- If an organization will be a "sibling" to your root Organization, then leave the Parent Organization column empty, as seen below with the first row:
- If an Organization will be a sub-organization to your root Organization or a new organization, then populate the Parent Organization column with the name of your root organization, or the name of the to-be parent organization. The parent organization can be the root organization, since it already exits, or a value listed in the Organization Name column above it. See below example:
- Organization Type must be a valid database value:
- Account Manager - The Organization tab has a link to Users through the Account Manager column. This is a relational field and must point to a valid lastname, first name. If users are not loaded yet, you cannot enter an Account Manager for your Organization. You'll have to do this as an update later.
- Holiday – this field must match a valid holiday in the system. Go to MANAGE, ADMINISTRATION, Tools, Holidays for the current list, or create a new one.
- Exclude From Surveys - the valid values are a yes or a no. Setting this to yes will exclude all contacts related to the organization from ever getting a survey sent to them.
- All other fields are free form text
Support Groups
- For help on populating most group fields, log into CSM and go to the MANAGE, ADMINISTRATION, Tools area. Select Groups and select any field on the default Group detail form. Each field will give you help text on what the field requires. Required fields will have a red star before them.
- The Used For fields, shown below, must have a Yes or No value:
- For help on additional worksheet fields, refer to the documentation wiki page here.
...
Configuration Items and CI Related Contacts
Refer to the documentation wiki for help populating these objects. The following is an example of a populated Configuration Item form.
The Class, Category, Type, and Item field values on the Configuration Items tab must exist or be listed on the Categorizations tab and associated with Configuration Items. See below screen shot.
For CI Related Contacts, both the CI Name and the Client Defined System User ID must exist. This information is loaded from the Contact Permissions tab and the Configuration Items tabs, which is why CI Related Contacts is loaded after both of those.
...
Information on installing and using the Active Directory Synchronization can be found on the documentation wiki by clicking here. This utility will take users from Microsoft Active Directory or Novell eDirectory and import, update, or inactivate them in CSM. It will also take LDAP attribute fields and populate them in CSM with the contact information.
This example will show how to install and use ADSync with Microsoft Active Directory to populate the CSM Users. The example company is Forward Inc.
...
In this test scenario, we are logged onto the LDAP server as an Administrator. We will be installing and running ADSync on this server, but before we do this, we need to make sure Java 8 is installed.
If you don't know whether or not you have Java installed, point your browser to www.java.com and select the Do I have Java? link. If you need the latest version, select Free Java Download and follow the prompts to download and install Java.
Once Java is downloaded and installed you will need to set JAVA_HOME as an environment variable on the ADSync server (in our case the LDAP server) and add it to your PATH statement. See below for an example.
TIP: To find and use the short path of Java Home:
...
SSL certificate can be downloaded from the CSM site. They are not included with the ADSync download by default since the SSL certificates expires frequently.
also enclosed is the training video of adding the SSL certificate to AD Sync.
https://www.youtube.com/watch?v=zHsor9SFnqQ&t=19s*
To enable an SSL environment for the ADSync Utility, perform the following steps:
...
Variable | Default Value | New Value | Notes |
---|---|---|---|
ldap.gc= | ldap:// 1024server:3268 | ldap.gc=ldap://CSMLDAPSERVER:3268 | CSMLDAPSERVER is the name of the LDAP server. |
ldap.dc= | ldap.dc=ldap:// CSMLDAPSERVER:389 | CSMLDAPSERVER is the name of the LDAP server. | |
ldap.bind.user= | AD account with access to run queries on the AD server | ||
ldap.bind.user.pwd= | user@123 | CSMR@ck$! | AD account password |
send.data= | yes | no | Temporarily set this value to 'no' for initial testing |
login.appender= | Value to append the sAMAccountName attribute in LDAD, which maps to the user's Username: |
...
You may want to do this if you have a lot of system accounts that do not have a givenName populated in AD. The AD field of givenName maps to the CSM field of first name on a user's record. To skip all AD accounts with a null givenName, update the value to:
(&(!(givenName=""))(objectClass=user)(objectClass=person)(objectClass=organizationalPerson)
For a full list of variables in this file, refer to the documentation wiki location here. <<change the link to Serviceaide>>
Step 6: Update searchBase.list
...
You may need to update the attribute_map.list file to define your organizational structure. You can define an org_name using active directory (AD) attributes, static values, or a combination of both.
In the following screen shot, the default org_name value is set appropriately for the sample users, so no updates are necessary. The user shown will be created in the CSM organization Forward Inc.>>FWD Technology Services Ltd.
For additional information on updating the attribute_map.list file, see the documentation wiki page here. <<Change the link to Serviceaide>>
Step 8: Run the sync Command
...