The rewrite tool allows you to develop guidelines that modify asks for and also reactions as they travel throughCharles. Rules suchas incorporating or changing a header or hunt and substitute some message in the feedback body.
Rewrite Sets
Rewrite collections can be individually triggered and also deactivated. Eachset has a list of sites and policies. The locations pick the demands and also feedbacks on whichthe rules will certainly function.
Rewrite Guidelines
Eachrule describes a singular rewrite procedure. The rule may have an effect on the headers, the body, or even component of the request URL; it may operate on the request and or the action; it might then define searchand also switchout or only substitute style spinning and rewrite.
Type
The kind points out the type of rewording function to carry out. There are actually four various classifications of rewrite guideline kinds; header regulations, LINK guidelines, question parameter regulations, as well as physical body policies. The header as well as concern guideline rules impact the header industries and also query strand specifications specifically; adding, customizing or even getting rid of headers and also specifications. The LINK and also physical body rules do locate and also switchout on the various portion of the URL and on the body.
Where
Choose where towards relate the rewrite policy; on the request, action or each.
Match
The matchareas consist of the text message to matchin the request or even feedback to determine whether to fire this regulation. You can optionally leave behind the label or value blank, or even both, to matchany kind of market value. If you leave behind boththe name as well as worthfields empty you will certainly matchall requests/ actions.
Regex assistance might be made it possible for, supplying Perl-style routine phrases for your suit. If you consist of teams in your regular expression they might be utilized in the fit areas.
The rewrite tool field is actually a specific fit area unless regex is actually enabled, throughwhichsituation it supports partial matches. The title field is actually case-insensitive for eachregex and usual matching. The name area might be impaired if you are actually creating a rewrite guideline kind that does not demand it.
The value industry is a limited complement unless you switchon Suit whole market value throughwhichinstance it is a precise complement. The market value industry is actually case-insensitive for bothregex and also ordinary matching for header and also question parameter rules, as well as case-sensitive for LINK and also physical body regulations.
New/ Replace
The new/replace fields consist of the message to add or substitute in the ask for or even feedback when this rule is fired up. Leave rewrite tool either the label or even market value space to leave them the same as the matched name or value.
If regex assistance is allowed for the fit you may reference matchgroups using $1, $2 and so forth.
The practices of the label as well as market value fields hinges on the suit. If there is an equivalent matchthen the area functions as a substitute for the matched text, typically if the matchis empty at that point the industries changes the whole label or even worth.
The market value industry supports Replace First or even Replace All modes. The title field consistently works in replace-first setting if the name fit is a regex, otherwise it is a specific suit and also changes the entire title.
The label and or worthfields might be actually disabled if you are actually developing a rewrite guideline kind that doesn’t demand them.
Recommendations
Rewrite guidelines may be complicated to debug if they are certainly not working as you expect. It is usually better to build up a policy slowly along withrecurring screening.
Location Matching
Eachlocation suit might include procedure, host, port and also pathway designs to matchspecific URLs. Places might include wildcards. Even more support for creating area matches might be located when you add a brand new site to this rewrite tool.
Debugging
The rewrite tool may be toughto debug when your rewrite operation isn’t functioning as counted on. If you possess issue try featuring an extremely standard rule suchas one that incorporates an evident header, therefore you may observe whether your guidelines are matching the demand in any way. Additionally activate Debug in Error Record to acquire some debugging information published in the Mistake Log accessed from the Home window food selection in Charles.