getEmbeddedTextFile(path, id, [encoding]) Last updated: 29. Apr 2026

Get the text content of an embedded file in a specific document.

See also: getEmbeddedFile saveEmbeddedFile

Parameters

Name Type Description
path string Absolute path of Docly document to get embedded text file from.
id string ID of embedded file to get text content from.
encoding (optional) string Text encoding, default is UTF8.

Returns

String, the text content of the embedded file.

Example

Code example (#JS)

#JS is mixed HTML (or other text file) with inline JavaScript with # starting and ending each inline statement.
#{
    // Getting the embedded text file from a Docly document
    let p = docly.getFile("Test files/Example file.xlsx");
    let fileId = p.File;
    let text = docly.getEmbeddedTextFile(p.Url, fileId);
    
    // Write embedded text file contents to output
    write(text);
}#

Output

The #JS code above produces the output shown below:
PKY��U_rels/.rels���J1��}��{w�Dd���ЛH}����a7�0u}{�Z���I~��7C��f���G�Fo�Z+���{�����kW�#�VJ$cʪ��l� �n�0�\Q�X^:�`���d�d{�m]_�d������h���V�������F�w�^F9��W��-�(F/3�O�DSU�N�l/w�{N(�[���q��T����u<��r�?焮�s9�F����M��h���'h?PKf����;PKY��Uxl/workbook.xml�S�n�0��+�m-^j�W����ə�Fk�����e�)�C�8߼�yZޜk��X�U��a�<P�.�����c:�1�"W�ZA�.`������>�z��}ecV!6߷y5�C݀�H�M͑L��mc���Z�QL���:���]�"���5(�@H���V��l�,����!�7�g^�˜��W�_���|hRʎYɥj�ҧ/�wȑ:�R2���<�)@h�L*C���$�d�[�!�i#^�B.���R���Z�����ٶ�z���g�
}�����|r�gQ`E��f��wbWa�f�<b��T�&]+���8N���5������z�
tm�aK�<��u*A
��$�f!(`���� �lN���}PD l(?��&�k�u5W{9QA���?Zt߫����_Z�"3Щ�	�y#b���4�&�i4���h������x2HoӔƖl�y��D�P�$}����(�Z���Q�)�{;f~���/PK��~�lPKY��U
xl/styles.xml�X]O�0}߯��>��R`J�S��LhiҴ�8��?"ۅ�_��8M>�T&�H�Cm��s|r|�8��VR�;f,�j�GFL�:㪘�����	F�Q�Q���Y|�|����*s���ҹ�!6-���@WL��\IMAleͬIA�Q4%�r��X-�\:�R�Tdt!�o��݅�@�W����$&-A�Zmx&8��>�;*�$��J����J.�7��<�x�xS��)cI\Q�Qs����+pV�R�&����z4>����&���/k���B+*��Ω�w�/�^��I,X�������$�i	�5�O��L�2!�|���7w�*ZW�@�{�m70�ZU��kO�̒���M� t.x�${�xi�c�k�&��t��Jm�P�,ڲ�O�����ȱ���
,����j��D��fb�fK���B�ywl�:H���ek�%���$���S�ƧѶ>�:���Z���3ދyA����^�^�^�^�^�6b&������vJ�d�ԌwI��C���������Ư���z�(�����bۿ[�w�i��Y��������wR!z��,�p\�y
��R�u��h8|�~E�;�t�>Z�TZw��f�7�`����9�%3)�A9@��L��_僳������Ղg�D���Bd��7�7�f�ts@�P���lβ�?PK�؟.�PKY��Uxl/worksheets/sheet1.xml�VKo�8��t�ik��We���.��A�n�����"B�*I�M~��g�`�!98������P3?�ʸw��K2��XR&K������iC%\
X�O����o�I�G��^��1�U�8����A�'�*#_�!йBݢ����,�~�p�ނ!��Ű�q��0%�N��)�u����	�*rB�5��u�i�&�^�b%�L�(�YEm��2�|�3��B,#��?"p����3��8�Q��0n@}���}99�����̓�GC��0�G!e�B[vOA���'W���p38�γ�Sy� ��]�9㟊�[&�F��<�$������u���ڠ�!E����Ґ�8�hwݶ07�=e{�
	)��p;�j�/}a��R�v�pne�^lc�B����=K��b�1I���~���6���I.-��~{)���m��
