# system.perspective.alterDock parameters

**URL:** <https://forum.inductiveautomation.com/t/system-perspective-alterdock-parameters/62856>\
**Category:** Ignition\
**Tags:** ignition81, perspective\
**Created:** [August 9, 2022, 11:10pm UTC](https://forum.inductiveautomation.com/t/system-perspective-alterdock-parameters/62856 "2022-08-09T23:10:21Z")\
**Posts on this page:** 4\
**Page:** 1

<div class="post-metadata">

**Author:** ![tupanaster](https://avatars.discourse-cdn.com/v4/letter/t/5daacb/32.png) [@tupanaster](https://forum.inductiveautomation.com/u/tupanaster)\
**Post date:** [August 9, 2022, 11:10pm UTC](https://forum.inductiveautomation.com/t/system-perspective-alterdock-parameters/62856/1 "2022-08-09T23:10:21Z")

</div>

Hi everyone!

I’ve started experimenting a bit with alterDock function that was newly added.

In the manual [system.perspective.alterDock](https://docs.inductiveautomation.com/display/DOC81/system.perspective.alterDock) it says that parameters are [keyword arguments.](https://docs.inductiveautomation.com/display/DOC79/User+Defined+Functions#UserDefinedFunctions-KeywordArguments) but I’m thinking “JSON” since it’s what I’m used to.

So, this line worked for me: `system.perspective.alterDock(dockName, { 'size': 800 } )` which is slightly different from what the manual shows. For parameters I wrote `system.perspective.alterDock(dockName, { 'viewParams': {'tank: '01'} } )`

How should it be written?

---

<div class="post-metadata">

**Author:** ![cmallonee](https://sea1.discourse-cdn.com/inductiveautomation/user_avatar/forum.inductiveautomation.com/cmallonee/32/6416_2.png) [@cmallonee](https://forum.inductiveautomation.com/u/cmallonee)\
**Post date:** [August 10, 2022, 5:42am UTC](https://forum.inductiveautomation.com/t/system-perspective-alterdock-parameters/62856/2 "2022-08-10T05:42:05Z")

</div>

```auto
system.perspective.alterDock(dockName, { 'viewParams': {'tank: '01'} } )

```

Looks close to being correct (assuming `dockName` is a variable which stores the ID of the Docked View), though you’re missing a closing quote after `tank`:

```auto
system.perspective.alterDock(dockName, { 'viewParams': {'tank': '01'} } )

```

I’ll reach out to the Docs team to update that example with the correct usage.

---

<div class="post-metadata">

**Author:** ![tupanaster](https://avatars.discourse-cdn.com/v4/letter/t/5daacb/32.png) [@tupanaster](https://forum.inductiveautomation.com/u/tupanaster)\
**Post date:** [August 10, 2022, 6:32am UTC](https://forum.inductiveautomation.com/t/system-perspective-alterdock-parameters/62856/3 "2022-08-10T06:32:09Z")

</div>

I had some code around in an many parameters so I simplify it and forgot to add that quote. dockName is a string with the name of the dock. Just `dockName = 'my dock name'`

My dock name in that scenario is quite long so it’s better to have it in a variable.

Going back to the manual, why it’s `{ size: ` `500` `}` instead of `{ 'size': ` `500` `}`?

---

<div class="post-metadata">

**Author:** ![cmallonee](https://sea1.discourse-cdn.com/inductiveautomation/user_avatar/forum.inductiveautomation.com/cmallonee/32/6416_2.png) [@cmallonee](https://forum.inductiveautomation.com/u/cmallonee)\
**Post date:** [August 10, 2022, 2:30pm UTC](https://forum.inductiveautomation.com/t/system-perspective-alterdock-parameters/62856/4 "2022-08-10T14:30:07Z")

</div>

> [@cmallonee](#):
>
> I’ll reach out to the Docs team to update that example with the correct usage.

It IS supposed to be `"size"`. The docs are wrong.
