summaryrefslogtreecommitdiff
path: root/BUILD/Help/html/advanced/Macros.html
blob: a513f458593d8df9d615d738aa084d43975e5609 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<HTML>
<HEAD>
	<META HTTP-EQUIV="CONTENT-TYPE" CONTENT="text/html; charset=windows-1252">
	<TITLE></TITLE>
	<META NAME="GENERATOR" CONTENT="OpenOffice.org 3.2  (Win32)">
	<META NAME="CREATED" CONTENT="20091206;16574000">
	<META NAME="CHANGED" CONTENT="20110718;14131000">
	<META NAME="Info 1" CONTENT="">
	<META NAME="Info 2" CONTENT="">
	<META NAME="Info 3" CONTENT="">
	<META NAME="Info 4" CONTENT="">
	<STYLE TYPE="text/css">
	<!--
		@page { margin: 2cm }
		P { margin-bottom: 0.21cm }
		H3 { margin-bottom: 0.21cm }
		H3.western { font-family: "Arial", sans-serif }
		H3.cjk { font-family: "MS Mincho" }
		H3.ctl { font-family: "Mangal" }
		A:link { so-language: zxx }
	-->
	</STYLE>
</HEAD>
<BODY LANG="de-DE" DIR="LTR">
<H3 CLASS="western"><FONT FACE="Tahoma, sans-serif">Macros</FONT></H3>
<P STYLE="margin-bottom: 0cm"><BR>
</P>
<P STYLE="margin-bottom: 0cm"><FONT FACE="Tahoma, sans-serif">All
directory names may contain macros that are expanded during
synchronization. Begin and end of each macro is marked by a '%'
character. Besides special macros handling time and date, the
<U>operating system's environment variables</U> can also be used.</FONT></P>
<P STYLE="margin-bottom: 0cm"><BR>
</P>
<P STYLE="margin-bottom: 0cm"><FONT FACE="Tahoma, sans-serif"><B>Internal
macros:</B></FONT></P>
<UL>
	<P><SPAN ID="Rahmen4" DIR="LTR" STYLE="float: left; width: 80%; height: 0.14cm; border: none; padding: 0cm; background: #e6e6e6">
		<UL>
			<P ALIGN=LEFT STYLE="margin-right: 0.98cm; margin-bottom: 0cm"><FONT FACE="Tahoma, sans-serif"><FONT FACE="Courier New, monospace">%time%&nbsp;&nbsp;&nbsp;&nbsp;-
			</FONT>current time, format [hhmmss], e. g. &quot;<FONT FACE="Courier New, monospace">201340</FONT>&quot;<BR><FONT FACE="Courier New, monospace">%date%&nbsp;&nbsp;&nbsp;&nbsp;-
			</FONT>current date, e. g. &quot;<FONT FACE="Courier New, monospace">2010-07-13</FONT>&quot;<BR><BR><FONT FACE="Courier New, monospace">%weekday%&nbsp;-
			</FONT>day of the week, e. g. &quot;<FONT FACE="Courier New, monospace">Monday</FONT>&quot;<BR><FONT FACE="Courier New, monospace">%week%&nbsp;&nbsp;&nbsp;&nbsp;-
			</FONT>calendar week, e. g. &quot;<FONT FACE="Courier New, monospace">28</FONT>&quot;<BR><BR><FONT FACE="Courier New, monospace">%day%&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;-
			</FONT>current day, e. g. &quot;<FONT FACE="Courier New, monospace">21</FONT>&quot;<BR><FONT FACE="Courier New, monospace">%month%&nbsp;&nbsp;&nbsp;-
			</FONT>current month, e. g. &quot;<FONT FACE="Courier New, monospace">July</FONT>&quot;<BR><FONT FACE="Courier New, monospace">%year%&nbsp;&nbsp;&nbsp;&nbsp;-
			</FONT>current year, e. g. &quot;<FONT FACE="Courier New, monospace">2010</FONT>&quot;<BR><BR><FONT FACE="Courier New, monospace">%hour%&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;-
			</FONT>current hour, e. g. &quot;<FONT FACE="Courier New, monospace">20</FONT>&quot;<BR><FONT FACE="Courier New, monospace">%min%&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;-
			</FONT>current minute, e. g. &quot;<FONT FACE="Courier New, monospace">13</FONT>&quot;<BR><FONT FACE="Courier New, monospace">%sec%&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;-
			</FONT>current second, e. g. &quot;<FONT FACE="Courier New, monospace">40</FONT>&quot;</FONT></P>
		</UL>
	</SPAN><BR CLEAR=LEFT>
	</P>
