2
0

forms.py 58 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394959697989910010110210310410510610710810911011111211311411511611711811912012112212312412512612712812913013113213313413513613713813914014114214314414514614714814915015115215315415515615715815916016116216316416516616716816917017117217317417517617717817918018118218318418518618718818919019119219319419519619719819920020120220320420520620720820921021121221321421521621721821922022122222322422522622722822923023123223323423523623723823924024124224324424524624724824925025125225325425525625725825926026126226326426526626726826927027127227327427527627727827928028128228328428528628728828929029129229329429529629729829930030130230330430530630730830931031131231331431531631731831932032132232332432532632732832933033133233333433533633733833934034134234334434534634734834935035135235335435535635735835936036136236336436536636736836937037137237337437537637737837938038138238338438538638738838939039139239339439539639739839940040140240340440540640740840941041141241341441541641741841942042142242342442542642742842943043143243343443543643743843944044144244344444544644744844945045145245345445545645745845946046146246346446546646746846947047147247347447547647747847948048148248348448548648748848949049149249349449549649749849950050150250350450550650750850951051151251351451551651751851952052152252352452552652752852953053153253353453553653753853954054154254354454554654754854955055155255355455555655755855956056156256356456556656756856957057157257357457557657757857958058158258358458558658758858959059159259359459559659759859960060160260360460560660760860961061161261361461561661761861962062162262362462562662762862963063163263363463563663763863964064164264364464564664764864965065165265365465565665765865966066166266366466566666766866967067167267367467567667767867968068168268368468568668768868969069169269369469569669769869970070170270370470570670770870971071171271371471571671771871972072172272372472572672772872973073173273373473573673773873974074174274374474574674774874975075175275375475575675775875976076176276376476576676776876977077177277377477577677777877978078178278378478578678778878979079179279379479579679779879980080180280380480580680780880981081181281381481581681781881982082182282382482582682782882983083183283383483583683783883984084184284384484584684784884985085185285385485585685785885986086186286386486586686786886987087187287387487587687787887988088188288388488588688788888989089189289389489589689789889990090190290390490590690790890991091191291391491591691791891992092192292392492592692792892993093193293393493593693793893994094194294394494594694794894995095195295395495595695795895996096196296396496596696796896997097197297397497597697797897998098198298398498598698798898999099199299399499599699799899910001001100210031004100510061007100810091010101110121013101410151016101710181019102010211022102310241025102610271028102910301031103210331034103510361037103810391040104110421043104410451046104710481049105010511052105310541055105610571058105910601061106210631064106510661067106810691070107110721073107410751076107710781079108010811082108310841085108610871088108910901091109210931094109510961097109810991100110111021103110411051106110711081109111011111112111311141115111611171118111911201121112211231124112511261127112811291130113111321133113411351136113711381139114011411142114311441145114611471148114911501151115211531154115511561157115811591160116111621163116411651166116711681169117011711172117311741175117611771178117911801181118211831184118511861187118811891190119111921193119411951196119711981199120012011202120312041205120612071208120912101211121212131214121512161217121812191220122112221223122412251226122712281229123012311232123312341235123612371238123912401241124212431244124512461247124812491250125112521253125412551256125712581259126012611262126312641265126612671268126912701271127212731274127512761277127812791280128112821283128412851286128712881289129012911292129312941295129612971298129913001301130213031304130513061307130813091310131113121313131413151316131713181319132013211322132313241325132613271328132913301331133213331334133513361337133813391340134113421343134413451346134713481349135013511352135313541355135613571358135913601361136213631364136513661367136813691370137113721373137413751376137713781379138013811382138313841385138613871388138913901391139213931394139513961397139813991400140114021403140414051406140714081409141014111412141314141415141614171418141914201421142214231424142514261427142814291430143114321433143414351436143714381439144014411442144314441445144614471448144914501451145214531454145514561457145814591460146114621463146414651466146714681469147014711472147314741475147614771478147914801481148214831484148514861487148814891490149114921493149414951496149714981499150015011502150315041505150615071508150915101511151215131514151515161517151815191520152115221523152415251526152715281529153015311532153315341535153615371538153915401541154215431544154515461547154815491550155115521553155415551556155715581559156015611562156315641565156615671568156915701571157215731574157515761577157815791580158115821583158415851586158715881589159015911592159315941595159615971598159916001601160216031604160516061607160816091610161116121613161416151616161716181619162016211622162316241625162616271628
  1. from mptt.forms import TreeNodeChoiceField
  2. import re
  3. from django import forms
  4. from django.contrib.postgres.forms.array import SimpleArrayField
  5. from django.core.exceptions import ValidationError
  6. from django.db.models import Count, Q
  7. from extras.forms import CustomFieldForm, CustomFieldBulkEditForm, CustomFieldFilterForm
  8. from ipam.models import IPAddress
  9. from tenancy.forms import TenancyForm
  10. from tenancy.models import Tenant
  11. from utilities.forms import (
  12. APISelect, add_blank_choice, ArrayFieldSelectMultiple, BootstrapMixin, BulkEditForm, BulkEditNullBooleanSelect,
  13. BulkImportForm, ChainedFieldsMixin, ChainedModelChoiceField, CommentField, CSVDataField, ExpandableNameField,
  14. FilterChoiceField, FlexibleModelChoiceField, Livesearch, SelectWithDisabled, SmallTextarea, SlugField,
  15. FilterTreeNodeMultipleChoiceField,
  16. )
  17. from .formfields import MACAddressFormField
  18. from .models import (
  19. DeviceBay, DeviceBayTemplate, CONNECTION_STATUS_CHOICES, CONNECTION_STATUS_PLANNED, CONNECTION_STATUS_CONNECTED,
  20. ConsolePort, ConsolePortTemplate, ConsoleServerPort, ConsoleServerPortTemplate, Device, DeviceRole, DeviceType,
  21. Interface, IFACE_FF_CHOICES, IFACE_FF_LAG, IFACE_ORDERING_CHOICES, InterfaceConnection, InterfaceTemplate,
  22. Manufacturer, InventoryItem, Platform, PowerOutlet, PowerOutletTemplate, PowerPort, PowerPortTemplate,
  23. RACK_TYPE_CHOICES, RACK_WIDTH_CHOICES, Rack, RackGroup, RackReservation, RackRole, Region, Site, STATUS_CHOICES,
  24. SUBDEVICE_ROLE_CHILD, SUBDEVICE_ROLE_PARENT, VIRTUAL_IFACE_TYPES,
  25. )
  26. FORM_STATUS_CHOICES = [
  27. ['', '---------'],
  28. ]
  29. FORM_STATUS_CHOICES += STATUS_CHOICES
  30. DEVICE_BY_PK_RE = '{\d+\}'
  31. def get_device_by_name_or_pk(name):
  32. """
  33. Attempt to retrieve a device by either its name or primary key ('{pk}').
  34. """
  35. if re.match(DEVICE_BY_PK_RE, name):
  36. pk = name.strip('{}')
  37. device = Device.objects.get(pk=pk)
  38. else:
  39. device = Device.objects.get(name=name)
  40. return device
  41. def validate_connection_status(value):
  42. """
  43. Custom validator for connection statuses. value must be either "planned" or "connected" (case-insensitive).
  44. """
  45. if value.lower() not in ['planned', 'connected']:
  46. raise ValidationError('Invalid connection status ({}); must be either "planned" or "connected".'.format(value))
  47. class DeviceComponentForm(BootstrapMixin, forms.Form):
  48. """
  49. Allow inclusion of the parent device as context for limiting field choices.
  50. """
  51. def __init__(self, device, *args, **kwargs):
  52. self.device = device
  53. super(DeviceComponentForm, self).__init__(*args, **kwargs)
  54. #
  55. # Regions
  56. #
  57. class RegionForm(BootstrapMixin, forms.ModelForm):
  58. slug = SlugField()
  59. class Meta:
  60. model = Region
  61. fields = ['parent', 'name', 'slug']
  62. #
  63. # Sites
  64. #
  65. class SiteForm(BootstrapMixin, TenancyForm, CustomFieldForm):
  66. region = TreeNodeChoiceField(queryset=Region.objects.all(), required=False)
  67. slug = SlugField()
  68. comments = CommentField()
  69. class Meta:
  70. model = Site
  71. fields = [
  72. 'name', 'slug', 'region', 'tenant_group', 'tenant', 'facility', 'asn', 'physical_address',
  73. 'shipping_address', 'contact_name', 'contact_phone', 'contact_email', 'comments',
  74. ]
  75. widgets = {
  76. 'physical_address': SmallTextarea(attrs={'rows': 3}),
  77. 'shipping_address': SmallTextarea(attrs={'rows': 3}),
  78. }
  79. help_texts = {
  80. 'name': "Full name of the site",
  81. 'facility': "Data center provider and facility (e.g. Equinix NY7)",
  82. 'asn': "BGP autonomous system number",
  83. 'physical_address': "Physical location of the building (e.g. for GPS)",
  84. 'shipping_address': "If different from the physical address"
  85. }
  86. class SiteFromCSVForm(forms.ModelForm):
  87. region = forms.ModelChoiceField(
  88. Region.objects.all(), to_field_name='name', required=False, error_messages={
  89. 'invalid_choice': 'Tenant not found.'
  90. }
  91. )
  92. tenant = forms.ModelChoiceField(
  93. Tenant.objects.all(), to_field_name='name', required=False, error_messages={
  94. 'invalid_choice': 'Tenant not found.'
  95. }
  96. )
  97. class Meta:
  98. model = Site
  99. fields = [
  100. 'name', 'slug', 'region', 'tenant', 'facility', 'asn', 'contact_name', 'contact_phone', 'contact_email',
  101. ]
  102. class SiteImportForm(BootstrapMixin, BulkImportForm):
  103. csv = CSVDataField(csv_form=SiteFromCSVForm)
  104. class SiteBulkEditForm(BootstrapMixin, CustomFieldBulkEditForm):
  105. pk = forms.ModelMultipleChoiceField(queryset=Site.objects.all(), widget=forms.MultipleHiddenInput)
  106. region = TreeNodeChoiceField(queryset=Region.objects.all(), required=False)
  107. tenant = forms.ModelChoiceField(queryset=Tenant.objects.all(), required=False)
  108. asn = forms.IntegerField(min_value=1, max_value=4294967295, required=False, label='ASN')
  109. class Meta:
  110. nullable_fields = ['region', 'tenant', 'asn']
  111. class SiteFilterForm(BootstrapMixin, CustomFieldFilterForm):
  112. model = Site
  113. q = forms.CharField(required=False, label='Search')
  114. region = FilterTreeNodeMultipleChoiceField(
  115. queryset=Region.objects.annotate(filter_count=Count('sites')),
  116. to_field_name='slug',
  117. required=False,
  118. )
  119. tenant = FilterChoiceField(
  120. queryset=Tenant.objects.annotate(filter_count=Count('sites')),
  121. to_field_name='slug',
  122. null_option=(0, 'None')
  123. )
  124. #
  125. # Rack groups
  126. #
  127. class RackGroupForm(BootstrapMixin, forms.ModelForm):
  128. slug = SlugField()
  129. class Meta:
  130. model = RackGroup
  131. fields = ['site', 'name', 'slug']
  132. class RackGroupFilterForm(BootstrapMixin, forms.Form):
  133. site = FilterChoiceField(queryset=Site.objects.annotate(filter_count=Count('rack_groups')), to_field_name='slug')
  134. #
  135. # Rack roles
  136. #
  137. class RackRoleForm(BootstrapMixin, forms.ModelForm):
  138. slug = SlugField()
  139. class Meta:
  140. model = RackRole
  141. fields = ['name', 'slug', 'color']
  142. #
  143. # Racks
  144. #
  145. class RackForm(BootstrapMixin, TenancyForm, CustomFieldForm):
  146. group = ChainedModelChoiceField(
  147. queryset=RackGroup.objects.all(),
  148. chains={'site': 'site'},
  149. required=False,
  150. widget=APISelect(
  151. api_url='/api/dcim/rack-groups/?site_id={{site}}',
  152. )
  153. )
  154. comments = CommentField()
  155. class Meta:
  156. model = Rack
  157. fields = [
  158. 'site', 'group', 'name', 'facility_id', 'tenant_group', 'tenant', 'role', 'type', 'width', 'u_height',
  159. 'desc_units', 'comments',
  160. ]
  161. help_texts = {
  162. 'site': "The site at which the rack exists",
  163. 'name': "Organizational rack name",
  164. 'facility_id': "The unique rack ID assigned by the facility",
  165. 'u_height': "Height in rack units",
  166. }
  167. widgets = {
  168. 'site': forms.Select(attrs={'filter-for': 'group'}),
  169. }
  170. class RackFromCSVForm(forms.ModelForm):
  171. site = forms.ModelChoiceField(queryset=Site.objects.all(), to_field_name='name',
  172. error_messages={'invalid_choice': 'Site not found.'})
  173. group_name = forms.CharField(required=False)
  174. tenant = forms.ModelChoiceField(Tenant.objects.all(), to_field_name='name', required=False,
  175. error_messages={'invalid_choice': 'Tenant not found.'})
  176. role = forms.ModelChoiceField(RackRole.objects.all(), to_field_name='name', required=False,
  177. error_messages={'invalid_choice': 'Role not found.'})
  178. type = forms.CharField(required=False)
  179. class Meta:
  180. model = Rack
  181. fields = ['site', 'group_name', 'name', 'facility_id', 'tenant', 'role', 'type', 'width', 'u_height',
  182. 'desc_units']
  183. def clean(self):
  184. site = self.cleaned_data.get('site')
  185. group = self.cleaned_data.get('group_name')
  186. # Validate rack group
  187. if site and group:
  188. try:
  189. self.instance.group = RackGroup.objects.get(site=site, name=group)
  190. except RackGroup.DoesNotExist:
  191. self.add_error('group_name', "Invalid rack group ({})".format(group))
  192. def clean_type(self):
  193. rack_type = self.cleaned_data['type']
  194. if not rack_type:
  195. return None
  196. try:
  197. choices = {v.lower(): k for k, v in RACK_TYPE_CHOICES}
  198. return choices[rack_type.lower()]
  199. except KeyError:
  200. raise forms.ValidationError('Invalid rack type ({}). Valid choices are: {}.'.format(
  201. rack_type,
  202. ', '.join({v: k for k, v in RACK_TYPE_CHOICES}),
  203. ))
  204. class RackImportForm(BootstrapMixin, BulkImportForm):
  205. csv = CSVDataField(csv_form=RackFromCSVForm)
  206. class RackBulkEditForm(BootstrapMixin, CustomFieldBulkEditForm):
  207. pk = forms.ModelMultipleChoiceField(queryset=Rack.objects.all(), widget=forms.MultipleHiddenInput)
  208. site = forms.ModelChoiceField(queryset=Site.objects.all(), required=False, label='Site')
  209. group = forms.ModelChoiceField(queryset=RackGroup.objects.all(), required=False, label='Group')
  210. tenant = forms.ModelChoiceField(queryset=Tenant.objects.all(), required=False)
  211. role = forms.ModelChoiceField(queryset=RackRole.objects.all(), required=False)
  212. type = forms.ChoiceField(choices=add_blank_choice(RACK_TYPE_CHOICES), required=False, label='Type')
  213. width = forms.ChoiceField(choices=add_blank_choice(RACK_WIDTH_CHOICES), required=False, label='Width')
  214. u_height = forms.IntegerField(required=False, label='Height (U)')
  215. desc_units = forms.NullBooleanField(required=False, widget=BulkEditNullBooleanSelect, label='Descending units')
  216. comments = CommentField(widget=SmallTextarea)
  217. class Meta:
  218. nullable_fields = ['group', 'tenant', 'role', 'comments']
  219. class RackFilterForm(BootstrapMixin, CustomFieldFilterForm):
  220. model = Rack
  221. q = forms.CharField(required=False, label='Search')
  222. site = FilterChoiceField(
  223. queryset=Site.objects.annotate(filter_count=Count('racks')),
  224. to_field_name='slug'
  225. )
  226. group_id = FilterChoiceField(
  227. queryset=RackGroup.objects.select_related('site').annotate(filter_count=Count('racks')),
  228. label='Rack group',
  229. null_option=(0, 'None')
  230. )
  231. tenant = FilterChoiceField(
  232. queryset=Tenant.objects.annotate(filter_count=Count('racks')),
  233. to_field_name='slug',
  234. null_option=(0, 'None')
  235. )
  236. role = FilterChoiceField(
  237. queryset=RackRole.objects.annotate(filter_count=Count('racks')),
  238. to_field_name='slug',
  239. null_option=(0, 'None')
  240. )
  241. #
  242. # Rack reservations
  243. #
  244. class RackReservationForm(BootstrapMixin, forms.ModelForm):
  245. units = SimpleArrayField(forms.IntegerField(), widget=ArrayFieldSelectMultiple(attrs={'size': 10}))
  246. class Meta:
  247. model = RackReservation
  248. fields = ['units', 'description']
  249. def __init__(self, *args, **kwargs):
  250. super(RackReservationForm, self).__init__(*args, **kwargs)
  251. # Populate rack unit choices
  252. self.fields['units'].widget.choices = self._get_unit_choices()
  253. def _get_unit_choices(self):
  254. rack = self.instance.rack
  255. reserved_units = []
  256. for resv in rack.reservations.exclude(pk=self.instance.pk):
  257. for u in resv.units:
  258. reserved_units.append(u)
  259. unit_choices = [(u, {'label': str(u), 'disabled': u in reserved_units}) for u in rack.units]
  260. return unit_choices
  261. class RackReservationFilterForm(BootstrapMixin, forms.Form):
  262. q = forms.CharField(required=False, label='Search')
  263. site = FilterChoiceField(
  264. queryset=Site.objects.annotate(filter_count=Count('racks__reservations')),
  265. to_field_name='slug'
  266. )
  267. group_id = FilterChoiceField(
  268. queryset=RackGroup.objects.select_related('site').annotate(filter_count=Count('racks__reservations')),
  269. label='Rack group',
  270. null_option=(0, 'None')
  271. )
  272. #
  273. # Manufacturers
  274. #
  275. class ManufacturerForm(BootstrapMixin, forms.ModelForm):
  276. slug = SlugField()
  277. class Meta:
  278. model = Manufacturer
  279. fields = ['name', 'slug']
  280. #
  281. # Device types
  282. #
  283. class DeviceTypeForm(BootstrapMixin, CustomFieldForm):
  284. slug = SlugField(slug_source='model')
  285. class Meta:
  286. model = DeviceType
  287. fields = ['manufacturer', 'model', 'slug', 'part_number', 'u_height', 'is_full_depth', 'is_console_server',
  288. 'is_pdu', 'is_network_device', 'subdevice_role', 'interface_ordering', 'comments']
  289. labels = {
  290. 'interface_ordering': 'Order interfaces by',
  291. }
  292. class DeviceTypeBulkEditForm(BootstrapMixin, CustomFieldBulkEditForm):
  293. pk = forms.ModelMultipleChoiceField(queryset=DeviceType.objects.all(), widget=forms.MultipleHiddenInput)
  294. manufacturer = forms.ModelChoiceField(queryset=Manufacturer.objects.all(), required=False)
  295. u_height = forms.IntegerField(min_value=1, required=False)
  296. is_full_depth = forms.NullBooleanField(required=False, widget=BulkEditNullBooleanSelect, label='Is full depth')
  297. interface_ordering = forms.ChoiceField(choices=add_blank_choice(IFACE_ORDERING_CHOICES), required=False)
  298. is_console_server = forms.NullBooleanField(required=False, widget=BulkEditNullBooleanSelect, label='Is full depth')
  299. is_pdu = forms.NullBooleanField(required=False, widget=BulkEditNullBooleanSelect, label='Is a PDU')
  300. is_network_device = forms.NullBooleanField(
  301. required=False, widget=BulkEditNullBooleanSelect, label='Is a network device'
  302. )
  303. class Meta:
  304. nullable_fields = []
  305. class DeviceTypeFilterForm(BootstrapMixin, CustomFieldFilterForm):
  306. model = DeviceType
  307. q = forms.CharField(required=False, label='Search')
  308. manufacturer = FilterChoiceField(
  309. queryset=Manufacturer.objects.annotate(filter_count=Count('device_types')),
  310. to_field_name='slug'
  311. )
  312. is_console_server = forms.BooleanField(
  313. required=False, label='Is a console server', widget=forms.CheckboxInput(attrs={'value': 'True'}))
  314. is_pdu = forms.BooleanField(
  315. required=False, label='Is a PDU', widget=forms.CheckboxInput(attrs={'value': 'True'})
  316. )
  317. is_network_device = forms.BooleanField(
  318. required=False, label='Is a network device', widget=forms.CheckboxInput(attrs={'value': 'True'})
  319. )
  320. subdevice_role = forms.NullBooleanField(
  321. required=False, label='Subdevice role', widget=forms.Select(choices=(
  322. ('', '---------'),
  323. (SUBDEVICE_ROLE_PARENT, 'Parent'),
  324. (SUBDEVICE_ROLE_CHILD, 'Child'),
  325. ))
  326. )
  327. #
  328. # Device component templates
  329. #
  330. class ConsolePortTemplateForm(BootstrapMixin, forms.ModelForm):
  331. class Meta:
  332. model = ConsolePortTemplate
  333. fields = ['device_type', 'name']
  334. widgets = {
  335. 'device_type': forms.HiddenInput(),
  336. }
  337. class ConsolePortTemplateCreateForm(DeviceComponentForm):
  338. name_pattern = ExpandableNameField(label='Name')
  339. class ConsoleServerPortTemplateForm(BootstrapMixin, forms.ModelForm):
  340. class Meta:
  341. model = ConsoleServerPortTemplate
  342. fields = ['device_type', 'name']
  343. widgets = {
  344. 'device_type': forms.HiddenInput(),
  345. }
  346. class ConsoleServerPortTemplateCreateForm(DeviceComponentForm):
  347. name_pattern = ExpandableNameField(label='Name')
  348. class PowerPortTemplateForm(BootstrapMixin, forms.ModelForm):
  349. class Meta:
  350. model = PowerPortTemplate
  351. fields = ['device_type', 'name']
  352. widgets = {
  353. 'device_type': forms.HiddenInput(),
  354. }
  355. class PowerPortTemplateCreateForm(DeviceComponentForm):
  356. name_pattern = ExpandableNameField(label='Name')
  357. class PowerOutletTemplateForm(BootstrapMixin, forms.ModelForm):
  358. class Meta:
  359. model = PowerOutletTemplate
  360. fields = ['device_type', 'name']
  361. widgets = {
  362. 'device_type': forms.HiddenInput(),
  363. }
  364. class PowerOutletTemplateCreateForm(DeviceComponentForm):
  365. name_pattern = ExpandableNameField(label='Name')
  366. class InterfaceTemplateForm(BootstrapMixin, forms.ModelForm):
  367. class Meta:
  368. model = InterfaceTemplate
  369. fields = ['device_type', 'name', 'form_factor', 'mgmt_only']
  370. widgets = {
  371. 'device_type': forms.HiddenInput(),
  372. }
  373. class InterfaceTemplateCreateForm(DeviceComponentForm):
  374. name_pattern = ExpandableNameField(label='Name')
  375. form_factor = forms.ChoiceField(choices=IFACE_FF_CHOICES)
  376. mgmt_only = forms.BooleanField(required=False, label='OOB Management')
  377. class InterfaceTemplateBulkEditForm(BootstrapMixin, BulkEditForm):
  378. pk = forms.ModelMultipleChoiceField(queryset=InterfaceTemplate.objects.all(), widget=forms.MultipleHiddenInput)
  379. form_factor = forms.ChoiceField(choices=add_blank_choice(IFACE_FF_CHOICES), required=False)
  380. mgmt_only = forms.NullBooleanField(required=False, widget=BulkEditNullBooleanSelect, label='Management only')
  381. class Meta:
  382. nullable_fields = []
  383. class DeviceBayTemplateForm(BootstrapMixin, forms.ModelForm):
  384. class Meta:
  385. model = DeviceBayTemplate
  386. fields = ['device_type', 'name']
  387. widgets = {
  388. 'device_type': forms.HiddenInput(),
  389. }
  390. class DeviceBayTemplateCreateForm(DeviceComponentForm):
  391. name_pattern = ExpandableNameField(label='Name')
  392. #
  393. # Device roles
  394. #
  395. class DeviceRoleForm(BootstrapMixin, forms.ModelForm):
  396. slug = SlugField()
  397. class Meta:
  398. model = DeviceRole
  399. fields = ['name', 'slug', 'color']
  400. #
  401. # Platforms
  402. #
  403. class PlatformForm(BootstrapMixin, forms.ModelForm):
  404. slug = SlugField()
  405. class Meta:
  406. model = Platform
  407. fields = ['name', 'slug', 'rpc_client']
  408. #
  409. # Devices
  410. #
  411. class DeviceForm(BootstrapMixin, TenancyForm, CustomFieldForm):
  412. site = forms.ModelChoiceField(
  413. queryset=Site.objects.all(),
  414. widget=forms.Select(
  415. attrs={'filter-for': 'rack'}
  416. )
  417. )
  418. rack = ChainedModelChoiceField(
  419. queryset=Rack.objects.all(),
  420. chains={'site': 'site'},
  421. required=False,
  422. widget=APISelect(
  423. api_url='/api/dcim/racks/?site_id={{site}}',
  424. display_field='display_name',
  425. attrs={'filter-for': 'position'}
  426. )
  427. )
  428. position = forms.TypedChoiceField(
  429. required=False,
  430. empty_value=None,
  431. help_text="The lowest-numbered unit occupied by the device",
  432. widget=APISelect(
  433. api_url='/api/dcim/racks/{{rack}}/units/?face={{face}}',
  434. disabled_indicator='device'
  435. )
  436. )
  437. manufacturer = forms.ModelChoiceField(
  438. queryset=Manufacturer.objects.all(),
  439. widget=forms.Select(
  440. attrs={'filter-for': 'device_type'}
  441. )
  442. )
  443. device_type = ChainedModelChoiceField(
  444. queryset=DeviceType.objects.all(),
  445. chains={'manufacturer': 'manufacturer'},
  446. label='Device type',
  447. widget=APISelect(
  448. api_url='/api/dcim/device-types/?manufacturer_id={{manufacturer}}',
  449. display_field='model'
  450. )
  451. )
  452. comments = CommentField()
  453. class Meta:
  454. model = Device
  455. fields = [
  456. 'name', 'device_role', 'device_type', 'serial', 'asset_tag', 'site', 'rack', 'position', 'face', 'status',
  457. 'platform', 'primary_ip4', 'primary_ip6', 'tenant_group', 'tenant', 'comments',
  458. ]
  459. help_texts = {
  460. 'device_role': "The function this device serves",
  461. 'serial': "Chassis serial number",
  462. }
  463. widgets = {
  464. 'face': forms.Select(attrs={'filter-for': 'position'}),
  465. }
  466. def __init__(self, *args, **kwargs):
  467. # Initialize helper selectors
  468. instance = kwargs.get('instance')
  469. if instance and instance.device_type is not None:
  470. initial = kwargs.get('initial', {})
  471. initial['manufacturer'] = instance.device_type.manufacturer
  472. kwargs['initial'] = initial
  473. super(DeviceForm, self).__init__(*args, **kwargs)
  474. if self.instance.pk:
  475. # Compile list of choices for primary IPv4 and IPv6 addresses
  476. for family in [4, 6]:
  477. ip_choices = []
  478. interface_ips = IPAddress.objects.filter(family=family, interface__device=self.instance)
  479. ip_choices += [(ip.id, u'{} ({})'.format(ip.address, ip.interface)) for ip in interface_ips]
  480. nat_ips = IPAddress.objects.filter(family=family, nat_inside__interface__device=self.instance)\
  481. .select_related('nat_inside__interface')
  482. ip_choices += [(ip.id, u'{} ({} NAT)'.format(ip.address, ip.nat_inside.interface)) for ip in nat_ips]
  483. self.fields['primary_ip{}'.format(family)].choices = [(None, '---------')] + ip_choices
  484. # If editing an existing device, exclude it from the list of occupied rack units. This ensures that a device
  485. # can be flipped from one face to another.
  486. self.fields['position'].widget.attrs['api-url'] += '&exclude={}'.format(self.instance.pk)
  487. else:
  488. # An object that doesn't exist yet can't have any IPs assigned to it
  489. self.fields['primary_ip4'].choices = []
  490. self.fields['primary_ip4'].widget.attrs['readonly'] = True
  491. self.fields['primary_ip6'].choices = []
  492. self.fields['primary_ip6'].widget.attrs['readonly'] = True
  493. # Rack position
  494. pk = self.instance.pk if self.instance.pk else None
  495. try:
  496. if self.is_bound and self.data.get('rack') and str(self.data.get('face')):
  497. position_choices = Rack.objects.get(pk=self.data['rack'])\
  498. .get_rack_units(face=self.data.get('face'), exclude=pk)
  499. elif self.initial.get('rack') and str(self.initial.get('face')):
  500. position_choices = Rack.objects.get(pk=self.initial['rack'])\
  501. .get_rack_units(face=self.initial.get('face'), exclude=pk)
  502. else:
  503. position_choices = []
  504. except Rack.DoesNotExist:
  505. position_choices = []
  506. self.fields['position'].choices = [('', '---------')] + [
  507. (p['id'], {
  508. 'label': p['name'],
  509. 'disabled': bool(p['device'] and p['id'] != self.initial.get('position')),
  510. }) for p in position_choices
  511. ]
  512. # Disable rack assignment if this is a child device installed in a parent device
  513. if pk and self.instance.device_type.is_child_device and hasattr(self.instance, 'parent_bay'):
  514. self.fields['site'].disabled = True
  515. self.fields['rack'].disabled = True
  516. self.initial['site'] = self.instance.parent_bay.device.site_id
  517. self.initial['rack'] = self.instance.parent_bay.device.rack_id
  518. class BaseDeviceFromCSVForm(forms.ModelForm):
  519. device_role = forms.ModelChoiceField(
  520. queryset=DeviceRole.objects.all(), to_field_name='name',
  521. error_messages={'invalid_choice': 'Invalid device role.'}
  522. )
  523. tenant = forms.ModelChoiceField(
  524. Tenant.objects.all(), to_field_name='name', required=False,
  525. error_messages={'invalid_choice': 'Tenant not found.'}
  526. )
  527. manufacturer = forms.ModelChoiceField(
  528. queryset=Manufacturer.objects.all(), to_field_name='name',
  529. error_messages={'invalid_choice': 'Invalid manufacturer.'}
  530. )
  531. model_name = forms.CharField()
  532. platform = forms.ModelChoiceField(
  533. queryset=Platform.objects.all(), required=False, to_field_name='name',
  534. error_messages={'invalid_choice': 'Invalid platform.'}
  535. )
  536. status_name = forms.ChoiceField(choices=[(s[1], s[0]) for s in STATUS_CHOICES])
  537. class Meta:
  538. fields = []
  539. model = Device
  540. def clean(self):
  541. manufacturer = self.cleaned_data.get('manufacturer')
  542. model_name = self.cleaned_data.get('model_name')
  543. # Validate device type
  544. if manufacturer and model_name:
  545. try:
  546. self.instance.device_type = DeviceType.objects.get(manufacturer=manufacturer, model=model_name)
  547. except DeviceType.DoesNotExist:
  548. self.add_error('model_name', "Invalid device type ({} {})".format(manufacturer, model_name))
  549. def clean_status_name(self):
  550. return dict(self.fields['status_name'].choices)[self.cleaned_data['status_name']]
  551. class DeviceFromCSVForm(BaseDeviceFromCSVForm):
  552. site = forms.ModelChoiceField(
  553. queryset=Site.objects.all(), to_field_name='name', error_messages={
  554. 'invalid_choice': 'Invalid site name.',
  555. }
  556. )
  557. rack_name = forms.CharField(required=False)
  558. face = forms.CharField(required=False)
  559. class Meta(BaseDeviceFromCSVForm.Meta):
  560. fields = [
  561. 'name', 'device_role', 'tenant', 'manufacturer', 'model_name', 'platform', 'serial', 'asset_tag',
  562. 'status_name', 'site', 'rack_name', 'position', 'face',
  563. ]
  564. def clean(self):
  565. super(DeviceFromCSVForm, self).clean()
  566. site = self.cleaned_data.get('site')
  567. rack_name = self.cleaned_data.get('rack_name')
  568. # Validate rack
  569. if site and rack_name:
  570. try:
  571. self.instance.rack = Rack.objects.get(site=site, name=rack_name)
  572. except Rack.DoesNotExist:
  573. self.add_error('rack_name', "Invalid rack ({})".format(rack_name))
  574. def clean_face(self):
  575. face = self.cleaned_data['face']
  576. if not face:
  577. return None
  578. try:
  579. return {
  580. 'front': 0,
  581. 'rear': 1,
  582. }[face.lower()]
  583. except KeyError:
  584. raise forms.ValidationError('Invalid rack face ({}); must be "front" or "rear".'.format(face))
  585. class ChildDeviceFromCSVForm(BaseDeviceFromCSVForm):
  586. parent = FlexibleModelChoiceField(
  587. queryset=Device.objects.all(),
  588. to_field_name='name',
  589. required=False,
  590. error_messages={
  591. 'invalid_choice': 'Parent device not found.'
  592. }
  593. )
  594. device_bay_name = forms.CharField(required=False)
  595. class Meta(BaseDeviceFromCSVForm.Meta):
  596. fields = [
  597. 'name', 'device_role', 'tenant', 'manufacturer', 'model_name', 'platform', 'serial', 'asset_tag',
  598. 'status_name', 'parent', 'device_bay_name',
  599. ]
  600. def clean(self):
  601. super(ChildDeviceFromCSVForm, self).clean()
  602. parent = self.cleaned_data.get('parent')
  603. device_bay_name = self.cleaned_data.get('device_bay_name')
  604. # Validate device bay
  605. if parent and device_bay_name:
  606. try:
  607. device_bay = DeviceBay.objects.get(device=parent, name=device_bay_name)
  608. if device_bay.installed_device:
  609. self.add_error('device_bay_name',
  610. "Device bay ({} {}) is already occupied".format(parent, device_bay_name))
  611. else:
  612. self.instance.parent_bay = device_bay
  613. except DeviceBay.DoesNotExist:
  614. self.add_error('device_bay_name', "Parent device/bay ({} {}) not found".format(parent, device_bay_name))
  615. class DeviceImportForm(BootstrapMixin, BulkImportForm):
  616. csv = CSVDataField(csv_form=DeviceFromCSVForm)
  617. class ChildDeviceImportForm(BootstrapMixin, BulkImportForm):
  618. csv = CSVDataField(csv_form=ChildDeviceFromCSVForm)
  619. class DeviceBulkEditForm(BootstrapMixin, CustomFieldBulkEditForm):
  620. pk = forms.ModelMultipleChoiceField(queryset=Device.objects.all(), widget=forms.MultipleHiddenInput)
  621. device_type = forms.ModelChoiceField(queryset=DeviceType.objects.all(), required=False, label='Type')
  622. device_role = forms.ModelChoiceField(queryset=DeviceRole.objects.all(), required=False, label='Role')
  623. tenant = forms.ModelChoiceField(queryset=Tenant.objects.all(), required=False)
  624. platform = forms.ModelChoiceField(queryset=Platform.objects.all(), required=False)
  625. status = forms.ChoiceField(choices=FORM_STATUS_CHOICES, required=False, initial='', label='Status')
  626. serial = forms.CharField(max_length=50, required=False, label='Serial Number')
  627. class Meta:
  628. nullable_fields = ['tenant', 'platform']
  629. def device_status_choices():
  630. status_counts = {}
  631. for status in Device.objects.values('status').annotate(count=Count('status')).order_by('status'):
  632. status_counts[status['status']] = status['count']
  633. return [(s[0], u'{} ({})'.format(s[1], status_counts.get(s[0], 0))) for s in STATUS_CHOICES]
  634. class DeviceFilterForm(BootstrapMixin, CustomFieldFilterForm):
  635. model = Device
  636. q = forms.CharField(required=False, label='Search')
  637. site = FilterChoiceField(
  638. queryset=Site.objects.annotate(filter_count=Count('devices')),
  639. to_field_name='slug',
  640. )
  641. rack_group_id = FilterChoiceField(
  642. queryset=RackGroup.objects.select_related('site').annotate(filter_count=Count('racks__devices')),
  643. label='Rack group',
  644. )
  645. role = FilterChoiceField(
  646. queryset=DeviceRole.objects.annotate(filter_count=Count('devices')),
  647. to_field_name='slug',
  648. )
  649. tenant = FilterChoiceField(
  650. queryset=Tenant.objects.annotate(filter_count=Count('devices')), to_field_name='slug',
  651. null_option=(0, 'None'),
  652. )
  653. manufacturer_id = FilterChoiceField(queryset=Manufacturer.objects.all(), label='Manufacturer')
  654. device_type_id = FilterChoiceField(
  655. queryset=DeviceType.objects.select_related('manufacturer').order_by('model').annotate(
  656. filter_count=Count('instances'),
  657. ),
  658. label='Model',
  659. )
  660. platform = FilterChoiceField(
  661. queryset=Platform.objects.annotate(filter_count=Count('devices')),
  662. to_field_name='slug',
  663. null_option=(0, 'None'),
  664. )
  665. status = forms.MultipleChoiceField(choices=device_status_choices, required=False)
  666. mac_address = forms.CharField(required=False, label='MAC address')
  667. #
  668. # Bulk device component creation
  669. #
  670. class DeviceBulkAddComponentForm(BootstrapMixin, forms.Form):
  671. pk = forms.ModelMultipleChoiceField(queryset=Device.objects.all(), widget=forms.MultipleHiddenInput)
  672. name_pattern = ExpandableNameField(label='Name')
  673. class DeviceBulkAddInterfaceForm(forms.ModelForm, DeviceBulkAddComponentForm):
  674. class Meta:
  675. model = Interface
  676. fields = ['pk', 'name_pattern', 'form_factor', 'mgmt_only', 'description']
  677. #
  678. # Console ports
  679. #
  680. class ConsolePortForm(BootstrapMixin, forms.ModelForm):
  681. class Meta:
  682. model = ConsolePort
  683. fields = ['device', 'name']
  684. widgets = {
  685. 'device': forms.HiddenInput(),
  686. }
  687. class ConsolePortCreateForm(DeviceComponentForm):
  688. name_pattern = ExpandableNameField(label='Name')
  689. class ConsoleConnectionCSVForm(forms.Form):
  690. console_server = FlexibleModelChoiceField(
  691. queryset=Device.objects.filter(device_type__is_console_server=True),
  692. to_field_name='name',
  693. error_messages={
  694. 'invalid_choice': 'Console server not found',
  695. }
  696. )
  697. cs_port = forms.CharField()
  698. device = FlexibleModelChoiceField(queryset=Device.objects.all(), to_field_name='name',
  699. error_messages={'invalid_choice': 'Device not found'})
  700. console_port = forms.CharField()
  701. status = forms.CharField(validators=[validate_connection_status])
  702. def clean(self):
  703. # Validate console server port
  704. if self.cleaned_data.get('console_server'):
  705. try:
  706. cs_port = ConsoleServerPort.objects.get(device=self.cleaned_data['console_server'],
  707. name=self.cleaned_data['cs_port'])
  708. if ConsolePort.objects.filter(cs_port=cs_port):
  709. raise forms.ValidationError("Console server port is already occupied (by {} {})"
  710. .format(cs_port.connected_console.device, cs_port.connected_console))
  711. except ConsoleServerPort.DoesNotExist:
  712. raise forms.ValidationError("Invalid console server port ({} {})"
  713. .format(self.cleaned_data['console_server'], self.cleaned_data['cs_port']))
  714. # Validate console port
  715. if self.cleaned_data.get('device'):
  716. try:
  717. console_port = ConsolePort.objects.get(device=self.cleaned_data['device'],
  718. name=self.cleaned_data['console_port'])
  719. if console_port.cs_port:
  720. raise forms.ValidationError("Console port is already connected (to {} {})"
  721. .format(console_port.cs_port.device, console_port.cs_port))
  722. except ConsolePort.DoesNotExist:
  723. raise forms.ValidationError("Invalid console port ({} {})"
  724. .format(self.cleaned_data['device'], self.cleaned_data['console_port']))
  725. class ConsoleConnectionImportForm(BootstrapMixin, BulkImportForm):
  726. csv = CSVDataField(csv_form=ConsoleConnectionCSVForm)
  727. def clean(self):
  728. records = self.cleaned_data.get('csv')
  729. if not records:
  730. return
  731. connection_list = []
  732. for i, record in enumerate(records, start=1):
  733. form = self.fields['csv'].csv_form(data=record)
  734. if form.is_valid():
  735. console_port = ConsolePort.objects.get(device=form.cleaned_data['device'],
  736. name=form.cleaned_data['console_port'])
  737. console_port.cs_port = ConsoleServerPort.objects.get(device=form.cleaned_data['console_server'],
  738. name=form.cleaned_data['cs_port'])
  739. if form.cleaned_data['status'] == 'planned':
  740. console_port.connection_status = CONNECTION_STATUS_PLANNED
  741. else:
  742. console_port.connection_status = CONNECTION_STATUS_CONNECTED
  743. connection_list.append(console_port)
  744. else:
  745. for field, errors in form.errors.items():
  746. for e in errors:
  747. self.add_error('csv', "Record {} {}: {}".format(i, field, e))
  748. self.cleaned_data['csv'] = connection_list
  749. class ConsolePortConnectionForm(BootstrapMixin, ChainedFieldsMixin, forms.ModelForm):
  750. site = forms.ModelChoiceField(
  751. queryset=Site.objects.all(),
  752. widget=forms.HiddenInput(),
  753. )
  754. rack = ChainedModelChoiceField(
  755. queryset=Rack.objects.all(),
  756. chains={'site': 'site'},
  757. label='Rack',
  758. required=False,
  759. widget=forms.Select(
  760. attrs={'filter-for': 'console_server', 'nullable': 'true'}
  761. )
  762. )
  763. console_server = ChainedModelChoiceField(
  764. queryset=Device.objects.filter(device_type__is_console_server=True),
  765. chains={'site': 'site', 'rack': 'rack'},
  766. label='Console Server',
  767. required=False,
  768. widget=APISelect(
  769. api_url='/api/dcim/devices/?site_id={{site}}&rack_id={{rack}}&is_console_server=True',
  770. display_field='display_name',
  771. attrs={'filter-for': 'cs_port'}
  772. )
  773. )
  774. livesearch = forms.CharField(
  775. required=False,
  776. label='Console Server',
  777. widget=Livesearch(
  778. query_key='q',
  779. query_url='dcim-api:device-list',
  780. field_to_update='console_server',
  781. )
  782. )
  783. cs_port = ChainedModelChoiceField(
  784. queryset=ConsoleServerPort.objects.all(),
  785. chains={'device': 'console_server'},
  786. label='Port',
  787. widget=APISelect(
  788. api_url='/api/dcim/console-server-ports/?device_id={{console_server}}',
  789. disabled_indicator='connected_console',
  790. )
  791. )
  792. class Meta:
  793. model = ConsolePort
  794. fields = ['site', 'rack', 'console_server', 'livesearch', 'cs_port', 'connection_status']
  795. labels = {
  796. 'cs_port': 'Port',
  797. 'connection_status': 'Status',
  798. }
  799. def __init__(self, *args, **kwargs):
  800. super(ConsolePortConnectionForm, self).__init__(*args, **kwargs)
  801. if not self.instance.pk:
  802. raise RuntimeError("ConsolePortConnectionForm must be initialized with an existing ConsolePort instance.")
  803. #
  804. # Console server ports
  805. #
  806. class ConsoleServerPortForm(BootstrapMixin, forms.ModelForm):
  807. class Meta:
  808. model = ConsoleServerPort
  809. fields = ['device', 'name']
  810. widgets = {
  811. 'device': forms.HiddenInput(),
  812. }
  813. class ConsoleServerPortCreateForm(DeviceComponentForm):
  814. name_pattern = ExpandableNameField(label='Name')
  815. class ConsoleServerPortConnectionForm(BootstrapMixin, ChainedFieldsMixin, forms.Form):
  816. site = forms.ModelChoiceField(
  817. queryset=Site.objects.all(),
  818. widget=forms.HiddenInput(),
  819. )
  820. rack = ChainedModelChoiceField(
  821. queryset=Rack.objects.all(),
  822. chains={'site': 'site'},
  823. label='Rack',
  824. required=False,
  825. widget=forms.Select(
  826. attrs={'filter-for': 'device', 'nullable': 'true'}
  827. )
  828. )
  829. device = ChainedModelChoiceField(
  830. queryset=Device.objects.all(),
  831. chains={'site': 'site', 'rack': 'rack'},
  832. label='Device',
  833. required=False,
  834. widget=APISelect(
  835. api_url='/api/dcim/devices/?site_id={{site}}&rack_id={{rack}}',
  836. display_field='display_name',
  837. attrs={'filter-for': 'port'}
  838. )
  839. )
  840. livesearch = forms.CharField(
  841. required=False,
  842. label='Device',
  843. widget=Livesearch(
  844. query_key='q',
  845. query_url='dcim-api:device-list',
  846. field_to_update='device'
  847. )
  848. )
  849. port = ChainedModelChoiceField(
  850. queryset=ConsolePort.objects.all(),
  851. chains={'device': 'device'},
  852. label='Port',
  853. widget=APISelect(
  854. api_url='/api/dcim/console-ports/?device_id={{device}}',
  855. disabled_indicator='cs_port'
  856. )
  857. )
  858. connection_status = forms.BooleanField(
  859. required=False,
  860. initial=CONNECTION_STATUS_CONNECTED,
  861. label='Status',
  862. widget=forms.Select(
  863. choices=CONNECTION_STATUS_CHOICES
  864. )
  865. )
  866. class Meta:
  867. fields = ['site', 'rack', 'device', 'livesearch', 'port', 'connection_status']
  868. labels = {
  869. 'connection_status': 'Status',
  870. }
  871. #
  872. # Power ports
  873. #
  874. class PowerPortForm(BootstrapMixin, forms.ModelForm):
  875. class Meta:
  876. model = PowerPort
  877. fields = ['device', 'name']
  878. widgets = {
  879. 'device': forms.HiddenInput(),
  880. }
  881. class PowerPortCreateForm(DeviceComponentForm):
  882. name_pattern = ExpandableNameField(label='Name')
  883. class PowerConnectionCSVForm(forms.Form):
  884. pdu = FlexibleModelChoiceField(
  885. queryset=Device.objects.filter(device_type__is_pdu=True),
  886. to_field_name='name',
  887. error_messages={
  888. 'invalid_choice': 'PDU not found.',
  889. }
  890. )
  891. power_outlet = forms.CharField()
  892. device = FlexibleModelChoiceField(queryset=Device.objects.all(), to_field_name='name',
  893. error_messages={'invalid_choice': 'Device not found'})
  894. power_port = forms.CharField()
  895. status = forms.CharField(validators=[validate_connection_status])
  896. def clean(self):
  897. # Validate power outlet
  898. if self.cleaned_data.get('pdu'):
  899. try:
  900. power_outlet = PowerOutlet.objects.get(device=self.cleaned_data['pdu'],
  901. name=self.cleaned_data['power_outlet'])
  902. if PowerPort.objects.filter(power_outlet=power_outlet):
  903. raise forms.ValidationError("Power outlet is already occupied (by {} {})"
  904. .format(power_outlet.connected_port.device,
  905. power_outlet.connected_port))
  906. except PowerOutlet.DoesNotExist:
  907. raise forms.ValidationError("Invalid PDU port ({} {})"
  908. .format(self.cleaned_data['pdu'], self.cleaned_data['power_outlet']))
  909. # Validate power port
  910. if self.cleaned_data.get('device'):
  911. try:
  912. power_port = PowerPort.objects.get(device=self.cleaned_data['device'],
  913. name=self.cleaned_data['power_port'])
  914. if power_port.power_outlet:
  915. raise forms.ValidationError("Power port is already connected (to {} {})"
  916. .format(power_port.power_outlet.device, power_port.power_outlet))
  917. except PowerPort.DoesNotExist:
  918. raise forms.ValidationError("Invalid power port ({} {})"
  919. .format(self.cleaned_data['device'], self.cleaned_data['power_port']))
  920. class PowerConnectionImportForm(BootstrapMixin, BulkImportForm):
  921. csv = CSVDataField(csv_form=PowerConnectionCSVForm)
  922. def clean(self):
  923. records = self.cleaned_data.get('csv')
  924. if not records:
  925. return
  926. connection_list = []
  927. for i, record in enumerate(records, start=1):
  928. form = self.fields['csv'].csv_form(data=record)
  929. if form.is_valid():
  930. power_port = PowerPort.objects.get(device=form.cleaned_data['device'],
  931. name=form.cleaned_data['power_port'])
  932. power_port.power_outlet = PowerOutlet.objects.get(device=form.cleaned_data['pdu'],
  933. name=form.cleaned_data['power_outlet'])
  934. if form.cleaned_data['status'] == 'planned':
  935. power_port.connection_status = CONNECTION_STATUS_PLANNED
  936. else:
  937. power_port.connection_status = CONNECTION_STATUS_CONNECTED
  938. connection_list.append(power_port)
  939. else:
  940. for field, errors in form.errors.items():
  941. for e in errors:
  942. self.add_error('csv', "Record {} {}: {}".format(i, field, e))
  943. self.cleaned_data['csv'] = connection_list
  944. class PowerPortConnectionForm(BootstrapMixin, ChainedFieldsMixin, forms.ModelForm):
  945. site = forms.ModelChoiceField(queryset=Site.objects.all(), widget=forms.HiddenInput())
  946. rack = ChainedModelChoiceField(
  947. queryset=Rack.objects.all(),
  948. chains={'site': 'site'},
  949. label='Rack',
  950. required=False,
  951. widget=forms.Select(
  952. attrs={'filter-for': 'pdu', 'nullable': 'true'}
  953. )
  954. )
  955. pdu = ChainedModelChoiceField(
  956. queryset=Device.objects.all(),
  957. chains={'site': 'site', 'rack': 'rack'},
  958. label='PDU',
  959. required=False,
  960. widget=APISelect(
  961. api_url='/api/dcim/devices/?site_id={{site}}&rack_id={{rack}}&is_pdu=True',
  962. display_field='display_name',
  963. attrs={'filter-for': 'power_outlet'}
  964. )
  965. )
  966. livesearch = forms.CharField(
  967. required=False,
  968. label='PDU',
  969. widget=Livesearch(
  970. query_key='q',
  971. query_url='dcim-api:device-list',
  972. field_to_update='pdu'
  973. )
  974. )
  975. power_outlet = ChainedModelChoiceField(
  976. queryset=PowerOutlet.objects.all(),
  977. chains={'device': 'device'},
  978. label='Outlet',
  979. widget=APISelect(
  980. api_url='/api/dcim/power-outlets/?device_id={{pdu}}',
  981. disabled_indicator='connected_port'
  982. )
  983. )
  984. class Meta:
  985. model = PowerPort
  986. fields = ['site', 'rack', 'pdu', 'livesearch', 'power_outlet', 'connection_status']
  987. labels = {
  988. 'power_outlet': 'Outlet',
  989. 'connection_status': 'Status',
  990. }
  991. def __init__(self, *args, **kwargs):
  992. super(PowerPortConnectionForm, self).__init__(*args, **kwargs)
  993. if not self.instance.pk:
  994. raise RuntimeError("PowerPortConnectionForm must be initialized with an existing PowerPort instance.")
  995. #
  996. # Power outlets
  997. #
  998. class PowerOutletForm(BootstrapMixin, forms.ModelForm):
  999. class Meta:
  1000. model = PowerOutlet
  1001. fields = ['device', 'name']
  1002. widgets = {
  1003. 'device': forms.HiddenInput(),
  1004. }
  1005. class PowerOutletCreateForm(DeviceComponentForm):
  1006. name_pattern = ExpandableNameField(label='Name')
  1007. class PowerOutletConnectionForm(BootstrapMixin, ChainedFieldsMixin, forms.Form):
  1008. site = forms.ModelChoiceField(
  1009. queryset=Site.objects.all(),
  1010. widget=forms.HiddenInput()
  1011. )
  1012. rack = ChainedModelChoiceField(
  1013. queryset=Rack.objects.all(),
  1014. chains={'site': 'site'},
  1015. label='Rack',
  1016. required=False,
  1017. widget=forms.Select(
  1018. attrs={'filter-for': 'device', 'nullable': 'true'}
  1019. )
  1020. )
  1021. device = ChainedModelChoiceField(
  1022. queryset=Device.objects.all(),
  1023. chains={'site': 'site', 'rack': 'rack'},
  1024. label='Device',
  1025. required=False,
  1026. widget=APISelect(
  1027. api_url='/api/dcim/devices/?site_id={{site}}&rack_id={{rack}}',
  1028. display_field='display_name',
  1029. attrs={'filter-for': 'port'}
  1030. )
  1031. )
  1032. livesearch = forms.CharField(
  1033. required=False,
  1034. label='Device',
  1035. widget=Livesearch(
  1036. query_key='q',
  1037. query_url='dcim-api:device-list',
  1038. field_to_update='device'
  1039. )
  1040. )
  1041. port = ChainedModelChoiceField(
  1042. queryset=PowerPort.objects.all(),
  1043. chains={'device': 'device'},
  1044. label='Port',
  1045. widget=APISelect(
  1046. api_url='/api/dcim/power-ports/?device_id={{device}}',
  1047. disabled_indicator='power_outlet'
  1048. )
  1049. )
  1050. connection_status = forms.BooleanField(
  1051. required=False,
  1052. initial=CONNECTION_STATUS_CONNECTED,
  1053. label='Status',
  1054. widget=forms.Select(
  1055. choices=CONNECTION_STATUS_CHOICES
  1056. )
  1057. )
  1058. class Meta:
  1059. fields = ['site', 'rack', 'device', 'livesearch', 'port', 'connection_status']
  1060. labels = {
  1061. 'connection_status': 'Status',
  1062. }
  1063. #
  1064. # Interfaces
  1065. #
  1066. class InterfaceForm(BootstrapMixin, forms.ModelForm):
  1067. class Meta:
  1068. model = Interface
  1069. fields = ['device', 'name', 'form_factor', 'lag', 'mac_address', 'mgmt_only', 'description']
  1070. widgets = {
  1071. 'device': forms.HiddenInput(),
  1072. }
  1073. def __init__(self, *args, **kwargs):
  1074. super(InterfaceForm, self).__init__(*args, **kwargs)
  1075. # Limit LAG choices to interfaces belonging to this device
  1076. if self.is_bound:
  1077. self.fields['lag'].queryset = Interface.objects.order_naturally().filter(
  1078. device_id=self.data['device'], form_factor=IFACE_FF_LAG
  1079. )
  1080. else:
  1081. self.fields['lag'].queryset = Interface.objects.order_naturally().filter(
  1082. device=self.instance.device, form_factor=IFACE_FF_LAG
  1083. )
  1084. class InterfaceCreateForm(DeviceComponentForm):
  1085. name_pattern = ExpandableNameField(label='Name')
  1086. form_factor = forms.ChoiceField(choices=IFACE_FF_CHOICES)
  1087. lag = forms.ModelChoiceField(queryset=Interface.objects.all(), required=False, label='Parent LAG')
  1088. mac_address = MACAddressFormField(required=False, label='MAC Address')
  1089. mgmt_only = forms.BooleanField(required=False, label='OOB Management')
  1090. description = forms.CharField(max_length=100, required=False)
  1091. def __init__(self, *args, **kwargs):
  1092. super(InterfaceCreateForm, self).__init__(*args, **kwargs)
  1093. # Limit LAG choices to interfaces belonging to this device
  1094. if self.device is not None:
  1095. self.fields['lag'].queryset = Interface.objects.order_naturally().filter(
  1096. device=self.device, form_factor=IFACE_FF_LAG
  1097. )
  1098. else:
  1099. self.fields['lag'].queryset = Interface.objects.none()
  1100. class InterfaceBulkEditForm(BootstrapMixin, BulkEditForm):
  1101. pk = forms.ModelMultipleChoiceField(queryset=Interface.objects.all(), widget=forms.MultipleHiddenInput)
  1102. device = forms.ModelChoiceField(queryset=Device.objects.all(), widget=forms.HiddenInput)
  1103. lag = forms.ModelChoiceField(queryset=Interface.objects.all(), required=False, label='Parent LAG')
  1104. form_factor = forms.ChoiceField(choices=add_blank_choice(IFACE_FF_CHOICES), required=False)
  1105. mgmt_only = forms.NullBooleanField(required=False, widget=BulkEditNullBooleanSelect, label='Management only')
  1106. description = forms.CharField(max_length=100, required=False)
  1107. class Meta:
  1108. nullable_fields = ['lag', 'description']
  1109. def __init__(self, *args, **kwargs):
  1110. super(InterfaceBulkEditForm, self).__init__(*args, **kwargs)
  1111. # Limit LAG choices to interfaces which belong to the parent device.
  1112. device = None
  1113. if self.initial.get('device'):
  1114. try:
  1115. device = Device.objects.get(pk=self.initial.get('device'))
  1116. except Device.DoesNotExist:
  1117. pass
  1118. if device is not None:
  1119. interface_ordering = device.device_type.interface_ordering
  1120. self.fields['lag'].queryset = Interface.objects.order_naturally(method=interface_ordering).filter(
  1121. device=device, form_factor=IFACE_FF_LAG
  1122. )
  1123. else:
  1124. self.fields['lag'].choices = []
  1125. #
  1126. # Interface connections
  1127. #
  1128. class InterfaceConnectionForm(BootstrapMixin, ChainedFieldsMixin, forms.ModelForm):
  1129. interface_a = forms.ChoiceField(
  1130. choices=[],
  1131. widget=SelectWithDisabled,
  1132. label='Interface'
  1133. )
  1134. site_b = forms.ModelChoiceField(
  1135. queryset=Site.objects.all(),
  1136. label='Site',
  1137. required=False,
  1138. widget=forms.Select(
  1139. attrs={'filter-for': 'rack_b'}
  1140. )
  1141. )
  1142. rack_b = ChainedModelChoiceField(
  1143. queryset=Rack.objects.all(),
  1144. chains={'site': 'site_b'},
  1145. label='Rack',
  1146. required=False,
  1147. widget=APISelect(
  1148. api_url='/api/dcim/racks/?site_id={{site_b}}',
  1149. attrs={'filter-for': 'device_b', 'nullable': 'true'}
  1150. )
  1151. )
  1152. device_b = ChainedModelChoiceField(
  1153. queryset=Device.objects.all(),
  1154. chains={'site': 'site_b', 'rack': 'rack_b'},
  1155. label='Device',
  1156. required=False,
  1157. widget=APISelect(
  1158. api_url='/api/dcim/devices/?site_id={{site_b}}&rack_id={{rack_b}}',
  1159. display_field='display_name',
  1160. attrs={'filter-for': 'interface_b'}
  1161. )
  1162. )
  1163. livesearch = forms.CharField(
  1164. required=False,
  1165. label='Device',
  1166. widget=Livesearch(
  1167. query_key='q',
  1168. query_url='dcim-api:device-list',
  1169. field_to_update='device_b'
  1170. )
  1171. )
  1172. interface_b = ChainedModelChoiceField(
  1173. queryset=Interface.objects.exclude(form_factor__in=VIRTUAL_IFACE_TYPES).select_related(
  1174. 'circuit_termination', 'connected_as_a', 'connected_as_b'
  1175. ),
  1176. chains={'device': 'device_b'},
  1177. label='Interface',
  1178. widget=APISelect(
  1179. api_url='/api/dcim/interfaces/?device_id={{device_b}}&type=physical',
  1180. disabled_indicator='is_connected'
  1181. )
  1182. )
  1183. class Meta:
  1184. model = InterfaceConnection
  1185. fields = ['interface_a', 'site_b', 'rack_b', 'device_b', 'interface_b', 'livesearch', 'connection_status']
  1186. def __init__(self, device_a, *args, **kwargs):
  1187. super(InterfaceConnectionForm, self).__init__(*args, **kwargs)
  1188. # Initialize interface A choices
  1189. device_a_interfaces = Interface.objects.order_naturally().filter(device=device_a).exclude(
  1190. form_factor__in=VIRTUAL_IFACE_TYPES
  1191. ).select_related(
  1192. 'circuit_termination', 'connected_as_a', 'connected_as_b'
  1193. )
  1194. self.fields['interface_a'].choices = [
  1195. (iface.id, {'label': iface.name, 'disabled': iface.is_connected}) for iface in device_a_interfaces
  1196. ]
  1197. # Mark connected interfaces as disabled
  1198. self.fields['interface_b'].choices = [
  1199. (iface.id, {'label': iface.name, 'disabled': iface.is_connected}) for iface in self.fields['interface_b'].queryset
  1200. ]
  1201. class InterfaceConnectionCSVForm(forms.Form):
  1202. device_a = FlexibleModelChoiceField(
  1203. queryset=Device.objects.all(),
  1204. to_field_name='name',
  1205. error_messages={'invalid_choice': 'Device A not found.'}
  1206. )
  1207. interface_a = forms.CharField()
  1208. device_b = FlexibleModelChoiceField(
  1209. queryset=Device.objects.all(),
  1210. to_field_name='name',
  1211. error_messages={'invalid_choice': 'Device B not found.'}
  1212. )
  1213. interface_b = forms.CharField()
  1214. status = forms.CharField(
  1215. validators=[validate_connection_status]
  1216. )
  1217. def clean(self):
  1218. # Validate interface A
  1219. if self.cleaned_data.get('device_a'):
  1220. try:
  1221. interface_a = Interface.objects.get(device=self.cleaned_data['device_a'],
  1222. name=self.cleaned_data['interface_a'])
  1223. except Interface.DoesNotExist:
  1224. raise forms.ValidationError("Invalid interface ({} {})"
  1225. .format(self.cleaned_data['device_a'], self.cleaned_data['interface_a']))
  1226. try:
  1227. InterfaceConnection.objects.get(Q(interface_a=interface_a) | Q(interface_b=interface_a))
  1228. raise forms.ValidationError("{} {} is already connected"
  1229. .format(self.cleaned_data['device_a'], self.cleaned_data['interface_a']))
  1230. except InterfaceConnection.DoesNotExist:
  1231. pass
  1232. # Validate interface B
  1233. if self.cleaned_data.get('device_b'):
  1234. try:
  1235. interface_b = Interface.objects.get(device=self.cleaned_data['device_b'],
  1236. name=self.cleaned_data['interface_b'])
  1237. except Interface.DoesNotExist:
  1238. raise forms.ValidationError("Invalid interface ({} {})"
  1239. .format(self.cleaned_data['device_b'], self.cleaned_data['interface_b']))
  1240. try:
  1241. InterfaceConnection.objects.get(Q(interface_a=interface_b) | Q(interface_b=interface_b))
  1242. raise forms.ValidationError("{} {} is already connected"
  1243. .format(self.cleaned_data['device_b'], self.cleaned_data['interface_b']))
  1244. except InterfaceConnection.DoesNotExist:
  1245. pass
  1246. class InterfaceConnectionImportForm(BootstrapMixin, BulkImportForm):
  1247. csv = CSVDataField(csv_form=InterfaceConnectionCSVForm)
  1248. def clean(self):
  1249. records = self.cleaned_data.get('csv')
  1250. if not records:
  1251. return
  1252. connection_list = []
  1253. occupied_interfaces = []
  1254. for i, record in enumerate(records, start=1):
  1255. form = self.fields['csv'].csv_form(data=record)
  1256. if form.is_valid():
  1257. interface_a = Interface.objects.get(device=form.cleaned_data['device_a'],
  1258. name=form.cleaned_data['interface_a'])
  1259. if interface_a in occupied_interfaces:
  1260. raise forms.ValidationError("{} {} found in multiple connections"
  1261. .format(interface_a.device.name, interface_a.name))
  1262. interface_b = Interface.objects.get(device=form.cleaned_data['device_b'],
  1263. name=form.cleaned_data['interface_b'])
  1264. if interface_b in occupied_interfaces:
  1265. raise forms.ValidationError("{} {} found in multiple connections"
  1266. .format(interface_b.device.name, interface_b.name))
  1267. connection = InterfaceConnection(interface_a=interface_a, interface_b=interface_b)
  1268. if form.cleaned_data['status'] == 'planned':
  1269. connection.connection_status = CONNECTION_STATUS_PLANNED
  1270. else:
  1271. connection.connection_status = CONNECTION_STATUS_CONNECTED
  1272. connection_list.append(connection)
  1273. occupied_interfaces.append(interface_a)
  1274. occupied_interfaces.append(interface_b)
  1275. else:
  1276. for field, errors in form.errors.items():
  1277. for e in errors:
  1278. self.add_error('csv', "Record {} {}: {}".format(i, field, e))
  1279. self.cleaned_data['csv'] = connection_list
  1280. class InterfaceConnectionDeletionForm(BootstrapMixin, forms.Form):
  1281. confirm = forms.BooleanField(required=True)
  1282. # Used for HTTP redirect upon successful deletion
  1283. device = forms.ModelChoiceField(queryset=Device.objects.all(), widget=forms.HiddenInput(), required=False)
  1284. #
  1285. # Device bays
  1286. #
  1287. class DeviceBayForm(BootstrapMixin, forms.ModelForm):
  1288. class Meta:
  1289. model = DeviceBay
  1290. fields = ['device', 'name']
  1291. widgets = {
  1292. 'device': forms.HiddenInput(),
  1293. }
  1294. class DeviceBayCreateForm(DeviceComponentForm):
  1295. name_pattern = ExpandableNameField(label='Name')
  1296. class PopulateDeviceBayForm(BootstrapMixin, forms.Form):
  1297. installed_device = forms.ModelChoiceField(
  1298. queryset=Device.objects.all(),
  1299. label='Child Device',
  1300. help_text="Child devices must first be created and assigned to the site/rack of the parent device."
  1301. )
  1302. def __init__(self, device_bay, *args, **kwargs):
  1303. super(PopulateDeviceBayForm, self).__init__(*args, **kwargs)
  1304. self.fields['installed_device'].queryset = Device.objects.filter(
  1305. site=device_bay.device.site,
  1306. rack=device_bay.device.rack,
  1307. parent_bay__isnull=True,
  1308. device_type__u_height=0,
  1309. device_type__subdevice_role=SUBDEVICE_ROLE_CHILD
  1310. ).exclude(pk=device_bay.device.pk)
  1311. #
  1312. # Connections
  1313. #
  1314. class ConsoleConnectionFilterForm(BootstrapMixin, forms.Form):
  1315. site = forms.ModelChoiceField(required=False, queryset=Site.objects.all(), to_field_name='slug')
  1316. device = forms.CharField(required=False, label='Device name')
  1317. class PowerConnectionFilterForm(BootstrapMixin, forms.Form):
  1318. site = forms.ModelChoiceField(required=False, queryset=Site.objects.all(), to_field_name='slug')
  1319. device = forms.CharField(required=False, label='Device name')
  1320. class InterfaceConnectionFilterForm(BootstrapMixin, forms.Form):
  1321. site = forms.ModelChoiceField(required=False, queryset=Site.objects.all(), to_field_name='slug')
  1322. device = forms.CharField(required=False, label='Device name')
  1323. #
  1324. # Inventory items
  1325. #
  1326. class InventoryItemForm(BootstrapMixin, forms.ModelForm):
  1327. class Meta:
  1328. model = InventoryItem
  1329. fields = ['name', 'manufacturer', 'part_id', 'serial']