�ޜ��b�{�G(٬/���RO�tA_S/�}�K�q'K]e���Q�"��h1[Lg�E�'���9G�t��3V��T��e�o����
w(�/T|�Đ(T��a-l�mdV5[����R����B�
V��\��Q��ng+�ݮ�X������L�*�f1y�FL��u5��,nꈍ1���nDI}�7�X�.n���fbӞ��@ܼ'n�19]������z����-z�=qA��f����؅q��]��v�'G�CS�س��NZP�.{]0,:�r�|%��pc���xt~q���}����]7���3��S��'uäH�4���}E�7�c��v���Nww#�n��k�}�Bl�ۇʓxHAlQ-V[1�K?��(°��9����2�LY/��cg_���W�J�J;J�le�,4l��~)�9ï�
�k�Zb�3p�sQfk�r�Q�$X'a~K�6o)��؞�(����;�@�����~�YH��o
ڻ��7��{9%K��Lݿ�0hQ,`����=�;�
*�*��v>+�;Ϟ�bx@qܻ�ݠ���F�PKZY�>�PKY��U#xl/worksheets/_rels/sheet1.xml.rels���
�0E�~E���օ�4�F�n�~@L�i�y�Dѿ7�.\�}��V����N!N�
(y��r�d��sw\WՉf�r$���,wl0����Q�dd�Γ�����)�A���*5�(��P/�����/�uOO���0L�N����&y�)eДp�V>F�30��ź�PKZ��V�PKY��Uxl/tables/table1.xmlm��n�0��{�����4��U∦�=��)��$�헁��K$�����_ΪO��0�e��i
��o_@��ܢ��`]>�kK*}�P@c��:493�S� �aL�?��{�6tD�Y�Ȳg��0(Ӧ��]��&kA�&�ϻ	�t(`3_UO��$#�&�J�C��6�Q6B��9Q��F�ca��{��W��\}K�������A��,~#��/��^�i.	=+�oPK;w��PKY��Uxl/sharedStrings.xml���j1�{�"̽f� E��
=�����
l&kf"�ۛě��g��ƬҨ�X8f�0�u��B�#-|��_�@�x���	-�"�ڽfQm��� 2���0`�<�R�|璼�X������QҨ]���Gr%��U)�*�����W�x�5����>j:`1Z����	��%�Ge�k�yJo�һ�����PKH''-��PKY��Uxl/_rels/workbook.xml.rels��Mk�0���F��Ic�8��A����Q���6�ֵ�~.[
e�Г���H��4���C�����v������V͢��h%����؀I/Z��8Y.b;]��JN��ɺ��Q/��IӜ�S�[�n+P�s���c�
_�{�0�
	�r�3�R�b�+/2�m��=�?"�#ʯ��R6w	�_f�zo	ۭP~��$��E����|PKO��z�%PKY��UdocProps/core.xml�R]O�0}�W,}ߺ
!�l#QÓ���o�����5m��v�<�v�=��~5�~�*؂��V9J��Xͅ*s����W(��*N�ZA��`Ѵ�Ș&�6�dj
�	��7R�0���s�`l�$��W(O�j#��ДXS�IK�iO�G9u7�������RoL�p��	�Y�D	>ji�>h��n�᬴'���p��E�Q+��'�m~�܎
լ�*�C#��x�
HW�g^G�w�*�8M�$
�x�\�xBƗ����1���
{>�`���v䏄�U��/�P��᱕���n�o���L��Hr�)��89�7h+؊��i[t�M�v��溑�c'\]�����PK��qVc�PKY��UdocProps/app.xml��Mo!���ҫ�ኆ�4izj���7CaViv����������l��l>hkZT�e`�U�lZ��=M(�BF��h�Z�;��5�,Lh�6F��8�-�"�lR��~1�~�m�k	�V~�`".	i0�#j�.@t&.v�Pe�q���.�8�`t�������b���J�K���1]�?�O/'	<˫���wm��	�ڬ�:�iY�%�@F�
E@4�'�()!b^�RH���u=��!UUS�oŎʫ�W�b��d����׫�_PK��u��PKY��U[Content_Types].xml�U;O�0��+"�(vˀJځ��(3r�Kb?d�����(U	mQ'+��w���d-�h�	�R2�C��t.T����C|M&�A2�p�*���{sØ�*��Qm@a��Vr���d�g^��X���c8�8���/kݯq��E8�nۼ �nL-2�1�B�u�,��p��=w�3��&�U¸���*�����ně�nH@��ۊ�)���KL`��F{��Ki]�wms��p�;�tQ�r�-%B�3x�*/kڬTr���;�����ސ�Pyp�YF=����=�o7g���خv�
������[�hz�]�#>�����84>��8�-���/���
�����o����p����$�y*�PK����pYPKY��Uf����;_rels/.relsPKY��U��~�lxl/workbook.xmlPKY��U�؟.�
Mxl/styles.xmlPKY��UZY�>�@xl/worksheets/sheet1.xmlPKY��UZ��V�#�
xl/worksheets/_rels/sheet1.xml.relsPKY��U;w��xxl/tables/table1.xmlPKY��UH''-���xl/sharedStrings.xmlPKY��UO��z�%�
xl/_rels/workbook.xml.relsPKY��U��qVc��docProps/core.xmlPKY��U��u��hdocProps/app.xmlPKY��U����pY�[Content_Types].xmlPK�f