Функция ENCODEURL: различия между версиями

Материал из Planfix
Перейти к: навигация, поиск
Нет описания правки
Нет описания правки
 
(не показаны 52 промежуточные версии 2 участников)
Строка 5: Строка 5:
|description=Функция ENCODEURL
|description=Функция ENCODEURL
}}
}}
Функция изменяет в ссылке определенные символы на специальную последовательность символов из таблицы:
Функция ENCODEURL() возвращает строку в кодировке URL, заменяя некоторые не буквенно-цифровые символы символом процента (%) и шестнадцатеричным числом:
 
<div style="display: inline-block; width: 100%; text-align: center;">
{| class="wikitable"
{| class="wikitable" style="width:30%; float: left; margin-right: 1%;"
| IN
| '''IN'''
| OUT
| '''OUT'''
|-
| !
| %21
|-
| #
| %23
|-
| $
| %24
|-
| %
| %25
|-
| &
| %26
|-
| '
| %27
|-
| (
| %28
|}
{| class="wikitable" style="width: 30%; float: left; margin-right: 1%;"
| '''IN'''
| '''OUT'''
|-
| )
| %29
|-
| *
| %2A
|-
| +
| %2B
|-
| ,
| %2C
|-
| /
| %2F
|-
| :
| %3A
|}
{| class="wikitable" style="width: 30%;"
| '''IN'''
| '''OUT'''
|-
| ;
| %3B
|-
| ?
| %3F
|-
| @
| %40
|-
| [
| %5B
|-
|-
| Bread
| ]
| Pie
| %5D
|-
|-
| Butter
|  
| Ice cream
| %20
|}
|}
</div>
Используется для случаев, когда необходимо сформировать работающую ссылку в вычисляемом поле или действием сценария вычислить значение поля.


! %21
# %23
$ %24
% %25
& %26
' %27
( %28
) %29
* %2A
+ %2B
, %2C
/ %2F
: %3A
; %3B
= %3D
? %3F
@ %40
[ %5B
] %5D
%20


== Формат ==


== Формат ==
'''ENCODEURL'''("ссылка")


'''MD5(текст)'''
'''КОДИР.URL'''("ссылка")




== Пример ==
== Примеры ==
Пример № 1:
<div style="display: block; padding: 9.5px; margin: 0 0 10px; font-size: 13px; line-height: 1.65; color: #333; word-break: break-all; word-wrap: break-word; background-color: #f5f5f5; border: 1px solid #ccc; border-radius: 4px;">"<nowiki>https://</nowiki>site.ru/?param="+'''ENCODEURL'''(<nowiki>{{Задача.Название}}</nowiki>)</div>
<div style="display: block; padding: 9.5px; margin: 0 0 10px; font-size: 13px; line-height: 1.65; color: #333; word-break: break-all; word-wrap: break-word; background-color: #f5f5f5; border: 1px solid #ccc; border-radius: 4px;"><nowiki>https://</nowiki>site.ru/?param=%D0%9D%D0%B0%D0%B7%D0%B2%D0%B0%D0%BD%D0%B8%D0%B5%20%D0%B7%D0%B0%D0%B4%D0%B0%D1%87%D0%B8</div>


MD5("Доброе утро")


Результат: b9d459fde4cbaecb222770fc759c3fd1
Пример № 2:
<div style="display: block; padding: 9.5px; margin: 0 0 10px; font-size: 13px; line-height: 1.65; color: #333; word-break: break-all; word-wrap: break-word; background-color: #f5f5f5; border: 1px solid #ccc; border-radius: 4px;">'''ENCODEURL'''("<nowiki>http://</nowiki>contoso.sharepoint.com/teams/Finance/Documents/April Reports/Profit and Loss Statement.xlsx")</div>
<div style="display: block; padding: 9.5px; margin: 0 0 10px; font-size: 13px; line-height: 1.65; color: #333; word-break: break-all; word-wrap: break-word; background-color: #f5f5f5; border: 1px solid #ccc; border-radius: 4px;">http%3A%2F%2Fcontoso.sharepoint.com%2Fteams%2FFinance%2FDocuments%2FApril%20Reports%2FProfit%20and%20Loss%20Statement.xlsx</div>




== Важно ==
== Важно ==
'''На текущий момент функция не работает для формул, вычисляемых только для строк итогов или первых группировок в отчетах.'''
В функцию можно добавлять только ссылки без специальных символов, как в примерах выше. Иначе специальные символы (например %) будут заменены на свои аналоги по таблице. В результате ссылка станет нерабочей.





Текущая версия от 14:28, 22 марта 2021

Функция ENCODEURL() возвращает строку в кодировке URL, заменяя некоторые не буквенно-цифровые символы символом процента (%) и шестнадцатеричным числом:

IN OUT
! %21
# %23
$ %24
% %25
& %26
' %27
( %28
IN OUT
) %29
* %2A
+ %2B
, %2C
/ %2F
: %3A
IN OUT
; %3B
? %3F
@ %40
[ %5B
] %5D
%20

Используется для случаев, когда необходимо сформировать работающую ссылку в вычисляемом поле или действием сценария вычислить значение поля.


Формат

ENCODEURL("ссылка")

КОДИР.URL("ссылка")


Примеры

Пример № 1:

"https://site.ru/?param="+ENCODEURL({{Задача.Название}})
https://site.ru/?param=%D0%9D%D0%B0%D0%B7%D0%B2%D0%B0%D0%BD%D0%B8%D0%B5%20%D0%B7%D0%B0%D0%B4%D0%B0%D1%87%D0%B8


Пример № 2:

ENCODEURL("http://contoso.sharepoint.com/teams/Finance/Documents/April Reports/Profit and Loss Statement.xlsx")
http%3A%2F%2Fcontoso.sharepoint.com%2Fteams%2FFinance%2FDocuments%2FApril%20Reports%2FProfit%20and%20Loss%20Statement.xlsx


Важно

В функцию можно добавлять только ссылки без специальных символов, как в примерах выше. Иначе специальные символы (например %) будут заменены на свои аналоги по таблице. В результате ссылка станет нерабочей.


Перейти