Added test for to_hierarchical_dataframe for the icephys tables

[oruebel]

This PR is in response to hdmf-dev/hdmf#665 which identified an issue where conversion of the icephys metadata tables to a hierarchical dataframe fails if a table contains a VectorIndex column. This PR adds corresponding tests in PyNWB to make sure this case is tests here. A corresponding PR on HDMF will follow as well to fix this issue.

How to test the behavior?

From hdmf-dev/hdmf#665

from pynwb.testing import create_icephys_testfile
from hdmf.common.hierarchicaltable import to_hierarchical_dataframe
nwbfile = create_icephys_testfile()
nwbfile.icephys_experimental_conditions.add_column('newcol', 'abc', data = [1,2,3], index = [2,3])
to_hierarchical_dataframe(nwbfile.icephys_experimental_conditions)

Checklist

• Did you update CHANGELOG.md with your changes?
• Have you checked our Contributing document?
• Have you ensured the PR clearly describes the problem and the solution?
• Is your contribution compliant with our coding style? This can be checked running flake8 from the source directory.
• Have you checked to ensure that there aren't other open Pull Requests for the same change?
• Have you included the relevant issue number using "Fix #XXX" notation where XXX is the issue number? By including "Fix #XXX" you allow GitHub to close issue #XXX when the PR is merged.