Billing To Milan uses the MatterInput.sql file to create and update workspaces based on data read from your billing or accounting system. In order for Billing To Milan to make sense of this data, you must edit the MatterInput.sql file so that the client and matter information is mapped to fields recognized by Billing To Milan. Once that has been completed, you can run Billing To Milan in matters mode, which performs the following actions.
To minimize the number of billing entries processed by Billing To Milan, include the following condition in the WHERE clause:
AND LAST_MODIFIED >= '{0}'
Replace LAST_MODIFIED with the name of a billing data field that represents when a client-matter record has been updated in the billing system.
The following fields must be included in the MatterInput.sql file.
Field Names | Description |
---|---|
ClientID | Custom1 field |
ClientName | Custom1 Description field |
MatterID | Custom2 field |
MatterName | Custom2 Description field |
WorkspaceName | Naming format for new workspace |
TemplateId | ID of the folder template to be applied to the new workspace |
Note: Fields that require one or more WorkSite user IDs must be assigned user IDs that already exist in WorkSite.
Field Names | Description | ||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Server | The name of the WorkSite server (DMS) that hosts the database specified in the database field. If this field does not exist , Billing To Milan uses the server name specified in the dms-server application setting. | ||||||||||||||||||||
Database | The name of the WorkSite database where Billing To Milan will create the new workspace. If this field does not exist, Billing To Milan uses the database specified in the dms-database application setting. | ||||||||||||||||||||
Owner | The user ID of an existing WorkSite user who will be assigned ownership of the workspace. If this field is not set, Billing To Milan assigns ownership of the workspace to the NRTAdmin account used by Milan. | ||||||||||||||||||||
DefaultSecurity |
|
||||||||||||||||||||
MatterCategory | The name of WorkSite category in which to create the My Matters workspace shortcut. | ||||||||||||||||||||
FlatFilingDefaultFolder | The name of a folder, defined in the specified folder template (TemplateID), to which flatspace files will be moved if a suitable class-based folder does not exist. In the case where a workspace contains more than one folder with the given name, Milan moves files to the first matching folder. | ||||||||||||||||||||
MyMattersList | A comma-separated list of WorkSite users to which Billing To Milan adds My Matters shortcuts to the new workspace. | ||||||||||||||||||||
WorkspaceDescription | The description field for the new workspace. | ||||||||||||||||||||
WorkspaceID | The WorkSite moniker for an existing workspace. | ||||||||||||||||||||
OpenDate | By default, the value set for the OpenDate field is mapped to the imProfileCustom21 (CDATE1) field in WorkSite. This value must be cast in SQL smalldatetime format. | ||||||||||||||||||||
FullAccessGroups, ReadWriteGroups, ReadOnlyGroups, DeniedGroups | A comma-separated list of existing Milan groups to assign to an access group based on the WorkSite permissions level. | ||||||||||||||||||||
AppendTemplateID | The ID of a template to apply to workspaces. Only folders not already present in a workspace will be added. | ||||||||||||||||||||
RevisedTemplateID | The ID of a template to re-apply to workspaces after all existing empty folders have been deleted. |
Note: When updating the default security of a workspace from Billing to Milan, the existing security of that workspace is not removed until new security is specified while modifying the workspace.
Field Name | Description |
---|---|
imProfileCustom<1-12, 13-30> | Values for the corresponding WorkSite custom fields. |
imProfileCustom<1-12, 29, 30>Description | Descriptions for the corresponding WorkSite custom fields. |
imProfileClass | WorkSite Class value. |
imProfileSubClass | WorkSite SubClass value. |
imProfileSubType | WorkSite SubType value. |
The following fields are used to map users IDs to different attorney/secretary roles.
Field Name | User ID of |
---|---|
BillingAtty | Billing attorney |
BillingAttySecy | Secretary of the billing attorney |
HandlingAtty | Handling attorney |
HandlingAttySecy | Secretary of the handling attorney |
OrigAtty | Originating attorney |
OrigAttySecy | Secretary of the originating attorney |
RespAtty | Responsible attorney |
RespAttySecy | Secretary of the responsible attorney |
SupAtty | Supervising attorney |
SupAttySecy | Secretary of the supervising attorney |
To add a matter to the My Matters of a user designated as the billing, originating, responsible, or supervising attorney, the corresponding field below must be set to 1. If more than one attorney has been assigned to these roles, the value of the corresponding application setting must be set to 1.
Field Name | Attorney Role | Application Setting |
---|---|---|
BillingAttyAddToMyMatters | Billing attorney (BillingAtty) | add-to-my-matters-billing-attorney |
OrigAttyAddToMyMatters | Originating attorney (OrigAtty) | add-to-my-matters-orig-attorney |
RespAttyAddToMyMatters | Responsible attorney (RespAtty) | add-to-my-matters-responsible-attorney |
SupAttyAddToMyMatters | Supervising attorney (SupAtty) | add-to-my-matters-sup-attorney |
The following fields specify the Milan role to be assigned to specific attorneys and secretaries. The Milan role name is mapped to the Name field in the Role table of the Milan database.
Field Name | Name of the Milan Role for |
---|---|
BillingAttyRole | Billing attorney |
BillingAttySecyRole | Billing attorney's secretary |
HandlingAttyRole | Handling attorney |
OrigAttyRole | Originating attorney |
HandlingAttySecyRole | Handling attorney's secretary |
OrigAttySecyRole | Originating attorney's secretary |
RespAttyRole | Responsible attorney |
RespAttySecyRole | Responsible attorney's secretary |
SupAttyRole | Supervising attorney |
SupAttySecyRole | Supervising attorney's secretary |
The following fields specify the matter team permissions level for the given secretary. Valid values are listed in the table below.
Field Name | Matter Team Permission Level For |
---|---|
BillingAttySecyMilanRights | Billing attorney's secretary |
HandlingAttySecyMilanRights | Handling attorney's secretary |
OrigAttySecyMilanRights | Originating attorney secretary |
RespAttySecyMilanRights | Responsible attorney's secretary |
SupAttySecyMilanRights | Supervising attorney's secretary |
Value | Permissions |
---|---|
read | Read access |
readwrite | Read/Write access |
readwritecreatefolder | Read/Write, Create Folder |
readwritecreatefoldermanageteam | Read/Write, Create Folder, Manage Matter Team |
The matter team groups for a workspace can be given custom names with the following fields. If no value is specified for a group that has one or more members, Milan will create the group using the default naming convention.
Field Name | Custom Name For | Default Group Name |
---|---|---|
FAMatterTeamGroup | Full Access group | z_client_matter_fullaccess_team |
RWMatterTeamGroup | Read/Write group | z_client_matter_team |
RMatterTeamGroup | Read group | z_client_matter_readonly_team |
To add members to a matter team group, set the value of the corresponding group members field to a comma-separated list of WorkSite users.
Field Name | Adds Users to |
---|---|
FAMatterTeamGroupMembers | Full Access matter team group. |
RWMatterTeamGroupMembers | Read/Write matter team group. |
RMatterTeamGroupMembers | Read matter team group. |
The following script maps the fields in an Elite database to the fields required by Billing To Milan and assigns folder templates based on the area of law.
SELECT top 500 left(m.mmatter,6) AS ClientID,
Right(m.mmatter,4) AS MatterID,
c.clname1 AS ClientName,
m.mdesc1 AS MatterName,
m.mstatus AS imProfileCustom6, --MatterStatus field
m.mopendt AS imProfileCustom21, --OpenDate
m.mclosedt AS imProfileCustom22, --CloseDate
m.mloc AS imProfileCustom3, --Office
m.mprac AS imProfileCustom3, --Practice
LEFT(m.mdept,4) + RIGHT(m.mdept,2) AS imProfileCustom4, --AreaLaw
NULL AS RespAtty,
NULL AS HandlingAtty,
usb.ufullname AS BillingAtty,
uso.ufullname AS OrigAtty,
uss.ufullname AS SupAtty,
m.mdesc1 AS WorkspaceName,
m.mdesc1 AS WorkspaceDescription CASE
WHEN m.mdept = '254' THEN 'template-100'
WHEN m.mdept = '325' THEN 'template-1'
ELSE 'template-5'
END AS TemplateId,
'30' AS DefaultSecurity --public default security
FROM matter m
LEFT JOIN client c ON c.clnum = left(m.mmatter,6)
LEFT JOIN uaccess uab ON m.mbillaty = uab.wvtkinit
LEFT JOIN uaccess uao ON m.morgaty = uao.wvtkinit
LEFT JOIN uaccess uas ON m.msupaty = uas.wvtkinit
LEFT JOIN usmaster usb ON uab.uname = usb.userid
LEFT JOIN usmaster uso ON uao.uname = uso.userid
LEFT JOIN usmaster uss ON uas.uname = uss.userid
WHERE ISNumeric(left(mmatter,6)) = 1 --and ISNumeric(right(mmatter,4)) = 1
AND CHARINDEX('-',reverse(mmatter)) = 5
AND m.mmoddate >= '{0}'