Searching the Help
To search for information in the Help, type a word or phrase in the Search box. When you enter a group of words, OR is inferred. You can use Boolean operators to refine your search.
Results returned are case insensitive. However, results ranking takes case into account and assigns higher scores to case matches. Therefore, a search for "cats" followed by a search for "Cats" would return the same number of Help topics, but the order in which the topics are listed would be different.
Search for | Example | Results |
---|---|---|
A single word | cat
|
Topics that contain the word "cat". You will also find its grammatical variations, such as "cats". |
A phrase. You can specify that the search results contain a specific phrase. |
"cat food" (quotation marks) |
Topics that contain the literal phrase "cat food" and all its grammatical variations. Without the quotation marks, the query is equivalent to specifying an OR operator, which finds topics with one of the individual words instead of the phrase. |
Search for | Operator | Example |
---|---|---|
Two or more words in the same topic |
|
|
Either word in a topic |
|
|
Topics that do not contain a specific word or phrase |
|
|
Topics that contain one string and do not contain another | ^ (caret) |
cat ^ mouse
|
A combination of search types | ( ) parentheses |
|
Example: Retrieving Service Manager Release Management changes into a text file using Connect-It
- Create the Service Manager Web Services Connector with the following connection parameter settings. (All other settings remain the defaults.)
- Click Test to verify that the connection works.
- Click Finish to save the changes made to the new connector.
- In our example, the Web Service simply fills information into a delimited text field. The settings for that connector are as follows:
- Click Finish to create and save the connector.
- Finally the source (Web Services) data and the target data (Delimited Text file) must be mapped, in this case based on the matching names.
- Because Web Services need to be prompted to produce output, another text file connector must be created that helps create the request sent to the Web service. This text file connector is defined as follows:
- Select a document type. Click the down arrow and enter SMChange.
- Click Next.
- Select a file for the preview. Accept the default <path and filename from step 6> and click Next.
- Select the appropriate delimiter.
- Enter the information on the screen:
- Write the column headers: checked
- Do not generate errors if a line contains... : checked
- Number of skipped lines: 0
- Quote character: "
- Start of the comment line: //
- Escape character: /
- Click Next.
- Enter the column names and type: for example, Change Number - text
- Click Finish to create and save the connector.
- Now create a mapping between this text file and the Service Manager Web Service by connecting the two.
- Click the first text connector and click Produce Now (the F5 button) to fill information from the cm3r file in Service Manager into a delimited text file via Web Services.
• Server name: <server>:<httpPort (use a dedicated port, not the loadBalancer port)>
• Context Path: sc62server/PWS
• Service name: Change Management
• Enter the SysAdmin userID and password
• Name: Changes
• Processing Mode: write
• Connection protocol: Local / network files
• Enter a folder name and decide whether to create a separate file for each record retrieved or write all records into one file (recommended).
• On the next screen, decide whether to append to the same file (recommended) or overwrite with each run, or how many files to keep.
• Enter the path to the descriptor file (see below) or create a new descriptor file.
To create a description file for the text output file (comma delimited text in our example), the following code is a sample .dsc file that can be used for retrieving change information:
{ TextFileFormat SMChange Extension= FormatType=Delimited EscapeChar="\\" Quote="\"" Extracolumn=1 WriteColumn=1 Delimiter=, { String "Change Number" UserType=Default } { String "Category" UserType=Default } { String "Status" UserType= Default } { String "Approval Status" UserType=Default } { String "Requested By" UserType=Default } { String "Assigned To" UserType= Default } { String "Coordinator" UserType=Default } { String "Coordinator Phone" UserType=Default } { TimeStamp "Planned Start Date" UserType=TimeStamp } { TimeStamp "Planned End Date" UserType=TimeStamp } { String "Reason" UserType=Default } { String "Current Phase" UserType= Default } { String "Risk Assessment" UserType=Default } }
• Processing Mode: read
• Connection Protocol: Local/Network files
• Location: Read files, file name: <path and filename>
• Upon successful processing, leave the file in the folder.
Use this .dsc file. Enter <path and filename> and click Find (magnifying glass) to create or modify a description file.