DocUp Tools 70x

Embed Size (px)

Citation preview

  • 8/4/2019 DocUp Tools 70x

    1/50

    Documentation Update forSiebel ToolsReference

    Date Published: June 10, 2002

    Last Updated: December 5, 2002

    This Documentation Update applies to the following versions ofSiebel Tools Reference.

    Document Version: 7.0, Rev B

    Date Published: August 2002, June 2002

    Software Version:Siebel 7 Version 7.0.3 and 7.0.4

  • 8/4/2019 DocUp Tools 70x

    2/50

    2

    Version 7.0.3 and 7.0.4

    General Information 0June 10, 2002

    NOTE: If you are developing applications that run against databases on DB2 UDB for OS/390 andz/OS, seeImplementing Siebel eBusiness Applications on DB2 UDB for OS/390 and z/OS for

    considerations and procedures specific to that environment.

    This is especially true for applying schema changes to your local database and migrating schemachanges from your development environment to a user-acceptance or production database.

    Chapter 1, Installing Siebel Tools0

    June 10, 2002

    Page 1-18Add the following note before step 3:

    NOTE: Password encryption interferes with project check-in and checkout. You must disable

    password encryption in the client or configuration file when running Siebel Tools if you will bechecking projects in and out.

    Chapter 2, Siebel Repository 0June 10, 2002

    Page 2-7The note on page 2-7 is true for v7.0.2, but not for v7.0.3 or v7.0.4. Replace it with the following note:

    NOTE: Browser scripts must be generated, using the genbscript utility, each time a scripted object iscompiled. See Alert 0365 on Siebel SupportWeb for instructions. The genbscript utility must be runeach time a new .srf file is deployed to the Siebel Mobile Web Client or Siebel Server.

  • 8/4/2019 DocUp Tools 70x

    3/50

    3

    Chapter 3, Siebel Tools Fundamentals 0

    June 10, 2002

    Creating a New Object Definition 0

    Page 3-37Add the following text to the beginning of the section:

    Names of new objects should consist only of standard US ASCII characters, such as letters andnumbers. They should not contain foreign characters, such as , , and , or punctuation, such ascommas, periods, and colons.

    Chapter 5, Data Objects Layer 0

    Extension Tables0

    December 5, 2002

    Page 5-8Add the following note before the last sentence of the second paragraph (The relationships...):

    NOTE: When columns in a base table are updated, the timestamps of its extension tables are not

    updated unless columns in those extension tables are also updated.

    June 10, 2002

    Page 5-8Change the second sentence of the second paragraph on page 5-8 to read as follows:

    Its columns are provided mostly for developers, and are generally not used by standard Siebelapplications.

    Page 5-10Add the following text after the first paragraph on page 5-10:

    The standard Siebel applications use the following columns in these extension tables:

  • 8/4/2019 DocUp Tools 70x

    4/50

    4

    S_CONTACT_X. ATTRIB_03, 04, 05, 06, 07, 08, 14, 15, 26, 48, and MODIFICATION_NUM.

    S_EMPLOYEE_X. ATTRIB_48.

    S_OPTY_X. ATTRIB_04, 05, 08, 09, 10, 11, 15, 16, 17, 18, 34, 35, 36, 37, 38, 39, 41, 42, 43, 44, 45.

    S_ORG_EXT_X. ATTRIB_01, 02, 03, 08, 14, 15, 16, 27, 48, 49, 50, 51, 52, 53.

    One-to-One Extension Tables 0June 10, 2002

    Page 5-11Add the following text to the end of the section:

    When writing data to a one-to-one extension table, at least one column of the extension table mustbe updated for a record to be written to the extension table.

    For example, you might want to create a workflow policy based on an column in a 1:1 extension

    table. If there is no data to be written, the record will not be updated. Therefore, the workflow policywill not be triggered.

    Column Object Type 0December 5, 2002

    Page 5-27

    Replace the second to last bullet point on the page so that it reads as follows:

    Long. Long text. You can store approximately 16K worth of data in long columns. By default,you cannot have char greater than 1. However, you can change this setting by selecting theView > Options menu, and then selecting the Database tab in the Development Tools Optionsdialog box.

    June 10, 2002

    Page 5-28Add the following text to the Number physical type (first sub-bullet point on page 5-28):

    Data of this type is limited to 16 digits without a decimal point or 15 digits before a decimalpoint.

  • 8/4/2019 DocUp Tools 70x

    5/50

    5

    Index Column Object Type 0June 10, 2002

    Page 5-37Replace the Sort Order property bullet point with the following:

    Sort Order. The sort order for the index column. Its value can be either Asc (ascending) or Desc(descending).

    S_PARTY_PER 0June 10, 2002

    Page 5-56Change the first sentence of the section to read as follows:

    S_PARTY_PER is an intersection table (see Figure 5-33) that relates two instances of parties and is

    used to implement group-member relationships between the following, respectively:

    Add the following text afterFigure 5-33:

    In the implied join between S_PARTY_PER and S_PARTY:

    S_PARTY_PER.PARTY_ID maps to the groups row ID (S_ORG_EXT.ROW_ID)

    S_PARTY_PER.PERSON_ID maps to the members row ID (S_CONTACT.ROW_ID)

    Chapter 6, Adding Custom Extensions to the DataModel 0

    Planning and Design Steps 0June 10, 2002

    Page 6-9Add the following text before the note at the end of the page:

  • 8/4/2019 DocUp Tools 70x

    6/50

    6

    If you need to store additional data that almost always exists for a given base record and is regularlyaccessed, the recommended approach is to extend the base table to store this data. By doing this you

    avoid an extra join to an extension table. However, this might result in slower access to the base tableif there is a lot of data (that is, many large fields have been added and they are always populated),because fewer rows now fit on one page.

    If a large number of extension fields is required, and if the view displaying this data is accessedinfrequently, use an extension table. A join is executed for the extension table, but only when thisview is accessed.

    Pages 6-9 and 6-10Move the sentence before the note on page 6-9 (starts with If you choose...) after the note and makeitstep 2.

    Database Extension Implementation 0June 10, 2002

    Page 6-15Add the following Caution before the procedureTo implement database extensions:

    Creating a Custom Extension Table 0December 5, 2002

    Page 6-17Add the following text after the first paragraph of the section:

    If you wish to create 1:1 or 1:M extensions for tables whose type is Extension (Siebel), you mustextend from S_PARTY.

    For example, S_CONTACT is an extension table of S_PARTY. Because S_CONTACT is of typeExtension (Siebel), you cannot use it as a parent table for an extension table. You must use S_PARTY.

    Caution: Creating tables using SQL is not supported; use only SiebelTools to create tables and perform other logical database schemaextensions.

  • 8/4/2019 DocUp Tools 70x

    7/50

    7

    For a business component based on your new table to show data from S_CONTACT, you must create

    a Join object that references S_CONTACT and has a Join Specification child object with a Source

    Field property set to Parent Id and Destination Column property set to ROW_ID. The row ID of an

    S_CONTACT record will be the same as the row ID of the corresponding S_PARTY record. 0

    Adding Extension Columns to Tables 0December 5, 2002

    Page 6-18Delete the note under Extension (Siebel). It refers to creating extension tables, not extension columns.

    Page 6-19Change the first sentence of the last paragraph as follows:

    Delete: You are limited to one LONG custom extension column of type Varchar and one of type Long

    per table.

    Replace with: You are limited to one column of type LONG per table.

    Change the last sentence of the caution on page 6-19 as follows:

    Delete: Additionally, you must set the Foreign Key Table Name property to NULL for that column,and you will not be able to use the Enterprise Integration Manager to load values into that column.

    Replace with: Additionally, you must set the Foreign Key Table Name property to NULL for thatcolumn to use the Enterprise Integration Manager to load values into that column.

    Using Extensions with Enterprise Integration Manager 0June 10, 2002

    Page 6-24Change the first note on page 6-24 and the paragraph after it to read as follows:

    NOTE: PreSiebel 2000 software uses only the _IF suffix for interface tables. Siebel 2000 and laterversions use both the _IF and EIM_ forms for interface tables.

  • 8/4/2019 DocUp Tools 70x

    8/50

    8

    For example, you can create an extension column called X_CUST_NUM in the S_ACCOUNT_IF orEIM_ACCOUNT table, and map this either to an extension column you added to S_ORG_EXT or to

    an existing column in the S_ORG_EXT_X extension table.

    Deleting Extension Tables or Columns 0June 10, 2002

    Page 6-26Replace the last paragraph in the section with the following paragraph:

    After you have deleted an extension table or column from the logical schema in the Siebel repository,the table or column still exists in the physical schema of the database. You must apply your changesto the physical database by clicking the Apply button. This will synchronize the logical and physicalschemes, dropping any tables or columns from the database that you have deleted from therepository. See Applying the Physical Schema Extensions to the Local Database on page 6-27 formore information.

    NOTE: In some database platforms, such as DB2, dropping a column requires you to reconstruct theentire table. However, if there an object based on the table, a DB2 object such as a view for example,you cannot drop the table from the database.

    Adding Custom Indexes 0June 10, 2002

    Page 6-26Change the Caution to read as follows:

    Caution: Use caution when implementing custom indexes. Addingan index, while improving the performance of one query, mightadversely affect others. It is strongly recommended that you consultSiebel Expert Services before implementing any custom indexes; itcan assist you on evaluating the impact of creating such an index inyour database.

    Also, all changes should be thoroughly tested in your developmentenvironment before being introduced into production.

  • 8/4/2019 DocUp Tools 70x

    9/50

    9

    Applying the Physical Schema Extensions to the Local Database 0June 10, 2002

    Page 6-27Add the following note before the procedure To update your local environment.

    NOTE: Siebel eBusiness Applications version 7.0 do not support customized database triggers. If youhave created customized triggers on your Siebel base tables, you must disable them before updatingthe logical database schema. You will then need to recreate the triggers after the update is finished.

    Pages 6-27 and 6-28Delete the figure afterstep 3 on page 6-27 and replace step 4 on page 6-28 with the following:

    4 Fill in the fields as shown in the following table, and then click Apply.

    Field Description

    Tables Select one of the following options from the drop-downmenu:

    All. Update the database to reflect all changes made tothe dictionary. This option forces each database objectto be compared with the data dictionary, and updated ifrequired.

    Current Query. Update the database to reflect

    modifications made to the tables in the current queryonly.

    Current Row. Update the database to reflectmodifications made to the table in the current rowonly.

    Table space Leave blank.

    16K table space Leave blank.

    32K table space Leave blank.

    Index space Leave blank.

    Table groupings file Optional.

    This file is provided by the DBA and is specific to yourdatabase.

  • 8/4/2019 DocUp Tools 70x

    10/50

    10

    Populating Extension Tables and Columns 0June 10, 2002

    Page 6-35Add the following procedure to the end of the section:

    To make an extension table available for population by EIM

    1 Lock the EIM Interface Table project.

    2 Navigate to the EIM Interface Table object, create a new record, and then complete its properties,for example Name and Target Table Name.

    3 Click Activate in the EIM Tables list.

    The temporary columns required to populate the extension table are created.

    4 Navigate to the Table object, and then select the EIM interface table created in Step 2.

    5 Click Apply in the Tables list, complete the fields in the Apply Schema dialog as shown in Toupdate your local environment on page 6-27, and then click Apply in the dialog.

    The generated temporary columns are applied to the database.

    Privileged user id Enter your database user ID, for example SADMIN.The table owner is read from tools.cfg.

    Privileged user password Enter your database user password, for example SADMIN.

    NOTE: When the database initialization for a mobile clientis performed, the table owner changes from SIEBEL to themobile user's password. In this case, use the mobile userspassword in the password field.

    ODBC data source Verify that the ODBC connection specified in the ODBCData Source text box is correct for your environment.

    You cannot apply schema changes to any database otherthan the one you are currently connected to (for example,by specifying the ODBC name of a different database).

    Field Description

  • 8/4/2019 DocUp Tools 70x

    11/50

    11

    6 Click Activate in the Tables list.

    The extension table is available to be populated by EIM.

    Add the following subsection:

    Configuring Client-Side ImportYou can also use client-side import to populate fields with data if you are not using EIM. Client-sideimport takes advantage of the applet-level menu import functionality in the Siebel Web Client. It isconfigured using the Import Object object in Siebel Tools, which sets business component fields to

    be populated.

    For example, many users import external contact data, so the Contact business component alreadyexists as an import object in the standard Siebel application, with many fields as Import Field childobjects.

    To enable client-side import for a business component

    1 Lock the project to which the business component belongs.

    2 In the Object Explorer, select Import Object.

    3 Add a new record with the business component and its project as properties.

    4 With the new record selected, expand Import Object, and then select the Import Field childobject.

    5 Add new records for each business component field you wish to be populated.

    NOTE: You can also add import fields to already existing import objects, such as Contact.

    6 Compile the .srf, selecting the locked project.

    The new fields will be displayed in the Select a Siebel Field dialog and can be mapped to fields inthe External Data Source Field dialog when importing data.

    Table Wizard Actions 0June 10, 2002

    Page 6-54Replace the last main bullet point(For Intersection Tables...) with the following:

  • 8/4/2019 DocUp Tools 70x

    12/50

    12

    For intersection tables, the Table Wizard sets the type of the table to Data(Intersection) andcreates the following:

    TYPE column for added user functionality

    Two Foreign Key columns with names specified in the Table Wizard

    User Key Sequence=1 and 2

    Foreign Key Table=

    U1 index on the two Foreign Keys (1, 2), TYPE (3), and CONFLICT_ID (4)

    Unique/Cluster=TRUE

    Type=User Key

    User Primary Key=TRUE

    F1 index on the Foreign Key to the second parent table

    Add the following note to the end of the section:

    NOTE: When a custom extension table is added using the Table Wizard, a U1 index is added to thetable. However, the User Key column is blank and does not allow the definition of user keys. This isbecause there is no need to create user keys: they are only needed to resolve foreign keys while usingEIM, and EIM does not work with foreign keys to custom tables.

    EIM Table Mapping Wizard 0December 5, 2002

    Page 6-58

    Add the following note after the first paragraph under Step 6:

    NOTE: When selecting an existing base table the wizard will only let you select the Interface tablesthat have the base table defined as a target table.

  • 8/4/2019 DocUp Tools 70x

    13/50

    13

    Chapter 7, Business Objects Layer 0

    Configuring Data-Driven Read-Only Behavior 0June 10, 2002

    Page 7-18Replace the second bullet point on page 7-18 with the following:

    These user properties do not function when used in an applet in a view where the view's Admin

    Mode property is set to TRUE.

    Admin Mode, when TRUE, turns off all insert and update restrictions for the businesscomponents used by the view, including those specified by business component user properties.The business component Sales Rep and Personal visibility modes are ignored. Records that donot have a primary team member are also visible. However, pop-up visibility is not overridden.

    Intersection Business Components0

    June 10, 2002

    Page 7-29Replace the paragraph that precedes Figure 7-7 with the following:

    An example of an intersection business component that is exposed in the user interface isOpportunity Product. It is based on the S_REVN table, and used in the applets in the Opportunity

    Products screen in Siebel Sales, shown in Figure 7-7.

    Calculated Fields 0June 10, 2002

    Page 7-33Add the following note after the paragraph that begins with For more information...:

    NOTE: Queries on calculated fields are not supported if the Cache Data property of the businesscomponent is set to TRUE.

  • 8/4/2019 DocUp Tools 70x

    14/50

    14

    Field Data Types 0December 5, 2002

    Page 7-33Add the following note between the second and third sentences of the first paragraph:

    NOTE: Calculated fields are not automatically refreshed when a related field value changes; they arerefreshed only after committing the record. To have them refresh immediately after the fields havebeen changed the Immediate Post Changes property of the field needs to be set to TRUE.

    June 10, 2002

    Page 7-36Add the following note to the Description field of the DTYPE_ID row ofTable 7-2, Field Data Types:

    NOTE: Fields mapped to extension columns of physical type Varchar(15) will automatically defaultto data type DTYPE_ID.

    Change the Description field of the DTYPE_INTEGER row ofTable 7-2, Field Data Types to read asfollows:

    Refers to data as whole numbers ranging in value from - 2147483648 to 2147483647.

    Primary ID Field 0June 10, 2002

    Page 7-82Add the following new section before Using the Check No Match Property with a Primary Join:

    Allowing Users to Set PrimariesYou can set the MVG Set Primary Restricted: visibility_mvlink_name user property in the businesscomponent underlying the MVG applet to allow certain users to set primaries. Setting this userproperty to FALSE allows the Primary team member to be altered by someone other than theManager or Siebel Administrator.

    If this user property is not set, only Siebel Administrators (in Admin mode) and Managers (inManager view mode) have the ability to change the Primary team member on opportunities,accounts and contacts.

  • 8/4/2019 DocUp Tools 70x

    15/50

    15

    For more information, see MVG Set Primary Restricted: visibility_mvlink_name on page F-22.

    How a Cascade Copy with a Multi-Value Link is Constructed 0June 10, 2002

    Page 7-85Replace the first sentence in the bullet that describes the No Copy property with the following sentence:

    This must be set to FALSE and #Field ID should be set to No Copy=FASLE. If No Copy property isset to TRUE, cascade copying is disabled.

    Chapter 9, Logical User Interface Objects Layer 0June 10, 2002

    Text Controls 0

    Page 9-21Change the following sub-bullet under the Display Format property bullet to read as follows:

    For DTYPE_CURRENCY data, the property can be specified explicitly using the same symbolsas for DTYPE_NUMBER, plus the dollar sign. The display of currency values can also becontrolled using the Scale field in the Currencies view under the Application Administration

    screen.

    About HTML Control Types 0

    Page 9-33Remove the cell in table 9-1, HTML Control Types, that contains information for the control type of

    Java applet, as this control is not supported.

    Applets 0

    Page 9-36Add the following new subsection to the end of the Applets section:

  • 8/4/2019 DocUp Tools 70x

    16/50

    16

    About the Search Specification PropertyIf the value in the Search Specification property in an Applet object definition is non-blank, the setof records provided to an applet is restricted. The search specification contains the names of one ormore fields in the business component and various operators, combined to create a conditionalexpression. Records in which the value of the conditional expression evaluates to TRUE are providedto the applet for display; those records in which the expression evaluates to FALSE are excluded.

    NOTE: Search specifications on child applets are not executed.

    Some sample search specification expressions appear below:

    [Type]= "COST LIST"

    [Revenue] > 5000

    [Competitor] IS NOT NULL and [Competitor] "N"

    [Type] = LookupValue ("TODO_TYPE", "In Store Visit")

    Search specification expressions are built according to the following syntax rules:

    Standard comparison operators are used to compare a field to a constant, or one field to anotherfield. These include =, , >, =, and 5000

    String constants are enclosed in double quotation marks. String values are case sensitive, so theuse of uppercase and lowercase letters in the search specification should exactly match that of

    the records you want returned.

    Example: [Type] "COST LIST"

    The logical operators AND, OR, and NOT are used to negate or combine expressions. Case isignored in these operators; for example, and is the same as AND).

    Example: [Competitor] IS NOT NULL and [Competitor] "N"

    A field name in a search specification must be enclosed in square brackets.

    Example: [Conflict Id] = 0

  • 8/4/2019 DocUp Tools 70x

    17/50

    17

    The LIKE operator may be used to create text string comparison expressions in which a field iscompared to a constant, or a field to another field, and a match on only the first several charactersis required. The wildcard characters * and ? are used to indicate any number of characters,and a single character, respectively.

    Example: [Last Name] LIKE "Sm*"

    In this example, the Last Name values of Smith, Smythe, Smallman, and so on would cause theexpression to evaluate to TRUE.

    The search specification expression must be 255 characters or less.

    An applet search specification cannot be used to override the search specification of the underlyingbusiness component, if the business component has one. Rather than overriding the businesscomponents search specification, the applets search specification is appended to that of thebusiness component. Search specifications should appear in the business component or the appletsthat use it, but not both.

    The search specification on an applet is converted to a WHERE clause by the data manager atruntime. When two applets based on the same business component appear in the same view, one

    query is generated against the database to populate both applets. Because a database selectstatement only supports one WHERE clause, only one of the applets should have a searchspecificationor if both do, they should have the same specification.

    For example, the Account List Applet and the Account Entry Applet both appear in the Account ListView. The record that is selected in the Account List Applet also appears in the Account Entry Applet.When you select a different row in the list or scroll through the list, the Account Entry Applet isupdated to show the same record that is selected in the Account List Applet. This is made possible

    by the fact that both applets are populated from the same query and therefore show the same recordset.

    To prevent the two applets from being synchronized, they would have to be on separate businesscomponents, for example by copying the business component on which the first applet is based.

  • 8/4/2019 DocUp Tools 70x

    18/50

    18

    For more information on the usage of the Search Specification property of applets, see Object TypesReference.

    NOTE: When the Applet Visibility Type property of the View Web Template Item object is set to a non-null value, it might cause search specifications on the applets in that view to be ignored. Thisproperty is recommended for use mainly where the applets in a view are based on different businesscomponents. If you use this property, test it thoroughly for functionality.

    NOTE: Search specifications can impact performance negatively, particularly when you include fieldsbased on joins in the search specification. Search specifications with NOT or OR can also adverselyaffect performance by forcing the database to execute a full table scan.

    Drilldown Behavior in a View 0

    Page 9-44Add the following text before the note on page 9-44:

    If the driving applet of a view has a search specification, this search specification is also applied tothe destination view when drilling down.

    For more information, see About the Search Specification Property and Object Types Reference.

    About the User Interface Navigational Paradigm0

    Page 9-52Add the following text to the end of the section under the Views bullet point:

    When a query is performed in a view or a predefined query is executed for a view, the current querycontext remains when users navigate to another view using a view tab, where the driving applet isbased on the same business component as the previous view.

    However, a fresh query is applied when the view is visited from the Site Map.

    The visibility rules of the new view are also applied. If a query is entered in an All view and then aView tab is used to navigate to a Manager view or a Sales Rep view, only the subset of records thatis visible to the user as a manager or as a sales representative will be seen.

  • 8/4/2019 DocUp Tools 70x

    19/50

    19

    If there is a search specification on a driving applet in a view and the user navigates from this viewto another using a view tab, the search specification is applied to the destination viewkeeping thesame query.

    An explicit search specification can be specified for the applet in the target view to force a new query.For more information, see About the Search Specification Property and Object Types Reference.

    Chapter 10, Logical User Interface ObjectsConfiguration 0June 10, 2002

    Editing the Web Layout of Applets 0

    Page 10-15Add the following as step 6 in the procedure To Access the Web Applet Editor:

    6 Validate that controls and list columns are mapped to placeholders in the Web template by right-clicking and selecting Check Mappings.

    If the control or list column is not mapped to a placeholder, it is listed, and you are prompted todelete it from the Web template. This may occur when a control or list column object has beendeleted from the repository, but still appears on the Web template. Or it may occur when a newWeb template is associated with an applet, and the existing placeholder IDs for controls or listcolumns do not exist in the new template.

    Creating Views Using the Object Explorer 0

    Page 10-22Add the following bullet point to step 3:

    Visibility Applet Type. Limits view visibility by organization or responsibility. Valid values forVisibility Applet Type are:

    All

    Personal

    Sales Rep

    Manager

  • 8/4/2019 DocUp Tools 70x

    20/50

    20

    Organization

    Sub-Organization

    Catalog

    Group

    If Visibility Applet is blank, the view appears as a view tab and is not listed in the Show menu.Its visibility is determined by the value of Visibility Applet Type.

    If Visibility Applet Type is blank, the view's visibility defaults to the most restrictive type

    defined for the business component. (This usually means Personal or Sales Rep visibility,depending on the corresponding visibility settings of the business component of the view'sThread Applet property.) The view is listed in the Show menu by the name given in theVisibility Applet property.

    If both are blank, the visibility depends on the navigation context:

    When navigating from another view to this view using the Show menu, the query contextand record focus are kept from the previous view, assuming that the business componentsand search specifications are relevant.

    When navigating to this view using the Site Map or the Screen tabs, the visibility defaultsto the most restrictive type defined for the business component.

    For more information on view visibility rules, seeAuthentication and Access ControlAdministration Guide.

    Defining Views 0

    Page 10-26Add the following section as a new heading to follow the heading Editing the Web Layout of Views.

    Configuring Views for Layout ControlCertain views in Siebel applications, such as a home page views, allow the user to control the layout

    of the view. For example, these views allow the user to:

    Reorder applets

    Collapse or expand applets

    Show or hide applets

    See the Customizing Your Home Page section in the Siebel Fundamentals book for a description of

    this feature from the end-user perspective.

  • 8/4/2019 DocUp Tools 70x

    21/50

    21

    The user can edit view layout in two modes. Show mode and Edit Layout mode.

    Show mode. Allows users to move, collapse and expand, show and hide individual applets within

    the view, using controls placed at the top of each applet on the view. For example, home pageviews are displayed in Show mode until a user clicks the Edit Layout button.

    Edit Layout mode. Allows users to move, expand and collapse, show and hide, individual applets,plus perform the following operations on all applets within the view: show all applets, hide allapplets, minimize all applets, maximize all applets, and reset the default layout definition. Thismode is presented to the user using a separate applet called the Layout Controls applet andappears after the user clicks the Edit Layout button.

    To configure a view to support personal layout control

    1 Set the User Layout property of the Views View Web Template object to TRUE.

    2 Define the default layout of the view by setting the following properties of the View Web TemplateItems associated with the view.

    Display Size. Determines whether the applet is minimized or maximized. Always Maximized

    indicates that the applet cannot be minimized by the end user.

    NOTE: Minimized and maximized are referred to as collapse and expand in the client userinterface.

    Display Visibility. Determines whether the applet is shown or hidden. Always Show indicatesthat the applet cannot be hidden by the end user.

    Move Range. Defines a range in which the applet may be moved. For example, on anapplication home page with two columns, applets would specify a move range of eitherColumn1 or Column2. Any applet with a move range ofColumn1 is movable only within thefirst (left) column. Any applet with a move range ofColumn2 is movable only within thesecond (right) column.

    If this property is not defined, the applet cannot be moved by the end-user. The applet locationis fixed within the view. For example, the salutation applet on the home page would typically

    not have move range specified for it.

  • 8/4/2019 DocUp Tools 70x

    22/50

    22

    3 Add the Layout Controls Applet to the view, add a corresponding View Web Template Item, andmap the applet to a placeholder in the Web Template.

    There is an applet in the Siebel repository called Layout Controls applet. Add this applet to theview that you want to enable for personal layout control. It serves as a container for the controlsthat handle view-level operations, such as Reset Default Layout. In Show Mode, this appletappears as the Edit Layout button. In Edit Layout mode, which appears after the user clicks theEdit Layout button, this applet shows all applets on the view, and allows the user to Hide AllApplets, Show All Applets, Reset Default Layout, and return to Show mode by clicking Done.

    4 Add the following view layout controls to applets within personalized views, add corresponding

    Applet Web Template Items, and map the controls to the appropriate placeholders in the Webtemplate.

    ButtonMoveAppletUp

    ButtonMoveAppletDown

    ButtonHideApplet

    ButtonShowApplet ButtonMinimizeApplet

    ButtonMaximizeApplet

    These view layout controls use Invoke Methods to manipulate the user's view layout preferences.

    Why a View Is Not Visible to a User 0

    Page 10-26Add this new section afterProviding User Access to a New View:

    When a view is not visible to the logged-in user, there are the following possible reasons:

    The view does not exist in the .srf file.

    This includes a possible misspelling when the view was registered (Site Map > ApplicationAdministration > Views); that is, it does not match the view name in the .srf file. If it matches,compile the .srf file again using the All Projects option (full compile).

    The view is not included in one of the logged-in user's responsibilities.

    Determine which responsibilities the logged-in user has (Site Map > User Administration >Employees).

  • 8/4/2019 DocUp Tools 70x

    23/50

    23

    Determine for each responsibility whether the view is included (Site Map > ApplicationAdministration > Responsibilities).

    The view is hidden using personalization rules.

    Determine this under Personalization Administration > Views. For testing purposes, you can alsoswitch off the EnablePersonalization parameter in the .cfg file.

    The view is not included either in the menu or in the view tabs. In this case, the view can onlybe accessed by drilling down from another view.

    In Siebel Tools, examine the Screen Menu property of the View object. It must be set to TRUE

    for the view to be included in the Site Map.

    Determine whether the view is included in a screen and that the Viewbar Text property of theScreen View child object of the screen is set appropriately.

    Determine whether the views Visibility Applet and Visibility Applet Type properties are setcorrectly. For more information, see Creating Views Using the Object Explorer on page 10-22.

    The view belongs to a screen that is not included in the currently running application.

    In Siebel Tools, determine whether the screen is included in the application (Screen MenuItem child object of the application).

    Determine whether the application name is spelled correctly in the .cfg file.

    The view does not belong to the same business object as the screen's default view.

    Make sure that the view is based on the same business object. You can also set a property for thescreen called Unrestricted Viewbar. If you set this property to TRUE, all views for the screen willbe shown, even if they are from different business objects.

    For restrictions on the Screen property, see Object Types Reference.

    The view is not available due to upgrade problems.

    If an upgrade was done, make sure that it was successful by verifying all the log files that were

    created. The upgrade log files are found in the DBSERVER_ROOT\DB_PLATFORM directory.

    The view is not included in your license keys.

    If none of the previous reasons is responsible fro the view not being visible, it is likely that theview is not included in your license keys. Send the license keys to Siebel Expert Services forexamination. See also Alert 0041 on Siebel SupportWeb.

  • 8/4/2019 DocUp Tools 70x

    24/50

    24

    Defining Screens 0

    Page 10-27Add the following note after the paragraph that discusses the Screen View object type (fourth

    paragraph) on page 10-27:

    NOTE: The Site Map is limited to visibility-level views only. Non-visibility level views, such asAccount Profile View and Account Attachment View, do not show up on the Site Map.

    Chapter 11, Pick Applets and Static Picklists 0June 10, 2002

    Configuring the Originating Business Component 0

    Page 11-18Add the following note to the end of the Pick maps bullet point:

    NOTE: Test your pick map definition after creating it. If the originating field stays the same afterchoosing a value from the pick applet, you should check the pick map definition for that field.

    Configuring the Pick List 0

    Page 11-32Add the following bullet point to the end of the section:

    No Insert. Static picklists must have their No Insert property set to TRUE to work properly. If thisproperty is set to FALSE the application generates the following error message:

    Unable to create picklist popup applet.

  • 8/4/2019 DocUp Tools 70x

    25/50

    25

    Pop-Up Visibility Rules 0

    Page 11-37Replace the text in the section with the following:

    You can limit picklist visibility by organization or responsibility using the following properties of theBusiness Component object type:

    Popup Visibility Auto All. Valid values are TRUE, FALSE, and blank.

    Popup Visibility Type. Valid values are:

    All

    Personal

    Sales Rep

    Manager

    Organization Sub-Organization

    Group

    Catalog

    If Popup Visibility Auto All is set to TRUE and the user has access to any All views, pop-up visibilitywill be All. If the user does not have access to any All views, pop-up visibility will be the value ofPopup Visibility Type.

    If Popup Visibility Auto All is set to TRUE, the user does not have access to any All views, andPopup Visibility Type is blank, pop-up visibility will default to the most restrictive value defined forthe business component, for example Sales Rep.

    If Popup Visibility Auto All is blank, pop-up visibility will be the value for Popup Visibility Type.

    If both properties are blank, pop-up visibility will default to the most restrictive value defined for thebusiness component.

    For more information on visibility rules, seeAuthentication and Access Control AdministrationGuide.

  • 8/4/2019 DocUp Tools 70x

    26/50

    26

    Chapter 12, Multi-Value Group Applets 0

    Configuring the Originating Business Component 0June 10, 2002

    Page 12-7Add the following text to the end of page 12-7:

    Pick maps can be used for multi-value fields similarly to how they are used for single-value fields.

    The MVF Pick Map object is a child object of Multi Value Field. Each pick map defines acorrespondence between a field in the multi-value group business component and one in theoriginating business component. These correspondences provide the information required toimmediately update the current originating business component record with information from theMVG business component when a record is picked.

    Each MVF Pick Map object definition has two important properties:

    Field. Identifies a field in the originating business component that is to be populated by data froma field in the MVG business component, when the PickRecord method is invoked.

    Pick List Field. Identifies a field in the MVG business component that is the source of data for thefield in the Field property of the Pick Map object.

    An example is the MVF pick map on the State multi-value field of the Account business component.Account has a multi-value link to the Business Address business component, where it obtainsaddress information.

    Using the MVG Applet Wizard 0December 5, 2002

    Page 12-15Add the following note to step 4 before the last sentence (For more information...):

    NOTE: If you will have a New button on your MVG applet, you will also need to define an Editmode manually, using the Popup Query template.

  • 8/4/2019 DocUp Tools 70x

    27/50

    27

    Chapter 13, Special-Purpose Applets 0June 10, 2002

    Making X-Axis Labels Vertical 0

    Page 13-35Add the following section afterChart Element Object Type:

    You can make x-axis labels vertical so that they do not overlap with each other. To do this, set the

    Vertical property to TRUE for the Chart Element object whose Axis Id property is set to XAxis.

    Tree Applets 0December 5, 2002

    Page 13-45Add the following note to the end of the section:

    NOTE: Search specifications on tree applets are not supported.

    Chapter 14, Physical User Interface Layer 0June 10, 2002

    Understanding Siebel Templates 0

    Page 14-6Replace the Edit and Edit List subbullets under the Applet template bullet with the following:

    Edit. Mode for editing an existing record.

    If New/Query templates do not exist, Edit is used when creating and querying.

    Edit List. Allows users to edit fields in a list applet.

    If Edit/New/Query templates do not exist, Edit List is used in high-interactivity (employee)applications when editing, creating, and querying. Standard-interactivity (customer andpartner) applications do not use Edit List, so you must define an Edit mode template.

  • 8/4/2019 DocUp Tools 70x

    28/50

    28

    First Navigation Level: Primary Tab Bar 0

    Page 14-21Add the following note after the last paragraph in this section:

    NOTE: To change the bitmaps used for screen tabs, in addition to modifying the template file toinclude the names of the new bitmap file, you must change the relevant Bitmap objects in SiebelTools so that they also reference the new bitmap file. Screen tabs are static bitmaps that are compliedinto the repository file (.srf). When a tab is clicked, JavaScript in the Siebel Web template redrawsthe bitmaps using the compiled information stored in the .srf file. The bitmaps used in a givenapplication are defined in the [SWE] section of that applications configuration file. For moreinformation about working with bitmaps, see Associating Bitmaps with Applets and Toolbar Iconson page 10-39.

    Second and Third Navigational Level: Visibility Picklist and Detail Tab

    View Bar0

    Page 14-27Add the following note as the last paragraph in this section:

    NOTE: To change the bitmaps used for view tabs, in addition to modifying the template file to includethe names of the new bitmap file, you must change the relevant Bitmap objects in Siebel Tools so

    that they also reference the new bitmap file. View tabs are static bitmaps that are complied into therepository file (.srf). When a tab is clicked, JavaScript in the Siebel Web template redraws thebitmaps using the compiled information stored in the .srf file. The bitmaps used in a givenapplication are defined in the [SWE] section of that applications configuration file. For moreinformation about working with bitmaps, see Associating Bitmaps with Applets and Toolbar Iconson page 10-39.

    http://userintobjdefine.pdf/http://userintobjdefine.pdf/http://userintobjdefine.pdf/http://userintobjdefine.pdf/http://userintobjdefine.pdf/http://userintobjdefine.pdf/http://userintobjdefine.pdf/http://userintobjdefine.pdf/
  • 8/4/2019 DocUp Tools 70x

    29/50

    29

    Chapter 16, Special Behavior Supported by Templates 0June 10, 2002

    Using Icons for Field Values 0

    Page 16-25Replace the sentence that begins In order to render... with the following note and To-do heading:

    NOTE: If you want to use custom icons in a list applet, you must size them in accordance with thelist applets row font size. For example, when using an 8-pt font (standard for Siebel eBusinessApplications), icons should be 23 pixels in width x 14 pixels in height.

    If you change the list applet row font size dynamically or place an icon larger than 23 x 14 in a row,the list applet rows will be scrambled.

    To render a field using image files

    Chapter 17, Repositories 0

    Exporting and Importing Repository Objects 0June 10, 2002

    Page 17-4Add the following Caution after the note at the bottom of the page:

    Caution: Exported objects from one version of Siebel eBusinessApplications should not be imported (through .sif files) into adifferent version, as object definitions might have changed.

    Importing an invalid object might result in invalid configurationsand an unsupported application.

  • 8/4/2019 DocUp Tools 70x

    30/50

    30

    repimexp.exe 0December 5, 2002

    Page 17-26Replace the entire section with the following section:

    Using repimexp.exe for Importing, Exporting, and Creating a File DumpThe repimexp.exe program imports, exports, or creates a file dump of a repository. It can also do anINTL table import. INTL tables contain language-specific information and are a part of therepository.

    You would rarely need to use repimexp.exe directlyyou would use the configuration utility instead.The only circumstances when you would run repimexp.exe directly might be:

    You need to run repimexp.exe with special parameter settings that are inaccessible through thebatch files.

    You need to perform a file dump.

    To import a repository using repimexp

    In the command line, type the following:

    repimexp /A I /G language_codes

    where language_codes is a list such as ENU, FRA, JPN. Use ALL for all languages.

    NOTE: If you want to import your repository with locale objects, you must specify at least one

    language code. Otherwise no locale objects will be imported. Therefore, when you compile theimported repository, it will not have any text in the user interface.

  • 8/4/2019 DocUp Tools 70x

    31/50

    31

    To export a repository using repimexp

    In the command line, type the following:

    repimexp /A E argument_list

    Export uses the arguments listed in Table 1.

    Table 1. Parameter Settings Passed as Export Arguments to repimexp.exe

    Parameter Required Meaning

    /U Yes Siebel administrator user name.

    /P Yes Siebel password.

    /C Yes ODBC data source. The default is the value in theSIEBEL_DATA_SOURCE environment variable.

    /D Yes Siebel database table owner. The default is thevalue in the SIEBEL_TABLE_OWNERenvironment variable.

    /W Yes Language mode, such as ENU or JPN. The defaultis SIEBEL_LANGUAGE. If this is not set, thedefault is ENU.

    /R Yes Repository name. The default is SiebelRepository.

    /1 Yes Export repository user name. The default is thesame as for /U.

    /2 Yes Export repository password. The default is thesame as for /P.

    /3 Yes Export repository ODBC data source. The defaultis the same as for /C.

    /4 Yes Export repository table owner. Use siebel forOracle and DB2, dbo for MS SQL Server. Thedefault is the same as for /D.

    /5 Yes Export repository name. The default is SiebelRepository.

    /B Yes Siebel server installation directory to overrideSIEBEL_HOME environment variable.

    /F Yes Data file, including path, to which to export.

    /T No Test only, do not export into database.

  • 8/4/2019 DocUp Tools 70x

    32/50

    32

    To create a file dump using repimexp

    In the command line, type the following:

    repimexp /A D /F [/L ]

    To perform an INTL table import using repimexp

    In the command line, type the following:

    repimexp /A X argument_list

    INTL import uses the arguments listed in Table 2.

    /V No Verify data. The default is N.

    /N No Change creation and update information:

    0= no change

    1= change CREATED_BY, UPDATED_BY

    2=change CREATED_BY, UPDATED_BY,dates columns

    The default is 1.

    /M No Commit changes even if verification fails. Thedefault is N.

    /L No Log file for output messages.

    Table 2. Parameter Settings Passed as INTL Import Arguments to repimexp.exe

    Parameter Required Meaning

    /G Yes A list of language codes such as ENU, FRA, JPN.Use ALL for all languages.

    /O Yes Abort INTL import if unable to resolve parent rowin server repository, that is orphans.

    The default is N.

    /I Yes Abort INTL import if insert fails.

    The default is Y.

    Table 1. Parameter Settings Passed as Export Arguments to repimexp.exe

    Parameter Required Meaning

  • 8/4/2019 DocUp Tools 70x

    33/50

    33

    Migrating Repositories and Schemas Between Databases 0June 10, 2002

    Page 17-29Add the following bullet point to the beginning of the list on page 17-29 under"It is recommended..."

    Check in all projectsin both the source and target databases.

    If you migrate a database schema with some projects still checked out, the migration will workbut the project state will be not locked in the target database.

    Add the following note after the second bullet point on page 17-29 under"It is recommended..."(starts with Run the...):

    NOTE: Siebel eBusiness Applications version 7.0 do not support customized database triggers. Ifyou have created customized triggers on your Siebel base tables, you must disable them beforemigrating the schema. You will then need to recreate the triggers after the migration is finished.

    December 5, 2002

    Page 17-29

    Modify the 4th bullet point on page 17-29 under It is recommended... to read as follows:

    If you move a repository from one database to another, such as from development to test, youneed to also create any new views, responsibilities, and list of values entries in the new

    environment.

    Upgrading Mobile Databases 0June 10, 2002

    Page 17-37Add the following note to step 3 on page 17-37:

    NOTE: However, if mobile databases are not reextracted, users will still be able to synchronizeno error message will be generated. This is to allow Siebel Anywhere, which users might use toupgrade mobile databases, to continue working.

  • 8/4/2019 DocUp Tools 70x

    34/50

    34

    Chapter 19, Application Development Projects 0

    Moving Object Definitions Between Projects 0June 10, 2002

    Page 19-20Add the following note to the end of the section:

    NOTE:If you delete an object from a particular project, and then re-create it with the same name inanother project, this has the same effect as moving the object between projects. Therefore, you

    should take the same precautions.

    In general, you should not delete object definitions. Deleting objects might cause parts of yourapplication not to work. If you do not want to use an object, you should set the value of its Inactiveproperty to TRUE.

    Checking In Projects 0June 10, 2002

    Page 19-22Replace the Caution after step 6 with the following:

    Caution: Depending on the size of the project, the check-in processmight require some time. Do not interrupt the process, as doing socan leave your repository in an unstable state. If for any reason thecheck-in process is interrupted, you must redo it. This completesthe unfinished tasks and unlocks the project on the server.

  • 8/4/2019 DocUp Tools 70x

    35/50

    35

    Undoing Checkout 0June 10, 2002

    Page 19-29Add the following note as the last paragraph in the section:

    NOTE: You can also use Get to overwrite a project that you have checked out from the serverdatabase. Perform the Get for the project you want to overwrite, the project in your local databasewill be overwritten with the project from the server. Then check the project back in to the server.

    This will undo the lock for the project.

    Compiling Projects 0June 10, 2002

    Page 19-32

    Replace the first paragraph of the section with the following text:

    Once you have completed modifying the object definitions in your project, you need to compile thechanges and test them. You have the following compilation options:

    Full. Compiles all projects into a new Siebel repository (.srf) file.

    This will remove any inactive objects in the repository.

    Incremental. Compiles objects into an existing .srf file.

    To compile incrementally, you must have already done at least one full compilation. Doing anincremental compilation will remove inactive child objects from the repository, but not inactivetop-level objects.

    For example, if you inactivate the Name list column in the Account List Applet, and then compilethe Account SSE project, the Name list column will be removed. However, if you inactivate theAccount List Applet, and then compile the Account SSE project, the Account List Applet will still

    be there.

  • 8/4/2019 DocUp Tools 70x

    36/50

    36

    Compiling the Siebel Repository Using the Command-Line Interface 0December 5, 2002

    Page 19-35Replace the first paragraph on page 1043 with the following:

    You can also compile projects using the command-line interface. The command-line interface isinvoked from the siebdev executable using the command switch /bc. This command switchperforms a full compile. The siebdev.exe is located in the Bin directory of the Siebel Tools installationdirectory.

    Appendix A, Siebel Tools Menus and Toolbars 0December 5, 2002

    Help Menu 0

    Page A-18After the description of About Visible Views, add the following column descriptions:

    Visible. Indicates whether the view is visible based on all the other columns

    Application. Indicates whether the view is part of the application

    View. Indicates whether the view has been added to seed data

    Responsibility. Indicates whether the current user has the required responsibility to see thisview

    License. Indicates whether the user has a license key that exposes this view

    Platform. Indicates whether this view can run on the current platform

  • 8/4/2019 DocUp Tools 70x

    37/50

    37

    Appendix B, Tags 0

    swe: dir 0December 5, 2002

    Purpose:

    Used to create templates that can work with bidirectional languages. This tag gets converted todir=rtl when running in right-to-left languages. Does not generate anything in left-to-rightlanguages, as this is the default for the browser.

    Usage:

    Restrictions:

    Can be used within any HTML tag that takes the dir attribute

    swe: include 0June 10, 2002

    Page B-23Change the Usage and Attribute sections to read as follows:

    Usage:

    Attribute:

    File. Required. The name of the file to be included. This file must reside in the same folder as theother template files used by the application and have the extension .swt, even if it is an HTML file.

    swe:this.Id0

    December 5, 2002

    Purpose:

    Used to create scrollable tab bars for screens and views. This tag is used to generate a unique ID forthe HTML tag that contains each tab.

  • 8/4/2019 DocUp Tools 70x

    38/50

    38

    Usage:

    ...

    Restrictions:

    Should only be used in the HTML tag that contains a screen, view, or subview tab. This tag should be created within a or tag.

    swe:this.TableId 0December 5, 2002

    Purpose:

    Used to create scrollable tab bars for screens and views. This tag is used to generate a unique ID forthe HTML tag that contains the tabs.

    Usage:

    ...

    ...

    ...

    Restrictions:

  • 8/4/2019 DocUp Tools 70x

    39/50

    39

    Should only be used in the HTML tag that contains the screen, view, or subview tabs. This tag should be created within a , , or tag.

    Appendix E. Operators, Expressions, and Conditions 0

    Functions in Calculation Expressions 0June 10, 2002

    Page E-8In table E-5 replace the function Count (mvlink) with the following:

    Count (mvlink)

    In table E-5 add the following row to the table:

    Page E-14Add the following text to the Description field of the Timestamp() row ofTable E-5, Calculated Fieldand Validation Functions:

    The Timestamp function can also be used in queries. For example:

    Created >= Timestamp() - 0.1

    against an MS SQL Server database would return those records created within the last one-tenth ofa day.

    FunctionResultType Query Description

    InvokeServiceMethod("[ServiceName]","[MethodName]","[InputProp1=val1,InputProp2=val2]","[OutputProp")

    String No Invokes a business service from acalculated field and returns[Output Prop].

    Note: do not expose a calculated

    expression that invokes a businessservice in a list applet. Doing somay result in poor performancebecause the business service willbe repeatedly instantiated eachtime the field appears in the list.

  • 8/4/2019 DocUp Tools 70x

    40/50

    40

    Add the following note to the Description field of the Today() row ofTable E-5, Calculated Field andValidation Functions:

    NOTE: Running a query using the Today() function against fields of type DTYPE_DATE,DTYPE_DATETIME, and DTYPE_TIME can have varying results. For example, when using theToday() function against DTYPE_DATETIME fields, only records that have a TIME constituent equalto 00:00:00 will be returned if = Today() is used as a query operator.

    Page E-15

    Add the following section before Using Julian Functions:

    Using Datetime Fields in CalculationsIt is possible to perform calculations with datetime fields in calculated fields. When adding a numberto a datetime field, days are represented by integers and hours, minutes and seconds are representedby fractions.

    For example, to add one minute to the current date and time, use the following expression, which isderived from the fact that one day has 1,440 minutes:

    Timestamp() + 1/1440

    In this example the product delivery interval, measured in seconds, is added to the current date andtime:

    Timestamp() + [Product Delivery Interval]/86400

    NOTE: The Type property of the calculated field must be of type DTYPE_DATETIME.

    Syntax for Predefault Fields 0June 10, 2002

    Page E-17Change the name of the section to Syntax for Predefault and Postdefault Fields and add thefollowing text after the heading:

    The Pre Default Value property of a field (Predefault Value in the Object List Editor) automaticallyassigns a value to that field for a new record. The user can modify the field if it is displayed and notset to Read Only. For example, Currency Code has a predefault value of System: Currency. Thecurrency code for a new contact is automatically set to the default system currency.

    Th P t D f lt V l t f fi ld i l t fi ld if h t b t d b

  • 8/4/2019 DocUp Tools 70x

    41/50

    41

    The Post Default Value property of a field assigns a value to a field, if one has not been entered bythe user, before the record is written to the database. For example, Personal Contact has a postdefaultvalue of N. If the user does not designate a new contact as personal, the system assumes that it is

    not.

    Add the following rows to Table E-6 on page E-17:

    Change the Parent: BusComp.Field, BusComp.Field row ofTable E-6 to read as follows:

    Function Result Type Description

    System: OrganizationId String Organization ID (for example, 1-24E1).

    System: OrganizationName String Organization name (for example, Siebel Service).

    Function Result Type Description

    Parent: BusComp.Field,BusComp.Field String Value in parent business component field.The field in the parent business component must haveLink Specification set to TRUE for values to be defaulted.

    You can have multiple BusComp.Field constructsseparated by commas; the list is checked from first to lastuntil a value is found, for example:

    Parent: ServiceRequest.Account,

    Account.Name

    NOTE: A space is required after every comma separatingthe fields for this function to work correctly. If the businesscomponent has an apostrophe in its name, you mustenclose the name in double quotes, for example:

    Parent: FINS AG Agent's Contracts.Status

    Of Contract

    You can also terminate a chain of Parent calls with aSystem call, for example:

    Parent: 'Opportunity.Currency Code',

    'Account.Currency Code', System: Currency

    Change the Description field for the System: Currency row of Table E 6 Predefault Values and

  • 8/4/2019 DocUp Tools 70x

    42/50

    42

    Change the Description field for the System: Currency row ofTable E-6, Predefault Values andFunctions, to the following:

    Currency for this position (for example, USD). Determined by the setting for the Currency field inthe Divisions or Organizations view under the Group Administration screen.

    If the division has a different Currency setting from the organization, the division Currency settingwill be used.

    Calculated Field Values and Field Validation

  • 8/4/2019 DocUp Tools 70x

    43/50

    43

    Calculated Field Values and Field Validation 0December 5, 2002

    Page E-19December 5, 2002

    Add the following after the first paragraph:

    The validation property is evaluated when the field is accessed and modified in the GUI only. Thevalidation properties from the current applet's business component fields are evaluated. If thesefields are part of other business components as well, those validation properties are not evaluated.

    June 10, 2002

    Page E-20Add the following text to the end of the section:

    When a Calculated Value statement references more than one field value, and the fields havedifferent data types, the order of the data types can have an effect on the calculation.

    For example, the Quote Item business component has the calculated field Line Total, whosecalculated value is [Item Price] * [Quantity]. The data type of Item Price is DTYPE_INTEGER;the data types of both Quantity and Line Total is DTYPE_CURRENCY.

    If Item Price is 2.25 and Quantity is 5, Line Total is calculated to be 11.25. However, if the calculatedvalue of Line Total is changed to [Quantity] * [Item Price], using the same values Line Totalis calculated to be 11.00.

    Searching and Sorting on Division ID and Division Name 0June 10, 2002

    Page E-24Delete the phrase C++ in the sentence afterTo return the Division Id in eScript in the standardapplication. The sentence should read as follows:

    Use the following code:

    Appendix F User Properties

  • 8/4/2019 DocUp Tools 70x

    44/50

    44

    Appendix F, User Properties 0

    Aspect User Properties 0December 5, 2002

    Page F-4Add this new section to Appendix F.

    All of the aspect user proprieties are optional.

    Aspect (CSSBCBase)Syntax:

    Parent Object Type: Business Component

    Parent Object Type: Field

    Purpose:

    This feature provides a dynamic way to use the CSSBCBase class. When a particular aspect has beenset from the applet level or CSSBCBases default, CSSBCBase will change its behavior based on theaspect-related setting described in the user property:

    If Aspect BC ReadOnly:Aspectis defined, and the current aspect isAspect, the current record willbecome read-only when the value ofField Name is Y.

    If Aspect Child BC ReadOnly:Aspectis defined, and the current aspect isAspect, the currentrecords child business components will become read-only when the value ofField Name is Y.

    User Property Name Value

    Default Aspect Aspect

    Aspect BC ReadOnly:Aspect Field Name

    Aspect Child BC ReadOnly:Aspect Field Name

    Aspect BC NoInsert:Aspect Field Name

    User Property Name Value

    Aspect Default Value:Aspect Expression

    If Aspect BC NoInsert:Aspectis defined, and the current aspect isAspect, the user cannot insert

  • 8/4/2019 DocUp Tools 70x

    45/50

    45

    p p , p p ,new records when the value ofField Name is Y.

    NOTE: To use Aspect BC NoInsert:Aspect, you need to make sure that the value [Field Name](normally a calculated field) will not be changed when the user steps to a different record;otherwise runtime behavior will confuse the end user. Inproper configuration will make insertsdependent on the state of current records, which is most likely not what you want.

    For a particular business component field, if Aspect Default Value:Aspectis defined, and thecurrent aspect isAspect, the predefault value for this field will be the expression defined in the

    user property value.

    For example, if an activity business component has a Planned field with a field user propertyAspect Default Value: Planned defined that has a value of Timestamp(), the predefault value forthe activitys planned start date and time will be Timestamp().

    Aspect (CSSSWEFrameBase and CSSSWEFrameListBase)Syntax:

    Parent Object Type: Business Component

    Purpose:

    If the user property View Aspect* is defined for the current view, set and pass the aspect name tothe underlying (CSSBCBase) business component.

    If View Aspect* is not defined for the current view and Default Aspect is defined, set and pass theaspect name to the underlying (CSSBCBase) business component.

    User Property Name User Property Value

    View Aspect: View Name Aspect Name

    View Aspect View Name, Aspect Name

    View Aspect 1 View Name, Aspect Name

    View Aspect 2 View Name, Aspect Name

    Default Aspect Aspect Name

    Group Visibility 0

  • 8/4/2019 DocUp Tools 70x

    46/50

    46

    Group Visibility 0June 10, 2002

    Page F-20Add this new user property afterFileMustExist:

    Group Visibility Only 0June 10, 2002

    Page F-20Add this new user property afterGroup Visibility:

    Parent Object Type Business Component

    Description If set to TRUE, group + team visibility will be applied.

    Functional Area Campaign

    Parent Object Type Business Component

    Description If set to TRUE, only group visibility will be applied. If you set this toTRUE, set Group Visibility to FALSE.

    You might also want to inactivate Buscomp View Mode, so that itwill not do an inner join to the S_SRC_POSTN table.

    Functional Area Campaign

    MVG Set Primary Mode 0

  • 8/4/2019 DocUp Tools 70x

    47/50

    47

    yJune 10, 2002

    Page F-22The statement that this user property is unsupported is incorrect. Replace the text in the section with

    the following:

    Parent Object Type Business Component

    Description Setting this user property to All allows the Primary team member to

    be altered by someone other than the Manager or SiebelAdministrator. The default behavior is Manager.

    Only Siebel Administrators (in Admin mode) and Managers (inManager view mode) have the ability to change the Primary teammember on opportunities, accounts, and contacts.

    Usage Used in Siebel 6.x. For Siebel 7.0, use MVG Set Primary Restricted:visibility_mvlink_name.

    MVG Set Primary Restricted: visibility_mvlink_name 0

  • 8/4/2019 DocUp Tools 70x

    48/50

    48

    y yJune 10, 2002

    Page F-22Add the following new section:

    Parent Object Type Business Component

    Description Setting this user property to FALSE allows the Primary team memberto be altered by someone other than the Manager or SiebelAdministrator.

    If this user property is not set, only Siebel Administrators (in Adminmode) and Managers (in Manager view mode) have the ability tochange the Primary team member on opportunities, accounts andcontacts.

    Usage MVG Set Primary Restricted: visibility_mvlink_name,

    where

    visibility_mvlink_name is the value of the Visibility MVLink

    property of the BusComp View Mode child object of the businesscomponent for which you want to allow or restrict setting theprimary.

    For example, you want to allow sales representatives to set theprimary sales team members for contacts:

    1 Create a user property for the Contact Business componentcalled MVG Set Primary Restricted: Position.

    Position is the value of Visibility MVLink for the Sales Rep viewmode for Contact.

    2 Set the value of MVG Set Primary Restricted: Position to FALSE.

    Required 0

  • 8/4/2019 DocUp Tools 70x

    49/50

    49

    Set Primary Mode 0June 10, 2002

    Page F-30Delete this section. This user property is not supported.

    Appendix G, Configuration Guidelines 0June 10, 2002

    Specialized Business Component Classes 0

    Page G-9Add the following paragraph before the last note on page G-9:

    Use caution when customizing pick list field values. Many specialized business component classesrely on specific pick list values to function correctly.

    Applet Classes 0

    Page G-14Add the following paragraph before the last paragraph on page G-14:

    Use caution when customizing picklist field values. Many specialized business component classesrely on specific picklist values to function correctly.

    Parent Object Type Field

    Description Allows you to make the parent field a required field under certainconditions. You specifiy the condition by defining a caluclatedexpression for the value of the user property. See the Product fieldof the Quote Item business component for an exapample..

  • 8/4/2019 DocUp Tools 70x

    50/50

    50