</UL>
<P STYLE="margin-bottom: 0cm"><BR>
</P>
<P STYLE="margin-bottom: 0cm"><FONT FACE="Tahoma, sans-serif"><B>Hint:</B></FONT></P>
<P STYLE="margin-bottom: 0cm"><FONT FACE="Tahoma, sans-serif">You can
add a great amount of flexibility to Batch Synchronization
(*.ffs_batch) by creating new temporary environment variables in a
*.bat/*.cmd file that are evaluated by FreeFileSync at runtime!</FONT></P>
<P STYLE="margin-bottom: 0cm"><BR>
</P>
<P STYLE="margin-bottom: 0cm"><FONT FACE="Tahoma, sans-serif"><B>Example:</B></FONT></P>
<UL>
	<P><SPAN ID="Rahmen1" DIR="LTR" STYLE="float: left; width: 80%; height: 0.14cm; border: none; padding: 0cm; background: #e6e6e6">
		<UL>
			<LI><P ALIGN=LEFT STYLE="margin-right: 0.98cm; margin-bottom: 0cm">
			<FONT FACE="Tahoma, sans-serif"><FONT FACE="Courier New, monospace">C:\Backup\%username%_Config&nbsp;</FONT>expands
			to<FONT FACE="Courier New, monospace"><BR>C:\Backup\ZenJu_Config</FONT></FONT></P>
			<LI><P ALIGN=LEFT STYLE="margin-right: 0.98cm; margin-bottom: 0cm">
			<FONT FACE="Tahoma, sans-serif"><FONT FACE="Courier New, monospace">%appdata%\FreeFileSync&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</FONT>expands
			to<FONT FACE="Courier New, monospace"><BR>C:\Documents and
			Settings\ZenJu\Application Data\FreeFileSync</FONT></FONT></P>
		</UL>
	</SPAN><BR CLEAR=LEFT>
	</P>
</UL>
<P STYLE="margin-bottom: 0cm"><BR>
</P>
<P STYLE="margin-bottom: 0cm"><FONT FACE="Tahoma, sans-serif"><B>Example:</B></FONT></P>
<P STYLE="margin-bottom: 0cm"><FONT FACE="Tahoma, sans-serif">The
batch configuration file <FONT FACE="Courier New, monospace">C:\SyncJob.ffs_batch
</FONT>contains macro <FONT FACE="Courier New, monospace">%MyVar%
</FONT>instead of an absolute target directory and is invoked by a
*.cmd file:</FONT></P>
<UL>
	<P><SPAN ID="Rahmen2" DIR="LTR" STYLE="float: left; width: 80%; height: 0.14cm; border: none; padding: 0cm; background: #e6e6e6">
		<UL>
			<P ALIGN=LEFT STYLE="margin-right: 0.98cm; margin-bottom: 0cm"><FONT FACE="Tahoma, sans-serif"><FONT FACE="Courier New, monospace">set
			MyVar=C:\Target<BR>cd &quot;C:\Program
			files\FreeFileSync&quot;<BR>FreeFileSync.exe C:\SyncJob.ffs_batch
			</FONT>(-&gt;<FONT FACE="Courier New, monospace">%MyVar% </FONT>is
			replaced by <FONT FACE="Courier New, monospace">C:\Target </FONT>during
			execution)</FONT></P>
		</UL>
	</SPAN><BR CLEAR=LEFT>
	</P>
</UL>
<P STYLE="margin-bottom: 0cm"><BR>
</P>
<UL>
	<P><SPAN ID="Rahmen3" DIR="LTR" STYLE="float: left; width: 80%; height: 0.14cm; border: 1px solid #000080; padding: 0.05cm; background: #ccccff">
		<P ALIGN=LEFT STYLE="margin-left: 0.79cm; margin-right: 0.98cm; margin-bottom: 0cm">
		<FONT FACE="Tahoma, sans-serif"><B>Note:</B><BR>Temporary
		environment variables created with the &quot;<FONT FACE="Courier New, monospace">set</FONT>&quot;
		command are only valid if the batch job is started by calling the
		executable directly! Using &quot;<FONT FACE="Courier New, monospace">start
		/wait</FONT>&quot; or relying on Shell Execute creates a new
		program context without these temporal variables.</FONT></P>
	</SPAN><BR CLEAR=LEFT>
	</P>
</UL>
</BODY>
</HTML>
bgstack15